TAA Tools
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:

             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.
          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

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

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

        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
                 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.


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


   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

Home Page Up to Top