Start of change

Managing a CMAS configuration

This section describes how you can obtain information about:

In the Web User Interface you access this information by clicking CICSPlex SM operations views-->CMASs known to local CMAS This menu contains links to views allowing you to perform the tasks listed in Table 21.

Table 21. CMAS configuration tasks
Web User Interface view End-user interface view (and resource table) Task
CMASs known to local CMAS (EYUSTARTCMASLIST) CMAS
  • Display information about the CMASs known to the local CMAS.
  • Shut down a CMAS.
  • Purge in-storage external security manager (ESM) profiles.
  • Rebuild ESM profiles for a CMAS.
CICSplexes managed by CMAS (EYUSTARTCMASPLEX) CMASPLEX Display information about the CICSplexes being managed by the local CMAS
CMASs managing CICSplex (EYUSTARTCICSPLEX) CICSPLEX Display information about the CMASs associated with a CICSplex known to the local CMAS.
CMAS to CMAS links (EYUSTARTCMTCMLNK) CMTCMLNK
  • Display information about the links between the local CMAS and one or more other CMASs.
  • Discard an installed CMAS link.
CMAS to MAS links (EYUSTARTCMTPMLNK) CMTPMLNK
    Start of change
  • Display information about the physical connections between the local CMAS and the MASs to which it is linked.
  • End of change

Start of changeEnd-user interface CMAS configuration viewsEnd of change

CICSPLEX

The CICSPLEX view shows information about all CMASs associated with a CICSplex, whether or not the local CMAS is the maintenance point for the CICSplex.

Issue command:
CICSPLEX cicsplex

cicsplex
Is the name of a CICSplex that is known to the local CMAS.

Select:
CICSPLEX from a menu of CONFIG views, being sure to specify the required parameters.
Hyperlink from:
the CICSplex field on the CMASPLEX view.

Figure 37 is an example of the CICSPLEX view.

Figure 37. The CICSPLEX view
 27FEB2005  17:06:00 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =CICSPLEX==========EYUCMS1A=EYUCMS1A=27FEB2005==17:06:00=CPSM==========2===
 CMD CICSplex CMAS     Status   MP  Access   Transit  Transit
 --- -------- -------- -------- --- Type---- --CMAS-- -Count-
     EYUPLX01 EYUCMS1A ACTIVE   YES LOCAL                   0
     EYUPLX01 EYUCMS1B INACTIVE NO  N/A                     0
 
 

Action commands

None.

Hyperlinks

None.

CMAS

The CMAS view shows information about the CMASs known to the local CMAS.

Issue command:
CMAS [cmas]

cmas
Is the specific or generic name of a CMAS known to the local CMAS. If you omit this parameter, the view includes information about all CMASs known to the local CMAS.

Select:
CMAS from a menu of CONFIG views.

Figure 38 is an example of the CMAS view.

Figure 38. The CMAS view
 27FEB2005  14:46:30 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =CMAS==============EYUCMS1A=EYUCMS1A=27FEB2005==14:46:30=CPSM==========2===
 CMD Name     Status   Sysid Access   Transit  Transit
 --- -------- -------- ----- Type---- CMAS---- Count--
     EYUCMS1A ACTIVE   CM1A  LOCAL                   0
     EYUCMS1B ACTIVE   CM1B  ADJACENT                0
 

The local CMAS knows about other CMASs that are:

Adjacent
There is a CMAS-to-CMAS link between the local CMAS and the other CMAS.
Indirect
The local CMAS knows about a CMAS through direct links with intermediary, or transit, CMASs.

The information in the view identifies all CMASs known to the local CMAS since it started.

Action commands

Table 22 shows the action commands you can issue from the CMAS view.

Table 22. CMAS view action commands
Primary command Line command Description
PURge cmas PUR Purges any in-storage copies of security profiles that have been inherited from other CMASs.
SECurity cmas SEC Rebuilds the in-storage external security manager (ESM) profiles for a CMAS, provided they reside in local storage.
Note:
The SEC command cannot rebuild ESM profiles that reside in global storage. You must use the facilities provided by your ESM to refresh those profiles.
SHUtdown cmas SHU Shut down a CMAS normally.
TRAce cmas TRA Alter the level of CMAS component tracing that is to occur, as described in Tracing CMAS components.
Where::
cmas
Is the name of a CMAS.

