CVTJOBLOG2 CONVERT JOB LOG 2 TAALOGL |
The Convert Job Log 2 command creates an outfile of one record per
batch job that was submitted and has completed. Selection on the
completion code (defaults to abnormal job end) may be specified. The
command is a slow runner, but the outfile can be used to help
understand the failures that have occurred. The command is English
language dependent.
You must have *ALLOBJ special authority to use CVTJOBLOG2.
The file output is always JOBLOGP2 which uses a format name of
JLGRCD2 and a model file named TAALOGLP.
A typical command would be:
CVTJOBLOG2 OUTLIB(xxx)
By default, job logs created by system created profiles except for
QPGMR, QSECOFR, and QUSER would be bypassed. One record would be
written for each submitted batch job that did not successfully
complete.
The record would contain the identifying job information, the
completion code and the first line of the first Request type message.
A special case is made for job logs created by the TAA SBMPARMS tool
which is intended to be used with the Programmers Menu. If the
program sending the request message is TAASRCDC2 in TAATOOL, the
first line of message text for the Request message is used instead of
the first Request message for the job.
CVTJOBLOG2 escape messages you can monitor for
----------------------------------------------
None. Escape messages from based on functions will be re-sent.
CVTJOBLOG2 Command parameters *CMD
-----------------------------
COMPTYPE The type of completion code to write a summary
record for. Only submitted batch jobs are
considered.
The default is *ABNORMAL meaning any job completion
code that is not 0.
*ALL may be specified for all submitted batch jobs.
OUTLIB The library in which the JOBLOGP2 file will be
placed. The default is *LIBL. If the file does not
already exist, a library must be specified.
OUTMBR The member of the JOBLOGP2 file to be used. If the
member does not exist, it is added. The default is
JOBLOGP2.
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.
OUTQ The qualified name of the output queue to be
processed. QEZJOBLOG is the default. The library
value defaults to *LIBL. A specific library or
*CURLIB may be entered.
JOB The job name or generic name to be selected. *ALL
is the default.
USER The user name or generic name to be selected.
*ALLUSR is the default meaning that all system
created profiles except QPGMR, QSECOFR, and QUSER
would be bypassed. Other system created profiles
are bypassed by the use of the tool RTVIBMPRF (see
the source with DSPTAA TAASEFCC).
A specific name (including system profile names), a
generic name, or the special value *ALL may also be
entered which will include system profile names).
FROMDATE The From date to be selected. The default is
*FIRST. *TODAY may be specified for the current
date.
FROMTIME The From time to be selected. The default is *FIRST
meaning the first time on the FROMDATE value.
TODATE The To date to be selected. The default is *LAST.
TOTIME The To time to be selected. The default is *LAST
meaning the last time on the TODATE value.
Restrictions
------------
You must have *ALLOBJ special authority to use CVTJOBLOG2.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
CHKGENERC Check generic
CHKIBMPRF Check IBM profile name
CHKOBJ3 Check object 3
CVTJOBLOG Convert job log
CVTOUTQ Convert output queue
DUPTAADBF Duplicate TAA data base file
EDTVAR Edit variable
RSNLSTMSG Resend last message
RTVDAT Retrieve date
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion 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
------ ---- --------- ---------- ----------
CVTJOBLOG2 *CMD TAALOGL QATTCMD
TAALOGLC *PGM CLP TAALOGLC QATTCL
TAALOGLR *PGM RPG TAALOGLR QATTRPG
TAALOGLP *FILE PF TAALOGLP QATTDDS
|
Added to TAA Productivity tools October 15, 2013