Queue Integration Process (IP) settings use a Unique Message
Identification to determine whether or not to process a message. When defining a Queue IP, keep in mind:
The message is handed off to the source connection in the DTS.
Associate a Queue IP with a DTS configured for the XML dynamic
connection method on the source.
In the DTS Parameters, do not specify /SD=%Filename.
Set queue IP settings
Define in Message Identification the criteria that identify incoming messages that
need to be processed.
To configure an IP to accept any field value for processing, enter an asterisk (*) in that field. Only one IP can be configured to accept any value for any field.
Message label — Associates a message type with the Integration Process.
Scribe label — Associates with the ScribeLabel root node
attribute in the message body.
For example, in the following, CompanyContactData is the RootNodeName, and
ScribeLabel must be used:
<CompanyContactData ScribeLabel="MyScribeLabel">
XML root node — Associates with the root node name found in the message body.
XML schema — Specifies the Scribe-specific schema file that is used by the associated
DTS to process the data. The schema file pathname is available to label an integration process, but it does
not perform any tasks as part of the collaboration. The schema file is installed in
*\Public\Public Documents\Scribe\Collaborations\<collaboration name>\ and has a filetype of .xdr.
Each Queue IP must contain unique values for each field.
Click Browse to navigate to a schema file.
Click Open to view the specified schema file.
Note: If one message meets the criteria for more than one Queue IP, it is
retrieved by the process that includes message label in its Unique Message Identifier.
If no process includes message label, the message is retrieved by the process that includes
the Scribe label in its Unique Message Identifier, followed by XML schema, and finally by the XML root
node name.
On the On Success tab, specify the actions to take when message processing succeeds:
Forward Message to Queue checkbox — Forwards the message to another queue.
Select a queue from the drop-down list:
SCRIBEDEADMESSAGE
SCRIBEIN
SCRIBERETRY
Only queues that have been exposed in Security Settings are available.
Message label — Changes the Message label. If you put the message back into the
Scribe Input queue without changing the label, the message is retrieved by the same
IP. A double quotation mark (") keeps the existing value.
Scribe label — Changes the Scribe label. If you put the message back into the
Scribe Input queue without changing the label, the message is retrieved by the same
IP. A double quotation mark (") keeps the existing value.
Note: If you forward the message back to the Scribe Input queue, the message
can be retrieved by another IP.
Message Priority — Changes the priority for this message. Priority
ranges from 0 (lowest) to 7 (highest). The default priority is 3 (normal). If you do not
specify a priority, the original priority is used.
On the On Retry tab, specify how many times to retry a message before
moving it to the queue specified in the On Failure tab.
Allow retries before failing a message — Specifies the number of time so try
processing a message before failing that message. Quantities range from 0 to 100. An XML
message is moved from the Input queue to the Retry queue after the first time it fails to
process.
The default value is 120. Messages are retried about every 5 seconds,
the message is retried for about 10 minutes.
Note: To set the retry count for the DEFAULT or user-defined processor group, you must modify the Scribe Internal Database. For more information, see Adjust the IP Retry Count.
On the On Failure tab, specify how to manage a message after it has retried and
failed the specified number of times. Similar to On Success, but allows you to move a message to more
than one queue.
Forward message to Scribe dead message queue — Sends the failed
message to the Scribe Dead Message queue. This is the default.
Forward message to other queue — Forwards the message to a queue
other than the Dead Message queue.
Only queues that have been exposed in Security Settings are available.
Message label — Changes the Message label. If put the message back into the Scribe
Input queue without changing the label, the message is retrieved by the same Integration
Process. A double quotation mark (") keeps the existing value.
Scribe label — Changes the Scribe label. If put the message back into the Scribe
Input queue without changing the label, the message is retrieved by the same Integration
Process. A double quotation mark (") keeps the existing value.
Message Priority — Changes the priority for this message. Priority
ranges from 0 (lowest) to 7 (highest). The default priority is 3 (normal). If you do not
specify a priority, the original priority is used.
If you forward the message back to the Scribe Input queue, the message can be retrieved by
another IP.
Note: A technique to consider is to forward the message back to the Input queue with a
different label. You can then use another IP to retrieve the message from the Input
queue to process errors and undo incomplete changes (sometimes referred to as a "compensating
transaction").
In the Message label and Scribe label fields, specify the labels to apply. If you do not specify new labels
and put the message back into the Scribe Input queue, the message is retrieved by the same
IP.
Specify a double quotation mark (") to keep the existing
value.
Note: If you forward the message back to the Scribe Input queue, the message can be
retrieved by another IP.
Optionally, select in Message Priority the priority to be applied to this message. Priority
ranges from 0 (lowest) to 7 (highest). To change the priority from the default setting (Keep
Original), select a priority level from the drop-down list.
When defining Queue IP settings, keep in mind:
The message will be handed off as the source for the DTS.
Make sure to associate a Queue IP with a DTS configured for the XML dynamic connection
method on the source.
In the DTS Parameters, do not specify /SD=%Filename.