NetBatch Management Programming Manual

Commands and Responses
NetBatch Management Programming Manual—522462-003
5-45
RELEASE JOB Command
ZSPI-TKN-RESPONSE-TYPE
is the standard SPI response-type token that lets the requester specify whether the
server (that is, the scheduler) is to return all responses. The values are:
If you specify ZSPI-VAL-ERR-WARN-AND-NORM, the requester must receive all
responses from and return all context tokens to the scheduler. If the requester
does not do this, the command might not release all possible jobs.
The default value is ZSPI-VAL-ERR-AND-WARN.
Operational Notes
•
The RELEASE JOB command is a sensitive command available to all users.
•
The process sending the command (that is, the requester process) must be a
NetBatch job.
•
The requester process (the master job) must supply its own job name in the
ZRELEASER field of ZBAT-MAP-PAR-RELEASE-JOB if the dependent job is
running in a different scheduler from that of the master job. For the requester
process to get its own job name, it must:
1. Call Guardian procedure PROCESS_GETINFO_ to return its job ID and the
process handle of its ancestor (that is, the process handle of its GMOM, or
scheduler). The procedure’s jobid and gmom’s-processhandle fields
return this information.
2. Call Guardian procedure PROCESS_GETINFO_ again, this time supplying the
process handle obtained at Step 1 in the procedure’s processhandle field.
The procedure returns the scheduler’s name in the proc-fname:maxlen
field.
3. Execute a STATUS JOB job-ID command on the scheduler identified at Step
2, where job-ID is the job ID returned at Step 1. The command returns the
job name in response-buffer token ZBAT-TKN-SEL-JOBNAME.
ZSPI-VAL-ERR-
AND-WARN
Causes the scheduler to return a single response record
indicating whether the command was successful. ZSPI-TKN-
DATALIST tokens returned in the response record are ZSPI-TKN-
ERRLIST, ZSPI-TKN-ENDLIST, and ZSPI-TKN-RETCODE.
ZSPI-VAL-ERR-
WARN-AND-
NORM
Causes the scheduler to return a response record for each job it
releases from the set of jobs specified in the command. ZSPI-
TKN-DATALIST tokens returned in each response record are
ZBAT-TKN-SEL-JOBNAME, ZBAT-TKN-SEL-JOB-NUMBER,
ZSPI-TKN-ERRLIST, ZSPI-TKN-ENDLIST, and ZSPI-TKN-
RETCODE.