You can access a topology view by doing any of the following:
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.
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.
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.
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
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.
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. |
Field name | Value |
---|---|
Description | 1- to 30-character description of the CICS system group. |
Table 35 shows the hyperlink field on the CICSGRP view.
Hyperlink field | View displayed | Description |
---|---|---|
System Group | SYSGRPC | Identifies the members of the specified CICS system group. |
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.
----------------------- 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:
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.
Figure 50 illustrates the panel produced when you use the add (ADD) line action command from the CICSGRP view.
--------------------- 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:
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.
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.
------------------------- 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:
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.
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.
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
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.
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. |
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. |
Table 38 shows the hyperlink field on the CICSSYS view.
Hyperlink field | View displayed | Description |
---|---|---|
CICS System | SYSGRPC | Identifies the CICS system group to which the CICS system belongs. |
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.
--------------- 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.
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.)
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:
For an active system, data entered in this field takes effect when you press Enter.
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.
For an active system, data entered in this field takes effect when you press Enter.
For an active system, data entered in this field takes effect when you press Enter.
For an active system, data entered in this field takes effect when you press Enter.
For an active system, data entered in this field takes effect when you press Enter.
For an active system, data entered in this field takes effect when you press Enter.
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.
--------------- 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.
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.
The CICS system is assumed to be a routing region that is associated with an appropriate workload specification.
If the CICS system is not a routing region, or is not associated with a specification, no workload management occurs.
If the CICS system definition is complete, press Enter. If other attributes must be specified, issue the DOWN command.
--------------- 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.
If the CICS system is not a routing region, or is not associated with a specification, no workload management occurs.
For an active system, data entered in this field takes effect when you press Enter.
For an active system, data entered in this field takes effect when you press Enter.
Data not allowed with Inherit.
and the cursor is moved to the Action or Generic column.
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.
For an active system, data entered in this field takes effect when you press Enter.
Data not allowed with Inherit.
and the
cursor is moved to the Severity column.
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.
-------------- 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.
For this to occur, the CICS system must be associated with a monitor specification.
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.
The retention period can be:
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.
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.
Figure 58 illustrates the panel produced when you use the group (GRP) line action command from the CICSSYS view.
-------------------- 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:
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.
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.
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.
You can use either the CON action command or the GEN action command to create system link definitions from the CICSSYS view:
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:
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.
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:
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:
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.
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.
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
Provide the following information, as appropriate:
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:
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.
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:
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.
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
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.
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:
|
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. |
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:
|
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. |
There are no hyperlink fields in the PERIODEF view.
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.
----------------------- 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: