Start of changeManaging topology definitions using the end user interfaceEnd of change

You can access a topology view by doing any of the following:

Figure 47. The ADMTOPOL menu
 27FEB2005  19:34:08 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =MENU==============EYUPLX01=EYUPLX01=27FEB2005==19:34:08=CPSM==========6===
 CMD Name             Description
 --- -------------------------------
     ADMTOPOL     Topology Administration Views
       CICSSYS      CICS System Definitions
       CICSGRP      CICS System Group Definitions
       SYSGRPC      Members of CICS System Groups
       PERIODEF     Time Period Definitions
 

For additional information about accessing views, see topic Accessing end user interface administration views.

Reminder: Unless noted otherwise, only the context setting is recognized when you are creating and maintaining topology definitions. For additional information about setting the context to a CICSplex, see CICSPlex® System Manager User Interface Guide.

The remainder of this section contains detailed descriptions of the topology views.

CICS system group definitions

A CICS® system group identifies a subset of the CICS systems comprising a CICSplex. Each subset can consist of one or more CICS systems, CICS system groups, or both. They are referred to as the members of a CICS system group.

Start of changeManaging CICS system group definitions using the end user interfaceEnd of change

To display information about existing CICS system groups, issue the command:

   CICSGRP [sysgroup]

where sysgroup is the specific or generic name of a CICS system group known to the CICSplex identified as the context. If this parameter is omitted, the view, illustrated in Figure 48, includes information about all existing CICS system groups associated with the CICSplex identified as the context.

Figure 48. The CICSGRP view
 27FEB2005  17:05:25 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =CICSGRP===========EYUPLX01=EYUPLX01=27FEB2005==17:05:25=CPSM==========4===
 CMD System   Description
 --- Group    ------------------------------
     EYUCSG01 SSet - AORs/FORs on EYUPLX01
     EYUCSG03 SSet - All AORs in EYUPLX01
     EYUCSG04 SSet - EYUA AORs in EYUPLX01
     EYUCSG05 SSet - EYUB AORs in EYUPLX01
 
Action commands and overtype fields

Table 33 summarizes the action commands you can use with the CICSGRP view. Table 34 identifies the overtype field you can modify when you use the SET action command.

Table 33. CICSGRP view action commands
Primary command Line command Description
n/a ADD Add a CICS system or CICS system group to a CICS system group definition, as described in topic Adding a member to a CICS system group.
n/a BAS Display a visual map of business application services definitions using the specified group as a starting point.
n/a BRO Browse a CICS system group definition in the data repository.

The format of the resulting panels is identical to that shown in Figure 49. All of the fields are nonmodifiable.

CREate CRE Create a CICS system group definition and add it to the data repository, as described in topic Creating a CICS system group definition.
n/a MAP Display a visual map of CICSPlex SM definitions, using the specified group as a starting point. You are prompted to specify the type of definitions you want to map: business application services (BAS), resource monitoring (MON), real-time analysis (RTA), or workload management (WLM).
n/a MON Display a visual map of resource monitoring definitions using the specified group as a starting point.
n/a REM Remove a CICS system group definition from the data repository, as described in topic Removing a CICS system group.
n/a RTA Display a visual map of real-time analysis definitions using the specified group as a starting point.
n/a SET Change a CICS system group definition description using an overtype field.
Note:
The value you specified in the Require Set field on the CICSPlex SM entry panel determines whether or not you must use the SET command when you overtype a field.
TEMPMP cmas 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 a CICS system group definition in the data repository.

The format of the resulting panels is similar to that shown in Figure 49. Most of the fields in the panel are modifiable.

n/a WLM Display a visual map of workload management definitions using the specified group as a starting point.

Table 34. CICSGRP view overtype field
Field name Value
Description 1- to 30-character description of the CICS system group.
Hyperlink fields

Table 35 shows the hyperlink field on the CICSGRP view.

Table 35. CICSGRP view hyperlink fields
Hyperlink field View displayed Description
System Group SYSGRPC Identifies the members of the specified CICS system group.
Creating a CICS system group definition

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

Figure 49. Creating a CICS system group definition.
 ----------------------- Create System Group for EYUPLX01 ----------------------
 COMMAND  ===>
 
  System Group name  ===> EYUCSG01
  Description        ===> Starter Set System Group 1
 
 
Press Enter to Create the System Group.
Type END or CANCEL to cancel without creating.

Provide the following information, as appropriate:

System Group
Specify a 1- to 8-character name for the CICS system group. The name can contain alphabetic, numeric, or national characters. However, the first character must be alphabetic.
Note:
The name of a CICS system group must be unique within the CICSplex identified as the context; it should not be the same as the name of another CICS system group, a CICS system, or the CICSplex itself.
Description
(Optional.) Specify a 1- to 30-character description of the CICS system group.

Press Enter to add the CICS system group definition to the data repository.

There is no limit to the number of CICS system groups you can associate with a CICSplex.

Adding a member to a CICS system group

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

Figure 50. Adding a member to a CICS system group
 --------------------- Add Member to System Group for EYUPLX01 -----------------
 COMMAND  ===>
 
 System Group Name  EYUCSG02
 Description        Starter Set System Group 2
 
 Member       ===>                 CICS System, Group or Generic
 
  Component Spec     Inherit
 
  MON       EYUMOS01 NULL
  WLM       EYUWMS01 NULL
  RTA       EYURTS01 NULL
 
 Press Enter to add Member to System Group.
 Type END or CANCEL to cancel without adding.

Provide the following information, as appropriate:

