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
A typical command would be:
The job log would be converted and then displayed as:
Display Joblog 3 - TAA TAASYS7
Position to Msg Nbr . . _______1 Job: FAIL SLOAN 035017
Scan value . _________________ Total messages: 7 Comp Code: 20
First message: 02/03/09 08:47:15 Last message: 02/03/09 08:47:15
Type options, press Enter.
Opt MsgNbr Msg ID Type Text
_ 1 CPF1124 *INFO Job 035017/SLOAN/FAIL started on 02/03
_ 2 CPI1125 *INFO Job 035017/SLOAN/FAIL submitted.
_ 3 *NONE *RQS CALL PGM(SYSYSYS)
_ 4 CPD0170 *DIAG Program SYSYSYS in library *LIBL not fo
_ 5 CPF0001 *ESCAPE Error found on CALL command.
_ 6 CPC2402 *COMP Job ended. Cancel message received at c
_ 7 CPF1164 *COMP Job 035017/SLOAN/FAIL ended on 02/03/01
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
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
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.
The QPJOBLOG spooled file must exist. 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
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
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.
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
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
SPLNBR The file number of the spooled file. This defaults
to *LAST. *ONLY or a specific number may be
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
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.
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.
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
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
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