Environment variables descriptions

Examples of use

AMQ_ALLOWED_CIPHERS

For more information, see Providing a custom list of enabled CipherSpecs on Multiplatforms in CipherSpec order in TLS handshake.

AMQ_BAD_COMMS_DATA_FDCS

The AMQ_BAD_COMMS_DATA_FDCS environment variable is effective when set to any value.

A failure data capture (FDC) record containing the invalid data that IBM MQ has received might also be written. However, an FFST file is not generated if this is the beginning of a conversation with the remote side and the format is a simple known format such as a GET request from an HTTP web browser. If you want to override this to cause FFST files to be written for any bad data including simple known formats, you can set the AMQ_BAD_COMMS_DATA_FDCS environment variable to any value (for example, TRUE) and restart the queue manager.

AMQ_CONVEBCDICNEWLINE

You can use the AMQ_CONVEBCDICNEWLINE environment variable to specify how IBM MQ is to convert an EBCDIC NL character into ASCII format. The environment variable takes the same values as the ConvEBCDICNewline attribute of the mqs.ini, that is, NL_TO_LF, TABLE, or ISO (see All queue managers stanza of the mqs.ini file). You can, for example, use the AMQ_CONVEBCDICNEWLINE environment variable instead of the ConvEBCDICNewline stanza attribute to provide ConvEBCDICNewline functionality on the client side in situations where the mqs.ini file cannot be used. If both the stanza attribute and the environment variable are set, the stanza attribute takes precedence.

For more information, see Data conversion between coded character sets .

AMQ_DIAGNOSTIC_MSG_SEVERITY

If the AMQ_DIAGNOSTIC_MSG_SEVERITY environment variable is set to 1 for an IBM MQ process, this causes the message severity to be appended to the message number as a single uppercase alphabetic character when the IBM MQ process writes a message to an error log or to the console.

The behavior that AMQ_DIAGNOSTIC_MSG_SEVERITY enables is set by default. You can turn off this behavior by setting the environment variable to 0.

For more information, see Using error logs.

AMQ_DISABLE_CLIENT_AMS

For more information, see Disabling Advanced Message Security at the client.

AMQ_DMPMQCFG_QSGDISP_DEFAULT

AMQ_IODELAY, AMQ_IODELAY_INMS and AMQ_IODELAY_FFST

Starting the queue manager as in this example, causes an FDC or FFST file to be written if an input/output operation takes longer than 200000 microseconds (0.2s), which is still a relatively generous threshold.

For more information, see Queue manager health check behavior.

AMQ_LDAP_TRACE

If the AMQ_LDAP_TRACE environment variable is set to a non-null value, it is possible to switch LDAP client trace on and off without also stopping or starting the queue manager.

For more information, see Enabling dynamic tracing of LDAP client library code.

AMQ_LICENSING_METRIC

Setting the AMQ_LICENSING_METRIC=VPCMonthlyPeak environment variable causes the queue manager to upload data relating to monthly VPC license types, instead of the default behavior of uploading data related to hourly container-based licenses.

For more information about configuring IBM MQ for use with the IBM Cloud® Private metering service, see IBM Cloud Private metering service in the IBM Cloud Private documentation.

AMQ_MQS_INI_LOCATION

On AIX and Linux systems, you can alter the location that is used for the mqs.ini file by setting the location of the mqs.ini file in the AMQ_MQS_INI_LOCATION environment variable. This environment variable must be set at the system level.

For more information about the mqs.ini file, including directory locations, see IBM MQ configuration file, mqs.ini.

AMQ_NO_BAD_COMMS_DATA_FDCS

The AMQ_NO_BAD_COMMS_DATA_FDCS environment variable is effective when set to any value.

