Start of change

Managing topology definitions using the Web User Interface

You can manage topology definitions in the WUI using a series of views accessed by clicking Administration views-->Topology administration views.Table 31 summarizes the topology management tasks you can carry out using these views:

Table 31. Web User Interface topology management tasks
Web User Interface view Resource name Task
CICS system definition CYSDEF
  • Create, update or remove CICS system. definitions.
  • Add CICS systems to a CICS system group definition.
System group definition CYSGRP
  • Create, update or remove CICS system group definitions.
  • Add CICS systems or system groups to a CICS system group definition.
CICS system group to CICS system group link CSGLCGCG Create or remove CICS system group to CICS system group links.
Link between CICS system and CICS system group CSGLCGCS Create or remove CICS system to CICS system group links.
Time period definition PERIODEF Create, update or remove a time period definition

Reminder: Unless noted otherwise, only the context setting is recognized when you are creating and maintaining topology definitions.

The remainder of this section describes how to use the WUI to perform some typical topology tasks.

Start of change

Managing CICS system group definitions using the Web User Interface

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.

The remainder of this section describes a typical CICS system group definition task using the Web User Interface.

Creating a CICS system group definition using the Web User Interface

Follow this procedure to create a CICS system group definition and add it to the data repository.

  1. Click Topology administration views-->CICS system group definitions to open the System group definition tabular view .

    This view displays a summary any CICS system groups already defined to the CICSPlex.

  2. If you want to use some of the information from an existing definition in the creation of your new definition, select an existing definition by selecting a check box in the Record column
  3. Click the Create action button.

    This opens the System group definition create panel.

  4. Provide the following information.
    System group name
    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.
  5. Click Yes 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.

End of change

Working with 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, use the CICS system definition view , which is accessed from the Topology administration views menu.

The remainder of this section consists of some typical CICS system definition tasks using the Web User Interface.

Creating a CICS system definition using the Web User Interface

Follow this procedure to create a CICS system definition and add it to the data repository.

  1. Click Topology administration views-->CICS system definitions to open the CICS system definition tabular view .

    This view displays a summary any CICS systems already defined to the CICSPlex.

  2. If you want to use some of the information from an existing definition in the creation of your new definition, select an existing definition by selecting a check box in the Record column
  3. Click the Create button.

    This opens the CICS system definition create panel. This is a large panel with attributes divided into groups.

  4. Type in the following general information.
    CICS system definition 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 name
    (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.

    Period definition name
    (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 Time period definition 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.

    CICS VTAM application ID
    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
    System ID
    Specify the 4-character system ID of the CICS system. The 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.
    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
  5. Type in the following security information.
    Simulated CICS command security 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.
    Simulated CICS resource security 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.
    Exemption from simulated security checks
    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.
  6. Type in the following time zone information.
    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.
    Daylight savings in effect
    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.
  7. Type in the following workload management information.
    Workload manager status
    Indicate whether or not workload management is to be used.
    AOR dynamic routing mode
    Indicate whether or not 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.
  8. Provide the following real time analysis (RTA) information.
    Real time analysis status
    Indicate whether or not 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:
    Actions for system monitoring events
    For each event type 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.
    inherit
    The action definition is inherited from the analysis specification.
    Severities for monitoring events
    For each event type indicate how the predefined condition is to be handled. Specify:
    level
    The severity level that is to be associated with the designated condition. The severity levels are:
    N_a
    Exclude this condition from monitoring
    Inherit
    Severity level is inherited from the analysis specification
    Vls
    Very low severity
    Ls
    Low severity
    Lw
    Low warning
    Nm
    Normal warning
    Hw
    High warning
    Hs
    High severity
    Vhs
    Very high severity
  9. Provide the following monitoring information.
    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.

    Time data is kept after monitoring stops
    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.
    Sample intervals for resource types
    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:
    • 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
    • Resource types for which you created a monitor definition (such as connections or files)
    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.
  10. Provide the following Business Application Services (BAS) information.
    Install BAS resources option
    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.
    BAS install failure 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.
  11. Click Yes.

    The CICS system definition is added to the data repository and the CICS system definition tabular view is redisplayed.

Adding a CICS system to a CICS system group using the Web User Interface

Follow this procedure to add a CICS system definition to an existing CICS system group in the data repository.

  1. Click Topology administration views-->CICS system definitions to open the CICS system definition tabular view.

    This view displays a summary of any CICS systems already defined to the CICSPlex.

  2. Select one of the listed CICS system definitions and click Add to CICS system group.

    This opens a new panel.

  3. Specify the name of an existing CICS system group to which the CICS system is to be associated and click Yes.

    The CICS system is added to the specified CICS system group and the CICS system definition panel is redisplayed.

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.

Managing time period definitions using the Web User Interface

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.

Creating a time period definition

Follow this procedure to create a time period definition in the data repository.

  1. Click Administration views-->Topology administration views-->Time period definitions.

    This opens the Time period definition tabular view, which displays a summary any time period definitions already defined.

  2. If you want to use some of the information from an existing definition in the creation of your new definition, select an existing definition by selecting a check box in the Record column.
  3. Click the Create action button.

    This opens the Time period definition create panel.

  4. Provide the following information, as appropriate:
    Definition anme
    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).
  5. Click Yes.

    The new time period definition is added to the data repository and the Time period definition panel is redisplayed.

Time zone codes

Table 32 identifies the time zone codes that you can use in a time period definition. The codes represent the single-character Greenwich time zone codes and are based on the 24 standard international time zones. Each code indicates the time zone’s relationship to Greenwich Mean Time (GMT).

Time zone setting in a period definition

When a period definition is for time zone A, all events controlled by that period definition become active at the same clock time, based upon the start time specified in the period definition, and the time zone, time zone adjustment, and daylight saving indicator within the entity (CMAS or CICS system). Similarly, events become inactive at the same clock time, based upon the end time specified in the period definition, and the time zone, time zone adjustment, and daylight saving indicator within the entity (CMAS, or CICS system).

When a period definition is for a time zone other than time zone A, all events controlled by that period definition become active at exactly the same real time, regardless of the time zone in which the events are occurring. The activation time is based upon the period definition’s start time, time zone, and time zone adjustment. Similarly, events controlled by that period definition become inactive at the same real time, based upon the period definition’s ending time, time zone, and time zone adjustment. For both activation and deactivation, the time zone specified refers to the standard time for that time zone, regardless of whether daylight saving time is in effect.

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

Table 32. Timezone codes
Code GMT offset Description Code GMT offset Description
A n/a Current local time* N -12 (West of date line)
B +1 Central European time O -11 Bering standard time
C +2 Eastern Europe P -10 Hawaii and Alaska standard time
D +3 Arabia Q -9 Yukon standard time
E +4 Pakistan R -8 Pacific standard time
F +5 Bay of Bengal S -7 Mountain standard time
G +6 Thailand T -6 Central standard time
H +7 Philippines U -5 Eastern standard time
I +8 Australia V -4 Atlantic standard time
J +9 Japan W -3 Greenland
K +10 New Caledonia X -2 Azores
L +11 New Zealand Y -1 Iceland
M +12 (East of date line) Z 0 Greenwich mean time (GMT)
*Note:
Time zone A can be specified only in a period definition
End of change [[ Contents Previous Page | Next Page Index ]]