Code base

Overview

The MQe application programming interface (API) is the programming interface to MQe. The MQe API supports the Java™ and C programming languages as follows:

The Java version: Provides access to all MQe function at Version 2. The detailed classes, methods, and procedures are described in the Java Programming Reference. Examples of MQe programming are given throughout this information center.

There are two versions of the C support:

The Native C code base

Provides access to a subset of MQe function, the main restriction being that only device queue managers can be used. Other restrictions are as follows (see also the table below):

Does not support store-and-forward queues or bridge queues
Supports the HTTP adapter only
Supports the RLE compressor only
Supports the RC4 cryptor only
Supports the MAttribute and local security features only

The detailed methods and procedures are described in the C Programming Reference. Examples of programming MQe for the C API are given throughout this information center.

The C Bindings

Supplied for use until the Native C code base provides full functionality. Your application calls the C API in the bindings, and the call is routed to the Java classes for MQe to carry out the function. The bindings were written for MQe Version 1, but still provide access to nearly all of the Java function in MQe Version 2. The detailed methods and procedures are described in the C Programming Reference. Examples of programming MQe for the C bindings are given in the C Bindings Programming Reference.

Types of queue manager

Throughout this documentation, and in the table below, the following queue manager descriptions are used, and it is important to distinguish between them:

Device queue manager: A queue manager with no listener component, and no bridge component. It therefore can only send messages, it cannot receive them.
Server queue manager: A queue manager that can have a listener added. With the listener it can receive messages as well as send them.
Gateway queue manager: A queue manager that can have a listener and a bridge added. With the listener it can receive messages as well as send them, and with the bridge it can communicate with MQ.

Table of options

Option	Java	Native C	C Bindings
Operating systems	Any with Java 2 (which began at Java Version 1.2)	PocketPC2002; PocketPC2003; Windows^® (from MQe V2.0.1.5 on);	Windows 32bit
Queue managers	Any	Device only	Any
Gateway to MQ (queue manager with bridge and listener)	Yes	No	Yes
Store-and-forward queues, bridge queues	Yes	No	Yes
Adapters	All	HTTP only	All
Compressors	All	RLE only	All
Cryptors	All	RC4	All
Security features	All	MAttribute and local only	All
Add messages to Trace	Yes	No	Yes
Event logging	Yes	No	Yes
Private registry and credentials	Yes	No	Yes
Attribute rules	Yes	No	Yes
Bridge rules	Yes	No	Yes
Classes for customizing	All	No	Some
Application loading	Yes	No	Yes