IBM MQ Put Activity
Use this activity to place messages onto a queue.
Configuration
The Configuration tab has the following fields:
| Field | Description |
|---|---|
| Connection | Select the connection appropriate for this flow |
| GenCorrelationID | Enable to generate a unique correlation ID when the message is sent. This unique ID is displayed on the output schema for reference by any activity that needs it. |
| 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 Deserialiazer | Select one of the options:
String or
JSON.
If JSON is selected an 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 object that you selected on the Configuration tab. You can provide the input values in the Flogo Connector for mapping input fields directly or use Mapper to map the input values to a field from the output of a preceding activity in the flow.
The Input Settings tab has the following fields:
| Field | Description |
|---|---|
| Destination | Enter the queue name to which the message is sent. It can be overridden on the input tab. |
| Destination Queue Manager | Enter the name of the queue manager who owns the queue. Only supported for clustered queue managers. Can be overridden on the Input tab. |
| Schema for JSON Value | Enter a JSON schema for the message if the value deserializer was set to JSON. This schema is presented 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.
Note: The messages that are expected to contain properties can be mapped here. It is necessary to map properties that are used in the flow.
|
Input
The Input tab has the following fields:
| Field | Description |
|---|---|
| queue | Specify a destination here to override the queue name from Input Settings. With it, the queue can be dynamically specified. |
| queueMgr | Map a dynamic queue manager for the PUT operation. It is only supported for clustered queue managers. |
| MessageString | Map a string to this field. It is copied to the body of the message. |
| CorrelId | If GenCorrlationID is not specified on the Configuration tab then a value can be mapped here. If the value is base64 encoded it is decoded before being used, otherwise the bytes from the mapped string is used. |
| MsgId | Message IDs are normally generated by the queue manager to guarantee uniqueness, but can be overridden on the put. If the values is base64 encoded it is decoded before being used, otherwise, the bytes from the mapped string is 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 describing the queue manager's delivery priority. The default value is 0. |
| Expiry | Enter the number of tenths of a second for which the message stays on the queue before it is deleted. |
| ReplyToQ | Enter the name of the queue to which a reply can be sent. |
| ReplyToQmgr | Enter the name of the queue manager hosting the reply to the queue. This is only applicable for clustered queue managers. |
| UserIdentifier | Enter the user ID to be used when authorizing this message as it traverses the messaging system. For operations with report options, this field is mandatory. If a value is not provided here, it is taken from the connection resource if one is available there, and from the environment, if it is not. |
| AccountingToken | Enter a binary (base 64 encoded) accounting token to be used on host systems to assist in accounting for resources used by the application. |
| ApplIdentityData | Enter a string that can be used on all endpoints to identify this application. The maximum length is 32 bytes. |
| PutApplType | Enter value describing the sending application. For more information about this field on various platforms, see IBM MQMD documentation. |
| PutApplName | Enter the name of the application as determined by the client library. |
| ApplOriginData | Enter an additional information about the nature of the sending application. |
Output
The Output tab has the following fields:
| Field | Description |
|---|---|
| CorrelId | The correlation ID for the sent message. |
| MsgId | The message ID for the sent message. |
Iterator
Use the Iterator tab to iterate a certain piece of logic multiple times. If you leave this tab blank, the activity is executed only once. For more information about Iterator, see Using the Iterator in an Activity in the TIBCO Flogo® apps documentation.