Member
Specify the name of an existing CICS system or CICS system group that is to be associated with the CICSplex identified as the context.
Inherit
(Required when adding a CICS system to a CICS system group.) Indicate whether the CICS system is to inherit the resource monitor (MON), real-time analysis (RTA), or workload management (WLM) specification from the CICS system group to which you are associating it. Specify:
KEEP
The CICS system is to keep the specification currently associated with it. No action is taken if the CICS system is not currently associated with a specification.
FORCE
The CICS system is to inherit the specification associated with the CICS system group. When a CICS system is currently associated with a specification, but the CICS system group is not associated with any specification, the CICS system retains the current specification.
NULL
The CICS system is to inherit the specification associated with the CICS system group only if the CICS system is not currently associated with a specification. If the CICS system is already associated with a specification, it is to retain that specification.
The Spec field contains the name of the specification, if any, for a CICSPlex SM component that is currently associated with the CICS system group.

A CICS system in a CICS system group cannot inherit a specification from another CICS system group.

Press Enter to add this association to the data repository.

There is no limit to the number of members you can associate with a CICS system group.

Note:
If you are using the Business Application Services component, adding a CICS system to a CICS system group could result in inconsistent resource set or inconsistent scope errors. For information about this type of problem and how to resolve it, see the CICSPlex System Manager Managing Business Applications manual.
Removing a CICS system group

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

The line containing MON, RTA, or WLM component information is included in the panel only if the CICS system group has a specification associated with it.

Figure 51. Removing a CICS system group
 ------------------------- Remove System Group for EYUPLX01 --------------------
 COMMAND  ===>
 
 System Group Name   EYUCSG01
 Description
 
 Component Spec     Action
 MON       SPEC1    KEEP
 WLM       SPEC2
 
 
 Press ENTER to remove the System Group.
 Type END or CANCEL to cancel without removing.

Provide the following information:

Action
Indicate how the CICS systems comprising the CICS system group are to use any specifications associated with the CICS system group. Specify:
KEEP
Those CICS systems that inherited a specification from the CICS system group are explicitly assigned the specification.
DROP
Those CICS systems that inherited a specification from the CICS system group are not to use that specification.

If a specification is associated with a CICS system group, DROP is the default value that appears in the Action field when this panel is displayed.

Press Enter to remove the CICS system group definition from the data repository.

Associations between the CICS system group and its members are removed when the CICS system group is removed.

CICS system definitions

In order to be managed by CICSPlex SM, a CICS system must be associated with a CICSplex that is defined to CICSPlex SM. The definition establishing this association also contains information about how the CICS system is to use the workload management, real-time analysis, resource monitoring, and business application services components of CICSPlex SM.

To display information about CICS systems defined to a CICSplex, issue the command:

   CICSSYS [sysname]

where sysname is the specific or generic name of a CICS system known to the CICSplex identified as the context. If this parameter is omitted, the view, illustrated in Figure 52, includes information about all CICS systems associated with the CICSplex identified as the context.

Figure 52. The CICSSYS view
 27FEB2005 11:30:30 ---------- INFORMATION DISPLAY -----------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1         ALT WIN ===>
  W1 =CICSSYS===========EYUPLX01=EYUCSG01=27FEB2005==11:30:30=CPSM==========4===
 CMD  CICS       Description                       Model
 ---  System---  -------------------------------  --------
      EYUMAS1A   Starter Set TOR 1 on System A
      EYUMAS1B   Starter Set AOR 3 on System B
      EYUMAS3A   Starter Set AOR 2 on System A
      EYUMAS4A   Starter Set FOR 1 on System A
 

Action commands

Table 36 summarizes the action commands you can use with the CICSSYS view. Table 37 identifies the overtype field you can use with the CON action command.

Table 36. CICSSYS view action commands
Primary command Line command Description
n/a BAS Display a visual map of business application services definitions using the specified system as a starting point.
n/a BRO Browse a CICS system definition in the data repository.

The format of the resulting panels is similar to that shown in Figure 53 through Figure 57. All of the fields in the panels are nonmodifiable.

n/a CON Create system link (SYSLINK) definitions using the existing system links of a specified CICS system as a model, as described in CICSPlex System Manager Managing Business Applications.

When you issue the CON command, you must enter a CICS system name in the Model field.

CREate CRE Create a CICS system definition and add it to the data repository, as described in topic Creating a CICS system 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 a CICS system definition, fields in the new view contain values to be modeled (from the existing CICS system definition).

n/a GEN Create system link (SYSLINK) definitions based upon the existing connections of the active CICS system, as described in CICSPlex System Manager Managing Business Applications.
n/a GRP Add a CICS system to a CICS system group definition, as described in topic Adding a CICS system to a CICS system group.
n/a MAP Display a visual map of CICSPlex SM definitions, using the specified definition as a starting point. You are prompted to specify the type of definitions you want to map: business application services (BAS), resource monitoring (MON), real-time analysis (RTA), or workload management (WLM).
n/a MON Display a visual map of resource monitoring definitions using the specified system as a starting point.
n/a REM Remove a CICS system definition from the data repository. (When you remove a CICS system definition, associations between the CICS system and any CICS system groups or component specifications are also removed.)
n/a RTA Display a visual map of real-time analysis definitions using the specified system as a starting point.
TEMPMP cmas n/a Change the temporary maintenance point CMAS to a specific CMAS or display a selection list based on a generic CMAS ID. For more information about temporary maintenance point CMASs, see Working with maintenance point CMASs.
n/a UPD Update a CICS system definition in the data repository.

The format of the resulting panels is similar to that shown in Figure 53 through Figure 57. Most of the fields in the panels are modifiable. (A difference is that when resource monitoring, real-time analysis, and workload management are active, the appropriate specification names and types of links to those specifications are shown.)

For an active system, any changes you make via this view take effect immediately and are permanent. Refer to the panel descriptions in Creating a CICS system definition for field-specific information on whether an update is effective immediately or at the next CICS system restart.You can use the MAS view, as indicated in Table 4, to temporarily change the definitions of an active CICS system.

In order to activate a component, an appropriate specification (workload, real-time analysis, or monitor) must be associated with the CICS system.

