Messaging Job

Control-M for Messaging enables you to send or receive a JMS or IBM WebSphereMQ Series message to the message queue of another application.

The following table describes the Messaging job type attributes:

Attribute	Description
Connection Profile	Defines the Messaging connection profile. Rules: 1-50 characters (uppercase only) Valid characters: Integers between 0 and 9, _ (underscore), - (dash, hyphen), A-Z characters
Action Type	Determines the action that the job performs, as follows: Use free text message Use predefined message Wait for reply only: Enables you to wait and consume a message from the reply queue/topic, as defined in the connection profile. Variable Name: %%MSG-REPLYMSGONLY By default, the Control-M for Messaging consumes the first available message in the queue. To consume the message with specific correlation id, add a job variable %%WJM_MSG_ID and set it to the correlation ID.
Use predefined message	Defines the content of the message as the previously defined text or binary file as the content of the message. Rules: 1-30 characters Any alphanumeric character, underscore, hyphen Variable Name: %%MSG-USEPREDEFINEDMSG
Use free text message	Defines the content of the free text message. Rules: Any alphanumeric and special characters. The period character (.) is not permitted. Certain special characters are internally represented by more than one character. For example, ampersand (&) is represented internally by three characters. Variable Name: %%MSG-USEFREETEXT
Advanced Messaging Settings	Enables you to change predefined message settings, as described in Advanced Message Settings.
Job Output Assignment	Enables you to save reply message into a chosen variable. Control-M rules: Up to 38 characters Any alphanumeric character, underscore, hyphen. Spaces and special characters are not permitted.
Job Output	Determines the content of the job output, with options as follows: Include with banner: Presents the job output with the banner. Include without banner: Presents the job output without the banner. Exclude job's output: Presents only the banner, and do not include information about the job output.

Advanced Message Settings

The following table describes the Advanced Message Settings attributes:

Attribute	Description
Outgoing Message	Defines the outgoing message.
Destination Queue/Topic	Defines the names of the message queues where the outgoing messages are sent, with options as follows: Default A string Rules: Characters: 1-212 Valid characters: Any alphanumeric characters, underscore, hyphen Invalid characters: Blank spaces Separate message queues with the comma. If the primary queue cannot be reached, the job uses the secondary queue. Variable Name: %%MSG-DESTINATIONQUEUE
Priority	Determines the level for prioritizing the messages that are to be routed to the Destination queue/Topic, with options as follows: Default 0-9 Variable Name: %%MSG-PRIORITY
Expiration Time (sec)	Defines the amount of time (in seconds) until the outgoing message expires, with options as follows: Default Any digit Rule: Invalid characters: Blank spaces Variable Name: %%MSG-OUTGOINGMSGEXPTIME
Reply Message	Defines the reply message.
Wait for Reply	Defines the waiting for messages in the reply message queue, with options as follows: Default A string Rules: Characters: 1-212 Valid characters: Any alphanumeric characters, underscore, hyphen Invalid characters: Blank spaces Separate message queues with the comma. If the primary queue cannot be reached, the job uses the secondary queue. Variable Name: %%MSG-WAITREPLY
Reply Queue/Topic	Defines the message queue where replies are sent, with options as follows: Default A string Rules: Characters: 1-212 Valid characters: Any alphanumeric characters, underscore, hyphen Invalid characters: Blank spaces Separate message queues with the comma. If the primary queue cannot be reached, the job uses the secondary queue. Variable Name: %%MSG-REPLYQUEUE
Time to Wait (sec)	Defines the amount of time (in seconds) to wait for incoming messages in the reply message queue, with options as follows: Default Any digit Rule: Invalid characters: Blank spaces Variable Name: %%MSG-TIMETOWAIT
Message Properties	For JMS Accounts only. Defines the outgoing message string properties. Specify a new key and corresponding value.
Property Name	Defines the property key name to be added to an outgoing message. Rules: Any digit between 1 and 212 characters Any alphanumeric character, underscore, hyphen Case sensitive Variable Name: %%MSG-PARMS-P00n-NAME Where n refers to the nth property. For example, if you want to define two properties, the first property would be %%MSG-PARMS-P001-NAME, and the second property would be %%MSG-PARMS-P002-NAME
Property Value	Defines the property value corresponding to the Property Name parameters. Rules: Any digit up to 212 characters Case sensitive Variable Name: %%MSG-PARMS-P00n-VALUE Where n refers to the nth property value. For example, if you want to specify two property values, the first value would be %%MSG-PARMS-P001-VALUE, and the second value would be %%MSG-PARMS-P002-VALUE.