Hyperlinks

Table 23 shows the hyperlink field on the CMAS view.

Table 23. CMAS view hyperlink field
Hyperlink field View displayed Description
Name CMASD Detailed information about the specified CMAS.

Tracing CMAS components

CMAS component tracing is provided for the use of IBM® service personnel. CMAS trace settings are normally not active. Activating tracing may have an adverse effect on performance.

Figure 39 illustrates the panel produced when you want to change trace settings. It identifies the current trace settings for each component comprising the specified CMAS. Tracing is active when the setting is Y; it is not active when the setting is N.

Figure 39. Tracing a CMAS
 --------------------- Component Trace Levels for EYUCMS01 ---------------------
 COMMAND  ===>
 
     Overstrike the level number with a Y or N to alter the trace level
 
     Level                     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
 DAT         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
 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
 MON         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
 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
 BAS         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
Press Enter to change Trace Flags.
Type END to cancel without changing.
 

To change a trace setting for a component, first move the cursor to the code for the appropriate component and then move the cursor to the right until you reach the appropriate level. Upon reaching the appropriate level, overtype the current setting with either a Y (to activate tracing) or N (to deactivate tracing).

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

CMASD

The CMASD view shows information about a CMAS known to the local CMAS.

Issue command:
CMASD cmas

cmas
Is the name of a CMAS known to the local CMAS.

Select:
CMASD from a menu of CONFIG views, being sure to specify the required parameters.
Hyperlink from:
the Name field on the CMAS view.

Figure 40 is an example of a CMASD view.

Figure 40. The CMASD view
 27FEB2005  14:46:44 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =CMASD=============EYUCMS1A=EYUCMS1A=27FEB2005==14:46:44=CPSM==============
     CMAS Name..... EYUCMS1A Start Date....  27FEB2005 EYUDREP State       OPEN
     JOB Name...... EYUJCM1A Start Time....   13:22:04 IRC Status...     CLOSED
     Applid........ EYUCMS1A Time Zone.....          Z VTAM ACB.....       OPEN
     Location......     EC2L Time Offset...          0 CAS Connect..     ACTIVE
     Sysid.........     CM1A Daylight Time.         NO CAS Id.......       EYUA
     Act Maxtasks..      100 Total CPU.....       24.2 System Trace.  SYSTEMOFF
     Maxtasks......      120 Total Page In.        158 User Trace...     USERON
     Current Tasks.       29 Total Page Out          0 GTF Trace....    GTFSTOP
     Peak Amaxtask.       12 Total Real Stg       4388 AUX Trace....   AUXSTART
     Total Tasks...       63 CPSM Version..        110 AUX Switch...   NOSWITCH
     Times at MAXT.        0 Free OSSB Cnt.         16 Max STCB.....          1
     SDUMP always         NO Used Free OSSB          0 NetView PPI..         NO
                             Getmain OSSB..          0 NMVTS Sent...          0
                                                       Res Stat Name     
     Pending Queues
     Connections...        0 Programs......          0 Trans. Data..          0
     Files.........        0 Terminals.....          0 System.......          0
     Journals......        0 Transactions..          0
 

Action commands

Table 24 shows the action commands you can issue from the CMASD view. The overtype fields are shown in Table 25.

Table 24. CMASD view action commands
Primary command Line command Description
PURge PUR Purges any in-storage copies of security profiles that have been inherited from other CMASs.
SECurity SEC Rebuilds the in-storage external security manager (ESM) profiles for a CMAS, provided they reside in local storage.
Note:
The SEC command cannot rebuild ESM profiles that reside in global storage. You must use the facilities provided by your ESM to refresh those profiles.
SHUtdown SHU Shuts down a CMAS normally.
n/a SET Changes a CMAS attribute according to the new value you specify in an overtype field (see Table 25).
Note:
The value you specified in the Require Set field on the CICSPlex System Manager entry panel determines whether or not you must use the SET command when you overtype a field.
TRAce TRA Alters the level of CMAS component tracing that is to occur, as described in topic Tracing CMAS components.
Table 25. CMASD view overtype fields
Field name Values
Act Maxtasks 60-999
Maxtasks 60-999
SDUMP Always YES | NO
Time Zone B-Z
Time Offset 0-59
Daylight Time YES | NO
IRC Status OPEN | CLOSED | IMMCLOSE
VTAM® ACB OPEN | CLOSED | IMMCLOSE | FORCECLOSE
System Trace SYSTEMON | SYSTEMOFF
User Trace USERON | USEROFF
GTF Trace GTFSTART | GTFSTOP
AUX Trace AUXSTART | AUXSTOP | AUXPAUSE | AUXSWITCH
AUX Switch SWITCHNEXT | SWITCHALL | NOSWITCH
NetView® PPI YES | NO

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

Hyperlinks

None.

CMASPLEX

The CMASPLEX view shows information about the CICSplexes being managed by the local CMAS.

Issue command:
CMASPLEX
Select:
CMASPLEX from a menu of CONFIG views.

Figure 41 is an example of a CMASPLEX view.

Figure 41. The CMASPLEX view
 27FEB2005  17:20:19 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =CMASPLEX==========EYUCMS1A=EYUCMS1A=27FEB2005==17:20:19=CPSM==========1===
 CMD CICSplex MP
 --- -------- ---
     EYUPLX01 YES
 
 

You can also use the CMASPLEX view to determine whether the local CMAS is the maintenance point (MP), for a CICSplex.

Action commands

None.

Hyperlinks

Table 26 shows the hyperlink field on the CMASPLEX view.

Table 26. CMASPLEX view hyperlink field
Hyperlink field View displayed Description
CICSPlex CICSPLEX Detailed information about all CMASs associated with the specified CICSplex.

CMTCMLND

The CMTCMLND view shows information about the link between a CMAS and the local CMAS.

The information provided by CMTCMLND view is primarily for the use of IBM service personnel; it includes diagnostic data that can be used to resolve communications-related problems.

Note:
Detailed information can be displayed about any CMAS linked to the local CMAS. However, the information is current only when the connection between the CMASs is active and available for use. (When the Status field on either this view or the CMTCMLNK view contains the value CONACT, the connection state is active.)
Issue command:
CMTCMLND cmas

cmas
Is the name of a CMAS linked to the local CMAS.

Select:
CMTCMLND from a menu of CONFIG views, being sure to specify the required parameters.
Hyperlink from:
the Target CMAS field of the CMTCMLNK view.

Figure 42 is an example of the CMTCMLND view.

Figure 42. The CMTCMLND view
 27FEB2005  18:07:28 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =CMTCMLNK=CMTCMLND=EYUCMS1A=EYUCMS1A=27FEB2005==18:07:13=CPSM==========1===
     Target CMAS.  EYUCMS1B
     Sysid.......      CM1B Msgs Sent......          0 Msgs Recv....          0
     Type........      LU62 Packets Sent...          0 Packets Recv.          0
     Applid......  EYUCMS1B Transit Sent...          0 Transit Recv.          0
     Status......     RESET Bytes Xmit.....          0 Bytes Recv...          0
     Conn Status.  ACQUIRED Bytes Output...          0 Bytes Input..          0
     Serv Status. INSERVICE Schedule Time..    0:00:00 Execute Time.    0:00:00
                            Transmit Time..    0:00:00 Receive Time.    0:00:00
 
 

Action commands

Table 27 shows the action command you can issue from the CMTCMLND view.

Table 27. CMTCMLND view action commands
Primary command Line command Description
DiSCard DSC Discard a CMAS link.

When you discard a link between the local CMAS and another CMAS, the local CMAS is prevented from communicating with the other CMAS for as long as the local CMAS is running. (The link definition is not removed from the data repository.) You can reactivate a link by restarting the CMAS.

Hyperlinks

None.

CMTCMLNK

The CMTCMLNK view shows information about the links that exist between the local CMAS and one or more other CMASs.

Issue command:
CMTCMLNK [cmas]

cmas
Is the specific or generic name of a CMAS linked to the local CMAS. If you omit this parameter, the view includes information about all CMASs defined to the local CMAS.

Select:
CMTCMLNK from a menu of CONFIG views.

Figure 43 is an example of the CMTCMLNK view.