Note:
Using the CICSSYS view to update definitions affects both a currently running system and the definitions in the data repository.
n/a WLM Display a visual map of workload management definitions using the specified system as a starting point.

 

Table 37. CICSSYS view overtype field
Field name Value
Model Name of a CICS system whose system links are to be used as a model.
Note:
To use the system links of another CICS system as a model, type the CON action command in the line command field next to the name of the CICS system and enter a CICS system name in the Model field.

Hyperlink fields

Table 38 shows the hyperlink field on the CICSSYS view.

Table 38. CICSSYS view hyperlink field
Hyperlink field View displayed Description
CICS System SYSGRPC Identifies the CICS system group to which the CICS system belongs.

Creating a CICS system definition

When you use the create primary (CREate) or line (CRE) action command from the CICSSYS view, a series of input panels is produced.

In the descriptions of the panels, you are informed about fields for which input for an active system takes immediate effect when you press Enter to issue the UPDate action command. For all other fields, UPDate input does not take effect until the CICS system is restarted.

  1. Figure 53 shows the format of the first panel produced when you want to create a CICS system definition.
    Figure 53. Creating a CICS system definition - general attributes
    --------------- Create System - General Attributes - for EUPLX01 ---------------
    COMMAND ===>
     
     System Name ===>
     Description ===>
     
     Primary CMAS             ===> EYUCMS01   RTA System Availability Monitoring CMAS
     Active Period            ===> PRIME      Hours of Operation
     APPLID                   ===>            VTAM application ID
     SYSIDNT                  ===>            System communication ID
     
                                            SECURITY
     CICS Command Checking    ===> *          Simulated CICS Cmd Checks
     CICS Resource Checking   ===> *          Simulated CICS Res Checks
     Exemption Checking       ===> *          Check for Exempt Users
     
                                            TIME
     Time Zone                ===> *          Time Zone for System
     Time Zone Offset         ===> *          Time Zone Offset for System
     Daylight Savings Time    ===> *          Daylight Savings for System
     
    Enter DOWN or UP to view other System screens.
    Press Enter to create the System.
    Type END or CANCEL to cancel without creating.
    Provide the following information, as appropriate:
    System Name
    Specify a 1- to 8-character name for the CICS system to be associated with the CICSplex identified as the context. The name can contain alphabetic, numeric, or national characters. However, the first character must be alphabetic.
    Note:
    The name of a CICS system must be unique within the CICSplex; it should not be the same as the name of another CICS system, a CICS system group, or the CICSplex itself.

    Make sure that the name you specify here matches the name you specify with the EYUPARM parameter NAME in the start up JCL for the CICS system. (See the CICS Transaction Server for z/OS® Installation Guide manual for additional information.)

    Description
    (Optional.) Specify a 1- to 30-character description of the CICS system.
    Primary CMAS
    (Required only for system availability monitoring, as described in CICSPlex System Manager Managing Resource Usage) Specify the name of the CMAS that should be assigned the task of monitoring the availability of this CICS system.

    When the CICS system is part of a CICSplex that is managed by a single CMAS, specify the name of that CMAS.

    When multiple CMASs are involved in managing the CICSplex, identify the CMAS to which the CICS system normally connects. Naming a CMAS does not prevent the CICS system from connecting to another CMAS when, for example, the primary CMAS is not available.

    If the designated CMAS is not available and:

    • It is the only CMAS managing the CICSplex with which the CICS system is associated, the CICS system is not known to CICSPlex SM.
    • There are multiple CMASs involved in managing the CICSplex, the secondary CMAS, as specified in the APCMAS view, takes over availability monitoring.

    For an active system, data entered in this field takes effect when you press Enter.

    Active Period
    (Required only for system availability monitoring, as described in CICSPlex System Manager Managing Resource Usage) Specify the name of the period definition that identifies the hours during which this CICS system is to be running. (You can use the PERIODEF view, as described in Table 4, to display a list of existing time period definitions.) You can specify any appropriate name. If the name you specify does not belong to an existing period definition, you can create that period definition later.

    This name plus the Primary CMAS name are used by system availability monitoring (SAM) to generate external notifications when the CICS system is not active during its defined hours of operation.

    For an active system, data entered in this field takes effect when you press Enter.

    APPLID
    Specify the VTAM® application ID of the CICS system.
    Note:
    Start of change
    See CICSPlex System Manager Managing Business Applications for information on changing this value and the impacts on SYSLINKs.
    End of change
    SYSIDNT
    Specify the 4-character system ID of the CICS system. Start of changeThe value specified must match the CICS SYSIDNT SIT operand or override. If the SYSIDNT value used by the MAS does not match the CICSSYS definition, the topology connect of CICS will fail.End of change
    Note:
    Start of change
    See CICSPlex System Manager Managing Business Applications for information on changing this value and the impacts on SYSLINKs.
    End of change
    CICS Command Checking
    Indicate whether CICSPlex SM security checking is to simulate CICS command checking for this CICS system. Specify:
    YES
    Simulate CICS security checking for this CICS system.
    NO
    Do not simulate CICS security checking for this CICS system.
    *
    Use the value assigned to the CICSplex with which this CICS system is associated.

    For an active system, data entered in this field takes effect when you press Enter.

    CICS Resource Checking
    Indicate whether CICSPlex SM security checking is to simulate CICS resource checking for this CICS system. Specify:
    YES
    Simulate CICS resource checking for this CICS system.
    NO
    Do not simulate CICS resource checking for this CICS system.
    *
    Use the value assigned to the CICSplex with which this CICS system is associated.

    For an active system, data entered in this field takes effect when you press Enter.

    Exemption Checking
    Indicate whether all simulated CICS security checking is to be bypassed for this CICS system. Specify:
    YES
    Bypass all simulated CICS security checking for this CICS system.
    NO
    Do not bypass simulated CICS security checking for this CICS system.
    *
    Use the value assigned to the CICSplex with which this CICS system is associated.

    For an active system, data entered in this field takes effect when you press Enter.

    Time Zone
    Identify the time zone in which this CICS system is located by specifying:
    • A code in the range B through Z. (See Table 32 for a description of these codes.)
    • * (asterisk), to inherit the time zone offset assigned to the CMAS to which this CICS system is connected, or the primary CMAS, if the CICS system is inactive.
    Note:
    If you specify * (asterisk) for any one of the time fields, you must specify asterisk for all three time fields.

    For an active system, data entered in this field takes effect when you press Enter.

    Time Zone Offset
    Indicate the adjustment value that is to be applied to the computed time. This value is used to resolve time references in areas that do not use a standard zone. Specify:
    • A value between 0 and 59 to identify the number of minutes to be added to the time for that time zone (for areas that do not use a standard time zone).
    • * (asterisk), to inherit the time zone offset assigned to the CMAS to which this CICS system is connected, or the primary CMAS, if the CICS system is inactive.

    For an active system, data entered in this field takes effect when you press Enter.

    Daylight Savings Time
    Indicate whether you are currently recognizing daylight saving time. Specify:
    YES
    Recognize daylight saving time.
    NO
    Do not recognize daylight saving time.
    *
    Use the value assigned to the daylight time indicator assigned to the CMAS to which this CICS system is connected, or the primary CMAS, if the CICS system is inactive.

    For an active system, data entered in this field takes effect when you press Enter.

    For more information about the time zone attributes and their use, see CICSPlex SM time zone attributes.

    If the CICS system definition is complete, press Enter. If other attributes must be specified, issue the DOWN command.

  2. Figure 54 shows the format of the panel produced the first time you issue the DOWN command.
    Figure 54. Creating a CICS system definition - workload attributes
    --------------- Create System - Workload Attributes - for EUPLX01 -------------
    COMMAND ===>
     
     System Name      EYUMAS1A
     Description      Starter Set TOR 1 on System A
     
     Routing Support active    ===> NO     Routing support to be activated
     
     Target routing at startup  ===> YES
     
     
    Enter DOWN or UP to view other System screens.
    Press Enter to create the System.
    Type END or CANCEL to cancel without creating.
    Provide the following information about workload management. Note that the CICS system can act as one or more of the following:

    See Combining CICS systems and CICS system groups for more information about the roles of CICS regions in dynamic routing. For more information about workload management, see CICSPlex System Manager Managing Workloads.

    Routing support active
    Indicate whether this region can act as a routing region when CICS is started. Specify:
    YES
    Workload management is to be active.

    The CICS system is assumed to be a routing region that is associated with an appropriate workload specification.

    NO
    Workload management is not to be active.
    Workload specification
    BROwse and UPDate operations only. For workload management to occur, the CICS system must be associated with workload specification. If it is, the specification name is shown.
    Specification source
    BROwse and UPDate operations only. The type of link between the CICS system and the workload specification is displayed.
    System group name
    BROwse and UPDate operations only. If the specification is inherited from a CICS system group, the group name is displayed.

    If the CICS system is not a routing region, or is not associated with a specification, no workload management occurs.

    Target routing at startup
    Indicate whether the CICS system is a potential target for workload routing at startup. Specify:
    YES
    The CICS system is to be included in dynamic routing when the CICS system becomes active.
    NO
    The CICS system is to be excluded from dynamic routing when the CICS system becomes active.
    Note:
    To have a CICS system included in dynamic routing after it becomes active, use the WLMAWAOR view, as described in Table 4.

    If the CICS system definition is complete, press Enter. If other attributes must be specified, issue the DOWN command.

  3. Figure 55 shows the format of the panel produced the second time you issue the DOWN command.
    Figure 55. Creating a CICS system definition - real-time analysis attributes
    --------------- Create System - Analysis Attributes - for EUPLX01 -------------
    COMMAND ===>
     
     System Name      EYUMAS1A
     Description      Starter Set TOR 1 on System A
     
     Analysis active         ===> YES        Activate at RTA at startup
     
     System availability management:
                       Action or   Action      Severity        Severity
                        Generic    Inherit                     Inherit
      SAM         ===>              ===> NO    ===>           ===> NO
      SOS         ===>              ===> NO    ===>           ===> NO
      SYSDUMP     ===>              ===> NO    ===>           ===> NO
      TRANDUMP    ===>              ===> NO    ===>           ===> NO
      MAXTASK     ===>              ===> NO    ===>           ===> NO
      STALL       ===>              ===> NO    ===>           ===> NO
     
     
    Type DOWN or UP to view other System Screens.
    Press ENTER to Create the System.
    Type END or CANCEL to cancel without creating.
    Provide the following information about real-time analysis. Any value you specify in an action or severity field will override the corresponding value in the analysis specification to which this CICS system will be associated. (For additional information about real-time analysis, see the CICSPlex System Manager Managing Resource Usage manual.).
    Analysis active
    Indicate whether the system availability monitoring (SAM) and MAS resource monitoring (MRM) components of real-time analysis are to be active when this CICS system is started. Specify:
    YES
    System availability monitoring and MAS resource monitoring are to be active.
    NO
    System availability monitoring and MAS resource monitoring are not to be active.
    SAM
    Only system availability monitoring is to be active.
    MRM
    Only MAS resource monitoring is to be active.
    Analysis specification
    BROwse and UPDate operations only. For RTA to occur, the CICS system must be associated with a real-time analysis specification. If it is, the specification name is shown.
    Specification source
    BROwse and UPDate operations only. The type of link between the CICS system and the real-time analysis specification is displayed.
    System group name
    BROwse and UPDate operations only. If the specification is inherited from a CICS system group, the group name is displayed.

    If the CICS system is not a routing region, or is not associated with a specification, no workload management occurs.

    Notes:
    1. For MAS resource monitoring to occur, the CICS system must be associated with an analysis specification; if it is not, no MAS resource monitoring occurs.
    2. If a new analysis specification is associated with the CICS system while it is active, you must stop and restart MAS resource monitoring for the specification to take effect. First use the UPD action command to specify NO in this field and press Enter to turn MAS resource monitoring off. Then use the UPD action command again and specify either YES or MRM. MAS resource monitoring will become active using the new analysis specification.

    For an active system, data entered in this field takes effect when you press Enter.

    Action
    Identify the action definition to be used when generating notification about the designated predefined condition. Specify:
    name
    The specific or generic name of an existing action definition.
    If you leave this field blank and specify NO in the Action Inherit field, the default action definition is used.

    For an active system, data entered in this field takes effect when you press Enter.

    Action Inherit
    Indicate whether or not the action definition is to be inherited from the analysis specification. Specify:
    YES
    The action definition is to be inherited from the specification. When you specify YES, you cannot specify the name of an action definition in the Action field. If you specify YES and enter the name of an action definition in the Action field, the following message is displayed:
         Data not allowed with Inherit.
    and the cursor is moved to the Action or Generic column.
    NO
    The action definition is not to be inherited from the analysis specification.

    If you specify NO and leave the Action field blank, the default action definition is used.

    The default Action Inherit value is NO.

    For an active system, data entered in this field takes effect when you press Enter.

    Severity
    Indicate how the predefined condition is to be handled. Specify:
    *
    List of severities.
    level
    The severity level that is to be associated with the designated condition. The severity levels are:
    VHS
    Very high severe
    HS
    High severe
    HW
    High warning
    LW
    Low warning
    LS
    Low severe
    VLS
    Very low severe
    NO
    Exclude this condition from monitoring.
    If you leave this field blank and specify NO in the Severity Inherit field, the default severity level is used.

    For an active system, data entered in this field takes effect when you press Enter.

    Severity Inherit
    Indicate whether or not the severity level is to be inherited from the analysis specification. Specify:
    YES
    The severity level is to be inherited from the specification. When you specify YES, you cannot specify a severity level in the Severity field. If you specify YES and enter a severity level in the Severity field, the following message is displayed:
         Data not allowed with Inherit.
    and the cursor is moved to the Severity column.
    NO
    The severity level is not to be inherited from the analysis specification.

    If you specify NO and leave the Severity field blank, the default severity level is used.

    The default Severity Inherit value is NO.

    For an active system, data entered in this field takes effect when you press Enter.

    If the CICS system definition is complete, press Enter. If other attributes must be specified, issue the DOWN command.

  4. Figure 56 shows the format of the panel produced the third time you issue the DOWN command.
    Figure 56. Creating a CICS system definition - resource monitoring attributes
     -------------- Create System - Monitor Attributes - for EYUPLX01 --------------
     COMMAND ===>
     
      System name      EYUMAS4A
      Description      Starter Set FOR 1 on System A
     
      Monitoring active      ===> *          Activate at monitoring at startup
      Data retention period  ===>            Data retained after termination n
     
      Resource Sample Rates:
       CICS Region           ===>            Connections           ===>
       Global                ===>            Files                 ===>
       DB2                   ===>            Journals              ===>
                                             Programs              ===>
                                             Terminals             ===>
                                             Transactions          ===>
                                             TD Queues             ===>
     
     Type DOWN or UP to view other System screens.
     Press ENTER to create the System.
     Type END or CANCEL to cancel without creating.
    Provide the following information about resource monitoring. Any data retention period or sample interval values you specify here will override the corresponding values in the monitor specification to which this CICS system will be associated. (For additional information about resource monitoring, see CICSPlex System Manager Managing Resource Usage.)
    Monitoring active
    Indicate whether resource monitoring is to be active when this CICS system is started. Specify:
    YES
    Resource monitoring is to be active.

    For this to occur, the CICS system must be associated with a monitor specification.

    NO
    Resource monitoring is not to be active.
    *
    Resource monitoring activity depends on the value specified with the monitor specification to which this CICS system is associated.

    Specify YES or NO to override the value in the comparable field of the monitor specification associated with this CICS system. Specify * (asterisk) when the value specified with the monitor specification is to be used.

    Monitor specification
    BROwse and UPDate operations only. For resource monitoring to occur, the CICS system must be associated with a monitor specification. If it is, the specification name are shown.
    Specification source
    BROwse and UPDate operations only. The type of link between the CICS system and the monitor specification is displayed.
    System group name
    BROwse and UPDate operations only. If the specification is inherited from a CICS system group, the group name is displayed.
    Data retention period
    Specify the number of minutes collected data is to be kept after resource monitoring stops. (Resource monitoring stops when the CICS system stops or when the MAS view command is used to stop resource monitoring for the CICS system.)

    The retention period can be:

    1 - 1440
    Collected data is to be kept the specified number of minutes.
    0
    Collected data is not to be kept.
    blank
    The CICS system is to use the value specified with its associated monitor specification.

    For an active system, data entered in this field takes effect when you press Enter.

    Resource sample intervals
    For each type of resource you want to monitor, specify how long, in seconds, CICSPlex SM is to wait between the collection of sample data. You can specify a sample interval for:
    • Resource types for which you created a monitor definition (such as connections or files)
    • CICS Region, Global, or DB2® resources, which do not require a monitor definition. These types provide monitoring of the following resources:
      CICS Region
      CICS regions and dynamic storage areas
      Global
      Transient data queue usage, temporary storage queue usage, LSR pools, transaction classes, and FEPI connections
      DB2
      DB2 threads
    The sample interval can be:
    1 - 86400
    A value evenly divisible into the monitor interval value, when converted to seconds. If you specify a value that is not evenly divisible, you are prompted for one that is.
    Note:
    The lower you set the sampling interval, the greater the impact on processing overhead.
    0
    No resource monitoring is to occur.
    blank
    The CICS system is to use the value specified with its associated monitor specification.

    If the CICS system definition is complete, press Enter. If other attributes must be specified, issue the DOWN command.

  5. Figure 57 shows the format of the panel produced the fourth time you issue the DOWN command.
    Figure 57. Creating a CICS system definition - business application services attributes
    COMMAND ===>
     
     System Name      EYUMAS1A
     Description      Starter Set TOR 1 on System A
     
     Install Resources  ===> NEVER     (NEVER, ALWAYS, COLDONLY, WARMONLY)
     
     Recovery Action    ===> CONTINUE  (CONTINUE,PROMPT,TERMINATE,IMMEDIATE,NORMAL)
     
     
    Enter DOWN or UP to view other System screens.
    Press Enter to create the System.
    Type END or CANCEL to cancel without creating.
    Provide the following information, as appropriate:
    Install Resources
    For CICS systems running CICS/ESA 4.1 or later, indicate whether resources associated with the system through a resource description should be automatically installed when the MAS connects to the CMAS. Specify:
    ALWAYS
    Install resources every time the MAS connects after a CICS startup.
    COLDONLY
    Install resources only when the MAS connects after a CICS INITIAL or COLD start.
    NEVER
    Resources should never be automatically installed in this CICS system.
    WARMONLY
    Install resources only when the MAS connects after a CICS warm start or emergency restart (AUTO).
    Notes:
    1. You can also control the automatic installation of specific resources using the Auto Install field on a resource description.
    2. System links (SYSLINKs)are not controlled by resource descriptions. Therefore, either all SYSLINKs for a given CICS system are automatically installed or none are, depending on the Install Resources value for that system.
    3. Automatic installation of resources is not supported for systems running any version of CICS other than CICS/ESA 4.1 or later. In those systems, this field is checked for syntax, but its value has no meaning.
    Recovery Action
    Indicate what action should be taken when automatic resource installation errors occur. Specify:
    CONTINUE
    Continue installing other resource definitions. A CICSPlex SM message is issued to the console and CMAS EYULOG.
    IMMEDIATE
    Shut down the CICS system immediately. A CICSPlex SM message is issued to the console and CMAS EYULOG.
    NORMAL
    Shut down the CICS system normally. A CICSPlex SM message is issued to the console and CMAS EYULOG.
    PROMPT
    Prompt the operator console for an action. The resource installation process is suspended, but all other MAS processing continues. A CICSPlex SM message is issued to the console and CMAS EYULOG.
    TERMINATE
    Terminate the resource installation process. A CICSPlex SM message is issued to the console and CMAS EYULOG. No more resource definitions are processed. Any resource definitions that were successfully installed are not removed.
    To add the CICS system definition to the data repository, press Enter.

