HC_QRY_A19 Collaboration Template

The HC_QRY_A19 collaboration template processes MQWF_QRY_A19 business objects. The HC_QRY_A19 collaboration template uses data contained in the MQWF_QRY_A19 business object to build and populate an HL7 MTQRY request business object. The collaboration is generally used as one of a pair of closely coupled request/response collaborations. Data stored by HC_QRY_A19 (the request) is used by the HC_ADR_A19 collaboration (the response). The QRY/ADR request/response message pair is used to obtain patient identification and demographic data.

WebSphere MQ Workflow context data is stored to the PROCESSCONTEXT table.

This collaboration object performs the following tasks:

HC_QRY_A19 uses the generic MTQRY business object to represent an HL7 Patient Query message.

Collaboration object setup

This section includes information on port bindings and required steps for setting up collaboration objects based on HC_QRY_A19. For information on standard features, ports, and configuration properties for collaboration templates, and for general information on creating collaboration objects, refer to the documents listed in Required Documents for Creating Collaboration Objects.

Port information

The following diagram illustrates HC_QRY_A19's ports:

Note: To keep the collaboration object from using a port, bind that port to the Port connector. Doing so indicates that the port is unused without causing the collaboration object to provide additional functionality.

DestinationAppRetreive
Business object Bound to Function Verbs used
MQWF_QRY_A19 Source application's connector or calling collaboration object Sends a reference-valued business object to retrieve the full-valued business object. The result determines which verb is used. Retrieve
From
Business object Bound to Function Verbs used
MQWF_QRY_A19 Source application's connector or calling collaboration object Receives the triggering business object Create
To
Business object Bound to Function Verbs used
MTQRY Destination application's connector Sends the HL7 message business object out of the collaboration object Create

Setting up HC_QRY_A19 as a stand-alone object

To set up HC_QRY_A19 as a stand-alone collaboration object, complete the following steps:

  1. Create the HC_QRY_A19 collaboration object.
  2. Bind all ports as described in Port information.
  3. Configure HC_QRY_A19 as described in Configuration properties.

Collaboration template processes

This section illustrates the business processing logic for this collaboration template:

Overall process logic

This section illustrates this collaboration template's process logic for the supported verb, Create.

Create

The following diagrams show the process logic for this collaboration template's Create verb.

Diagram showing this collaboration's SyncLogic process

     SYNC_LOGIC diagram

Diagram showing this collaboration's Process HL7 message

     Process HL7 Message diagram

Diagram showing this collaboration's Save Workflow Process Context flow

     Save Workflow Process Context diagram

Diagram showing this collaboration's Create HL7 Message process

     Create HL7 Message diagram

Standard process logic

This collaboration template uses the following standard business processes:

Configuration properties

This section describes the standard and specific configuration properties for this collaboration:

Standard properties

This collaboration template uses the following standard configuration properties:

Collaboration-specific properties

This collaboration template has the following configuration properties specific to it:

DB_CONN_POOL_NAME

This property specifies the database connection pool.

DB_CONN_POOL_NAME configuration property
Default value Usage
HEALTHCARE_DB Defines the database connection pool used by the collaboration.

TRIGGEREVENTID

This property specifies a value used in the creation of a runtime process context key. This string should be no more than 3 characters in length.

TRIGGEREVENTID configuration property
Default value Usage
A19 Used as part of a unique process context database key. This ID is also used as the HL7 message trigger event ID. As a convention, use the HL7 message event trigger.

SQL_DUPLICATE_ERROR

This property defines the database duplicate row insert error code. It is used in the processing of the unique process context key.

SQL_DUPLICATE_ERROR configuration property
Default value Usage
SQL0803 Database error code returned in the event of a duplicate row insertion

Related reference

Copyright IBM Corp. 2002, 2003