Binary and character strings

Methods that set character (char *) data always take a copy of the data, but some methods might truncate the copy, because certain limits are imposed by WebSphere MQ.

The ImqString class (see ImqString) encapsulates the traditional char * and provides support for:

• Comparison

• Concatenation

• Copying

• Integer-to-text and text-to-integer conversion

• Token (word) extraction

• Uppercase translation

The ImqBinary class (see ImqBinary) encapsulates binary byte arrays of arbitrary size. In particular it is used to hold the following attributes:

• accounting token (MQBYTE32)

• connection tag (MQBYTE128)

• correlation id (MQBYTE24)

• facility token (MQBYTE8)

• group id (MQBYTE24)

• instance id (MQBYTE24)

• message id (MQBYTE24)

• message token (MQBYTE16)

• transaction instance id (MQBYTE16)

Where these attributes belong to objects of the following classes:

• ImqCICSBridgeHeader (see ImqCICSBridgeHeader)

• ImqGetMessageOptions (see ImqGetMessageOptions)

• ImqIMSBridgeHeader (see ImqIMSBridgeHeader)

• ImqMessageTracker (see ImqMessageTracker)

• ImqQueueManager (see ImqQueueManager)

• ImqReferenceHeader (see ImqReferenceHeader)

• ImqWorkHeader (see ImqWorkHeader)

The ImqBinary class also provides support for comparison and copying.