WebSphere MQ for Solaris configuration

Before beginning the installation process ensure that you have first created the mqm user and group, and set the password.

Start any channel using the command: 

runmqchl -c channel.name

Notes:

  1. Sample programs are installed in /opt/mqm/samp.

  2. Error logs are stored in /var/mqm/qmgrs/qmgrname/errors.

  3. When you are using the command interpreter runmqsc to enter administration commands, a + at the end of a line indicates that the next line is a continuation. Ensure that there is a space between the last parameter and the continuation character.

  4. For an SNA or LU6.2 channel, if you experience an error when you try to load the communications library, probably file liblu62.so cannot be found. A likely solution to this problem is to add its location, which is probably /opt/SUNWlu62, to LD_LIBRARY_PATH.

 

Basic configuration

  1. Create the queue manager from the UNIX prompt using the command: 
    crtmqm -u dlqname -q solaris
    where:

    solaris
    Is the name of the queue manager

    -q
    Indicates that this is to become the default queue manager

    -u dlqname
    Specifies the name of the undeliverable message queue

    This command creates a queue manager and a set of default objects.

  2. Start the queue manager from the UNIX prompt using the command: 
    strmqm solaris
    where solaris is the name given to the queue manager when it was created.

 

Channel configuration

The following section details the configuration to be performed on the Solaris queue manager to implement the channel.

The MQSC command to create each object is shown. Either start runmqsc from a UNIX prompt and enter each command in turn, or build the commands into a command file.

Examples are given for connecting WebSphere MQ for Solaris and MQSeries for OS/2 Warp. If you wish to connect to another WebSphere MQ product use the appropriate set of values from the table in place of those for OS/2.

Note:
The words in bold are user-specified and reflect the names of WebSphere MQ objects used throughout these examples. If you change the names used here, ensure that you also change the other references made to these objects throughout this book. All others are keywords and should be entered as shown.


Table 30. Configuration worksheet for WebSphere MQ for Solaris

ID Parameter Name Reference Example Used User Value
Definition for local node
(A) Queue Manager Name SOLARIS
(B) Local queue name SOLARIS.LOCALQ
Connection to MQSeries for OS/2 Warp

The values in this section of the table must match those used in Table 16, as indicated.
(C) Remote queue manager name (A) OS2
(D) Remote queue name OS2.REMOTEQ
(E) Queue name at remote system (B) OS2.LOCALQ
(F) Transmission queue name OS2
(G) Sender (SNA) channel name SOLARIS.OS2.SNA
(H) Sender (TCP/IP) channel name SOLARIS.OS2.TCP
(I) Receiver (SNA) channel name (G) OS2.SOLARIS.SNA
(J) Receiver (TCP/IP) channel name (H) OS2.SOLARIS.TCP
Connection to WebSphere MQ for Windows

The values in this section of the table must match those used in Table 18, as indicated.
(C) Remote queue manager name (A) WINNT
(D) Remote queue name WINNT.REMOTEQ
(E) Queue name at remote system (B) WINNT.LOCALQ
(F) Transmission queue name WINNT
(G) Sender (SNA) channel name SOLARIS.WINNT.SNA
(H) Sender (TCP/IP) channel name SOLARIS.WINNT.TCP
(I) Receiver (SNA) channel name (G) WINNT.SOLARIS.SNA
(J) Receiver (TCP) channel name (H) WINNT.SOLARIS.TCP
Connection to WebSphere MQ for AIX

The values in this section of the table must match those used in Table 22, as indicated.
(C) Remote queue manager name (A) AIX
(D) Remote queue name AIX.REMOTEQ
(E) Queue name at remote system (B) AIX.LOCALQ
(F) Transmission queue name AIX
(G) Sender (SNA) channel name SOLARIS.AIX.SNA
(H) Sender (TCP) channel name SOLARIS.AIX.TCP
(I) Receiver (SNA) channel name (G) AIX.SOLARIS.SNA
(J) Receiver (TCP) channel name (H) AIX.SOLARIS.TCP
Connection to MQSeries for Compaq Tru64 UNIX

The values in this section of the table must match those used in Table 23, as indicated.
(C) Remote queue manager name (A) DECUX
(D) Remote queue name DECUX.REMOTEQ
(E) Queue name at remote system (B) DECUX.LOCALQ
(F) Transmission queue name DECUX
(H) Sender (TCP) channel name DECUX.SOLARIS.TCP
(J) Receiver (TCP) channel name (H) SOLARIS.DECUX.TCP
Connection to WebSphere MQ for HP-UX

The values in this section of the table must match those used in Table 25, as indicated.
(C) Remote queue manager name (A) HPUX
(D) Remote queue name HPUX.REMOTEQ
(E) Queue name at remote system (B) HPUX.LOCALQ
(F) Transmission queue name HPUX
(G) Sender (SNA) channel name SOLARIS.HPUX.SNA
(H) Sender (TCP) channel name SOLARIS.HPUX.TCP
(I) Receiver (SNA) channel name (G) HPUX.SOLARIS.SNA
(J) Receiver (TCP/IP) channel name (H) HPUX.SOLARIS.TCP
Connection to MQSeries for AT&T GIS UNIX

