WebSphere MQ for HP-UX 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.

Basic configuration

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

    hpux
    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. It sets the DEADQ attribute of the queue manager but does not create the undeliverable message queue.

  2. Start the queue manager from the UNIX prompt using the command:
    strmqm hpux
    
    where hpux 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 HP-UX queue manager to implement the channel described in Figure 32.

In each case the MQSC command 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 HP-UX and MQSeries for OS/2 Warp. If you wish 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 25. Configuration worksheet for WebSphere MQ for HP-UX

ID Parameter Name Reference Example Used User Value
Definition for local node
(A) Queue Manager Name
HPUX
(B) Local queue name
HPUX.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
HPUX.OS2.SNA
(H) Sender (TCP/IP) channel name
HPUX.OS2.TCP
(I) Receiver (SNA) channel name (G) OS2.HPUX.SNA
(J) Receiver (TCP/IP) channel name (H) OS2.HPUX.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
HPUX.WINNT.SNA
(H) Sender (TCP/IP) channel name
HPUX.WINNT.TCP
(I) Receiver (SNA) channel name (G) WINNT.HPUX.SNA
(J) Receiver (TCP) channel name (H) WINNT.HPUX.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
HPUX.AIX.SNA
(H) Sender (TCP) channel name
HPUX.AIX.TCP
(I) Receiver (SNA) channel name (G) AIX.HPUX.SNA
(J) Receiver (TCP) channel name (H) AIX.HPUX.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.HPUX.TCP
(J) Receiver (TCP) channel name (H) HPUX.DECUX.TCP
Connection to WebSphere MQ for z/OS without CICS

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
HPUX.GIS.SNA
(H) Sender (TCP) channel name
HPUX.GIS.TCP
(I) Receiver (SNA) channel name (G) GIS.HPUX.SNA
(J) Receiver (TCP) channel name (H) GIS.HPUX.TCP
Connection to WebSphere MQ for Solaris

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

(C) Remote queue manager name
SOLARIS
(D) Remote queue name
SOLARIS.REMOTEQ
(E) Queue name at remote system (B) SOLARIS.LOCALQ
(F) Transmission queue name
SOLARIS
(G) Sender (SNA) channel name
HPUX.SOLARIS.SNA
(H) Sender (TCP/IP) channel name
HPUX.SOLARIS.TCP
(I) Receiver (SNA) channel name (G) SOLARIS.HPUX.SNA
(J) Receiver (TCP/IP) channel name (H) SOLARIS.HPUX.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
HPUX.AS400.SNA
(H) Sender (TCP/IP) channel name
HPUX.AS400.TCP
(I) Receiver (SNA) channel name (G) AS400.HPUX.SNA
(J) Receiver (TCP) channel name (H) AS400.HPUX.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
HPUX.MVS.SNA
(H) Sender (TCP) channel name
HPUX.MVS.TCP
(I) Receiver (SNA) channel name (G) MVS.HPUX.SNA
(J) Receiver (TCP) channel name (H) MVS.HPUX.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
HPUX.VSE.SNA
(I) Receiver channel name (G) VSE.HPUX.SNA

WebSphere MQ for HP-UX 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 (HPUX.OS2.SNA) chltype(sdr) +          (G)
    trptype(lu62) +
    conname('OS2CPIC') +                       (16)
    xmitq(OS2) +                               (F)
    replace

WebSphere MQ for HP-UX receiver-channel definitions using SNA

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

WebSphere MQ for HP-UX invokable TP setup

This is not required for HP SNAplus2 Release 6.

During the HP SNAplus2 configuration process, you created an invokable TP definition, which points to an executable file. In the example, the file was called /users/interops/HPUX.crs6a. You can choose what you call this file, but you are recommended to include the name of your queue manager in the name. The contents of the executable file must be:

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

where hpux is the name of your queue manager (A).

This ensures that SNA receiver channels activate correctly when a sender channel initiates a conversation.

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

WebSphere MQ for HP-UX receiver-channel definitions using TCP/IP

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



© IBM Corporation 2002. All Rights Reserved