Cross API changes
The Bindings use MQeAttributeHndl as a base type for many differnet types
of attributes. These types have been more tightly specified, for example getMessage
calls take MQeFieldsAttrHndl.
The Bindings used a wrapper around the Java Enumeration classes. This has
been replaced with a native MQeVector. The major change here is in terms of
memory management. This is detailed in the Programming Reference/Examples/HTML
reference guides.
Note:
Specific sections of the API are referenced
in the following sections. Note that the main headerfile MQe_API.h should
always be included rather than specific API header files.
mqeQueueManager APIs
The following warnings are applicable to :
- QM_01
- QueueManager new parameters change. NAtive C requires the parameters,
queue manager and registry, to be supplied in the new function rather than
activate.
- QM_02
- QueueManager activate - > mqeQueueManager_start().
no longer requires additional params, see QM_01.
- QM_03
- No message listener currnetly in native C.
- QM_04
- Browse Messages attribute handle type is now MQeFieldsAttrHndl. Messages
are now returned in an MQeVector.
- QM_05
- As QM_04 but for browseAndLock.
- QM_06
- mqeQueueManager_close is replaced with mqeQueueManager_stop.
- QM_07
- mqeQueueManager_getMessage attribute hndl.
- QM_08
- mqeQueueManager_getReference API has changed to mqeQueueManager_getCurrentQueueManager.
- QM_09
- mqeQueueManager_putMessage attribute hndl.
- QM_10
- Message Listener not currently supprted in native C.
- QM_11
- mqeQueueManager_waitForMessage not currently supported in native C.
- QM_12
- mqeQueueManager_setGlobalHashtable not supported in native C
Fields API
- Fields_01
- FieldEnumeraion deprecated, replace with MQeVector.
- Fields_02
- mqeFields_getAttribute.
- Fields_03
- Get and Put array length not supported in native C.
- Fields_04
- mqeFields_setAttribute attribute handle.
- Fields_05
- mqeFields_putDoubles() is deprecated. Use mqeFields_putArrayOfDouble()
instead.
- Fields_06
- mqeFields_putFloats is deprecated. Use mqeFields_putArrayOfFloat() instead.
- Fields_07
- mqeFields_putInt32s is deprecated. Use mqeFields_putArrayOfInt32() instead.
- Fields_08
- mqeFields_putInt64s is deprecated. Use mqeFields_putArrayOfInt64() instead.
- Fields_09
- mqeFields_putInt16s is deprecated. Use mqeFields_putArrayOfInt16()
instead.
- Fields_10
- mqeFields_putBytes is deprecated. Use mqeFields_putArrayOfByte() instead.
- Fields_11
- mqeFields_getDoubles() is deprecated. Use mqeFields_getArrayOfDouble()
instead.
- Fields_12
- mqeFields_getFloats() is deprecated. Use mqeFields_getArrayOfFloat()
instead.
- Fields_13
- mqeFields_getDoubles() is deprecated. Use mqeFields_getArrayOfInt32()
instead.
- Fields_14
- mqeFields_getInt64s() is deprecated. Use mqeFields_getArrayOfInt64()
instead.
- Fields_15
- mqeFields_getInt16s() is deprecated. Use mqeFields_getArrayOfInt16()
instead.
- Fields_16
- mqeFields_getBytes() is deprecated. Use mqeFields_getArrayOfByte() instead.
Constants
WebSphere MQ Everyplace still supplies the full range of constants. New constants are thelist
of constants to construct MQeMqMsgObjects from first principles. Specifiy
MQeM.
- MQe_Adapter_Constants.h
- MQe_Admin_Constants.h
- MQe_Attribute_Constants.h
Administration messages
The native C implementation provides a fields implemention. The various
subtypes though of fields, such as Administration messages are not supplied.
A number of helper methods are provided to help construct the usual WebSphere MQ Everyplace Messages.
Various other subclasses of message can be constructed from a basic fields
object, the required constants for the field labels, and the mqeFIelds_setClassName
method. This method sets a field indicated what class this must be when reinstantiated
in a Java queue manager.
Configuration and administration
MQe_QueueManagerConfigure.h is not applicable to the nativeC
codebase. A new API defined by MQe_Administrator.h is provided.
This allows configuration of the queue manager.