Set up the client workstation
Before you complete this task have completed, Set up the server workstation.
When a WebSphere MQ application is run on the WebSphere MQ client, the following information is required:
- The name of the MQI channel that connects the client to the server
- The communications protocol
- The address of the server
You provide this information by defining a client-connection channel with the name used for the server-connection channel defined on the server. This example uses the MQSERVER environment variable to define the client-connection channel.
- Before starting, use the ping command to check that your TCP/IP software is correctly configured, and that your WebSphere MQ client and server TCP/IP sessions have been initialized. From the client, enter:
ping server-hostname or ping n.n.n.nwhere
- server-hostname
- Is the host name of the server
- n.n.n.n
- Is the network address of the server
- Press Ctrl-C to stop the ping command.
- To create a client-connection channel, set the MQSERVER environment variable as follows:
export MQSERVER='CHANNEL1/TCP/server-hostname(port)'where
- CHANNEL1
- Is the name of the server-connection channel already defined on the server
- TCP
- Is the communications protocol.
- server-address
- Is the TCP/IP host name of the server.
- port
- Is optional and is the port number that the server is listening on, you specified this in step 6 of Set up the server workstation. If you do not give a port number, WebSphere MQ uses:
- The one specified in the qm.ini file.
- If no value is specified in the qm.ini file, WebSphere MQ uses the port number identified in the TCP/IP services file for the service name WebSphere MQ. If this entry in the services file does not exist, a default value of 1414 is used.
The client-connection channel and server listener program must use the same port number.
To continue with the verification process, see Testing communication between workstations.
Parent topic:
Verifying the client installation
hq10750_