com.ibm.cics.model
Interface IManagedRegion

All Superinterfaces:
ICICSObject, ICPSMManager, com.ibm.cics.model.meta.ITypedObject

public interface IManagedRegion
extends ICPSMManager

generated from CICS resourcetable MAS


Nested Class Summary
static class IManagedRegion.AinsfailValue
          Enumeration type for field AINSFAIL
static class IManagedRegion.AutoinstValue
          Enumeration type for field AUTOINST
static class IManagedRegion.DaylightSavingValue
          Enumeration type for field DAYLGHTSV
static class IManagedRegion.MonitoringStatusValue
          Enumeration type for field MONSTATUS
static class IManagedRegion.MxtsevValue
          Enumeration type for field MXTSEV
static class IManagedRegion.NrmsevValue
          Enumeration type for field NRMSEV
static class IManagedRegion.RTAStatusValue
          Enumeration type for field RTASTATUS
static class IManagedRegion.SamsevValue
          Enumeration type for field SAMSEV
static class IManagedRegion.SdmsevValue
          Enumeration type for field SDMSEV
static class IManagedRegion.SecbypassValue
          Enumeration type for field SECBYPASS
static class IManagedRegion.SeccmdchkValue
          Enumeration type for field SECCMDCHK
static class IManagedRegion.SecreschkValue
          Enumeration type for field SECRESCHK
static class IManagedRegion.SossevValue
          Enumeration type for field SOSSEV
static class IManagedRegion.StateValue
          Enumeration type for field CICSSTATE
static class IManagedRegion.StlsevValue
          Enumeration type for field STLSEV
static class IManagedRegion.TdmsevValue
          Enumeration type for field TDMSEV
static class IManagedRegion.TypeValue
          Enumeration type for field MASTYPE
static class IManagedRegion.WlmoptenValue
          Enumeration type for field WLMOPTEN
static class IManagedRegion.WlmqmodeValue
          Enumeration type for field WLMQMODE
static class IManagedRegion.WLMStatusValue
          Enumeration type for field WLMSTATUS
 
Field Summary
 
Fields inherited from interface com.ibm.cics.model.ICPSMManager
COPYRIGHT
 
