Working with MAS topology definitions using the Web User Interface

This section describes how you can obtain information about active CICS® systems using the Runtime MAS display tabular WUI view.

Stopping an active MAS

To stop MAS agent code within an active CICS system:

  1. Click CICSPlex SM operations view-->Status of MASs known to CICSplex.

    This open the Runtime MAS display tabular view, which displays information about CICS systems that are known to the CICSplex identified as the context.

  2. Select one or more of the listed CICS systems.
  3. Click Stop and confirm the action by clicking Yes on the confirmation screen.
Note:
When the Workload manager status field for a CICS system contains YES, you may not be able to stop the MAS agent code. If the CICS system is acting as a requesting region, or, for enterprise beans, a routing region, with a dynamic routing program of EYU9XLOP, you cannot stop the MAS agent code. (To determine which CICS systems are acting as either requesting regions or, for enterprise beans, routing regions click Active workload views-->Target regions in an active workload.)

If you want to stop the MAS agent code in a CICS system of this type, you must first change the dynamic routing program to something other than EYU9XLOP. (You can use the CICS regions view to change the dynamic routing program.)

Updating an active MAS

Any changes that you make to a CICS system definition take effect immediately. They remain in effect as long as the CICS system is active or until you change them again.

Note:
If you turn on workload management, real-time analysis, or resource monitoring from these panels, their status will not be shown as active until the component is fully initialized.

Follow this procedure to update an active MAS:

  1. Click CICSPlex SM operations view-->Status of MASs known to CICSplex.

    This open the Runtime MAS display tabular view, which displays information about CICS systems that are known to the CICSplex identified as the context.

  2. Click on one of the listed CICS systems to open the Runtime MAS display detail view. This opens the first of three detail panels. The first panel allows you to change general attributes. From this panel you can open Real time analysis and Monitoring details views.
  3. On the first detail view, change the following information, as appropriate:
    Monitoring status
    Indicate whether resource monitoring is to be active. Specify:
    YES
    To start resource monitoring.

    For this to occur, the CICS system must be associated with a monitor specification. If it is not, no resource monitoring occurs.

    NO
    To stop resource monitoring. If real-time analysis requires resource monitoring to remain active, use the FORCE option.
    FORCE
    To stop resource monitoring even if it is being used by real-time analysis. All resource monitoring will stop. If an evaluation definition names a monitor table resource, that evaluation definition becomes inactive.
    Real time analysis status
    Indicate whether the system availability monitoring (SAM) and MAS resource monitoring (MRM) components of real-time analysis are to be active. Specify one of the following:
    YES
    To start system availability monitoring and MAS resource monitoring.
    NO
    To stop system availability monitoring and MAS resource monitoring.
    SAM
    To start system availability monitoring.
    MRM
    To start MAS resource monitoring.
    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 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 becomes active using the new analysis specification.
    Workload manager status
    Specify YES to start managing workloads for this CICS system. (You cannot stop workload management once it is started, so the only valid value is YES.)

    The CICS system is assumed to be a requesting region that is associated with the appropriate workload specification. If the CICS system is not a requesting region or is not associated with a workload specification, no workload management occurs.

    If workload management cannot be activated, messages are written to:

    • The window, when the CICS system is not associated with a workload specification or when the contents of the input panel cannot be successfully processed.
    • The console log, when any other condition occurs.
    Note:
    If you update the MON Active, RTA Active, or WLM Active fields to YES, the change will not be reflected on the MAS view until the component is fully initialized.
    Time Zone
    Identify the time zone in which this CICS system is located by specifying one of the following codes:
    Table 42. Timezone codes
    Code GMT offset Description Code GMT offset Description
    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
    J +8 Japan V -4 Atlantic standard time
    I +9 Australia W -3 Greenland
    K +10 New Caledonia X -2 Azores
    L +11 New Zealand Y -1 Iceland
    M +12 (West of date line) Z 0 Greenwich mean time (GMT)
    N -12 (East of date line)  
    Time zone offset
    Specify a number of minutes, between 0 and 59, that are to be added to the specified time zone. This adjustment is used to resolve time references in areas that do not use a standard zone.
    Daylight savings in effect
    Specify YES or NO to indicate whether the specified time zone is currently recognizing daylight saving time.

    This value must be changed twice a year; once when daylight saving time begins and again when it ends.

    Simulated security command check
    Specify YES or NO to indicate whether you want CICSPlex® SM to simulate CICS command checking for this CICS system.
    Simulated security resource Check
    Specify YES or NO to indicate whether you want CICSPlex SM to simulate CICS resource checking for this CICS system.
    Simulated security exemption Check
    Specify YES or NO to indicate whether you want to bypass all simulated CICS security checking for this CICS system.

    For more information about the Time Zone, Time Zone Offset, and Daylight Time attributes, see the description of CICSPlex SM time zone attributes in CICSPlex SM time zone attributes.

  4. If you want to update real time analysis attributes, click Real time analysis details. This opens a new details panel allowing you to change the following attributes:
    Real time analysis status
    Indicates whether the system availability monitoring (SAM) and MAS resource monitoring (MRM) components of real-time analysis are to be active. Specify one of the following:
    YES
    To start system availability monitoring and MAS resource monitoring.
    NO
    To stop system availability monitoring and MAS resource monitoring.
    SAM
    To start system availability monitoring.
    MRM
    To start MAS resource monitoring.
    Actions for system availability events
    For each event type, supply a specific or generic name of an action definition to be used when generating notification about the designated condition.
    Severities for system availability events
    For each event type, specify the severity level to be associated with the designated condition, or N_A to exclude the condition from monitoring. The severity levels are:
    VHS
    Very high severity
    HS
    High severity
    HW
    High warning
    LW
    Low warning
    LS
    Low severity
    VLS
    Very low severity
    Note:
    The default action and severity level for system availability monitoring (SAM) cannot be updated while the CICS system is active. The values shown in the SAM field are for reference only.
  5. If you want to update monitoring attributes, click Monitoring details. This opens a new details panel allowing you to change the following attributes:
    Monitoring status
    Indicates whether resource monitoring is to be active. Specify:
    YES
    To start resource monitoring.

    For this to occur, the CICS system must be associated with a monitor specification. If it is not, no resource monitoring occurs.

    NO
    To stop resource monitoring. If real-time analysis requires resource monitoring to remain active, use the FORCE option.
    FORCE
    To stop resource monitoring even if it is being used by real-time analysis. All resource monitoring will stop. If an evaluation definition names a monitor table resource, that evaluation definition becomes inactive.
    Monitoring 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 you use the UPD action command and this panel to stop it.) The value may be:
    • Between 1 and 1440, when collected data is to be retained
    • 0, when collected data is not to be retained
    Resource sample intervals
    Specify the duration, in seconds, between the collection of monitor data for each resource type. The value may be:
    • Between 1 and 86400 and 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.
      CAUTION:
      The lower you set the sample interval, the greater the impact on both CPU and teleprocessing overhead.
    • 0, when no monitoring is to occur for a resource type.
    • Omitted, when the CICS system is to use the value set with its associated monitor specification.
    Notes:
    1. If you change a sample interval from 0 to a value, use the MONACTV view command to find out whether the appropriate monitor definitions are active. If they are not, those monitor definitions must be installed for the change to take effect.
    2. The sample interval for a resource may be locked by RTA.
  6. To apply the changes you have made to the active CICS system, click Apply changes. The changes take effect immediately and remain in effect until you change them or the CICS system stops.
[[ Contents Previous Page | Next Page Index ]]