Deploying applications
This section dsescribes how to deploy WebSphere MQ Everyplace applications for Java and C.
Java deployment
When deploying WebSphere MQ Everyplace applications, you are recommended to pack the minimum
set of classes required by the application into compressed jar files.
This ensures that the application requires the minimum system resources. WebSphere MQ Everyplace provides
the following examples of how the WebSphere MQ Everyplace classes can be packaged into .jar files. These examples are in the<MQeInstallDir>\Java\Jars directory of a standard WebSphere MQ Everyplace installation.
WebSphere MQ Everyplace ships the following .jar files
- MQeBase.jar
- This file contains basic information only. It does not contain any security
information, compressors, cryptors, or authenticators. It contains all communication
information, queue types, administration for all of the included resources.
It also contains a client and server. With the MQeBase.jar, you can send WebSphere MQ Everyplace and WebSphere MQ Everyplace MQ
messages. It supports the diskfields, memory, and reduceddiskfields adapters.
- MQeBindings.jar
- This file contains all C bindings specific information. You need this
.jar file to use the C library bindings to control a Java WebSphere MQ Everyplace queue manager.
It includes com.ibm.mqe.bindings, which you need
to use the C library bindings.
- MQeCore.jar
- This contains mandatory classes.
- MQeDeprecated.jar
- This contains all of the deprecated class files that are no longer needed
by a WebSphere MQ Everyplace application. These deprecated class files help you run applications
written using a previous version of WebSphere MQ Everyplace, without making any changes.
- MQeDiagnostics.jar
- This file helps to diagnose problems with WebSphere MQ Everyplace classes. It contains
tooling to search the class path to find out the level of each class found.
- MQeExamples.jar
- A packaging of all the WebSphere MQ Everyplace examples into one jar file. This
includes all of the examples supplied with WebSphere MQ Everyplace, but excludes the deprecated
classes.
- MQeGateway.jar
- This contains the classes that can be used on a server platform. It includes
the bridge class, but excludes the deprecated classes.
- MQeJMS.jar
- This contains the classes that provide a subset of the JMS interface,
suitable for use on smaller devices.
- MQeMidp.jar
- This is equivalent to MQeBasic.jar, but it is for use with J2ME.
- MQeMigration.jar
- This contains classes in the com.ibm.mqe.validation package.
- MQeRetail.jar
- This contains extra message stores with short filenames.
- MQeSecurity.jar
- A set of classes that can be used to extend both the MQeBasic.jar to allow both queue and message based security.
A new jar file, the MQeMidpBase.jar
To run WebSphere MQ Everyplace applications, you must set up the Java runtime environment
to include the required WebSphere MQ Everyplace and application classes. Using a standard
Java runtime environment (JRE), you must set the CLASSPATH to include any
required jar files.
Example statements are:
- Windows
-
Set CLASSPATH=<MQeInstallDir>\Jars\MQeDevice.jar;%CLASSPATH%
- UNIX
-
CLASSPATH=<MQeInstallDir>/Java/Jars/MQeDevice.jar:$CLASSPATH
export CLASSPATH
C deployment
To deploy applications on the PocketPC 2000 or PocketPC 2002 devices, you
need to copy the WebSphere MQ Everyplace DLLs to the device. Copy the DLLs to the Windows directory,
the root directory, or the same directory that holds the application. The
following tables show which DLLs you need for different WebSphere MQ Everyplace entities. You
need the following DLLs for the local queuing base:
- HMQ_Core.dll
- HMQ_DiskAdapter.dll
- HMQ_HAL.dll
- HMQ_nativeAPI.dll
- HMQ_nativeOSA.dll
- HMQ_RegistryFileSession.dll
- HMQ_LocalQueue.dll
Along with the base DLLs you require the following DLLs depending on how
you wish to configure your application:
- Remote queuing
- Add the HMQ_HttpAdapter.dll to the local queuing base DLLs.
Note:
You can remove HMQ_LocalQueue.dll, if you do not want to support administration
queues or local queueing.
- Synchronous remote queue support
- Add HMQ_SyncRemoteQueue.dll to the local
queuing base DLLs.
- Asynchronous remote queue support
- Add HMQ_AsyncRemoteQueue.dll to the local
queuing base DLLs.
- Home server queue support
- Add HMQ_HomeServerQueue.dll to the local
queuing base DLLs.
- Administration queue support
- Add HMQ_AdminQueue.dll and HMQ_LocalQueue.dll to the local queuing base DLLs.
- RLE compressor support
- Add HMQ_RleCompressor.dll to the local
queuing base DLLs.
- RC4 crytpor support
- Add HMQ_RC4Cryptor.dll to the local queuing
base DLLs.
- Support for included examples
- Add BrokerDLL.dll to the local queuing
base DLLs.