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 Launcher, the message ID can be specified with wildcard notation. For more information about wildcard notation, see the Launcher documentation.

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.

When a message ID is specified for a target, the adapter places the message on the queue with that message ID assigned. If this command is not specified for a target, the message is put on the queue using a unique message identifier generated by the queue manager.

For targets only, if the Header adapter command (-HDR) is used in conjunction with the Message ID adapter command (-MID), the Header adapter command (-HDR) takes precedence over the Message ID adapter command (-MID), which is ignored.