TAA Tools
DSPSBMJOB       DISPLAY SUBMITTED JOBS                 TAAJOCD

The Display Submitted Jobs  command provides a display that  is similar
to that  provided by the system WRKSBMJOB command  except that the user
cannot  perform actions against the jobs.   An option exists to allow a
display of any spooled  files associated with the  job.  An outfile  is
optional.    DSPSBMJOB may  be  helpful if  you  have  a menu  oriented
system  and want  to prevent  users from  changing, holding,  or ending
batch jobs.

The model file is TAAJOCDP with a format of SBMJOBR.

The intent  of  the command  is  that it  would  be  used in  place  of
WRKSBMJOB  as an  option  on a  user  menu.   No  command line  exists.
However, if  the spooled file option is  specified, a command line does
exist on the system spooled file display.

A typical command would be:

          DSPSBMJOB

This displays the  jobs submitted  by the  current user  in job  number
order.   The  display  that  appears is  similar  to that  provided  by
WRKSBMJOB,  but would  only allow  the option  to display  more details
about the job or to work with the spooled files of the job.

The  SPLF parameter allows control of  whether the user will be allowed
to see any spooled files  of a submitted job, just display  the spooled
files, or have the full capability of WRKJOB OPTION(*SPLF).

The  SPLF option *PGM  may also  be used  to run  a user  exit program.
The  intent of this  function is to  be able  to do a  function such as
the TAA WRKALLSPLF command.  See the later discussion.

The APIs used include:

       - QUSCRTUS
       - QUSLJOB
       - QUSRTVUS
       - QUSRJOBI

Ascending or Descending option
------------------------------

F6  may  be  used  to  flip/flop  the  display  between   ascending  or
descending  order  of  Job  Numbers.   The  display  first  appears  in
'Ascending order'  (described in the upper right  hand corner) with the
F6 text at the bottom of the display allowing for 'Descending'.

If F6 is  pressed, the display is  refreshed so the  text in the  upper
right hand corner  indicates 'Descending sequence'  and the F6  text at
the bottom becomes 'Ascending'.

The F6  option is not  valid if the  Job Numbers retrieved  have rolled
over from 999999 to 000001.

Spooled file handling program
-----------------------------

By  specifying  SPLF(*PGM)  and  naming  a  user  exit  program  in the
SPLFPGM parameter, a  user program  can be used  instead of the  system
functions to process spooled files.

The TAA WRKALLSPLF  command may be used to allow a  user defined set of
options and command keys.

The user program is passed 3 parameters:

       - Job name            *CHAR LEN(10)   Requested job name
       - Job user            *CHAR LEN(10)   Requested job user
       - Job number          *CHAR LEN(6)    Requested job number

A typical program would be coded as:

             PGM        PARM(&JOB &USER &JOBNBR)
             DCL        &JOB *CHAR LEN(10)
             DCL        &USER *CHAR LEN(10)
             DCL        &JOBNBR *CHAR LEN(6)
             WRKALLSPLF JOB(&JOBNBR/&USER/&JOB)
             ENDPGM

Other   options  could   be  specified   on  the   WRKALLSPLF  command.
Specifying the qualified  job name  causes only the  spooled files  for
the named job to be displayed.

A demonstration program  is available using the above code.   Invoke it
as:

             DSPSBMJOB   SPLF(*PGM) PGM(TAATOOL/TAAJOCDC12)

Command parameters                                    *CMD
------------------

   SBMFROM       The type  of submitted jobs to be  displayed.  This is
                 the same  parameter  as  on WRKSBMJOB,  but  the  only
                 value is  *USER which displays  the jobs  submitted by
                 the current user.

                 The  parameter exists  to allow  for  future expansion
                 if  the system APIs provide for  a rapid access to the
                 WRKSBMJOB functions of *WRKSTN and *JOB.

   SPLF          Whether to  allow the  user  to display  or work  with
                 the  spooled  files  of   the  submitted  jobs.    The
                 default  is *WRK which  causes the  function of WRKJOB
                 JOB(xxx) OPTION(*SPLF)  to be  used.   The user  would
                 have full  control to display,  change, or  delete the
                 spooled  files in  addition to  being able  to respond
                 to spool messages.

                 *DSP  may  be  specified  to  cause  the  function  of
                 DSPJOB JOB(xxx)  OPTION(*SPLF) to be  used.   The user
                 can  only display  the spooled  files  associated with
                 the job.

                 *PGM  may be  specified if a  program is  named in the
                 SPLFPGM parameter to allow  a user program to  process
                 the spooled  files.  The  intent of this  parameter is
                 to  allow  a  function  such  as  the  TAA  WRKALLSPLF
                 command to be  used.   See the  previous comments  for
                 how to write the program.

                 *NONE may  be specified to  prevent the user  from any
                 access to the spooled files of the job.

   SPLFPGM       The  qualified  name of  the user  program  to process
                 spooled files.   The  default is  blank for  both  the
                 program  and library  name.   If  a  name is  entered,
                 SPLF(*PGM)  must   be  specified.     If  the  library
                 qualifier is blank, *LIBL is assumed.

                 See  the  previous discussion  for the  parameter list
                 passed to the program and sample code.

   OPTION8TXT    The  constant  to   be  displayed  if   SPLF(*PGM)  is
                 specified.   The default is  *DFT meaning the  name of
                 the program will be displayed.

                 A  value  may be  entered such  as  '8=Display spooled
                 files'.

   OUTPUT        The type of  output.  *DSP is  the default to  display
                 the output.

                 *OUTFILE may  be entered to  create an outfile  of the
                 information.

   OUTLIB        The   library  to  be  used   if  OUTPUT(*OUTFILE)  is
                 specified.  *LIBL is  the default and  may be used  if
                 the SBMJOBP file  already exists on the  library list.

                 A specific library may be entered.

   OUTMBR        The  member  to   be  used  in  the  SBMJOBP  outfile.
                 *FIRST is the default.

                 A specific member may be named.

   REPLACE       Whether  to  replace the  data  in the  member  of the
                 outfile.  *YES is the default.

                 *NO may  be  specified to  add  data to  the  existing
                 member.

Restrictions
------------

A maximum of 9999  jobs can be displayed or output to  the outfile.  If
the  limit  is  exceeded,  a  message  appears  on  the  first  display
informing the user that not all jobs are shown.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CVTDTS          Convert date/time in *DTS format
     DUPTAADBF       Duplicate data base file
     EDTVAR          Edit variable
     FILEFDBCK       File feedback
     HLRMVMSG        HLL Remove message
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   DSPSBMJOB     *CMD                   TAAJOCD       QATTCMD
   TAAJOCDC      *PGM       CLP         TAAJOCDC      QATTCL
   TAAJOCDC11    *PGM       CLP         TAAJOCDC11    QATTCL
   TAAJOCDC12    *PGM       CLP         TAAJOCDC12    QATTCL
   TAAJOCDR      *PGM       RPG         TAAJOCDR      QATTRPG
   TAAJOCDD      *FILE      DSPF        TAAJOCDD      QATTDDS
   TAAJOCDP      *FILE      PF          TAAJOCDP      QATTDDS

The  CL  program  TAAJOCDC12  is   a  demo  function  of  the   SPLFPGM
capability.
					

Added to TAA Productivity tools June 1, 1997


Home Page Up to Top