WebSphere MQ message properties set on messages written to destination queues

When transferring from file to message, WebSphere® MQ File Transfer Edition can set WebSphere MQ message properties on the first message written to the destination queue. Additional WebSphere MQ message properties are set when a file to message transfer has failed.

WebSphere MQ message properties allow an application to select messages to process, or to retrieve information about a message without accessing MQ Message Descriptor (MQMD) or MQRFH2 headers. For more information, see the WebSphere MQ version 7.0.1 online product documentation.

Standard properties

You can use the -qmp parameter on the fteCreateTransfer command or the fteCreateTemplate command to specify whether WebSphere MQ message properties are set on the first message written to the destination queue by the transfer. For an example of how to use this parameter, see the topic Example: Setting WebSphere MQ message properties on a file-to-message transfer

The WebSphere MQ message properties contain transfer metadata. The message property names are prefixed with usr.WMQFTE. The usr. prefix makes these message properties available to JMS applications.

usr.WMQFTETransferId
The unique hexadecimal transfer ID.
usr.WMQFTETransferMode
The type of file transfer: binary mode or text mode.
usr.WMQFTESourceAgent
The name of the source agent.
usr.WMQFTEDestinationAgent
The name of the destination agent.
usr.WMQFTEFileName
The name of the source file.
usr.WMQFTEFileSize
The size of the source file in bytes.
usr.WMQFTEFileLastModified
The last modified time of the source file. This value is in units of milliseconds, measured from 00:00:00 UTC, January 1, 1970.
usr.WMQFTEFileIndex
The index of the current file in the list of files that are being transferred. The first file in the list has index 0.
usr.WMQFTEMqmdUser
The MQMD user ID of the user that submitted the transfer request.

Failure properties

When a file to message transfer fails after the destination agent has written at least one message to the destination queue, WebSphere MQ File Transfer Edition writes a blank message to the destination queue. If the -qmp parameter is set to true, this blank message has two WebSphere MQ message properties set. For an example of a file to message transfer failure, see Failure of a file to message transfer.

The WebSphere MQ message properties contain information about the failure. As with the standard message properties, the message property names are prefixed with usr.WMQFTE and are available to JMS applications.

usr.WMQFTEReturnCode
The return code of the transfer. For a list of possible values for this return code, see the topic Return codes for WebSphere MQ File Transfer Edition.
usr.WMQFTESupplement
A supplementary message describing in more detail why the transfer failed.

User-defined properties

Metadata specified using the -md parameter with the fteCreateTransfer command can be set as WebSphere MQ message properties. If the -qmp parameter is set to true, any metadata specified by the user will be added to the message header of the first message.

The metadata name is prefixed by usr.. For example, if the metadata is department=accounts, the WebSphere MQ message header is set to usr.department=accounts.

You cannot use metadata to specify headers that begin with usr.WMQFTE or usr.com.ibm.wmqfte. If you specify metadata with a name beginning with WMQFTE or com.ibm.wmqfte this metadata is not used in the message properties and is ignored.


Reference Reference

Feedback

Timestamp icon Last updated: Tuesday, 30 January 2018
http://www.ibm.com/support/knowledgecenter/SSEP7X_7.0.4/com.ibm.wmqfte.doc/mq_message_properties.htm