TAA Tools
DSPJOB2         DISPLAY JOB 2                          TAAJOCS

The Display  Job 2  command is a  more powerful  version of  the system
DSPJOB command.   Both commands display the 'Display  Job' menu if only
a  single  job exists.   Both  commands display  a subfile  if multiple
jobs  exist.     DSPJOB2  supports  options   for  DSPJOB  and   DSPJOB
OUTPUT(*PRINT) and  all of the  detail options available on  the DSPJOB
menu.    When  the  option  completes,  the  subfile  is  re-displayed.
DSPJOB2 also allows options  for all jobs,  all users, job status,  and
job type.

To  request a  job  other than  the  current job,  the  user must  have
*JOBCTL authority.

A typical command would be:

             DSPJOB2  JOB(xxx)

If  only a single job  exists for the qualified  job name, the 'Display
Job' menu appears.

If multiple  jobs exist  for the  same qualified  job name,  a  subfile
display  appears   and   options  exist   to  use   DSPJOB  or   DSPJOB
OUTPUT(*PRINT)  or directly  access the  detail  options of  the DSPJOB
display.    When  the  option is  complete,  the  subfile  is displayed
again.

Command selection options exist for:

  **   Job name for *CURRENT or all jobs.

  **   User name for *CURRENT or all users.

  **   Job type (such as  *INTER) may be specified to display  only the
       interactive jobs.

  **   Job  status (such  as *JOBQ)  may be  specified to  display only
       those jobs on the job queue.

An  option exists to  determine what should  occur if no  jobs exist to
meet the  criteria  specified.    The  default is  to  send  an  escape
message.    You may  specify  that  the  user  should see  the  subfile
display with an appropriate message stating that no jobs exist.

Differences with WRKJOB2
------------------------

DSPJOB2  differs from the WRKJOB2  command in that no  options exist to
cause changes such as changing spooled  files or ending jobs that  have
locks.

DSPJOB2  escape messages you can monitor for
--------------------------------------------

      TAA9895    No jobs exist (Optional based on ESCAPE parm)

Escape messages from based on functions will be re-sent.

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

   JOB           The qualified job name  of the job to be  worked with.
                 The  default is  for all  jobs  for the  current user.
                 This  differs from the WRKJOB  default of a display of
                 the current job.

                 The default  for  the JOB  name portion  is  *ALL.   A
                 specific job name or *CURRENT may be specified.

                 The  default for  the  USER portion  is  *CURRENT.   A
                 specific user name or *ALL may be specified.

                 The  default for  the job number  portion is  *ALL.  A
                 specific number may be entered.

   STATUS        The status of  the job to be  displayed.  The  default
                 is *ALL for jobs in any status.

                 *ACTIVE, *JOBQ,  or *OUTQ  may be specified  to select
                 only those jobs that have the same status.

   TYPE          The type  of the job to be  displayed.  The default is
                 *ALL for any type of job to be displayed.

                 *AUTO, *BATCH, *INTER,  *SBS, *SPLRDR, *SPLWTR,  *SYS,
                 or *SCPF  may be specified  to select only  those jobs
                 that have the same type.

   ESCAPE        Whether  to send an  escape message  if no  jobs exist
                 for  the qualified  job name,  status, and  type.  The
                 default  is  *YES  which  means  the   TAA9895  escape
                 message would be sent.

                 *NO  may  be specified  to  cause  the  subfile to  be
                 displayed with an appropriate message.

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

There  are differences between  DSPJOB and DSPJOB2 when  the subfile is
displayed.   DSPJOB2  does  not  show  all  of  the  detail  job  types
supported by DSPJOB nor some of the details of the Status field.

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

The following TAA Tools must be on your system:

     CHKJOBCTL       Check job control
     CVTDAT          Convert date program
     FILEFDBCK       File feedback
     SNDESCMSG       Send escape message
     TAAEXC          TAA Execute command

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

None, the tool is ready to use.

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

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

   DSPJOB2       *CMD                   TAAJOCS       QATTCMD
   TAAJOCSC      *PGM       CLP         TAAJOCSC      QATTCL
   TAAJOCSC2     *PGM       CLP         TAAJOCSC2     QATTCL
   TAAJOCSR      *PGM       RPG         TAAJOCSR      QATTRPG
   TAAJOCSD      *FILE      DSPF        TAAJOCSD      QATTDDS
					

Added to TAA Productivity tools September 1, 1999


Home Page Up to Top