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


Home Page Up to Top