Data Transformation Engine IBM WebSphere MQ Adapter Reference Guide

Chapter 3 - IBM WebSphere MQ Commands List of Commands
IBM WebSphere MQ Adapter Reference Guide
40
You must always specify a value when using the
-FORMAT adapter command.
Failure to do so will result in map failure and a corresponding error message is
generated.
Note If you use a user-defined format, you must also provide the corresponding data-
conversion exit so that receiving applications can read the message using the
MQGMO_CONVERT option. For Mercator applications, this means using the -CVT
adapter command for the IBM WebSphere MQ inputs.
If the message format is not provided (either with the usage of the
-FORMAT
adapter command or through the message descriptor type tree with the
-HDR/-DH adapter command), the MQFMT_STRING message format is used as a
default value.
Message ID (-MID)
Use the Message ID adapter command (-MID) to specify a particular message ID
for a data source or target.
-MID [
message_ID ]
Option Description
message_ID
A message ID can be up to 24 bytes long and may
contain spaces.
If the value contains a space, it must be enclosed with double quotation marks as
shown in the example below:
-MID "my ID"
The double quotation mark character can also be used as part of a value. To do
this, the double quotation mark value must be represented by a pair of double
quotation marks. For example, if you wanted to specify a message ID of
My "New" ID, you would need to enter the following:
-MID "My ""New"" ID"
When using the Event Server, the message ID can be specified with wildcard
notation. For more information about wildcard notation, refer to the Event Server
Reference Guide.
When a message ID is specified for a data source, the adapter retrieves the first
message with the designated message ID. If no argument is supplied, the
message ID of the first message retrieved will be used.