Actions - ACTION

The Action definition (ACTION) views show the type of external notification that is to occur when the condition or conditions identified in an analysis definition are true.

Supplied views

To access from the main menu, click:

Administration views > RTA analysis point monitoring > Actions

Table 1. Views in the supplied Action definitions (ACTION) view set
View Notes
Action definitions

EYUSTARTACTION.CREATE

Create an action definition and add it to the data repository.

When you use the Create action, some fields in the new view may contain values supplied by CICSPlex SM; you may change these values. If you select an existing definition, then click Create, fields in the new EYUSTARTACTION.CREATE view contain values to be modelled (from the existing action definition).

Action definitions

EYUSTARTACTION.DETAILED

Detailed information about a selected action definition
Action definitions

EYUSTARTACTION.REMOVE

Remove an action definition from the data repository.
Action definitions

EYUSTARTACTION.TABULAR

Tabular information about all action definitions for the CICSplex identified as the context.

Actions

Table 2. Actions available for ACTION views
Action Description
CREATE Create an action definition and add it to the data repository.

When you use the Create action, some fields in the new view may contain values supplied by CICSPlex SM; you may change these values. If you select an existing definition, then click Create, fields in the new EYUSTARTACTION.CREATE view contain values to be modelled (from the existing action definition).

REMOVE Remove an action definition from the data repository.
UPDATE Update a selected action definition in the data repository.

This opens the EYUSTARTACTION.CREATE view containing values from the selected definition. You can modify the contents of any field in the view except Action Name .

Fields

Table 3. Fields in ACTION views
Field Attribute name Description
Message text when alert is cleared ALERTMSGEND A 1- to 30-character message that is to be added to the SNA generic alert when the condition causing the alert ends.
Message text when alert is raised ALERTMSGSTRT A 1- to 30-character message that is to be added to the SNA generic alert when the condition causing the alert starts.
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • DREPAPI - Resource was last changed by a CICSPlex SM API command.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification.
Last modification CHANGETIME The local time when the definition was last changed.
Last modification userid CHANGEUSRID The userid that made the last modification.
Time created CREATETIME The local time when the definition was created.
Description DESC (Optional) A 1- to 30-character description of the definition .
Description code page DESCCODEPAGE The code page of the description field.
Message to send when event occurs EVENTMSG A 1- to 30-character description that describes the event if a notification condition occurs.

If the action definition is for use by a system availability monitoring condition, you can specify * (asterisk) to use the default event text for that condition.

External message sent when event is cleared EXTMSGEND A 1- to 30-character description that is to be added to the CICSPlex SM message produced when a notifiable condition ends.
External message sent when event occurs EXTMSGSTRT A 1- to 30-character description that is to be added to the external message produced when a notifiable condition occurs.
Generate SNA generic alert GENALERT Indicates whether a SNA generic alert is to be sent to NetView as part of this action.
Generate event GENEVENT Indicates whether CICSPlex SM event messages are to be generated when a notification condition occurs. If you specify YES, provide the following information, as appropriate:
  • Optional site-specific data about the condition
  • Action priority
  • Message to send when event occurs
Generate external message GENEXTMSG Indicates whether or not external messages are to be generated when a notification condition occurs.
Action NAME The 1- to 8-character name for the action definition. The name can contain alphabetic, numeric, or national characters. However, the first character must be alphabetic.
CMAS to which NetView attached NETVIEW The name of the CMAS to which the NetView system is linked.
Action priority PRIORITY A value between 1 and 255, inclusive. This value and the severity code associated with the condition are used to determine the sort order of events shown in the EVENT view. The higher the priority, the higher in the list an event appears.
MVS automatic restart RESTARTMAS Indicates whether CICS systems affected by the event are to be immediately cancelled and restarted using the MVS automatic restart manager (ARM). The default is NO. For ARM restart to be successful, the CICS system must:
  • Be known to CICSPlex SM as a local MAS
  • Be running in an MVS image where ARM is active
  • Have successfully registered with ARM during initialization
  • Be eligible for restart according to current ARM policy
User data area VIEW (Optional) A string of up to 8 characters that allows you to provide additional site-specific data about the condition or to assist in resolving the condition.