INGRCHCK
Purpose
The INGRCHCK command checks whether a particular resource is in a specific state by checking the observed status of the resource. If the resource is not in the expected state, INGRCHCK waits until the resource reaches this status.
Syntax
Parameters
- resource
- This is the name of the resource. It can be either a subsystem name or a resource name in automation manager notation.
- OBSERVED
- This is the observed status that the resource should be in. You can specify more than one status. If you specify more than one status, they must be separated by a blank character and enclosed in parentheses. The observed status can be abbreviated, for example, SO for softdown. Here is a list of possible Observed Status values and their shortest possible abbreviations: AVAILABLE (A), UNKNOWN (U), SYSGONE (SY), SOFTDOWN (SO), HARDDOWN (H), STARTING (STAR), DEGRADED (D), STOPPING (STO), PROBLEM (P), WASAVAILABLE (W), and STANDBY (STAN).
- INTERVAL
- This specifies the time interval that the routine uses to periodically check whether the resource is in the expected state. The default is 5 seconds. The maximum is 999 seconds.
- MAXINT
- This specifies the maximum number of retry intervals allowed. The default for MAXINT is 0 (zero) which means infinite retries.
Examples
INGRCHCK AM2/APL/AOC8 OBSERVED=(SO H)Return Codes
- 0
- OK.
- 1
- Error occurred.
- 2
- Retry limit reached.
- 6
- Automation not initialized.
Usage
The INGRCHCK command is primarily used in shutdown scenarios. It is potentially task blocking, unless you use the MAXINT parameter to avoid infinite times of resource status check.
To use it outside of shutdown scenarios, it's recommended to run it in a user owned autotask rather than in standard SA z/OS autotasks.