Writer instructions | |
|---|---|
Page title | For most spaces, this page must be titled Space announcements. For spaces with localized content, this page must be titled Space announcements l10n. |
Purpose | Provide an announcement banner on every page of your space. |
Location | Move this page outside of your home branch. |
Guidelines | |
XSUTMTRX (matrix job management) automation control point
Use the XSUTMTRX automation control point to exclude certain objects from processing if the product finds that another product is executing on the requested object. The automation control point provides the options to wait for the hold to be released or skip the object and continue processing.
The automation component invokes this automation control point before the first BMC AMI Utility of a set runs.
Variables
The following table describes the variables used in the XSUTMTRX 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.