DSPJOBLOG3 DISPLAY JOB LOG 3 TAALOGG |
The Display Job Log 3 command provides a different method of viewing
a job log. The messages are displayed on an 80 byte wide display
using a subfile with one line per message plus a detail display
option. Different positions within the subfile can be quickly
displayed along with a scanning capability to find any character
string.
A typical command would be:
DSPJOBLOG3 JOB(xxx)
The job log would be converted and then displayed as:
**********************************************************************
Display Joblog 3 - TAA
Position to Msg Nbr . . . 1 Job: QPADEV0001 DDYKSTAL
Scan value . Total messages: 412
First message: 03/31/23 14:35:13 Last message: 03/31/23 15:40:5
Type options, press Enter.
5=Display 6=Print
Opt MsgNbr Msg ID Type Text
1 CPF1124 *INFO Job 698052/DDYKSTAL/QPADEV0001 started
2 CPC2101 *COMP Library list changed.
3 CPC2198 *COMP Current library changed to DDYKSTAL.
4 *NONE *RQS -RPLDSPF FILE(TAATOOL/TAALOGGD) SRCFILE
5 CPI2126 *INFO AUT parameter ignored.
6 CPI2121 *INFO Replaced object TAALOGGD type *FILE wa
7 TAA9855 *COMP RPLDSPF successfully created display f
8 *NONE *RQS -crttaatool dspjoblog3 ddz096
9 CPC7301 *COMP File QSQLTEMP1 created in library QTEM
10 CPC7305 *COMP Member TAALOGGR added to file QSQLTEMP
11 CPC0904 *COMP Data area RETURNCODE created in librar
F3=Exit F11=View 2 F12=Cancel F16=Scan F18=Bottom
**********************************************************************
Option 5 displays the details of a specific message.
All Option 6 selections are printed when the Enter Key is pressed to
a single spooled file named TAAJOBLOG. This allows you to select
only certain messages to be printed to make a subset joblog. For
example, if you have a large job log and have discovered about where
the error is, you can print several messages before and including the
error condition.
DSPJOBLOG3 is an option on the WRKALLSPL2 command. If you have
existing job logs for your user profile, and would like a simple
demonstration, use WRKALLSPL2 and Option 16 on a QPJOBLOG spooled
file.
Multiple jobs of the same name
------------------------------
If multiple jobs exist that satisfy the JOB and STATUS parameters, a
subfile of jobs is displayed using the TAA Tool DSPDUPJOB and the
user can select the required job to be processed by DSPJOBLOG3. When
DSPJOBLOG3, the return is to the DSPDUPJOB display.
QPJOBLOG requirements
---------------------
The QPJOBLOG spooled file must exist, except when the current job is
specified and REFRESH(*YES) is used. Only job logs written in upper
or lower case English and can be copied by CPYSPLF are supported.
The job log can be in any output queue as long as the user is
authorized.
It is possible that multiple job logs exist for the same job. This
would typically occur if the system DSPJOBLOG command was used with
OUTPUT(*PRINT) and the job completion function also caused a job log.
DSPJOBLOG3 selects the last QPJOBLOG file written for a job by
default. This will most likely be the job completion version.
It is possible that multiple job logs will exist while the job is
still active.
It is also possible for a user with *JOBCTL special authority to use
DSPJOBLOG OUTPUT(*PRINT) for a job other than his own. The spooled
file is named QPJOBLOG and will be owned by the current user (not
necessarily the user of the job).
Assume the name of the current job is DSP01 and the job that was
specified for DSPJOBLOG was XX1. If the DSP01 user requests
DSPJOBLOG3 JOB(*), he would see the QPJOBLOG spooled file of job XX1.
Authorization requirements
--------------------------
A user may display his own QPJOBLOG file, but must have *JOBCTL
authority to display job logs for a different user.
DSPJOBLOG3 escape messages you can monitor for
----------------------------------------------
DSPJOBLOG3 does not send any escape messages that could be monitored
for. However, the escape messages from CPYSPLF will be re-sent such
as:
CPF3303 No QPJOBLOG spooled file exists for the job
CPF3342 Job not found
CPF3429 File cannot be copied
Command parameters *CMD
------------------
JOB The qualified name of the job to display the job log
for. The default is * for the current job. The
last QPJOBLOG spooled file for the job will be
displayed.
SPLNBR The file number of the spooled file. This defaults
to *LAST. *ONLY or a specific number may be
specified.
STATUS The status of the job requested. The default is
*ALL for all status conditions.
A specific status may be entered if you have
multiple jobs of the same name and did not enter a
fully qualified job name.
*ACTIVE may be specified if the job is still active.
The QPJOBLOG spooled file must exist which means the
job must have run the DSPJOBLOG system command and
specified OUTPUT(*PRINT). The last version of
QPJOBLOG will be displayed.
*OUTQ may be specified if the job has completed and
the job log is in an output queue.
JOBLOGPLIB The library for the JOBLOGP file created by
CVTJOBLOG. QTEMP is the default.
A specific library may be named if you have already
done CVTJOBLOG to create a JOBLOGP file in a
specific library.
The intent of this function is to allow large job
logs which may need to be reviewed multiple times to
have the conversion done once.
REFRESH If the current job is requested then run a DSPJOBLOG
to create a QPJOBLOG spooled file and run CVTJOBLOG
to convert that into a JOBLOGP file.
The intent is to allow a convenient way to present a
view of the job log of the current job in a far more
convenient format than DSPJOBLOG.
Restrictions
------------
DSPJOBLOG3 uses the CVTJOBLOG TAA Tool which operates only on upper
and lower case English.
CVTJOBLOG also uses CPYSPLF which prevents some spooled files from
being copied such as those with ASCII data. The restrictions would
be rare in a job log spooled file.
Prerequisites
-------------
The following TAA Tools must be on your system:
ADJVAR Adjust variable
CVTDAT Convert date
CVTTIM Convert time
CVTJOBLOG Convert job log
CVTSPLNBR Convert spool number
DSPDUPJOB Display duplicate job
FILEFDBCK File feedback
HLRMVMSG HLL Remove message
RTVJOBSTS Retrieve job status
RTVSYSVAL3 Retrieve system value 3
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
------ ---- --------- ---------- ----------
DSPJOBLOG3 *CMD TAALOGG QATTCMD
TAALOGGC *PGM CLP TAALOGGC QATTCL
TAALOGGR *PGM RPG TAALOGGR QATTRPG
TAALOGGR2 *PGM RPG TAALOGGR2 QATTRPG
TAALOGGR3 *PGM RPG TAALOGGR3 QATTRPG
TAALOGGD *FILE DSPF TAALOGGD QATTDDS
Structure
---------
DSPJOBLOG3 Cmd
TAALOGGC CL pgm
TAALOGGR RPG Pgm - Check for same joblog in QTEMP files
TAALOGGR2 RPG Pgm - Main display program
TAALOGGD Display file
TAALOGGR3 RPG Pgm - Print program for Option 6
|
Added to TAA Productivity tools April 23, 2001
