HIMSS and RSNA
Integrating the Healthcare Enterprise

 IHE/MESA Cross Reference Mgr Tests

Electronic Radiology Laboratory
Mallinckrodt Institute of Radiology
510 South Kingshighway Blvd.
St. Louis, MO  63110
314.362.6965 (Voice)
314.362.6971 (Fax)

Revision 10.11.0
29-November-2006

1 Cross Reference Manager Tests

Introduction

The MESA tests include a number of cases each of which rely on a sequence of messages between actors. These tests range across different integration profiles:

• Retrieve Information for Display
• Enterprise User Authentication
• Patient Identity Cross Reference for MPI
• Patient Synchronized Application
• Consistent Time

This document lists the transactions and messages for a number of cases. It may not describe the clinical scenario behind each case, but listing the transactions should clearly define what is expected of each actor.  These are all of the transactions involving all of the actors.  When you test with your particular actor, you may see only a subset of these messages.

Patient Identification

Configuration

The MESA scripts are run from the directory $MESA_TARGET/mesa_tests/iti/xref_mgr. The ASCII configuration file xref_mgr.cfg contains parameters that identify the Cross Reference Manager under test and the MESA Cross Reference Manager.
Edit the configuration file and modify the two entries that begin with TEST to identify your Cross Reference Manager. The value for TEST_XREF_HOST_HL7 can specify an IP address or a host name (assuming the host table or DNS is accurate).
The default port number for the MESA Cross Reference Manager is 3600. You should only change this port number if there is a conflict with another service on the MESA test computer. There will be no conflicts with other MESA servers; the only conflict would occur with something from the operating system or other software package.

Starting the MESA Servers

MESA servers are started from a DOS/CMD window or a terminal emulator. Follow these steps for Unix systems

1. cd $MESA_TARGET/mesa_tests/iti/actors/xref_manager

2. scripts/start_mesa_servers.csh

      To stop the servers:

     scripts/stop_mesa_servers.csh

      The start instructions for MESA tools on a Windows system are:

1. cd  %MESA_TARGET%\mesa_tests\iti\actors\xref_manager

2. scripts\start_mesa_servers.bat

To stop the MESA servers:

     scripts/stop_mesa_servers.bat

Installation Test

Submission of Results

Test descriptions below inform the reader to “submit results to the Project Manager”. This is does not mean “email”. The current submission process should be documented by the Project Manager, but will not include emailing files directly to the Project Manager.

2 Test Cases: PIX

This section describes test cases that are generally associated with the PIX Integration Profile. There may be some overlap with other profiles.
Each test case involves a series of transactions involving one test patient.  Some patients may require that a single actor participate in multiple transactions. The tables in this section give the order of messages for an integrated system with all actors.  This is provided as a centralized reference.  To test an individual IHE actor, refer to the appropriate test document.

     perl  scripts/xref_mgr_pix.pl 10501 <log level>

     perl  10501/eval_10501.pl 4

Test Case 10502: PIX Query Case 3

Test case 10502 covers the PIX Query case 3. Two patients are registered in a single domain. A PIX consumer sends a query for a third patient who is not recognized as one of the two registered patients.

References

ITI TF-2: 3.9.4.2.2

Instructions

To run this test, follow these steps using a DOS window or terminal emulator:

1. Set the current directory to $MESA_TARGET/mesa_tests/iti/actors/xref_mgr.
2. Edit the file xref_mgr.cfg. This file describes your server that receives HL7 messages. Modify the values that begin with “TEST” to accurately describe your server.
3. Make sure the MESA servers have been started. See section 1.4 for details.
4. Run the test script as follows:

     perl  scripts/xref_mgr_pix.pl 10502 <log level>

5. The test script will send three A04 registration messages to your system. After the three A04 messages, the test script sends two PIX queries. Your system will respond with appropriate PIX responses.

Evaluation

To evaluate your response to this test:

1. Run the evaluation script

     perl  10502/eval_10502.pl 4

2. The output file is 10502/grade_10502.txt. This test is successfully completed when the last line in the output file indicates 0 errors.
3. Submit the grade file to the Project Manager

Supplemental Information

The evaluation script takes a single argument, <log level>. When debugging output, it is sometimes helpful to use a log level of 1 to see only differences. When submitting results, we prefer the output with the most verbose level, 4.

     perl  scripts/xref_mgr_pix.pl 10503 <log level>

     perl  10503/eval_10503.pl 4