If IBM MQ does not recognize the initial data transmission when attempting to connect a non-IBM MQ client to an IBM MQ TCP/IP listener, this causes the queue manager to write an AMQ9207E error message to the queue manager error logs. A failure data capture (FDC) record is also written. You can suppress the generation of these diagnostic files with the AMQ_NO_BAD_COMMS_DATA_FDCS environment variable. When AMQ_NO_BAD_COMMS_DATA_FDCS is set to any value (for example, TRUE), this instructs IBM MQ not to generate FFSTs when reporting AMQ9207E error messages on the initial communications flow. To be effective, the environment variable should be set before starting the queue manager and listener processes.

The FDC continues to be generated in the case where a client sends valid IBM MQ protocol flows to the queue manager, and then sends invalid data, as this is indicative of a client issue that warrants further investigation.

AMQ_NO_IPV6

The AMQ_NO_IPV6 environment variable is effective when set to any value. When this environment variable is set, it disables the use of IPv6 while attempting a connection.

AMQ_REVERSE_COMMIT_ORDER

AMQ_SSL_ALLOW_DEFAULT_CERT

When the AMQ_SSL_ALLOW_DEFAULT_CERT environment variable is not set, an application can connect to a queue manager with a personal certificate in the client keystore only when the certificate includes the label name of ibmwebspheremquserid. When the AMQ_SSL_ALLOW_DEFAULT_CERT environment variable is set, the certificate does not require the label name of ibmwebspheremquserid. That is, the certificate that is used to connect to a queue manager can be a default certificate, provided that a default certificate is present in the key repository, and the key repository does not contain a personal certificate with the prefix ibmwebspheremquserid.

A value of 1 enables the use of a default certificate.

Instead of using the AMQ_SSL_ALLOW_DEFAULT_CERT environment variable, an application can use the CertificateLabel setting of the SSL stanza in the mqclient.ini file. For more information, see Digital certificate labels, understanding the requirements and SSL stanza of the client configuration file.

AMQ_SSL_LDAP_SERVER_VERSION

The AMQ_SSL_LDAP_SERVER_VERSION environment variable can be used to ensure that either LDAP v2 or LDAP v3 is used by IBM MQ cryptographic components in cases where CRL servers require that a specific version of the LDAP protocol be used.

This environment variable does not affect LDAP connections established by the IBM MQ queue manager for user authentication or user authorization.

AMQ_USE_ZLIBNX

The zlibNX library is available in IBM AIX 7.2 with Technology Level 4 Expansion Pack, and later. If the environment variable is set and the zlibNX library (/usr/opt/zlibNX/lib/libz.a) is not installed, the message channel agents will use the standard zlib library provided in the IBM MQ for AIX installation.

HOME

On AIX, Linux and IBM i, the HOME environment variable specifies the name of the directory that is searched for the mqclient.ini file. This file contains configuration information that is used by IBM MQ MQI clients.

For more information, see IBM MQ MQI client configuration file, mqclient.ini and Location of the client configuration file.

HOMEDRIVE and HOMEPATH

To be used, both the HOMEDRIVE and HOMEPATH environment variables must be set. They are used on Windows systems to specify the name of the directory that is searched for the mqclient.ini file. This file contains configuration information that is used by IBM MQ MQI clients.

For more information, see IBM MQ MQI client configuration file, mqclient.ini and Location of the client configuration file.

LDAP_BASEDN

LDAP_BASEDN is the required environment variable for running an LDAP sample program. It specifies the base Distinguished Name for the directory search.

LDAP_HOST

LDAP_HOST is an optional environment variable for running an LDAP sample program. It specifies the name of the host where the LDAP server is running; it defaults to the local host if it is not specified.

LDAP_VERSION

LDAP_VERSION is an optional environment variable for running an LDAP sample program. It specifies the version of the LDAP protocol to be used, and can be either 2 or 3. Most LDAP servers now support version 3 of the protocol; they all support the older version 2. This sample works equally well with either version of the protocol, and if it is not specified it defaults to version 2.

MQ_CHANNEL_SUPPRESS_INTERVAL

