The Convert Job Queue command uses a system API to access the
information similar to WRKJOBQ and creates the data base file JOBQP
with one record per job on the job queue. This allows you to
automate several functions involving batch jobs.
You must have the special authority *JOBCTL to use CVTJOBQ. The
QUSLJOB API is used.
The typical command would be entered as:
CVTJOBQ JOBQ(xxxx) OUTLIB(QTEMP)
The command creates a file named JOBQP in QTEMP with one record for
each job on the job queue. You can then read the file in a CL or
other HLL program.
By specifying JOBQ(*ALL/*ALL), you can write one record for every job
on all job queues on the system.
WRKJOBQ sequencing
------------------
The default sequencing of the output will be in the order the jobs
are received from the API. This will rarely agree with the sequence
as seen on WRKJOBQ.
An option exists to sequence the data to match what appears on
WRKJOBQ. This will be a 100% match in most cases. There can be
exceptions such as if multiple jobs are placed on the job queue with
the exact same date and time.
The field JQSORT is generated for the JOBQP file based on rules
within the TAAJOBGR program. It will contain data that can be sorted
on to match WRKJOBQ. For the specific rules of how this field is
generated, scan the TAAJOBGR source for **SORT**.
If SEQ(*WRKJOBQ) is specified, the data is copied from the JOBQP file
to the TAACVTJOBQ file in QTEMP. The TAACVTJOBQ file is created
automatically and has the same format as the JOBQP file plus a key on
the JQSORT field. The data is then copied back to the JOBQP file and
the TAACVTJOBQ file is deleted.
Command parameters *CMD
------------------
JOBQ Specifies a qualified name for the JOBQ to be
converted. The default library is *LIBL.
The special entry *ALL/*ALL may be specified to
convert all jobs on every job queue on the system.
If *ALL is specified for the job queue, the library
qualifier must be *ALL or a specific library. If
the library qualifier is *ALL, the job queue name
must be *ALL.
OUTLIB The library in which the file JOBQP will be placed.
The default is *LIBL. If the JOBQP file does not
already exist, a library must be named.
OUTMBR The member of the JOBQP file to be used. If the
member does not exist, it is added. The default is
JOBQP.
REPLACE A *YES/*NO value for whether the member should be
cleared before writing records into it. The default
is *YES.
SEQ Whether to sequence the data in the outfile. The
default is *API meaning the data appears in the
sequence as extracted from the API.
*WRKJOBQ may be specified to duplicate the sequence
of the jobs as they appear on the system WRKJOBQ
display. In most situations this will be a 100%
match. See the previous section on WRKJOBQ
Sequencing.
File format
-----------
The file name that is output is JOBQP.
The model file used is TAAJOBGP with a format name of JQRCD.
To see the field names used:
DSPFMT TAAJOBGP
Restrictions
------------
*JOBCTL authority is required.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKJOBCTL Check job control special authority
CVTDTS Convert DTS
DUPFILFMT Duplicate file format
EDTVAR Edit variable
HLRMVMSG HLL Remove message
RTVSYSVAL3 Retrieve system value 3
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
------ ----- --------- ---------- -----------
CVTJOBQ *CMD TAAJOBG QATTCMD
TAAJOBGC *PGM CLP TAAJOBGC QATTCL
TAAJOBGC2 *PGM CLP TAAJOBGC2 QATTCL
TAAJOBGR *PGM RPG TAAJOBGR QATTRPG
TAAJOBGP *FILE PF TAAJOBGP QATTDDS
TAAJOBGQ *FILE PF TAAJOBGQ QATTDDS
The TAAJOBGQ file is used for SEQ(*WRKJOBQ) processing.