Figure 43. The CMTCMLNK view
 27FEB2005  18:07:15 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =CMTCMLNK==========EYUCMS1A=EYUCMS1A=27FEB2005==18:07:13=CPSM==========1===
 CMD Target   Sys  Type Applid   Status   Messages   Messages
 --- CMAS---  ID-- ---- -------- -------- Sent------ Received--
     EYUCMS1B CM1B LU62 EYUCMS1B RESET             0          0
 
 

Action commands

Table 28 shows the action command you can issue from the CMTCMLNK view.

Table 28. CMTCMLNK view action commands
Primary command Line command Description
DiSCard cmas DSC Discard a CMAS link.
Where::
cmas
Is the name of a CMAS linked to the local CMAS.

When you discard a link between the local CMAS and another CMAS, the local CMAS is prevented from communicating with the other CMAS for as long as the local CMAS is running. (The link definition is not removed from the data repository.) You can reactivate a link by restarting the CMAS.

Hyperlinks

Table 29 shows the hyperlink field on the CMTCMLNK view.

Table 29. CMTCMLNK view hyperlink field
Hyperlink field View displayed Description
Target CMAS CMTCMLND Detailed information about the link that exists between the specified CMAS and the local CMAS.

CMTPMLND

Start of changeThe CMTPMLND view shows information about the physical connection that exists between the local CMAS and a specific local MAS.End of change

The information provided by the CMTPMLND view is primarily for the use of IBM service personnel; it includes diagnostic data that can be used to resolve communications-related problems.

Note:
Detailed information can be displayed about any MAS linked to the local CMAS. However, the information is current only when the connection between a MAS and its local CMAS is active and available for use. (When the Status field on either this view or the CMTPMLNK view contains the value CONACT, the connection state is active.)
Issue command:
CMTPMLND mas

mas
Is the name of a MAS linked to the local CMAS.

Select:
CMTPMLND from a menu of CONFIG views, being sure to specify the required parameters.
Hyperlink from:
the MAS field of the CMTPMLNK view.

Figure 44 is an example of a CMTPMLND view.

Figure 44. The CMTPMLND view
 27FEB2005  09:11:24 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =CMTPMLNK=CMTPMLND=EYUCMS1B=EYUCMS1B=27FEB2005==09:11:12=CPSM==========1===
     Target MAS..  EYUMAS1C                          0
     CICSplex....           Msgs Sent......          0 Msgs Recv....          0
     Sysid.......      MS1C Packets Sent...          0 Packets Recv.          0
     Type........      LU62 Transit Sent...          0 Transit Recv.          0
     Applid......  EYUMAS1C Bytes Xmit.....          0 Bytes Recv...          0
     Status......     RESET Bytes Output...          0 Bytes Input..          0
     Conn Status.       N/A Schedule Time..    0:00:00 Execute Time.    0:00:00
     Serv Status.       N/A Transmit Time..    0:00:00 Receive Time.    0:00:00
 

Start of changeAction commandsEnd of change

Start of changeEnd of change

Hyperlinks

None.

CMTPMLNK

Start of changeThe CMTPMLNK view shows information about the physical connections that exist between the local CMAS and the local MASs to which it is linked. End of change

Issue command:
CMTPMLNK [mas]

mas
Is the specific or generic name of a MAS linked to the local CMAS. If you omit this parameter, the view includes information about all MASs defined to the local CMAS.

Select:
CMTPMLNK from a menu of CONFIG views.

Figure 45 is an example of the CMTPMLNK view.

Figure 45. The CMTPMLNK view
 27FEB2005  18:08:43 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =CMTPMLNK==========EYUCMS1B=EYUCMS1B=27FEB2005==18:08:43=CPSM==========2===
 CMD Target   Sys  Type Applid   Status   CICSplex Messages   Messages
 --- MAS---   ID-- ---- -------- -------- -------- Sent------ Received--
     EYUMAS1B MS1B ESSS EYUMAS1B CONACT   EYUPLX01       6567         11
     EYUMAS1C MS1C LU62 EYUMAS1C CONACT   EYUPLX02         55        517
 

Action commands

Hyperlinks

Table 30 shows the hyperlink field on the CMTPMLNK view.

Table 30. CMTPMLNK view hyperlink field
Hyperlink field View displayed Description
MAS CMTPMLND Detailed information about the link that exists between the specified MAS and its CMAS.
End of change [[ Contents Previous Page | Next Page Index ]]