The MQ_CHANNEL_SUPPRESS_INTERVAL environment variable specifies the time interval, in seconds, during which the messages defined with MQ_CHANNEL_SUPPRESS_MSGS are to be suppressed from being written to the error log, together with the number of times that a message will be allowed to occur during the specified time interval before being suppressed. The default value is 60,5 which means that any further occurrences of a given message are suppressed after the first five occurrences of that message in a 60 second interval. For more information, see Suppressing channel error messages from error logs on Multiplatforms.

The MQ_CHANNEL_SUPPRESS_INTERVAL environment variable is comparable to SuppressInterval in the qm.ini file.

MQ_CHANNEL_SUPPRESS_MSGS

The MQ_CHANNEL_SUPPRESS_MSGS environment variable suppresses channel error messages in the error log. You can specify a list of messages that are suppressed. MQ_CHANNEL_SUPPRESS_MSGS is used in conjunction with MQ_CHANNEL_SUPPRESS_INTERVAL, which specifies the number of times that each message appears before being suppressed and the length of time that messages are suppressed for. For more information, see Suppressing channel error messages from error logs on Multiplatforms.

The MQ_CHANNEL_SUPPRESS_MSGS environment variable is comparable to SuppressMessage in the qm.ini file, except that you can suppress any channel message by using the environment variable, whereas there is a restrictive list for the qm.ini method.

MQ_CONNECT_TYPE

On Multiplatforms, you can use the MQ_CONNECT_TYPE environment variable in combination with the type of binding specified in the Options field of the MQCNO structure that is used on an MQCONNX call. MQ_CONNECT_TYPE only has any effect for STANDARD bindings. For other bindings, MQ_CONNECT_TYPE is ignored.

For more information, see Use of MQCONNX call options with MQ_CONNECT_TYPE.

MQ_CROSS_QUEUE_ORDER_ALL

When you set the MQ_CROSS_QUEUE_ORDER_ALL environment variable to a non-zero value, the message put order is maintained in a unit of work. This means that, if messages in a Unit of Work (UoW) are put onto multiple queues (for example, Q1, then Q2), when an MQCMIT is issued, the messages are delivered and made available in the same queue order in which they were PUT.

In a multi-queue manager environment, MQ_CROSS_QUEUE_ORDER_ALL must exist and have a non-empty value on both the sending and receiving side before each queue manager is started.

MQ_EPHEMERAL_PREFIX

The MQ_EPHEMERAL_PREFIX environment variable specifies the path to the queue manager's ephemeral directory, within which ephemeral queue manager data is kept, while the queue manager is running.

As an alternative to changing the ephemeral prefix by changing the EphemeralPrefix attribute in the DefaultEphemeralPrefix attribute of the AllQueueManagers stanza of the mqs.ini file, you can use the environment variable MQ_EPHEMERAL_PREFIX to override the EphemeralPrefix for the crtmqm command. For more information, see Configurable ephemeral directory.

MQ_FILE_PATH

HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere MQ\Installation\InstallationName\FilePath

For more information, see setmqenv (set IBM MQ environment) and crtmqenv (create IBM MQ environment).

MQ_JAVA_DATA_PATH

The MQ_JAVA_DATA_PATH environment variable specifies the directory for log and trace output for the IBM MQ classes for JMS and IBM MQ classes for Jakarta Messaging and IBM MQ classes for Java. It is used by the scripts provided with IBM MQ classes for JMS and IBM MQ classes for Jakarta Messaging and IBM MQ classes for Java.

For more information, see Setting environment variables for IBM MQ classes for JMS/Jakarta Messaging and Environment variables relevant to IBM MQ classes for Java.

MQ_JAVA_INSTALL_PATH

The MQ_JAVA_INSTALL_PATH environment variable specifies the directory where the IBM MQ classes for JMS and IBM MQ classes for Jakarta Messaging as shown in What is installed for IBM MQ classes for JMS, and the IBM MQ classes for Java as shown in IBM MQ classes for Java installation directories are installed.