The values in this section of the table must match those used in Table 27, as indicated.
(C) Remote queue manager name (A) GIS
(D) Remote queue name GIS.REMOTEQ
(E) Queue name at remote system (B) GIS.LOCALQ
(F) Transmission queue name GIS
(G) Sender (SNA) channel name SOLARIS.GIS.SNA
(H) Sender (TCP/IP) channel name SOLARIS.GIS.TCP
(I) Receiver (SNA) channel name (G) GIS.SOLARIS.SNA
(J) Receiver (TCP/IP) channel name (H) GIS.SOLARIS.TCP
Connection to WebSphere MQ for Linux

The values in this section of the table must match those used in Table 32, as indicated.
(C) Remote queue manager name (A) LINUX
(D) Remote queue name LINUX.REMOTEQ
(E) Queue name at remote system (B) LINUX.LOCALQ
(F) Transmission queue name LINUX
(G) Sender (SNA) channel name SOLARIS.LINUX.SNA
(H) Sender (TCP/IP) channel name SOLARIS.LINUX.TCP
(I) Receiver (SNA) channel name (G) LINUX.SOLARIS.SNA
(J) Receiver (TCP/IP) channel name (H) LINUX.SOLARIS.TCP
Connection to WebSphere MQ for iSeries

The values in this section of the table must match those used in Table 51, as indicated.
(C) Remote queue manager name (A) AS400
(D) Remote queue name AS400.REMOTEQ
(E) Queue name at remote system (B) AS400.LOCALQ
(F) Transmission queue name AS400
(G) Sender (SNA) channel name SOLARIS.AS400.SNA
(H) Sender (TCP) channel name SOLARIS.AS400.TCP
(I) Receiver (SNA) channel name (G) AS400.SOLARIS.SNA
(J) Receiver (TCP) channel name (H) AS400.SOLARIS.TCP
Connection to WebSphere MQ for z/OS without CICS

The values in this section of the table must match those used in Table 36, as indicated.
(C) Remote queue manager name (A) MVS
(D) Remote queue name MVS.REMOTEQ
(E) Queue name at remote system (B) MVS.LOCALQ
(F) Transmission queue name MVS
(G) Sender (SNA) channel name SOLARIS.MVS.SNA
(H) Sender (TCP) channel name SOLARIS.MVS.TCP
(I) Receiver (SNA) channel name (G) MVS.SOLARIS.SNA
(J) Receiver (TCP) channel name (H) MVS.SOLARIS.TCP
Connection to MQSeries for VSE/ESA

The values in this section of the table must match those used in Table 53, as indicated.
(C) Remote queue manager name (A) VSE
(D) Remote queue name VSE.REMOTEQ
(E) Queue name at remote system (B) VSE.LOCALQ
(F) Transmission queue name VSE
(G) Sender channel name SOLARIS.VSE.SNA
(I) Receiver channel name (G) VSE.SOLARIS.SNA

 

WebSphere MQ for Solaris sender-channel definitions using SNA using SunLink Version 9.1

def ql (OS2) +                                    (F)
    usage(xmitq) +
    replace
 
def qr (OS2.REMOTEQ) +                            (D)
    rname(OS2.LOCALQ) +                           (E)
    rqmname(OS2) +                                (C)
    xmitq(OS2) +                                  (F)
    replace
 
def chl (SOLARIS.OS2.SNA) chltype(sdr) +          (G)
    trptype(lu62) +
    conname('/home/mqstart/OS2CPIC') +            (14)
    xmitq(OS2) +                                  (F)
    replace

 

WebSphere MQ for Solaris sender-channel definitions using SNAP-IX SNA

def ql (OS2) +                                    (F)
    usage(xmitq) +
    replace
 
def qr (OS2.REMOTEQ) +                            (D)
    rname(OS2.LOCALQ) +                           (E)
    rqmname(OS2) +                                (C)
    xmitq(OS2) +                                  (F)
    replace
 
def chl (SOLARIS.OS2.SNA) chltype(sdr) +          (G)
    trptype(lu62) +
    conname('OS2CPIC') +            (14)
    xmitq(OS2) +                                  (F)
    replace

 

WebSphere MQ for Solaris receiver-channel definitions using SNA

def ql (SOLARIS.LOCALQ) replace                   (B)
 
def chl (OS2.SOLARIS.SNA) chltype(rcvr) +         (I)
    trptype(lu62) +
    replace

 

WebSphere MQ for Solaris sender-channel definitions using TCP

def ql (OS2) +                                    (F)
    usage(xmitq) +
    replace
 
def qr (OS2.REMOTEQ) +                            (D)
    rname(OS2.LOCALQ) +                           (E)
    rqmname(OS2) +                                (C)
    xmitq(OS2) +                                  (F)
    replace
 
def chl (SOLARIS.OS2.TCP) chltype(sdr) +          (H)
    trptype(tcp) +
    conname(remote_tcpip_hostname) +
    xmitq(OS2) +                                  (F)
    replace

 

WebSphere MQ for Solaris receiver-channel definitions using TCP/IP

def ql (SOLARIS.LOCALQ) replace                   (B)
 
def chl (OS2.SOLARIS.TCP) chltype(rcvr) +         (J)
    trptype(tcp) +
    replace

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.