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.
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.
- 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.
- 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
- Click the Create action button.
This opens the System group definition create panel.
- 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.
- 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.
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.
- 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.
- 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
- Click the Create button.
This opens the CICS system definition create panel. This is a large panel with attributes
divided into groups.
- 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:
See CICSPlex System Manager Managing Business Applications for information
on changing this value and the impacts on SYSLINKs.

- 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:
See CICSPlex System Manager Managing Business Applications for
information on changing this value and the impacts on SYSLINKs.

- 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.
- 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.
- 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.
- 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
- 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.
- 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:
- You can also control the automatic installation of specific resources
using the Auto Install field on a resource description.
- 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.
- 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.
- 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.
- Select one of the listed CICS system definitions and click Add to CICS system group.
This opens a new panel.
- 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.
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.
- 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.
- 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.
- Click the Create action button.
This opens the Time period definition create panel.
- 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).
- 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 |
[[ Contents Previous Page | Next Page Index ]]