XSUTMTRX (matrix job management) automation control point
Variable name | Contents | Possible values |
|---|---|---|
function_name | Type of utility that is waiting |
|
dbname | Database name | Not applicable |
tsname | Table space name | Not applicable |
partition | Partition number | Not applicable |
desired_access | Access requested by the utility on the object | Not applicable |
holding_access. | Stem variable indicating current access on the object | Not applicable |
holding_uid. | Stem variable indicating the utility IDs holding access to the object | Not applicable |
holding_jobname. | Stem variable indicating the job name associated with the hold | Not applicable |
holding_job#. | Stem variable indicating the job number associated with the hold | Not applicable |
holding_function. | Stem variable indicating the type of utility associated with the hold | Not applicable |
waiting_uid. | Stem variable indicating the utility IDs waiting for the object | Not applicable |
waiting_jobname. | Stem variable indicating the job name associated with the waiting object | Not applicable |
waiting_job#. | Stem variable indicating the job number associated with the waiting object | Not applicable |
waiting_function. | Stem variable indicating the type of utility waiting for the object | Not applicable |
wait_time | Maximum number of minutes to wait for a matrix lock release See Usage considerations. | Not applicable |
Return codes
The XSUTMTRX automation control point returns the following return codes:
Return code | Description |
|---|---|
0 | Wait on the object as follows:
|
4 | Exclude the object from processing |
Any other value | Abnormal termination Set the return code to a value greater than 4 to cancel the entire job. |
Usage considerations
The automation control point does not check wait time until the calling job is not processing any other work. If the calling job is waiting for work, then the automation control point checks wait time for matrix entries.