Adding a CICS system to a CICS system group

Figure 58 illustrates the panel produced when you use the group (GRP) line action command from the CICSSYS view.

Figure 58. Adding a CICS system to a CICS system group
 -------------------- Add System to System Group for EYUPLX01 ------------------
 COMMAND  ===>
 
  System Name        EYUMAS1A
 
  Scope        ===>  PRODGRP          System Group Name or Generic
 
            Current
  Component Spec   Source   Group    Inherit Spec
  MON       SPEC1  INHERIT  OTHERGRP NO
  RTA                                YES
  WLM       SPEC2  EXPLICIT          NO
 
 
Press Enter to Add System to System Group.
Type END or CANCEL to cancel without adding.

Provide the following information, as appropriate:

Scope
Specify the name of an existing CICS system group to which the CICS system is to be associated.

If the appropriate CICS system group does not currently exist, create it, as described in topic Creating a CICS system group definition, and then add the CICS system to the group, using either this view or the view described in topic Adding a member to a CICS system group.

Inherit Spec
Indicate whether the CICS system is to inherit the specification for a CICSPlex SM component from the CICS system group to which you are associating it. Specify:
YES
The CICS system is to inherit the specification associated with the CICS system group. (If there is no association between a CICS system group and a specification, the CICS system inherits no specification.)
NO
The CICS system is not to inherit the specification associated with the CICS system group.

