Using the HL7 Binding Component

Quality of Service (QoS) Properties

The QoS attributes are configured from the QoS Properties Editor, accessed from the Composite Application Service Assembly (CASA) Editor. For an example of how to access the QoS Properties Editor, see Using Message Throttling.

Service Name (Consumer)

Specifies the consumer service name. Provides a list of preexisting namespaces. Click the ellipses button to open the QName Editor.

Example: ns1:http://j2ee.netbeans.org/wsdl/HL7V2InboundProject/hl7receive

Endpoint Name (Consumer)

Indicates the consumer endpoint name.

Service Name (Provider)

Specifies the provider service name. Provides a list of preexisting namespaces. Click the ellipses button to open the QName Editor.

Example: ns1:http://j2ee.netbeans.org/wsdl/HL7V2InboundProject/hl7receive

Endpoint Name (Provider)

Indicates the consumer endpoint name.

Max Attempts (Redelivery Extension)

Specifies the number of retries to attempt before using the On Failure option.

Example: 20

Wait Time (Redelivery Extension)

Specifies time (in milliseconds) to wait between redelivery attempts.

Example: 300

On Failure (Redelivery Extension)

Specifies the type of action to be taken when message exchange (ME) redelivery attempts have been exhausted.

The On Failure options are:

  • Delete: When the final defined delivery attempt has failed, the QoS utility abandons the message exchanges (ME) and returns a Done status to the JBI component, which proceeds to its next process instance. This option is only supported for In-Only message exchanges.

  • Error: When the final defined delivery attempt has failed, the QoS utility returns an Error status to the JBI component, and the JBI component throws an Exception. This is the default option, and is supported for both In-Only and In-Out message exchanges.

  • Redirect: Similar to the Delete option, except that the QoS utility reroutes the ME to the configured redirect endpoint when the maxAttempts count has been exhausted. If the QoS utility is successful in routing the message to the redirect endpoint, a Done status is returned to the JBI component; otherwise, an Error status is returned. This option is supported for In-Only message exchanges only.

  • Suspend: The QoS utility returns an Error status to the JBI component if it is not able to deliver the ME to the actual provisioning endpoint. After the re-delivery attempts have been exhausted, the JBI Component suspends the process instance. This option is only supported if monitoring is enabled in the JBI Component, since the user must use the monitoring tool to resume a suspended instance. This option is supported for both In-Only and In-Out message exchanges.

Example: Delete

Maximum Concurrency Limit (Throttling Extension)

Specifies the maximum number of concurrent messages that can be processed on a specific connection. This number is used to set up the maximum number of concurrent messages that the internal endpoint sends to the provider endpoint.

Example: 10