Setting up EXITOPT DD parameters

You can control what data is collected for BMC Extensions for MainView for MQ (MQE) and how it is collected by specifying EXITOPT DD parameters. If you do not specifiy an EXITOPT DD statement, default values are used.

To use EXITOPT, enter the DD statement into the MMAHINIT step of the started task for a given queue manager, as shown in this example:

//MMAHOOKS EXEC PGM=MMAHINIT,ACCT=(5611),PARM='MQT'
//STEPLIB DD DSN=BCL.QA.M9A38U.MQR52.BBLINK,DISP=SHR
//EXITOPT DD DISP=SHR,DSN=BCL.QA.EXITOPT.PARMLIB(BCL5XOPT)

The following table lists the valid EXITOPT parameters and values. A sample EXITOPT member is available in the MainView for MQ BBSAMP data set.

Notes

Except for the TREXCEPTION keyword, if you enter the same keyword more than once, the last value is used.

The following EXITOPT parameters are no longer supported:

STCNT
TROFFLOAD
TRTCNT
TRTSIZE
STALTKEY1
STALTKEY2
STALTKEY3
STALTCNT
STALTSYS
STALTBMC
BPM
STALTKL2

EXITOPT DD parameters

Entry	Description
zIIP processing for BMC Software Extensions for MQ (MQE)
PASDATA=YES	specifies whether MQE data collection should be performed asynchronously in the product address space (PAS) YES - Data collection is performed asynchronously in the PAS, which means data is collected only when the PAS is running. Also, data is collected in the same format as it is presented, which reduces the overhead of retrieval. The default value is YES. If you specify PASDATA=YES: You must ensure the MAXCADS value in IEASYSxx can support two common dataspaces per queue manager. The ZIIP value is set to YES automatically. The following statistics parameters are set automatically: STDYNACCUM=YES STDYNAPPL=APPL
ZIIP= [ YES \| NO]	specifies whether to run MQE data collection on a System z Integrated Information Processor (zIIP) Valid values are: YES - Use zIIP processing for data collection. NO - Perform data collection under the application TCB on a general processor. The default value is YES. Note If you specify PASDATA=YES, the ZIIP value is set to YES automatically. If you do not want to use zIIP processing, specify ZIIPPCT=0. You must consider the IEAOPT setting of ZIIPAWMT, which tells z/OS how long to wait before moving work that is queued to a busy zIIP to an available general processor. Too high a setting for IEAOPT can result in increased response time and reduced throughput.
ZIIPPCT=[ 100 \| nnn]	specifies the percentage of zIIP-eligible workload that should be offloaded to a zIIP processor The default value is 100.
Trace Control
CONNDISC=[ NO \| YES]	indicates whether specified connect and disconnect calls will be traced Valid values are: NO - MainView for MQ does not trace connect and disconnect requests to BMC Extensions forMQ. YES - trace entries for connect and disconnect requests are written to the data space and, when requested, to the log space. The default value is NO.
LOGTRLVL=[ 0 \| 1 \| 2 \| 3 \| 4 \| 5]	indicates the level of MQ API calls that are written to the Next Generation Logger (NGL) The default value is 0. Valid values are 0 - No MQ API calls are logged. 1 - Log MQPUT, MQPUT1, and MQGET calls and all MQ API exceptions (non-zero return codes). 2 - Log level 1 calls plus MQOPEN and MQCLOSE calls. 3 - Log level 1 and 2 calls plus MQCMIT and MQBACK calls. 4 - Log level 1, 2, and 3 calls plus MQINQ and MQSET calls. 5 - Log all MQ API calls.
TRAPPL= [ OFF \| appNamePattern]	bases the trace on the application name If TRAPPL is blank, the job name is used. For appNamePattern, use a ? for single characters and a * for multiple characters. If TRAPPL=*, all records for all applications are traced. The default value is OFF.
TRCNTL= dsn(member)	specifies the location of include/exclude rules See Setting-up-include-exclude-rules-for-queue-tracing.
TREXCEPTION=[ ON \| WARNING \| ANY \| ALL \| OFF \| IGNORENOMSG]	indicates how trace exceptions are handled Valid values are ON - trace exceptions for which the return code is 2 (default) WARNING - trace exceptions for which the return code is 1 ANY \| ALL - trace exceptions with non-zero return codes IGNORENOMSG - do not trace "no message available" exceptions The default values are ON and IGNORENOMSG. Note All exception values are cumulative except OFF.
TRENT=nnnnnn	controls the number of trace records to be contained in the xxxxMQTR data space for the xxxxMSTR address space. The value must be a 1-6 digit number, with a maximum of 524286. If this parameter is not specified, the maximum value will be used as the default. The value should not be set too low because the trace records created by the MQ xxxxMSTR address space must be processed by the PAS before the data space address wraps; otherwise trace records could be lost.
TRJOB= [ OFF \| jobNamePattern]	bases the trace on an individual job or set of jobs in the queue manager For jobNamePattern, use a ? for single characters and a * for multiple characters. The default value is OFF.
TRQUEUE= [ OFF \| queueNamePattern]	bases the trace on an individual queue or set of queues in the queue manager For queueNamePattern, use a ? for single characters and a * for multiple characters. The default value is OFF.
TRRESOLVED= [ OFF \| resolvedQueueNamePattern]	bases the trace on an individual resolved queue name or set of resolved queue names in the queue manager For resolvedQueueNamePattern, use a ? for single characters and a * for multiple characters. The default value is OFF.
Next Generation Logger (NGL)
DBCID=ssid	specifies the one- to four-character subsystem ID of the DB2 Component Services (DBC) that is hosting NGL
LOGSET=logsetName	specifies the logset name of the NGL instance that MainView for MQ is going to use This value can be up to 16 characters in length.
LOGSSID=ssid	specifies the one- to four-character NGL subsystem ID
RETRY=nn	specifies the number of times MainView for MQ should attempt to connect to DBC
DSMAX=nnnn	Specifies the maximum number of LOGSETS allowed to be allocated (1-999).
DSMIN=nnnn	Specifies the minimum number of LOGSETS allowed to be allocated (1-999), and should be less than DSMAX.
SPACE=nnnn	Specifies the amount of space (in megabytes) to be allocated per LOGSET (1-9999)
RETENTION=nn	Specifies the retention period (in days) of the LOGSETS (1-99).
DSNPREFIX=logDSprefix	Specifies the LOG dataset name prefix for LOGSETS (maximum length of 28 bytes)
MainView Transaction Analyzer connection
MTACONN=[ NO \| YES]	indicates whether MainView Transaction Analyzer is enabled for this queue manager If TRJOB and TRAPPL are set to their default values, MTACONN=YES overrides these options and traces all MQ API calls. The default value is NO. Note To correlate MQ components when MainView Transaction Analyzer is running, BMC Software Extensions for MQ (MQE) must be installed on the appropriate queue managers and must be writing to the logset.
MTAID= ssid	specifies a subsystem ID for the MainView Transaction Analyzer PAS to which the connection is being made
Dumps
DUMPCNT= [ 2 \| nn]	indicates the maximum number of dumps to be taken for this queue manager, The default value is 2.
Statistics
MQEXDSSZ=NNNNNN	specifies the MQEXqmgr data space size. Size in 4K blocks (pages) in the range 1000 to 524,288. The default is 524,288. If the The MQEX data space size is not set up, will use the default value 524288.
MQTCPOOL=[ 300 \| nnnnnn]	indicates the number of workareas reserved for statistics and trace records When the CPOOL storage area becomes full, the BBSX702 message is issued at shutdown. The default value is 300.
STDYNACCUM= [ YES \| NO \| ALL]	indicates whether to accumulate data in the dynamic queues Valid values are YES - If the model name is identifiable, it is used as the object name in the key. Temporary dynamic queues with unidentifiable model names are prefaced with tempdyn instead of the model name. Permanent dynamic queues with unidentifiable model names are treated as if they are permanent objects; the hash key is not changed. NO - Create the key for the dynamic queue as predefined instead of dynamic. ALL - This value provides the same results as YES, except permanent queues with unidentifiable model names are keyed with permdyn instead of the model name. The default value is YES. Note You must define the application name by using STDYNAPPL=APPL. If you specify PASDATA=YES, the STDYNACCUM value is set to YES automatically.
STDYNAPPL= [ APPL \| QMGR]	indicates the value to be used as the application name for dynamic queues Valid values are APPL - Uses the real application name as part of the record key. QMGR - Uses the queue manager name in place of the application name for dynamic queues. The default value is APPL. Note If you specify PASDATA=YES, the STDYNAPPL value is set to APPL automatically.
STGLNEG0=[ YES \| NO]	indicates how to treat negative latency Valid values are: YES - Treat negative latency as 0 for statistics. NO - Discard negative latency. The default value is YES.
STGLV n= xxxxxx	indicates the lowest latency time collected from bucket n xxxxxx is the bound value, in one-hundredths of a second. Valid values for n are 2, 3, 4, 5, or 6. The default values are STGLV2 = 100 (1 second) STGLV3 = 200 (2 seconds) STGLV4 = 500 (5 seconds) STGLV5 = 1500 (15 seconds) STGLV6 = 6000 (60 seconds)

Setting up EXITOPT DD parameters

On this page