ACTNDEF (Action definitions)

An action definition designates the type of external notification that is to occur when the condition or conditions identified in an analysis definition are true. Examples of how to use this view can be found in Example tasks: real-time analysis.

To display information about existing action definitions, issue the command:

   ACTNDEF [actndef]

where actndef is the specific or generic name of an action definition. If you omit this parameter, the resulting view, illustrated in Figure 9, includes information about all action definitions for the CICSplex identified as the context.

Figure 9. The ACTNDEF view
  27FEB2005 11:30:30 --------- INFORMATION DISPLAY -----------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1         ALT WIN ===>
  W1 =ACTNDEF=============EYUPLX01==EYUCSG01==27FEB2005==11:30:30=CPSM======2===
 CMD Name      Event    View    Msg  Alert  ARM  Description
 --- --------  -----  --------  ---  -----  ---  -------------------------------
     EYURTA01  YES    CICSRGN   YES  YES    YES  A test action
     EYURTA02  YES    LOCFILE   YES  YES    NO   Another action
 
 

Action commands

Table 6 summarizes the action commands you can use with the ACTNDEF view.

Table 6. ACTNDEF view action commands
Primary command Line command Description
n/a BRO Browse an action definition in the data repository.

The format of the resulting panel is similar to that shown in Figure 10. The panel fields are not modifiable.

CREate CRE Create an action definition and add it to the data repository, as described in topic Creating an action definition.

When you use the primary command CREate, some fields in the new view may contain values supplied by CICSPlex® SM; you may change these values. When you enter the line command CRE next to the name of an action definition, fields in the new view contain values to be modelled (from the existing action definition).

n/a MAP Display a visual map of real-time analysis definitions using the specified action definition as a starting point.
n/a REM Remove an action definition from the data repository.
TEMPMP cmasid n/a Change the temporary maintenance point CMAS to a specific CMAS or display a selection list based on a generic CMAS ID.
n/a UPD Update an action definition in the data repository.

The format of the resulting panel is similar to the panel shown in Figure 10. You can modify the contents of any field in the panel except Action Name.

Hyperlink fields

There are no hyperlink fields on the ACTNDEF view.

Creating an action definition

Figure 10 shows the format of the panel produced when you use the create primary (CREate) or line (CRE) action command from the ACTNDEF view.

Figure 10. Creating an action definition
 -------------------------- Create Action for EYUPLX01 -------------------------
 COMMAND  ===>
 
 Action Name   ===> EYURTA01
  Description  ===>
 
  Event        ===> YES          Generate Event (Yes/No)
   Event View  ===> LOCTRAN      View for Event
   Priority    ===> 255          Event Priority (1 to 255)
   Event Text  ===> Transaction rate too great
 
  External Msg ===>              Generate External Message (Yes/No)
   Enter Msg   ===>
   Exit Msg    ===>
 
  Alert        ===>              Generate Alert (Yes/No)
   CMAS Name   ===>              CMAS to Issue Alert
   Enter Text  ===>
   Exit Text   ===>
 
   Restart     ===> NO           Cancel for ARM Restart (Yes/No)
 
 Press Enter to create the Action Definition.
 Type END or CANCEL to cancel without creating.

Provide the following information, as appropriate:

Action Name
Specify a 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.
Description
(Optional.) Specify a 1- to 30-character description of the definition.
Event
Specify YES or NO to indicate whether CICSPlex SM event messages are to be generated when a notification condition occurs.

If you specify YES, provide the following information, as appropriate:

Event View
(Optional.) The name of the CICSPlex SM view that is to appear in the View field of the EVENT and EVENTD views when a notification condition occurs. The view should be the one that is most frequently used to obtain information about the condition or to assist in resolving the condition.
Priority
A value between 1 and 255, inclusive. This value and the severity code associated with the condition, as described in topic Severity levels, 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.
Event Text
A 1- to 30-character description that is to appear in the EVENT and EVENTD views 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. For a list of the system availability monitoring defaults, see Default notification values.

External Msg
Specify YES or NO to indicate whether external messages are to be generated when a notification condition occurs.

If you specify YES, provide the following information, as appropriate:

Enter Msg
A 1- to 30-character description that is to be added to the CICSPlex SM message produced when a notifiable condition occurs.
Exit Msg
A 1- to 30-character description that is to be added to the CICSPlex SM message produced when a notifiable condition ends.
Notes:
  1. If the action definition is for use by a system availability monitoring condition, you can specify * (asterisk) in one or both of these fields to use the default external message text for that condition. For a list of the system availability monitoring defaults, see Default notification values.
  2. The external message text is added to CICSPlex SM messages that are prefixed with EYUPN. For additional information about these messages, see the CICSPlex SM Messages and Codes book.
Alert
Specify YES or NO to indicate whether an SNA generic alert is to be sent to NetView®. (For more information about how CICSPlex SM uses SNA generic alerts and resolutions, see Appendix B. Generic alert and resolution structures.)

If you specify YES, provide the following information, as appropriate:

CMAS Name
The name of the CMAS to which the NetView system is linked.

To specify that generic NetView alerts are to be generated and passed to a CMAS residing in the same MVS™ image:

  • Use the CMAS view, as described in the CICSPlex System Manager Administration book, to display the names of existing CMASs. Decide which of these CMASs is to participate in real-time analysis. That is, which of these CMASs is to record the conditions that are to be transmitted to NetView.
  • Then, use the CMASD view, also described in the CICSPlex System Manager Administration book, to display detailed information about each appropriate CMAS. To have generic alerts transmitted to the NetView system that resides in the same MVS image as the CMAS, set the NetView PPI field to YES.The default name of the alert receiver that the CMAS will send generic alerts to is NETVALRT. This may be changed by using the CMAS only CICSPlex SM system parameter ALERTRCVR. See the CICS® Transaction Server for z/OS® Installation Guide for details.
Enter Text
A 1- to 30-character message that is to be added to the SNA generic alert when the condition causing the alert starts.
Exit Text
A 1- to 30-character message that is to be added to the SNA generic alert when the condition causing the alert ends.

If the action definition is for use by a system availability monitoring condition, you can specify * (asterisk) in one or both of the text fields to use the default alert text for that condition. For a list of the system availability monitoring defaults, see Default notification values.

Restart
Specify YES or NO to indicate 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:

ARM restart is available for CICS/ESA 4.1 and later systems.

Press Enter to add this action definition to the data repository.

[[ Contents Previous Page | Next Page Index ]]