Introduction
Configure the settings for the LLP Client destination component.
The LLP Client component transmits HL7 messages on a specified port using the LLP protocol.
From here you can choose host address and port, the message encoding type, choose LLP delimiters, ACKnowledgement settings, connection settings, and SSL settings.
- Click the Edit Channel button
- Enter your settings and click Save Changes
Host address
- Enter the IP address your domain name of the target machine
- You can use an environment variable (in the format ${VARIABLE_NAME}) in the host address field.
Port
- Specify the port number In the Port field. By default Iguana will automatically choose a port that is currently not in use
- In Iguana 6.1.2 and newer, you can use an environment variable (in the format ${VARIABLE_NAME}) in the port field.
Message encoding
- Choose the desired encoding from the Message encoding list box
- Check Escape 8-bit characters (HL7) to escape 8-bit characters in ACK messages
Tip: You can get much better control of escaping messages by using a Filter with a Translator script.
LLP delimiters
- (Optionally) choose custom LLP delimiters
Use SSL
- Check Use SSL to receive messages securely using SSL (Secure Socket Layer)
- Select the Private key file, this must be in PEM format and cannot be password protected
- Select the Certificate file, this must be x509 in PEM format and cannot be password protected
- Check Verify Peer to verify the server sending you messages, and enter the name of the Certificate authority file, which must be x509 in PEM format and cannot be password protected
- You can use the view certificate link to view the certificate details:
ACK Settings [top]
Wait for ACK
- Check this option to wait for an ACK before sending the next message
Note: All the other ACK settings are only showing when this is selected
ACK timeout
- Enter the number of milliseconds to wait for an ACK
ACK verification
- Select the type of ACK to use:
Acknowledgment verification | Meaning |
---|---|
Any Message | Treat any message sent back by the target machine as a valid acknowledgment. |
Any ACK Message | Use the VMD file provided in the Iguana install directory (ack_verify.vmd) to parse the acknowledgment and ensure that it is an HL7 message of type ACK. Iguana uses the message identity to verify that the acknowledgment is valid. |
Verified ACK Message | This option provides the strictest acknowledgment checking. The ack_verify.vmd file compares the MessageControlID field in the MSH segment of the original message with the corresponding field in the ACK message. The acknowledgment message must be of type ACK.You can add even more stringent acknowledgment verification by adding fields to the MSH table in the VMD file and mapping them to the fields that you want to compare in the messages. For example, you might want to compare the message type in the acknowledgment message to the message type in the original message. For more information on how to create a custom VMD file to perform ACK verification, see the ack.vmd file in the code repository. |
ACK VMD
- Select the VMD file to verify the ACK
The default file ack_verify.vmd is usually sufficient
Attempt to resend message
- Choose when to attempt re-sending a message
Number of resend attempts
- Enter the number of re-send attempts
Note: This field is only displayed if you chose to attempt re-sending messages
Disconnect between resend attempts
- Check the box to disconnect between re-send attempts
- Enter the time to wait in milliseconds
Note: This field is only displayed chose to disconnect
ACK error handling
- Select the error handling option from the listbox
Persistent connection?
- Choose whether or not to persistently connect to the remote host
- If you choose to disconnect after timeout enter the number of milliseconds
Attempt to reconnect?
- Select the option from the listbox
- If you chose Yes, with limit enter the number of retries
Reconnection interval
- Enter the reconnection interval and milliseconds