SPLCLOSE

ANSI

The SPLCLOSE instruction closes an existing spool file after updating its End Of File information in the directory. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

pfile

Optional. A previously defined PFILE variable that routes the output to an alternate device/file.

Flags Affected: NONE

Note the following:

1. A PRINT instruction that does not specify a {pfile} and is executed after a SPLCLOSE instruction directs the output to the default printer device/file name.

2. A PRINT instruction that specifies a {pfile} and is executed after a SPLCLOSE instruction for that {pfile} generates a Spool Error.

3. A SPLCLOSE instruction that is executed against an open spool file that is not open is ignored.

4. SPLCLOSE can be executed using a PFILE opened using PRTOPEN or SPLOPEN. (9.6B)

5. If a SPLCLOSE is executed on a PFILE opened using a PRTOPEN, the SPLCLOSE executes with the same actions as a PRTCLOSE instruction. (9.6B)

6. If a FILEPI instruction is active, it is terminated.

See Also: Example Code, Printer Instructions