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