CICSplexes managed by CMAS - CMASPLEX

The CICSplexes managed by CMAS (CMASPLEX) views display information about the CICSplexes being managed by the local CMAS.

Supplied views

To access from the main menu, click:

CICSPlex SM operations views > CICSplexes managed by CMAS

Table 1. Views in the supplied CICSplexes managed by CMAS (CMASPLEX) view set
View Notes
CICSplexes managed by CMAS

EYUSTARTCMASPLEX.DETAILED

Detailed information about a selected CICSplex being managed by the local CMAS.
CICSplexes managed by CMAS

EYUSTARTCMASPLEX.FORCEREMPLEX

Remove the CONTEXT CMAS from a CICSplex definition when the MPSTATE is NOTCONNECTED. Note that if a connection is established to the MP at a future date, and the MP is valid, then the MP will reinstall the CICSplex into the CONTEXT CMAS.

To remove the CONTEXT CMAS from a CICSplex definition when the MPSTATE is INVALID, use the CMASPLEX REMPLEX action.

To remove the CONTEXT CMAS from a CICSplex definition when the MPSTATE is VALID, set the CONTEXT to the MP CMAS and navigate to the CPLEXDEF or CPLXCMAS view. Perform the UNASSIGN action to remove the CMAS from the management of the CICSplex.

CICSplexes managed by CMAS

EYUSTARTCMASPLEX.REMPLEX

Remove the CONTEXT CMAS from a CICSplex definition when the MPSTATE is INVALID.

To remove the CONTEXT CMAS from a CICSplex definition when the MPSTATE is NOTCONNECTED, use the CMASPLEX FORCEREMPLEX action.

To remove the CONTEXT CMAS from a CICSplex definition when the MPSTATE is VALID, set the CONTEXT to the MP CMAS and navigate to the CPLEXDEF or CPLXCMAS view. Perform the UNASSIGN action to remove the CMAS from the management of the CICSplex.

CICSplexes managed by CMAS

EYUSTARTCMASPLEX.TABULAR

Tabular information about the CICSplexes being managed by the local CMAS.

Actions

Table 2. Actions available for CMASPLEX views
Action Description
FORCEREMPLEX Remove the CONTEXT CMAS from a CICSplex definition when the MPSTATE is NOTCONNECTED. Note that if a connection is established to the MP at a future date, and the MP is valid, then the MP will reinstall the CICSplex into the CONTEXT CMAS.

To remove the CONTEXT CMAS from a CICSplex definition when the MPSTATE is INVALID, use the CMASPLEX REMPLEX action.

To remove the CONTEXT CMAS from a CICSplex definition when the MPSTATE is VALID, set the CONTEXT to the MP CMAS and navigate to the CPLEXDEF or CPLXCMAS view. Perform the UNASSIGN action to remove the CMAS from the management of the CICSplex.

REMPLEX Remove the CONTEXT CMAS from a CICSplex definition when the MPSTATE is INVALID.

To remove the CONTEXT CMAS from a CICSplex definition when the MPSTATE is NOTCONNECTED, use the CMASPLEX FORCEREMPLEX action.

To remove the CONTEXT CMAS from a CICSplex definition when the MPSTATE is VALID, set the CONTEXT to the MP CMAS and navigate to the CPLEXDEF or CPLXCMAS view. Perform the UNASSIGN action to remove the CMAS from the management of the CICSplex.

Fields

Table 3. Fields in CMASPLEX views
Field Attribute name Description
RS server bottom tier BOTRSUPD For sysplex optimized workloads, this value is converted from a task load percentage to an actual task count. That count will be used to define the bottom tier task load range (from zero up to this value).

The value range is from 1 to 25. When a region's task load falls within this range, then the task load will be broadcast to the coupling facility for every change in the task load. Once the load reaches this value, then the RS server update frequency task rules will be activated.

The default value is 1%. You should only change this value after giving consideration to the impact that the change may have on your workload and coupling facility throughput.

The value shown here at the CICSplex level may be overridden at the CICS definition level to allow fine tuning of the value on an individual CICS region basis.

Daylight saving time in effect DAYLGHTSV Indicates whether or not the specified time zone is currently recognizing daylight saving time.
Maintenance point CMAS MPCMAS The name of the maintenance point CMAS.
State of MP CMAS MPSTATE The status of the maintenance point CMAS. This value can be:
  • VALID
    • The maintenance point CMAS is connected to the CONTEXT CMAS and has confirmed it is the maintenance point CMAS.
  • INVALID
    • The maintenance point CMAS is connected to the CONTEXT CMAS and has confirmed it is not the maintenance point CMAS.
  • NOTCONNECTED
    • The maintenance point CMAS is not connected to the CONTEXT CMAS, therefore it cannot be determined if the named MP CMAS is actually the MP CMAS.
