TAA Tools
CLRJOBQ2        CLEAR JOB QUEUE 2                      TAAJOFW

The Clear Job  Queue 2 command clears  selected jobs from a  job queue.
Jobs may  be cleared based on a combination  of selection criteria such
as  job, user, status, and priority.   At least one selection type must
be made.   A  job  must satisfy  all selection  types  specified to  be
ended.   A  'check option'  exists to  allow a  determination  of which
jobs would be ended.

You must have *JOBCTL special authority to use CLRJOBQ2.

A typical command would be:

             CLRJOBQ2  JOBQ(xxx) USER(uuu)

All  jobs on the  job queue for the  specified user would  be ended.  A
message for each job ended would appear.

Multiple selection criteria may be used such as:

             CLRJOBQ2  JOBQ(xxx) JOB(ABC*) USER(uuu) ENDJOB(*YES)

Any job  name  beginning  with ABC  and  the specified  user  would  be
ended.

CLRJOBQ2 escape messages you can monitor for
--------------------------------------------

      TAA9891    No jobs exist on the job queue
      TAA9892    Some error occurred
      TAA9893    No jobs match the selection criteria

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

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

   JOBQ          The  qualified name  of the  job queue.   The  library
                 value  defaults  to  *LIBL.    A  specific library  or
                 *CURLIB may also be used.

   JOB           The job  or  generic  job  name  to  be  ended.    The
                 default   is   *ALL  meaning   all   job   names   are
                 considered.

   USER          The user  or generic user of  a job to be  ended.  The
                 default   is   *ALL   meaning  all   user   names  are
                 considered.

   STATUS        The status of jobs  to be ended.  The default  is *ALL
                 meaning  all  status  conditions  are considered.    A
                 value of *RLS, *SCD, or *HLD may be entered.

   JOBPTY        The  priority of  jobs to  be ended.   The  default is
                 *ALL meaning all priorities  are considered.  A  value
                 between 1 and 9 may be entered.

   ENDJOB        The action to be taken if a job is selected.

                 *CHECK is  the default  to receive  messages on  which
                 jobs would be ended.

                 *YES may be specified to end any selected jobs.

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

You must have *JOBCTL special authority to use CLRJOBQ2.

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

The following TAA Tools must be on your system:

     CHKGENERC       Check generic
     CHKJOBCTL       Check *JOBCTL special authority
     CVTJOBQ         Convert job queue
     CHKOBJ3         Check object 3
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVJOBQA        Retrieve job queue attributes
     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
   ------        ----    ---------      ----------    ----------

   CLRJOBQ2      *CMD                   TAAJOFW       QATTCMD
   TAAJOFWC      *PGM       CLP         TAAJOFWC      QATTCL
					

Added to TAA Productivity tools October 15, 2012


Home Page Up to Top