For more information, see Setting environment variables for IBM MQ classes for JMS/Jakarta Messaging and Environment variables relevant to IBM MQ classes for Java.

MQ_JAVA_LIB_PATH

The MQ_JAVA_LIB_PATH environment variable specifies the directory where the IBM MQ classes for JMS and IBM MQ classes for Jakarta Messaging, and the IBM MQ classes for Java libraries are stored. Some scripts, for example, IVTRun, that are supplied with the IBM MQ classes for JMS and IBM MQ classes for Jakarta Messaging or the IBM MQ classes for Java use this environment variable.

For more information, see Setting environment variables for IBM MQ classes for JMS/Jakarta Messaging and Environment variables relevant to IBM MQ classes for Java.

MQ_OVERRIDE_DATA_PATH

You can use the MQ_OVERRIDE_DATA_PATH environment variable to change the default directory of the IBM MQ data path.

MQ_SET_NODELAYACK

The MQ_SET_NODELAYACK environment variable switches off TCP delayed acknowledgment on AIX.

When you set this environment variable, the setting switches off TCP delayed acknowledgment by calling the operating system's setsockopt call with the TCP_NODELAYACK option. Only AIX supports this function, so the MQ_SET_NODELAYACK environment variable only has an effect on AIX.

MQ_USER_NAME

You can use the MQ_USER_NAME environment variable to allow an unregistered installation on Linux to choose the name of an unnamed user. This is needed, for example, to use publish/subscribe hierarchies in OpenShift.

The value of MQ_USER_NAME must not match a pre-existing user on the system, and must be less than or equal to 12 bytes.

MQAPI_TRACE_LOGFILE

The sample API exit program generates an MQI trace to a user-specified file with a prefix that is defined in the MQAPI_TRACE_LOGFILE environment variable.

For more information, see The API exit sample program.

MQAPPLNAME

If the application name has not yet been chosen, you can use the MQAPPLNAME environment variable as the name to be used to identify the connection to a queue manager. Only the first 28 characters are used, and they must not be all blanks or nulls.

For more information, see Using the application name in supported programming languages.

MQCCSID

The MQCCSID environment variable specifies the coded character set number to be used and overrides the CCSID value with which the server has been configured. MQCCSID can be used to override the native CCSID of an application and specify the coded character set number to be used, for example if the native CCSID is an unsupported CCSID or is not the required CCSID.

For more information, see Choosing client or server CCSID.

MQCCDTURL

IBM MQ supports retrieving a CCDT from a file, ftp, or http URL. However, MQCCDTURL only accepts a URL value. It does not accept the existing local file system directory format.

export MQCCDTURL=file:///var/mqm/qmgrs/QMGR/@ipcc/MYCHL.TAB

export MQCHLLIB=/var/mqm/qmgrs/QMGR/@ipcc
export MQCHLTAB=MYCHL.TAB

set MQCCDTURL=file:/c:/mq-channels/CCDT-QMGR1.json

set MQCHLLIB=C:\mq-channels
set MQCHLTAB=CCDT-QMGR1.json

For more information, see URL access to the CCDT.

MQCERTLABL

The MQCERTLABL environment variable defines the certificate label of a channel definition for IBM MQ to use to locate a personal certificate that is sent during a TLS handshake.

For more information, see Digital certificate labels, understanding the requirements.

MQCERTVPOL

The MQCERTVPOL environment variable specifies the type of certificate validation policy to be used. This environment variable overrides the CertificateValPolicy attribute in the SSL stanza of the client configuration file.

For more information, see Certificate validation policies in IBM MQ and Configuring certificate validation policies in IBM MQ.

MQCHLLIB

The MQCHLLIB environment variable specifies the directory path to the file that contains the client channel definition table (CCDT). The file is created on the server, but can be copied across to the IBM MQ MQI client workstation.

For more information, see Locations for the CCDT, URL access to the CCDT, and Connecting client applications to queue managers using environment variables.

