PFILE

ANSI

The PFILE instruction defines spool files used for alternate PRINT spooling. It uses one of the following formats:

Where:

label

Optional. A Program Execution Label.

^

Optional. Denotes the item as being a POINTER.

%

Optional. Denotes the item as being GLOBAL.

%%

Optional. Denotes the item as GLOBAL but does not initialize it in any way.

Flags Affected: NONE

Note the following:

1. A PFILE must have been defined with a PFILE definition instruction before being referenced in a PRINT instruction.

2. A SPLOPEN instruction must have been performed using the given PFILE variable before performing any PRINT instructions using the PFILE variable.

3. The PFILE variable may not be in common and therefore is not kept open across program chains. A PFILE variable that is declared as GLOBAL is kept open across program chains.

4. The ^ denotes a Pointer Variable.

5. If the % form is used, the data item is placed in the Global Data Area. The variable would be available to other programs that also declared it with the percent form. Global Data Items are available with PLBCMP only.

6. If the %% form is used, the data label is placed in the Global Data Area but no initialization takes place if it has not already been defined in the Global Data Area. Global Data Items are available with PLBCMP only.

See Also: Example Code, File Definitions, Printer Instructions