RTASCOPE (Analysis specifications assigned a scope)

To display information about the CICS® systems or CICS system groups that are associated with an analysis specification, issue the command:

   RTASCOPE [rtaspec]

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

Figure 38. The RTASCOPE view
 27FEB2005  21:03:56 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =RTASCOPE==========EYUPLX01=EYUPLX01=27FEB2005==21:03:56=CPSM==========2===
 CMD RTA      Scope    Scope    Scope    Scope    Update
 --- Spec---- Name---- Type---- Mode---- Link---- Option--
     EYURTS01 EYUMAS1A CICSSYS  EXPLICIT
     EYURTS03 EYUMAS4A CICSSYS  EXPLICIT
 

Action commands and overtype fields

Table 24 summarizes the action commands you can use with the RTASCOPE view. Table 25 identifies the overtype fields you can modify when you use the SET action command.

Table 24. RTASCOPE view action commands
Primary command Line command Description
n/a BRO Browse the association between a scope and an analysis specification.

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

n/a MAP Display a visual map of real-time analysis definitions using the designated specification as a starting point.
n/a REM Remove the association between a scope and an analysis specification, as described in topic Removing scope-to-analysis specification associations.
n/a SET Change the association between a scope and an analysis specification using overtype fields (see Table 25).
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 the association between a scope and an analysis specification, as described in Updating scope-to-analysis specification associations.

When you change or remove the analysis specification associated with a CICS system group, you must indicate how the CICS systems comprising that group are to be affected.

Based on the value you specify, the number of entries shown in the RTASCOPE view may increase or decrease. For example, you might specify a value that causes a CICS system within a CICS system group to be explicitly associated with a specification, rather than inherit it from its CICS system group. When this happens, the resulting RTASCOPE view contains a line identifying the CICS system group and a new line identifying the CICS system that is now explicitly associated with a specification.

Table 25. RTASCOPE view overtype fields
Field name Value
RTA Spec 1- to 8-character name of an existing analysis specification that is to be associated with the CICS system or CICS system group.
Update Option FORCE | KEEP | NAME | NULL
Notes:
  1. When the scope of the analysis specification is a CICS system group, you must indicate how the CICS systems comprising the CICS system group are to use the specification by overtyping the contents of the Update Option field.

    If 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 the Update Option field.

  2. If you update the analysis specification for a CICS system that is already active, you must restart real-time analysis, as described in Updating scope-to-analysis specification associations.

Hyperlink fields

Table 26 shows the hyperlink field on the RTASCOPE view.

Table 26. RTASCOPE view hyperlink field
Hyperlink field View displayed Description
RTA Spec RTASPEC Detailed information about the designated analysis specification.

Updating scope-to-analysis specification associations

Figure 39 illustrates the panel produced when you use the update (UPD) line action command from the RTASCOPE view.

Figure 39. Updating the association between a scope and an analysis specification
 ----------- Update RTA Specification in Scope for EYUPLX01 -------------------
 COMMAND  ===>
 
   Specification Name   ===> EYURTS01   Specification name or Generic
   Scope                     EYUCSG01
   Scope Type                SYSGROUP
 
   Option               ===>            FORCE, KEEP, NAME, or NULL
                                        Valid only for SYSGROUP
 
 
  Press ENTER to update.
  Type END or CANCEL to cancel without updating.

The Option field does not appear on this panel when the scope is a CICS system (CICSSYS).

Change the following information, as appropriate:

Specification Name
Enter the specific or generic name of an existing analysis specification. If you specify a generic value, a list of valid analysis specifications is displayed.
Option
When the scope of the analysis specification is a CICS system group, you must indicate how the CICS systems comprising the CICS system group are to use the specification. To do this, specify one of the following:
FORCE
All CICS systems in the CICS system group are to inherit the new specification.
KEEP
Any CICS system that inherited a specification from the CICS system group is to be explicitly assigned the old specification; all other CICS systems in the group are to be unaffected.
NAME
Any CICS system that inherited a specification from the CICS system group is to be explicitly assigned the new specification; all other CICS systems in the group are to be unaffected.
NULL
Any CICS system in the CICS system group that is not explicitly associated with a specification is to inherit the new specification; all other CICS systems in the group are to be unaffected.
If 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 the Option field.

If you update the analysis specification for 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.

Removing scope-to-analysis specification associations

Figure 40 illustrates the panel produced when you use the remove (REM) line action command from the RTASCOPE view.

Figure 40. Removing the association between a scope and an analysis specification
 ------------------ Confirm Removal of RTA Spec to Scope from EYUPLX01 ---------
 COMMAND  ===>
 
   Specification Name         EYURTS02
   Scope                      EYUCSG01
   Scope Type                 SYSGROUP
 
   Option                ===>            KEEP or blank
                                         Valid only for SYSGROUP
 
   WARNING:  For this definition type, removal will cascade through
             related associations.
 
  Press Enter to remove.
  Type END or CANCEL to cancel without removing.

The Option field does not appear on this panel when the scope is a CICS system (CICSSYS).

Provide the following information when the scope is a CICS system group:

Option
Indicate how the CICS systems comprising the CICS system group are to use the analysis specification associated with that CICS system group. Specify:
KEEP
Those CICS systems that inherited the specification from the CICS system group are explicitly assigned that specification.
Blank
Those CICS system that inherited the specification from the CICS system group are not to use that specification.

If 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 remove the scope from the designated analysis specification definition in the data repository.

[[ Contents Previous Page | Next Page Index ]]