Test Case 10506: PIX Query, Patient Update

Test case 10506 covers PIX Patient Feed, the ADT^A08 message, and PIX queries. Patient TAU^TERI is registered in domain ADT1 with “correct” demographics. This patient is then registered in ADT2 with incorrect demographics. The demographics are sufficiently different that a Cross Reference Manager should not link these two records.
A patient update message is sent for the patient in domain ADT2 that should synchronize the demographics with those seen in ADT1. The Cross Reference Manager should now link the two records.

References

ITI TF-2: 3.9.4.2.2

Instructions

To run this test, follow these steps using a DOS window or terminal emulator:

1. Set the current directory to $MESA_TARGET/mesa_tests/iti/actors/xref_mgr.
2. Edit the file xref_mgr.cfg. This file describes your server that receives HL7 messages. Modify the values that begin with “TEST” to accurately describe your server.
3. Make sure the MESA servers have been started. See section XXX for details.
4. Run the test script as follows:

     perl  scripts/xref_mgr_pix.pl 10506 <log level>

5. The test script will send one PIX query with a PID that includes the issuer XXXX. This issuer is unknown to the Cross Reference Manager. The Cross Reference Manager should respond as defined in Case 4.

Evaluation

To evaluate your response to this test:

1. Run the evaluation script

     perl  10506/eval_10506.pl 4

2. The output file is 10506/grade_10506.txt. This test is successfully completed when the last line in the output file indicates 0 errors.
3. Submit the grade file to the Project Manager

Supplemental Information

The evaluation script takes a single argument, <log level>. When debugging output, it is sometimes helpful to use a log level of 1 to see only differences. When submitting results, we prefer the output with the most verbose level, 4.

Test Case 10512: PIX Patient Feed: A04

Test case 10512 covers PIX Patient Feed and the ADT^A04 message. These behaviors are tested:

• Patient Identity Source formulates an A04 message with the proper content
• Patient Identity Cross-reference Manager can receive and process a properly constructed ADT^A04 message.

The nominal patient name is EPSILON^ELLIE.

References

ITI TF-2: 3.8.4

Instructions

To run this test, follow these steps using a DOS window or terminal emulator:

1. Set the current directory to $MESA_TARGET/mesa_tests/iti/actors/xref_mgr.
2. Edit the file xref_mgr.cfg. This file describes your server that receives HL7 messages. Modify the values that begin with “TEST” to accurately describe your server.
3. Make sure the MESA servers have been started. See section XXX for details.
4. Run the test script as follows:

     perl  scripts/xref_mgr_pix.pl 10512 <log level>

5. The test script will send an A04 registration message to your system.

Evaluation

1. Create evidence that this patient has been captured by your system:
   1. Obtain a screen capture (software, digital camera) a UI screen
   2. Extract a section of a log file
2. Name the output file xref_10512.xxx where xxx is the appropriate extension.
3. Zip/tar the screen capture file with other results and Submit to the Project Manager.

Supplemental Information

Test Case 10514: PIX Patient Feed: A08

Test case 10514 covers PIX Patient Feed and the ADT^A08 message.

References

ITI TF-2: 3.8.4

Instructions

Evaluation

Supplemental Information

Test Case 10531: PIX Update Notification: MESA 1

Test case 10531 covers a use case involving the PIX Update Notification transaction and behavior of the Cross-reference Manager.

References

ITI TF-2: 3.10

Instructions

Evaluation

Supplemental Information

Test Case 10533: PIX Update Notification: MESA 3

Test case 10533 covers a use case involving the PIX Update Notification transaction and behavior of the Cross-reference Manager.

References

ITI TF-2: 3.10

Instructions

Evaluation

Supplemental Information

Test Case 10542: PIX Integrated Test 2

Test case 10542 covers a use case with several PIX transactions integrated into a larger test.

References

ITI TF-2: 3.10

Instructions

Evaluation

Supplemental Information

3 Test Cases: PSA

This section describes test cases that are generally associated with the PSA Integration Profile. There may be some overlap with other profiles.
Each test case involves a series of transactions involving one test patient.  Some patients may require that a single actor participate in multiple transactions. The tables in this section give the order of messages for an integrated system with all actors.  This is provided as a centralized reference.  To test an individual IHE actor, refer to the appropriate test document.

4 Test Cases: CT

This section describes test cases that are generally associated with the CT component. There may be some overlap with other profiles.