APSPEC (Analysis point specifications)

An analysis point specification identifies one or more CMASs that are to be responsible for analyzing CICS® systems within the CICSplex identified as the context. An example of how to use this view can be found in Issuing one notification for multiple conditions(1).

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

   APSPEC [apspec]

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

Figure 12. The APSPEC view
 27FEB2005  16:51:44 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =APSPEC============EYUPLX01=EYUPLX01=27FEB2005==16:51:44=CPSM==========2===
 CMD Spec     Description
 --- Name---- ------------------------------
     EYURAPLC SSet - License
     EYURAP01 SSet - Analysis point 1
 

Action commands

Table 9 summarizes the action commands you can use with the APSPEC view. Table 10 identifies the overtype field you can modify when you use the SET action command.

Table 9. APSPEC view action commands
Primary command Line command Description
n/a ADD Add an association between an analysis point specification and a CMAS, as described in topic Associating an analysis point specification with a CMAS.
n/a BRO Browse an analysis point specification in the data repository.

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

CREate CRE Create an analysis point specification and add it to the data repository, as described in topic Creating an analysis point 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 point specification from the data repository.
n/a SET Change the description of an analysis point specification using an overtype field (see Table 10).
Note:
The value you specified in the Require Set field on the CICSPlex® System Manager entry panel determines whether or not you must use the SET command when you overtype a field.
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 point specification in the data repository.

The format of the resulting panel is similar to that shown in Figure 13. You can change the Description field.

Table 10. APSPEC view overtype field
Field name Value
Description 1- to 30-character description of the specification.

Hyperlink fields

Table 11 shows the hyperlink field on the APSPEC view.

Table 11. APSPEC view hyperlink field
Hyperlink field View displayed Description
Spec Name RTAINAPS Detailed information about the associations that exist between the designated analysis point specification and its analysis groups.

Creating an analysis point specification

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

Figure 13. Creating an analysis point specification
 ----------------------- Create Analysis Point Specification for EYUPLX01 ------
 COMMAND  ===>
 
  AP SpecName        ===>
  Description        ===>
 
 
Press Enter to create AP Specification.
Type END or CANCEL to cancel without creating.
 

Provide the following information, as appropriate:

AP Spec Name
Specify a 1- to 8-character name for the 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.

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

Associating an analysis point specification with a CMAS

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

Figure 14. Adding a CMAS to an analysis point specification
 ----------------------- Add APSPEC CMAS Association for EYUPLX01  -------------
 COMMAND  ===>
 
  AP SpecName             EYURAP01
  Description
 
  CMAS Name          ===>              CMAS name from CICSplex set or Generic
  Type               ===>              CMAS role (Primary/Secondary)
 
Press ENTER to add AP Specification to CMAS.
Type END or CANCEL to cancel without adding.

Provide the following information:

CMAS Name
Enter the specific or generic name of a CMAS, involved in managing the CICSplex, that is to be associated with this specification. If you specify a generic value, a list of valid CMAS names is displayed.

Ensure that the CMASs you specify for the primary and secondary associations are running the highest level of CICSPlex SM currently in use in the CICSplex.

Type
Indicate the type of association that is to be created. Specify:
PRIMARY
Control of the analysis definitions associated with the analysis point specification are to be passed to this CMAS when it initializes.
SECONDARY
Control of the analysis definitions associated with the analysis point specification are to be passed to this CMAS only when the primary CMAS is unavailable.

Only one primary CMAS can be associated with an analysis point specification. Multiple secondary CMASs can be associated with an analysis point specification.

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

To remove the CMAS association, use the REM action command from the APCMAS view, as described in topic APCMAS (Analysis point specification and CMAS associations).

[[ Contents Previous Page | Next Page Index ]]