MASs known to CICSplex - MAS

The MASs known to CICSplex (MAS) views display information about MASs known to CICSplex.

Supplied views

To access from the main menu, click:

CICSPlex SM operations views > MASs known to CICSplex

Table 1. Views in the supplied **MASs known to CICSplex** (MAS) view set
View	Notes
MASs known to CICSplex EYUSTARTMAS.CPSMDUMP	Capture a CICSPlex SM diagnostic dump, including the MAS, the managing CMAS, and the ESSS (Environmental Services Subsystem) address spaces, and selected component data spaces.
MASs known to CICSplex EYUSTARTMAS.DETAIL1	Detailed real time analysis information about a selected MAS.
MASs known to CICSplex EYUSTARTMAS.DETAIL2	Detailed monitoring information about a selected MAS.
MASs known to CICSplex EYUSTARTMAS.DETAILED	Detailed general information about a selected MAS.
MASs known to CICSplex EYUSTARTMAS.FORCEDISCON	Terminates the ESSS connection of the MAS. Note: Abends may occur if ForceDiscon is issued against an active system. ForceDiscon should only be used if the system terminated as a CICS system but remained connected to the ESSS. ForceDiscon can only be issued if a previous StopUncon was issued and did not terminate the system from the ESSS.
MASs known to CICSplex EYUSTARTMAS.SET	Change the attributes of a selected MAS.
MASs known to CICSplex EYUSTARTMAS.STOP	Stops the MAS agent code within a CICS system. Note: If a MAS is acting as a routing region for workload management, and the DTR program is EYU9XLOP, you cannot stop the MAS agent code.
MASs known to CICSplex EYUSTARTMAS.STOPUNCON	Stops the MAS agent code within a CICS system. Note: If a MAS is acting as a routing region for workload management, and the DTR program is EYU9XLOP, StopUncon will stop the MAS agent code. This may lead to EYUO abends in the MAS if subsequent routes are attempted.
MASs known to CICSplex EYUSTARTMAS.TABULAR	Tabular information about all MASs associated with the CICSplex identified as the context.

Actions

Table 2. Actions available for MAS views
Action	Description
CPSMDUMP	Capture a CICSPlex SM diagnostic dump, including the MAS, the managing CMAS, and the ESSS (Environmental Services Subsystem) address spaces, and selected component data spaces.
FORCEDISCON	Terminates the ESSS connection of the MAS. Note: Abends may occur if ForceDiscon is issued against an active system. ForceDiscon should only be used if the system terminated as a CICS system but remained connected to the ESSS. ForceDiscon can only be issued if a previous StopUncon was issued and did not terminate the system from the ESSS.
SET	Change the attributes of a selected MAS.
STOP	Stops the MAS agent code within a CICS system. Note: If a MAS is acting as a routing region for workload management, and the DTR program is EYU9XLOP, you cannot stop the MAS agent code.
STOPUNCON	Stops the MAS agent code within a CICS system. Note: If a MAS is acting as a routing region for workload management, and the DTR program is EYU9XLOP, StopUncon will stop the MAS agent code. This may lead to EYUO abends in the MAS if subsequent routes are attempted.

Fields

