The Save and Restore Job Queue tool supports two commands to provide
for a save and restore of a job queue. CVTJOBQ2 creates an outfile
of information about the jobs on a job queue. The file can be saved
and restored to the same or a different system. The SBMJOBQ2 command
may then be used to read the outfile and perform a SBMJOB for each
job found in the outfile. Some restrictions exist.
You must have *ALLOBJ special authority to use either CVTJOBQ2 or
SBMJOBQ2.
On the source system, a typical command would be:
CVTJOBQ JOBQ(JOBQ1) OUTLIB(ABC)
The jobs in JOBQ1 would be read and information about each job
written to the JOBQP2 file in library ABC.
After restoring or transferring the file to a different system
(assume the entire ABC library is transferred), the following command
would be used to place the jobs onto JOBQ1:
SBMJOBQ2 OUTLIB(ABC)
The default assumes that the same job queue will be used. A
different job queue could be assigned. A listing would be displayed
with each job listed and the command command that will be used.
If an error had occurred, it is noted on the listing and the messages
associated with the error are noted in the job log. An escape
message would be issued if any errors occur.
It is possible to use CVTJOBQ2 multiple times to convert multiple job
queues to the same JOBQP2 file. The default on SBMJOBQ2 is to use
the same job queue name in the JOBQP2 as was captured by SBMJOBQ2.
Restrictions
------------
** When the tool was first issued (July 2011), PTFs were needed
for the sub tool RTVJOBA2. This added the format JOBI0310 to
the API QUSRJOBI. If the command fails, check with system
support to get the latest PTFs that affect the API.
** An *ALLOBJ user is required for both CVTJOBQ2 and SBMJOBQ2.
** Both the CVTJOBQ2 and SBMJOBQ2 commands use the model file
TAAJOFQP. The level ID must be the same if SBMJOBQ2 is used
on a different system.
** Any objects such as job descriptions, user profiles, output
queues, etc described for the jobs to be captured must exist
on the system where SBMJOBQ2 is used.
** To access the command for a job on a job queue, the RTVSBMCMD
TAA command is used. This accesses the information from a
listing created by the internal use of DSPJOBLOG. The job log
listing must be in either lower or upper case English.
** The RQSDTA parameter of the original SBMJOB (if it exists) is
assumed to be a command and will be used on the SBMJOB when
SBMJOBQ2 runs.
** The system library list parameter (SYSLIBL) on SBMJOB is
defaulted to *CURRENT. This means you must ensure the system
library list is the same (or will not change the results of
the job).
** The following parameters (in addition to SYSLIBL) are not
supported and the SBMJOB default will be used when SBMJOBQ2 is
run:
RTGDTA
INLASPGRP
CPYENVAR
CVTMSGQ2 escape messages you can monitor for
--------------------------------------------
None. Escape messages from based on functions will be re-sent.
SBMJOBQ2 escape messages you can monitor for
--------------------------------------------
None. Escape messages from based on functions will be re-sent.
CVTJOBQ2 Command parameters *CMD
---------------------------
JOBQ The qualified name of the job queue to capture
information from. The library value defaults to
*LIBL. A specific library or *CURLIB may also be
used.
OUTLIB The name of the library where the job information
will be written to the JOBQP2 file. The library
qualifier defaults to *LIBL. If the JOBQP2 file
does not exist, a specific library must be named.
*CURLIB may be used for the library qualifier.
OUTMBR The member of the JOBQP2 file to be written to.
JOBQP2 is the default. A specific member may be
named.
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 an existing
file.
SBMJOBQ2 Command parameters *CMD
---------------------------
JOBQP2LIB The library containing the JOBQP2 file. The file
must have been created by the CVTJOBQ2 command and
must have the same level ID as that used by the
CVTJOBQ2 command.
JOBQ The qualified name of the job queue to be written
to.
*OUTFILE is the default meaning to use the job queue
name that exists in the outfile when converted by
the CVTJOBQ2 command. It is possible to use
CVTJOBQ2 to write the information from multiple job
queues to the same JOBQP2 file. If *OUTFILE is
used, the library qualifier must be blank.
If a specific job queue is named and the library
qualifier is blank, *LIBL is assumed. A specific
library may be named or the special values *LIBL or
*CURLIB.
OUTPUT How to output the results. * is the default to
display the spooled file if the command is entered
interactively. The spooled file is deleted after it
is displayed.
If the command is entered in batch or *PRINT is
specified, the spooled file is output and retained.
Restrictions
------------
See the previous section.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
CHKOBJ3 Check object 3
CVTJOBQ Convert job queue
DUPTAADBF Duplicate TAA data base file
EDTVAR Edit variable
RSNALLMSG Resend all messages
RSNLSTMSG Resend last message
RTVDAT Retrieve date
RTVFMT Retrieve format
RTVJOBA2 Retrieve job attributes 2
RTVSBMCMD Retrieve submitted command
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDDIAGMSG Send diagnostic message
SNDESCINF Send escape information
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
------ ---- --------- ---------- ----------
CVTJOBQ2 *CMD TAAJOFQ QATTCMD
SBMJOBQ2 *CMD TAAJOFQ2 QATTCMD
TAAJOFQC *PGM CLP TAAJOFQC QATTCL
TAAJOFQC2 *PGM CLP TAAJOFQC2 QATTCL
TAAJOFQR *PGM RPG TAAJOFQR QATTRPG
TAAJOFQR2 *PGM RPG TAAJOFQR2 QATTRPG
TAAJOFQP *FILE PF TAAJOFQP QATTDDS
Structure
---------
CVTJOBQ2 Cmd
TAAJOFQC CL pgm
TAAJOFQR RPG Pgm
SBMJOBQ2 Cmd
TAAJOFQC2 CL pgm
TAAJOFQR2 RPG Pgm
|
