The Convert All Job Queues command accesses one or more job queues,
accesses the attributes of each, and creates a data base file
ALLJOBQP with one record per job queue. The record includes the
number of jobs which are on the job queue. This allows you to
automate several functions involving batch jobs.
A typical command would be entered as:
CVTALLJOBQ OUTLIB(QTEMP)
The command creates a file named ALLJOBQP in QTEMP with one record
for each job queue. You can then read the file in a CL or other HLL
program. For example, you could determine if the job queue had any
jobs and issue the CVTJOBQ command to determine what the jobs are.
Command parameters *CMD
------------------
LIB The library to convert the job queues from. The
default is *ALL. If a library is named, only the
job queues in that library will be converted.
OUTLIB The library in which the file ALLJOBQP will be
placed. The default is *LIBL. If the ALLJOBQP file
does not exist, a library must be specified.
OUTMBR The member of the ALLJOBQP file to be used. If the
member does not exist, it is added. The default is
ALLJOBQP.
REPLACE A *YES/*NO value for whether the member should be
cleared before writing records into it. The default
is *YES.
ASPDEV Specifies the auxiliary storage pool (ASP) device
name where storage for the library containing the
object is allocated. If the library resides in an
ASP that is not part of the thread's library name
space, this parameter must be specified to ensure
the correct library is searched. If this parameter
is used when the library qualifier specified for the
Object prompt (OBJ parameter) is *CURLIB, *LIBL, or
*USRLIBL, ASPDEV(*) is the only valid value.
This parameter can be specified as a list of two
values (elements) or as a single value. The
possible single values are:
* = The ASPs that are currently part of the thread's
library name space will be searched to locate the
library. This includes the system ASP (ASP 1), all
defined basic user ASPs (ASPs 2-32), and, if the
thread has an ASP group, the primary and secondary
ASPs in the thread's ASP group.
*ALLAVL = All available ASPs will be searched. This
includes the system ASP (ASP 1), all defined basic
user ASPs (ASPs 2-32), and all available primary and
secondary ASPs, (ASPs 33-255) with a status of
'Available'.
*CURASPGRP = If the thread has an ASP group, the
primary and secondary ASPs in the thread's ASP group
will be searched to locate the library. The system
ASP (ASP 1) and defined basic user ASPs (ASPs 2-32)
will not be searched. If no ASP group is associated
with the thread, an error will be issued.
*SYSBAS = The system ASP (ASP 1) and all defined
basic user ASPs (ASPs 2-32) will be searched to
locate the library. No primary or secondary ASPs
will be searched even if the thread has an ASP
group.
Element 1: Device
The device name of the primary or secondary ASP to
be searched. The primary or secondary ASP must have
been activated (by varying on the ASP device) and
have a status of 'Available'. The system ASP (ASP
1) and defined user basic ASPs (ASPs 2-32) will not
be searched.
Element 2: Search type
*ASP = Specifies that only the single auxiliary
storage pool (ASP) device named in element 1 is to
be searched.
*ASPGRP = Specifies that the entire group of the
primary auxiliary storage pool (ASP) device named in
element 1 is to be searched.
File format
-----------
The file name that is output is ALLJOBQP.
The model file used is TAAJOBHP with a format name of AJRCD.
To see the field names used:
DSPFMT TAAJOBHP
Restrictions
------------
Because all job queues must be accessed, you must have *ALLOBJ
authority to use CVTALLJOBQ.
Prerequisites
-------------
The following TAA Tools must be on your system:
EDTVAR Edit variable
RTVJOBQA Retrieve job queue attributes
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
SNDSTSMSG Send status message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ----- --------- ---------- -----------
CVTALLJOBQ *CMD TAAJOBH QATTCMD
TAAJOBHP *FILE PF TAAJOBHP QATTDDS
TAAJOBHC *PGM CLP TAAJOBHC QATTCL
TAAJOBHC2 *PGM CLP TAAJOBHC2 QATTCL
TAAJOBHR *PGM RPG TAAJOBHR QATTRPG
|
