When Queue Integrations process records successfully, the original XML message is deleted.  If the values mapped to the Target are not what is expected, capturing the original XML message can be useful in troubleshooting the process.

Queue based Integrations can send the XML message taken from the ScribeIn queue to another designated queue.  To capture processed XML messages, do the following:

• Create a new queue in Windows Computer Management.
• Expose the new queue in Scribe Console Security.
• Set your Scribe Integration Process to send the XML messages to the queue after processing.

NOTE:  These Queues are created manually and must be purged manually.  Queues have a default storage limit of 1 GB, which can be increased to 4 GB, but should be purged or deleted once diagnostics are complete. 
 

Creating A New Queue

1. In Windows, open Computer Management.
2. Select Services and Applications > Message Queuing.
3. Right-click Private Queues and select New > Private Queue.

   

4. On the New Private Queue dialog, give the Queue a descriptive name, such as one containing the name of the Integration that sends the processed XML messages.
5. Click OK.

   

6. Right-click the new Queue and select Properties.

 

7. Select the Security tab in the Properties dialog.
8. In Group or user names, select Everyone.
9. In Permissions, check Allow next to Full Control.
10. Click OK to save and close the Properties window.

 

Exposing The New Queue In TIBCO Scribe® Insight Console Security

1. Open the TIBCO Scribe® Insight Console.
2. In the tree, select Administration > Security
3. On the Security Settings window select the Message Queues tab. The new Queue displays in the Known Message Queues list.
4. Select the Queue and click the right > button to add it to Shared Message Queues.
5. NOTE: If the queue does not appear in Known Message Queues it can be copied from the General tab of the Properties window for the Queue in Computer Management. Copy the Queue into the Enter Message Queue Name field then click the > button to the right of the field.
6. Click Save at the top of the window.

 
Once the Queue has been shared in Security it appears in the Queue Browser under Other Available Queues.

   

Configuring The TIBCO Scribe® Insight Integration Process
 

1. In the TIBCO Scribe® Insight Console, select Integration Server > Integration Processes.
2. Open the Integration Process that will send its processed XML messages to the new Queue and click on Step 3.
3. Select the On Success tab in the right half of the Event Settings step.
4. Check the box next to Forward Message to Queue.
5. Select the new Queue from the drop-down list.

   

6. In the On Success tab, leave the quote mark (“) in the Message label and Scribe label fields to retain the same labels from the original message.
7. Click Finish to save the change.

 

XML messages successfully processed by this Integration are saved to the selected queue.  For any records that do not process as expected the XML can be traced out and the input data reviewed.

 
IMPORTANT: There is no mechanism to automatically purge this queue. It must be purged manually.  When you no longer need to troubleshoot, open the Integration and uncheck the Forward Message to Queue in Step to stop the XML files from being sent to the selected queue. 


 

When TIBCO Scribe® Insight Queue Integrations process records successfully, the original XML message is deleted. If the values mapped to the Target are not what is expected, capturing the original XML message can be useful in troubleshooting the process.

For additional information, see the following in the TIBCO Scribe® Insight Help: Message Queue Security, Queue Integration Settings