When you specify NO and you want one or more of the components to be active, you must associate the CICS system with the appropriate specification.

To add this association to the data repository, press Enter.

Note:
If you are using the Business Application Services component, adding a CICS system to a CICS system group could result in inconsistent resource set or inconsistent scope errors. For information about this type of problem and how to resolve it, see the CICSPlex System Manager Managing Business Applications manual.

When a specification for a CICSPlex SM component is associated with a CICS system:

When this panel is initially displayed, the Inherit Spec field is set to:

To remove a CICS system from a CICS system group, use the SYSGRPC view, as described in topic Removing a member from a CICS system group.

Creating system link definitions

You can use either the CON action command or the GEN action command to create system link definitions from the CICSSYS view:

CON
Is useful when you have created a new CICS system and you want to model its system links on the links defined for another system. Neither the CICS system nor the model system have to be active when you issue the CON action command.
Note:
Using the CON action command has the same effect as specifying a Model System when the CICS system is created or updated.
GEN
Is useful when you are migrating existing system link definitions for a CICS system from RDO to the CICSPlex SM data repository. The CICS system and all the systems for which you want to create system link definitions must be active when you issue the GEN action command.

The CON and GEN action commands both create balanced, bidirectional system link definitions for the CICS systems you select. The new system links maintain the same relationships that exist either for the model system or in the CSD (as far as which system is considered the primary and which is the secondary). The system IDs of the primary and secondary CICS systems form the name of the new system link.

