Contents

About this book
License warning
Who should read this book
Prerequisite knowledge
Terms used in this book
Summary of changes
Migration notes
General migration issues
What is the same?
What is different?
Not supported
Migration warnings
Cross API changes
mqeQueueManager APIs
Fields API
Constants
Administration messages
Configuration and administration
Deprecated classes
Migrating from version 1.2.7 to version 2.0
Changes to MQeFields
Peer channels
Changes to MQeChannel
MQeAttribute
Migrating from version 1.2.6 or lower to version 2.0
Aliases
Attribute keys
MQBridge programming
Mini-certificate server
Registry
Trace
Introduction
"HelloWorld" messaging
Java codebase
Developing the Java "HelloWorld" application
Running the Java "HelloWorld" application
C codebase
Designing the C "HelloWorld" application
Developing the C "HelloWorld" application
Deploying the C "HelloWorld" application
Running the C "HelloWorld" application
Running Applications
Development environment
Java development
C development
Threading
Calling convention
Handles and items
WebSphere MQ Everyplace memory functions
MQeString
J2ME environment
Windows security configuration
Java development
C development
Deploying applications
Java deployment
C deployment
Post install test
Java
C
Messaging
MQeFields
What are WebSphere MQ Everyplace messages?
Message Filters
Message Expiry
Queues
What are WebSphere MQ Everyplace queues?
Queue Names
Queue types
Local queue
Remote queue
Store-and-forward queue
Dead-letter queue
Administration queue
Home-server queue
WebSphere MQ bridge queue
Queue persistent storage
WebSphere MQ Everyplace connection definitions
Using queue aliases
Examples of queue aliasing
Queue manager operations
What is a WebSphere MQ Everyplace queue manager?
The queue manager lifecycle
Starting queue managers
Starting queue managers in Java
Queue manager parameters
Starting queue managers in C
Registry parameters for a queue manager
Client queue managers
Server queue managers
Environment relationship
Messaging lifecycle
Message states
Message events
Message index fields
Messaging operations
Queue Ordering
Reading messages on a queue
Browse and Lock
Message listeners
Message polling
Trigger transmission
Deleting queue managers
Java
C
Servlet
Security
Connection security
Aliases
Message Delivery
Asynchronous message delivery
Synchronous message delivery
Assured and non-assured message delivery
Assured message delivery
Non-assured message delivery
Synchronous assured message delivery
Put message
Get message
Security
Security features
Local security
Usage scenario
Usage guide for Java
Usage guide for C
Message-level security
Usage scenario
Usage guide
Mini-certificate issuance service
Renewing mini-certificates
Obtaining new credentials (private and public keys)
Listing mini-certificates
Updated mini-certificate format for WebSphere MQ Everyplace Version 2.0
Private registry service
Private registry and the concept of authenticatable entity
Usage scenario
Usage guide
Public registry service
Usage scenario
Usage guide
Java Message Service
Using JMS with WebSphere MQ Everyplace
Obtaining jar files
Testing the JMS class path
Running other WebSphere MQ Everyplace JMS example programs
Writing JMS programs
The JMS model
Restrictions in this version of WebSphere MQ Everyplace
Using Java Naming and Directory Interface (JNDI)
Storing and Retrieving objects with JNDI
Using the example programs with JNDI
Mapping JMS messages to WebSphere MQ Everyplace messages
Naming MQeMsgObject fields
WebSphere MQ Everyplace JMS information
JMS header files
JMS properties
WebSphere MQ Everyplace JMS classes
Error and error handling
Error handling in the Java codebase
Error handling in the C codebase
Structure of the codes
Exception block
Useful macros
Deployment of applications from Webshpere Studio Device Developer
Getting started
Palm: What you need to get started
PocketPC: What you need to get started
Debugging
Debugging on the Palm using WSDD
Debugging on the PocketPC using WSDD
Debugging locally using WSDD
Available runnable classes
MIDlets
Giving parameters to the MIDlet
Cleaning up after the applications
Problems with SmartLinker
Additional help
Open Services Gateway Initiative
WebSphere MQ Everyplace example bundle contents
Using WebSphere MQ Everyplace within OSGi
Running the Example Bundles
Server application (MQeServerBundle.jar)
Client Application (MQeClientBundle.jar )
Running the example
Providing user-defined rules and dynamic class loading
Appendix A. WebSphere MQ Everyplace Java programming examples
Examples
examples.adapters
examples.administration.commandline package
examples.administration.console package
examples.administration.simple package
examples.application package
examples.attributes package
examples.awt package
examples.certificates package
examples.eventlog package
examples.install package
examples.mqbridge.awt package
examples.mqbridge.administration.commandline package
examples.mqbridge.application.GetFromMQ
examples.mqeexampleapp package
examples.nativecode package
examples.queuemanager package
examples.rules package
examples.trace package
Appendix B. Applying maintenance to WebSphere MQ Everyplace
Appendix C. Differences between trace in WebSphere MQ Everyplace version 1.2.6 or lower and version 2.0
How to migrate from WebSphere MQ Everyplace version 1 to the WebSphere MQ Everyplace version 2.0 trace mechanism
Appendix D. Notices
Trademarks
Glossary
Bibliography
Index
Sending your comments to IBM