Working With the PIX/PDQ Manager

Running Data Through the PIX/PDQ Manager

Sun provides both HL7 v2 and HL7 v3 sample data for you to run through the PIX/PDQ system to help you get started with the applications. To enter the HL7 v2 sample messages, you need an HL7 simulator. There are several available on the internet. The HL7 v3 data is provided in the form of test cases that are run from the HL7 v3 composite application project.

The sample data illustrates several scenarios for data processing. You add new records, update existing records, cause assumed matches in Master Index, perform PIX queries for associated local identifiers, perform demographic queries, and perform merges. The data was designed to be run in a specific order to get the expected results from PIX and PDQ queries.

Before you can run these test, you need to run a database script to add system information to the midm database, as described below. Without this data, the sample tests will fail.


Note –

You can modify the HL7 v2 sample files and the HL7 v3 test input files to insert additional records into the master index database. If you modify the HL7 v2 sample files, be sure to use an editor that does not automatically convert \r to \r\n, such as UltraEdit.


ProcedureTo Add Required Systems to the Database

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

  2. Log into the midm database from a SQL prompt or editor as the midm user.

  3. Run the pixpdq_configuration_data.sql file against the database.

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.

ProcedureTo Run HL7 V3 Data

Before You Begin

Make sure the PIXPDQ_HL7V3_Direct_ca project is open in the NetBeans IDE and the GlassFish server is running. Run these tests in the


Note –

For best results, run the tests in the order they are displayed in the project. This will show you a full spectrum of PIX/PDQ processing. Because each response is uniquely identified in the id root element, each test will report a failure because it does not receive the expected output. In addition, if the tests are run out of order additional errors will occur because the response from the Master Index will be different.


  1. On the NetBeans Projects window, expand the PIXPDQ_HL7V3 project, and then expand Test.

  2. Right-click on the test you want to run, and select Run.

  3. Check whether the test passed or failed. Do one or both of the following to verify a test:

    • Right-click the test case in NetBeans, and then click Diff. The only difference should be the root id.

    • Launch the PIX Console and click the Message tab. Select the message ID, and view the trace information for the message.

  4. To perform additional tests, you can modify the input file of any of the tests and rerun it. You can also create your own tests by doing the following:

    1. Right-click Test, and then select New Test Case.

      The New Test Case Wizard appears.

    2. Enter a name for the test case, and then click Next.

      The Select the WSDL Document window appears.

    3. Expand the HL7 v3 project containing the operation you want to test.

    4. Select the WSDL file containing the operation to test, and then click Next.

      The Select the Operation to Test window appears.

    5. Select the operation to test, and then click Finish.


      Note –

      Currently the tester only support SOAP 1.1 and not SOAP 1.2, so you cannot select any of the SOAP 1.2 operations.


      In the Projects tree, a new folder is created under the Test node, containing two files: Input.xml and Output.xml.