CL Command Reference - HLDSPLF
CL Command List > HLDSPLF Reference
Description:
The Hold Spooled File (HLDSPLF) command stops the specified spooled file from additional processing by a spooled writer. If the file is being produced on an output device, the writer stops processing that file and gets the next file to be processed. When the file is released and selected for output, it is again processed starting at the beginning of the file. If multiple copies are being produced for the file when it is held, the incomplete copy is produced from the beginning again and any remaining copies follow it.
Examples:
Example 1: Holding a File Created by Another Job
HLDSPLF FILE(SHIPITEMS) JOB(00009/JONES/ORDER)
This command withholds the spooled file SHIPITEMS, created by the job ORDER, from additional processing.
Example 2: Holding a File at a Page Boundary
HLDSPLF FILE(QPJOBLOG) OPTION(*PAGEEND)
This command holds the spooled file QPJOBLOG at a page boundary.
Example 3: Holding a File Immediately
HLDSPLF FILE(QPJOBLOG) OPTION(*IMMED)
This command holds the spooled file QPJOBLOG immediately. Holding a spooled file by specifying this option causes the CHGSPLFA command RESTART(*NEXT) to be inaccurate if the spooled file is currently being processed by a spool writer.