<ONPAGE>

The <ONPAGE> tag defines the pages in each document on which fields are found or adds are applied. When you use <ONPAGE> in the Add tag group, it adds the object to the specified pages. When you use <ONPAGE> in the Field tag group, it looks for the field information on the specified pages.

For fields, these pages are further restricted by the second character in the <FIELD> tag action parameter. For example, if action is KA, Enrichment acts upon the last value from the page or page range specified by <ONPAGE>. Likewise, if action is KP, Enrichment acts upon the first value from each page of the range specified by <ONPAGE>.

Note: When you use the <ONPAGE> tag for a one-page document, Enrichment treats the page as both the first and last page of the document. Therefore, if you set <ONPAGE> to FIRST, LAST, or LLAST (for Add tags), it is the same as setting <ONPAGE> to ALL. Setting <ONPAGE> to NFIRST, NLAST, or MIDDLE, would have no effect.

If you specify a range of pages whose ending value exceeds the number of pages in a document, Enrichment looks for the field information only on the pages that exist. If you specify a range whose beginning value exceeds the number of pages in the document, Enrichment will find no field information and add nothing to the document. For example, <ONPAGE> 4 7 works for any document that contains four or more pages.

If you specify a page range, a space must separate the page specifications.

Note: You will receive a severe error if you use the <ONPAGE> tag in the Field tag group and that field is used to define a page or the top or bottom of a document.

Tag Group

Add tag group

Field tag group

Syntax

<ONPAGE> page

Parameter Description Default
page One of the following:

A[LL] — All pages.

F[IRST] — The first page.

L[AST] — The last page.

M[IDDLE] — All pages except the first and the last.

NF[IRST] — All pages except the first.

NL[AST] — All pages except the last.

LL[AST] — The last page of the last document. LLAST has no effect if the output in which it is defined does not contain the last document in the application.

ALL
The following options are available only for the <ADD> group.
B[ANNER] Only pages belonging to a <BANNER>.
num A specific page.
num1 num2 A range of pages.
num L A range of pages that begins at page num and ends at the last page.
num1 L-num2 A range of pages that begins at page num1 and ends num2 pages before the last page.
L-num A specific page num pages before the last page.
L-num L A range of pages that begins num pages before the last page and ends on the last page.
L-num1 L-num2 A range of pages that begins num1 pages before the last page and ends num2 pages before the last page.