Assignment - PAGENO

Purpose

Changes the current page number that serves as the value of the PAGENO built-in function.

Syntax

PAGENO(f) = e;

Parameters

f
A reference to a file constant, or to a file variable that has been assigned a file constant value.
e
Any valid expression.

Description

The PAGENO pseudovariable refers to the page number of the referenced print file.

Assignment to the PAGENO pseudovariable modifies the current page number by causing the expression e to be evaluated and converted to a binary integer value of default precision, then assigned as the current page number of the file identified by f. (For details on default precisions, see your Open PL/I User's Guide.)

The file must be open and must describe a STREAM OUTPUT PRINT file.

The PAGENO assignment does not cause any additional pages to be output to the file; it simply changes the current page number that serves as the value of the PAGENO built-in function.

Example

DECLARE F FILE;
   .
   .
   .
PAGENO(F) = 10;

Restrictions

None.