Contents
Syntax diagrams:
How to read railroad diagrams
How to read dotted decimal diagrams
Figures
Tables
About this book
Who this book is for
What you need to know to understand this book
Terms used in this book
Using WebSphere MQ for Windows
Using WebSphere MQ for UNIX systems
The calls MQCONN and MQCONNX
Summary of changes
Changes for this edition (SC34-6584-00)
The WebSphere MQ Explorer
The File Transfer Application
Control commands
WebSphere MQ objects
WebSphere MQ structures
Authorization service functions
WebSphere MQ configuration information
WebSphere MQ tracing on AIX systems
Informix XA resource manager
Backup queue managers
Introduction
Introduction to WebSphere
(R)
MQ
WebSphere MQ and message queuing
Time-independent applications
Message-driven processing
Messages and queues
What is a message?
What is a queue?
Objects
Object names
Managing objects
Object attributes
WebSphere MQ queues
WebSphere MQ queue managers
Process definitions
Clusters
Namelists
Authentication information objects
Channels
Client connection channels
Listeners
Services
System default objects
Clients and servers
WebSphere MQ applications in a client-server environment
Extending queue manager facilities
User exits
API exits
Installable services
Security
Object Authority Manager (OAM) facility
User-written or third party channel exits
Channel security using SSL
Transactional support
An introduction to WebSphere MQ administration
Local and remote administration
Performing administration tasks using commands
Control commands
WebSphere MQ Script (MQSC) commands
PCF commands
Further methods of administration
Using the WebSphere MQ Explorer
Using the Windows Default Configuration application
Using the Microsoft Cluster Service (MSCS)
Understanding WebSphere MQ file names
Queue manager name transformation
Object name transformation
Administration using WebSphere MQ commands
Managing queue managers
Using control commands
Using control commands on Windows systems
Using control commands on UNIX
(R)
systems
Using the WebSphere MQ Explorer
Creating a queue manager
Guidelines for creating queue managers
Creating a default queue manager
Making an existing queue manager the default
Backing up configuration files after creating a queue manager
Starting a queue manager
Starting a queue manager automatically
Stopping a queue manager
Quiesced shutdown
Immediate shutdown
Preemptive shutdown
If you have problems shutting down a queue manager
Restarting a queue manager
Deleting a queue manager
Administering local WebSphere MQ objects
Supporting application programs that use the MQI
Performing local administration tasks using MQSC commands
WebSphere MQ object names
Standard input and output
Using MQSC commands interactively
Running MQSC commands from text files
Running MQSC commands from batch files
Resolving problems with MQSC commands
Working with queue managers
Displaying queue manager attributes
Altering queue manager attributes
Working with local queues
Defining a local queue
Displaying default object attributes
Copying a local queue definition
Changing local queue attributes
Clearing a local queue
Deleting a local queue
Browsing queues
Monitoring local queues with the Windows Performance Monitor
Enabling large queues
Working with alias queues
Defining an alias queue
Using other commands with alias queues
Working with model queues
Defining a model queue
Using other commands with model queues
Working with services
Defining a service object
Managing services
Additional environment variables
Replaceable inserts on service definitions
Examples on using service objects
Managing objects for triggering
Defining an application queue for triggering
Defining an initiation queue
Defining a process
Displaying attributes of a process definition
Automating administration tasks
PCF commands
PCF object attributes
Escape PCFs
Using the MQAI to simplify the use of PCFs
Active Directory Services Interfaces
Administering remote WebSphere MQ objects
Channels, clusters, and remote queuing
Remote administration using clusters
Remote administration from a local queue manager
Preparing queue managers for remote administration
Preparing channels and transmission queues for remote administration
Managing the command server for remote administration
Issuing MQSC commands on a remote queue manager
Recommendations for issuing commands remotely
If you have problems using MQSC commands remotely
Creating a local definition of a remote queue
Understanding how local definitions of remote queues work
An alternative way of putting messages on a remote queue
Using other commands with remote queues
Defining a transmission queue
Using remote queue definitions as aliases
Queue manager aliases
Reply-to queue aliases
Data conversion
When a queue manager cannot convert messages in built-in formats
File ccsid.tbl
Converting messages in user-defined formats
Changing the queue manager CCSID
Administration using the WebSphere MQ Explorer
Administration using the WebSphere MQ Explorer
What you can do with the WebSphere MQ Explorer
Remote queue managers
Deciding whether to use the WebSphere MQ Explorer
Setting up the WebSphere MQ Explorer
Prerequisite software
Required definitions for administration
Cluster membership
Security
Data conversion
Using the WebSphere MQ Explorer
Showing and hiding queue managers and clusters
Using the WebSphere MQ Taskbar application (Windows only)
Security on Windows
Using Active directory (Windows only)
Controlling access (Windows only)
Changing the password of the AMQMSRVN user account
Extending the WebSphere MQ Explorer
Who this chapter is for
What you need to know to understand this chapter
Introduction
Importing the simple Eclipse plug-in
Writing an Eclipse plug-in for the WebSphere MQ Explorer
Accessing Javadoc
Utilizing extension points
Applying plug-ins to the WebSphere MQ Explorer
Configuring WebSphere MQ
Configuring WebSphere MQ
Changing configuration information on Windows systems
Viewing configuration information
Changing configuration information on UNIX systems
Editing configuration files
The WebSphere MQ configuration file, mqs.ini
Queue manager configuration files, qm.ini
Attributes for changing WebSphere MQ configuration information
All queue managers
Client exit path
Default queue manager
Exit properties
Log defaults for WebSphere MQ
Advanced Configuration and Power Interface (ACPI)
API exits
Queue managers
Changing queue manager configuration information
Installable services
Queue manager logs
Restricted mode
XA resource managers
Channels
LU62, NETBIOS, TCP, and SPX
Exit path
Queue manager error logs
Queue manager default bind type
WebSphere MQ security
Authority to administer WebSphere MQ
Managing the mqm group
Authority to work with WebSphere MQ objects
When security checks are made
How access control is implemented by WebSphere MQ
Identifying the user ID
Alternate-user authority
Context authority
Connecting to WebSphere MQ using Terminal Services
Creating and managing groups
Windows 2000
Windows XP and Windows 2003
HP-UX
AIX
Solaris
Linux
Using the OAM to control access to objects
Giving access to a WebSphere MQ object
Using OAM generic profiles
Displaying access settings
Changing and revoking access to a WebSphere MQ object
Preventing security access checks
Channel security
Protecting channel initiator definitions
Transmission queues
Channel exits
Protecting channels with SSL
How authorizations work
Authorizations for MQI calls
Authorizations for MQSC commands in escape PCFs
Authorizations for PCF commands
Guidelines for Windows 2000 and Windows 2003
When you get a 'group not found' error
When you have problems with WebSphere MQ and domain controllers
Applying security template files
Nested groups
Transactional support
Introducing units of work
Scenario 1: Queue manager performs the coordination
Database coordination
DB2 configuration
Oracle configuration
Informix configuration
Sybase configuration
Multiple database configurations
Security considerations
Administration tasks
XA dynamic registration
Scenario 2: Other software provides the coordination
External syncpoint coordination
Using CICS
Using the Microsoft Transaction Server (COM+)
The WebSphere MQ dead-letter queue handler
Invoking the DLQ handler
The sample DLQ handler, amqsdlq
The DLQ handler rules table
Control data
Rules (patterns and actions)
Rules table conventions
How the rules table is processed
Ensuring that all DLQ messages are processed
An example DLQ handler rules table
Supporting the Microsoft Cluster Service (MSCS)
Introducing MSCS clusters
Setting up WebSphere MQ for MSCS clustering
Setup symmetry
MSCS security
Using multiple queue managers with MSCS
Cluster modes
Creating a queue manager for use with MSCS
Creating a queue manager from a command prompt
Creating a queue manager using the WebSphere MQ Explorer
Moving a queue manager to MSCS storage
Putting a queue manager under MSCS control
Removing a queue manager from MSCS control
Taking a queue manager offline from MSCS
Returning a queue manager from MSCS storage
Hints and tips on using MSCS
Verifying that MSCS is working
Using the IBM MQSeries Service
Manual startup
MSCS and queue managers
Always use MSCS to manage clusters
Working in Active/Active mode
PostOnlineCommand and PreOfflineCommand
Using preferred nodes
Performance benchmarking
WebSphere MQ MSCS support utility programs
Recovery and problem determination
Recovery and restart
Making sure that messages are not lost (logging)
What logs look like
Types of logging
Using checkpointing to ensure complete recovery
Checkpointing with long-running transactions
Calculating the size of the log
Managing logs
What happens when a disk gets full
Managing log files
Using the log for recovery
Recovering from power loss or communications failures
Recovering damaged objects
Protecting WebSphere MQ log files
Backing up and restoring WebSphere MQ
Backing up queue manager data
Restoring queue manager data
Using a backup queue manager
Creating a backup queue manager
Updating a backup queue manager
Starting a backup queue manager
Recovery scenarios
Disk drive failures
Damaged queue manager object
Damaged single object
Automatic media recovery failure
Dumping the contents of the log using the dmpmqlog command
Problem determination
Preliminary checks
Has WebSphere MQ run successfully before?
Are there any error messages?
Are there any return codes explaining the problem?
Can you reproduce the problem?
Have any changes been made since the last successful run?
Has the application run successfully before?
Problems with commands
Does the problem affect specific parts of the network?
Does the problem occur at specific times of the day?
Is the problem intermittent?
Have you applied any service updates?
Looking at problems in more detail
Have you obtained incorrect output?
Have you failed to receive a response from a PCF command?
Are some of your queues failing?
Does the problem affect only remote queues?
Is your application or system running slowly?
Application design considerations
Effect of message length
Effect of message persistence
Searching for a particular message
Queues that contain messages of different lengths
Frequency of syncpoints
Use of the MQPUT1 call
Number of threads in use
Error logs
Error log files
Error log access restrictions under UNIX systems
Ignoring error codes under UNIX systems
Ignoring error codes under Windows systems
Operator messages
Dead-letter queues
Configuration files and problem determination
Tracing
Tracing WebSphere MQ for Windows
Tracing WebSphere MQ for UNIX systems
Trace files
Tracing Secure Sockets Layer (SSL) on UNIX systems
Tracing with the AIX system trace
First-failure support technology (FFST)
FFST: WebSphere MQ for Windows
FFST: WebSphere MQ for UNIX systems
Problem determination with WebSphere MQ clients
Terminating clients
Java diagnostics
Using com.ibm.mq.commonservices
Java trace and FFDC files
WebSphere MQ control commands
How to use WebSphere MQ control commands
Names of WebSphere MQ objects
Example syntax diagram
Syntax help
Examples
The control commands
amqccert (check certificate chains)
amqmdain (WebSphere MQ services control)
amqtcert (transfer certificates)
Listing the contents of certificate stores
Manually migrating certificate stores
Automatically migrating certificate stores
Listing the contents of registry entries
Removing state information
crtmqcvx (data conversion)
crtmqm (create queue manager)
dltmqm (delete queue manager)
dmpmqaut (dump authority)
dmpmqlog (dump log)
dspmq (display queue managers)
dspmqaut (display authority)
dspmqcsv (display command server)
dspmqfls (display files)
dspmqrte (WebSphere MQ display route application)
dspmqtrc (display formatted trace output)
dspmqtrn (display transactions)
dspmqver (display version information)
endmqcsv (end command server)
endmqlsr (end listener)
endmqdnm (stop .NET monitor)
endmqm (end queue manager)
endmqtrc (end trace)
mqftapp (run File Transfer Application GUI)
mqftrcv (receive file on server)
mqftrcvc (receive file on client)
mqftsnd (send file from server)
mqftsndc (send file from client)
rcdmqimg (record media image)
rcrmqobj (recreate object)
rsvmqtrn (resolve transactions)
runmqchi (run channel initiator)
runmqchl (run channel)
runmqdlq (run dead-letter queue handler)
runmqdnm (run .NET monitor)
runmqlsr (run listener)
runmqsc (run MQSC commands)
runmqtmc (start client trigger monitor)
runmqtrm (start trigger monitor)
setmqaut (set or reset authority)
Authorizations for MQI calls
Authorizations for context
Authorizations for commands
Authorizations for generic operations
setmqcrl (set certificate revocation list (CRL) LDAP server definitions)
setmqscp (set service connection points)
strmqcfg (start WebSphere MQ Explorer)
strmqcsv (start command server)
strmqm (start queue manager)
strmqtrc (Start trace)
Managing keys and certificates
Preparing to use the gsk7cmd command
gsk7cmd and runmqckm commands
Commands for a CMS key database only
Commands for CMS or PKCS #12 key databases
Commands for cryptographic device operations
gsk7cmd and runmqckm options
WebSphere MQ installable services and the API exit
Installable services and components
Why installable services?
Functions and components
Entry-points
Return codes
Component data
Initialization
Primary initialization
Secondary initialization
Primary termination
Secondary termination
Configuring services and components
Service stanza format
Service stanza format for Windows systems
Service component stanza format
Creating your own service component
Using multiple service components
Example of using multiple components
Omitting entry points when using multiple components
Example of entry points used with multiple components
Authorization service
Object authority manager (OAM)
Defining the service to the operating system
Refreshing the OAM after changing a user's authorization
Migrating from MQSeries Version 5.1
Authorization service on UNIX systems
Configuring authorization service stanzas: UNIX systems
Authorization service on Windows systems
Configuring authorization service stanzas: Windows systems
Authorization service interface
Name service
How the name service works
Name service interface
Installable services interface reference information
How the functions are shown
Parameters and data types
MQZEP - Add component entry point
Syntax
Parameters
C invocation
MQHCONFIG - Configuration handle
C declaration
PMQFUNC - Pointer to function
C declaration
MQZ_AUTHENTICATE_USER - Authenticate user
Syntax
Parameters
C invocation
MQZ_CHECK_AUTHORITY - Check authority
Syntax
Parameters
C invocation
MQZ_CHECK_AUTHORITY_2 - Check authority (extended)
Syntax
Parameters
C invocation
MQZ_COPY_ALL_AUTHORITY - Copy all authority
Syntax
Parameters
C invocation
MQZ_DELETE_AUTHORITY - Delete authority
Syntax
Parameters
C invocation
MQZ_ENUMERATE_AUTHORITY_DATA - Enumerate authority data
Syntax
Parameters
C invocation
MQZ_FREE_USER - Free user
Syntax
Parameters
C invocation
MQZ_GET_AUTHORITY - Get authority
Syntax
Parameters
C invocation
MQZ_GET_AUTHORITY_2 - Get authority (extended)
Syntax
Parameters
C invocation
MQZ_GET_EXPLICIT_AUTHORITY - Get explicit authority
Syntax
Parameters
C invocation
MQZ_GET_EXPLICIT_AUTHORITY_2 - Get explicit authority (extended)
Syntax
Parameters
C invocation
MQZ_INIT_AUTHORITY - Initialize authorization service
Syntax
Parameters
C invocation
MQZ_INQUIRE - Inquire authorization service
Syntax
Parameters
C invocation
MQZ_REFRESH_CACHE - Refresh all authorizations
Syntax
Parameters
C invocation
MQZ_SET_AUTHORITY - Set authority
Syntax
Parameters
C invocation
MQZ_SET_AUTHORITY_2 - Set authority (extended)
Syntax
Parameters
C invocation
MQZ_TERM_AUTHORITY - Terminate authorization service
Syntax
Parameters
C invocation
MQZAC - Application context
Fields
C declaration
MQZAD - Authority data
Fields
C declaration
MQZED - Entity descriptor
Fields
C declaration
MQZIC - Identity context
Fields
C declaration
MQZFP - Free parameters
Fields
C declaration
MQZ_DELETE_NAME - Delete name
Syntax
Parameters
C invocation
MQZ_INIT_NAME - Initialize name service
Syntax
Parameters
C invocation
MQZ_INSERT_NAME - Insert name
Syntax
Parameters
C invocation
MQZ_LOOKUP_NAME - Lookup name
Syntax
Parameters
C invocation
MQZ_TERM_NAME - Terminate name service
Syntax
Parameters
C invocation
API exits
Why use API exits
How you use API exits
How to configure WebSphere MQ for API exits
How to write an API exit
What happens when an API exit runs?
Configuring API exits
Configuring API exits on UNIX
(R)
systems
Configuring API exits on Windows
(R)
systems
API exit reference information
General usage notes
MQACH - API exit chain header
Fields
C declaration
MQAXC - API exit context
Fields
C declaration
MQAXP - API exit parameter
Fields
C declaration
MQXEP - Register entry point
Syntax
Parameters
C invocation
MQ_BACK_EXIT - Back out changes
Syntax
Parameters
C invocation
MQ_BEGIN_EXIT - Begin unit of work
Syntax
Parameters
C invocation
MQ_CLOSE_EXIT - Close object
Syntax
Parameters
C invocation
MQ_CMIT_EXIT - Commit changes
Syntax
Parameters
C invocation
MQ_CONNX_EXIT - Connect queue manager (extended)
Syntax
Parameters
Usage notes
C invocation
MQ_DISC_EXIT - Disconnect queue manager
Syntax
Parameters
C invocation
MQ_GET_EXIT - Get message
Syntax
Parameters
Usage notes
C invocation
MQ_INIT_EXIT - Initialize exit environment
Syntax
Parameters
Usage notes
C invocation
MQ_INQ_EXIT - Inquire object attributes
Syntax
Parameters
C invocation
MQ_OPEN_EXIT - Open object
Syntax
Parameters
C invocation
MQ_PUT_EXIT - Put message
Syntax
Parameters
Usage notes
C invocation
MQ_PUT1_EXIT - Put one message
Syntax
Parameters
C invocation
MQ_SET_EXIT - Set object attributes
Syntax
Parameters
C invocation
MQ_TERM_EXIT - Terminate exit environment
Syntax
Parameters
Usage notes
C invocation
Appendixes
Appendix A. System and default objects
Windows default configuration objects
Appendix B. Directory structure (Windows systems)
Appendix C. Directory structure (UNIX systems)
Appendix D. Stopping and removing queue managers manually
Stopping a queue manager manually
Stopping queue managers in WebSphere MQ for Windows
Stopping queue managers in WebSphere MQ for UNIX systems
Removing queue managers manually
Removing queue managers in WebSphere MQ for Windows
Removing queue managers in WebSphere MQ for UNIX systems
Appendix E. File Transfer Application
Introduction to the File Transfer Application
Advantages
Components
Installing and configuring the File Transfer Application
Installing the File Transfer Application on a WebSphere MQ server
Installing the File Transfer Application on a WebSphere MQ client
Setup tasks
Configuring the GUI
File Transfer Application channel security
Using the File Transfer Application
Sending a file
Receiving a file
Listing all sent and received files
File status
Using the command line
Appendix F. Comparing command sets
Queue manager commands
Command server commands
Authority commands
Cluster commands
Authentication information commands
Channel commands
Listener commands
Namelist commands
Process commands
Queue commands
Service commands
Other commands
Appendix G. WebSphere MQ and UNIX System V IPC resources
Clearing WebSphere MQ shared memory resources
Shared memory on AIX
(R)
Appendix H. Common Criteria
Environmental Considerations
Configuration Requirements
Appendix I. Notices
Trademarks
Index
Notices
|
Downloads
|
Library
|
Support
|
Feedback
amqzag0602