Method Summary
<From extends ICICSObject>
ICICSObjectListFactory<From>
findReferences(IReferenceAttribute<From,IManagedRegion> referenceAttribute)
          Returns an ICICSObjectListFactory that can be used to retrieve all objects that reference this ICICSObject by the supplied IReferenceAttribute.
 java.lang.String getActvtime()
          Getter for field ACTVTIME
 IManagedRegion.AinsfailValue getAinsfail()
          Getter for field AINSFAIL
 IManagedRegion.AutoinstValue getAutoinst()
          Getter for field AUTOINST
 java.lang.String getBastrace()
          Getter for field BASTRACE
 java.lang.Long getBotrsupd()
          Getter for field BOTRSUPD
 java.lang.String getChetrace()
          Getter for field CHETRACE
 IManagedRegionReference getCICSObjectReference()
           
 ICICSRegionDefinitionReference getCicsRegionDefinitionReference()
           
 java.lang.String getCMASName()
          Getter for field CMASNAME
 java.lang.String getComtrace()
          Getter for field COMTRACE
 java.lang.Long getConnectionSampleInterval()
          Getter for field CONNSAMP
 java.lang.String getCpsmver()
          Getter for field CPSMVER
 java.lang.String getDattrace()
          Getter for field DATTRACE
 IManagedRegion.DaylightSavingValue getDaylightSaving()
          Getter for field DAYLGHTSV
 java.lang.Long getDB2SampleInterval()
          Getter for field DBXSAMP
 java.lang.String getDescription()
          Getter for field DESC
 java.lang.Long getFileSampleInterval()
          Getter for field FILESAMP
 java.lang.Long getGlobalSampleInterval()
          Getter for field GLBLSAMP
 java.lang.String getHost()
          Getter for field HOST
 java.lang.Long getJournalSampleInterval()
          Getter for field JRNLSAMP
 java.lang.String getKernelTrace()
          Getter for field KNLTRACE
 java.lang.String getMASTrace()
          Getter for field MASTRACE
 java.lang.String getMessageTrace()
          Getter for field MSGTRACE
 IManagedRegion.MonitoringStatusValue getMonitoringStatus()
          Getter for field MONSTATUS
 java.lang.String getMxtaction()
          Getter for field MXTACTION
 IManagedRegion.MxtsevValue getMxtsev()
          Getter for field MXTSEV
 java.lang.String getName()
          Getter for field CICSNAME
 java.lang.String getNetworkid()
          Getter for field NETWORKID
 java.lang.String getNrmaction()
          Getter for field NRMACTION
 IManagedRegion.NrmsevValue getNrmsev()
          Getter for field NRMSEV
 ICICSType<IManagedRegion> getObjectType()
           
 java.lang.Long getPort()
          Getter for field PORT
 java.lang.String getPrimaryCMAS()
          Getter for field PRICMAS
 java.lang.Long getProgramSampleInterval()
          Getter for field PROGSAMP
 java.lang.String getQuetrace()
          Getter for field QUETRACE
 java.lang.Long getReadrs()
          Getter for field READRS
 java.lang.Long getRetention()
          Getter for field RETENTION
 IManagedRegion.RTAStatusValue getRTAStatus()
          Getter for field RTASTATUS
 java.lang.String getRtatrace()
          Getter for field RTATRACE
 java.lang.String getSamaction()
          Getter for field SAMACTION
 java.lang.Long getSampleInterval()
          Getter for field CICSSAMP
 IManagedRegion.SamsevValue getSamsev()
          Getter for field SAMSEV
 java.lang.String getSdmaction()
          Getter for field SDMACTION
 IManagedRegion.SdmsevValue getSdmsev()
          Getter for field SDMSEV
 IManagedRegion.SecbypassValue getSecbypass()
          Getter for field SECBYPASS
 IManagedRegion.SeccmdchkValue getSeccmdchk()
          Getter for field SECCMDCHK
 IManagedRegion.SecreschkValue getSecreschk()
          Getter for field SECRESCHK
 java.lang.String getServicesTrace()
          Getter for field SRVTRACE
 java.lang.String getSosaction()
          Getter for field SOSACTION
 IManagedRegion.SossevValue getSossev()
          Getter for field SOSSEV
 IManagedRegion.StateValue getState()
          Getter for field CICSSTATE
 java.lang.String getStlaction()
          Getter for field STLACTION
 IManagedRegion.StlsevValue getStlsev()
          Getter for field STLSEV
 java.lang.String getTdmaction()
          Getter for field TDMACTION
 IManagedRegion.TdmsevValue getTdmsev()
          Getter for field TDMSEV
 java.lang.Long getTDQSampleInterval()
          Getter for field TDQSAMP
 java.lang.Long getTerminalSampleInterval()
          Getter for field TERMSAMP
 java.lang.String getTimeZone()
          Getter for field TMEZONE
 java.lang.Long getTimeZoneOffset()
          Getter for field TMEZONEO
 java.lang.Long getToprsupd()
          Getter for field TOPRSUPD
 java.lang.String getToptrace()
          Getter for field TOPTRACE
 java.lang.Long getTransactionSampleInterval()
          Getter for field TRANSAMP
 java.lang.String getTratrace()
          Getter for field TRATRACE
 IManagedRegion.TypeValue getType()
          Getter for field MASTYPE
 java.lang.Long getUpdaters()
          Getter for field UPDATERS
 IManagedRegion.WlmoptenValue getWlmopten()
          Getter for field WLMOPTEN
 IManagedRegion.WlmqmodeValue getWlmqmode()
          Getter for field WLMQMODE
 IManagedRegion.WLMStatusValue getWLMStatus()
          Getter for field WLMSTATUS
 java.lang.Long getWlmthrsh()
          Getter for field WLMTHRSH
 java.lang.String getWLMTrace()
          Getter for field WLMTRACE
 
