Integration with CA OPS/MVS › CA MIA VARY Delay Detected Event

CA MIA VARY Delay Detected Event

CA MIA monitors the progress of managed device VARY activity and provides the means to generate notifications, on a cyclical basis, should the VARY activity for a given device exceed an installation specified threshold.

Note: For more information about establishing the threshold and interval for VARY delay processing, see the description of the VARYDELAY keyword of the SETOPTION GTAF command in the Statement and Command Reference Guide.

When CA MIA detects that the attempt to VARY a managed device has exceed the specified threshold, it issues a highlighted MIM2211 console message on a cyclical basis until the VARY activity completes. CA MIA also directly notifies CA OPS/MVS of the VARY delay event and permits CA OPS/MVS to evaluate the VARY delay event in an )API rule. The )API rule can instruct CA MIA to continue waiting for the VARY to complete in which case CA MIA will continue waiting and the cyclical process will repeat again if the VARY device activity does not complete within the next VARYDELAY interval. Alternatively, the )API rule can instruct CA MIA to terminate the VARY device activity, in which case, CA MIA abends the target task processing the VARY device that is being delayed.

The CA MIA VARY device delay event is presented to CA OPS/MVS and can be processed by the following rule:

)API MIM2211

The available OPS/REXX variables for a CA MIA VARY device delay event are:

OPS/REXX Variable Value

API.APPLICATION MiMgr

API.VERSION Current release

API.LEVEL Service level

API.EVENTID MIM2211

API.MSGID MIM2211

API.TASKNAME 1 to 8 character CA MIM internal task name. This task name can be correlated to the CA MIM DISPLAY TASK command response.

API.TCB 8 character z/OS TCB address of the MIMTPVDV task that is experiencing the VARY device delay.

API.ACTION This variable is a read-write character variable. The variable is initialized to the character string 'CONTINUE' by CA MIA before the VARY delay event is presented to CA OPS/MVS. The )API rule can leave the ACTION variable unchanged in which case CA MIA will continue to wait for the VARY device to complete. Otherwise, the )API rule can change the ACTION variable to the text string 'ABORT' which will instruct CA MIA to terminate the VARY device processing that is being delayed.

API.TEXT MIM2211W VARY devn state delayed by nnn seconds. The format of the API.TEXT variable is the same as the MIM2211W console message. The MIM2211W message ID within the text is subject to message ID prefixing as controlled by the CA MIM command, SETOPTION MIM MSGPREFIX keyword.

devn

Specifies the target device number

state

Can be either 'ONLINE' or 'OFFLINE'

nnn

Specifies the number of seconds that have elapsed since the VARY device was initiated.

Member APIMIMGR of HLQ.OPS.SAMPLE.RULES demonstrates how to use the MIM2211 API.