Definitions - RTADEF

The RTA definition (RTADEF) views display information about evaluations to be performed on a periodic basis and the actions to be taken should a notifiable condition occur.

Supplied views

To access from the main menu, click:

Administration views > RTA analysis point monitoring > Definitions

Table 1. Views in the supplied **RTA definitions** (RTADEF) view set
View	Notes
RTA definitions EYUSTARTRTADEF.ADDTOGRP	Add an RTA definition to an RTA group.
RTA definitions EYUSTARTRTADEF.APINSTALL	Install an analysis definition into an analysis point.
RTA definitions EYUSTARTRTADEF.CREATE	Create an analysis definition and add it to the data repository. When you click Create, some fields in the displayed EYUSTARTRTADEF.CREATE view may contain values supplied by CICSPlex SM; you can change these values. If you select an RTA definition and then click Create, fields in the displayed view contain values to be modelled (from the existing RTA definition).
RTA definitions EYUSTARTRTADEF.DETAILED	Detailed information about a selected RTA definition.
RTA definitions EYUSTARTRTADEF.INSTALL	Install an analysis definition in an analysis specification.
RTA definitions EYUSTARTRTADEF.REMOVE	Remove an RTA definition from the data repository.
RTA definitions EYUSTARTRTADEF.TABULAR	Tabular information about all RTA definitions for the CICSplex identified as the context.

Actions

Table 2. Actions available for RTADEF views
Action	Description
ADDTOGRP	Add an RTA definition to an RTA group.
APINSTALL	Install an analysis definition into an analysis point.
CREATE	Create an analysis definition and add it to the data repository. When you click Create, some fields in the displayed EYUSTARTRTADEF.CREATE view may contain values supplied by CICSPlex SM; you can change these values. If you select an RTA definition and then click Create, fields in the displayed view contain values to be modelled (from the existing RTA definition).
INSTALL	Install an analysis definition in an analysis specification.
REMOVE	Remove an RTA definition from the data repository.
UPDATE	Update an RTA definition in the data repository using the EYUSTARTRTADEF.CREATE view.

Fields

Table 3. Fields in RTADEF views
Field	Attribute name	Description
Action definition name	ACTION	The name of the action definition that is to be associated with this definition. An action definition indicates what is to happen when the condition or conditions being analyzed are true. If the action definition cannot be located when this analysis definition is installed in a CICS system and the designated condition or conditions become true, only CICSPlex SM event notification will occur.
Last modification agent	CHANGEAGENT	The change agent identifier that made the last modification. DREPAPI - Resource was last changed by a CICSPlex SM API command. N_A - Resource was created or last updated prior to CICS TS Version 4 Release 1 and support for resource signatures.
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 user ID	CHANGEUSRID	The user ID that made the last modification.
Time created	CREATETIME	The local time when the definition was created.
Description	DESC	(Optional.) Specify a 1- to 58-character description of the definition.
Description code page	DESCCODEPAGE	The code page of the description field.
Evaluation expression	EVALEXPRTEXT	The evaluation expression that is to be analyzed. This expression can comprise of a single definition name or multiple definition names. DEFNAME1 DEFNAME2 DEFNAME1 \| DEFNAME 2 DEFNAME1 & DEFNAME 2 (DEFNAME1 \| DEFNAME 2) \| (DEFNAME3 & DEFNAME 4) Where \| is an OR and & is an AND. The maximum length is 500 characters.
Execute evaluation modification string	EXEC_OPS	Indicates whether any resource modifications are to be performed when the condition or conditions being analyzed are true: Yes CICSPlex SM attempts to perform the modification when the condition described by its evaluation definition is true. CICSPlex SM attempts to perform the requested modification only once. If the modification is not successful for any reason (for example, the resource is in use or is not available, or a CICS or CICSPlex SM error occurred when the modification was requested), it is not retried. If the condition generates a CICSPlex SM event, and the modification cannot be made, the event remains displayed on the Real Time Analysis Outstanding Event view. No The modification is not performed. Always CICSPlex SM attempts to perform the modification when the condition described by the evaluation definition is true. When the ALWAYS option is set, the Exit Intervals option is ignored.
Count of true evaluations before HS raised	HSENTRY	The number of consecutive evaluation time periods, for the HS severity level, during which the designated condition or conditions must be true before any action is taken. The value must be between 1 and 9999.
Count of false evaluations before HS resolved	HSEXIT	The number of consecutive evaluation time periods, for the HS severity level, during which the designated condition or conditions must be false before any action is taken. The value must be between 1 and 9999.
Count of true evaluations before HW raised	HWENTRY	The number of consecutive evaluation time periods, for the HW severity level, during which the designated condition or conditions must be true before any action is taken. The value must be between 1 and 9999.
Count of false evaluations before HW resolved	HWEXIT	The number of consecutive evaluation time periods, for the HW severity level, during which the designated condition or conditions must be false before any action is taken. The value must be between 1 and 9999.
Count of true evaluations before LS raised	LSENTRY	The number of consecutive evaluation time periods, for the LS severity level, during which the designated condition or conditions must be true before any action is taken. The value must be between 1 and 9999.
Count of false evaluations before LS resolved	LSEXIT	The number of consecutive evaluation time periods, for the LS severity level, during which the designated condition or conditions must be false before any action is taken. The value must be between 1 and 9999.
Count of true evaluations before LW raised	LWENTRY	The number of consecutive evaluation time periods, for the LW severity level, during which the designated condition or conditions must be true before any action is taken. The value must be between 1 and 9999.
Count of false evaluations before LW resolved	LWEXIT	The number of consecutive evaluation time periods, for the LW severity level, during which the designated condition or conditions must be false before any action is taken. The value must be between 1 and 9999.
Name	NAME	The 1- to 8-character name of the analysis definition. The name can contain alphabetic, numeric, or national characters. However, the first character must be alphabetic.
Analysis interval	RATE	The interval, in seconds, between samples of the specific conditions being evaluated. The definition names specified in the Evaluation expression field identify the conditions. The value must be between 1 and 86400.
Count of true evaluations before VHS raised	VHSENTRY	The number of consecutive evaluation time periods, for the VHS severity level, during which the designated condition or conditions must be true before any action is taken. The value must be between 1 and 9999.
Count of false evaluations before VHS resolved	VHSEXIT	The number of consecutive evaluation time periods, for the VHS severity level, during which the designated condition or conditions must be false before any action is taken. The value must be between 1 and 9999.
Count of true evaluations before VLS raised	VLSENTRY	The number of consecutive evaluation time periods, for the VLS severity level, during which the designated condition or conditions must be true before any action is taken. The value must be between 1 and 9999.
Count of false evaluations before VLS resolved	VLSEXIT	The number of consecutive evaluation time periods, for the VLS severity level, during which the designated condition or conditions must be false before any action is taken. The value must be between 1 and 9999.