The Hold Job 2 command  holds one or more jobs using  the system HLDJOB
command.   Generic job names or user names  may be specified along with
a  subsystem name.  An ACTION  parameter allows either *CHECK or *HOLD.
HLDJOB2 can  assist when a  set of  jobs needs  to be held.   You  must
have *JOBCTL special authority to use HLDJOB2.

See the companion tool RLSJOB2.

A typical command would be:

              HLDJOB2       JOB(ABC*) ACTION(*HOLD)

All jobs  beginning with the  name ABC would  be held.  A  spooled file
would be displayed with the results.

HLDJOB2 escape messages you can monitor for
-------------------------------------------

      TAA9893    No jobs selected (occurs only if no display)

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

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

   JOB           The  job  or  generic  job name  to  check  for.   The
                 special value  *ALL  may  be  entered  for  *ALL  jobs
                 which  would  normally  be  used if  you  added  other
                 selection criteria.

   USER          The  user or  generic  user name  to check  for.   The
                 special value *ALL may be entered for *ALL users.

   SBS           The subsystem  or  generic  subsystem  name  to  check
                 for.  The special  value *ALL may be entered  for *ALL
                 subsystems.

   JOBSTS        The job  status to be  selected.  *ALL  is the default
                 for all status conditions.

                 The  other  supported  values are  *ACTIVE,  *JOBQ, or
                 *OUTQ.

   SPLFILE       A *YES/*NO parameter  that determines whether  spooled
                 files  will be  held for  the  jobs being  held.   The
                 value is passed to the HLDJOB command.

                 *NO is the default.

                 *YES  may be specified to hold  the spooled files if a
                 job is held.

   ACTION        The action to be performed.

                 *CHECK is the  default which does  not hold any  jobs,
                 but allows a review of what jobs would be held.

                 *HOLD may be specified to hold the selected jobs.

   OUTPUT        How  to output  the  results.   *  is  the default  to
                 display  the spooled  file if  the command  is entered
                 interactively.  The spooled  file is deleted after  it
                 is displayed.

                 If  the command  is  entered  in  batch or  *PRINT  is
                 specified,  the spooled file  is output  and retained.


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

You must have *JOBCTL special authority to use HLDJOB2.

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

The following TAA Tools must be on your system:

     CHKJOBCTL       Check *JOBCTL special authority
     CVTJOB          Convert jobs to an outfile
     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
   ------        ----    ---------      ----------    ----------

   HLDJOB2       *CMD                   TAAJOEV       QATTCMD
   TAAJOEVC      *PGM       CLP         TAAJOEVC      QATTCL
   TAAJOEVR      *PGM       RPG         TAAJOEVR      QATTRPG