CICSPlex SM system parameters

  keyword(v)

keyword

The name of a CICSPlex SM system parameter.

v

An alphanumeric data value that you can specify with the system parameter.

EYUCMS0P

CMAS parameters

EYULMS0P

Local MAS parameters

Table 1. CICSPlex SM parameters used in CMAS, MAS, and WUI servers. Parameter CMAS MAS and WUI server Default ALERTRCVR Optional n/a NETVALRT ALERTVER Optional n/a 0 APISIGNMSG Optional n/a YES BASASSOCBLK Optional n/a 14301 BASLOGMSG n/a Optional NO CACHEDSNUM Optional n/a 2 CICSPLEX n/a Required   CMASSYSID n/a Optional See description CMTCMLNKACQ Optional n/a RECONN COHTTASKPRI n/a Optional 200 COIRTASKPRI n/a Optional 200 COMMTSBLOCKS Optional Optional 128 (MAS)       512 (CMAS) HISTORYONLY n/a Optional NO HISTRECSMSG n/a Optional 0 HISTSECS n/a Optional 30 JRNLDEFCH Optional n/a NO JRNLOPACT Optional n/a NO JRNLRTAEV Optional n/a NO MASALTLRTCNT n/a Optional 0 MASALTLRTPRI n/a Optional 255 MASALTLRTTIM n/a Optional 10 MASINITTIME n/a Optional 10 MASPLTWAIT n/a Optional NO MASTASKPROT Optional n/a NO MAXAUXCPSM Optional n/a 50 MAXAUXTOTL Optional n/a 70 MAXHISTRECS n/a Optional 1 MSGBUCKETS n/a Optional 1024 NAME Optional Optional   RESSTATUS Optional n/a NOTIFY SEC Optional n/a NO SECLOGMSG Optional n/a NO SECRPTLVL Optional n/a RESPONSE SECTIMEOUT Optional n/a 30 SPOOLCLASS Optional Optional P STALLCONTSK n/a Optional 2 STALLCONCNT n/a Optional 3 STALLDBCTSK n/a Optional 4 STALLDBCCNT n/a Optional 4 STALLDB2TSK n/a Optional 4 STALLDB2CNT n/a Optional 4 STALLDLITSK n/a Optional 4 STALLDLICNT n/a Optional 4 STALLDSPTSK n/a Optional 4 STALLDSPCNT n/a Optional 2 STALLEJBCNT n/a Optional 3 STALLEJBTSK n/a Optional 2 STALLENQTSK n/a Optional 4 STALLENQCNT n/a Optional 4 STALLFLETSK n/a Optional 3 STALLFLECNT n/a Optional 4 STALLILKTSK n/a Optional 2 STALLILKCNT n/a Optional 3 STALLIPCTSK n/a Optional 2 STALLIPCCNT n/a Optional 3 STALLLCKTSK n/a Optional 4 STALLLCKCNT n/a Optional 4 STALLLGRCNT n/a Optional 3 STALLLGRTSK n/a Optional 2 STALLITVTSK n/a Optional 0 STALLITVCNT n/a Optional 0 STALLJNLTSK n/a Optional 1 STALLJNLCNT n/a Optional 3 STALLMQSCNT n/a Optional 3 STALLMQSTSK n/a Optional 2 STALLPGMTSK n/a Optional 2 STALLPGMCNT n/a Optional 4 STALLRMITSK n/a Optional 2 STALLRMICNT n/a Optional 3 STALLSESTSK n/a Optional 2 STALLSESCNT n/a Optional 3 STALLSOCTSK n/a Optional 2 STALLSOCCNT n/a Optional 3 STALLSTGTSK n/a Optional 1 STALLSTGCNT n/a Optional 2 STALLTDQTSK n/a Optional 3 STALLTDQCNT n/a Optional 4 STALLTRMTSK n/a Optional 0 STALLTRMCNT n/a Optional 0 STALLTSKTSK n/a Optional 0 STALLTSKCNT n/a Optional 0 STALLTSQTSK n/a Optional 3 STALLTSQCNT n/a Optional 4 STALLUSRCNT n/a Optional 0 STALLUSRTSK n/a Optional 0 STALLWEBCNT n/a Optional 3 STALLWEBTSK n/a Optional 2 STALLXMGTSK n/a Optional 4 STALLXMGCNT n/a Optional 2 STALLXRFTSK n/a Optional 1 STALLXRFCNT n/a Optional 2 SUPPRESSCMF n/a Optional NO TOBATCHREQ Optional n/a 0 TOONLINEREQ Optional n/a 0 TOPOLLINT Optional n/a 300 WLMLCUSH n/a Optional 20