Table 3. Fields in MAS views
Field	Attribute name	Description
Period definition name	ACTVTIME	The name of the period definition that identifies the hours during which this CICS system is to be running.
Autoinstall failure action	AINSFAIL	The name of the action definition to be used when generating notification about the named condition. Specify inherit to derive the action definition action from the analysis specification.
Autoinstall request type	AUTOINST	Indicates whether resources associated with the system through a resource description should be automatically installed when the MAS connects to the CMAS: 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).
Business Application Services (BAS) trace flags	BASTRACE	Business Application Services trace flag settings. Alter trace flag settings only when asked to by IBM System Support center personnel.
RS server bottom tier	BOTRSUPD	This attribute applies to CICSPlex SM sysplex optimized workloads. If the MAS is not at a sufficiently high enough release to support sysplex optimized workloads, then this value will contain zero, and will not be changeable to any other value. If the MAS is at high enough release for optimized workload support, then the following help explanation applies: 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, or INHERIT. A value of INHERIT means assign the value that is specified for this attribute in the parent CICSplex definition (CPLEXDEF) object for this CICS region. This is the default setting for this attribute. Values between 1 and 25 are applied as an arithmetic percentage to a region's MAXTASKS setting. The task count value from zero up to this value is deemed to be the task load bottom tier. If the task load in a region falls into this range, then it will be broadcast to the coupling facility for every change in the load. Once the load reaches this value, then the RS server update frequency task rules will be activated. The default value is 1%. You may change this value here to dynamically change the value assigned to the current CICS region. If you want the change to be applied to this CICS region after it has been restarted, then you must also change this value in the CICS system definition panel. You should only change this value after giving consideration to the impact that the change may have on your workload and coupling facility throughput.
Cache services trace flags	CHETRACE	The cache services trace flag settings. Alter trace flag settings only when asked to by IBM System Support center personnel.
CICS system name	CICSNAME	The name of a CICS system that is currently known to CICSPlex SM. Once a CICS system makes itself known to CICSPlex SM, it is considered a MAS.
Sample interval for CICS region monitoring	CICSSAMP	The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.
MAS status	CICSSTATE	The status of the MAS is either ACTIVE or INACTIVE. CICSPlex SM can only manage MASs that are active. ACTIVE The CICS system is active and connected to CICSPlex SM. INACTIVE The CICS system is inactive, or not connected to CICSPlex SM, or communication to the CMAS that manages the MAS is not active. A MAS can be inactive for one of two reasons: The Stop action was used to stop the MAS agent The CICS system itself is inactive, but is still known Other valid options are LOSTCONN, LOSTCMAS, and LOSTMAS. Note: If this field is blank, the MAS is temporarily between an inactive and active state.
CMAS name	CMASNAME	The name of a CMAS that participates in the management of the specified MAS.
Communications trace flags	COMTRACE	The communications trace flag settings. Alter trace flag settings only when asked to by IBM System Support center personnel.
Sample interval for connection monitoring	CONNSAMP	The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.
CPSM version of MAS	CPSMVER	The CICSPlex SM version of the current MAS.
Data repository services trace flags	DATTRACE	The data repository services trace flag settings. Alter trace flag settings only when asked to by IBM System Support center personnel.
Daylight saving time in effect	DAYLGHTSV	Indicates whether you are currently recognizing daylight saving time. Specify: YES - Recognize daylight saving time. NO - Do not recognize daylight saving time. INHERIT - 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. N_A - Not applicable.
Sample interval for DB2/DBCTRL monitoring	DBXSAMP	The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.
CICS system description	DESC	A description of the CICS system.
Sample interval for file monitoring	FILESAMP	The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.
Sample interval for global region monitoring	GLBLSAMP	The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.
Host Name	HOST	The 116-character host name of the system (for example, www.example.com), or its dotted decimal IP address (for example, 9.20.181.3). This is used for IPIC SYSLINK connections.
Sample interval for journal monitoring	JRNLSAMP	The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.
Kernel linkage trace flags	KNLTRACE	The kernel linkage trace flag settings. Alter trace flag settings only when asked to by IBM System Support center personnel.
MAS services trace flags	MASTRACE	The MAS services trace flag settings. Alter trace flag settings only when asked to by IBM System Support center personnel.
MAS type	MASTYPE	The type of relationship that exists between this MAS and the specified CMAS: LOCAL - The MAS resides in the same MVS image as the CMAS and uses the CICSPlex SM ESSS facility to communicate with it. REMOTE - The MAS is a stand-alone CICS region (SMSS). N_A - The MAS is not currently active; its type cannot be determined.
Monitoring status	MONSTATUS	Indicates whether resource monitoring is active in this MAS. The valid values are: YES Resource monitoring is active in this MAS. NO Resource monitoring is inactive in this MAS. If the MAS has just been initialized or has been updated to turn monitoring on, this value is displayed until monitoring is fully initialized. N_A The MAS is not connected to its CMAS (the MAS Status field shows INACTIVE). 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. Note: For Monitoring to become fully initialized the MAS must have a Monitoring Specification associated with it.
Message services trace flags	MSGTRACE	The message services trace flag settings. Alter trace flag settings only when asked to by IBM System Support center personnel.
Action for CICS-at-maximum-tasks event	MXTACTION	The name of the action definition to be used when generating notification about the named condition. Specify inherit to derive the action definition action from the analysis specification.
Severity for CICS-at-maximum-tasks event	MXTSEV	The severity level that is to be associated with the named condition. The severity codes are: VLS, LS, LW, HW, HS, or VHS. Specify N_A to exclude this condition from monitoring.
Network ID	NETWORKID	The network ID of the system. NETWORKID is used in combination with the APPLID option to ensure unique naming for connecting systems via IPIC. This is used for IPIC SYSLINK connections.
Action for Non-responsive-MAS event	NRMACTION	The name of the action definition to be used when generating notification about the named condition. Specify inherit to derive the action definition action from the analysis specification.
Severity for Non-responsive-MAS event	NRMSEV	The severity level that is to be associated with the named condition. The severity codes are: VLS, LS, LW, HW, HS, or VHS. Specify N_A to exclude this condition from monitoring.
Port number	PORT	A decimal number, in the range 1 through 65535, specifying the port number to be used for outbound requests on this IPIC connection. That is, the number of the port on which the remote system will be listening. This is used for IPIC SYSLINK connections.
Primary CMAS name	PRICMAS	The name of the CMAS that is assigned the task of monitoring the availability of this CICS system.
Sample interval for program monitoring	PROGSAMP	The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.
Queue services trace flags	QUETRACE	The queue services trace flag settings. Alter trace flag settings only when asked to by IBM System Support center personnel.
RS server read interval	READRS	This attribute applies to CICSPlex SM Sysplex Optimized Workloads. If the MAS is not at a sufficiently high enough release to support Sysplex Optimized Workloads, then this value will contain zero, and will not be changeable to any other value. If the MAS is at high enough release for Optimized Workload support, then the following help explanation applies: Within a workload running in optimized mode, this value specifies the minimum interval between region status refreshes that a routing region would request from the CICS CFDT server. This is the current value used by this CICS region. 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 this region on every occasion that it examines this region's status. Values between 1 and 2000 specify the minimum millisecond time interval that must expire before this region's status data can be refreshed. A low value mean that the router will refresh a target's status from the RS server more often 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 You may change this value here to dynamically change the value assigned to the current CICS region. If you want the change to be applied to this CICS region after it has been restarted, then you must also change this value in the CICS System definition panel.
Monitoring data retention period	RETENTION	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.
Real time analysis status	RTASTATUS	Indicates whether real time analysis (RTA) is active in this MAS. The valid values are: YES System availability monitoring and MAS resource monitoring are active. NO No RTA monitoring is active. If the MAS has just been initialized or has been updated to turn analysis on, NO is displayed until RTA is fully initialized. SAM System availability monitoring is active. MRM MAS resource monitoring is active. N_A The MAS is not connected to its CMAS (the MAS Status field shows INACTIVE). Note: For Real time analysis to become fully initialized the MAS must have a Real time analysis Specification associated with it.
Real time analysis (RTA) trace flags	RTATRACE	The real time analysis trace flag settings. Alter trace flag settings only when asked to by IBM System Support center personnel.
Action for system availability monitoring event	SAMACTION	The name of the action definition to be used when generating notification about the named condition. Specify inherit to derive the action definition action from the analysis specification.
Severity for system availability monitoring event	SAMSEV	The severity level that is to be associated with the named condition. The severity codes are: VLS, LS, LW, HW, HS, or VHS. Specify N_A to exclude this condition from monitoring.
Action for system dump event	SDMACTION	The name of the action definition to be used when generating notification about the named condition. Specify inherit to derive the action definition action from the analysis specification.
Severity for system dump event	SDMSEV	The severity level that is to be associated with the named condition. The severity codes are: VLS, LS, LW, HW, HS, or VHS. Specify N_A to exclude this condition from monitoring.
Simulated security exemption check	SECBYPASS	Indicates whether all simulated CICS security checking is to be bypassed for this CICS system: YES - Bypass all simulated CICS security checking for this CICS system. NO - Do not bypass simulated CICS security checking for this CICS system. INHERIT (asterisk) - Use the value assigned to the CICSplex with which this CICS system is associated. N_A - Not applicable.
Simulated security command check	SECCMDCHK	Indicates whether or not 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. INHERIT - Use the value assigned to the CICSplex with which this CICS system is associated. N_A - Not applicable.
Simulated security resource check	SECRESCHK	Indicates 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. INHERIT (asterisk) - Use the value assigned to the CICSplex with which this CICS system is associated.
Action for short on storage (SOS) event	SOSACTION	The name of the action definition to be used when generating notification about the named condition. Specify inherit to derive the action definition action from the analysis specification.
Severity for short on storage (SOS) event	SOSSEV	The severity level that is to be associated with the named condition. The severity codes are: VLS, LS, LW, HW, HS, or VHS. Specify N_A to exclude this condition from monitoring.
Common services trace flags	SRVTRACE	The external services trace flag settings. Alter trace flag settings only when asked to by IBM System Support center personnel.
Action for CICS-stalled event	STLACTION	The name of the action definition to be used when generating notification about the named condition. Specify inherit to derive the action definition action from the analysis specification.
Severity for CICS-stalled event	STLSEV	The severity level that is to be associated with the named condition. The severity codes are: VLS, LS, LW, HW, HS, or VHS. Specify N_A to exclude this condition from monitoring.
Action for transaction dump event	TDMACTION	The name of the action definition to be used when generating notification about the named condition. Specify inherit to derive the action definition action from the analysis specification.
Severity for transaction dump event	TDMSEV	The severity level that is to be associated with the named condition. The severity codes are: VLS, LS, LW, HW, HS, or VHS. Specify N_A to exclude this condition from monitoring.
Sample interval for TDQ monitoring	TDQSAMP	The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.
Sample interval for terminal monitoring	TERMSAMP	The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.
Time zone	TMEZONE	The time zone in which this CICS system is located. Specify: A code in the range B through Z. INHERIT - 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.
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. 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). INHERIT - 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	This attribute applies to CICSPlex SM sysplex optimized workloads. If the MAS is not at a sufficiently high enough release to support sysplex optimized workloads, then this value will contain zero, and will not be changeable to any other value. If the MAS is at high enough release for optimized workload support, then the following help explanation applies: 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, or INHERIT. A value of INHERIT means assign the value that is specified for this attribute in the parent CICSplex definition (CPLEXDEF) object for this CICS region. This is the default setting for this attribute. Values between 1 and 25 are 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 may change this value here to dynamically change the value assigned to the current CICS region. If you want the change to be applied to this CICS region after it has been restarted, then you must also change this value in the CICS system definition panel. You should only change this value after giving consideration to the impact that the change may have on your workload and coupling facility throughput.
Topology trace flags	TOPTRACE	The topology trace flag settings. Alter trace flag settings only when asked to by IBM System Support center personnel.
Sample interval for transaction monitoring	TRANSAMP	The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.
Trace services trace flags	TRATRACE	The trace services trace flag settings. Alter trace flag settings only when asked to by IBM System Support center personnel.
RS server update frequency	UPDATERS	This attribute applies to CICSPlex SM sysplex optimized workloads. If the MAS is not at a sufficiently high enough release to support sysplex optimized workloads, then this value will contain zero, and will not be changeable to any other value. If the MAS is at high enough release for optimized workload support, then the following help explanation applies: Within a workload running in optimized mode, this value specifies 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 is the current value used by this CICS region. 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 this CICS region. 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 you specify a value that 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. You may change this value here to dynamically change the value assigned to the current CICS region. If you want the change to be applied to this CICS region after it has been restarted, then you must also change this value in the CICS System definition panel.
WLM optimization enablement	WLMOPTEN	This attribute shows if optimized workload routing is enabled. When set to ENABLED, this region can utilize optimized workload management. If this attribute is set to DISABLED, then optimized workload management is suppressed. The value can be changed to dynamically alter the value assigned to the current CICS region. If this change is to be applied to this CICS region after it has been restarted, then you must also change this value in the CICS System definitions panel.
Task load queue mode	WLMQMODE	This attribute is used by CICSPlex SM Workload Manager and applies to target regions. This value specifies how the queued task load of a target CICS region is to be evaluated: MAXTASK - specifies that both active and MAXTASK queued tasks are to be included in the task load evaluation for the region. ALL - specifies that the task load evaluation for the region will include active tasks, tasks queued for the MAXTASK limit and tasks that are queued because of a TRANCLASS limit. The default value is ALL. If this value specifies N_A , then the current MAS is not at a high enough CICS release to support this function, and you will not be able to change it to any other value. You may change this value here to dynamically change the value assigned to the current CICS region. If you want the change to be applied to this CICS region after it has been restarted, then you must also change this value in the CICS System definition panel.
Workload manager status	WLMSTATUS	Indicates whether the workload manager (WLM) is active in this MAS. The valid values are: YES The workload manager (WLM) is active in this MAS. NO The workload manager (WLM) is inactive in this MAS. If the MAS has just been initialized or has been updated to turn workload management on, this value is displayed until WLM is fully initialized. N_A The MAS is not connected to its CMAS (the MAS Status field shows INACTIVE). Note: For the workload manager to become fully initialized the MAS must have a workload manager Specification associated with it.
Task load health threshold	WLMTHRSH	This attribute is used by CICSPlex SM Workload Manager. It specifies a percentage threshold of the current region's task load, which is calculated by dividing the current task count by the maximum task count. When the load for a target region reaches this threshold, then WLM considers the region to be relatively unhealthy. This will cause higher link weights to be applied to the WLM routing algorithm when evaluating this region. When a target scope covers local and remote regions relative to the router, then WLM will favour local targets over remote ones. The effect of this attribute is that when this load threshold in the local regions is achieved, then WLM will start to favour remote targets instead. When all targets in the scope achieve this load threshold, then WLM will revert to favouring local targets again. The value range is from 1 to 100, and the default value is 60. If this value specifies 0, then the current MAS is not at a high enough CICS release to support this function, and you will not be able to change it to any other value. Note: this value is nullified when applied to the routing factor of link neutral dynamic routing requests. This is because the link weight itself is ignored for the LNQUEUE and LNGOAL algorithms. You may change this value here to dynamically change the value assigned to the current CICS region. If you want the change to be applied to this CICS region after it has been restarted, then you must also change this value in the CICS System definition panel.
Workload management trace flags	WLMTRACE	The workload management trace flag settings. Alter trace flag settings only when asked to by IBM System Support center personnel.