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

A typical command would be:

             DSPJOBLOG3   JOB(xxx)

The job log would be converted and then displayed as:

***********************************************************************

                            Display Joblog 3 - TAA              TAASYS7
                                                      2/03/09  18:36:15
 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.
   5=Display     6=Print

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

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


Home Page Up to Top