• Introduction
• View Pending & Processed Messages
• Resubmit a Single Message
• Resubmit Multiple Messages
• Skip Processing Messages
• Resubmit Messages Using the HL7 Simulator
• How the Preview Panel works
• Reposition the Queue in Pictures
• More Information

Introduction

You can Resubmit single log messages, or multiple log messages. Messages can be re-sent to the same channel or forwarded to a different channel.

To resubmit multiple messages you Reposition the queue for a channel to re-start processing from a specified message. You can also reposition the queue to omit processing a group of messages.

You can also use the HL7 Simulator to resubmit batches of messages to any channel that uses an LLP Listener as the source component. This method has one major advantage, you can use any log query (i.e., a time range) to select the messages to resubmit.

You must be a member of the Administrators Role to Resubmit messages and Reposition the logs, see Roles for more information.

View Pending & Processed Messages [top]

You can view Pending and Processed messages in the Logs screen just like any other message. If a channel From Channel source component then you will need to select the source channel(s) to include messages from those channel(s).

There are two ways to view Pending and Processed messages in the Logs screen:

1. Click the link in the Queued column in the Dashboard:
   1. Clicking the “1” (can be any number) link for LLP End Channel will show Pending, and Processed and other messages:
      
   2. Clicking a “0” link will show any Processed and other messages:
      
2. View the channel messages in the Logs screen and select the desired channel:
   1. This channel does not have a From Channel source component so you can see the Pending and Processed messages:
      
   2. This channel has a From Channel source component so we had to select the source channel HL7 SIM to QUE to see the Pending and Processed messages:

Resubmit a Single Message [top]

If an HL7 message has been logged, you can re-send the message from the Iguana logs screen. This is useful if an unexpected problem occurs at the receiving end or if you want to forward the message to a different channel.

To resubmit a message:

1. Click the Logs tab.
2. Scroll through the messages to find the one you want to resubmit, or use the search feature.
3. Click the message to view it.
4. Click to display the resubmit screen:
   
5. Click to display the log message resubmit screen:
   
6. From the Resubmit To Channel list box, select the channel to resubmit to:
   
7. You can edit the message in the upper panel. As you edit the message changes are shown in the lower Preview panel.
8. Click Resubmit to resubmit the message, or Cancel to return to log messages.

Resubmit Multiple Messages [top]

There are times when you need to resubmit messages through Iguana, for example:

1. You are bringing a new system live which you need to ‘back populate’ with historical data.
2. An application has failed to process messages due to database or other failure and requires reprocessing several days worth of data etc.
3. There was an integration (mapping/logic) error in which requires reprocessing of affected messages.

These scenarios are very easy to deal with in Iguana since you can requeue messages in a few mouse clicks.

To reposition a channel to resubmit multiple messages:

1. Select the channel to reposition from the Channel list box in the Search Criteria panel:
   
2. If the channel has a From Channel source component, select the source channel that you want to display and reposition. (See Selecting The Source Channels Of A ‘From Channel’ Source Component To Display for details on how to do this.)
3. From the Type list box, select Messages:
   
4. Locate the Processed message to restart from:
   1. Click the Last Processed Message link to view the last message processed by the channel:
      
   2. Scroll down to find the message to restart from.
      Note: This method works well for resending a few messages.
   3. If you need to resend a large number of messages, then you can use a Text Query to identify the message to restart from:
      
5. Click the PROCESSED button at the left side of the chosen message:
   
6. Click Start Here to re-send messages (including the current message) :
   Note: To resend messages excluding the current message click After This Message.
   

Tips for resending Messages

Scenario: You know the first bad message. For example you discover bad data in your database beginning with Gary Adams (see above). In this case you need to reprocess all the messages including Gary Adams.

• Follow the resubmit procedure above, and in select Start Here in step six to begin reprocessing including Gary Adams.

Scenario: You know the last good message. For example you discover missing data in your database and you identify that Gary Adams was the last record that was successfully processed. In this case you need to reprocess all the messages excluding Gary Adams.

• Follow the resubmit procedure above, and in select After This Message in step six to begin reprocessing excluding Gary Adams.

Shortcuts for listing the messages for a channel. Here are a couple of alternatives to selecting the channel in the logs window (as we did in the procedure above).

In the dashboard you can click the Queued link for a channel:

• A numbered link will include pending and processed messages
  (In this case 01-File to Socket has 85 pending messages)
• A link with zero will only include processed messages

You can also click the Queued link in the properties for a channel:

Skip Processing Messages [top]

There are times when you need to skip processing for one or more queued (pending) messages, for example:

• Messages were sent in error and you don’t want to process them
• Messages contain invalid data
• Messages contain errors and are stopping the channel

Skipping messages is almost identical to resubmitting messages, the only difference is that you select a Pending message to restart from instead of a Processed message. All Pending messages prior to the message you restart from will be marked as Processed.

To reposition a channel to skip processing for one or more messages:

1. Select the channel to reposition from the Channel list box in the Search Criteria panel:
   
2. If the channel has a From Channel source component, select the source channel that you want to display and reposition. (See Selecting The Source Channels Of A ‘From Channel’ Source Component To Display for details on how to do this.)
3. From the Type list box, select Messages:
   
