CL Command Reference - CHGSPLFA
CL Command List > CHGSPLFA Reference
Description:
The Change Spooled File Attributes (CHGSPLFA) command allows you to change attributes of a spooled file while it is on an output queue. These changes affect only the current processing of the file. The next time the job runs and the file is produced, the file attributes are derived from the device file description, the program, and any override commands.
If the file is currently being produced on an output device, the only parameters that can be changed are COPIES, RESTART, and SAVE. An attempt to change any other parameter results in an error, and no file attributes are changed. However, if the file is being held on an output queue because of spooling attribute errors, this command can be used to change the attributes, and a spooling writer can then be started to produce the file.
See the Information Center for more information about changing spooled file attributes.
You can change the following attributes:
. The name of the device
. The order of the spooled file entries
. The output queue of the specified file
. The type of forms to be used for printer output
. The number of copies to be produced
. The number of separator pages for this printer file
. The schedule for the output
. Whether the spooled file is to be saved after it has been written
. The output priority
. The user data that identifies the spooled file
. The alignment prompts to be used for a printer file
. The print quality for a printer file
. Whether to print the file on one or both sides of each page
. The form feed attachment to be used for a printer file
. The volume identifier used for diskette files
. The label identifier used for diskette files
. The exchange type used to write to diskette
. The character code (EBCDIC or ASCII) used for diskette
Examples:
Example 1: Moving a File to Another Queue
CHGSPLFA FILE(SALES) JOB(000147/JONES/BILLING) OUTQ(QPRINT2)
FORMTYPE(¡¯1140-6¡¯)
This command moves the file named SALES (of the BILLING job numbered 000147) from the present queue to the QPRINT2 queue. It also changes the forms identifier to 1140-6, which means that this form type is used in the printer.
Example 2: Changing Number of Output Copies
CHGSPLFA FILE(DEPT511) COPIES(2) FILESEP(5)
This command changes the attributes of the spooled file DEPT511 that is produced by the submitter¡¯s job. It changes the number of output copies to 2 and specifies that five separator pages precede each copy.
Example 3: Changing Starting and Ending Pages to Print
CHGSPLFA FILE(DEPT481) PAGERANGE(99 100)
This command changes the attributes of the spooled file, DEPT481. It changes the starting and ending pages that are to be printed. Now, only pages 99 and 100 of each copy of the file is printed.
Example 4: Starting on a Specific Page
CHGSPLFA FILE(DEPT481) RESTART(5)
This command restarts printing spooled file DEPT481 on page 5. All of the copies that follow are printed from the specified starting page to ending page. If the file is in WTR status, the writer stops printing the current copy and restarts printing on page 5. The page specified on the RESTART parameter must be within the range specified on the PAGERANGE parameter.
Example 5: Restarting on the Next Page
CHGSPLFA FILE(DEPT481) RESTART(*NEXT)
This command restarts the printing job on the page following the last page printed when the job was interrupted. All of the copies that follow are printed from the specified starting page to ending page. The file must not be in WTR status. If the file is in WTR status, this command is rejected and a message is sent to the user. RESTART(*NEXT) is not valid when a file is being processed by a writer.