CA MIA monitors managed device VARY activity and generates notification when a VARY command for a given device is requeued by z/OS. z/OS requeues a VARY command when ENQ resources necessary for z/OS to serialize a VARY command with other system functions cannot be obtained within 5 seconds. VARY REQUEUE Notification occurs when the number of times that a VARY command has been requeued exceeds an installation specified threshold.
Note: For more information about establishing the threshold for VARY REQUEUE Notification, see the description of the VARYRQNTFY keyword of the SETOPTION GTAF command in the CA MIM Statement and Command Reference Guide.
When CA MIA detects that the number of times that a VARY command for a managed device has been requeued exceeds the VARYRQNTFY threshold, it issues a MIM2225 console message. This message is issued on an iterative basis until the VARY activity completes. CA MIA also directly notifies CA OPS/MVS of the VARY REQUEUE event and permits CA OPS/MVS to evaluate the VARY REQUEUE event in an ‘)API rule’. The ‘)API rule’ can instruct CA MIA to continue to retry the VARY command. In this case CA MIA will reset the requeue counter for the VARY command. The VARY REQUEUE Notification process will repeat again if the SYSIEFSD ENQ contention issue remains in effect. Alternatively, the ‘)API rule’ can instruct CA MIA to terminate the VARY device activity. In this case, CA MIA will not retry the VARY command and will remove it from the CA MIA VARY command processing queue.
The CA MIA VARY Requeue Notification event is presented to CA OPS/MVS and can be processed by the following rule:
)API MIM2225
The available OPS/REXX variables for a CA MIA VARY Requeue Notification event are:
Variable Value
MiMgr
Current release
Service level
MIM2225
MIM2225
1 to 8 character CA MIM internal task name. This task name can be correlated to the CA MIM DISPLAY TASK command response.
8 character z/OS TCB address of the MIMTPVDV task that has been requeued.
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 this case, CA MIA will continue to retry the VARY command until it eventually completes when ENQ contention has been relieved. Alternatively, the )API rule can change the ACTION variable to the text string 'ABORT'. The ‘ABORT’ ACTION variable instructs CA MIA NOT to retry a VARY command that has been requeued due to ENQ contention.
MIM2225W VARY 078F OFFLINE REQUEUED - SYSIEFSD Q4 ENQ CONTENTION. The format of the API.TEXT variable is the same as the MIM2225W console message. The MIM2225W message ID within the text is subject to message ID prefixing as controlled by the CA MIM command, SETOPTION MIM MSGPREFIX keyword.
Specifies the target device number
Can be either ONLINE or OFFLINE.
Member APIMIMNW of HLQ.OPS.SAMPLE.RULES demonstrates how to use the MIM2225 API.
|
Copyright © 2014 CA.
All rights reserved.
|
|