An analysis definition identifies the evaluations to be performed on a periodic basis and the actions to be taken should a notifiable condition occur. Examples of how to use this view can be found in Example tasks: real-time analysis.
To display information about existing analysis definitions, issue the command:
RTADEF [rtadef]
where rtadef is the specific or generic name of an analysis definition. If you omit this parameter, the resulting view, illustrated in Figure 20, includes information about all analysis definitions for the CICSplex identified as the context.
27FEB2005 21:02:48 ----------- INFORMATION DISPLAY --------------------------- COMMAND ===> SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> W1 =RTADEF============EYUPLX01=EYUPLX01=27FEB2005==21:02:48=CPSM=========10=== CMD Name Intv Action Description --- -------- ---- -------- ------------------------------ EYURTDLC 60 EYURTALC SSet - License EYURTD01 300 EYURTA01 SSet - All connections EYURTD02 300 EYURTA02 SSet - All DFHCSD files EYURTD16 300 EYURTA16 SSet - Empty files EYURTD17 300 EYURTA17 SSet - DBCTL at maxthreads EYURTD18 300 EYURTA18 SSet - DTR not set correctly EYURTD19 300 EYURTA19 SSet - Monitoring inactive EYURTD20 300 EYURTA20 SSet - DSA free space % EYURTD21 300 EYURTA21 SSet - Outstanding EVENTs EYURTD22 300 EYURTA22 SSet - Dumps suppressed
Table 13 summarizes the action commands you can use with the RTADEF view.
Primary command | Line command | Description |
---|---|---|
n/a | ADD | Add an association between an analysis definition and an analysis group, as described in topic Adding an association to an analysis group. |
n/a | AIN | Install an analysis definition in an analysis point specification, as described in topic Installing an analysis definition into an analysis point specification. |
n/a | BRO | Browse an analysis definition in the data repository.
The format of the resulting panel is similar to that shown in Figure 21. The panel fields are not modifiable. |
CREate | CRE | Create an analysis definition and add it to the data repository,
as described in Creating an analysis 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 analysis definition, fields in the new view contain values to be modelled (from the existing analysis definition). |
n/a | INS | Install an analysis definition in a CICS® system or CICS system group, as described in topic Installing an analysis definition. |
n/a | MAP | Display a visual map of real-time analysis definitions using the specified definition as a starting point. |
n/a | REM | Remove an analysis 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 analysis definition in the data repository.
The format of the resulting panel is similar to the panel shown in Figure 21. You can modify the contents of any field in the panel except Name. |
There are no hyperlink fields on the RTADEF view.
Figure 21 shows the format of the panel produced when you use the create primary (CREate) or line (CRE) action command from the RTADEF view.
--------------------- Create Analysis Definition for EYUPLX01 ---------------- COMMAND ==> Name ===> EYURTD01 Description ===> Perform Ops ===> NO Perform EVALDEF operations changes (YES, NO, ALWAYS) Sample Interval ===> 60 Interval between samples in seconds (1-86400) Action Name ===> Action definition name or generic VLS LS LW HW HS VHS Entry Intervals ===> 5 5 5 5 5 5 Exit Intervals ===> 2 3 1 1 1 1 Evaluation expression: ===> EYURTE01 ===> ===> ===> ===> ===> ===> Press Enter to create the Analysis Definition. Type END or CANCEL to cancel without creating.
Provide the following information, as appropriate:
Resource modifications are defined as part of the evaluation definitions
(EVALDEFs) associated with this analysis definition (RTADEF).
Resource table: LOCTRAN
Evaluation : STATUS NE ENABLED
Modification : STATUS=ENABLED
ALWAYS would work well with this example because the modification will
cause the evaluation to become false. ALWAYS should not be used if that is
not the case for example:
Resource table: LOCTRAN
Evaluation : STATUS NE ENABLED
Modification : PRIORITY=255
ALWAYS would not work
well with this example because the modification will not cause the evaluation
to become false.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.
Press Enter to add this analysis definition to the data repository.
Figure 22 illustrates the panel produced when you use the add (ADD) line action command from the RTADEF view.
------------------ Add RTADEF to Analysis Group for EYUPLX01 ----------------- COMMAND ===> Name EYURTD01 Description Sample definition Analysis Group ===> EYURTG01 Analysis Group or Generic Active Period ===> PRIME Period Name or Generic Press Enter to add RTADEF to Analysis Group. Type END or CANCEL to cancel without adding.
Provide the following information:
If the name you specify is not an existing period definition, you can create that period definition later. If you leave this field blank, the analysis definition remains active for as long as the CICS system is running or until you discard it.
Press Enter to add the association to the designated analysis definition and analysis group in the data repository.
If the appropriate analysis group does not currently exist, you must first create the group, as described in topic Creating an analysis group. Then you can add the definition to that group, using either this action command or the action command described in topic Adding a definition to an analysis group.
To remove a definition from an analysis group, see topic Action commands.
You can install an analysis definition for one or more active CICS systems that are within the CICSplex identified as the context.
An analysis definition can be automatically installed for a CICS system when that system starts. For this to occur, associate the definition with an analysis group. Then associate that group with an analysis specification that is defined to the CICS system.
Figure 23 illustrates the panel produced when you use the install (INS) line action command from the RTADEF view.
------------------------ Install RTADEF for EYUPLX01 -------------------------- COMMAND ===> Name EYURTD01 Description SSet - All connections Type RTADEF Scope ===> CICS System, System Group, or Generic Active Period ===> Blank, PERIODEF, or Generic Press Enter to install Analysis Definition. Type END or CANCEL to cancel without installing.
Provide the following information:
Press Enter to install the definition in the designated CICS systems.
For an installation to succeed, the CICS system must be running and real-time analysis must be active. Additionally, associated evaluation definitions must refer to resource tables that are supported in the target CICS system. If CICSPlex SM detects otherwise, it issues a message indicating that the definitions are not installed in those systems that do not support the specified resource table.
The analysis definition becomes active either:
The analysis definition remains active as long as the CICS system is running, until you discard it, or until the time designated by an associated period definition is reached.
To discard an analysis definition installed in a CICS system, use the RTAACTV view as described in Table 3.
Figure 24 illustrates the panel produced when you use the install (AIN) line action command from the RTADEF view.
---------------------------- Install RTADEF for EYUPLX01 ---------------------- COMMAND ===> Name EYURTD01 Description SSet - All connections Type RTADEF AP Spec Name ===> Active Analysis Point Spec or Generic Scope ===> CICS System, System Group, or Generic Press Enter to install Analysis Definition. Type END or CANCEL to cancel without installing.
Provide the following information:
Press Enter to install the analysis definition into the analysis point specification.
If an analysis definition is associated with an evaluation definition that refers to a resource table that is not supported in the target CICS system, CICSPlex SM issues a message indicating that the definitions are not installed because the resource is not supported.
[[ Contents Previous Page | Next Page Index ]]