HIMSS and RSNA
Integrating the Healthcare Enterprise
IHE/MESA
Export Receiver 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 9.4.0
4-November-2005
Export Receiver Tests
Introduction
Message Attributes
Message Values
Configuration
Starting the MESA Servers
Unique Identifiers
Test Instructions
Export Receiver Tests
Read the document IHE Tests: Transaction Sequences. This document lists all the transactions in a series of use cases which drive tests for individual actors. Export Receiver will participate in a subset of the transactions. Reading that document will allow you to understand the full set of transactions for each test. These are the 1xx series tests.
There are other tests that do not depend on message flow as defined in IHE Tests: Transaction Sequences. These other tests (the 4xx series tests) are used to evaluate more static features of the Export Receiver, such as responses for specific keys as defined in the IHE Technical Framework.
Each test is run using the same procedure. We assume you are using an interactive terminal or terminal emulator and are logged on to the MESA test system. Change directory to $MESA_TARGET/mesa_tests/rad/actors/expmgr. Make sure the $MESA_TARGET and $MESA_STORAGE environment variables are set properly.
This document lists a number of tests for Export Receiver Systems. You may not be responsible for all of these tests.
Please refer to the Connectathon web tool to list the required tests for your system. The web address of this tool depends on the year and project manager. Please contact the appropriate project manager to obtain this information.
Application |
AE Title |
Port Number |
MESA_EXPMGR_HOST |
MESA_EXPMGR |
2350 |
MESA_EXPRCR_HOST |
MESA_EXPRCR |
2360 |
|
|
|
|
|
|
Read the Runtime Notes section of the Installation Guide to determine the proper settings for the MESA runtime environment.
These instructions assume you are using a terminal emulator on Unix systems or an MS DOS command window under Windows NT. Each test uses a command line interface; there is no graphical user interface. Before you start the test procedure, you need to start several MESA servers. Make sure the appropriate database is running (PostgreSQL, SQL Server). To start the MESA servers:
perl scripts/start_mesa_servers.pl [loglevel]loglevel is an optional argument (0 is default). Log levels are:
When you are finished running one or more tests, you can stop the servers:
perl scripts/stop_mesa_servers.plLog files are stored in $MESA_TARGET/logs.
scripts/start_mesa_secure.csh <log level> Unix
set LOGLEVEL=X (1, 2, 3, 4) (Windows)
scripts\start_mesa_secure.bat
The MESA servers are stopped using these scripts: scripts/stop_mesa_secure.csh and scripts\stop_mesa_secure.bat.
NB: The method for starting the MESA servers in “standard” mode changes with the 6.6.0 release. This better allows the MESA servers to listen for connections on ports other than our assumed defaults. This helps with some Solaris installations where there is conflict with the ports we chose as default values.
Please note the test instructions change starting with the 6.7.0 release.
Each test is independent of the others. You must collect the results of one test before starting a new test.
A test engine manages the test process. This test engine is driven by a text file that describes the events for the specific test. Each test below will indicate which script is appropriate. The arguments to the script are the test number and the log level for output:
An example of the syntax used to invoke the script for the 3000 test is:
perl scripts/exprcr_tce.pl 3000 1The test script will announce what events are about to happen and will request that you send specific events according to the sequence defined in IHE Tests: Transaction Sequences. When you have completed the sequence of events, results can be evaluated by running the evaluation script:
perl <test>/eval_<test>.pl <log level> <MPPS Mgr AE Title>For example:
perl 131/eval_131.pl 3 AE_TITLE_FILLERThe log level for evaluation is defined as:
Starting with version 6.7.0 of the MESA software, the user can change the patient name and patient ID of the test subject prior to running the test. This allows one to rerun a test without clearning the database of the prior subject. This is done from the directory $MESA_TARGET/mesa_tests/rads/msgs.
A perl script is used to query the user for a new patient name and other demographics; the script automatically generates the new patient identifier. The perl script can also use an existing text file to specify the new demographics. The software is shipped with text files that are designed for IHE United States. It would be a simple task to make different text files for other countries. As listed in each sectio below, invoke the perl script with no arguments for interactive questions. If you specify an argument, it is the name of a text file with the demographic values.
Each section below lists one Export Receiver test. As mentioned above, the individual transactions involving the Export Receiver under test are described in other documents.
Export Receiver Test 3001: Simple Single Study Teaching File ExportTest case 3001 exercises the basic set of transactions needed to support the teaching file export workflow. The images sent by the Export Selection actor are deidentified by the Export Manager, who then transmits them to the Receiver. ReferencesInstructionsTo run this test: perl scripts/exprcr_tce.pl 3001 <log> EvaluationTo evaluate this test: perl 3001/eval_3001.pl <log> Supplemental Information |
Test case 3003 exercises the option of waiting for additional data. In this use case the data being waited for is transferred via DICOM, followed by a final manifest that includes the additional data.
To run this test:
perl scripts/exprcr_tce.pl 3003 <log>
To evaluate this test:
perl 3003/eval_3003.pl <log>