ALERTRCVR(NETVALRT | name)

Identifies the 1- 8-character name of the NetView® Alert Receiver to be used by the CMAS if the CMAS sends NetView Generic Alerts to NetView.

ALERTVER( 0 | 1 )

Identifies the version of the CPSM generic alert record that the CMAS sends to NetView. See Generic alert and resolution structures for details about the generic alert Records that CICSPlex SM sends to NetView.

ALERTVER is relevant only for a CMAS that is named in an ACTNDEF as a CMAS that sends generic alerts to NetView.

APISIGNMSG(YES | NO)

Indicates whether the successful signon and signoff message, EYUXD0807I, is issued when a CICSPlex SM API user connects to, or disconnects (TERMINATE) from, the CICSPlex SM API.

BASASSOCBLK(value | 14301)

Specifies the number of BAS association blocks that can be acquired from a single association element. The default EYUPARM value creates an association segment size requiring approximately 1.2 MB of storage. If you specify the maximum value of 114597 blocks-per-segment is specified, then the resultant segment size is just over 8 MB.

BASLOGMSG(YES | NO)

Indicates whether CICS resources defined using BAS must have their definitions logged to the CSDL Transient Data Queue of the MAS when they are installed.

If the CICS version used by the MAS does not support the LOGMESSAGE option of the EXEC CICS CREATE command, BASLOGMSG has no effect.

CACHEDSNUM(value | 2)

Specifies the number of data spaces that this CMAS creates for each CICSPlex SM component. At least 1MB is allocated in each data cache when the data space is created. The value must be in the range 1 to 8.

You can change this parameter only on a CPSM CMAS cold start. Normally, do not change this parameter unless advised to do so by IBM® Support.

CICSPLEX(name)

Identifies the 1- to 8-character name of the CICSplex to which the local MAS is to be associated.

The name of a CICSplex must not be the same as the name of a CMAS, a CICS system, or a CICS system group.

CMASSYSID(name)

Identifies the 1- to 4-character name of the CMAS to which a MAS is to be attached. If a MAS specifies a CMASSYSID and the CMAS is active but does not manage the CICSplex, the MAS waits until the specified CMAS is managing the CICSplex before it joins the CICSplex.

You can also use this parameter when a local MAS is to attach to a specific CMAS in the same MVS™ image.

Note: This parameter is optional. However; for a specific release of CICSPlex SM, if you do not specify a value for the CMASSYSID parameter and you have multiple CMASs on an MVS system, a local MAS will connect to the last CMAS initialized on the MVS system that manages the CICSplex specified by the CICSPLEX parameter.

CMTCMLNKACQ(ALWAYS | RECONN)

Specifies whether you want the CMAS to attempt to reacquire LU6.2 CMAS to CMAS links (CMTCMLNKs) if the initial acquire attempt made by CICS fails. The initial acquire attempt is made by CICS when a CMAS is started, a z/OS Communications Server ACB is opened, or a CMAS to CMAS definition (CMTCMDEF) is installed. If the initial acquire attempt fails, CICSPlex SM network surveillance might attempt to re-acquire the LU6.2 CMAS to CMAS links depending on the value of CMTCMLNKACQ:

• If CMTCMLNKACQ is set to ALWAYS, the CMAS attempts to acquire CMTCMLNKs, independent of whether the links were established in the current CMAS run.
• If CMTCMLNKACQ is set to RECONN, the CMAS attempts to re-acquire CMTCMLNKs only where CMTCMLNKs were established in the current CMAS run.

If the CMTCMLNKs were not acquired in the current CMAS run and the initial acquire attempts fail, CMTCMLNK must manually be acquired.

Depending on the CMTCMLNKACQ option that you are using, repeated failed acquire attempts can produce messages DFHZC3437, DFHZC3462 and DFHZC2405 and z/OS Communications Server IST663 and IST664.

