Use IBM MQ environment variables
We can use commands to display the current settings or to reset the values of IBM MQ environment variables.
About this task
We can use environment variables in the following ways:
- To set the variables in the system profile to make a permanent change
- To issue a command from the command line to make a change for this session only
- To give one or more variables a particular value dependent on the application that is running, add commands to a command script file used by the application
For each environment variable, we can use commands to display the current setting or to reset the value of the variable. The available commands are listed in the subtopic links. These commands are available on all the IBM MQ MQI client platforms unless otherwise stated.
IBM MQ uses default values for those variables that you have not set.
Note: IBM MQ for z/OS does not support any IBM MQ environment variables. If we are using this platform as your server, see Client channel definition table for information about how the client channel definition table is generated on z/OS. We can still use the IBM MQ environment variables on your client platform.
Procedure
- On Windows, for each environment variable, use the following commands to display the current setting or to reset the value of a variable:
- To remove the value of an environment variable, use the following command:
SET MQSERVER=- To display the current setting of an environment variable, use the following command:
SET MQSERVER- To display all environment variables for the session, use the following command:
set
- On UNIX and Linux, for each environment variable, use the following commands to display the current setting or to reset the value of a variable:
- To remove the value of an environment variable, use the following command:
unset MQSERVER- To display the current setting of an environment variable, use the following command:
echo $MQSERVER- To display all environment variables for the session, use the following command:
set
- MQCCDTURL
MQCCDTURL provides the equivalent capability to setting a combination of the MQCHLLIB and MQCHLTAB environment variables.- MQCCSID
MQCCSID specifies the coded character set number to be used and overrides the CCSID value with which the server has been configured.- MQCERTLABL
MQCERTLABL specifies the certificate label of the channel definition.- MQCERTVPOL
MQCERTVPOL specifies the certificate validation policy used.- MQCHLLIB
MQCHLLIB specifies the directory path to the file containing 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.- MQCHLTAB
MQCHLTAB specifies the name of the file containing the client channel definition table (ccdt). The default file name is AMQCLCHL.TAB.- MQIPADDRV
MQIPADDRV 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. If it is not set, "MQIPADDR_IPv4" is assumed.- MQNAME
MQNAME specifies the local NetBIOS name that the IBM MQ processes can use.- MQSERVER
The MQSERVER environment variable is used to define a minimal channel. MQSERVER specifies the location of the IBM MQ server and the communication method to be used.- MQSSLCRYP
MQSSLCRYP holds a parameter string that allows you to configure the cryptographic hardware present on the system. The permitted values are the same as for the SSLCRYP parameter of the ALTER QMGR command.- MQSSLFIPS
MQSSLFIPS specifies whether only FIPS-certified algorithms are to be used if cryptography is carried out in IBM MQ. The values are the same as for the SSLFIPS parameter of the ALTER QMGR command.- MQSSLKEYR
MQSSLKEYR specifies the location of the key repository that holds the digital certificate belonging to the user, in stem format. Stem format means that it includes the full path and the file name without an extension.- MQSSLPROXY
MQSSLPROXY specifies the host name and port number of the HTTP proxy server to be used by GSKit for OCSP checks.- MQSSLRESET
MQSSLRESET represents the number of unencrypted bytes sent and received on a TLS channel before the secret key is renegotiated.- MQSUITEB
We can configure IBM MQ to operate in compliance with the NSA Suite B standard on UNIX, Linux, and Windows platforms.- MQTCPTIMEOUT
How long IBM MQ waits for a TCP connect call.Parent topic: Configure connections between the server and client
Related tasks
Related information