The Change All Spooled Files command allows all spooled files in an
output queue to be changed for such values as OUTQ, FORMTYPE, SAVE,
and ALIGN. This provides a command interface instead of using the
'2' option on WRKOUTQ. A Hold/Release option also exists.
You must have *JOBCTL special authority to use CHGALLSPLF.
The command is intended for printer spooled files.
A typical command would be:
CHGALLSPLF OUTQ(xxx) SAVE(*YES)
All spooled files in the output queue would be changed to SAVE(*YES).
No error occurs if a spooled file is already SAVE(*YES).
The default for the attribute parameters is *SAME. At least one of
the parameters must be other than *SAME.
CHGALLSPLF escape messages you can monitor for
----------------------------------------------
TAA9892 All values are specified as *SAME.
Escape messages from system commands will be re-sent.
Command parameters *CMD
------------------
OUTQ The qualified name of the output queue to be
processed. The library value defaults to *LIBL.
*CURLIB may also be used.
TOOUTQ The output queue to move the spooled files to. The
default is *SAME. A different output queue may be
named. If a library is not specified, *LIBL is
assumed. *CURLIB may be specified.
CURSTS The current status of spooled files to be considered
for changes.
*ALL is the default meaning all status conditions
are considered.
*RDY may be specified to change only those spooled
files in a RDY status.
*HLD may be specified to change only those spooled
files in a HLD status.
STATUS Whether to Hold or Release the spooled files. The
default is *SAME.
If *HOLD is specified, the existing spooled files
are held and then changed by the other parameters.
If one or more of the spooled files is already held
or cannot be put in a held status, no error occurs.
The completion message contains the number of files
held.
If *RELEASE is specified, the existing spooled files
are changed and then released. If the spooled files
are moved to a new output queue, only the spooled
files that were in the From output queue are
released. If one or more of the files cannot be
released, no error occurs. The completion message
contains the number of files released.
FORMTYPE The form type to be used. The default is *SAME. A
name or *STD may be entered.
COPIES The number of copies to be printed. The default is
*SAME. A number between 1 and 255 may be entered.
FILESEP The number of file separators to be printed. The
default is *SAME. A number between 0 and 9 may be
entered.
SCHEDULE The schedule for when the file should become
available. The default is *SAME. The values
*JOBEND, *FILEEND, or *IMMED may be entered.
SAVE Whether to save the file after printing. The
default is *SAME. The values *YES or *NO may be
entered.
OUTPTY The output priority of the spooled file. The
default is *SAME. Values 0-9 may be entered.
USRDTA The user data attribute of the spooled file. The
default is *SAME.
ALIGN Whether to cause an alignment message before
printing the file. The default is *SAME. The
values *YES or *NO may be entered.
EXPDATE The expiration date of the file. The default is
*SAME. A date may be entered in job format to cause
the spooled file to be deleted by the system at the
end of the date specified.
PRTQLTY The type of print quality to be used. The default
is *SAME. The values *STD, *DEVD, *DRAFT, *NLQ, or
*FASTDRAFT may be entered.
FORMFEED The type of form feeding to be used. The default is
*SAME. The values *DEVD, *CONT, *CUT, *AUTOCUT, or
*CONT2 may be entered.
DRAWER The drawer to be used. The default is *SAME. The
values *E1 or *FORMDF may be entered.
FIDELITY The type of print fidelity to be used. The default
is *SAME. The values *ABSOLUTE or *CONTENT may be
entered.
DUPLEX Whether to print on both sides. The default is
*SAME. The values *YES, *NO, *TUMBLE, or *FORMDF
may be entered.
MULTIUP Whether multiple pages should be printed per side.
The default is *SAME. The values 1-4 may be
entered.
Restrictions
------------
*JOBCTL special authority is required.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKJOBCTL Check *JOBCTL special authority
CHKOBJ3 Check object 3
CVTOUTQ Convert output queue
EDTVAR Edit variable
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CHGALLSPLF *CMD TAASPMJ QATTCMD
TAASPMJC *PGM CLP TAASPMJC QATTCL
|
