RTASPEC (Analysis specifications)

An analysis specification identifies the default control attributes that are used for system availability monitoring and provides an anchor for all analysis definitions and status definitions associated with a CICS® system.

Examples of how to use this view can be found in:

To display information about existing analysis specifications, issue the command:

   RTASPEC [rtaspec]

where rtaspec is the specific or generic name of an analysis specification. If you omit this parameter, the resulting view, illustrated in Figure 41, includes information about all analysis specifications for the CICSplex identified as the context.

Figure 41. The RTASPEC view
 27FEB2005  21:04:03 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =RTASPEC===========EYUPLX01=EYUPLX01=27FEB2005==21:04:02=CPSM==========2===
 CMD Spec     Description
 --- Name---- ------------------------------
     EYURTS01 SSet - TOR groups
     EYURTS03 SSet - FOR groups
 

Action commands

Table 27 summarizes the action commands you can use with the RTASPEC view

Table 27. RTASPEC view action commands
Primary command Line command Description
n/a ADD Add an association between an analysis specification and a CICS system or CICS system group, as described in topic Adding a scope to an analysis specification.
n/a BRO Browse an analysis specification definition in the data repository.

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

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

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 analysis specification, fields in the new view contain values to be modelled (from the existing analysis specification).

n/a MAP Display a visual map of real-time analysis definitions using the designated specification as a starting point.
n/a REM Remove an analysis specification 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 analysis specification in the data repository.

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

Hyperlink fields

Table 28 shows the hyperlink field on the RTASPEC view.

Table 28. RTASPEC view hyperlink field
Hyperlink field View displayed Description
Spec Name RTAINSPC Detailed information about the associations that exist between the designated analysis specification and its analysis groups.

Creating an analysis specification

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

Figure 42. Creating an analysis specification
 ----------------------- Create Analysis Specification for EYUPLX01 ------------
 COMMAND  ===>
 
  RTA Spec Name     ===> EYURTS03
  Description       ===> SSet - FOR groups
 
  System availability management:
 
                 Action or Generic    Severity
  SAM                 => NOSYSTEM  => VHS
  SOS                 => DSAINSOS  => HS
  SYSDUMP             => CICSDUMP  => HS
  TRANDUMP            => TRANDUMP  => HW
  MAXTASK             => CICSMAXT  => HS
  STALL               => CICSDEAD  => VHS
 
Press Enter to create the RTA Specification.
Type END or CANCEL to cancel without creating.

Provide the following information, as appropriate:

RTA Spec Name
Specify a 1- to 8-character name for the analysis specification. 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 specification.
Action
Enter the specific or generic name of an action definition to be used when a predefined system availability monitoring condition occurs. If you specify a generic value, a list of valid action definitions is displayed. If you leave this field blank, the default action definition is used, as described in Default notification values.
Severity
Indicate how the predefined condition is to be handled. Specify:
severity
Identify the severity level that is to be associated with the designated condition. The severity codes are:
VLS
Very low severe
LS
Low severe
LW
Low warning
HW
High warning
HS
High severe
VHS
Very high severe
NO
Exclude this condition from monitoring.

Press Enter to add the analysis specification to the data repository.

The severity, if not specified or N/A, will default to the default event security as described in Default notification values.

Adding a scope to an analysis specification

Associating an analysis specification with a scope causes the specification to be automatically installed when a CICS system associated with the scope is started. Any definitions associated with the specification through analysis groups are also automatically installed.

However, if you associate the analysis specification with a CICS system that is already active, the new specification is not immediately available. To reset real-time analysis, you must display the MAS view and use the UPD action command to do one of the following:

Real-time analysis becomes active using the new analysis specification.

Figure 43 illustrates the panel produced when you use the add (ADD) line action command from the RTASPEC view.

Figure 43. Adding a scope to an analysis specification
 ----------------------- Add Scope for Specification for EYUPLX01 --------------
 COMMAND  ===>
 
  Analysis Spec Name      EYURTS01
  Description             SSet - TOR groups
 
  Scope              ===>              CICS System, Group or Generic
  Option             ===>              FORCE, NULL, or NONE for System Group
 
Press Enter to add Analysis Specification Scope.
Type END or CANCEL to cancel without adding.

Provide the following information:

Scope
Enter the specific or generic name of an existing CICS system or CICS system group that is not associated with any other analysis specification. If you specify a generic value, a list of valid CICS systems and CICS system groups is displayed.

A CICS system or CICS system group can be associated with only one analysis specification at a time. A specification, however, can be associated with any number of CICS systems and CICS system groups.

Option
(Required only when the scope is a CICS system group.) Indicate how the CICS systems comprising the CICS system group are to handle analysis specifications. Specify:
FORCE
All CICS systems in the CICS system group are to use the analysis specification. (The analysis specification attribute for each CICS system changes to INHERIT, indicating that the CICS system acquired the specification from a CICS system group.)
NULL
Those CICS systems within the CICS system group that are not associated with an analysis specification are to use this specification. (The analysis specification attribute for those CICS systems changes to INHERIT.)
NONE
Only the CICS system group is to be associated with the analysis specification. The CICS systems in the CICS system group are not affected. That is, if there is not association between a CICS system and an analysis specification, none is established; if there is an association, either explicitly established or inherited from another CICS system group, it is unchanged.

When the CICS system group includes other CICS system groups, all of the CICS systems, including those in the subordinate CICS system groups, are affected by the value specified in this field.

Press Enter to add the designated scope to the analysis specification definition in the data repository.

To remove the scope association, see topic Removing scope-to-analysis specification associations.

[[ Contents Previous Page | Next Page Index ]]