The Change Job Queue Jobs command allows changes to one, generic, or
all jobs in a job queue. The jobs may be held, released, or ended.
In addition, some parameters from CHGJOB are also valid such as JOBQ,
RUNPTY, OUTPTY, OUTQ, etc. *JOBCTL special authority is required.
A typical command to hold all jobs in a job queue beginning with the
name WRK:
CHGJOBQJOB JOBQ(xxx) JOB(WRK*) STATUS(*HLD)
A typical command to change all jobs beginning with PAY in a job
queue to the job queue NIGHT:
CHGJOBQJOB JOBQ(xxx) JOB(PAY*) TOJOBQ(NIGHT)
A typical command to change all jobs in a job queue to RUNPTY(32)
would be:
CHGJOBQJOB JOBQ(xxx) RUNPTY(32)
If a STATUS(*HLD) is specified and the job is already held, an escape
message will occur at the end of the command.
If a STATUS(*RLS) is specified and the job is already released, an
escape message will occur at the end of the command.
If all of the parameters are specified as *SAME, a completion message
occurs stating that no changes occurred.
If one of the CHGJOB type parameters is specified (such as TOJOBQ)
and specifies the current value for the job, the job is considered
changed. For example, if TOJOBQ(NIGHTQ) is specified and the job is
already on the NIGHT job queue, the job is considered changed.
CHGJOBQJOB escape messages you can monitor for
----------------------------------------------
TAA9895 No jobs on job queue or no job by job parm name.
TAA9896 Some errors occurred - See previous messages
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
JOBQ The qualified name of the job queue where the jobs
exist. The library value defaults to *LIBL.
*CURLIB may also be used.
JOB The job name to be changed. The default is *ALL for
all jobs on the job queue. A specific job name or a
generic job name may be entered.
STATUS The status the job should be set to. For example,
the job may be in a 'released' status waiting to be
run and you want to set it to a 'hold' status.
*SAME is the default meaning whatever the current
status is.
*HLD may be specified to hold the job. The job must
be in a 'release' status.
*RLS may be specified to release the job. The job
must be in a 'hold' status.
*END may be specified to end the job. The may be in
either a 'release' or 'hold' status.
SEQ How to sequence the jobs when they are processed.
The default is *API meaning the data appears in the
sequence as extracted from the API.
*WRKJOBQ may be specified to duplicate the sequence
of the jobs as they appear on the system WRKJOBQ
display. In most situations this will be a 100%
match. See the discussion of sequencing for the
CVTJOBQ command.
TOJOBQ The qualified name of the job queue to be used
instead of the current job queue. The default is
*SAME meaning the job's current job queue. *LIBL or
*CURLIB or a specific library may be used for the
qualified name.
JOBPTY The job priority of the job (priority on the job
queue). *SAME is the default meaning the job's
current job queue priority. A value between 1 and 9
may be entered (1 is the highest priority). The
value is restricted by the PTYLMT parameter of the
user profile.
OUTPTY The output priority of the job (priority on the
output queue). *SAME is the default meaning the
job's current output queue priority. A value
between 1 and 9 may be entered (1 is the highest
priority). The value is restricted by the PTYLMT
parameter of the user profile.
OUTQ The qualified name of the output queue to be used
for the job. *SAME is the default meaning the job's
current output queue. *LIBL or *CURLIB or a
specific library may be used for the qualified name.
RUNPTY The run priority of the job. *SAME is the default
meaning the job's current run priority. A value
from 1 to 99 may be entered (1 is the highest
priority).
PRTTXT The 'Print Text' for the job that will print at the
bottom of any printed output. *SAME is the default
meaning the job's current 'Print Text'. A string of
up to 30 bytes may be entered.
LOG The Message Logging of the job. This is a 3 part
parameter that is the same as on CHGJOB. The parts
are:
Level. The default is *SAME meaning the job's
current message level. 0-4 may be entered.
Severity. The default is *SAME meaning the job's
current message severity. 00-99 may be entered.
Text. The default is *SAME meaning the job's
current message text value. *MSG, *SEVLVL, or
*NOLIST may be entered.
INQMSGRPY The Inquiry Message Reply for the job. The default
is *SAME meaning the job's current Inquiry Message
Reply value. *RQD, *DFT, or *SYSRPYL may be
entered.
DATE The job date for the job. The date should be
entered in job format.
SCDDATE The date the job should be scheduled. The date
should be entered in job format.
SCDTIME The time the job should be scheduled. The time
should be entered in hhmmss format.
Restrictions
------------
*JOBCTL special authority is required.
The priority values cannot be changed to a better priority than
exists in the user profile.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKGENERC Check generic
CHKJOBCTL Check *JOBCTL special authority
CHKOBJ3 Check object 3
CVTJOBQ Convert job queue
EDTVAR Edit variable
RSNLSTMSG Resend last message
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CHGJOBQJOB *CMD TAAJOCY QATTCMD
TAAJOCYC *PGM CLP TAAJOCYC QATTCL
|