Methods inherited from interface com.ibm.cics.model.ICICSObject
getCICSType
 
Methods inherited from interface com.ibm.cics.model.meta.ITypedObject
getAttributeValue
 

Method Detail

getObjectType

ICICSType<IManagedRegion> getObjectType()
Specified by:
getObjectType in interface ICICSObject
Specified by:
getObjectType in interface ICPSMManager
Specified by:
getObjectType in interface com.ibm.cics.model.meta.ITypedObject

getName

java.lang.String getName()
Getter for field CICSNAME

CICS system name

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.

Specified by:
getName in interface ICICSObject

getCMASName

java.lang.String getCMASName()
Getter for field CMASNAME

CMAS name

The name of a CMAS that participates in the management of the specified MAS.


getType

IManagedRegion.TypeValue getType()
Getter for field MASTYPE

MAS type

The type of relationship that exists between this MAS and the specified CMAS:


getState

IManagedRegion.StateValue getState()
Getter for field CICSSTATE

MAS status

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:

Other valid options are LOSTCONN, LOSTCMAS, and LOSTMAS. Note:

If this field is blank, the MAS is temporarily between an inactive and active state.


getMonitoringStatus

IManagedRegion.MonitoringStatusValue getMonitoringStatus()
Getter for field MONSTATUS

Monitoring status

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.


getRTAStatus

IManagedRegion.RTAStatusValue getRTAStatus()
Getter for field RTASTATUS

Real time analysis status

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.


getWLMStatus

IManagedRegion.WLMStatusValue getWLMStatus()
Getter for field WLMSTATUS

Workload manager status

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.


getRetention

java.lang.Long getRetention()
Getter for field RETENTION

Monitoring data retention period

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.


getSampleInterval

java.lang.Long getSampleInterval()
Getter for field CICSSAMP

Sample interval for CICS region monitoring

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.


getGlobalSampleInterval

java.lang.Long getGlobalSampleInterval()
Getter for field GLBLSAMP

Sample interval for global region monitoring

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.


getDB2SampleInterval

java.lang.Long getDB2SampleInterval()
Getter for field DBXSAMP

Sample interval for DB2/DBCTRL monitoring

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.


getConnectionSampleInterval

java.lang.Long getConnectionSampleInterval()
Getter for field CONNSAMP

Sample interval for connection monitoring

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.


getFileSampleInterval

java.lang.Long getFileSampleInterval()
Getter for field FILESAMP

Sample interval for file monitoring

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.


getJournalSampleInterval

java.lang.Long getJournalSampleInterval()
Getter for field JRNLSAMP

Sample interval for journal monitoring

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.


getProgramSampleInterval

java.lang.Long getProgramSampleInterval()
Getter for field PROGSAMP

Sample interval for program monitoring

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.


getTerminalSampleInterval

java.lang.Long getTerminalSampleInterval()
Getter for field TERMSAMP

Sample interval for terminal monitoring

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.


getTDQSampleInterval

java.lang.Long getTDQSampleInterval()
Getter for field TDQSAMP

Sample interval for TDQ monitoring

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.


getTransactionSampleInterval

java.lang.Long getTransactionSampleInterval()
Getter for field TRANSAMP

Sample interval for transaction monitoring

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.


getKernelTrace

java.lang.String getKernelTrace()
Getter for field KNLTRACE

Kernel linkage trace flags

The kernel linkage trace flag settings.

Alter trace flag settings only when asked to by IBM System Support center personnel.


getTratrace

java.lang.String getTratrace()
Getter for field TRATRACE

Trace services trace flags

The trace services trace flag settings.

Alter trace flag settings only when asked to by IBM System Support center personnel.


getMessageTrace

java.lang.String getMessageTrace()
Getter for field MSGTRACE

Message services trace flags

The message services trace flag settings.

Alter trace flag settings only when asked to by IBM System Support center personnel.


getServicesTrace

java.lang.String getServicesTrace()
Getter for field SRVTRACE

