Using System State Manager › How to Specify and Store Actions › SSM Action Processes Default Logic › How SSMRETRY Limits a Repetitive Action Sequence

How SSMRETRY Limits a Repetitive Action Sequence

The SSMRETRY request rule is a technique that you can use to limit a repetitive action sequence from occurring, such as starting a problem resource.

The SSMRETRY request rule performs the following actions and causes these effects:

• The parameters that pass to SSMRETRY specify how many start attempts should be made within a defined time period.

  For example, if SSM starts a resource on a system as a result of DESIRED_STATE='UP', the resource starts on the system (CURRENT_STATE='STARTING'), but then terminates abnormally (CURRENT_STATE='DOWN'), the SSMRETRY logic limits SSM from attempting another start of the resource and sets the current state to failed (CURRENT_STATE='FAILED').

• The parameters that pass to SSMRETRY specify a maximum time that a resource reaches its initialization state. If a resource does not reach its initialization state (CURRENT_STATE='UP' as set by associating SSM rule packet), then the SSMRETRY logic sets the current state to timeout (CURRENT_STATE='TIMEOUT').

For example, if the maximum initialization time for JES2 is set to 5 minutes, when SSM starts JES2, and if it goes into some internal loop (never produces $HASP492), then after 5 minutes the logic that SSMRETRY creates sets the CURRENT_STATE = 'TIMEOUT' for JES2.

• The SSMRETRY request rule is invoked as a nested action within the DOWN_UP action process for a resource such as:

  EVRULE("SSMRETRY &SSMTABLE &JOBNAME,1,300,START UP");MVSCMD("START &JOBNAME")
  

  This START UP action process is limited to one start attempt and the resource reaches its initialization state (CURRENT_STATE = UP) within 300 seconds. These parameters can be change accordingly. The invocation of the SSMRETRY as an EVRULE action lets the code inform SSM to either process or bypass the nested or subsequent start resource action. (start resource)

  Note: For further details and complete implementation guidelines, see the comments within the SSMRETRY request rule.