The system link definitions that are created by CON and GEN are added to the data repository. The actual system links become active when they are installed. System links can be installed:

Using the CON action command

With the CON action command, you can model the system links for a new CICS system after an existing CICS system whose links are already defined to CICSPlex SM.

Figure 59 illustrates the panel produced when you use the connect (CON) line action command from the CICSSYS view.

Figure 59. Creating system link definitions from a model
 COMMAND  ===>
 
    Primary CICS System      EYUMAS1A
 
    ConnDef Name        ===>           Version   ===>
    SessDef Name        ===>           Version   ===>
 
 Sel System   Id   Applid   Dir         Description               Result
  -  -------- ---- -------- --- ------------------------------ ----------------
     EYUMAS1B A003 EYUMAS1B TO
     EYUMAS3A A002 EYUMAS3A TO
     EYUMAS4A F001 EYUMAS4A FRO
 
 
 
 
 

Provide the following information, as appropriate:

ConnDef Name
Specify the 1- to 4-character name of a connection definition that is known to CICSPlex SM. The connection definition is used, together with the sessions definition, to construct the system link definitions.
SessDef Name
Specify the 1- to 8-character name of a sessions definition that is known to CICSPlex SM. The sessions definition is used, together with the connection definition, to construct the system link definitions.
Version
Indicate what version of the specified connection and sessions definitions should be used in constructing the system link definitions.

