Working with MAS topology definitions using the end user interface

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

MAS

The MAS view shows information about CICS systems that are known to the CICSplex identified as the context.

Issue command:
MAS [cmas]

cmas
Is the specific or generic name of a CMAS involved in managing the CICSplex. If you omit this parameter, the view includes information about all CICS systems known to the CICSplex.

Select:
MAS from a menu of TOPOLOGY views.

Figure 65 is an example of the MAS view.

Figure 65. The MAS view
 27FEB2005  18:49:09 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
 >W1 =MAS===============EYUPLX01=EYUPLX01=27FEB2005==18:49:09=CPSM==========5===
 CMD Name     Type   CMAS     Status   MON RTA WLM Description
 --- -------- ------ -------- -------- Act Act Act -----------------------------
     EYUMAS1A LOCAL  EYUCMS1A ACTIVE   YES YES YES Starter Set TOR 1 on System A
     EYUMAS1B N/A             INACTIVE N/A N/A N/A Starter Set AOR 3 on System B
     EYUMAS2A LOCAL  EYUCMS1A INACTIVE YES YES NO  Starter Set AOR 1 on System A
     EYUMAS3A LOCAL  EYUCMS1A ACTIVE   YES YES NO  Starter Set AOR 2 on System A
     EYUMAS4A LOCAL  EYUCMS1A ACTIVE   YES YES NO  Starter Set FOR 1 on System A
 

Action commands

Table 43 shows the action commands you can issue from the MAS view when a CICS system is active.

Table 43. MAS view action commands
Primary command Line command Description
n/a BRO Browse the attributes of an active CICS system.

The format of the resulting panels is similar to that shown in the panels beginning in topic Updating an active MAS. None of the fields in these panels are modifiable.

n/a STO Stop MAS agent code within an active CICS system.

To restart the MAS agent code in a currently running CICS system, issue the CICS transaction:

    Start of change
  • COLM - for a local MAS
  • End of change
Note:
When the WLM Act 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. (You can use the WLMAWTOR view to determine which CICS systems are acting as either requesting regions or, for enterprise beans, routing regions.)

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 CICSRGND view to change the dynamic routing program.)

n/a UPD Temporarily change the attributes of an active CICS system, as described in Updating an active MAS.
Note:
These action commands are not valid when a CICS system is inactive, as indicated by the Status field.

Hyperlinks

None.

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.