4. Locate the Pending message to restart from:
   Note: All Pending messages prior to the selected message will be marked as Processed.
   1. Click the Last Processed Message link to view the last message processed by the channel:
      
   2. Scroll up to find the message to restart from.
      Note: This method works well for skipping a few messages.
   3. If you need to skip a large number of messages, then you can use a Text Query to identify the message to restart from:
      
5. Click the PENDING button at the left side of the chosen message:
   
6. Click Start Here to  skip messages prior to the current message:
   Note: To skip messages including the current message click After This Message.
   

Resubmit Messages Using the HL7 Simulator [top]

You can use the HL7 Simulator makes it easy to resubmit batches of messages to any channel that uses an LLP Listener as the source component. The advantage the advantage of this method is that you can use any log query (i.e., a time range) to select the messages to resubmit.

This procedure is also useful when you want to send a batch of messages to a different channel. You could use another channel to test code changes, or you might wish to forward some messages to a different destination.

To resubmit a batch of messages using the HL7 Simulator:

1. Export the log messages to be resubmitted to a text file.
   Note: Use the (default) export option One entry per line which creates a file that the Simulator can use as input.
2. Verify that the messages are error-free before attempting to resubmit them.
3. Stop the channel that has the LLP Listener source component.
4. Temporarily change the port number that the channel uses
   • Record the original port number for later reference
   • Change the port number
   • Click Save

     Note: Your live HL7 feed will not be processed until the original port number is restored at the end of this procedure.

5. Re-start the channel that has LLP Listener as the source component:
   
6. Run the HL7 Simulator utility.
7. In the Port field, specify the temporary port number of the channel.
8. In the Message File field, specify the text file you exported containing the messages that you want to resubmit.
9. In the Time delay (ms) field, change the default value from 1000 to 100. This will increase the speed in which the Simulator sends the messages to your target.
10. Ensure that the Stop sending messages at the end of file option is checked.
11. Click the Start button to begin sending messages to your target destination component.
12. While the messages are being sent, check the logs and verify that the resubmitted messages are now being processed successfully. If you are still receiving errors, you may want to check that the structure of the messages is correct and/or check the status of your server.
13. After all the messages have been successfully processed, stop the channel and change the port number back to its original value, then click Save Changes.
14. Restart your channel, to resume processing of your live HL7 feed.

How the Preview Panel works [top]

What appears in the Preview panel depends on the destination component of the channel to which you are sending the message. If the channel has a destination component of To Database, the Preview panel displays the SQL command that will be sent to the database:

For channels with a destination component other than To Database, the message to be resent is displayed in Segment View format:

You can control how the message is to be displayed in the Preview panel. The option buttons available depend on the destination component of the channel to which you are resubmitting the message.

These are the view options in the preview pane (not all options are available for every message):

Button	View Mode	Description
	Hex-dump	View the log message in hexadecimal format.
	Plain-text	View the log message in text format.
	Segment View	View the segments that are defined in this message. This is the default for all messages except those being sent to channels whose destination component is To Database.
	Segment Grammar View	View the segments in the segment grammar of the message definition that processed this message. This view mode is available only if this is a message that is being resubmitted to a channel whose destination component is To Database.
	Table View (Graphical)	Parse the message and view the generated tables in graphical format. This button only appears if this message is being resubmitted to a channel whose destination component is To Database.
	Table View (Plain-text)	Parse the message and view the generated tables in text format. This button only appears if this message is being resubmitted to a channel whose destination component is To Database.
	SQL View	Parse the message and view the SQL statements that add this message to the database. This button only appears if this message is being resubmitted to a channel whose destination component is To Database. In this case, this view is the default for the Preview panel.

Reposition the Queue in Pictures [top]

There are four possible combinations when you reposition the queue, these are explained below.

1. PROCESSED + Start here
   If the message has previously been processed (the button you clicked was PROCESSED) and you have clicked Start here, the source position of the channel is moved back to just before this message, and this message is reprocessed by the channel. Any messages that arrived later than this message that have already been processed are also reprocessed:
   
2. PROCESSED + After this message
   If the message has previously been processed (the button you clicked was PROCESSED) and you have clicked After this message, the source position of the channel is set to be this message, and all messages after this one are processed by the channel. Any messages after this one that have already been processed are reprocessed:
   
3. PENDING + Start here
   If the message is waiting in the message queue (the button you clicked was PENDING) and you have clicked Start here, the source position of the channel is moved ahead to just before this message, and this message becomes the next message processed. If there are messages that arrived before this message that have not yet been processed, these messages are skipped:
   
4. PENDING + After this message
   If the message is waiting in the message queue (the button you clicked was PENDING) and you have clicked After this message, the source position of the channel is set to this message. This message is skipped, and any messages that arrived before this message are also skipped:
   

   Note: If this message is the last message in the queue, clicking PENDING and After this message empties the message queue without processing any of the messages.

More information [top]

• Sending and receiving HL7 test messages
• Using the HL7 Simulator on Linux and Mac
• Send HL7 sample data using LLP Client