Changing the default actions for system availability monitoring (SAM)

If you turn on system availability monitoring (SAM) for a particular CICS® system, CICSPlex® SM issues the default notifications when one of the predefined conditions occurs. That is, CICSPlex SM generates an external message and an event notification. You can customize the external message and the event notification to suit local requirements.

The default values for these messages are shown in Default notification values. For example, you might want to change the message text for a particular condition, or change the severity of a condition, or selectively turn off parts of system availability monitoring.

This example shows you how to use the Web User Interface to modify the default system availability monitoring notifications you requested in the previous example (Switching system availability monitoring (SAM) on for a MAS) for CICS system CICSPA01. The changes you want to make are as follows:
  • If CICSPA01 is not available between 09:00 and 17:30, an alert is to be sent to NetView by CMAS CMSSYS1, and an event notification, with a severity of HW, is to be issued. However, no external message is to be generated.
  • If the system becomes short on storage (SOS), the default actions should be taken, but the priority of the event should be Very High Severe (VHS).
  • No notification of system or transaction dumps is required.
  1. Create an action definition.
    1. From the WUI main menu, click Administration views > RTA system availability monitoring > Actions to open the Action definitions tabular view.
    2. If the current context is not PLXPROD1, specify PLXPROD1 in the Context field and click Refresh.
    3. Click the Create... button at the bottom of the screen.
      Note: If you want to use an existing definition as a template, select a definition from the list first.
    4. Provide the following information:
      Action
      RTAPAY01
      Description
      CICSPA01 unavailable
      Generate event
      YES
      Action priority
      255
      Message to send when event occurs
      AOR CICSPA01 is unavailable
      Generate external message
      NO
      Generate SNA generic alert
      YES
      CMAS to which NetView attached
      CMSSYS1
      Message text when alert is raised
      AOR CICSPA01 is unavailable
      Message text when alert is cleared
      AOR CICSPA01 is now available
      MVS automatic restart
      NO
    5. Click Yes to create the definition. The Action definitions tabular view is redisplayed.
  2. Change the default system availability monitoring actions for CICSPA01.
    1. From the WUI main menu, click Administration views > RTA system availability monitoring > CICS system definitions to open the CICS system definitions tabular view.
    2. Select the entry for CICSPA01, and click the Update... button.
    3. To replace the default system availability monitoring notifications with your own:
      • Type in the name of the action definition you created in step 1 (RTAPAY01) in the Action for system availability monitoring event field
      • In the Severity for system availability monitoring event field, select HW from the drop-down menu.
    4. To change the severity of the SOS event to Very High Severe, select VHS from the drop-down menu in the Severity for short-on-storage (SOS) event field.
    5. To switch off notification of system and transaction dumps, select NO in the severity fields for both the system dump and transaction dump events.
    6. Click Yes to confirm the changes. The CICS system definitions tabular view is redisplayed.

    The updated system availability monitoring actions take effect immediately.