The Change Job Spooled Files command changes all the spooled files
for a job for specified attributes such as changing to a different
form type. This simplifies cleanup at the end of a job for spooled
files created during the job.
You must have *JOBCTL special authority to change a job other than
your own.
A typical command would be:
CHGJOBSPLF FORMTYPE(xxx)
All the spooled files for the current job would be changed to the
specified form type.
If no spooled files exist, no error occurs.
CHGJOBSPLF escape messages you can monitor for
----------------------------------------------
TAA9891 No jobs exist
TAA9892 All parameters for change cannot be *SAME
TAA9893 More than one job exists
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
JOB The qualified job name of the job to change spooled
files for. The default is * meaning the current
job. A unique name must be provided. A unique name
may be any combination of job name, job and user, or
job and job number.
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.
*SAV may be specified to change only those spooled
files in a SAV status.
*CLO may be specified to change only those spooled
files in a CLO status.
SELSPLF The spooled file to be selected. *ALL is the
default for all spooled files.
A spooled file name or generic name may be entered.
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 one or more of
the files cannot be released, no error occurs. The
completion message contains the number of files
released.
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.
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 Whether to change the value of the user data. The
default is *SAME. Any value may be entered.
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
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKJOBCTL Check *JOBCTL special authority
CVTJOBSPLF Convert job spooled file
EDTVAR Edit variable
RTVJOBSTS Retrieve job status
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CHGJOBSPLF *CMD TAASPOF QATTCMD
TAASPOFC *PGM CLP TAASPOFC QATTCL
|
