Working With the PIX/PDQ Manager

ProcedureTo Run HL7 V2 Data

Before You Begin

Make sure the GlassFish server is running and the HL7 simulator is configured correctly. Configuring the HL7 simulator is specific to the type of simulator you are using. Generally, you should only need to configure it to use the HL7 v2 listening URL, which is defined in the sunpixmgr-v2–url application variable for the HL7 Binding Component (by default, hl7://localhost:3600).


Note –

Each group of test files has a readme file that you should review to learn how each file should be processed and what the expected results should be.


  1. Navigate to the location where you installed the PIX/PDQ projects, and then to hcpbuild/smoketest/data.

    This folder contains a complete set of HL7 v2 files. It also contains subdirectories that each contain a subset of the test files that perform specific functions.

  2. From your HL7 simulator, do any of the following:

    1. To add records for the same person with different aliases and then perform both PIX and PDQ queries against the data, run the files under the /TestJamesnameStandardization subdirectory in alphanumeric order (this is the order in which they are displayed by default).

    2. To perform the same processing as above on a new patient, run the files under the /TestPlainJane subdirectory in alphanumeric order.

    3. To perform the same processing as above and include a merge transaction, run the files under the /TestSamuelMerge subdirectory.

      These test also include a PIX query that should return no results.

  3. To process additional records into the system, copy any of the test files and modify the message data as needed. Then process those files using the HL7 simulator.

  4. After you process any of the files through the system, you can view audit records and message tracing, content, and extensions from the PIX Console.

    For more information, see Viewing Messages and Auditing the PIX/PDQ Manager.