WebSphere MQ for AIX configuration

Notes:

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

2. If installation fails as a result of insufficient space in the file system you can increase the size as follows, using the command smit C sna. (Use df to display the current status of the file system. This will indicate the logical volume that is full.)

   -- Physical and Logical Storage
     -- File Systems
       -- Add / Change / Show / Delete File Systems
         -- Journaled File Systems
           -- Change/Show Characteristics of a Journaled File System
   

3. Start any channel using the command:

   runmqchl -c channel.name
   

4. Sample programs are installed in /usr/mqm/samp.

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

6. You can start an AIX trace of the WebSphere MQ components using the command:

   trace -a -j30D,30E -o trace.file
   

   You can stop AIX trace by entering:

   trcstop
   

   Format the trace report using the command:

   trcrpt -t /usr/mqm/lib/amqtrc.fmt trace.file > trace.report
   

7. 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.

Basic configuration

1. Create the queue manager from the AIX command line using the command:

   crtmqm -u dlqname -q aix
   

   where:

   aix

   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 AIX command line using the command:

   strmqm aix
   

   where aix is the name given to the queue manager when it was created.
3. Start runmqsc from the AIX command line and use it to create the undeliverable message queue by entering the command:

   def ql (dlqname)
   

   where dlqname is the name given to the undeliverable message queue when the queue manager was created.

Channel configuration

The following section details the configuration to be performed on the AIX queue manager to implement the channel described in Figure 32.

In each case the MQSC command is shown. Either start runmqsc from an AIX command line and enter each command in turn, or build the commands into a command file.

Examples are given for connecting WebSphere MQ for AIX 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 22. Configuration worksheet for WebSphere MQ for AIX

WebSphere MQ for AIX sender-channel definitions using 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 (AIX.OS2.SNA) chltype(sdr) +          (G)
    trptype(lu62) +
    conname('OS2CPIC') +                      (17)
    xmitq(OS2) +                              (F)
    replace

WebSphere MQ for AIX receiver-channel definitions using SNA

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

WebSphere MQ for AIX TPN setup

During the AIX Communications Server configuration process, an LU 6.2 TPN profile was created, which contained the full path to a TP executable. In the example the file was called u/interops/AIX.crs6a. You can choose a name, but you are recommended to include the name of your queue manager in it. The contents of the executable file must be:

#!/bin/sh
/opt/mqm/bin/amqcrs6a -m aix

where aix is the queue manager name ((A)). After creating this file, enable it for execution by running the command:

    chmod 755 /u/interops/AIX.crs6a

As an alternative to creating an executable file, you can specify the path on the Add LU 6.2 TPN Profile panel, using command line parameters.

Specifying a path in one of these two ways ensures that SNA receiver channels activate correctly when a sender channel initiates a conversation.

WebSphere MQ for AIX 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 (AIX.OS2.TCP) chltype(sdr) +          (H)
    trptype(tcp) +
    conname(remote_tcpip_hostname) +
    xmitq(OS2) +                              (F)
    replace

WebSphere MQ for AIX receiver-channel definitions using TCP

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

WebSphere MQ for AIX sender-channel definitions using UDP

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 (AIX.OS2.UDP) chltype(sdr) +          (H)
    trptype(udp) +
    conname(remote_udpip_hostname) +
    xmitq(OS2) +                              (F)
    replace

WebSphere MQ for AIX receiver-channel definitions using UDP

def ql (AIX.LOCALQ) replace                   (B)
 
def chl (OS2.AIX.UDP) chltype(rcvr) +         (J)
    trptype(udp) +
    replace