Common services trace flags

The external services trace flag settings.

Alter trace flag settings only when asked to by IBM System Support center personnel.


getChetrace

java.lang.String getChetrace()
Getter for field CHETRACE

Cache services trace flags

The cache services trace flag settings.

Alter trace flag settings only when asked to by IBM System Support center personnel.


getQuetrace

java.lang.String getQuetrace()
Getter for field QUETRACE

Queue services trace flags

The queue services trace flag settings.

Alter trace flag settings only when asked to by IBM System Support center personnel.


getComtrace

java.lang.String getComtrace()
Getter for field COMTRACE

Communications trace flags

The communications trace flag settings.

Alter trace flag settings only when asked to by IBM System Support center personnel.


getMASTrace

java.lang.String getMASTrace()
Getter for field MASTRACE

MAS services trace flags

The MAS services trace flag settings.

Alter trace flag settings only when asked to by IBM System Support center personnel.


getWLMTrace

java.lang.String getWLMTrace()
Getter for field WLMTRACE

Workload management trace flags

The workload management trace flag settings.

Alter trace flag settings only when asked to by IBM System Support center personnel.


getToptrace

java.lang.String getToptrace()
Getter for field TOPTRACE

Topology trace flags

The topology trace flag settings.

Alter trace flag settings only when asked to by IBM System Support center personnel.


getRtatrace

java.lang.String getRtatrace()
Getter for field RTATRACE

Real time analysis (RTA) trace flags

The real time analysis trace flag settings.

Alter trace flag settings only when asked to by IBM System Support center personnel.


getDattrace

java.lang.String getDattrace()
Getter for field DATTRACE

Data repository services trace flags

The data repository services trace flag settings.

Alter trace flag settings only when asked to by IBM System Support center personnel.


getBastrace

java.lang.String getBastrace()
Getter for field BASTRACE

Business Application Services (BAS) trace flags

Business Application Services trace flag settings.

Alter trace flag settings only when asked to by IBM System Support center personnel.


getSeccmdchk

IManagedRegion.SeccmdchkValue getSeccmdchk()
Getter for field SECCMDCHK

Simulated security command check

Indicates whether or not CICSPlex SM security checking is to simulate CICS command checking for this CICS system. Specify:


getSecreschk

IManagedRegion.SecreschkValue getSecreschk()
Getter for field SECRESCHK

Simulated security resource check

Indicates whether CICSPlex SM security checking is to simulate CICS command checking for this CICS system. Specify:


getSecbypass

IManagedRegion.SecbypassValue getSecbypass()
Getter for field SECBYPASS

Simulated security exemption check

Indicates whether all simulated CICS security checking is to be bypassed for this CICS system:


getSamsev

IManagedRegion.SamsevValue getSamsev()
Getter for field SAMSEV

Severity for system availability monitoring event

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.


getSossev

IManagedRegion.SossevValue getSossev()
Getter for field SOSSEV

Severity for short on storage (SOS) event

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.


getSdmsev

IManagedRegion.SdmsevValue getSdmsev()
Getter for field SDMSEV

Severity for system dump event

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.


getTdmsev

IManagedRegion.TdmsevValue getTdmsev()
Getter for field TDMSEV

Severity for transaction dump event

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.


getMxtsev

IManagedRegion.MxtsevValue getMxtsev()
Getter for field MXTSEV

Severity for CICS-at-maximum-tasks event

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.


getStlsev

IManagedRegion.StlsevValue getStlsev()
Getter for field STLSEV

Severity for CICS-stalled event

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.


getSamaction

java.lang.String getSamaction()
Getter for field SAMACTION

Action for system availability monitoring event

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.


getSosaction

java.lang.String getSosaction()
Getter for field SOSACTION

Action for short on storage (SOS) event

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.


getSdmaction

java.lang.String getSdmaction()
Getter for field SDMACTION

Action for system dump event

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.


getTdmaction

java.lang.String getTdmaction()
Getter for field TDMACTION

Action for transaction dump event

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.