MQCHLTAB

The MQCHLTAB environment variable specifies the name of the file that contains the client channel definition table (CCDT). The default file name is AMQCLCHL.TAB.

SET MQCHLTAB=ccdf1.tab

In the same way as for the client, the MQCHLTAB environment variable on the server specifies the name of the client channel definition table.

For more information, see Locations for the CCDT, URL access to the CCDT, and Connecting client applications to queue managers using environment variables.

MQCLNTCF

The MQCLNTCF environment variable specifies the location of the IBM MQ MQI client configuration file. This file contains configuration information that is used by IBM MQ MQI clients.

You can use the MQCLNTCF environment variable to modify the file path of the mqclient.ini file.

The format of this environment variable is a full URL. This means that the file name might not necessarily be mqclient.ini, which facilitates placing the file on a network attached file-system. For more information, see IBM MQ MQI client configuration file, mqclient.ini and Location of the client configuration file.

MQDOTNET_TRACE_ON

The MQDOTNET_TRACE_ON environment variable is used to enable trace for IBM MQ .NET redistributable clients. Values equal to and less than 0 do not enable trace, 1 enables default trace and values greater than 1 enable detail tracing.

For more information, see Tracing IBM MQ .NET applications and Tracing IBM MQ .NET applications using environment variables.

MQIPADDRV

The MQIPADDRV environment variable specifies which IP protocol to use for a channel connection. It has the possible string values of "MQIPADDR_IPV4" or "MQIPADDR_IPV6". These values have the same meanings as IPv4 and IPv6 in ALTER QMGR IPADDRV and the IPAddressVersion attribute of the TCP stanza of the client configuration file. If the environment variable is not set, "MQIPADDR_IPV4" is assumed.

MQKEYRPWD

When you set the MQKEYRPWD environment variable, it specifies the password for the key repository that holds the digital certificate belonging to the user. If MQKEYRPWD is used, you must encrypt the password before you set the value of the environment variable.

There is no default value for this environment variable.

For more information, see

• Supplying the key repository password for an IBM MQ MQI client on AIX, Linux, and Windows and Encrypting the key repository password
• Supplying the key repository password for an IBM MQ MQI client on IBM i and Encrypting the key repository password.

MQLICENSE

On Linux systems, you can use the MQLICENSE environment variable to accept or view an IBM MQ license after you install the product.

For more information about why you might want or need to do this, see Accepting the license on IBM MQ for Linux

export MQLICENSE=accept

export MQLICENSE=view

MQMAXERRORLOGSIZE

The MQMAXERRORLOGSIZE environment variable specifies the size of the queue manager error log that is copied to the backup.

For more information, see Using error logs.

MQNAME

The MQNAME environment variable specifies the local NetBIOS name that the IBM MQ processes can use. A NetBIOS connection applies only to a client and server running Windows.

SET MQNAME=Your_env_Name

SET MQNAME=CLIENT1

Some NetBIOS implementations require a unique name, set by MQNAME, for each application if you are running multiple IBM MQ applications simultaneously on the IBM MQ MQI client.

For more information, see Defining the IBM MQ local NetBIOS name.

MQNOREMPOOL

When you set the MQNOREMPOOL environment variable, it switches off channel pooling and causes channels to run as threads of the listener.

For more information, see MCATYPE (Message channel agent type).

MQPSE_TRACE_LOGFILE

You use the MQPSE_TRACE_LOGFILE environment variable when you run the Publish Exit Sample Program AMQSPSE0, which is a sample C program of an exit to intercept a publication before it is delivered to a subscriber. In the application process to be traced, this environment variable describes where the trace files must be written to.

For more information, see The Publish Exit sample program.

MQS_AMSCRED_KEYFILE

You can use the MQS_AMSCRED_KEYFILE environment variable to override or provide the initial key file to use at run time of IBM MQ Advanced Message Security (AMS) applications, or when you are protecting a keystore configuration file by using the runamscred command.