Following these fields is a list of CICS systems that have a system link to the model CICS system, but do not currently have a link to the primary system (that is, the CICS system for which the CON action was issued). For each CICS system, the following information is provided:

System
The name of the CICS system.
Id
The system ID of the CICS system.
Applid
The application ID of the CICS system.
Dir
The direction of the link that exists for the CICS system, as:
TO
The link originated with the primary system. That is, a link was defined to the specified system.
FRO
The link originated with the specified system. That is, a link was defined from the specified system.
Description
A 1- to 30- character description of the CICS system, if one was supplied when it was created.
Result
Indicates the result of CICSPlex SM's attempt to define each system link. For a description of the Result values, see How system link requests are processed.

To define a system link to one or more of the specified CICS systems, type an S (for select) to the left of the CICS system name. You can use the UP and DOWN commands to scroll the list of CICS system names.

When you finish making your selections, press Enter to define the system links. To cancel the request without defining any system links, issue the END command.

Using the GEN action command

With the GEN action command, you can use the active connections of a CICS system to define corresponding system links to CICSPlex SM.

Figure 60 illustrates the panel produced when you use the generate (GEN) line action command from the CICSSYS view.

Figure 60. Creating system link definitions from existing connections
 COMMAND  ===>
 
    Primary CICS System        EYUMAS1A
 
    ConnDef Name LU61     ===>          Version   ===>
    SessDef Name LU61     ===>          Version   ===>
    ConnDef Name LU62     ===>          Version   ===>
    SessDef Name LU62     ===>          Version   ===>
    ConnDef Name MRO      ===>          Version   ===>
    SessDef Name MRO      ===>          Version   ===>
    ConnDef Name INDIRECT ===>          Version   ===>
    SessDef Name INDIRECT ===>          Version   ===>
 
 Sel System   Id   Applid   Type     Description                   Result
  -  -------- ---- -------- ---- ------------------------------ ---------------
     EYUMAS1B A003 EYUMAS1B LU62
     EYUMAS3A A002 EYUMAS3A MRO
     EYUMAS4A F001 EYUMAS4A MRO

Note:
Both CICS systems must be active for a system link definition to be created by the GEN action command.

Provide the following information, as appropriate:

ConnDef Name LU61
Specify the 1- to 4-character name of a connection definition to be used for LU 6.1 links.
SessDef Name LU61
Specify the 1- to 8-character name of a sessions definition to be used for LU 6.1 links.
ConnDef Name LU62
Specify the 1- to 4-character name of a connection definition to be used for LU 6.2 links.
SessDef Name LU62
Specify the 1- to 8-character name of a sessions definition to be used for LU 6.2 links.
ConnDef Name MRO
Specify the 1- to 4-character name of a connection definition to be used for MRO links.
SessDef Name MRO
Specify the 1- to 8-character name of a sessions definition to be used for MRO links.
ConnDef Name INDIRECT
Specify the 1- to 4-character name of a connection definition to be used for indirect links.
SessDef Name INDIRECT
Specify the 1- to 8-character name of a sessions definition to be used for indirect links.
Version
Indicate what version of the specified connection and sessions definitions should be used in constructing the system link definitions.

Following these fields is a list of active CICS systems that have connections to the source system (that is, the CICS system for which the GEN action was issued). However, these connections are not currently defined as system links in the CICSPlex SM data repository. For each CICS system, the following information is provided:

System
The name of the CICS system.
Id
The system ID of the CICS system.
Applid
The application ID of the CICS system.
Type
The type of link that exists between the specified CICS system and the source system.
Description
A 1- to 30- character description of the CICS system, if one was supplied when it was created.
Result
Indicates the result of CICSPlex SM's attempt to define each system link. For a description of the Result values, see How system link requests are processed.

To define a system link to one or more of the specified CICS systems, type an S (for select) to the left of the CICS system name. You can use the UP and DOWN commands to scroll the list of CICS system names.

When you finish making your selections, press Enter to define the system links. To cancel the request without defining any system links, issue the END command.

How system link requests are processed

The CON or GEN input panel remains displayed while CICSPlex SM attempts to create the system link definitions. If links to all of the selected systems are successfully defined, the CICSSYS view is redisplayed.

If CICSPlex SM detects any errors while creating the system link definitions, the input panel is redisplayed. The Result field indicates the status of the definition for each selected system:

Logical Duplicate
A CICS system link has already been defined between the two systems. The selected system was previously identified as the primary system in a system link definition. Because CICSPlex SM creates bidirectional system links, another definition is not required.
No Primary Sysid
The definition of the primary system in the CICSPlex SM data repository does not include a CICS system ID. Make sure the SYSIDNT field in the CICSSYS definition contains a system ID.
No Secondary Sysid
The definition of the selected (or secondary) system in the CICSPlex SM data repository does not include a CICS system ID. Make sure the SYSIDNT field in the CICSSYS definition contains a system ID.
Processed
A system link was successfully defined between this CICS system and the selected system.
Record Exists
A CICS system link has already been defined between the primary system and the selected system.
Same Sysids
A system link definition could not be created because the primary system and the selected system have the same CICS system ID. Make sure the CICS system IDs for both systems have been correctly defined to CICSPlex SM using the SYSIDNT field in the CICSSYS definition.
Severe Error
A system link definition could not be created between the primary system and the selected system because of an unexpected error condition. When you issue the END command to exit from the input panel, EYUEInnnn messages are displayed that describe the error condition.

PERIODEF (Time period definitions)

A time period definition identifies a specific range of hours and minutes. These definitions are used with resource monitoring and real-time analysis to designate when specific actions are to start and stop.

To display information about existing time period definitions, issue the command:

   PERIODEF [periodef]

where periodef is the specific or generic name of an existing time period definition. If this parameter is omitted, the view, illustrated in Figure 61, includes information about all time period definitions known to the CICSplex identified as the context.

Figure 61. The PERIODEF view
 27FEB2005  19:48:16 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =PERIODEF==========EYUPLX01=EYUPLX01=27FEB2005==19:48:16=CPSM==========4===
 CMD Period   Start End   Time Zone Time
 --- Name---- Time- Time- Zone Adj- Description-------------------
     EYUPDF01 08:00 21:00 Z       0 SSet - Normal day
     EYUPDF02 17:01 21:00 Z       0 SSet - Batch time
     EYUPDF03 11:45 13:15 Z       0 SSet - Peak usage
     EYUPDF04 07:59 08:00 Z       0 SSet - Files required
 

Action commands

Table 39 summarizes the action commands you can use with the PERIODEF view. Table 40 identifies the overtype fields that you can modify when you use the SET action command.

Table 39. PERIODEF view action commands
Primary command Line command Description
n/a BRO Browse a period definition in the data repository.

The format of the resulting panels is identical to that shown in Figure 62. All of the fields are nonmodifiable.

CREate CRE Create a period definition, as described in Creating a period definition.
n/a MAP Display a visual map of CICSPlex SM definitions, using the specified definition as a starting point. You are prompted to specify the type of definitions you want to map: resource monitoring (MON) or real-time analysis (RTA).
n/a MON Display a visual map of resource monitoring definitions using the specified definition as a starting point.
n/a REM Remove a period definition.
Note:
Removing a period definition may adversely affect any CICSPlex SM function that is currently active and using the designated definition. Period definitions are needed for the following views:
  • CICSSYS
  • MONDEF
  • MONINGRP
  • RTADEF
  • RTAINGRP
  • STATDEF.
n/a RTA Display a visual map of real-time analysis definitions using the specified definition as a starting point.
n/a SET Change an existing period definition using overtype fields.

Changes take effect immediately. Users are notified of any changes that alter the current status of a CICSPlex SM component using the definition. That is, users are informed when a change causes a currently active component to become inactive, or an inactive component to become active.

Note:
The value you specified in the Require Set field on the CICSPlex SM entry panel determines whether you must use the SET command when you overtype a field.
TEMPMP cmas 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 UPDate Update a period definition in the data repository.

The format of the resulting panels is identical to that shown in Figure 62. Most of the fields in the panel are modifiable.

Note:
Using the PERIODEF view to update definitions affects both a currently running system and the definitions in the data repository.
Table 40. PERIODEF view overtype fields
Field name Value
Start Time The time at which the period is to start, specified in hours and minutes. You can use any of the following values:
HH:MM
Specify two numeric characters each, separated by a colon, for both hours and minutes.
HH:
Specify only the two numeric characters for hours, followed by the colon.
H:MM
Specify only one numeric character for hours, followed by a colon then two numeric characters for minutes.
:MM
Specify the colon, followed by two numeric characters for minutes.
H:
Specify only one numeric character for hours, followed by the colon.
:
Specify only the colon, to indicate two zeros each for both hours and minutes.
End Time The time at which the period is to stop, specified in hours and minutes. The values can be the same as for Start Time.
Time Zone A single-character code, shown in Table 32, identifying the time zone to which the start and end times apply.
Zone Adjustment Adjustment factor to be applied to the computed time.
Description 1- to 30-character description of the period.
Note:
To change a period definition, type the SET action command in the line command field next to the name of the period to be affected and overtype the current contents of the appropriate fields.

The value you specified in the Require Set field on the CICSPlex SM entry panel determines whether or not you must use the SET command when you overtype a field.

Hyperlink fields

There are no hyperlink fields in the PERIODEF view.

Creating a period definition

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

Figure 62. Creating a time period definition
 ----------------------- Create Time Period Def for EYUPLX01 -------------------
 COMMAND  ===>
 
  Definition Name ===> prime
  Description     ===>
 
  Time Period Definition:
   Start Time      ===>         (HH:MM)
   End Time        ===>         (HH:MM)
   Time Zone       ===>
   Zone Adjustment ===> 0
 
 
Press Enter to Create Time Period Definition.
Type END or CANCEL to cancel without creating.

Provide the following information, as appropriate:

Definition Name
Specify a 1- to 8-character name for the time period definition. The name can contain alphabetic, numeric, or national characters. However, the first character must be alphabetic.
Description
Specify a 1- to 30-character description of the time period.
Start Time
Specify the hour and minute at which the time period is to start.
End Time
Specify the hour and minute at which the time period is to end.
Time Zone
Specify one of the codes shown in Table 32 to identify the time zone to which the period definition is to apply.
Zone Adjustment
Specify a value between 0 and 59 to identify the number of minutes to be added to the time for that time zone (for areas that do not use a standard time zone).

Press Enter to save this definition.

[[ Contents Previous Page | Next Page Index ]]