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 described in Figure 32.

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 iSeries

The values in this section of the table must match those used in Table 49, as indicated.

(C) Remote queue manager name
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 34, as indicated.

(C) Remote queue manager name
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 51, as indicated.

(C) Remote queue manager name
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



© IBM Corporation 2002. All Rights Reserved