For more information, see Using keystores and certificates with AMS and Protecting passwords in IBM MQ component configuration files.

MQS_DISABLE_ALL_INTERCEPT

For more information, see Disabling Advanced Message Security at the client.

MQS_IPC_HOST

Since IPC file system objects have to be distinguished by system, a subdirectory for each system that the queue manager runs on is added to the directory path. If the generated value of the host name creates a problem, you can set the host name by using the MQS_IPC_HOST environment variable.

For more information, see Sharing IBM MQ files on Multiplatforms.

MQS_KEYSTORE_CONF

The MQS_KEYSTORE_CONF environment variable specifies the location of the keystore configuration file for IBM MQ Advanced Message Security (AMS), if the file is not in the default location of home_directory/.mqs/keystore.conf.

For more information, see Using keystores and certificates with AMS.

If you are having problems on Managed File Transfer, see Troubleshooting when MFT does not read keystore properties for AMS.

MQS_MQI_KEYFILE

When you set the MQS_MQI_KEYFILE environment variable, it specifies the location of an initial key file which contains the initial key to be used for password protection operations. If the initial key file is not specified, the default initial key is used by the IBM MQ password protection system.

For more information, see Supplying an initial key for an IBM MQ MQI client on AIX, Linux, and Windows and Supplying an initial key for an IBM MQ MQI client on IBM i.

MQS_SSLCRYP_KEYFILE

The MQS_SSLCRYP_KEYFILE environment variable is an alternative way of specifying the full path and name of the file containing the initial key used to encrypt the password in the PKCS #11 cryptographic hardware configuration string, instead of specifying it with the SSLCryptoHardwareKeyFile attribute in the SSL stanza of the qm.ini. MQS_SSLCRYP_KEYFILE has a higher priority than the qm.ini file so its value takes precedence over any other value. For more information, see IBM MQ clients using cryptographic hardware.

MQS_TRACE_OPTIONS

For more information, see Tracing on AIX and Linux.

MQSERVER

If you use the MQSERVER environment variable to define the channel between your IBM MQ MQI client machine and a server machine, this is the only channel available to your application, and no reference is made to the client channel definition table (CCDT).

For more information, see Creating a client-connection channel on the IBM MQ MQI client using MQSERVER.

MQSNOAUT

When you set the MQSNOAUT environment variable to any value it disables the object authority manager (OAM) and prevents any security checking. This might be suitable for a test environment. This includes both authorization and connection authentication functionality. TLS, Channel Authentication Records and Security Exits are unaffected.

For more information, see Preventing security access checks on AIX, Linux, and Windows systems.

MQSPREFIX

As an alternative to changing the default prefix, you can use the MQSPREFIX environment variable to override the DefaultPrefix for the crtmqm command.

For more information, see IBM MQ file names and AllQueueManagers stanza of the mqs.ini file.

MQSSLCRYP

The MQSSLCRYP environment variable holds a parameter string that you can use to configure the cryptographic hardware present on the system.

The permitted values are the same as for the SSLCryptoHardware field in the SSL stanza of the client configuration file.

For more information, see Configuring for cryptographic hardware on AIX, Linux, and Windows and IBM MQ clients that use cryptographic hardware in Protecting passwords in IBM MQ component configuration files.

MQSSLFIPS

The MQSSLFIPS environment variable specifies whether only FIPS-certified algorithms are to be used if cryptography is carried out in IBM MQ. You can set this environment variable to YES or NO The default is NO. These values are the same as for the SSLFIPS parameter of the ALTER QMGR command.

The use of FIPS-certified algorithms is affected by the use of cryptographic hardware. For more information, see Specifying that only FIPS-certified CipherSpecs are used at run time on the MQI client.

MQSSLKEYR

The MQSSLKEYR environment variable specifies the location of the key repository that holds the digital certificate belonging to the user.

Specify the full path and the file name of the key repository. If the file suffix is not specified, it is assumed to be .kdb.

