IBM MQ Publish Activity
Use this activity to publish a message to a topic.
Configuration
The Configuration tab has the following fields:
| Field | Description |
|---|---|
| Connection | Select the connection appropriate for this flow |
| Context Support | Select any one of the available options: Default, Identity, or All context to access the corresponding fields. Specific permissions are required on the server to set values in the fields corresponding to these contexts. |
| Message Type | Select one of the available options: Datagram, Request, or Reply to configure an appropriate type of message. |
| Value Deserializer | Select one of the options:
String or
JSON.
If JSON is selected a entry area for the JSON schema is provided. |
Input Settings
The Input Settings tab displays the input schema of the activity as a tree structure. The schema varies according to the Value Deserializer field you selected on the Configuration tab. The values entered on the Input Settings tab are static and optional. They can be overridden on the Input tab.
The Input Settings tab has the following fields:
| Field | Description |
|---|---|
| Topic Name | (Optional) Enter the name of the administratively defined topic. For an indication of the actual topic string to which it relates, see the topic definition on the server.
It is mandatory to provide Topic field or Topic Dynamic field either on the Input Settings tab or the Input tab. |
| Topic Dynamic | (Optional) Enter the dynamic part of the topic name. The contents of this field are apended to the topic string represented by the
Topic field.
It is mandatory to provide Topic field or Topic Dynamic field either on the Input Settings tab or the Input tab. |
| Retain Publication | Enable this field to retain this publication for offline subscribers. |
| Schema for JSON Value | Enter a JSON schema for the message. This schema is displayed on the Input tab. |
| Properties | Click Add Row button to add each string property. Properties are displayed on the input schema under the MessageProperties node. |
Input
The Input tab has the following fields:
| Field | Description |
|---|---|
| Topic | (Optional) Map the name of the administratively defined topic. For an indication of the actual topic string to which it relates, see the topic definition on the server.
It is mandatory to provide Topic field or Topic Dynamic field either on the Input Settings tab or the Input tab. |
| Topic Dynamic | (Optional) Map the dynamic part of the topic name. The contents of this field are apended to the topic string represented by the
Topic field.
It is mandatory to provide Topic field or Topic Dynamic field either on the Input Settings tab or the Input tab. |
| MessageString | Map a string to this field. It will be copied to the body of the message. |
| Retain | Enter a boolean value to turn the message retention on or off in the server. |
| Field | Description |
|---|---|
| CorrelId | Map a correlation ID here. If the values is base64 encoded it will be decoded before being used, otherwise the bytes from the mapped string will be used. |
| MsgId | Message IDs are normally generated by the queue manager in order to guarantee uniqueness, but can be overridden on the put. If the values is base64 encoded it will be decoded before being used, otherwise the bytes from the mapped string will be used. |
| Encoding | Specifies the encoding of floating point data in the message. |
| CodedCharSetId | Specifies the encoding for string data in the message and its properties |
| Format | A free form of a string variable which describes the format of the message. The default value is MQSTR. |
| Priority | An integer field which is set to the message property. The default value is 4 but it can be overridden by the sending application. |
| Expiry | The number of tenths of a second for which the message stays on the queue before it is deleted. |
| ReplyToQ | The name of the queue to which a reply can be sent. |
| ReplyToQmgr | The name of the queue manager hosting the reply to the queue. This is only applicable for clustered queue managers. |