Part 1. Introduction
Chapter 1. Concepts of intercommunication
What is intercommunication?
How does distributed queuing work?
Distributed queuing components
Message channels
Message channel agents
Transmission queues
Channel initiators and listeners
Channel-exit programs
Dead-letter queues
Remote queue definitions
How to get to the remote queue manager
Multi-hopping
Sharing channels
Using different channels
Using clustering
Chapter 2. Making your applications communicate
How to send a message to another queue manager
Defining the channels
Defining the queues
Sending the messages
Starting the channel
Triggering channels
Safety of messages
Fast, nonpersistent messages
Undelivered messages
Chapter 3. More about intercommunication
Addressing information
What are aliases?
Queue name resolution
Queue manager alias definitions
Outbound messages - remapping the queue manager name
Outbound messages - altering or specifying the transmission queue
Inbound messages - determining the destination
Reply-to queue alias definitions
What is a reply-to queue alias definition?
Reply-to queue name
Networks
Channel and transmission queue names
Network planner
Part 2. How intercommunication works
Chapter 4. WebSphere MQ distributed-messaging techniques
Message flow control
Queue names in transmission header
How to create queue manager and reply-to aliases
Putting messages on remote queues
More about name resolution
Choosing the transmission queue
Receiving messages
Receiving alias queue manager names
Passing messages through your system
Method 1: Using the incoming location name
Method 2: Using an alias for the queue manager
Method 3: Selecting a transmission queue
Using these methods
Separating message flows
Concentrating messages to diverse locations
Diverting message flows to another destination
Sending messages to a distribution list
Reply-to queue
Reply-to queue alias example
How the example works
How the queue manager makes use of the reply-to queue alias
Reply-to queue alias walk-through
Networking considerations
Return routing
Managing queue name translations
Channel message sequence numbering
Sequential retrieval of messages
Sequence of retrieval of fast, nonpersistent messages
Loopback testing
Chapter 5. DQM implementation
Functions of DQM
Message sending and receiving
Channel parameters
Channel status and sequence numbers
Channel control function
Preparing channels
Channel states
Adopting an MCA
Stopping and quiescing channels
Restarting stopped channels
In-doubt channels
Problem determination
What happens when a message cannot be delivered?
Initialization and configuration files
z/OS without CICS
z/OS using CICS
Windows systems
OS/2, Compaq OpenVMS Alpha, Compaq NonStop Kernel, iSeries, and UNIX systems
VSE/ESA
Data conversion
Writing your own message channel agents
Chapter 6. Channel attributes
Channel attributes and channel types
Channel attributes in alphabetical order
Alter date (ALTDATE)
Alter time (ALTTIME)
Auto start (AUTOSTART)
Batch Heartbeat Interval (BATCHHB)
Batch interval (BATCHINT)
Batch size (BATCHSZ)
Channel name (CHANNEL)
Channel type (CHLTYPE)
CICS profile name
Cluster (CLUSTER)
Cluster namelist (CLUSNL)
Connection name (CONNAME)
Convert message (CONVERT)
Description (DESCR)
Disconnect interval (DISCINT)
Heartbeat interval (HBINT)
KeepAlive Interval (KAINT)
Local Address (LOCLADDR)
Long retry count (LONGRTY)
Long retry interval (LONGTMR)
LU 6.2 mode name (MODENAME)
LU 6.2 transaction program name (TPNAME)
Maximum message length (MAXMSGL)
Maximum transmission size
Message channel agent name (MCANAME)
Message channel agent type (MCATYPE)
Message channel agent user identifier (MCAUSER)
Message exit name (MSGEXIT)
Message exit user data (MSGDATA)
Message-retry exit name (MREXIT)
Message-retry exit user data (MRDATA)
Message retry count (MRRTY)
Message retry interval (MRTMR)
Network-connection priority (NETPRTY)
Nonpersistent message speed (NPMSPEED)
Password (PASSWORD)
PUT authority (PUTAUT)
Queue manager name (QMNAME)
Receive exit name (RCVEXIT)
Receive exit user data (RCVDATA)
Security exit name (SCYEXIT)
Security exit user data (SCYDATA)
Send exit name (SENDEXIT)
Send exit user data (SENDDATA)
Sequence number wrap (SEQWRAP)
Sequential delivery
Short retry count (SHORTRTY)
Short retry interval (SHORTTMR)
SSL Cipher Specification (SSLCIPH)
SSL Client Authentication (SSLCAUTH)
SSL Peer (SSLPEER)
Target system identifier
Transaction identifier
Transmission queue name (XMITQ)
Transport type (TRPTYPE)
User ID (USERID)
Chapter 7. Example configuration chapters in this book
Network infrastructure
Communications software
How to use the communication examples
IT responsibilities
Part 3. DQM in WebSphere MQ for UNIX systems, and Windows systems, and MQSeries for Compaq OpenVMS Alpha, Compaq NonStop Kernel, and OS/2 Warp
Chapter 8. Monitoring and controlling channels on distributed platforms
The DQM channel control function
Functions available
Getting started with objects
Creating objects
Creating default objects
Creating a channel
Displaying a channel
Displaying channel status
Starting a channel
Renaming a channel
Channel attributes and channel types
Channel functions
Create
Change
Delete
Display
Display Status
Ping
Start
Stop
Reset
Resolve
Chapter 9. Preparing WebSphere MQ for distributed platforms
Transmission queues and triggering
Creating a transmission queue
Triggering channels
Channel programs
Other things to consider
Undelivered-message queue
Queues in use
Security of WebSphere MQ objects
System extensions and user-exit programs
Running channels and listeners as trusted applications
What next?
Chapter 10. Setting up communication for OS/2 and Windows
Deciding on a connection
Defining a TCP connection
Sending end
Receiving on TCP
Defining an LU 6.2 connection
Sending end for OS/2
Sending end for Windows
Receiving on LU 6.2
Defining a NetBIOS connection
Defining the WebSphere MQ local NetBIOS name
Establishing the queue manager NetBIOS session, command, and name limits
Establishing the LAN adapter number
Initiating the connection
Target listener
Defining an SPX connection
Sending end
Receiving on SPX
IPX/SPX parameters
Chapter 11. Example configuration - MQSeries for OS/2 Warp
Configuration parameters for an LU 6.2 connection
Configuration worksheet
Explanation of terms
Establishing an LU 6.2 connection
Defining local node characteristics
Connecting to a peer system
Connecting to a host system
Verifying the configuration
What next?
Establishing a TCP connection
What next?
Establishing a NetBIOS connection
Establishing an SPX connection
IPX/SPX parameters
SPX addressing
Using the SPX KEEPALIVE option
Receiving on SPX
MQSeries for OS/2 Warp configuration
Basic configuration
Channel configuration
Running channels as processes or threads
Chapter 12. Example configuration - IBM WebSphere MQ for Windows
Configuration parameters for an LU 6.2 connection
Configuration worksheet
Explanation of terms
Establishing an LU 6.2 connection
Configuring the local node
Adding a connection
Adding a partner
Adding a CPI-C entry
Configuring an invokable TP
What next?
Establishing a TCP connection
What next?
Establishing a NetBIOS connection
Establishing an SPX connection
IPX/SPX parameters
SPX addressing
Receiving on SPX
WebSphere MQ for Windows configuration
Default configuration
Basic configuration
Channel configuration
Automatic startup
Running channels as processes or threads
Multiple thread support -- pipelining
Chapter 13. Setting up communication in UNIX systems
Deciding on a connection
Defining a TCP connection
Sending end
Receiving on TCP
Defining an LU 6.2 connection
Sending end
Receiving on LU 6.2
Chapter 14. Example configuration - IBM WebSphere MQ for AIX
Configuration parameters for an LU 6.2 connection
Configuration worksheet
Explanation of terms
Establishing a session using Communications Server for AIX V5
Configuring your node
Configuring connectivity to the network
Defining a local LU
Defining a transaction program
Establishing a TCP connection
What next?
Establishing a UDP connection
What next?
WebSphere MQ for AIX configuration
Basic configuration
Channel configuration
Chapter 15. Example configuration - IBM MQSeries for Compaq Tru64 UNIX
Establishing a TCP connection
What next?
MQSeries for Compaq Tru64 UNIX configuration
Basic configuration
Channel configuration
Chapter 16. Example configuration - IBM WebSphere MQ for HP-UX
Configuration parameters for an LU 6.2 connection
Configuration worksheet
Explanation of terms
Establishing a session using HP SNAplus2
SNAplus2 configuration
APPC configuration
HP-UX operation
What next?
Establishing a TCP connection
What next?
WebSphere MQ for HP-UX configuration
Basic configuration
Channel configuration
Chapter 17. Example configuration - IBM MQSeries for AT&T GIS UNIX, V2.2
Configuration parameters for an LU 6.2 connection
Configuration worksheet
Explanation of terms
Establishing a connection using AT&T GIS SNA Server
Defining local node characteristics
Connecting to a partner node
Configuring a remote node
What next?
Establishing a TCP connection
What next?
MQSeries for AT&T GIS UNIX configuration
Basic configuration
Channel configuration
Chapter 18. Example configuration - IBM WebSphere MQ for Solaris
Loading the WebSphere MQ library to support SNA
Configuration parameters for an LU 6.2 connection using SunLink Version 9.1
Configuration worksheet
Explanation of terms
Establishing a connection using SunLink Version 9.1
SunLink 9.1 base configuration
Configuring a PU 2.1 server
Adding a LAN connection
Configuring a connection to a remote PU
Configuring an independent LU
Configuring a partner LU
Configuring the session mode
Configuring a transaction program
CPI-C side information
What next?
Configuration parameters for an LU 6.2 connection using SNAP-IX
Configuration worksheet
Explanation of terms
Establishing a session using SNAP-IX
SNAP-IX configuration
APPC configuration
SNAP-IX operation
What next?
Establishing a TCP connection
What next?
WebSphere MQ for Solaris configuration
Basic configuration
Channel configuration
Chapter 19. Setting up communication in Compaq OpenVMS Alpha systems
Deciding on a connection
Defining a TCP connection
Sending end
Receiving channels using Compaq (DIGITAL) TCP/IP services (UCX) for OpenVMS
Receiving channels using Cisco MultiNet for OpenVMS
Receiving channels using Attachmate PathWay for OpenVMS
Receiving channels using Process Software Corporation TCPware
Defining an LU 6.2 connection
SNA configuration
Specifying SNA configuration parameters to WebSphere MQ
Sample WebSphere MQ configuration
Problem solving
Defining a DECnet Phase IV connection
Sending end
Receiving on DECnet Phase IV
Defining a DECnet Phase V connection
Chapter 20. Setting up communication in Compaq NonStop Kernel
Deciding on a connection
SNA channels
LU 6.2 responder processes
TCP channels
Communications examples
SNAX communications example
ICE communications example
TCP/IP communications example
Chapter 21. Message channel planning example for distributed platforms
What the example shows
Queue manager QM1 example
Queue manager QM2 example
Running the example
Expanding this example
Chapter 22. Example SINIX and DC/OSx configuration files
Configuration file on bight
Configuration file on forties
Working configuration files for Pyramid DC/OSx
Output of dbd command
Part 4. DQM in WebSphere MQ for z/OS
Chapter 23. Monitoring and controlling channels on z/OS
The DQM channel control function
Using the panels and the commands
Using the initial panel
Managing your channels
Defining a channel
Altering a channel definition
Displaying a channel definition
Deleting a channel definition
Displaying information about DQM
Starting a channel initiator
Stopping a channel initiator
Starting a channel listener
Stopping a channel listener
Starting a channel
Testing a channel
Resetting message sequence numbers for a channel
Resolving in-doubt messages on a channel
Stopping a channel
Displaying channel status
Displaying cluster channels
Chapter 24. Preparing WebSphere MQ for z/OS
Defining DQM requirements to WebSphere MQ
Defining WebSphere MQ objects
Transmission queues and triggering channels
Synchronization queue
Channel command queues
Starting the channel initiator
Stopping the channel initiator
Other things to consider
Operator Messages
Channel operation commands
Undelivered-message queue
Queues in use
Security changes
Communications stopped
z/OS Automatic Restart Management (ARM)
Chapter 25. Setting up communication for z/OS
Deciding on a connection
Defining a TCP connection
Sending end
Receiving on TCP
Using the TCP listener backlog option
Defining an LU6.2 connection
APPC/MVS setup
Chapter 26. Example configuration - IBM WebSphere MQ for z/OS
Configuration parameters for an LU 6.2 connection
Configuration worksheet
Explanation of terms
Establishing an LU 6.2 connection
Defining yourself to the network
Defining a connection to a partner
Establishing a TCP connection
What next?
WebSphere MQ for z/OS configuration
Channel configuration
Chapter 27. Message channel planning example for z/OS
What the example shows
Queue manager QM1 example
Queue manager QM2 example
Running the example
Expanding this example
Chapter 28. Monitoring and controlling channels in z/OS with CICS
The DQM channel control function
CICS regions
Starting DQM panels
The Message Channel List panel
Keyboard functions
Selecting a channel
Working with channels
Creating a channel
Altering a channel
Browsing a channel
Renaming a channel
Selected menu-bar choice
Edit menu-bar choice
View menu-bar choice
Help menu-bar choice
The channel definition panels
Channel menu-bar choice
Help menu-bar choice
Channel settings panel fields
Details of sender channel settings panel
Details of receiver channel settings panel
Details of server channel settings panel
Details of requester channel settings panel
Chapter 29. Preparing WebSphere MQ for z/OS when using CICS
Defining DQM requirements to WebSphere MQ
Defining WebSphere MQ objects
Multiple message channels per transmission queue
Channel operation considerations
Chapter 30. Setting up CICS communication for WebSphere MQ for z/OS
Connecting CICS systems
Communication between queue managers
Intersystem communication
Defining an LU 6.2 connection
Installing the connection
Communications between CICS systems attached to one queue manager
Connection names for function shipping
Chapter 31. Example configuration - IBM WebSphere MQ for z/OS using CICS
Configuration parameters for an LU 6.2 connection
Configuration worksheet
Explanation of terms
Establishing an LU 6.2 connection using CICS
Defining a connection
Defining the sessions
Installing the new group definition
What next?
WebSphere MQ for z/OS using CICS configuration
Channel configuration
Chapter 32. Message channel planning example for z/OS using CICS
Chapter 33. Preparing WebSphere MQ for z/OS for DQM with queue-sharing groups
Concepts
Class of service
Generic interface
Components
Listeners
Transmission queues and triggering
Message channel agents
Synchronization queue
Benefits
Load-balanced channel start
Shared channel recovery
Client channels
Clusters and queue-sharing groups
Channels and serialization
Intra-group queuing
Chapter 34. Setting up communication for WebSphere MQ for z/OS using queue-sharing groups
Deciding on a connection
Defining a TCP connection
Sending end
Receiving on TCP using a queue-sharing group
Defining an LU6.2 connection
Connecting to APPC/MVS (LU 6.2)
Receiving on LU 6.2 using a generic interface
Chapter 35. Example configuration - WebSphere MQ for z/OS using queue-sharing groups
Configuration parameters for an LU 6.2 connection
Configuration worksheet
Explanation of terms
Establishing an LU 6.2 connection into a queue-sharing group
Defining yourself to the network using generic resources
Defining a connection to a partner
What next?
Establishing a TCP connection into a queue-sharing group
Using WLM/DNS
What next?
WebSphere MQ for z/OS shared channel configuration
Shared channel configuration
Chapter 36. Message channel planning example for z/OS using queue-sharing groups
What this example shows
Queue-sharing group definitions
Queue manager QM3 example
Remaining definitions
Running the example
Chapter 37. Intra-group queuing
Concepts
Intra-group queuing and the intra-group queuing agent
Terminology
Intra-group queuing
Shared transmission queue for use by intra-group queuing
Intra-group queuing agent
Benefits
Reduced system definitions
Reduced system administration
Improved performance
Supports migration
Transparent delivery of messages when multi-hopping between queue managers in a queue-sharing group
Limitations
Messages eligible for transfer using intra-group queuing
Number of intra-group queuing agents per queue manager
Starting and stopping the intra-group queuing agent
Getting started
Enabling intra-group queuing
Disabling intra-group queuing
Using intra-group queuing
Configurations
Distributed queuing with intra-group queuing (multiple delivery paths)
Clustering with intra-group queuing (multiple delivery paths)
Clustering, intra-group queuing and distributed queuing
Messages
Message structure
Message persistence
Delivery of messages
Batching of messages
Message size
Default message persistence and default message priority
Undelivered/unprocessed messages
Report messages
Security
Intra-group queuing authority (IGQAUT)
Intra-group queuing user indentifier (IGQUSER)
Specific properties
Queue name resolution
Invalidation of object handles (MQRC_OBJECT_CHANGED)
Self recovery of the intra-group queuing agent
Retry capability of the intra-group queuing agent
The intra-group queuing agent and Serialization
Chapter 38. Example Configuration -- WebSphere MQ for z/OS using intra-group queuing
Configuration 1
Configuration 2
Configuration 3
Configuration 1 definitions
Configuration 2 definitions
Configuration 3 definitions
Running the example
Expanding the example
Part 5. DQM in WebSphere MQ for iSeries
Chapter 39. Monitoring and controlling channels in WebSphere MQ for iSeries
The DQM channel control function
Operator commands
Getting started
Creating objects
Creating a channel
Starting a channel
Selecting a channel
Browsing a channel
Renaming a channel
Work with channel status
Work-with-channel choices
Panel choices
F6=Create
2=Change
3=Copy
4=Delete
5=Display
8=Work with Status
13=Ping
14=Start
15=End
16=Reset
17=Resolve
Chapter 40. Preparing WebSphere MQ for iSeries
Creating a transmission queue
Triggering channels
Channel programs
Channel states on OS/400
Other things to consider
Undelivered-message queue
Queues in use
Maximum number of channels
Security of WebSphere MQ for iSeries objects
System extensions and user-exit programs
Chapter 41. Setting up communication for WebSphere MQ for iSeries
Deciding on a connection
Defining a TCP connection
Receiving on TCP
Defining an LU 6.2 connection
Initiating end (Sending)
Initiated end (Receiver)
Chapter 42. Example configuration - IBM WebSphere MQ for iSeries
Configuration parameters for an LU 6.2 connection
Configuration worksheet
Explanation of terms
Establishing an LU 6.2 connection
Local node configuration
Connection to partner node
What next?
Establishing a TCP connection
Adding a TCP/IP interface
Adding a TCP/IP loopback interface
Adding a default route
What next?
WebSphere MQ for iSeries configuration
Basic configuration
Channel configuration
Defining a queue
Defining a channel
Chapter 43. Message channel planning example for iSeries
What the example shows
Queue manager QM1 example
Queue manager QM2 example
Running the example
Expanding this example
Part 6. DQM in MQSeries for VSE/ESA
Chapter 44. Example configuration - MQSeries for VSE/ESA
Configuration parameters for an LU 6.2 connection
Configuration worksheet
Explanation of terms
Establishing an LU 6.2 connection
Defining a connection
Defining a session
Installing the new group definition
What next?
Establishing a TCP connection
MQSeries for VSE/ESA configuration
Configuring channels
Defining a local queue
Defining a remote queue
Defining a SNA LU 6.2 sender channel
Defining a SNA LU6.2 receiver channel
Defining a TCP/IP sender channel
Defining a TCP receiver channel
Part 7. Further intercommunication considerations
Chapter 45. Channel-exit programs
What are channel-exit programs?
Processing overview
Channel security exit programs
Channel send and receive exit programs
Channel send exit programs -- reserving space
Channel message exit programs
Channel message retry exit program
Channel auto-definition exit program
Transport-retry exit program
Writing and compiling channel-exit programs
WebSphere MQ for z/OS without CICS
WebSphere MQ for z/OS using CICS
WebSphere MQ for iSeries
MQSeries for OS/2 Warp
Windows 3.1 client
WebSphere MQ for Windows server, WebSphere MQ client for Windows
WebSphere MQ for AIX
MQSeries for Compaq OpenVMS Alpha
MQSeries for Compaq Tru64 UNIX
WebSphere MQ for HP-UX
MQSeries for AT&T GIS UNIX
WebSphere MQ for Solaris
MQSeries for SINIX and DC/OSx
MQSeries for Compaq NonStop Kernel
Supplied channel-exit programs using DCE security services
What do the DCE channel-exit programs do?
How do the DCE channel-exit programs work?
How to use the DCE channel-exit programs
SSPI security exit
Chapter 46. Channel-exit calls and data structures
Data definition files
MQ_CHANNEL_EXIT - Channel exit
Syntax
Parameters
Usage notes
C invocation
COBOL invocation
PL/I invocation
RPG invocation (ILE)
RPG invocation (OPM)
System/390 assembler invocation
MQ_CHANNEL_AUTO_DEF_EXIT - Channel auto-definition exit
Syntax
Parameters
Usage notes
C invocation
COBOL invocation
RPG invocation (ILE)
RPG invocation (OPM)
System/390 assembler invocation
MQ_TRANSPORT_EXIT - Transport retry exit
Syntax
Parameters
Usage notes
C invocation
MQXWAIT - Wait in exit
Syntax
Parameters
C invocation
System/390 assembler invocation
MQCD - Channel definition
Exit name fields
Fields
C declaration
COBOL declaration
PL/I declaration
RPG declaration (ILE)
RPG declaration (OPM)
System/390 assembler declaration
Visual Basic declaration
MQCXP - Channel exit parameter
Fields
C declaration
COBOL declaration
PL/I declaration
RPG declaration (ILE)
RPG declaration (OPM)
System/390 assembler declaration
MQTXP - Transport exit parameter
Fields
C declaration
MQXWD - Exit wait descriptor
Fields
C declaration
System/390 assembler declaration
Chapter 47. Problem determination in DQM
Error message from channel control
Ping
Dead-letter queue considerations
Validation checks
In-doubt relationship
Channel startup negotiation errors
When a channel refuses to run
Triggered channels
Conversion failure
Network problems
Dial-up problems
Retrying the link
Retry considerations
Data structures
User exit problems
Disaster recovery
Channel switching
Connection switching
Client problems
Terminating clients
Error logs
Error logs for OS/2, Windows and Windows 98 client
Error logs on UNIX systems
Error logs on DOS, Windows 3.1, and Windows 95 clients
Error logs on z/OS
Error logs on MQSeries for VSE/ESA
Error logs on MQSeries for Compaq NonStop Kernel
Part 8. Appendixes
Appendix A. Constants for channels and exits
List of constants
MQ_* (Lengths of character string and byte fields)
MQCC_* (Completion code)
MQCD_* (Channel definition structure length)
MQCD_* (Channel definition structure version)
MQCDC_* (Channel data conversion)
MQCF_* (Channel capability flags)
MQCHT_* (Channel type)
MQCXP_* (Channel-exit parameter structure identifier)
MQCXP_* (Channel-exit parameter structure version)
MQFB_* (Feedback)
MQKAI_* (Keepalive interval)
MQMCAT_* (MCA type)
MQNPMS_* (Nonpersistent message speed)
MQPA_* (Put authority)
MQRC_* (Reason code)
MQSCA_* (SSL client authentication)
MQSID_* (Security identifier)
MQSIDT_* (Security identifier type)
MQTXP_* (Transport retry exit structure identifier)
MQTXP_* (Transport retry exit structure version)
MQXCC_* (Exit response)
MQXPT_* (Transmission protocol type)
MQXR_* (Exit reason)
MQXR2_* (Secondary exit response)
MQXT_* (Exit identifier)
MQXUA_* (Exit user area)
MQXWD_* (Exit wait descriptor structure identifier)
MQXWD_* (Exit wait descriptor version)
Appendix B. Queue name resolution
What is queue name resolution?
How queue name resolution works
Appendix C. Configuration file stanzas for distributed queuing
Appendix D. Notices
Trademarks
Index
Sending your comments to IBM
© IBM Corporation 2002. All Rights Reserved