CVTJOBSPLF CONVERT JOB SPOOLED FILES TAASPNV |
The Convert Job Spooled Files command converts existing spooled files
for a specified job to an outfile. The WRKSPLFP data base file is
written with one record for each spooled file. This is the same
format as used by CVTWRKSPLF. CVTJOBSPLF provides a performance
advantage over CVTWRKSPLF when the spooled files for a specific job
are needed.
The model file is TAASPLHP with a format name of SFREC.
You must have *JOBCTL special authority to use CVTJOBSPLF for a job
other than your own.
Any spooled files in a FIN (finished) status are never output.
The job's SPLFACN parameter value must be *KEEP.
A specific file name such as QPJOBLOG may be specified.
A typical command would be:
CVTJOBSPLF JOB(*) OUTLIB(QTEMP)
All spooled files for the current job that are not in a FIN
(finished) state would be output.
A specific job name may be entered without either the user or job
number or both such as:
CVTJOBSPLF JOB(ABC) OUTLIB(QTEMP)
If either the user or job number are entered as blanks, *ALL will be
used and the job will attempt to be identified. If duplicate jobs
exist, an escape message will be sent.
If the job does not exist, an escape message will be sent.
If the job exists, but no spooled files exist (or match the file name
specified), the WRKSPLFP file will contain 0 records. No escape
message occurs.
CVTJOBSPLF escape messages you can monitor for
----------------------------------------------
TAA9891 Duplicate jobs exist for the specified job
TAA9892 No jobs exist for the specified job.
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
JOB The qualified name of the job to output spooled
files for. The default is * for the current job.
If * (current job) is not specified, at least a job
name must be entered. If either the user or job
number portion of the parameter are blank, *ALL is
assumed when attempting to identify the job.
FILE The file name to be converted. The default is *ALL
for all spooled file names. A specific spooled file
name such as QPJOBLOG may be entered.
OUTLIB The library in which the file WRKSPLFP will be
placed. The default is *LIBL. If the WRKSPLFP file
does not already exist, a library must be named.
OUTMBR The member of the WRKSPLFP file to be used. The
default is WRKSPLFP. If the member does not exist
it is added.
REPLACE A *YES/*NO value for whether the member should be
cleared before writing records into it. The default
is *YES.
*NO may be specified to add records to any existing
data.
Restrictions
------------
You must have *JOBCTL special authority to use CVTJOBSPLF for a job
other than your own.
The job's SPLFACN parameter value must be *KEEP.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKJOBCTL Check *JOBCTL special authority
DUPTAADBF Duplicate TAA data base file
EDTVAR Edit variable
RTVJOBSTS Retrieve job status
RTVSYSVAL3 Retrieve system value 3
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
------ ---- --------- ---------- ----------
CVTJOBSPLF *CMD TAASPNV QATTCMD
TAASPNVC *PGM CLP TAASPNVC QATTCL
TAASPNVR *PGM RPG TAASPNVR QATTRPG
Note that the outfile WRKSPLFP is part of the CVTWRKSPLF tool.
|
Added to TAA Productivity tools April 15, 2005