NetBatch Management Programming Manual

Commands and Responses
NetBatch Management Programming Manual—522462-003
5-25
ALTER JOB Command
Operational Notes
•
The ALTER JOB command is a sensitive command. It is available to all users, but
these conditions apply:
°
You can alter all attributes of a job if the job has a disk input file to which you
have write access. You can also alter all attributes of a job if the job’s input file
is a device or a process or does not exist, but you can do this only if you are
the job’s owner.
°
A NetBatch supervisor can alter all except these attributes of any job:
•
An ALTER JOB command that specifies neither ZBAT-TKN-SEL-USERNAME nor
ZBAT-TKN-SEL-NOTUSERNAME acts only on jobs owned by the requesting user.
•
To remove a master job from the list of masters specified by a dependent job’s
WAITON attribute, execute an ALTER JOB command with the ZINDICATOR field
of ZBAT-MAP-DEF-WAITON set to ZBAT-VAL-WAITON-REMOVE.
To remove a job’s WAITON attribute, execute an ALTER JOB command with the
ZMASTER field of ZBAT-MAP-DEF-WAITON set to spaces or a null value.
•
Attachment sets specified by an ALTER JOB command overwrite all existing
attachment sets of the job.
The order in which you specify a job’s attachment sets is the order in which the
scheduler supplies them to the job. For example, specifying sets C, B, and A in
that order makes the scheduler process set C first, set B second, and set A third.
If the name of an ASSIGN, DEFINE, or PARAM from a set conflicts with a name
from a set specified earlier, the scheduler overwrites the earlier ASSIGN, DEFINE,
or PARAM with the details of the later ASSIGN, DEFINE, or PARAM.
To remove a job’s ATTACHMENT-SET attribute, execute an ALTER JOB command
with ZBAT-TKN-ATT-SET-ID set to spaces or a null value.
•
These fields of ZBAT-MAP-DEF-JOB are returned in that token by the INFO JOB
command. The scheduler ignores them in the ALTER JOB command.
•
ZBAT-MAP-DEF-CRONTAB, ZBAT-TKN-CALENDAR, and the ZEVERY-DAYS,
ZEVERY-HOURS, and ZEVERY-MINUTES fields of ZBAT-MAP-DEF-JOB are
mutually exclusive.
ATTACHMENT-SET OUT STARTUP
EXECUTOR-PROGRAM PURGE-IN-FILE VOLUME
IN
ZINFO-NEXT-RUNTIME ZINFO-TOTAL-CPU-TIME
ZINFO-OPEN-ACCESSOR ZINFO-WHICH-LIS
ZINFO-OUT-SPOOL-NUM ZREMID
ZINFO-SPECIAL-REASON