CMAS is maintenance point MPSTATUS Indicates whether the local CMAS is the maintenance point for the specified CICSplex.
Performance interval duration PERFINTVL The sample interval determining the frequency with which CICSPlex SM collects performance-related data.
CICSplex PLEXNAME The name of a CICSplex that the local CMAS participates in managing.
RS server read interval READRS Within a workload running in optimized mode, this value specifies the minimum interval between refreshes of a target region status from a CICS CFDT server. These refresh requests will be issued by a routing region that is evaluating a target region for a dynamic routing request.

The value range is from 0 to 2000, and represents units of milliseconds:

  • A value of 0 means that a routing region will request a status update of a target region on every occasion that it examines that target region's status.
  • Values between 1 and 2000 specify the minimum time interval that must expire before the status of a target region can be refreshed.

    A low interval value means that the CFDT server will be polled more often for a status update, than for a higher value. For workloads in QUEUE mode, this will result in a task load more evenly balanced across the CICS regions in the workload target scope (assuming all other health and link factors are equal) . However, the utilization of the RS server will be correspondingly increased, which may consequently result in a higher utilization of your coupling facility.

A value of 1000 represents a one second interval. The default value is 200 milliseconds

The value specified here at the CICSplex level may be overridden at the CICS definition level to allow fine tuning of the value on an individual CICS region basis.

RS server pool name RSPOOLID For sysplex optimized workloads, region status data is maintained within a coupling facility data table. That table will be contained within a CFDT pool identified by this attribute. For an optimized workload to activate, there must be an active Region Status server which manages data for the pool name specified here.

If your CICSplex identifiers are not unique within your sysplex, you must ensure that the RS server pool names are unique. If your Sysplex comprises unique CICSplex identifiers, then they may all specify the same RS server pool name.

The default name is DFHRSTAT. You may choose to employ an existing CFDT pool for containing your CICSplex data tables. If you do, be aware that the throughput of your optimized workloads may be impeded by any user application activity to the specified pool name. Likewise, any application throughput to the pool may be impacted by sysplex optimized workloads. It is recommended that a discrete RS server and poolname is defined for the optimized workload function.

Time zone TMEZONE The time zone in which this CICS system is located. Options are:
  • A code in the range B through Z.
  • INHERIT - 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.
Time zone offset TMEZONEO 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. Options are:
  • 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).
  • INHERIT - 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
RS server top tier TOPRSUPD For sysplex optimized workloads, this value is converted from a task load percentage to an actual task count. That count will be subtracted from the MAXTASK value for the region to determine top tier task load range.

The value range is from 1 to 25. The value is applied as an arithmetic percentage to a region's MAXTASKS setting. The resultant task count value is subtracted from the region's MAXTASKS setting to establish a task load top tier. If the task load in a region runs up to its MAXTASKS limit, then the task load must drop back below this value before the MAXTASKS state for the region is switched off and broadcast to the coupling facility.

The default value is 5%. You should only change this value after giving consideration to the impact that the change may have on your workload and coupling facility throughput.

The value shown here at the CICSplex level may be overridden at the CICS definition level to allow fine tuning of the value on an individual CICS region basis.

RS server update frequency UPDATERS Within a workload running in optimized mode, this value indicates the frequency with which the CICS CFDT (RS) server will be called to modify the value of the task load within a target CICS region. This value will be the default frequency value for all CICS regions within the current CICSplex definition.

The value range is from 0 to 25:

  • A value of 0 means that the RS server is not notified of any task load count changes, which disables the optimized workload function for regions within the scope of this CICSplex.
  • Values between 1 and 25 are applied as an arithmetic percentage to a region's MAXTASKS setting. The resultant task count value is used as a numeric threshold to drive an update call to the RS server.

For example , with a MAXTASKS setting of 120, and with this attribute set to 20, the RS server will be called to update the WLM load count when the regions task count changes between:

  • 23 and 24 tasks - (20%),
  • 47 and 48 tasks - (40%),
  • 71 and 72 tasks - (60%),
  • 95 and 96 tasks - (80%).
  • 119 and 120 tasks - (100%).

The RS server would be updated when a regions task load increments or decrements across these boundaries.

If the value reported is at the lower end of the 1-25 scale, then that will cause an increase in the frequency of updates to the RS server across its task load range. For workloads in QUEUE mode, this will result in a task load more evenly balanced across the CICS regions in the workload target scope (assuming all other health and link factors are equal) . However, the utilization of the RS server will be correspondingly increased, which may consequently result in a higher utilization of your coupling facility.

The value shown here at the CICSplex level may be overridden at the CICS definition level to allow fine tuning of the value on an individual CICS region basis.



eyua7cmasplex.html | Timestamp icon Last updated: Sunday, 4 June 2017