TAA Tools
WRKJOB2         WORK JOB 2                             TAAJOCR

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

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

A typical command would be:

             WRKJOB2  JOB(xxx)

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

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

Command selection options exist for:

  **   Job name (or generic name) or *CURRENT or all jobs.

  **   User name (or generic name) or *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 DSPJOB2
------------------------

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

WRKJOB2  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,  a generic  name, or  *CURRENT may
                 be specified.

                 The  default  for the  USER  portion is  *CURRENT.   A
                 specific user name,  a generic  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 WRKJOB and  WRKJOB2 when the  subfile is
displayed.    WRKJOB2  does  not  show  all  of  the detail  job  types
supported by WRKJOB 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
     UNADOPT         Unadopt

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

None, the tool is ready to use.

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

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

   WRKJOB2       *CMD                   TAAJOCR       QATTCMD
   TAAJOCRC      *PGM       CLP         TAAJOCRC      QATTCL
   TAAJOCRC2     *PGM       CLP         TAAJOCRC2     QATTCL
   TAAJOCRR      *PGM       RPG         TAAJOCRR      QATTRPG
   TAAJOCRD      *FILE      DSPF        TAAJOCRD      QATTDDS
					

Added to TAA Productivity tools September 1, 1999


Home Page Up to Top