Contents
Figures
Tables
About this book
Who this book is for
What you need to know to understand this book
How to use this book
Appearance of text in this book
Terms used in this book
Summary of changes
Changes for this edition (SC34-6587-00)
Introduction
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
Security
Security exits
Secure sockets layer
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
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
How intercommunication works
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
Route tracing and activity recording
DQM implementation
Functions of DQM
Message sending and receiving
Channel parameters
Channel status and sequence numbers
Channel control function
Preparing channels
Channel states
Checking that the other end of the channel is still available
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
Windows systems
i5/OS and UNIX systems
Data conversion
Writing your own message channel agents
Channel attributes
Channel attributes and channel types
Channel attributes in alphabetical order
Alter date (ALTDATE)
Alter time (ALTTIME)
Batch Heartbeat Interval (BATCHHB)
Batch interval (BATCHINT)
Batch size (BATCHSZ)
Channel name (CHANNEL)
Channel statistics (STATCHL)
Channel type (CHLTYPE)
Cluster (CLUSTER)
Cluster namelist (CLUSNL)
Cluster workload priority (CLWLPRTY)
Cluster workload rank (CLWLRANK)
Cluster workload weight (CLWLWGHT)
Connection name (CONNAME)
Convert message (CONVERT)
Data compression (COMPMSG)
Description (DESCR)
Disconnect interval (DISCINT)
Disposition (QSGDISP)
Header compression (COMPHDR)
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)
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)
Monitoring (MONCHL)
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)
Short retry count (SHORTRTY)
Short retry interval (SHORTTMR)
SSL Cipher Specification (SSLCIPH)
SSL Client Authentication (SSLCAUTH)
SSL Peer (SSLPEER)
Transmission queue name (XMITQ)
Transport type (TRPTYPE)
User ID (USERID)
Example configuration
chapters
in this book
Network infrastructure
Communications software
How to use the communication examples
IT responsibilities
DQM in WebSphere MQ for distributed platforms
Monitoring and controlling channels on distributed platforms
The DQM channel control function
Functions available
Getting started with objects
Creating
associated
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
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?
Setting up communication for Windows
(R)
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
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
Example configuration - IBM
(R)
WebSphere
(R)
MQ for Windows
(R)
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
Setting up communication on UNIX
(R)
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
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
Configuring your node
Configuring connectivity to the network
Defining a local LU
Defining a transaction program
Establishing a TCP connection
What next?
WebSphere MQ for AIX configuration
Basic configuration
Channel configuration
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
Example configuration - IBM
(R)
WebSphere MQ for Solaris
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
Example configuration - IBM
(R)
WebSphere MQ for Linux
Configuration parameters for an LU 6.2 connection
Configuration worksheet
Explanation of terms
Establishing a session using Communications Server for Linux
(R)
Communications Server for Linux configuration
APPC configuration
Communications Server for Linux operation
What next?
Establishing a TCP connection
Using the inet daemon (INETD)
Using the extended inet daemon (XINETD)
What next?
WebSphere MQ for Linux configuration
Basic configuration
Channel configuration
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
DQM in WebSphere MQ for z/OS
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 the channel initiator
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
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)
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
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
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
Preparing WebSphere MQ for z/OS
(R)
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
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
Example configuration - IBM
(R)
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
Using Sysplex Distributor
What next?
WebSphere MQ for z/OS shared channel configuration
Shared channel configuration
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
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
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
DQM in WebSphere MQ for iSeries
Monitoring and controlling channels on 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
Preparing WebSphere MQ for iSeries
Creating a transmission queue
Triggering channels
Channel programs
Channel states on i5/OS
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
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)
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
Message channel planning example for WebSphere MQ for iSeries
What the example shows
Queue manager QM1 example
Queue manager QM2 example
Running the example
Expanding this example
Further intercommunication considerations
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
Writing and compiling channel-exit programs
WebSphere MQ for z/OS
WebSphere MQ for iSeries
WebSphere MQ for Windows server, WebSphere MQ client for Windows
WebSphere MQ for AIX
WebSphere MQ for HP-UX
WebSphere MQ for Solaris
WebSphere MQ for Linux
SSPI security exit
Channel-exit calls and data structures
Data definition files
MQ_CHANNEL_EXIT - Channel exit
Syntax
Parameters
Usage notes
C invocation
COBOL invocation
RPG invocation (ILE)
RPG invocation (OPM)
System/390
(R)
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
(R)
assembler invocation
MQXWAIT - Wait in exit
Syntax
Parameters
C invocation
System/390
(R)
assembler invocation
MQCD - Channel definition
Exit name fields
Fields
C declaration
COBOL declaration
RPG declaration (ILE)
RPG declaration (OPM)
System/390
(R)
assembler declaration
Visual Basic declaration
MQCXP - Channel exit parameter
Fields
C declaration
COBOL declaration
RPG declaration (ILE)
RPG declaration (OPM)
System/390
(R)
assembler declaration
MQXWD - Exit wait descriptor
Fields
C declaration
System/390
(R)
assembler declaration
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 Windows
Error logs on UNIX
(R)
systems
Error logs on z/OS
Message monitoring
Appendixes
Appendix A. Queue name resolution
What is queue name resolution?
How queue name resolution works
Appendix B. Configuration file stanzas for distributed queuing
Appendix C. Notices
Programming interface information
Trademarks
Index
Notices
|
Downloads
|
Library
|
Support
|
Feedback
csqzae1002