3.2.10.2 Optional Parameters

MINMSGLEVEL = integer

Specifies minimum debug level desired for userlog messages.

MAXMSGLEVEL = integer

Specifies maximum debug level desired for userlog messages.

Note:

• The absolute maximum value for MAXMSGLEVEL is 100, however, the highest meaningful value for customer debugging is 30. All the higher values should (only) be used by Oracle Support for deeper analysis or debugging.
• Parameters MINMSGLEVEL and MAXMSGLEVEL are intended only for application debugging, and setting MAXMSGLEVEL to a large value can result in excessive output to the ULOG, therefore they have to be used with caution.
  Level range for customers:

  • [10]: The log of message flow, mainly MQPUT log, or major function entry points only.
  • [20]: Detailed level of tracing. The information of MQ, Service, User, CompCode, and Reason are printed.
  • [30]: MQGET log in TM_MQI.

DEFMAXMSGLEN = integer

Specifies the default value for the MAXMSGLEN parameter in the *QUEUE section.

REPLYONSVCERR = {Y|N}

Specifies if a feedback interpreting errors other than TPEVSCFAIL will be added. The default value is N.

When fails with any tperrno value other than TPESVCFAIL, TM_MQI returns a reply to the reply queue only if REPLYONSVCERR is set so that existing applications that are not checking the Md.Feedback field are not confused the reply content. In this case, TM_MQI sets MQMD Feedback to MQFB_APPL_FIRST+TPERRNO.

When REPLYONSVCERR is set, the MQ Client must check the Md.Feedback field to make sure the reply message is available.

TPESVCFAILDATA = {Y|N}

Specifies the manner of handling TPESVCFAIL errors from Oracle Tuxedo with associated non-zero length data. The default value is N.

If TPESVCFAILDATA=N, then any error occurring on tpcall() causes TM_MQI to send the original data sent to tpcall to the MQ dead letter queue, if any.

If TPESVCFAILDATA=Y, then TM_MQI returns data to the caller reply queue and will not send the original message to the MQ dead letter queue if tpcall() fails with TPESVCFAIL and a non-zero length reply. TM_MQI sets MQMD Feedback to MQFB_APPL_FIRST+TPESVCFAIL in this case. If an Oracle Tuxedo service call fails with zero-length data or with any tperrno value other than TPESVCFAIL, the original message is sent to the Dead Letter Queue.

POLINTERVAL = integer

Specifies the polling interval in milliseconds of the MQ Series in queue for TM_MQI server.

If not specified, the default value is 500. The recommended range is 50 to 500. Setting this one to lower value (0 to 49) may imply a high server load and to a higher value (501 and up) may lead to performance application decrease as the MQ Series incoming request queue will be check out less often and thus introduce delay to process the MQ Series request.

RETRYINTERVAL = integer

Specifies reconnection interval (in seconds). The minimum value is 1 and maximum value is 2147483647.

Note:

This parameter is only available for multi-threaded TM_MQI.

MAXRETRIES = integer

Specifies the maximum attempts of connection retry. The minimum and default value is 0, and the maximum value is 2147483647. If MAXRETRIES is set to 0, connection retry is turned off.

Note:

This parameter is only available for multi-threaded TM_MQI.