There is no default value for this environment variable.

For more information, see the SSLKEYR parameter of the ALTER QMGR command.

MQSSLPROXY

The MQSSLPROXY environment variable specifies the host name and port number of the HTTP proxy server to be used by GSKit for OCSP checks.

The string that you specify with MQSSLPROXY can be either the host name or network address of the HTTP Proxy server that is to be used by GSKit for OCSP checks. This address can be followed by an optional port number, enclosed in parentheses. If you do not specify the port number, the default HTTP port, 80, is used.

For example, on AIX and Linux systems, you can use the one of the following commands:

• 
  export MQSSLPROXY="proxy.example.com(80)"
  

• 
  export MQSSLPROXY="127.0.0.1"
  

For more information, see Working with Online Certificate Status Protocol (OCSP).

MQSSLRESET

The MQSSLRESET environment variable specifies the number of unencrypted bytes sent and received on a TLS channel before the TLS secret key is renegotiated. It can be set to an integer in the range 0 through 999 999 999. The default is 0, which indicates that secret keys are never renegotiated. If you specify a TLS secret key reset count in the range 1 byte through 32 KB, TLS channels use a secret key reset count of 32 KB. This secret reset count is to avoid excessive key resets which would occur for small TLS secret key reset values.

For more information, see Resetting SSL and TLS secret keys.

MQSUITEB

You can configure IBM MQ to operate in compliance with the NSA Suite B standard on AIX, Linux, and Windows platforms.

You can specify multiple values using a comma separated list. Using the value NONE with any other value is invalid.

For more information, see Configuring IBM MQ for Suite B.

MQTCPTIMEOUT

The MQTCPTIMEOUT environment variable specifies how long IBM MQ waits for a TCP connect call.

ODQ_MSG

If you use a dead-letter queue handler that is different from runmqdlq, the source of the sample, amqsdlq, is available for you to use as your base. The sample is like the dead-letter handler provided within the product but trace and error reporting are different. Use the ODQ_MSG environment variable to set the name of the file containing error and information messages. The file that is provided is called amqsdlq.msg.

For more information, see Dead-letter queue handler sample.

ODQ_TRACE

If you use a dead-letter queue handler that is different from runmqdlq, the source of the sample, amqsdlq, is available for you to use as your base. The sample is like the dead-letter handler provided within the product but trace and error reporting are different. To enable tracing, set the ODQ_TRACE environment variable to YES or yes.

For more information, see Dead-letter queue handler sample.

WCF_TRACE_ON

Two different trace methods are available for the WCF custom channel. These two trace methods are activated either independently or together. Each method produces its own trace file, so when both trace methods have been activated, two trace output files are generated. There are four combinations for enabling and disabling the two different trace methods. As well as these combinations to enable WCF trace, the XMS .NET trace can be enabled by using the WCF_TRACE_ON environment variable.

For more information, see Tracing the WCF custom channel for IBM MQ.

WMQSOAP_HOME

The WMQSOAP_HOME environment variable is used when completing additional configuration steps after the .NET SOAP over JMS service hosting environment is correctly installed and configured in IBM MQ. It is accessible from a local queue manager.

For more information, see WCF client to a .NET service hosted by IBM MQ sample and WCF client to an Axis Java service hosted by IBM MQ sample.

XMS_TRACE_ON, XMS_TRACE_FILE_NUMBER, XMS_TRACE_FILE_PATH, XMS_TRACE_FILE_SIZE, XMS_TRACE_FORMAT, and XMS_TRACE_SPECIFICATION

If you are using IBM MQ classes for XMS .NET Framework, you can configure trace from an application configuration file as well as from the XMS environment variables. If you are using IBM MQ classes for XMS .NET (.NET Standard and .NET 6 libraries), you must configure trace from the XMS environment variables. Trace is normally used under the guidance of IBM Support.

For more information, see Tracing XMS .NET applications and Tracing XMS .NET applications using XMS environment variables.