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.

We cannot use MQSERVER to define a TLS channel or a channel with channel exits. For details of how to define a TLS channel, see Protecting channels with TLS.

ConnectionName must be a fully-qualified network name. The ChannelName cannot contain the forward slash (/) character because this character is used to separate the channel name, transport type, and connection name. When the MQSERVER environment variable is used to define a client channel, a maximum message length (MAXMSGL) of 100 MB is used. Therefore the maximum message size in effect for the channel is the value specified in the SVRCONN channel at the server.

To set this variable use one of these commands:

  • On Windows: 
    SET  MQSERVER=SYSTEM.DEF.SVRCONN/TCP/AMACHINE.ACOMPANY.COM(1414)
  • On UNIX and Linux : 
    export  MQSERVER='SYSTEM.DEF.SVRCONN/TCP/AMACHINE.ACOMPANY.COM(1414)'
  • On IBM i: 
    ADDENVVAR ENVVAR(MQSERVER) VALUE('SYSTEM.DEF.SVRCONN/TCP/AMACHINE.ACOMPANY.COM(1414)')

TransportType can be one of the following values, depending on the IBM MQ client platform:

  • LU62
  • TCP
  • NETBIOS
  • SPX

ConnectionName can be a comma-separated list of connection names. The connection names in the list are used in a similar way to multiple connections in a client connection table. The ConnectionName list might be used as an alternative to queue manager groups to specify multiple connections for the client to try. If we are configuring a multi-instance queue manager, you might use a ConnectionName list to specify different queue manager instances.

  • TCP/IP default port
    By default, for TCP/IP, IBM MQ assumes that the channel will be connected to port 1414.
  • SPX default socket
    By default, for SPX, IBM MQ assumes that the channel will be connected to socket 5E86.
  • Use MQSERVER
    If we use the MQSERVER environment variable to define the channel between the IBM MQ MQI client machine and a server machine, this is the only channel available to the application, and no reference is made to the client channel definition table (CCDT).

Parent topic: Use IBM MQ environment variables