getMxtaction

java.lang.String getMxtaction()
Getter for field MXTACTION

Action for CICS-at-maximum-tasks event

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.


getStlaction

java.lang.String getStlaction()
Getter for field STLACTION

Action for CICS-stalled event

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.


getPrimaryCMAS

java.lang.String getPrimaryCMAS()
Getter for field PRICMAS

Primary CMAS name

The name of the CMAS that is assigned the task of monitoring the availability of this CICS system.


getActvtime

java.lang.String getActvtime()
Getter for field ACTVTIME

Period definition name

The name of the period definition that identifies the hours during which this CICS system is to be running.


getDescription

java.lang.String getDescription()
Getter for field DESC

CICS system description

A description of the CICS system.


getTimeZoneOffset

java.lang.Long getTimeZoneOffset()
Getter for field TMEZONEO

Time zone offset

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:


getTimeZone

java.lang.String getTimeZone()
Getter for field TMEZONE

Time zone

The time zone in which this CICS system is located. Specify:

Note: If you specify * (asterisk) for any one of the time fields, you must specify asterisk for all three time fields.


getDaylightSaving

IManagedRegion.DaylightSavingValue getDaylightSaving()
Getter for field DAYLGHTSV

Daylight saving time in effect

Indicates whether you are currently recognizing daylight saving time. Specify:


getAutoinst

IManagedRegion.AutoinstValue getAutoinst()
Getter for field AUTOINST

Autoinstall request type

Indicates whether resources associated with the system through a resource description should be automatically installed when the MAS connects to the CMAS:


getAinsfail

IManagedRegion.AinsfailValue getAinsfail()
Getter for field AINSFAIL

Autoinstall failure action

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.


getHost

java.lang.String getHost()
Getter for field HOST

Host Name

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.


getNetworkid

java.lang.String getNetworkid()
Getter for field NETWORKID

Network ID

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.


getPort

java.lang.Long getPort()
Getter for field PORT

Port number

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.


getReadrs

java.lang.Long getReadrs()
Getter for field READRS

RS server read interval

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 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.


getUpdaters

java.lang.Long getUpdaters()
Getter for field UPDATERS

RS server update frequency

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:

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:

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.


getToprsupd

java.lang.Long getToprsupd()
Getter for field TOPRSUPD

RS server top tier

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.

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.


getBotrsupd

java.lang.Long getBotrsupd()
Getter for field BOTRSUPD

RS server bottom tier

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.

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.


getWlmthrsh

java.lang.Long getWlmthrsh()
Getter for field WLMTHRSH

Task load health threshold

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.


getWlmqmode

IManagedRegion.WlmqmodeValue getWlmqmode()
Getter for field WLMQMODE

Task load queue mode

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:

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.


getWlmopten

IManagedRegion.WlmoptenValue getWlmopten()
Getter for field WLMOPTEN

WLM optimization enablement

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.


getNrmsev

IManagedRegion.NrmsevValue getNrmsev()
Getter for field NRMSEV

Severity for Non-responsive-MAS event

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.


getNrmaction

java.lang.String getNrmaction()
Getter for field NRMACTION

Action for Non-responsive-MAS event

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.


getCpsmver

java.lang.String getCpsmver()
Getter for field CPSMVER

CPSM version of MAS

The CICSPlex SM version of the current MAS.


getCicsRegionDefinitionReference

ICICSRegionDefinitionReference getCicsRegionDefinitionReference()

getCICSObjectReference

IManagedRegionReference getCICSObjectReference()
Specified by:
getCICSObjectReference in interface ICICSObject

findReferences

<From extends ICICSObject> ICICSObjectListFactory<From> findReferences(IReferenceAttribute<From,IManagedRegion> referenceAttribute)
Returns an ICICSObjectListFactory that can be used to retrieve all objects that reference this ICICSObject by the supplied IReferenceAttribute. The list factory can be activated by the caller when necessary. This method does not perform any I/O.



Copyright © 2008-2013 IBM Corp. All Rights Reserved.