CMTCMLNKACQ can be dynamically changed in a CMAS using the COD0 SET command.

COHTTASKPRI(value | 200)

Specifies the CICS task priority for the MAS COHT task. COHT is invoked in a MAS when an API or Web User Interface query for completed task history records (HTASK records) is directed to the MAS. Use this parameter to tune the priority of HTASK requests so that a resource-intensive query does not affect the performance of other tasks in the MAS.

COIRTASKPRI(value | 200)

Specifies the task priority of COIR, in the range 0 - 255. COIR is a CICSPlex SM task that you can use to process evaluation definitions, EVALDEFs, independent of the MAS.

For each EVALDEF that requests a separate task, an instance of COIR is started at the specified priority. If you specify a priority of 0, no separate COIR tasks are started; all EVALDEFs are processed by the MAS long running task (LRT).

COMMTSBLOCKS((value | 512/128)

Specifies the number of sets of control blocks allocated at CMAS or MAS startup for CPSM Communications Transport Services. These control blocks are used when data must be shipped between a CMAS or MAS and other CMASs or MASs.

The default and minimum values for this parameter are 512 in a CMAS and 128 in a MAS. The maximum value is 8192 in either a CMAS or MAS.

Each set requires 1204 bytes of storage allocated in ESDSA in the CMAS or MAS. If the defaults are used, this amount of total storage is allocated:

CMAS: 512 * 1204 = 616,448 bytes
MAS: 128 * 1204 = 154,112 bytes

If the maximum value is specified, this amount of total storage is allocated:

CMAS: 8192 * 1204 = 9,863,168 bytes
MAS: 8192 * 1204 = 9,863,168 bytes

If a shortage occurs while running a CMAS or MAS, message EYUCT0105E is issued. At termination of the CMAS or MAS, message EYUCT0106W is issued. The later message includes a value equal to the highest concurrent shortage of sets (high-water mark). Increase the COMMTSBLOCKS parameter for the CMAS or MAS by at least the amount specified by the EYUCT0106W message before restarting the CMAS or MAS.

HISTORYONLY( YES | NO)

Specifies whether history data is collected without collecting normal CICSPlex SM monitoring data as well. For example, if MLOCTRAN and MREMTRAN data is not required set HISTORYONLY(YES) to prevent this data from being collected.

HISTRECSMSG( value | 0)

Specifies that message EYUNL0179I 'Task History Recorder data set EYUHISTx has accrued nnnn records' is produced each time 'value' thousand records are written to the history data sets. The maximum allowed value is 1000 which specifies that a message is produced every time 1 million records are written to the history data sets.

The message is an aid to determining the optimum size of the history data sets. A value of 0 means that no EYUNL0179I messages are to be produced.

HISTSECS( value | 30)

Specifies the number of seconds to use as the default when API or Web User Interface users specify a parameter of RECENT(HISTSECS) when requesting completed task (HTASK) resource table records. The maximum allowed value is 86400 seconds (24 hours).

JRNLDEFCH(YES | NO)

Causes a journal record to be written for each data repository add, delete, and update operation.

JRNLOPACT(YES | NO)

Causes a journal record to be written for each successful action command issued against a MAS or CMAS.

JRNLRTAEV(YES | NO)

Causes a journal record to be written each time a real-time analysis (RTA) event is generated.

MASALTLRTCNT(0 - 5 | 0)

Indicates the number of alternate long-running tasks (CONA) started in the MAS during MAS agent initialization. These tasks remain active until the MAS agent stops or goes into restart mode and handles all API, WUI, or RTA requests normally handled by the CONL task, allowing the CONL task to perform other processing in the MAS. At any time, only one of the CONA tasks processes requests. If the CONA task that is currently processing requests becomes busy (as determined by the value of the MASALTLRTTIM EYUPARM), subsequent requests are directed to another CONA task.

If you specify zero (0), no CONA tasks are started and the CONL task services the API, WUI or RTA requests that are normally directed to the long running task. Specifying different values for MASALTLRTCNT for multiple WLM target regions, you might cause an uneven distribution of transactions to those regions because of differing long-running task counts.

MASALTLRTPRI(0 - 255 | 255)

Specifies the priority given to the CONA transaction for running the current MAS. If you specify this value as less than 255 you might adversely affect the response time of API and WUI users and stop RTA EVENTs from being created or resolved in a timely manner.

MASALTLRTTIM(1 - 3600 | 10)

Specifies the amount of time in seconds for which a CONA task can be busy before subsequent requests are directed to another active CONA task.

MASINITTIME(value | 10)

Specifies the number of minutes, from 5 to 59, that CICSPlex SM waits for the MAS to initialize.

• If you specify MASPLTWAIT(YES), the MASINITTIME value is the maximum length of time that PLT processing can be suspended for MAS initialization. (By suspending PLT processing, the chance of completing MAS initialization in a specified time is increased, because you are asking for less work to be done in a given time interval and thereby reducing the scope for contention during that time).
• If you specify MASPLTWAIT(NO), the MASINITTIME value is the maximum length of time that can elapse before MAS initialization is halted if it does not complete.

MASPLTWAIT(YES | NO)

Indicates whether CICSPlex SM suspends all PLT processing until the MAS is fully initialized and connected to the CMAS.

• When you specify MASPLTWAIT(YES), no CICS applications can be started and no users can sign on to the system until CICSPlex SM completes the installation of resources and resumes PLT processing.
• If CICSPlex SM does complete the installation of resources and resume PLT processing in the time interval specified by MASINITTIME, message EYUTS0003I is issued.
• If it does not complete in the time interval specified by MASINITTIME, one of two messages will be issued:
  • EYUNL0090W is issued when MAS initialization is halted and PLT processing resumes to allow the region to function as a CICS region without CICSPlex SM control.
  • EYUXL0090W is issued when MAS initialization is halted and PLT processing resumes to allow the region to function as a CICS region without CICSPlex SM control, but the MAS agent continues to wait for the CICSplex to be registered with the ESSS subsystem by a starting CMAS. When a CMAS registers the CICSplex, MAS agent initialization will continue.
• MAS initialization can be retried by entering the COLM transaction manually.
• When you specify MASPLTWAIT(NO), CICSPlex SM still observes the MASINITTIME value waiting for the MAS agent to complete the topology connect.
• If CICSPlex SM does not complete the topology connect in the time interval specified by MASINITTIME or its default value, message EYUNL0090W is issued, the MAS initialization is halted, and the PLT processing resumes to allow the region to function as a CICS region without CICSPlex SM control.
• MAS initialization can be retried by entering the COLM transaction manually.

If you are including a CICS system in a platform, or if you are using Business Application Services (BAS) to automatically install resources at CICS system initialization, specify MASPLTWAIT(YES) for that system. MASPLTWAIT(YES) is required to automatically install resources for an application or platform, or BAS resources, when the CICS region is initialized.

If you are using Business Application Services (BAS) to automatically install a DB2® connection, and you want the connection to be activated during CICS startup, see the information in Activating DB2 and Websphere MQ connections during CICS startup.

MASTASKPROT (YES | NO)

Controls whether the CPSM API, Web User Interface (WUI), and CICS Management Client Interface (CMCI) are allowed to perform actions or set attribute values for CPSM MAS agent tasks with transaction IDs COIE, COI0, CONA, or CONL.

• If you specify MASTASKPROT(NO), the default, users of the CPSM API, WUI, and CMCI are allowed to FORCEPURGE or modify attribute values for CPSM MAS agent tasks.
• If you specify MASTASKPROT(YES), CPSM validates the transaction ID of all tasks before allowing actions to be performed, or attribute values to be modified for active tasks. If the transaction ID indicates that the task runs as part of the CPSM MAS agent, the request is not processed, and a CICS response is set as follows:
  • RESP = TASKIDERR
  • RESP2 = 2 (The task is protected by CICS and is not eligible for modification with this command.)
  The function code (EIBFN) is null, to indicate that the response is simulated and not set by the CICS SPI.

MAXAUXCPSM(value | 50)

Specifies the percentage of total auxiliary storage that can be committed to each CMAS, in the range of 0 to 99. A value of 0 stops CPSM from checking the amount of space used.

Important: Setting a value of 0 might result in a shortage of auxiliary storage, requiring an IPL of the MVS system.

Each CMAS requires 24,160 4 KB pages (94 MB) of cache storage at initialization. If a request for additional cache storage would cause the CMAS to exceed the MAXAUXCPSM threshold, an SDUMP is taken and the CMAS is terminated. If the threshold is exceeded during CMAS initialization, the CMAS was unable to acquire the initial allocations for all required component data cache areas. Either increase the value of MAXAUXCPSM, or increase the total amount of auxiliary storage by adding or expanding external page data sets. If this threshold is reached during an attempt to create or extend a data cache after CMAS initialization has completed, the automatic restart mechanism (ARM) is invoked to attempt to restart the CMAS.

MAXAUXTOTL(value | 70)

Specifies the maximum total auxiliary storage use at which the CMAS allows a request for additional cache storage to be made, in the range of 0 to 99. A value of 0 stops CPSM from checking the amount of space used.

Important: Setting a value of 0 might result in a shortage of auxiliary storage, requiring an IPL of the MVS system.

Setting a nonzero value for MAXAUXTOTL prevents the CMAS from requesting an amount of cache storage that would cause the MVS system to enter a state of auxiliary storage shortage. If a request for additional cache storage causes the CMAS to exceed this threshold, an SDUMP is taken and the CMAS is terminated. This parameter can cause a CMAS to shut down even though the CMAS is not the largest user of auxiliary storage. If such a shutdown occurs during CMAS initialization, the CMAS was unable to acquire the initial allocations for all required component data cache areas. You must increase the total amount of auxiliary storage available by adding or expanding external page data sets. If this threshold is reached during an attempt to create or extend a data cache after CMAS initialization has completed, the automatic restart mechanism (ARM) is invoked to attempt to restart the CMAS.

MAXHISTRECS( value | 1)

Specifies a value in thousands, in the range 1 to 50. This value is a limit on the number of records returned on a completed task query from the MAS. You can limit the amount of data in a request for completed task (HTASK) resource table records. When this limit is reached, the CICSPlex SM API GET request receives a WARNING response and MAXRECORDS reason.

MSGBUCKETS(value | 1024)

Specifies a value in the range 1 - 32768. This value specifies the number of buffers to be allocated for Topology data collection in the MAS. Each buffer is 64 bytes long. The buffer pool, allocated in the MAS cache data space, is used by CICSPlex SM XMEOUT and XRSINDI global user exits and by the MAS Heartbeat task. The number of buffers must equal or exceed the total number of connections, DSNAMEs, GLUEs, TRUEs, and FEPI connections defined in the MAS. If the number of buffers is not sufficient for the Topology mapped resources in the MAS, a trace record with debug text XDATLOST is written at every other heartbeat interval when MAS Topology resource data is collected. Without sufficient buffers, resources are missing from Topology Resource Maps for the MAS in all CMASes in the CICSplex, and query or action requests entered from the WUI or API for specific resources can fail because the target resources are not known to Topology.

NAME(name)

Identifies the 1- to 8-character name of the CMAS or local MAS that is to be started. If you do not specify this parameter, the default is the z/OS Communications Server application ID.

RESSTATUS(NOTIFY | MSG | CONMSG)

Indicates how the CMAS is to respond when a CICS resource that is being reported to the resource status facility has a change in operational state:

NOTIFY

Issues event notifications in the form of ERESSTAT resource table records.

You can monitor these event notifications by using the LISTEN command of the CICSPlex SM API. For more information, see cpsm.api.listen.

MSG

Writes external messages to EYULOG.

If you specify MSG, event notifications are produced in addition to the messages.

CONMSG

Writes external messages to the job log, console, and EYULOG.

If you specify CONMSG, event notifications are produced in addition to the messages.

Use this option with care. It can cause many messages to be sent to the console.

SEC(YES | NO)

For a CMAS, indicates whether the CMAS is to perform security checking of CICSPlex SM requests directed to the CICS systems it manages.

If you specify NO, all security-related parameters are ignored.

If a CMAS manages any CICS regions that are running with security active (SEC=YES specified as a system initialization parameter), the CMAS must include SEC(YES) in EYUPARM. If you do not activate CICSPlex SM security in the CMAS, a connection cannot be established to a CICS system that specifies SEC=YES. If a connection is attempted, the following message is issued to the console, the CMAS job log, and the CMAS EYULOG:

EYUCR0007E Security mismatch between CMAS cmasname and MAS masname. Connection terminating.

If a CMAS that is started with SEC(NO) connects directly or indirectly to a CMAS started with SEC(YES), any request sent to the SEC(YES) CMAS fails.

• If the request originates from the CICSPlex SM API connected to the SEC(NO) CMAS, the API request receives: RESPONSE 1031 NOTPERMIT REASON 1345 USRID
• If the request originates from the CICSPlex SM Web User Interface server connected to a SEC(NO) CMAS, the Web browser receives the message EYUVC1220E

SECLOGMSG(NO | YES | ALL)

Controls whether CICSPlex SM issues message EYUCR0009I to the CMAS EYULOG to record security failures.

When you specify NO, the default, message EYUCR0009I is not issued.

Specify YES, or ALL, to cause message EYUCR0009I to be issued.

SECLOGMSG(YES) can be useful if the External Security Manager (ESM) does not issue messages when it cannot make a decision or when a failure occurs.

When you specify SECLOGMSG(YES), EYUCR0009I is issued only for requests that are to be logged to the ESM.

SECLOGMSG(ALL) causes EYUCR0009I to be issued even when the ESM permits access to the resource. The ALL operand can produce many EYUCR0009I messages and must normally be used only under the direction of IBM Support.

You can change SECLOGMSG dynamically in a CMAS with the COD0 SET command.

SECRPTLVL (NONE | RESPONSE | DETAIL)

Controls the level of detail available to a client API task when a response of NOTPERMIT with reason USRID is returned by a request.

When you specify NONE, all indications of a security validation exception are suppressed. A response of OK or NODATA, as appropriate, is returned to the client API task.

Specifying the default, RESPONSE, causes the original API response of NOTPERMIT and reason of USRID to be returned to the client task.

Specifying DETAIL causes a result set of MASQRYER resources to be built, identifying the regions in which the requesting user was denied access to a resource. MASQRYER resources can be retrieved by running a FETCH command, passing the QUERYERROR parameter.

Note: The SECRPTLVL parameter controls the response from the CMAS in which it is processed even though the API request might have originated in a different CMAS. Thus a CMAS which manages MASes containing sensitive resources can be started with SECRPTLVL(NONE), while other CMASes managing MASes with lower sensitivity can be started with SECRPTLVL(RESPONSE) or SECRPTLVL(DETAIL).

SECTIMEOUT(value | 30)

Specifies the time in minutes, in the range of 1 through 1440 (1 day), that idle user IDs are to remain signed on in the CMAS before being considered for timeout.

You can also use this value to control how often the CMAS checks for idle users to timeout. For example, with the default value of 30, the CMAS checks every 30 minutes for users who have not used the CMAS for 30 minutes. However, because the times are not synchronized the user ID might not be timed out for up to double the SECTIMEOUT value. Setting a low value increases the number of calls to the External Security Manager (ESM). Setting a high value means that users might have to wait a long time before automatically picking up security changes that affect the user ID (for example, adding the user to a new group).

You can use the CMAS or CMASLIST PURGE request, available from the API and WUI, to force a CMAS to check for users to time out immediately.

You can use the CMAS or CMASLIST RESET USERID request, available from the API and WUI, to force the CMAS to rebuild the user's security information the next time it is used. This request is used after adding or removing a user ID to or from a group, and the user does not want to wait to be timed out to pick up the change.

SPOOLCLASS(class | P)

Specifies a SYSOUT class value, from A to Z or 0 to 9, that identifies where CICSPlex SM spool output is to be sent.

Spool output can be generated by these CICSPlex SM functions:

• The online utility transaction COLU
• The PRINT and CAPTURE commands of the interactive debugging transaction COD0

STALLxxxCNT

xxx represents a CICSPlex SM suspend class. The values for xxx are shown in Table 2.

Identifies the number of consecutive occurrences of an entry in the suspend class required for CICSPlex SM to report a STALL. The value can be 0 - 999. Use 0 to indicate that STALL detection for the xxx suspend class is not active. The default value for each task is shown in Table 1.

STALLxxxTSK

xxx represents a CICSPlex SM suspend class. The values for xxx are shown in Table 2.

Identify the minimum number of concurrent tasks required to enter the suspend class. The value can be 0 - 999. Use 0 to indicate that STALL detection for the xxx suspend class is not active. The default value for each task is shown in Table 1.

SUPPRESSCMF(YES | NO)

For a local MAS, indicates whether the records collected by the CICS Monitor Facility are written to SMF.

The parameter suppresses only CICS type 3 performance class records. Type 4 exception records and type 5 transaction resource records are not suppressed. The type 3 performance records are suppressed only if the CICS region has an active CICSPlex SM monitor definition installed for the MTRAN monitoring class. You can verify which CICS regions have active monitoring for the MTRAN class by using the WUI Active monitor specifications (POLMON) tabular view.

TOBATCHREQ(value | 0)

Specifies the time in seconds before a batch request directed to a MAS is timed out. This time includes RTA requests and API requests initiated from non-CICS programs. Specify zero or a value in the range 10 - 1800.

• If you specify zero, the default value of 240 seconds (4 minutes) is applied. This value is then doubled when the request is transmitted to the MAS.
• If you specify a non-zero value in the range 10 - 1800, that value is used.
• If you specify a non-zero value less than 10, TOBATCHREQ is set to 10.

Depending on the value specified for TOBATCHREQ, more timeouts can be received. You can check in the following ways:

RTA requests

No data is processed for any MAS that times out and no external message is displayed. This occurrence might mean that an event is not created or might lead to premature termination of existing events.

API requests initiated from non-CICS programs

All API requests initiated from non-CICS programs receive a RESPONSE of ENVIRONERROR (1030) and REASON of REQTIMEOUT (1342) and no data records are returned, regardless of the CONTEXT and SCOPE of the request.

TOONLINEREQ(value | 0)

Specifies the time in seconds before an online request directed to a MAS is timed out, including WUI requests and API requests initiated from CICS programs. Specify zero, or a value in the range 10 - 1800.

• If you specify zero, the default value of 240 seconds (4 minutes) is applied. This value is then doubled when a CMAS-to-CMAS link is crossed. For example, you might have a WUI connected to CMAS-1 and MAS-2 is connected to CMAS-2. If you inquire from the WUI to MAS-2, the TOONLINEREQ default value of 240 seconds is doubled to 480 seconds because the request is transmitted from CMAS-1 to CMAS-2.
• If you specify a non-zero value in the range 10 - 1800, that value is used.
• If you specify a non-zero value less than 10, TOONLINEREQ is set to 10.

Depending on the value specified for TOONLINEREQ, more timeouts can be received. You can check in the following ways:

WUI requests

All WUI requests receive the following message and no data records are displayed, regardless of the CONTEXT and SCOPE of the request.

EYUVC1220E

CICSPlex SM API command (GET) failed. (Environerror, Reqtimeout)

API requests initiated from CICS programs

All API requests initiated from CICS programs receive a RESPONSE of ENVIRONERROR (1030) and REASON of REQTIMEOUT (1342) and no data records are returned, regardless of the CONTEXT and SCOPE of the request.

TOPOLLINT(value | 300)

Specifies the time in seconds that a CMAS delays between checking all requests to check if they exceed their timeout time. Because polling is used to check when to timeout a request, more reliable timeouts occur if this value is set less than or equal to both TOBATCHREQ and TOONLINEREQ.

When a request is directed to a MAS that is not connected to the originating CMAS, it is transmitted from the originating CMAS to the remote CMAS to which the MAS is connected. In this case, the remote CMAS performs the timeout processing, based on the TOBATCHREQ and TOONLINEREQ values specified in the originating CMAS and the TOPOLLINT value specified in the remote CMAS. For this reason, timeout processing is more consistent if all CMASes in the network have the same TOPOLLINT value.

WLMLCUSH(value | 20)

Specifies the percentage of additional pre-allocated storage that CICSPlex SM WLM list management uses in addition to the value of MAXTASK at region initialization. This value is in the range of 0 to 100.

Important: If this value is lower than the known variance of MAXTASK from the initial MXT value, additional allocation and deallocation of storage in the routing region occurs, leading to degraded performance. In such circumstances, you must increase the initial values of MXT or WLMLCUSH and restart the routing region.