After entering the update action command, the first of four panels is displayed.

  1. Figure 66 illustrates the first panel produced when you use the update action command. You can use this panel to change general MAS attributes.
    Figure 66. Updating an active CICS system - general MAS attributes
     --------------------------- Control MAS for EYUPLX01 --------------------------
     COMMAND  ===>
     
     MAS      EYUMAS1A  Description  Starter Set TOR 1 on System A
     
          Attributes                    Time
     Type            LOCAL        Time Zone        ===> R
     CMAS            EYUCMS1A     Time Zone Offset ===> 00
     Status          ACTIVE       Daylight Savings ===> NO
     
     
           Activity                   Security
     MON Active ===> YES          Command Check    ===> NO
     RTA Active ===> NO           Resource Check   ===> NO
     WLM Active ===> NO           Exemption Check  ===> NO
     
     
     Enter DOWN or UP to view other MAS screens.
     Press Enter to change the MAS.
     Type END or CANCEL to cancel without changing.
    Change the following information, as appropriate:
    Time Zone
    Identify the time zone in which this CICS system is located by specifying one of the following codes:
    Table 44. 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
    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.

    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.

    MON Active
    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.
    RTA Active
    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.
    WLM Active
    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.
    Command Check
    Specify YES or NO to indicate whether you want CICSPlex SM to simulate CICS command checking for this CICS system.
    Resource Check
    Specify YES or NO to indicate whether you want CICSPlex SM to simulate CICS resource checking for this CICS system.
    Exemption Check
    Specify YES or NO to indicate whether you want to bypass all simulated CICS security checking for this CICS system.

    To apply the changes to the active CICS system, press Enter. The changes take effect immediately and remain in effect until you change them or the CICS system stops.

  2. Figure 67 illustrates the panel produced the first time you issue the DOWN command. You can use this panel to change real-time analysis attributes.
    Figure 67. Updating an active CICS system - MAS real-time analysis attributes
    ----------------------- Control Analysis for EYUPLX01 -------------------------
    COMMAND ===>
     
    MAS      EYUMAS1A  RTA Active ===> NO   (YES, NO, SAM, MRM)
     
    Primary CMAS            CMAS1C2   CMAS Name or Generic
    Active Period           PRIME     Period Def or Generic
     
     System availability management:
     
                    Action or Generic   Severity
      SAM
      SOS         ===>                ===>
      SYSDUMP     ===>                ===>
      TRANDUMP    ===>                ===>
      MAXTASK     ===>                ===>
      STALL       ===>                ===>
     
    Type DOWN or UP to view other MAS screens.
    Press ENTER to change Analysis.
    Type END to cancel without changing.
     

    Change the following information about real-time analysis, as appropriate:

    RTA Active
    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.
    Action
    Supply a specific or generic name of an action definition to be used when generating notification about the designated condition.
    Severity
    Specify the severity level to be associated with the designated condition, or NO to exclude the condition from monitoring. The severity levels are:
    VHS
    Very high severe
    HS
    High severe
    HW
    High warn
    LW
    Low warn
    LS
    Low severe
    VLS
    Very low severe
    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. To apply the changes to the active CICS system, press Enter. The changes take effect immediately and remain in effect until you change them or the CICS system stops.
  3. Figure 68 illustrates the panel produced the second time you issue the DOWN command. You can use this panel to change resource monitoring attributes.
    Figure 68. Updating an active CICS system - MAS resource monitoring attributes
     ------------------------- Control Monitor for EYUPLX01 ------------------------
     COMMAND  ===>
     
     MAS      EYUMAS1A  MON Active ===> YES
     
     Retention period ===> 0
     
      Resource Sample Intervals:
       CICS Region      ===> 900           Connections      ===> 900
       Global           ===> 900           Files            ===> 900
       DB2              ===> 0             Journals         ===> 900
                                           Programs         ===> 900
                                           Terminals        ===> 900
                                           Transactions     ===> 900
                                           TD Queues        ===> 900
     
     
    Enter DOWN or UP to view other MAS screens.
    Press Enter to change Monitor.
    Type END or CANCEL to cancel without changing.
    Change the following information about resource monitoring, as appropriate:
    MON Active
    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.
    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.
    To apply the changes to the active CICS system, press Enter. The changes take effect immediately and remain in effect until you change them or the CICS system stops.
  4. Figure 69 illustrates the panel produced the third time you issue the DOWN command. You can use this panel to change MAS trace table settings. (If you issue DOWN again, the first panel in this series is redisplayed.)
    Figure 69. Updating an active CICS system - MAS trace attributes
     ------------------------ Control MAS trace for EUPLX01 ------------------------
     COMMAND  ===>
     
     MAS      EYUMAS1A  Description  Starter Set TOR 1 on System A
     
         Number                    1 1 1 1 1 1 1 1 1 1 2 2 2 2 2 2 2 2 2 2 3 3 3
                 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2
     Component   ---------------------------------------------------------------
     KNL         N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N
     TRC         N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N
     MSG         N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N
     SRV         N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N
     CHE         N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N
     QUE         N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N
     COM         N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N
     MAS         N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N
     WLM         N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N
     TOP         N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N
     RTA         N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N
     
     Enter DOWN or UP to view other MAS screens.
     Press Enter to change the MAS.
     Type END or CANCEL to cancel without changing.
    You can control the trace settings for each component comprising the specified MAS. To do this:
    Note:
    Component tracing is provided primarily for the use of IBM® service personnel. MAS component trace settings are normally not active. Activating tracing may have an adverse effect on performance.

    To apply the changes to the active CICS system, press Enter. The changes take effect immediately and remain in effect until you change them or the CICS system stops.

[[ Contents Previous Page | Next Page Index ]]