internship report

David Vogler 

University of Applied Sciences Esslingen 

Faculty of Information Technology 

Software Technology 

Development of a 

Pilot Server Gateway Interface 

internship report 

revision 0.11 

September 4, 2000 to February 28, 2001 

6th semester, 2nd practical semester 

Supervisor: 

Michael C. Higgins, Ph.D. 

Agilent Laboratories 

Medical Department - eDx 

3500 Deer Creek Road 

Palo Alto, CA 94301-1392

Contents 

Contents 

i 

1 Project Overview 1 

1.1 System Overview and Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 

1.2 Project Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 

2 Analyze System 4 

2.1 System Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 

2.2 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 

2.3 Context Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 

2.4 Use Cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 

2.4.1 Use Case Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 

2.4.2 Use Case: Send Test Result Message . . . . . . . . . . . . . . . . . . . . 6 

2.4.3 Use Case: Send CA/CE/CR Message . . . . . . . . . . . . . . . . . . . 8 

2.4.4 Use Case: Send Application Acknowledgement/Error Message . . . . . . 8 

2.4.5 Use Case: Send Acknowledgement Message . . . . . . . . . . . . . . . . 9 

2.4.6 Use Case: Update Measurement Transfer Status Table . . . . . . . . . . 9 

2.4.7 Use Case: Log System Information . . . . . . . . . . . . . . . . . . . . . 10 

2.4.8 Use Case: Check Send Message Thread Timeout . . . . . . . . . . . . . 10 

2.4.9 Use Case: Check Pending Messages Thread Timeout . . . . . . . . . . . 11 

2.4.10 Use Case: Query Test Result . . . . . . . . . . . . . . . . . . . . . . . . 11 

3 Technical Description 13 

3.1 Technical Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 

3.2 Nature of Communication Link . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 

3.2.1 Physical Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 

3.2.2 Network Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 

i

CONTENTS 

ii 

3.2.3 Communication Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . 14 

3.2.4 Socket Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 

3.2.5 Pilot Server Gateway Sockets . . . . . . . . . . . . . . . . . . . . . . . . 14 

3.2.6 MAS Bridge Behaviour . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 

4 Design 16 

4.1 Send Message Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 

4.1.1 Send Message Client Data Flow . . . . . . . . . . . . . . . . . . . . . . 16 

4.1.2 Send Message Client Sequence . . . . . . . . . . . . . . . . . . . . . . . 17 

4.2 Receive Message Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 

4.2.1 Receive Message Server Data Flow . . . . . . . . . . . . . . . . . . . . . 18 

4.2.2 Receive Message Server Sequence . . . . . . . . . . . . . . . . . . . . . 18 

4.3 Check Pending Messages Thread . . . . . . . . . . . . . . . . . . . . . . . . . . 19 

4.3.1 Check Pending Messages Data Flow . . . . . . . . . . . . . . . . . . . . 19 

4.3.2 Check Pending Messages Thread Sequence . . . . . . . . . . . . . . . . 19 

4.4 Database Modifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 

5 Implementation 22 

5.1 XML Parsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 

5.2 Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 

5.2.1 Microsoft Visual Source Safe . . . . . . . . . . . . . . . . . . . . . . . . 22 

5.2.2 Microsoft SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 

5.2.3 Sun JDK 1.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 

5.2.4 Microsoft Visual C++ . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 

5.2.5 Cywgin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 

5.2.6 MS SQL Server 7.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 

6 Test Strategy 24 

6.1 Gateway Interface Test Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 24 

6.2 Tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 

6.2.1 Two Strategies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 

6.2.2 Code Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 

6.2.3 Message Exchange Format . . . . . . . . . . . . . . . . . . . . . . . . . 25 

6.2.4 Different Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 

6.3 MAS Test Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 

6.3.1 Response Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

CONTENTS 

iii 

6.3.2 Response Times . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 

6.4 Perform a Test Run . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 

6.4.1 Test Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 

6.4.2 Prepare a Test Run . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 

6.4.3 Observation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 

Bibliography 33 

List of Figures 34 

A Glossery 35 

B Package ncv.gatewayif 36 

B.1 Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 

B.1.1 Class CheckPendingMessages . . . . . . . . . . . . . . . . . . . . . . 38 

B.1.2 Class Config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 

B.1.3 Class DBSession . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 

B.1.4 Class ErrorMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 

B.1.5 Class ErrorMessageList . . . . . . . . . . . . . . . . . . . . . . . . . . 47 

B.1.6 Class GatewayIF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 

B.1.7 Class Logger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 

B.1.8 Class MASTestServer . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 

B.1.9 Class MessageList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 

B.1.10 Class MiscDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 

B.1.11 Class NotifyByEmail . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 

B.1.12 Class RecvMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 

B.1.13 Class RecvMessageServer . . . . . . . . . . . . . . . . . . . . . . . . . 62 

B.1.14 Class SendMessageClient . . . . . . . . . . . . . . . . . . . . . . . . . 64 

B.1.15 Class SendMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 

B.1.16 Class Timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 

B.1.17 Class XMLMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 

C Listings 72 

C.1 Java Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 

C.1.1 GatewayIF.java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 

C.1.2 CheckPendingMessages.java . . . . . . . . . . . . . . . . . . . . . . . . 73 

C.1.3 Config.java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

CONTENTS 

iv 

C.1.4 DBSession.java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 

C.1.5 ErrorMessage.java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 

C.1.6 ErrorMessageList.java . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 

C.1.7 Logger.java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 

C.1.8 MASTestServer.java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 

C.1.9 MessageList.java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 

C.1.10 MiscDate.java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 

C.1.11 NotifyByEmail.java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 

C.1.12 RecvMessage.java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 

C.1.13 RecvMessageServer.java . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 

C.1.14 SendMessage.java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 

C.1.15 Timer.java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 

C.1.16 XMLMessage.java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 

C.2 SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 

C.2.1 MeasXferStatus.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 

C.2.2 MeasXferInsertTrigger.sql . . . . . . . . . . . . . . . . . . . . . . . . . . 125 

C.3 Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 

C.3.1 gatewayif.cfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 

C.3.2 MAS.cfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 

C.3.3 hl7 v231.dtd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

Chapter 1 

Project Overview 

1.1 System Overview and Scope 

Figure 1.1: System Overview 

Figure 1.1 describes the system Kaiser Permanente Pilot (KPP), a demonstration pilot for a 

generalizable approach to the seamless integration of home monitoring data. [1] 

This document describes the analysis, design, implementation and test strategy of the gateway 

interface, which connects the Pilot Server to the MAS remote gateway. 

The main purpose of the gateway interface on the pilot server side is to demonstrate the usage 

of the CIC protocol as a format for data exchange in the health care industry. 

1

1.2. PROJECT PLAN 2 

1.2 Project Plan 

The project plan in figure 1.2 is a view of the team’s project plan with only my parts listed. There 

are mainly four sections of development: 

1. Analyze System: technical analysis of the system behaviour 

2. Design: design the system based on the technical analysis 

3. Implementation: develop a prototype based on the design 

4. Component Integration & Test: integrate the implementation into the project and test the 

component 

In the analysis phase, the requirements are explained and a requirement analysis is performed. The 

requirements are written down in table format. The system design is done based on this analysis 

of the system in UML notation, which is the most common notation in software engineering. 

The implementation of the system is coded in the Java language, using Sun Microsystem’s Java 

Development Toolkit (SDK) Version 1.3. There are small modifications to the Service Manager 

on the Pilot Server which spawns all the server services, written in C++. 

The component integration integrates the gateway interface into the Pilot Server software build 

tree. Therefor, GNU makefiles had to be written to compile the software within the given build 

structure. 

Finally, the system test is done by testing the component against a remote gateway simulator, 

which simulates the behaviour of the MAS remote gateway and the laboratory information system.

1.2. PROJECT PLAN 3 

Figure 1.2: Project Plan

Chapter 2 

Analyze System 

2.1 System Description 

The main purpose of the system is to establish a communication link between the Agilent pilot 

server and the Sunquest Laboratory Information System (LIS). As the LIS does not understand 

the CIC protocol, a bridge is needed. This bridge is represented by the MAS remote gateway. 

Agilent’s Pilot Server and the MAS remote gateway communicate simple test results messages 

and their acknowledgement messages using the CIC format. Both are exchanging messages as 

XML encoded HL7 (Health Level Seven) data. 

Figure 2.1: Pilot Server Message Exchange 

4

2.2. REQUIREMENTS 5 

2.2 Requirements 

requirement description 

100 The system shall implement the CIC EDI interface to the remote gateway 

of the Kaiser Permanente system. 

200 All messages that will be transmitted between the data manager and the 

Kaiser Permanente system shall be XML encoded. 

300 Health Level Seven (HL7) version 2.3.1 [3] defines further information of 

the message flow. 

400 The system shall send result set messages to the remote gateway after a 

configurable period of time. 

500 The system shall retransmit undelivered messages after a configurable period 

of time. 

600 The system shall send an email notification message in a configurable period 

of time if a message could not be sent, if there has been an error or reject 

acknowledgement by the remote gateway or if the laboratory information 

system reported an application error. 

700 Definitions of the system such as the email address for the email notification 

shall be configurable in a configuration file. 

800 The system shall not log the complete messages that are transmitted. Instead, 

a separate message transfer status table in the SQL7 database is 

used. It shall be possible to reconstruct the original messages with the 

information provided by this database table. 

900 The reliability of the system is considered very high, which means that in 

particular loss of data is unacceptable. 

1000 The system shall implement two sockets for the CIC EDI interface, so each 

gateway interface is able to send and receive messages at the same time. 

1100 The system shall be integrated in the ViridiaServiceManager from the NCV 

software like the hub interface, but run as a separate process. 

Some of these requirements are derived from David Frey’s gateway analyses [2] for the data 

manager gateway interface at an earlier point of the project phase. The requirements of the 

gateway interface have changed dramatically since the connection to the laboratory information 

system is realized via the MAS remote gateway, so a new system had to be analyzed and designed.

2.3. CONTEXT DIAGRAM 6 

2.3 Context Diagram 

Figure 2.2 shows the context diagram of the system gateway interface. It describes the terminators 

of the system and the data and control flows between them and the system. 

Figure 2.2: Context Diagram 

2.4 Use Cases 

2.4.1 Use Case Diagram 

The use case diagram (figure 2.3) is derived from the context diagram. The actors of the use case 

diagram are basically the terminators of the context diagram, the data and control flows of the 

context diagram are the identified use cases. 

2.4.2 Use Case: Send Test Result Message 

initiator: 

data manager 

involved actors:

2.4. USE CASES 7 

Figure 2.3: Use Case Diagram 

ˆ SQL7 database 

ˆ remote gateway interface 

included use case: 

ˆ update measurement transfer status table 

ˆ log system information 

pre-conditions: none 

basic flow of events: 

The data manager wants to send a test result message to the remote gateway interface. The 

data manager has to query the SQL7 database for unsent test results, generate an HL7 message 

embedded in XML and establish a socket connection to the remote gateway interface. 

After sending the message, the data manager waits for a configurable period of time to receive an 

acknowledgement message from the remote gateway interface during the same socket connection. 

After successfully receiving the acknowledgement message, type and timestamp of this message 

are logged in the measurement status transfer database table and the socket connection will be 

closed. 

post-conditions: none 

alternatives: none


2.4.3 Use Case: Send CA/CE/CR Message 

initiator: 

remote gateway interface 

involved actors: 

ˆ data manager 


included use cases: 





The remote gateway interface parses and validates the incoming XML embedded HL7 message. 

It generates a Commit Accept, Commit Error or Commit Reject XML message depending on the 

validation information and sends it back to the data manager during the same socket connection 

session. 

The data manager receives the acknowledgement message and updates the timestamp and flag 

information in the measurement transfer status table depending on the received message type. 


alternatives: none 

2.4.4 Use Case: Send Application Acknowledgement/Error Message 

initiator: 

laboratory information system 







ˆ log system information




The laboratory information system (LIS) validates incoming test result messages by examinating 

the content of the message. It then generates an application acknowledgement or application 

error message and sends it back to the data manager through the remote gateway interface. 



2.4.5 Use Case: Send Acknowledgement Message 

initiator: 

data manager 



ˆ laboratory information system 






The remote gateway interface transports the test result message to the laboratory information 

system (LIS). The laboratory information system has to validate the message and sends back 

an Application Acknowledgement (AA) or Application Error (AE) message through the remote 

gateway interface. 

The data manager listens on a socket for these incoming AA or AE messages, which are not time 

critical, and has to respond to them with an acknowledgement message. 



2.4.6 Use Case: Update Measurement Transfer Status Table 

initiator: 

data manager 


ˆ SQL7 database


included use cases: none 



The measurement transfer status table provides all necessary information to track the status of a 

test result message. Therefor each time a message has been sent or an acknowledgement message 

has been received, the measurement transfer status table will be updated with flag and timestamp 

information. If there has been an error acknowledgement, a comment that describes the kind of 

the error will be inserted. 



2.4.7 Use Case: Log System Information 

initiator: 

data manager 



ˆ laboratory information system 





The log system information use case will provide the possibility to track all important status and 

error information in a log file. Each part of the system has to write detailed information in the 

log file if an exception occured in order to make it possible to fix the problem. 

The log file will also include the information that a message has been sent or received successfully. 



2.4.8 Use Case: Check Send Message Thread Timeout 

initiator: 

data manager 

involved actors: none 



basic flow of events:


The system gateway interface checks the measurement transfer status table after a configurable 

period of time for new measurements to be send to the laboratory information system through 

the remote gateway interface. 

This will be realized by setting the send message thread asleep for the configured period of time 

and then call the send message routine. 



2.4.9 Use Case: Check Pending Messages Thread Timeout 

initiator: 

data manager 

involved actors: none 




The system gateway interface checks the measurement transfer status database table after a 

configurable period of time for pending and for error messages. 

If pending or error messages are found, an entry in the system log file will be written and an email 

notification message will be send to a configurable recipient. 



2.4.10 Use Case: Query Test Result 

initiator: 

SQL7 database 








This use case provides the system gateway interface with all necessary test result set data.


Lists of test result messages, pending messages and error messages gathered with a query of the 

SQL7 database will be provided for the system. 


alternatives: none

Chapter 3 

Technical Description 

3.1 Technical Overview 

Figure 3.1 gives an overview of the physical realization of the pilot server. The pilot server will be 

placed in a closed server room, secure from unauthorized access. 

Figure 3.1: Physical Overview of the Pilot 

The communication between the Sunquest laboratory information system (LIS) will be realized 

indirectly through the MAS remote gateway. Both, the MAS bridge and the LIS server are inside 

the Kaiser intranet. This section will describe the nature of the communication and data flow 

between the pilot server gateway interface and the MAS bridge. 

13

3.2. NATURE OF COMMUNICATION LINK 14 

3.2 Nature of Communication Link 

3.2.1 Physical Connection 

The pilot server will not be placed within the Kaiser intranet, so it will be connected via a dedicated 

line to the MAS bridge. 

3.2.2 Network Protocol 

The communication in the lower levels of the ISO OSI layer model will be handled with a TCP/IP 

connection over the dedicated line. 

3.2.3 Communication Protocol 

The pilot server gateway interface and the MAS bridge will send and receive XML encoded Health 

Level Seven (HL7 version 2.3.1) messages. 

3.2.4 Socket Connection 

The MAS bridge and the pilot server will communicate over a TCP/IP socket connection. Two 

sockets will be placed on each side. 

Connect pilot server gateway interface 

MAS bridge 

Sunquest LIS 

Sessions 

1 port #5000: send XML port #5000: receive 

encoded HL7 ORM O01 ORM O01, send ACK 

message to MAS port CA/CE/CR back during 

#5000 

this socket connection. 

Close socket connection. 

2 1 send result set to LIS receive result set, 

generate AA/AE 

messages. 

3 port #5001: wait for Generate XML encoded 

Application Acknowledgement 

AA/AE message. 

(AA). 

port #5001: receive Send AA/AE XML message 

AA/AE XML message, 

to port #5001. Re- 

send acknowledgement. ceive acknowledgement 

Close socket connection. message. Close socket 

connection. 

3.2.5 Pilot Server Gateway Sockets 

The gateway interface is seen from the outside as two threads: 

1 not included in the pilot server gateway interface application

3.2. NATURE OF COMMUNICATION LINK 15 

ˆ Thread one listens on port #5001 for incoming messages from the MAS bridge. The MAS 

gateway opens a socket connection to port #5001, sends its AA/AE message and closes the 

socket connection. The gateway interface closes the socket and re-opens it for listening. 

ˆ Thread two waits for new measurements received by the pilot server to be transmitted 

through the MAS bridge on port #5000, sends one ORM O01 result set, then waits for a 

CA, CE or CR acknowledgement message from MAS and sends the next message after that 

until there are no more result sets in the message list to be transmitted. 

3.2.6 MAS Bridge Behaviour 

The MAS bridge receives the ORM O01 result set messages from the pilot server gateway interface, 

generates a CA, CE or CR XML message and sends it during the same session to the pilot server. 

After passing the result set to the LIS it gets an Application Acknowledgement (AA) or Application 

Error (AE) back from LIS. 

This AA or AE message will be passed to the data manager via a new socket connection. MAS 

opens a connection to the pilot server on port #5001 and submits the XML encoded message.

Chapter 4 

Design 

4.1 Send Message Client 

4.1.1 Send Message Client Data Flow 

Figure 4.1: Send Message Data Flow 

When the Send Message Client thread starts, it queries the SQL7 database for new test results 

and the gateway interface receives the test results as arrays from the database. It generates XML 

objects out of it, opens a socket connction to the remote gateway interface and sends the list of 

unsent messages (one by one) to the MAS gateway. 

In the same session the gateway interface receives acknowledgement messages from the remote 

16

4.1. SEND MESSAGE CLIENT 17 

gateway interface and updates the timestamp and flag fields in the SQL7 database. 

4.1.2 Send Message Client Sequence 

Figure 4.2 shows the sequence diagram of the send message client thread. The send message 

client thread will be created by the data manager. It waits for a configurable period of time until 

it starts querying the database for new arrived test results. The query is done by the DBSession 

object, which creates a list of XML messages represented by the Send Message List Object. The 

message objects will be represented by the DOM document model implemented in the DOM 

Parser Xerces (Java Version). 

The SendMessage class provides a method for converting the DOM object into a string and sends 

this string to the remote gateway interface. 

Figure 4.2: Send Message Sequence Diagram

4.2. RECEIVE MESSAGE SERVER 18 

4.2 Receive Message Server 

4.2.1 Receive Message Server Data Flow 

Figure 4.3: Receive Message Data Flow 

The receive message server will be started as a thread by the datamanager and listen to a socket for 

incoming socket connections from the remote gateway interface. It will be designed for receiving 

and validating information sent from the LIS through the remote gateway to the data manager. 

When a socket connection has been established, the receive message server parses the incoming 

XML message with the DOM parser Xerces, extracts the acknowledgement type and message ID 

and updates the timestamp and flag information in the Measurement Transfer Status table in the 

SQL7 database. 

After having successfully received the acknowledgement message it will close the socket connection 

and wait for the next imcoming socket connection request. 

4.2.2 Receive Message Server Sequence 

The data manager creates the receive message thread, which will wait for incoming socket connections. 

When the socket connection has been established, the receive message server will read the 

incoming byte stream and send it to the receive message class, which will create a DOM object 

with the DOM parser Xerces out of it. The ReceiveMessage class provides methods to access the 

relevant data out of the document object model. This data will be send to the DBSession class, 

which provides all the methods for accessing the SQL7 database.

4.3. CHECK PENDING MESSAGES THREAD 19 

Figure 4.4: Receive Message Sequence Diagram 

4.3 Check Pending Messages Thread 

4.3.1 Check Pending Messages Data Flow 

The Check Pending Messages thread will be created by the data manager. It will be set asleep 

for a configurable period of time. When it starts, it sends a query to the SQL7 database that 

queries for messages with errors and messages for which now acknowledgement messages have 

been received within a configurable amount of time. 

These messages will be stored into a error message list out of which an email notification message 

will be generated and send to a configurable email address. 

4.3.2 Check Pending Messages Thread Sequence 

The check pending message thread calls the DBSession class which returns error message objects 

that will be inserted into a error message linked list. 

JavaMail provides methods for sending emails through a SMTP server - this package will be used 

to send the email message generated out of the information the error message list provides.

4.4. DATABASE MODIFICATIONS 20 

Figure 4.5: Check Pending Messages Data Flow 

4.4 Database Modifications 

For keeping track of the current status of the messages, a new database table has to be inserted 

into the existing database model as shown in figure 4.7. 

The system gateway interface stores all information about the current message status in this 

table. New measurements are recognized by querying the database table for measurement IDs 

with no timestamp or flag values (NULL values). These new measurement IDs are inserted into 

the Measurement Transfer Status table by using a trigger in the SQL7 database that inserts a 

MeasID into this table each time a new insert entry is made into the Measurement table.

4.4. DATABASE MODIFICATIONS 21 

Figure 4.6: Check Pending Messages Sequence Diagram 

Figure 4.7: Database Modifications

Chapter 5 

Implementation 

5.1 XML Parsers 

The XML parser sits in the middle between an XML document and an application that uses it. 

There are two different types of parsers available, SAX and DOM parsers. In order to process a 

document, you need to read from an input source that delivers the message’s content. To analyze 

this document, the parser provides access in two ways (as described in [7]): 

ˆ It builds an internal representation of the document, a tree of nodes. The parser then gets 

out of the way and the application works with the internal representation (the DOM way). 

ˆ It provides access to the tokes as they are encountered in a pass through the document, 

without constructing an internal representation of the document (the SAX way). 

We decided to take the DOM parser for our pilot server. The DOM model has the advantage of 

allowing random access to the document parsed, which is useful when fields are optional as in the 

CIC protocol. DOM on the other side requires more memory, but this will not be a concern with 

the small size of the CIC EDI message. 

We are using the DOM parser Xerces from the Apache project as it is freely available and we use 

the getElementsByTagName() method to extract the node values. 

5.2 Tools 

5.2.1 Microsoft Visual Source Safe 

MS Visual Source Safe is used for configuration management of source code files. 

5.2.2 Microsoft SDK 

This is Microsoft’s propriatary version of Sun’s Java Developer’s Kit. It uses the Microsoft Java 

compiler (JVC) and Microsoft’s Virtual Machine at run time for the classes compiled with MS 

SDK. 

22

5.2. TOOLS 23 

5.2.3 Sun JDK 1.3 

JDK 1.3 contains the software and tools that are needed to compile, debug, run and document 

(javadoc) applications written in the Java programming language. It includes the Java Runtime 

Environment (JRE) 1.3. 

5.2.4 Microsoft Visual C++ 

MS Visual C++ is needed to compile the Viridia Service Manager application which spawns all 

the services like the gateway interface and provides methods for the application log. 

5.2.5 Cywgin 

Cygwin allows to run GNU software like the Make utility to be run on a Windows NT platfrom as 

used in this project. We use GNU make to generate all our binaries. 

5.2.6 MS SQL Server 7.0 

The back end server database will be a MS SQL Server Version 7.0. The database will be used 

to store devices, logging and patient data.

Chapter 6 

Test Strategy 

6.1 Gateway Interface Test Overview 

Figure 6.1 gives an overview of the physical realization of the Pilot Server Gateway Interface test 

environment. 

Figure 6.1: Physical Test Overview 

Messages will be exchanged between the pilot server and the MAS bridge and between the MAS 

bridge and the Sunquest Laboratory Information System (LIS). 

6.2 Tests 

6.2.1 Two Strategies 

The Pilot Server Gateway Interface will be tested with two strategies: one will cover the requirement 

that all parts of the code will be executed at some time, the other one will be a MAS bridge 

24

6.3. MAS TEST SERVER 25 

simulator, called the MAS Test Server. 

6.2.2 Code Execution 

In order to make sure that any part of the code is executed at some time, there will be a simple 

System.out.println("..."); statement in each branch of the code, i.e. switch...case-, 

if...then...else-, while- and conditional-statements. 

These statements will be removed or commented out after the test phase. 

6.2.3 Message Exchange Format 

The MAS bridge and the Pilot Server Gateway Interface (GatewayIF) exchange HL7 messages 

embedded in XML format. To make sure that the XML messages are in a proper format, the 

DOM parser Xerces in combination with an HL7 Document Type Definition (DTD) file will be 

used for message generation and message parsing. The Xerces document creater throws exceptions 

when the received message is in a wrong format or does not apply to the DTD. 

6.2.4 Different Messages 

There are six kinds of different messages in the whole message exchange process possible. 

type description 

ORM O01 Result Set (measurement) 

ORR O02 Application Acknowledgement (AA), MSA.1 = AA 

ORR O02 Application Error (AE), MSA.1 = AE, MSA.3 = error comment 

ACK Commit Accept (CA), MSA.1 = CA 

ACK Commit Accept (CE), MSA.1 = CA, MSA.3 = error comment 

ACK Commit Accept (CR), MSA.1 = CA, MSA.3 = reject comment 

All of these messages have to be generated and validated by the test environment. 

6.3 MAS Test Server 

The MAS Test Server is the counterpart to the Gateway Interface. It will - like its name implies - 

simulate the MAS bridge and its behaviour. 

6.3.1 Response Messages 

There are several flows of data possible:

6.4. PERFORM A TEST RUN 26 

normal flow of data 

error flow one 

error flow two 

error flow three 

GatewayIF sends ORM O01, MAS responds with CA, later LIS 

reponds with AA 

GatewayIF sends ORM O01, MAS responds with CE, no response 

from LIS 

GatewayIF sends ORM O01, MAS responds with CR, no response 

from LIS 

GatewayIF sends ORM O01, MAS responds with CA, later LIS 

reponds with AE 

6.3.2 Response Times 

In addition to the possible response message types it’s possible that messages will not be received 

within a certain (configurable) period of time. 

LIS Messages 

Messages from LIS (AA and AE) are not time critical, the system is able to handle these messages 

at any time. 

MAS Messages 

Messages from MAS (CA, CE and CR) are time critical. The Gateway Interface is only able to 

handle these messages within one socket session. If the connection to MAS drops down or the ACK 

message is not received within the configured period of time, there will be no timeStampRcvd 

update in the database table MeasXferStatus and no flags will be set in the database. 

These errors will be identified by the CheckPendingMessages thread and an email notification 

will be send to the responsible case worker or the system administrator (configurable). 

6.4 Perform a Test Run 

6.4.1 Test Environment 

Hardware requirements to perform a test 

The test environment has mainly four parts: 

ˆ Personal computer on which the MAS Test Server runs 

ˆ Personal computer on which the Pilot Server Gateway Interface runs 

ˆ MS SQL7 database server 

ˆ Internet connection (here: Agilent Labs 10MBit/s Ethernet) 

It is also possible to run all the software including the SQL7 database server on one single machine 

without the need of an Ethernet connection.


Figure 6.2: Test Environment Overview 

Software used for test observation 

There are several possibilities to make it possible to ”see” what is transmitted over the Ethernet 

connection. In this test environment some open source tools and software that comes with the 

operating system are used to display the communication: 

ˆ Notebook side (Pilot Server Gateway Interface): 

– sniffit (network packet sniffer) for outgoing XML messages 

– ethereal (Ethernet network analyzer) for incoming XML messages 

– xterm to see the System.out.println output of the interface 

– tail -f gatewayif.log to watch the log file 

– sendmail as mailserver to deliver status report messages 

– pine to read the generated status report messages 

ˆ Desktop side (MAS Test Server): 

– Cygwin shell to see the System.out.println output of the test server 

– MS SQL Enterprise Manager to watch the database activities 

– MS SQL Query Analyzer to reset the database with initial values


6.4.2 Prepare a Test Run 

Configure test behaviour 

Set the test cases in the file MAS.cfg. Each line describes one test case: 

AA send CA, later AA 

AE send CA, later AE 

00 send CA with timeout, later AA 

CA send CA, no AA/AE 

CE send CE 

CR send CR 

Prepare database table 

To reset the values of the MeasXferStatus table set all fields to except the MeasID row: 

Figure 6.3: Reset database table with SQL7 query analyzer 

MAS Test Server 

Start the MAS Test Server with the command: 

java ncv.gatewayif.MASTestServer 

Pilot Server Gateway Interface 

Start the Pilot Server Gateway Interface with the command: 

java ncv.gatewayif.GatewayIF gatewayif.cfg


6.4.3 Observation 

SQL7 Enterprise Manager 

Update the MeasXferStatus table view (”!”) to see which fields have been changed and to which 

values. 

Figure 6.4: SQL7 Enterprise Manager 

Examine outgoing XML messages with sniffit 

Sniffit makes it possible to listen to ports on the system it is started on. Each connection will be 

logged into a separate file. The filename consists of two IP addresses and the ports that habe 

been used for the transmission. 

Examine incoming XML messages with ethereal 

Start the ethereal application as root and select option ”start capture”. Click on the ”source” 

and ”destination” buttons to search for the wanted packets. 

Watch Gateway Interface system output in xterm 

Watch log file on Pilot Server Gateway Interface computer 

Watch MAS Test Server output in cygwin shell


Figure 6.5: sniffit network packet sniffer 

Figure 6.6: Ethereal network analyzer


Figure 6.7: Gateway Interface output in xterm 

Figure 6.8: Gateway Interface log file


Figure 6.9: MAS Test Server output in cygwin shell

Bibliography 

[1] Michael Higgins. Demonstration Pilot Proposal - Connectivity for Home Monitoring of Prothrombin 

Time. Agilent Technologies, CA, 2000. 

[2] David Frey. Gateway Analysis. Agilent Technologies, CA, 2000. 

[3] Health Level Seven. Health Level Seven Standard Version 2.3.1. Health Level Seven, April 

2000. 

[4] Ivor Horton. Beginning Java 2. Birmingham, UK, 1999. Wrox Press Ltd. 

[5] David Flanagan. Java in a nutshell. Sebastopol, CA, 1999. O’Reilly & Associates, Inc. 

[6] Alexander Nakhimovsky and Tom Myers. Professional Java XML Programming. Birmingham, 

UK, 1999. Wrox Press Ltd. 

[7] Brett McLaughlin. Java and XML. Sebastopol, CA, 2000. O’Reilly & Associates, Inc. 

[8] Tom DeMarco, Structured Analysis and System Specification. Englewood Cliffs, NJ, 1979. 

Prentice Hall. 

[9] Erich Gamma, Richard Helm, Ralph Johnson, John Vlissides. Design Patterns. Reading, MA, 

1995. Addison-Wesley Publishing Company, Inc. 

[10] Pierre-Alain Muller. Instant UML. Birmingham, UK, 1997. Wrox Press Ltd. 

[11] Rational Software Corporation. Using Rational Rose. Revision 7.0, March 2000. 

33

List of Figures 

1.1 System Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 

1.2 Project Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 

2.1 Pilot Server Message Exchange . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 

2.2 Context Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 

2.3 Use Case Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 

3.1 Physical Overview of the Pilot . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 

4.1 Send Message Data Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 

4.2 Send Message Sequence Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . 17 

4.3 Receive Message Data Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 

4.4 Receive Message Sequence Diagram . . . . . . . . . . . . . . . . . . . . . . . . 19 

4.5 Check Pending Messages Data Flow . . . . . . . . . . . . . . . . . . . . . . . . 20 

4.6 Check Pending Messages Sequence Diagram . . . . . . . . . . . . . . . . . . . . 21 

4.7 Database Modifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 

6.1 Physical Test Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 

6.2 Test Environment Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 

6.3 Reset database table with SQL7 query analyzer . . . . . . . . . . . . . . . . . . 28 

6.4 SQL7 Enterprise Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 

6.5 sniffit network packet sniffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 

6.6 Ethereal network analyzer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 

6.7 Gateway Interface output in xterm . . . . . . . . . . . . . . . . . . . . . . . . . 31 

6.8 Gateway Interface log file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 

6.9 MAS Test Server output in cygwin shell . . . . . . . . . . . . . . . . . . . . . . 32 

34

Appendix A 

Glossery 

CIC 

EDI 

HL7 

KPP 

LIS 

NCV 

SQL 

STR 

XML 

Connectivity Industry Consortium 

Electronic Data Interchange 

Health Level Seven 

Kaiser Permanente Pilot 

Laboratory Information System 

New Clinical Venture 

Structured Query Language 

Simple Test Result 

Extensible Markup Language 

35

Appendix B 

Package ncv.gatewayif 

Package Contents 

Page 

Classes 

CheckPendingMessages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38 

This class looks in the MeasXferTable in the Pilot Server database for pending 

messages and error messages. 

Config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 

This class provides methods to read configurable values out of a configuration 

file. 

DBSession . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 

This class provides all the database functionality. 

ErrorMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 

This class represents an error message object used by the class CheckPendingMessages 

ErrorMessageList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 

This class is used by the CheckPendingMessages class to generate a list of 

ErrorMessages 

GatewayIF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 

This class spawns the threads SendMessageClient, RemoteMessageServer and 

CheckPendingMessages. 

Logger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 

This class is intended to log errors and other useful information to an ASCII text 

file 

MASTestServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 

Simulation of the MAS Gateway Interface and Sunquest’s Laboratory Information 

System (LIS) 

MessageList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 

This class is used by the SendMessageClient class to generate a linked list of 

XMLMessages to be send to the MAS remote gateway 

MiscDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 

This class is used to get general time and date information and to compute time 

differences. 

NotifyByEmail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 

36

APPENDIX B. PACKAGE NCV.GATEWAYIF 37 

...no description... 

RecvMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 

This class provides the methods for accessing an incoming (reveived) message 

RecvMessageServer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62 

This class provides the methods for receiving incoming LIS AA and AE messages 

send through the MAS remote gateway. 

SendMessageClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 

This class provides the basic functionality of the application, it gets a list of 

messages to be send, opens a socket connection to the MAS remote gateway, 

sends all the messages and receives CA/CE/CR message acknowledgement from 

the remote gateway. 

SendMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 

This class provides the methods for accessing an outgoing (to be send) message 

Timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 

...no description... 

XMLMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 

...no description...

B.1. CLASSES 38 

B.1 Classes 

B.1.1 

Class CheckPendingMessages 

This class looks in the MeasXferTable in the Pilot Server database for pending messages and error 

messages. If error and/or pending messages are found, an email notification will be generated and sent. 

Declaration 

public class CheckPendingMessages 

extends java.lang.Thread 

Constructors 

ˆ CheckPendingMessages 

public CheckPendingMessages( java.lang.String configFileName ) 

– Usage 

* Default Constructor. Reads configFileName to set values. 

Methods 

ˆ run 

public void run( ) 

– Usage 

* This method checks the database for CE/CR/AE and pending ACK messages 

from MAS and LIS. It runs permanently but sleeps for sleepTimer milliseconds. 

ˆ SendMail 

public void SendMail( java.lang.String msgText ) 

– Usage 

* Send email with content of parameter msgText to configured receipient. 

Methods inherited from class java.lang.Thread 

ˆ activeCount 

public static int activeCount( ) 

ˆ checkAccess 

public final void checkAccess( ) 

ˆ countStackFrames 

public native int countStackFrames( )


ˆ currentThread 

public static native Thread currentThread( ) 

ˆ destroy 

public void destroy( ) 

ˆ dumpStack 

public static void dumpStack( ) 

ˆ enumerate 

public static int enumerate( java.lang.Thread [] ) 

ˆ getContextClassLoader 

public ClassLoader getContextClassLoader( ) 

ˆ getName 

public final String getName( ) 

ˆ getPriority 

public final int getPriority( ) 

ˆ getThreadGroup 

public final ThreadGroup getThreadGroup( ) 

ˆ interrupt 

public void interrupt( ) 

ˆ interrupted 

public static boolean interrupted( ) 

ˆ isAlive 

public final native boolean isAlive( ) 

ˆ isDaemon 

public final boolean isDaemon( ) 

ˆ isInterrupted 

public boolean isInterrupted( ) 

ˆ join 

public final void join( ) 

ˆ join 

public final synchronized void join( long ) 

ˆ join 

public final synchronized void join( long , int ) 

ˆ resume 

public final void resume( ) 

ˆ run 


ˆ setContextClassLoader 

public void setContextClassLoader( java.lang.ClassLoader ) 

ˆ setDaemon 

public final void setDaemon( boolean ) 

ˆ setName 

public final void setName( java.lang.String ) 

ˆ setPriority 

public final void setPriority( int ) 

ˆ sleep 

public static native void sleep( long ) 

ˆ sleep 

public static void sleep( long , int ) 

ˆ start 

public native synchronized void start( ) 

ˆ stop 

public final void stop( )


ˆ stop 

public final synchronized void stop( java.lang.Throwable ) 

ˆ suspend 

public final void suspend( ) 

ˆ toString 

public String toString( ) 

ˆ yield 

public static native void yield( ) 

B.1.2 

Class Config 

This class provides methods to read configurable values out of a configuration file. 

Declaration 

public class Config 

extends java.lang.Object 

Constructors 

ˆ Config 

public Config( java.lang.String filename ) 

– Usage 

* Constructor needs the filename of the configuration file as parameter 

Methods 

ˆ getACKTimeOut 

public static long getACKTimeOut( ) 

– Usage 

* returns the timeout for acknowledgement messages. After this time the socket 

connection will be shut down. 

ˆ getCICInPort 

public static int getCICInPort( ) 

– Usage 

* returns port number on pilot server side for incoming XML messages 

ˆ getCICOutPort 

public static int getCICOutPort( ) 

– Usage


* returns port number on remote gateway for outgoing XML messages 

ˆ getConfigFileName 

public static String getConfigFileName( ) 

– Usage 

* returns the path and filename for the configuration file 

ˆ getCPMTimeOut 

public static long getCPMTimeOut( ) 

– Usage 

* returns the sleeptimer for the CheckPendingMessages thread. After one run, the 

thread will be set asleep for this amount of time. 

ˆ getdbDriver 

public static String getdbDriver( ) 

– Usage 

* returns the name for the database driver 

ˆ getdbName 

public static String getdbName( ) 

– Usage 

* returns the database name 

ˆ getdbPassword 

public static String getdbPassword( ) 

– Usage 

* returns the password for the database user 

ˆ getdbServer 

public static String getdbServer( ) 

– Usage 

* returns the database server name or IP address 

ˆ getdbUser 

public static String getdbUser( ) 

– Usage 

* returns the name of the database user 

ˆ getEmailFrom 

public static String getEmailFrom( ) 

– Usage 

* returns the email From: field for the status report 

ˆ getEmailHost 

public static String getEmailHost( )


– Usage 

* returns the name or IP address for the SMTP server the status report message is 

send to 

ˆ getEmailSubject 

public static String getEmailSubject( ) 

– Usage 

* returns the email Subject: field for the status report 

ˆ getEmailTo 

public static String getEmailTo( ) 

– Usage 

* returns the email To: field for the status report 

ˆ getLISTimeOut 

public static long getLISTimeOut( ) 

– Usage 

* returns the timeout for the MAS test gateway until it responds to an incoming 

XML message with an Application Acknowledgement message. 

ˆ getLogFileName 

public static String getLogFileName( ) 

– Usage 

* returns the path and filename of the log file. 

ˆ getMASRcvdTimeOut 

public static long getMASRcvdTimeOut( ) 

– Usage 

* returns the timeout for the MAS test gateway until it responds to an incoming 

XML message with a Commit Acknowledgement message. 

ˆ getPilotServer 

public static String getPilotServer( ) 

– Usage 

* returns name or IP address of the Pilot Server 

ˆ getReceivingApplication 

public static String getReceivingApplication( ) 

– Usage 

* returns the name of the receiving application 

ˆ getReceivingFacility 

public static String getReceivingFacility( ) 

– Usage 

* returns the name of the receiving facility


ˆ getRemoteGateway 

public static String getRemoteGateway( ) 

– Usage 

* returns name or IP address of the remote gateway 

ˆ getRMSTimeOut 

public static long getRMSTimeOut( ) 

– Usage 

* returns the sleeptimer for the ReceiveMessageServer thread. After one run, the 


ˆ getScanDBTimeOut 

public static long getScanDBTimeOut( ) 

– Usage 

* returns the sleeptimer for the SendMessageClient thread. After one run, the 


ˆ getSendingApplication 

public static String getSendingApplication( ) 

– Usage 

* returns the name of the sending application 

ˆ getSendingFacility 

public static String getSendingFacility( ) 

– Usage 

* returns the name of the sending facility 

ˆ getSocketTimeOut 

public static int getSocketTimeOut( ) 

– Usage 

* returns the timeout for closing an open socket connection 

B.1.3 

Class DBSession 

This class provides all the database functionality. 

Declaration 

public class DBSession 

extends java.lang.Object


Constructors 

ˆ DBSession 

public DBSession( java.lang.String configFileName ) 

– Usage 

* Constructor initializes member variables with values out of the given 

configuration file 

Methods 

ˆ closeDB 

public void closeDB( java.sql.Connection conn ) 

– Usage 

* close database connection 

ˆ getApplicationErrorMessages 

public ErrorMessageList getApplicationErrorMessages( java.sql.Connection 

conn ) 

– Usage 

* get Messages with flagAE set to true 

ˆ getCommitErrorMessages 

public ErrorMessageList getCommitErrorMessages( java.sql.Connection 

conn ) 

– Usage 

* get Messages with flagCE set to true 

ˆ getCommitRejectMessages 

public ErrorMessageList getCommitRejectMessages( java.sql.Connection 

conn ) 

– Usage 

* get Messages with flagCR set to true 

ˆ getMsgList 

public MessageList getMsgList( java.sql.Connection conn ) 

– Usage 

* returns Object MessageList with all new measurements 

ˆ getNumRows 

public int getNumRows( java.sql.Connection conn ) 

– Usage 

* get number of rows in table MeasXferStatys


ˆ getPendingACKMessages 

public ErrorMessageList getPendingACKMessages( java.sql.Connection 

conn, long timeDiff ) 

– Usage 

* get Messages with Pending timeStampRcvd 

ˆ getPendingLISMessages 

public ErrorMessageList getPendingLISMessages( java.sql.Connection 

conn, long timeDiff ) 

– Usage 

* get Messages with Pending timeStampLIS 

ˆ getTimesSent 

public int getTimesSent( java.sql.Connection 

MeasID ) 

conn, java.lang.String 

– Usage 

* get timesSent field in MeasXferStatus 

ˆ openDB 

public Connection openDB( ) 

– Usage 

* Open a database connection, returns database link as a Connection 

ˆ updateComment 

public boolean updateComment( java.sql.Connection conn, 

java.lang.String MeasID, java.lang.String Comment ) 

– Usage 

* update comment in MeasXferStatus 

ˆ updateFlagAA 

public boolean updateFlagAA( java.sql.Connection 

java.lang.String MeasID, boolean flag ) 

conn, 

– Usage 

* update flagAA field in MeasXferStatus 

ˆ updateFlagAE 

public boolean updateFlagAE( java.sql.Connection 


conn, 

– Usage 

* update flagAE field in MeasXferStatus 

ˆ updateFlagCA 

public boolean updateFlagCA( java.sql.Connection 


conn,


– Usage 

* update flagCA field in MeasXferStatus 

ˆ updateFlagCE 

public boolean updateFlagCE( java.sql.Connection 


conn, 

– Usage 

* update flagCE field in MeasXferStatus 

ˆ updateFlagCR 

public boolean updateFlagCR( java.sql.Connection 


conn, 

– Usage 

* update flagCR field in MeasXferStatus 

ˆ updateFlagNotified 

public boolean updateFlagNotified( java.sql.Connection 


conn, 

– Usage 

* update flagNotified field in MeasXferStatus 

ˆ updateTimesSent 

public boolean updateTimesSent( java.sql.Connection 

java.lang.String MeasID, int times ) 

conn, 

– Usage 

* update timesSent field in MeasXferStatus 

ˆ updateTimeStampLIS 

public boolean updateTimeStampLIS( java.sql.Connection 

java.lang.String MeasID, java.lang.String timeStamp ) 

conn, 

– Usage 

* update timeStampLIS field in MeasXferStatus 

ˆ updateTimeStampRcvd 

public boolean updateTimeStampRcvd( java.sql.Connection 


conn, 

– Usage 

* update timeStampRcvd field in MeasXferStatus 

ˆ updateTimeStampSent 

public boolean updateTimeStampSent( java.sql.Connection 


conn, 

– Usage 

* update timeStampSent field in MeasXferStatus


B.1.4 

Class ErrorMessage 

This class represents an error message object used by the class CheckPendingMessages 

Declaration 

public class ErrorMessage 


Constructors 

ˆ ErrorMessage 

public ErrorMessage( int MeasID, java.lang.String Comment ) 

– Usage 

* Constructor initializes the member values 

Methods 

ˆ getComment 

public String getComment( ) 

– Usage 

* returns the error comment of the error message 

ˆ getMeasID 

public int getMeasID( ) 

– Usage 

* returns the MeasID of the error message 

B.1.5 

Class ErrorMessageList 

This class is used by the CheckPendingMessages class to generate a list of ErrorMessages 

Declaration 

public class ErrorMessageList 

extends java.util.LinkedList


Constructors 

ˆ ErrorMessageList 

public ErrorMessageList( ) 

Methods inherited from class java.util.LinkedList 

ˆ add 

public void add( int , java.lang.Object ) 

ˆ add 

public boolean add( java.lang.Object ) 

ˆ addAll 

public boolean addAll( java.util.Collection ) 

ˆ addAll 

public boolean addAll( int , java.util.Collection ) 

ˆ addFirst 

public void addFirst( java.lang.Object ) 

ˆ addLast 

public void addLast( java.lang.Object ) 

ˆ clear 

public void clear( ) 

ˆ clone 

public Object clone( ) 

ˆ contains 

public boolean contains( java.lang.Object ) 

ˆ get 

public Object get( int ) 

ˆ getFirst 

public Object getFirst( ) 

ˆ getLast 

public Object getLast( ) 

ˆ indexOf 

public int indexOf( java.lang.Object ) 

ˆ lastIndexOf 

public int lastIndexOf( java.lang.Object ) 

ˆ listIterator 

public ListIterator listIterator( int ) 

ˆ remove 

public Object remove( int ) 

ˆ remove 

public boolean remove( java.lang.Object ) 

ˆ removeFirst 

public Object removeFirst( ) 

ˆ removeLast 

public Object removeLast( ) 

ˆ set 

public Object set( int , java.lang.Object ) 

ˆ size 

public int size( ) 

ˆ toArray 

public Object toArray( ) 

ˆ toArray 

public Object toArray( java.lang.Object [] )


Methods inherited from class java.util.AbstractSequentialList 

ˆ add 


ˆ addAll 


ˆ get 


ˆ iterator 

public Iterator iterator( ) 


public abstract ListIterator listIterator( int ) 

ˆ remove 


ˆ set 


Methods inherited from class java.util.AbstractList 

ˆ add 


ˆ add 


ˆ addAll 


ˆ clear 


ˆ equals 

public boolean equals( java.lang.Object ) 

ˆ get 

public abstract Object get( int ) 

ˆ hashCode 

public int hashCode( ) 

ˆ indexOf 


ˆ iterator 





public ListIterator listIterator( ) 



ˆ remove 


ˆ removeRange 

protected void removeRange( int , int ) 

ˆ set 


ˆ subList 

public List subList( int , int )


Methods inherited from class java.util.AbstractCollection 

ˆ add 


ˆ addAll 


ˆ clear 


ˆ contains 


ˆ containsAll 

public boolean containsAll( java.util.Collection ) 

ˆ isEmpty 

public boolean isEmpty( ) 

ˆ iterator 

public abstract Iterator iterator( ) 

ˆ remove 


ˆ removeAll 

public boolean removeAll( java.util.Collection ) 

ˆ retainAll 

public boolean retainAll( java.util.Collection ) 

ˆ size 

public abstract int size( ) 

ˆ toArray 


ˆ toArray 

public Object toArray( java.lang.Object [] ) 

ˆ toString 


B.1.6 

Class GatewayIF 

This class spawns the threads SendMessageClient, RemoteMessageServer and CheckPendingMessages. 

Declaration 

public class GatewayIF 


Constructors 

ˆ GatewayIF 

public GatewayIF( )


Methods 

ˆ main 

public static void main( java.lang.String [] args ) 







public native int countStackFrames( ) 



ˆ destroy 


ˆ dumpStack 


ˆ enumerate 




ˆ getName 






ˆ interrupt 




ˆ isAlive 


ˆ isDaemon 




ˆ join 


ˆ join 


ˆ join 


ˆ resume 

public final void resume( )


ˆ run 




ˆ setDaemon 


ˆ setName 




ˆ sleep 


ˆ sleep 


ˆ start 


ˆ stop 

public final void stop( ) 

ˆ stop 


ˆ suspend 


ˆ toString 


ˆ yield 


B.1.7 

Class Logger 

This class is intended to log errors and other useful information to an ASCII text file 

Declaration 

public class Logger 


Constructors 

ˆ Logger 

public Logger( ) 

– Usage 

* Constructor with default filename if no parameter is given 

ˆ Logger 

public Logger( java.lang.String fileName ) 

– Usage 

* Constructor needs filename of logfile


Methods 

ˆ clearLog 

public void clearLog( ) 

– Usage 

* clear all logged entries in logfile 

ˆ log 

public boolean log( short priority, short subSystemCode, 

java.lang.String moduleCode, java.lang.String errorCode, 

java.lang.String message ) 

– Usage 

* add new entry to log file with given parameters 

B.1.8 

Class MASTestServer 

Simulation of the MAS Gateway Interface and Sunquest’s Laboratory Information System (LIS) 

Declaration 

public class MASTestServer 


Fields 

ˆ public static int CICINPORT 

– Port for incoming XML messages 

ˆ public static int CICOUTPORT 

– Port for outgoing XML messages 

ˆ public static long TIMEOUT 

– 

ˆ public static long RESPONSETIME 

– Time MAS waits until sending response 

ˆ public static long RESPONSETIMEOUT 

– Time MAS waits until sending timeout response 

ˆ public static long responseTime 

– 

ˆ public static String RECVSERVER 

–


Constructors 

ˆ MASTestServer 

public MASTestServer( long delay ) 

– Usage 

* constructor sets default values from MAS.cfg file 

Methods 

ˆ getDOMDocument 

public Document getDOMDocument( java.lang.String xmlstring ) 

– Usage 

* generate DOM document out of received XML string 

ˆ main 


ˆ run 











ˆ destroy 


ˆ dumpStack 


ˆ enumerate 




ˆ getName 





public final ThreadGroup getThreadGroup( )


ˆ interrupt 




ˆ isAlive 


ˆ isDaemon 




ˆ join 


ˆ join 


ˆ join 


ˆ resume 


ˆ run 




ˆ setDaemon 


ˆ setName 




ˆ sleep 


ˆ sleep 


ˆ start 


ˆ stop 


ˆ stop 


ˆ suspend 


ˆ toString 


ˆ yield 


B.1.9 

Class MessageList 

This class is used by the SendMessageClient class to generate a linked list of XMLMessages to be send to 

the MAS remote gateway


Declaration 

public class MessageList 

extends java.util.LinkedList 

Constructors 

ˆ MessageList 

public MessageList( ) 

Methods inherited from class java.util.LinkedList 

ˆ add 


ˆ add 


ˆ addAll 


ˆ addAll 


ˆ addFirst 

public void addFirst( java.lang.Object ) 

ˆ addLast 

public void addLast( java.lang.Object ) 

ˆ clear 


ˆ clone 

public Object clone( ) 

ˆ contains 


ˆ get 


ˆ getFirst 

public Object getFirst( ) 

ˆ getLast 

public Object getLast( ) 

ˆ indexOf 






ˆ remove 


ˆ remove 

public boolean remove( java.lang.Object )


ˆ removeFirst 

public Object removeFirst( ) 

ˆ removeLast 

public Object removeLast( ) 

ˆ set 


ˆ size 

public int size( ) 

ˆ toArray 


ˆ toArray 


Methods inherited from class java.util.AbstractSequentialList 

ˆ add 


ˆ addAll 


ˆ get 


ˆ iterator 



public abstract ListIterator listIterator( int ) 

ˆ remove 


ˆ set 


Methods inherited from class java.util.AbstractList 

ˆ add 


ˆ add 


ˆ addAll 


ˆ clear 


ˆ equals 

public boolean equals( java.lang.Object ) 

ˆ get 

public abstract Object get( int ) 

ˆ hashCode 

public int hashCode( ) 

ˆ indexOf 

public int indexOf( java.lang.Object )


ˆ iterator 





public ListIterator listIterator( ) 



ˆ remove 


ˆ removeRange 

protected void removeRange( int , int ) 

ˆ set 


ˆ subList 

public List subList( int , int ) 

Methods inherited from class java.util.AbstractCollection 

ˆ add 


ˆ addAll 


ˆ clear 


ˆ contains 


ˆ containsAll 

public boolean containsAll( java.util.Collection ) 

ˆ isEmpty 

public boolean isEmpty( ) 

ˆ iterator 

public abstract Iterator iterator( ) 

ˆ remove 


ˆ removeAll 

public boolean removeAll( java.util.Collection ) 

ˆ retainAll 

public boolean retainAll( java.util.Collection ) 

ˆ size 

public abstract int size( ) 

ˆ toArray 


ˆ toArray 


ˆ toString 

public String toString( )


B.1.10 

Class MiscDate 

This class is used to get general time and date information and to compute time differences. 

Declaration 

public class MiscDate 


Constructors 

ˆ MiscDate 

public MiscDate( ) 

Methods 

ˆ getTimeDiff 

public static long getTimeDiff( java.sql.Timestamp timeStampSent ) 

– Usage 

* returns time difference in milliseconds between now and a given timestamp 

ˆ MessageDate 

public static String MessageDate( ) 

– Usage 

* returns today’s date and time as a String like the database returns it 

ˆ todaysDate 

public static String todaysDate( ) 

– Usage 

* returns today’s date as a formatted string 

B.1.11 

Class NotifyByEmail 

Declaration 

public class NotifyByEmail 

extends java.lang.Object


Constructors 

ˆ NotifyByEmail 

public NotifyByEmail( ) 

Methods 

ˆ main 


B.1.12 

Class RecvMessage 

This class provides the methods for accessing an incoming (reveived) message 

Declaration 

public class RecvMessage 

extends ncv.gatewayif.XMLMessage 

Constructors 

ˆ RecvMessage 

public RecvMessage( java.lang.String message ) 

– Usage 

* Constructor used for initializing the XML message object 

Methods 

ˆ getAckCode 

public String getAckCode( ) 

– Usage 

* returns the Acknowledgement code out of the DOM document 



– Usage 

* returns a DOM Document for an incoming XML message string as it is received 

from the MAS remote gateway


ˆ getErrorComment 

public String getErrorComment( ) 

– Usage 

* returns the Error comment out of the DOM document 

ˆ getMeasID 

public String getMeasID( ) 

– Usage 

* returns the MeasID out of the DOM document to identify the measurement in 

the database 

ˆ getMsgControlID 

public String getMsgControlID( ) 

– Usage 

* returns the unique Message Control ID out of the DOM document 

Methods inherited from class ncv.gatewayif.XMLMessage 

( in B.1.17, page 69) 

ˆ getCalCode 

public float getCalCode( ) 

ˆ getComment 


ˆ getDateOfMessage 

public String getDateOfMessage( ) 



ˆ getMessageControlID 

public String getMessageControlID( ) 

ˆ getObservationValue 

public float getObservationValue( ) 

ˆ getPatientID 

public String getPatientID( ) 


public String getReceivingApplication( ) 


public String getReceivingFacility( ) 


public String getSendingApplication( ) 


public String getSendingFacility( ) 

ˆ setErrorComment 

public void setErrorComment( java.lang.String errorComment )


B.1.13 

Class RecvMessageServer 

This class provides the methods for receiving incoming LIS AA and AE messages send through the MAS 

remote gateway. It validates the message and sends an acknowledgement message back to LIS during the 

same socket connection. 

Declaration 

public class RecvMessageServer 


Fields 

ˆ public static int CICOUTPORT 

– 

ˆ public static long TIMEOUT 

– 

Constructors 

ˆ RecvMessageServer 

public RecvMessageServer( java.lang.String cfgFileName ) 

– Usage 

* Constructor sets the member values as configured in given configuration file 

Methods 



– Usage 

* returns a DOM document generated out of an incoming XML message string 

ˆ run 

public void run( )











ˆ destroy 


ˆ dumpStack 


ˆ enumerate 




ˆ getName 






ˆ interrupt 




ˆ isAlive 


ˆ isDaemon 




ˆ join 


ˆ join 


ˆ join 


ˆ resume 


ˆ run 




ˆ setDaemon 


ˆ setName 

public final void setName( java.lang.String )




ˆ sleep 


ˆ sleep 


ˆ start 


ˆ stop 


ˆ stop 


ˆ suspend 


ˆ toString 


ˆ yield 


B.1.14 

Class SendMessageClient 

This class provides the basic functionality of the application, it gets a list of messages to be send, opens a 

socket connection to the MAS remote gateway, sends all the messages and receives CA/CE/CR message 

acknowledgement from the remote gateway. 

Declaration 

public class SendMessageClient 


Constructors 

ˆ SendMessageClient 

public SendMessageClient( java.lang.String configFileName ) 

– Usage 

* Constructor initializes member values out of given configuration file 

Methods 

ˆ run 

public void run( )











ˆ destroy 


ˆ dumpStack 


ˆ enumerate 




ˆ getName 






ˆ interrupt 




ˆ isAlive 


ˆ isDaemon 




ˆ join 


ˆ join 


ˆ join 


ˆ resume 


ˆ run 




ˆ setDaemon 


ˆ setName 

public final void setName( java.lang.String )




ˆ sleep 


ˆ sleep 


ˆ start 


ˆ stop 


ˆ stop 


ˆ suspend 


ˆ toString 


ˆ yield 


B.1.15 

Class SendMessage 

This class provides the methods for accessing an outgoing (to be send) message 

Declaration 

public class SendMessage 

extends ncv.gatewayif.XMLMessage 

Constructors 

ˆ SendMessage 

public SendMessage( int PatientID, java.lang.String kppID, int 

MeasID, float ObservationValue, float CalCode, java.lang.String 

ObservationTime ) 

– Usage 

* Constructor calls constructor of SuperClass XMLMessage 

ˆ SendMessage 

public SendMessage( java.lang.String 

java.lang.String ACKType ) 

MessageControlID, 

– Usage 

* Constructor calls constructor of SuperClass XMLMessage


Methods 

ˆ toString ACK 

public String toString ACK( ) 

– Usage 

* returns an Acknowledgement XML message string from DOM document 

ˆ toString ORM O01 

public String toString ORM O01( ) 

– Usage 

* returns a ORM O01 type XML message string from document 

ˆ toString ORR O02 

public String toString ORR O02( ) 

– Usage 

* returns an ORR O02 message string from DOM document 

Methods inherited from class ncv.gatewayif.XMLMessage 

( in B.1.17, page 69) 

ˆ getCalCode 


ˆ getComment 

















public String getSendingApplication( ) 






B.1.16 

Class Timer 

Declaration 

public class Timer 


Constructors 

ˆ Timer 

public Timer( int length ) 

Methods 

ˆ reset 

public synchronized void reset( ) 

ˆ run 


ˆ timeout 

public void timeout( ) 










ˆ destroy 


ˆ dumpStack 


ˆ enumerate 




ˆ getName 

public final String getName( )






ˆ interrupt 




ˆ isAlive 


ˆ isDaemon 




ˆ join 


ˆ join 


ˆ join 


ˆ resume 


ˆ run 




ˆ setDaemon 


ˆ setName 




ˆ sleep 


ˆ sleep 


ˆ start 


ˆ stop 


ˆ stop 


ˆ suspend 


ˆ toString 


ˆ yield 


B.1.17 

Class XMLMessage


Declaration 

public class XMLMessage 


Constructors 

ˆ XMLMessage 

public XMLMessage( int PatientID, java.lang.String kppID, int 

MeasID, float ObservationValue, float CalCode, java.lang.String 

ObservationTime ) 

ˆ XMLMessage 

public XMLMessage( java.lang.String message ) 

ˆ XMLMessage 

public XMLMessage( java.lang.String 

java.lang.String ACKType ) 

MessageControlID, 

Methods 

ˆ getCalCode 


ˆ getComment 

















public String getSendingApplication( )






Appendix C 

Listings 

C.1 Java Code 

C.1.1 

/** 

GatewayIF.java 

2 * $Workfile : GatewayIF.java 

* 

4 * @version $Revision : 0 $ 

* @author $Author: David Vogler $ 

6 * @date $Date: 02/11/00 10:00a $ 

* 

8 * Created by: David Vogler 

* Created on: November 2, 2000 

10 * Contact: Mike Higgins 

* 

12 * @description 

* 

14 * Startup file for Gateway Interface . Spawns all the other services 

* and threads for the Pilot Server − MAS/LIS Gateway connection. 

16 * 

* (C) Copyright Agilent Technologies 2000. All rights reserved . 

18 * Reproduction, adaption or translation without prior written 

* permission is prohibited except as allowed under the copyright 

20 * permission . 

* 

22 */ 

24 package ncv.gatewayif; 

26 import java. sql .Connection; 

import java.io .*; 

28 import java.net .*; 

import ncv.gatewayif.Config; 

30 import ncv.gatewayif.XMLMessage; 

import ncv.gatewayif.MessageList; 

32 

/** This class spawns the threads SendMessageClient, RemoteMessageServer and 

34 * CheckPendingMessages. 

*/ 

36 

72

C.1. JAVA CODE 73 

public class GatewayIF extends Thread { 

38 private static int CICOUTPORT; 

// private static final String SERVER = ”130.29.247.27”; 

40 private static String REMOTESERVER; 

private static final long TIMEOUT = 15000L; 

42 

44 

46 

public static void main(String [] args) { 

String configFileName = new String(); 

switch(args. length) { 

48 case 2: 

System.err . println (”Usage: GatewayIF ”); 

50 System.exit (1); 

break; 

52 case 1: 

configFileName = args [0]; 

54 break; 

default: 

56 configFileName = ”gatewayif.cfg”; 

break; 

58 } 

60 System.out. println (”GWI: Config file name: ” + configFileName); 

Config cfg = new Config(configFileName); 

62 

REMOTESERVER = cfg.getRemoteGateway(); 

64 CICOUTPORT = cfg.getCICOutPort(); 

66 System.out. println (”GWI: Connecting to ”+REMOTESERVER+” on port #”+CICOUTPORT); 

System.out. println (”GWI: Database server is: ”+cfg.getdbServer ()); 

68 

Thread SMClientThread = new SendMessageClient(configFileName); 

70 Thread RMServerThread = new RecvMessageServer(configFileName); 

Thread CPMessagesThread = new CheckPendingMessages(configFileName); 

72 

SMClientThread.start (); 

74 RMServerThread.start(); 

CPMessagesThread.start(); 

76 

try { 

78 System.in.read (); 

System.out. println (”GWI: Enter pressed.”); 

80 } catch (IOException e) { 

System.err . println (”GWI: ” + e); 

82 e. printStackTrace (); 

System.exit (1); 

84 } 

return; 

86 } 

} 

C.1.2 

/** 

CheckPendingMessages.java 

2 * $Workfile : CheckPendingMessages.java 

*




6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


* 

14 * (C) Copyright Agilent Technologies 2000. All rights reserved . 

* Reproduction, adaption or translation without prior written 

16 * permission is prohibited except as allowed under the copyright 

* permission . 

18 * 

*/ 

20 

22 

package ncv.gatewayif; 

import java. sql .Connection; 

24 import java.io .*; 

import java.net .*; 

26 import java. util . Properties ; 

28 import java.lang.NumberFormatException; 

30 import javax.mail .*; 

import javax.mail. internet .*; 

32 

import ncv.gatewayif.XMLMessage; 

34 import ncv.gatewayif.MessageList; 

36 /** 

This class looks in the MeasXferTable in the Pilot Server database for pending 

38 messages and error messages. If error and/or pending messages are found, an email 

notification will be generated and sent. 

40 */ 

42 public class CheckPendingMessages extends Thread { 

private long sleepTimer; 

44 private long MASRcvdTimeOut; 

private long LISTimeOut; 

46 private String logFileName; 

private String EmailFrom; 

48 private String EmailTo; 

private String EmailSubject; 

50 private String EmailHost; 

private String configFileName; 

52 

54 /** Send email with content of parameter msgText to configured receipient . */ 

public void SendMail (String msgText) { 

56 boolean debug = false; 

boolean sendmutlipart = false; 

58 

// set the host


60 Properties props = new Properties(); 

props.put(”mail.smtp.host”, EmailHost); 

62 

// create some properties and get the default Session 

64 Session session = Session. getDefaultInstance (props , null ); 

66 try { 

// create a message 

68 Message msg = new MimeMessage(session); 

70 // set the from 

InternetAddress from = new InternetAddress(EmailFrom); 

72 msg.setFrom(from); 

74 InternetAddress [] address = {new InternetAddress(EmailTo)}; 

msg. setRecipients (Message.RecipientType.TO, address); 

76 msg.setSubject(EmailSubject); 

78 msg.setContent(msgText, ”text/plain”); 

80 Transport.send(msg); 

System.out. println (”CPM: Message sent to ”+EmailTo+” via ”+EmailHost+”.”); 

82 } catch (MessagingException mex) { 

mex.printStackTrace (); 

84 } 

} 

86 

/** Default Constructor . Reads configFileName to set values . */ 

88 public CheckPendingMessages (String configFileName) { 

this .configFileName = configFileName; 

90 Config cfg = new Config(configFileName); 

92 sleepTimer = cfg.getCPMTimeOut(); 

setDaemon(true); 

94 

96 

logFileName = cfg.getLogFileName(); 

Logger logger = new Logger(logFileName); 

98 logger . log((short ) 7, ( short ) 8, ”CPM”, ”START”, ”CheckPendingMessages ” 

+ ”thread has been started.” ); 

100 

MASRcvdTimeOut = cfg.getMASRcvdTimeOut(); 

102 LISTimeOut = cfg.getLISTimeOut(); 

104 EmailFrom = cfg.getEmailFrom(); 

EmailTo = cfg.getEmailTo(); 

106 EmailSubject = cfg.getEmailSubject (); 

EmailHost = cfg.getEmailHost(); 

108 } 

110 /** This method checks the database for CE/CR/AE and pending ACK messages from 

* MAS and LIS. 

112 * It runs permanently but sleeps for sleepTimer milliseconds . 

*/ 

114 

public void run() {


116 ErrorMessageList CEMsgList; 

ErrorMessageList CRMsgList; 

118 ErrorMessageList AEMsgList; 

ErrorMessageList PendingACKMsgList; 

120 ErrorMessageList PendingLISMsgList; 

ErrorMessage errMsg; 

122 DBSession db; 

Connection conn; 

124 int i ; 

126 while(true) { 

db = new DBSession(configFileName); 

128 conn = db.openDB(); 

int numMessages = db.getNumRows(conn); 

130 String msgText = ”Gateway Interface Status Report\n” 

+ ”−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−\n\n”; 

132 

CEMsgList = db.getCommitErrorMessages(conn); 

134 CRMsgList = db.getCommitRejectMessages(conn); 

AEMsgList = db.getApplicationErrorMessages(conn); 

136 

if (CEMsgList.size() == 0) 

138 System.out. println (”CPM: no CE messages found.”); 

else { 

140 for ( i = 0; i < CEMsgList.size (); i++) { 

errMsg = (ErrorMessage) CEMsgList.get(i); 

142 db.updateFlagNotified(conn, ””+errMsg.getMeasID(), true); 

System.out. println (”DBS: ACK CE MeasID #”+errMsg.getMeasID() 

144 +” Comment: ”+errMsg.getComment()+”.”); 

} 

146 } 

System.out. println (”DBS: CE Percentage: ”+ (float) CEMsgList.size() 

148 /numMessages+” (”+CEMsgList.size()+” out of ”+numMessages+”).”); 

msgText += ”CE Percentage: ”+ (float) CEMsgList.size()/numMessages 

150 +” (”+CEMsgList.size()+” out of ”+numMessages+”).\n”; 

152 if (CRMsgList.size() == 0) 

System.out. println (”CPM: no CR messages found.”); 

154 else { 

for ( i = 0; i < CRMsgList.size (); i++) { 

156 errMsg = (ErrorMessage) CRMsgList.get(i); 

db.updateFlagNotified(conn, ””+errMsg.getMeasID(), true); 

158 System.out. println (”DBS: ACK CR MeasID #”+errMsg.getMeasID() 

+” Comment: ”+errMsg.getComment()+”.”); 

160 } 

} 

162 System.out. println (”DBS: CR Percentage: ”+ (float) CRMsgList.size() 

/numMessages+” (”+CRMsgList.size()+” out of ”+numMessages+”).”); 

164 msgText += ”CR Percentage: ”+ (float) CRMsgList.size()/numMessages 

+” (”+CRMsgList.size()+” out of ”+numMessages+”).\n”; 

166 

if (AEMsgList.size() == 0) 

168 System.out. println (”CPM: no AE messages found.”); 

else { 

170 for ( i = 0; i < AEMsgList.size (); i++) { 

errMsg = (ErrorMessage) AEMsgList.get(i);



System.out. println (”DBS: ACK AE MeasID #”+errMsg.getMeasID() 

174 +” Comment: ”+errMsg.getComment()+”.”); 

} 

176 } 

System.out. println (”DBS: AE Percentage: ”+ (float) AEMsgList.size() 

178 /numMessages+” (”+AEMsgList.size()+” out of ”+numMessages+”).”); 

msgText += ”AE Percentage: ”+ (float) AEMsgList.size()/numMessages 

180 +” (”+AEMsgList.size()+” out of ”+numMessages+”).\n”; 

182 try { 

PendingACKMsgList = db.getPendingACKMessages(conn, MASRcvdTimeOut); 

184 if (PendingACKMsgList.size() == 0) 

System.out. println (”CPM: no pending ACK messages found.”); 

186 else { 

for ( i = 0; i < PendingACKMsgList.size(); i++) { 

188 errMsg = (ErrorMessage) PendingACKMsgList.get(i); 

db.updateFlagNotified(conn, ””+errMsg.getMeasID(), true); 

190 db.updateComment(conn, ””+errMsg.getMeasID(), ”Pending ACK”); 

System.out. println (”DBS: Pending ACK MeasID #” 

192 +errMsg.getMeasID()+”.”); 

} 

194 } 

System.out. println (”DBS: Pending ACK Percentage: ” 

196 + (float) PendingACKMsgList.size()/numMessages 

+” (”+PendingACKMsgList.size()+” out of ”+numMessages+”).”); 

198 msgText += ”Pending ACK Percentage: ” 

+ (float) PendingACKMsgList.size()/numMessages+” (” 

200 +PendingACKMsgList.size()+” out of ”+numMessages+”).\n”; 

202 } catch (NumberFormatException nfe) { 

System.err . println (”CPM: NumberFormatException thrown.”); 

204 } 

206 PendingLISMsgList = db.getPendingLISMessages(conn, LISTimeOut); 

if (PendingLISMsgList.size() == 0) 

208 System.out. println (”CPM: no pending LIS messages found.”); 

else { 

210 for ( i = 0; i < PendingLISMsgList.size (); i++) { 

errMsg = (ErrorMessage) PendingLISMsgList.get(i); 


db.updateComment(conn, ””+errMsg.getMeasID(), ”Pending LIS ACK”); 

214 System.out. println (”DBS: Pending LIS MeasID #” 

+errMsg.getMeasID()+”.”); 

216 } 

} 

218 System.out. println (”DBS: Pending LIS Percentage: ” 

+ (float) PendingLISMsgList.size()/numMessages 

220 +” (”+PendingLISMsgList.size()+” out of ”+numMessages+”).”); 

msgText += ”Pending LIS Percentage: ” 

222 + (float) PendingLISMsgList.size()/numMessages 

+” (”+PendingLISMsgList.size()+” out of ”+numMessages+”).\n”; 

224 

226 

db.closeDB(conn); 

SendMail(msgText);


228 

try { 

230 sleep (sleepTimer); 

} catch (InterruptedException ie ) { 

232 System.err . println (”CPM: Interrupted Exception caught.”); 


234 logger . log((short ) 7, ( short ) 8, ”CPM”, ”INT EX”, 

” Interrupted Exception: CheckPendingMessages thread ” 

236 + ”has been shut killed .” ); 

} 

238 } // end while 

} // end run 

240 } // end CheckPendingMessages class 

C.1.3 

/** 

Config.java 

2 * $Workfile : Config. java 

* 



6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


* 





18 * 

*/ 

20 

22 


import java.io . File ; 

24 import java.io . FileInputStream ; 

import java.io .FileNotFoundException; 

26 import java.io .InputStream; 

import java.io .IOException; 

28 import java.lang. Integer ; 

import java. util . Properties ; 

30 

/** This class provides methods to read configurable values out of a configuration file . 

32 */ 

34 public class Config { 

/** filename of the configuration file . */ 

36 private static String configFileName = ”gatewayif.cfg”; 

38 // Socket connection related values */ 

40 /** name or IP address of the Pilot Server */ 

private static String PilotServer ;


42 /** name or IP address of the remote gateway (MAS) */ 

private static String RemoteGateway; 

44 /** Port on Pilot Server for incoming messages */ 

private static int CICInPort; 

46 /** Port on remote System for outgoing messages */ 

private static int CICOutPort; 

48 

private static String SendingApplication ; 

50 private static String SendingFacility ; 

private static String ReceivingApplication ; 

52 private static String ReceivingFacility ; 

54 // Database related values 

56 /** name of database user */ 

private static String dbUser; 

58 /** password of database user */ 

private static String dbPassword; 

60 /** name of database server */ 

private static String dbServer; 

62 /** name of database */ 

private static String dbName; 

64 /** name of database driver */ 

private static String dbDriver; 

66 

68 

// Timeouts in milliseconds 

/** Time to wait for ACK (CA) message from remote gateway */ 

70 private static long ACKTimeOut; 

/** Timeout for SendMessageClient Thread (sleeptimer) */ 

72 private static long ScanDBTimeOut; 

/** Timeout for CheckPendingMessages Thread (sleeptimer) */ 

74 private static long CPMTimeOut; 

/** Timeout for ReceiveMessageServer Thread (sleeptimer) */ 

76 private static long RMSTimeOut; 

/** Time MAS Test Server waits until sending ACK message */ 

78 private static long MASRcvdTimeOut; 

/** Time MAS Test Server waits until sending LIS ACK message */ 

80 private static long LISTimeOut; 

/** Timeout for closing open socket connections */ 

82 private static int SocketTimeOut; 

84 /** filename of the log file */ 

private static String logFileName; 

86 

88 

// email related values 

/** email From: field */ 

90 private static String EmailFrom; 

/** email To: field */ 

92 private static String EmailTo; 

/** email Subject : field */ 

94 private static String EmailSubject; 

/** name or IP Address of the SMTP server */ 

96 private static String EmailHost;


98 /** returns name or IP address of the Pilot Server */ 

public static String getPilotServer () { 

100 return PilotServer ; 

} 

102 

/** returns name or IP address of the remote gateway */ 

104 public static String getRemoteGateway() { 

return RemoteGateway; 

106 } 

108 /** returns port number on pilot server side for incoming XML messages */ 

public static int getCICInPort() { 

110 return CICInPort; 

} 

112 

/** returns port number on remote gateway for outgoing XML messages */ 

114 public static int getCICOutPort() { 

return CICOutPort; 

116 } 

118 /** returns the name of the sending application */ 

public static String getSendingApplication () { 

120 return SendingApplication ; 

} 

122 

/** returns the name of the sending facility */ 

124 public static String getSendingFacility () { 

return SendingFacility ; 

126 } 

128 /** returns the name of the receiving application */ 

public static String getReceivingApplication () { 

130 return ReceivingApplication ; 

} 

132 

/** returns the name of the receiving facility */ 

134 public static String getReceivingFacility () { 

return ReceivingFacility ; 

136 } 

138 /** returns the name of the database user */ 

public static String getdbUser() { 

140 return dbUser; 

} 

142 

/** returns the password for the database user */ 

144 public static String getdbPassword() { 

return dbPassword; 

146 } 

148 /** returns the database server name or IP address */ 

public static String getdbServer() { 

150 return dbServer; 

} 

152 

/** returns the database name */


154 public static String getdbName() { 

return dbName; 

156 } 

158 /** returns the name for the database driver */ 

public static String getdbDriver() { 

160 return dbDriver; 

} 

162 

/** returns the path and filename for the configuration file */ 

164 public static String getConfigFileName() { 

return configFileName; 

166 } 

168 /** returns the timeout for acknowledgement messages. After this time 

* the socket connection will be shut down. 

170 */ 

public static long getACKTimeOut() { 

172 return ACKTimeOut; 

} 

174 

/** returns the sleeptimer for the SendMessageClient thread. After one 

176 * run , the thread will be set asleep for this amount of time. 

*/ 

178 public static long getScanDBTimeOut() { 

return ScanDBTimeOut; 

180 } 

182 /** returns the sleeptimer for the CheckPendingMessages thread. After one 

* run , the thread will be set asleep for this amount of time. 

184 */ 

public static long getCPMTimeOut() { 

186 return CPMTimeOut; 

} 

188 

/** returns the sleeptimer for the ReceiveMessageServer thread. After one 

190 * run , the thread will be set asleep for this amount of time. 

*/ 

192 public static long getRMSTimeOut() { 

return RMSTimeOut; 

194 } 

196 /** returns the timeout for the MAS test gateway until it responds to an incoming 

* XML message with a Commit Acknowledgement message. 

198 */ 

public static long getMASRcvdTimeOut() { 

200 return MASRcvdTimeOut; 

} 

202 

/** returns the timeout for the MAS test gateway until it responds to an incoming 

204 * XML message with an Application Acknowledgement message. 

*/ 

206 public static long getLISTimeOut() { 

return LISTimeOut; 

208 }


210 /** returns the timeout for closing an open socket connection */ 

public static int getSocketTimeOut() { 

212 return SocketTimeOut; 

} 

214 

/** returns the path and filename of the log file . */ 

216 public static String getLogFileName() { 

return logFileName; 

218 } 

220 /** returns the email From: field for the status report */ 

public static String getEmailFrom() { 

222 return EmailFrom; 

} 

224 

/** returns the email To: field for the status report */ 

226 public static String getEmailTo() { 

return EmailTo; 

228 } 

230 /** returns the email Subject : field for the status report */ 

public static String getEmailSubject() { 

232 return EmailSubject; 

} 

234 

/** returns the name or IP address for the SMTP server the status report 

236 * message is send to 

*/ 

238 public static String getEmailHost() { 

return EmailHost; 

240 } 

242 /** Constructor needs the filename of the configuration file as parameter */ 

public Config(String filename ) { 

244 configFileName = filename; 

File cfgFile = new File(filename ); 

246 try { 

InputStream inStream = new FileInputStream(cfgFile); 

248 Properties cfgProp = new Properties(); 

cfgProp.load(inStream); 

250 

// get the values from the configuration file , second parameter 

252 // is a default value if no value is set in the configuration file 

PilotServer = cfgProp.getProperty(” PilotServer ”, ” PilotServer . Agilent”); 

254 RemoteGateway = cfgProp.getProperty(”RemoteGateway”, ”MASTestServer”); 

CICInPort = Integer . parseInt (cfgProp.getProperty(”CICInPort”, ”5000”)); 

256 CICOutPort = Integer.parseInt (cfgProp.getProperty(”CICOutPort”, ”5001”)); 

258 SendingApplication = cfgProp.getProperty(”SendingApplication”, 

”SendingApplication”); 

260 SendingFacility = cfgProp.getProperty(” SendingFacility ”, 

” SendingFacility ”); 

262 ReceivingApplication = cfgProp.getProperty(” ReceivingApplication ”, 

” ReceivingApplication ”); 

264 ReceivingFacility = cfgProp.getProperty(” ReceivingFacility ”, 

” ReceivingFacility ”);


266 

dbUser = cfgProp.getProperty(”dbUser”, ”dbUser”); 

268 dbPassword = cfgProp.getProperty(”dbPassword”, ”dbPassword”); 

dbServer = cfgProp.getProperty(”dbServer”, ”dbServer”); 

270 dbName = cfgProp.getProperty(”dbName”, ”dbName”); 

dbDriver = cfgProp.getProperty(”dbDriver”, ”dbDriver”); 

272 

ACKTimeOut = Long.parseLong(cfgProp.getProperty(”ACKTimeOut”, ”15000”)); 

274 ScanDBTimeOut = Long.parseLong(cfgProp.getProperty(”ScanDBTimeOut”, 

”15000”)); 

276 CPMTimeOut = Long.parseLong(cfgProp.getProperty(”CPMTimeOut”, ”300000”)); 

RMSTimeOut = Long.parseLong(cfgProp.getProperty(”RMSTimeOut”, ”1000”)); 

278 

MASRcvdTimeOut = Long.parseLong(cfgProp.getProperty(”MASRcvdTimeOut”, 

280 ”60000”)); 

LISTimeOut = Long.parseLong(cfgProp.getProperty(”LISTimeOut”, ”300000”)); 

282 SocketTimeOut = Integer.parseInt(cfgProp.getProperty(”SocketTimeOut”, 

”60000”)); 

284 

286 

logFileName = cfgProp.getProperty(”LogFile”, ”gatewayif . log”); 

EmailFrom = cfgProp.getProperty(”EmailFrom”, 

288 ”gatewayif@labs. agilent .com”); 

EmailTo = cfgProp.getProperty(”EmailTo”, ”david vogler@agilent .com”); 

290 EmailSubject = cfgProp.getProperty(”EmailSubject”, 

”GatewayIF status report”); 

292 EmailHost = cfgProp.getProperty(”EmailHost”, ”localhost”); 

294 inStream. close (); 

296 } catch (FileNotFoundException e) { 

System.out. println (”config file not found: ” + filename ); 


} catch (IOException e) { 

300 System.err . println (”unable to get properties .” ); 

e. printStackTrace (); 


} 

304 } 

306 } // end Config class 

C.1.4 

/** 

DBSession.java 

2 * $Workfile : DBSession.java 

* 



6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


*


14 * Handles connection to the pilot server database. 

* 





20 * 

*/ 

22 

24 

26 

28 


import java. sql .*; 

/** This class provides all the database functionality . */ 

public class DBSession{ 

30 // username for database login 

private static String user = ”sa”; 

32 // password for database login 

private static String password = ””; 

34 // database server name or IP address 

private static String server = ”med−iris”; 

36 // database name 

private static String db = ”demodb”; 

38 // database driver 

private static String driver = ”com.inet.tds .TdsDriver”; 

40 // URL for database driver 

private static String url = ”jdbc:inetdae :”+server+”:1433?database=” 

42 +db; 

44 Connection conn = null; 

Statement stmt = null; 

46 ResultSet rs = null; 

ResultSetMetaData rsmd = null; 

48 

// query for fetching all new measurements with the information 

50 // needed to generate an ORM R01 XML message 

private static String query = ”select p.ID as PatientID, p.kppID, ” 

52 + ”m.ID as MeasID, mINR.INR Value, mINR.calCode, m.timeStamp ” 

+ ”from ”+db+”.dbo.patient p, ”+db+”.dbo.measINR mINR, ” 

54 + db+”.dbo.Measurement m ” 

+ ”where (m.type = 6) and (p.ID = m.patientID) and (mINR.measID = m.ID) ” 

56 + ”and (m.ID in (” 

+ ”select MeasID from MeasXferStatus ” 

58 + ”where (timeStampSent is null) and (timeStampRcvd is null) ” 

+ ”))”; 

60 

private static String logFileName = ”gateway.log”; 

62 private static String timeStamp = ””; 

64 /** Constructor initializes member variables with values out of 

* the given configuration file 

66 */ 

public DBSession(String configFileName) { 

68 Config cfg = new Config(configFileName); 

user = cfg.getdbUser();


70 password = cfg.getdbPassword(); 

server = cfg.getdbServer (); 

72 db = cfg.getdbName(); 

driver = cfg.getdbDriver (); 

74 url = ”jdbc:inetdae :”+server+”:1433?database=”+db; 

} 

76 

// open database connection 

78 // returns Connection object for other methods to access database 

80 /** Open a database connection, returns database link as a Connection */ 

public Connection openDB() { 

82 try { 

System.out. println (”DBS: connecting to database.”); 

84 Class .forName(driver ).newInstance(); 

conn = DriverManager.getConnection(url, user , password); 

86 } catch (Exception e) { 

System.err . println (e); 



90 } 

return conn; 

92 } 

94 /** update timeStampSent field in MeasXferStatus */ 

96 public boolean updateTimeStampSent (Connection conn, String MeasID, String timeStamp) { 

String updateQuery = ”update ”+db+”.dbo.MeasXferStatus ” 

98 + ”set timeStampSent = ’”+ timeStamp + ”’” 

+ ” where measID = ”+ MeasID; 

100 try { 

stmt = conn.createStatement(); 

102 if (stmt.execute(updateQuery)) 

return true; 

104 else 

return false ; 

106 } catch (SQLException e) { 

System.err . println (”Could not execute update timeStampSent.”); 

108 System.err . println (e); 


110 return false ; 

} 

112 } 

114 /** update timeStampRcvd field in MeasXferStatus */ 

116 public boolean updateTimeStampRcvd (Connection conn, String MeasID, String timeStamp) { 


118 + ”set timeStampRcvd = ’”+ timeStamp + ”’” 


120 try { 



return true; 

124 else 

return false ;



System.err . println (”Could not execute update timeStampRcvd.”); 


} 

130 } 

132 /** update timeStampLIS field in MeasXferStatus */ 

134 public boolean updateTimeStampLIS (Connection conn, String MeasID, String timeStamp) { 


136 + ”set timeStampLIS = ’”+ timeStamp + ”’” 


138 try { 



return true; 

142 else 



System.err . println (”Could not execute update timeStampLIS.”); 


} 

148 } 

150 /** update flagCA field in MeasXferStatus */ 

152 public boolean updateFlagCA (Connection conn, String MeasID, boolean flag) { 

int MSSQLFlag = (flag) ? 1 : 0; 

154 String updateQuery = ”update ”+db+”.dbo.MeasXferStatus ” 

+ ”set flagCA = ”+ MSSQLFlag 

156 + ” where measID = ”+ MeasID; 

try { 

158 stmt = conn.createStatement(); 

if (stmt.execute(updateQuery)) 

160 return true; 

else 


} catch (SQLException e) { 

164 System.err . println (”Could not execute update flagCA.”); 




168 } 

} 

170 

172 

/** update flagCE field in MeasXferStatus */ 

public boolean updateFlagCE (Connection conn, String MeasID, boolean flag) { 

174 int MSSQLFlag = (flag) ? 1 : 0; 


176 + ”set flagCE = ”+ MSSQLFlag 


178 try { 



return true;


182 else 



System.err . println (”Could not execute update flagCE.”); 


} 

188 } 

190 /** update flagCR field in MeasXferStatus */ 

192 public boolean updateFlagCR (Connection conn, String MeasID, boolean flag) { 



+ ”set flagCR = ”+ MSSQLFlag 


try { 


if (stmt.execute(updateQuery)) 


else 



204 System.err . println (”Could not execute update flagCR.”); 


206 } 

} 

208 

210 

/** update flagAA field in MeasXferStatus */ 

public boolean updateFlagAA (Connection conn, String MeasID, boolean flag) { 



214 + ”set flagAA = ”+ MSSQLFlag 


216 try { 



return true; 

220 else 



System.err . println (”Could not execute update flagAA.”); 


} 

226 } 

228 /** update flagAE field in MeasXferStatus */ 

230 public boolean updateFlagAE (Connection conn, String MeasID, boolean flag) { 



+ ”set flagAE = ”+ MSSQLFlag 


try { 


if (stmt.execute(updateQuery))



else 



242 System.err . println (”Could not execute update flagAE.”); 


244 } 

} 

246 

248 

/** update flagNotified field in MeasXferStatus */ 

public boolean updateFlagNotified (Connection conn, String MeasID, boolean flag) { 



252 + ”set flagNotified = ”+ MSSQLFlag 


254 try { 



return true; 

258 else 



System.err . println (”DBS: Could not execute update flagNotified.”); 


} 

264 } 

266 /** update timesSent field in MeasXferStatus */ 

268 public boolean updateTimesSent (Connection conn, String MeasID, int times) { 


270 + ”set timesSent = ”+ times 


272 try { 



return true; 

276 else 



System.err . println (”Could not execute update timesSent.”); 


} 

282 } 

284 /** update comment in MeasXferStatus */ 

286 public boolean updateComment (Connection conn, String MeasID, String Comment) { 


288 + ”set comment = ’”+ Comment 

+ ”’ where measID = ”+ MeasID; 

290 try { 

System.out. println (”DBS: updating MeasID #”+MeasID+” comment to: ” 

292 +Comment); 

stmt = conn.createStatement();



return true; 

296 else 



System.err . println (”Could not execute update comment.”); 


} 

302 } 

304 /** close database connection */ 

306 public void closeDB(Connection conn) { 

try { 

308 conn.close (); 

} catch (Exception e) { 




} 

314 } 

316 /** returns Object MessageList with all new measurements */ 

318 public MessageList getMsgList(Connection conn) { 

MessageList MsgList = new MessageList(); 

320 try { 


322 if (stmt.execute(query)) { 

rs = stmt.getResultSet (); 

324 rsmd = rs.getMetaData(); 

int numColumns = rsmd.getColumnCount(); 

326 // for ( int i = 0; i < 3; i++) { 

// rs .next (); 

328 

330 

System.out. println (”DBS: fetching messages from database.”); 

while(rs .next ()) { 

332 SendMessage msg = new SendMessage(rs.getInt(1), rs.getString(2), 

rs . getInt (3), rs . getFloat (4), rs . getFloat (5), 

334 rs . getString (6)); 

System.out. println (”DBS: adding new message to list.”); 

336 MsgList.add(msg); 

} 

338 rs . close (); 

} 

340 stmt. close (); 

} catch (SQLException sqle) { 

342 System.err . println ( sqle ); 

sqle . printStackTrace (); 


} 

346 return MsgList; 

} 

348 

/** get Messages with Pending timeStampRcvd */


350 

public ErrorMessageList getPendingACKMessages(Connection conn, long timeDiff) { 

352 ErrorMessageList ErrMsgList = new ErrorMessageList(); 

String selectQuery = ”select MeasID, timeStampSent, Comment from ”+db 

354 +”.dbo.MeasXferStatus ” 

+ ”where (timeStampRcvd is null) and (timeStampSent is not null) ” 

356 + ”and (flagNotified is null )”; 

try { 


if (stmt.execute(selectQuery )) { 

360 rs = stmt.getResultSet (); 

while ( rs .next ()) { 

362 ErrorMessage errMsg = new ErrorMessage(rs.getInt(1), 

rs . getString (3)); 

364 Timestamp timeStampSent = rs.getTimestamp(2); 

if (MiscDate.getTimeDiff(timeStampSent) > timeDiff) { 

366 ErrMsgList.add(errMsg); 

} 

368 } 

} 

370 } catch (SQLException sqle) { 

System.err . println (”DBS: error getting pending ACK message list.”); 

372 Logger logger = new Logger(logFileName); 

logger . log((short ) 7, ( short ) 8, ”DBS”, ”GET ACK LIST ERR”, 

374 ”SQLError getting pending ACK message list.”); 

} 

376 return ErrMsgList; 

} 

378 

380 

/** get Messages with Pending timeStampLIS */ 

public ErrorMessageList getPendingLISMessages(Connection conn, long timeDiff) { 

382 ErrorMessageList ErrMsgList = new ErrorMessageList(); 

timeStamp = MiscDate.todaysDate(); 

384 String selectQuery = ”select MeasID, timeStampSent, Comment from ”+db 

+”.dbo.MeasXferStatus ” 

386 + ”where (timeStampLIS is null) and (timeStampSent is not null) ” 

+ ”and (flagNotified is null )”; 

388 try { 


390 if (stmt.execute(selectQuery )) { 


392 while ( rs .next ()) { 

ErrorMessage errMsg = new ErrorMessage(rs.getInt(1), 

394 rs . getString (3)); 

Timestamp timeStampSent = rs.getTimestamp(2); 

396 if (MiscDate.getTimeDiff(timeStampSent) > timeDiff) { 

ErrMsgList.add(errMsg); 

398 } 

} 

400 } 


402 System.err . println (”DBS: error getting pending LIS message list .” ); 


404 logger . log((short ) 7, ( short ) 8, ”DBS”, ”GET LIS LIST ERR”, 

”SQLError getting pending LIS message list.” );


406 } 

return ErrMsgList; 

408 } 

410 /** get Messages with flagCE set to true */ 

412 public ErrorMessageList getCommitErrorMessages(Connection conn) { 

ErrorMessageList ErrMsgList = new ErrorMessageList(); 

414 String selectQuery = ”select MeasID, Comment from ”+db+”.dbo.MeasXferStatus ” 

+ ”where (flagCE = 1) ” 


try { 








} 

426 } 


428 System.err . println (”DBS: error getting CE message list.” ); 


430 logger . log((short ) 7, ( short ) 8, ”DBS”, ”GET CE LIST ERR”, 

”SQLError getting CE message list.”); 

432 } 


434 } 

436 /** get Messages with flagCR set to true */ 

438 public ErrorMessageList getCommitRejectMessages(Connection conn) { 



+ ”where (flagCR = 1) ” 


try { 








} 

452 } 


454 System.err . println (”DBS: error getting CR message list.” ); 


456 logger . log((short ) 7, ( short ) 8, ”DBS”, ”GET CR LIST ERR”, 

”SQLError getting CR message list.”); 

458 } 


460 }


462 /** get Messages with flagAE set to true */ 

464 public ErrorMessageList getApplicationErrorMessages(Connection conn) { 



+ ”where (flagAE = 1) ” 


try { 








} 

478 } 


480 System.err . println (”DBS: error getting AE message list.” ); 


482 logger . log((short ) 7, ( short ) 8, ”DBS”, ”GET AE LIST ERR”, 

”SQLError getting AE message list.”); 

484 } 


486 } 

488 /** get timesSent field in MeasXferStatus */ 

490 public int getTimesSent (Connection conn, String MeasID) { 

String selectQuery = ”select timesSent from ”+db+”.dbo.MeasXferStatus ” 

492 + ”where measID = ”+ MeasID; 

try { 




rs .next (); 

498 return rs . getInt (1); 

} else 

500 return −1; 


502 System.err . println (”Could not get timesSent data.”); 

return −1; 

504 } 

} 

506 

508 

/** get number of rows in table MeasXferStatys */ 

public int getNumRows (Connection conn) { 

510 String selectQuery = ”select MeasID from ”+db+”.dbo.MeasXferStatus”; 

int numRows = 0; 

512 try { 


514 if (stmt.execute(selectQuery )) { 


516 while ( rs .next()) 

numRows++;


518 } else 

numRows = 0; 

520 } catch (SQLException sqle) { 

System.err . println (”DBS: error getting number of rows.”); 

522 Logger logger = new Logger(logFileName); 

logger . log((short ) 7, ( short ) 8, ”DBS”, ”GET NUM ROWS ERR”, 

524 ”SQLError getting number of rows.”); 

} 

526 return numRows; 

} 

528 } 

C.1.5 

/** 

ErrorMessage.java 

2 * $Workfile : ErrorMessage.java 

* 



6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


* 





18 * 

*/ 

20 

22 


/** This class represents an error message object used by 

24 * the class CheckPendingMessages 

*/ 

26 

28 

public class ErrorMessage { 

/** MeasID out of the database to identify the dataset */ 

30 protected int MeasID; 

/** Comment string for the MeasXferStatus table */ 

32 protected String Comment; 

34 /** Constructor initializes the member values */ 

public ErrorMessage (int MeasID, String Comment) { 

36 this .MeasID = MeasID; 

this .Comment = Comment; 

38 } 

40 /** returns the MeasID of the error message */ 

public int getMeasID() { 

42 return MeasID; 

}


44 

/** returns the error comment of the error message */ 

46 public String getComment() { 

return Comment; 

48 } 

} 

C.1.6 

/** 

ErrorMessageList.java 

2 * $Workfile : ErrorMessageList. java 

* 



6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


* 





18 * 

*/ 

20 

22 

24 


import java. util . LinkedList ; 

/** This class is used by the CheckPendingMessages class to generate 

26 * a list of ErrorMessages 

*/ 

28 public class ErrorMessageList extends LinkedList{ 

} 

C.1.7 

/** 

Logger.java 

2 * $Workfile : Logger.java 

* 



6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


* 




* permission .


18 * 

*/ 

20 

22 

24 



/** This class is intended to log errors and other useful information to 

26 * an ASCII text file 

*/ 

28 public class Logger { 

String fileName; 

30 

/** Constructor needs filename of logfile */ 

32 public Logger (String fileName) { 

this .fileName = fileName; 

34 } 

36 /** Constructor with default filename if no parameter is given */ 

public Logger () { 

38 this(”gatewayif . log”); 

} 

40 

/** clear all logged entries in logfile */ 

42 public void clearLog () { 

try { 

44 BufferedWriter f = new BufferedWriter (new FileWriter(fileName, 

false )); 

46 String S = MiscDate.todaysDate(); 

f . write(S , 0, S.length ()); 

48 f .newLine(); 

f . close (); 

50 } catch (IOException e) {} 

} 

52 

54 

/** add new entry to log file with given parameters */ 

public boolean log(short priority , short subSystemCode, 

56 String moduleCode, String errorCode, String message) { 

try { 

58 RandomAccessFile file = new RandomAccessFile(fileName, ”rw”); 

long length = file . length (); 

60 file .seek(length ); 

PrintWriter out = new PrintWriter(new FileWriter( file .getFD()), true); 

62 if (out != null ) { 

out. println (””+MiscDate.todaysDate()+” prio:”+priority 

64 +” subSystemCode:”+subSystemCode+” moduleCode:” 

+moduleCode+” errorCode:”+errorCode+” msg:”+message); 

66 out. close (); 

} else 


file . close (); 


} catch (IOException ioe) { 

72 System.err . println (” error writing logfile .” ); 

return false ;


74 } 

} 

76 } // end of Logger class 

C.1.8 

/** 

MASTestServer.java 

2 * $Workfile : MASTestServer.java 

* 



6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


* 





18 * 

*/ 

20 

22 

24 

26 


import java. util .Date; 

import java. text .DateFormat; 


28 import java.io .IOException; 

import java.io .BufferedReader; 

30 import java.io . FileInputStream ; 

import java.io .InputStream; 

32 import java.io .InputStreamReader; 

import java.io . PrintWriter ; 

34 import java.io .Reader; 

import java.io .StringReader; 

36 

import java.net.ServerSocket; 

38 import java.net.Socket; 

import java.net.UnknownHostException; 

40 import java.net.ConnectException; 

42 import org.apache.xerces . parsers .DOMParser; 

44 import org.w3c.dom.Document; 

import org.w3c.dom.Node; 

46 import org.w3c.dom.NodeList; 

48 import org.xml.sax.InputSource; 

50 import ncv.gatewayif.Config;


52 /** Simulation of the MAS Gateway Interface and Sunquest’s Laboratory 

Information System (LIS) 

54 */ 

56 public class MASTestServer extends Thread { 

/** Port for incoming XML messages */ 

58 public static int CICINPORT = 5000; 

/** Port for outgoing XML messages */ 

60 public static int CICOUTPORT = 5001; 

public static long TIMEOUT = 1000L; 

62 /** Time MAS waits until sending response */ 

public static long RESPONSETIME = 10000L; 

64 /** Time MAS waits until sending timeout response */ 

public static long RESPONSETIMEOUT = 60000L; 

66 public static long responseTime = RESPONSETIME; 

public static String RECVSERVER = ”130.29.247.103”; 

68 private static final int MAXRESP = 9; 

/** array for different kinds of response cases */ 

70 private static String [] responseCase = new String[MAXRESP]; 

private String msgType=””; 

72 

74 

private long sleepTimer; 

/** constructor sets default values from MAS.cfg file */ 

76 public MASTestServer (long delay) { 

sleepTimer = delay; 

78 setDaemon(true); 

File cfgFile = new File(”MAS.cfg”); 

80 

try { 

82 BufferedReader in = new BufferedReader(new InputStreamReader(new 

FileInputStream( cfgFile ))); 

84 for ( int i = 0; i < MAXRESP; i++) { 

responseCase[ i ] = in .readLine (); 

86 System.out. println (”MAS: case[”+i+”] = ” + responseCase[i]); 

} 

88 in . close (); 

} catch (IOException ioe) { 

90 System.err . println (”MAS: error reading configuration file .” ); 

System.err . println (ioe ); 

92 ioe . printStackTrace (); 

} 

94 } 

96 /** generate DOM document out of received XML string */ 

98 public Document getDOMDocument(String xmlstring){ 

Reader xmlreader = new StringReader(xmlstring); 

100 InputSource xmlsource = new InputSource(xmlreader); 

102 DOMParser parser = new DOMParser(); 

104 try { 

parser . parse(xmlsource); 


System.err . println (”Error in parsing : ” + e.getMessage());



} 

110 Document doc = parser.getDocument(); 

return doc; 

112 } 

114 public static void main(String [] args ) throws IOException { 

116 System.out. println (”MAS Gateway Interface Test Server”); 

118 Thread first = new MASTestServer(TIMEOUT); 

120 System.out. println (”press enter to quit .” ); 

122 first . start (); 

124 try { 

System.in.read (); 

126 System.out. println (”MASTestServer shutdown.”); 





} 

132 

134 } 

return; 

136 public void run() { 

138 ServerSocket serverSocket = null; 

Socket clientSocket = null; 

140 Socket sendSocket = null; 

DateFormat defaultDate; 

142 PrintWriter out = null; 

BufferedReader in = null; 

144 String inputLine , outputLine , message; 

Document doc; 

146 NodeList nodeList; 

Node nodeMSH10Text; // Message Control ID 

148 String MessageControlID = ” uninitialized ”; 

String endDocumentTag = ””; 

150 SendMessage msg; 

int c; 

152 int rsp = 0; 

154 Config cfg = new Config(Config.getConfigFileName()); 

156 RECVSERVER = cfg.getPilotServer(); 

CICINPORT = cfg.getCICInPort(); 



162 System.out. println (”ready to listen on port #”+CICINPORT+”.\n”);


164 try { 

serverSocket = new ServerSocket(CICINPORT); 


System.err . println (”Can not listen on port #” + CICINPORT); 




} 

172 

try { 

174 clientSocket = serverSocket .accept (); 


176 System.err . println (”Accept failed .” ); 



} 

180 

defaultDate = DateFormat.getDateInstance(); 

182 System.out. print (defaultDate.format(new Date())); 

System.out. println (” incoming socket connection established .” ); 

184 

// go to next test case 

186 System.out. println (”Processing test case #”+rsp+”.”); 

188 

try { 

190 out = new 

PrintWriter ( clientSocket .getOutputStream(),true); 

192 in = new BufferedReader(new 

InputStreamReader(clientSocket.getInputStream())); 

194 

196 

message = new String(); 

while((inputLine = in.readLine ()) != null ) { 

198 if ( inputLine .indexOf(”ORM O01”, 0) > 0) 

endDocumentTag = ””; 

200 if ( inputLine .indexOf(endDocumentTag, 0) > 0) { 

message += inputLine; 

202 // System.out. println (”MAS: ” + inputLine); 

break; 

204 } else { 


206 // System.out. println (”MAS: ” + inputLine); 

} 

208 } 

210 doc = getDOMDocument(message); 

nodeList = doc.getElementsByTagName(”MSH.10”); 

212 nodeMSH10Text = nodeList.item(0).getFirstChild(); 

MessageControlID = nodeMSH10Text.getNodeValue(); 

214 System.out. println (”MSH.10 = ” + nodeMSH10Text.getNodeValue()); 

216 System.out. println (”MAS: response case for this test run is ” 

+ responseCase[rsp] + ”.” ); 

218 

if (responseCase[rsp ]. equals(”CA”) || responseCase[rsp ]. equals(”AA”)


220 || responseCase[rsp ]. equals(”AE”) 

|| responseCase[rsp ]. equals(”00”)) { 

222 msgType = ”CA”; 

msg = new SendMessage(MessageControlID, msgType); 

224 System.out. println (”MAS: ACK CA generated.”); 

} else if (responseCase[rsp ]. equals(”CE”)) { 

226 msgType = ”CE”; 


228 msg.setErrorComment(”General Error”); 

System.out. println (”MAS: ACK CE generated.”); 

230 } else if (responseCase[rsp ]. equals(”CR”)) { 

msgType = ”CR”; 

232 msg = new SendMessage(MessageControlID, msgType); 

msg.setErrorComment(”General Rejection”); 

234 System.out. println (”MAS: ACK CR generated.”); 

} else { 

236 msgType = ”CA”; 


238 } 

240 // sleep to simulate response time 

242 if (responseCase[rsp ]. equals(”00”)) 

responseTime = RESPONSETIMEOUT; 

244 else 

responseTime = RESPONSETIME; 

246 

System.out. println (”MAS: waiting for ” + (responseTime/1000) 

248 + ” seconds to send message.”); 

try { 

250 sleep (responseTime); 

} catch (InterruptedException ie ) { 

252 System.err . println (”MAS: sleep() interrupted.” ); 

} 

254 

out. println (msg.toString ACK()); 

256 System.out. println (”MAS: ACK ”+msgType+” message sent.”); 

// System.out. println (”MAS: ” + msg.toString ACK()); 

258 

in . close (); 


clientSocket . close (); 

262 serverSocket . close (); 





268 } 

270 // now sending AA to RecvMessageServer on Port #5001 

// depending on test case. 

272 

if (responseCase[rsp ]. equals(”AA”) || responseCase[rsp ]. equals(”AE”)) { 

274 try { 

System.out. println (”Sending ACK to ”+RECVSERVER+” on port #”


276 +CICOUTPORT); 

sendSocket = new Socket(RECVSERVER, CICOUTPORT); 

278 out = new PrintWriter(sendSocket.getOutputStream(), true); 

in = new BufferedReader(new 

280 InputStreamReader(sendSocket.getInputStream())); 

} catch (UnknownHostException e) { 

282 System.err . println (”Don’t know about hostname: ” + 

RECVSERVER); 




} catch (ConnectException e) { 

288 System.err . println (”Connection has been refused. Try it again.” ); 


290 System.err . println (”Couldn’t get I/O for connection. ” 

+ ”Try it again.” ); 

292 } 

294 

try { 

296 System.out. println (”Sending Application Ack (”+responseCase[rsp] 

+”) to Pilot Server Gateway.”); 

298 msg = new SendMessage(MessageControlID, responseCase[rsp]); 

if (responseCase[rsp ]. equals(”AA”)) 

300 msg.setErrorComment(”A24680”); 

else 

302 msg.setErrorComment(”Invalid Patient”); 

out. println (msg.toString ORR O02()); 

304 System.out. println (”Closing socket connection to PS Gateway ” 

+ ”Interface .” ); 


System.err . println (”Error sending message.”); 

308 } 

310 try { 


312 


314 if ( inputLine .indexOf(”ACK”, 0) > 0) 




318 break; 

} else { 

320 message += inputLine; 

} 

322 } 

324 RecvMessage msgIN = new RecvMessage(message); 

System.out. println (”MAS: rcvd ACK for AA: ” 

326 +msgIN.getMsgControlID()); 

328 } catch (IOException ioe) { 

System.err . println (”MAS: error receiving CA.”); 

330 }


332 try { 

sendSocket. close (); 


in . close (); 





340 } catch (NullPointerException e) { 

System.err . println (”Null Pointer Exception for closing socket.” ); 

342 } 

} 

344 

// setting new test case 

346 rsp++; 

if ( rsp >= MAXRESP) 

348 rsp = 0; 

350 try { 

System.out. println (”Connection closed. Waiting for timeout.” ); 


} catch (InterruptedException e) { 




} 

358 

360 } 

} 

C.1.9 

/** 

} 

MessageList.java 

2 * $Workfile : MessageList.java 

* 



6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


* 





18 * 

*/ 

20 

22 

24 


import java. util . LinkedList ;


/** This class is used by the SendMessageClient class to generate 

26 * a linked list of XMLMessages to be send to the MAS remote gateway 

*/ 

28 public class MessageList extends LinkedList{ 

} 

C.1.10 

/** 

MiscDate.java 

2 * $Workfile : MiscDate.java 

* 



6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


* 





18 * 

*/ 

20 

22 


import java.lang. Integer ; 

24 import java. sql .Timestamp; 


26 import java. util .Date; 

import java. util .Calendar; 

28 import java. util .GregorianCalendar; 

30 /** This class is used to get general time and date information and to compute 

* time differences . 

32 */ 

34 public class MiscDate { 

/** returns today’s date as a formatted string */ 

36 public static String todaysDate() { 

Calendar C = new GregorianCalendar(); 

38 String DateString = ””; 

40 if (C.get(Calendar.MONTH)+1 < 10) 

DateString = ”0”; 

42 DateString += C.get(Calendar.MONTH)+1 + ”/”; 

if (C.get(Calendar.DAY OF MONTH) < 10) 

44 DateString += ”0”; 

DateString += C.get(Calendar.DAY OF MONTH); 

46 DateString += ”/”+C.get(Calendar.YEAR) + ” ”; 

if (C.get(Calendar.HOUR OF DAY) < 10) 


DateString += C.get(Calendar.HOUR OF DAY) + ”:”;


50 if (C.get(Calendar.MINUTE) < 10) 

DateString += ”0”; 

52 DateString += C.get(Calendar.MINUTE) + ”:”; 

if (C.get(Calendar.SECOND) < 10) 


DateString += C.get(Calendar.SECOND); 

56 

58 } 

return DateString; 

60 /** returns time difference in milliseconds between now and 

* a given timestamp 

62 */ 

64 public static long getTimeDiff(Timestamp timeStampSent) { 

Calendar today = new GregorianCalendar(); 

66 Timestamp now = new Timestamp(today.getTime().getTime()); 

long timeDiff = now.getTime() − timeStampSent.getTime(); 

68 

System.out. println (”MD: timeStampSent: ”+timeStampSent); 

70 System.out. println (”MD: now: ”+now); 

System.out. println (”MD: difference: ”+timeDiff); 

72 

74 } 

return timeDiff ; 

76 /** returns today’s date and time as a String like the database 

* returns it 

78 */ 

public static String MessageDate() { 

80 Calendar C = new GregorianCalendar(); 

String DateString = null; 

82 

84 

DateString = ”” + C.get(Calendar.YEAR); 

if (C.get(Calendar.MONTH) < 10) 

86 DateString += ’0’; 

DateString += C.get(Calendar.MONTH); 

88 if (C.get(Calendar.DAY OF MONTH) < 10) 

DateString += ’0’; 

90 DateString += C.get(Calendar.DAY OF MONTH); 

if (C.get(Calendar.HOUR OF DAY) < 10) 


DateString += C.get(Calendar.HOUR OF DAY); 

94 if (C.get(Calendar.MINUTE) < 10) 

DateString += ’0’; 

96 DateString += C.get(Calendar.MINUTE); 

if (C.get(Calendar.SECOND) < 10) 


DateString += C.get(Calendar.SECOND); 

100 

102 } 

return DateString; 

104 } // end MiscDate class


C.1.11 

/** 

NotifyByEmail.java 

2 * $Workfile : NotifyByEmail.java 

* 



6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


* 





18 * 

*/ 

20 

22 


import java. util .*; 

24 import javax.mail .*; 

import javax.mail. internet .*; 

26 

public class NotifyByEmail { 

28 public static void main(String [] args) { 

if ( args . length != 4) { 

30 System.out. println ( 

”usage: sendmessage ” + 

32 ””); 


34 } 

36 boolean debug = false; // change to get more information 

String msgText = ”A body.\nthe second line.”; 

38 String msgText2 = ”Another body.\nmore lines”; 

boolean sendmultipart = 

40 Boolean.valueOf(args [3]). booleanValue(); 

42 // set the host 

Properties props = new Properties(); 

44 props.put(”mail.smtp.host”, args [2]); 

46 // create some properties and get the default Session 

Session session = Session. getDefaultInstance (props , null ); 

48 session .setDebug(debug); 

50 try { 

// create a message 

52 Message msg = new MimeMessage(session); 

54 // set the from 

InternetAddress from = new InternetAddress(args [1]);


56 msg.setFrom(from); 

58 InternetAddress [] address = { new InternetAddress(args [0]) }; 

msg. setRecipients (Message.RecipientType.TO, address); 

60 msg.setSubject(”JavaMail APIs Test”); 

62 if (! sendmultipart ) { 

// send a plain text message 

64 msg.setContent(msgText, ”text/plain”); 

} else { 

66 // send a multipart message 

// create and fill the first message part 

68 MimeBodyPart mbp1 = new MimeBodyPart(); 

mbp1.setContent(msgText, ”text/plain”); 

70 

// create and fill the second message part 

72 MimeBodyPart mbp2 = new MimeBodyPart(); 

mbp2.setContent(msgText2, ”text/plain”); 

74 

// create the Multipart and its parts to it 

76 Multipart mp = new MimeMultipart(); 

mp.addBodyPart(mbp1); 

78 mp.addBodyPart(mbp2); 

80 // add the Multipart to the message 

msg.setContent(mp); 

82 } 

Transport.send(msg); 

84 } catch (MessagingException mex) { 

mex.printStackTrace (); 

86 } 

} 

88 } 

C.1.12 

/** 

RecvMessage.java 

2 * $Workfile : RecvMessage.java 

* 



6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


* 





18 * 

*/ 

20 

package ncv.gatewayif;


22 

import java.io .Reader; 

24 import java.io .StringReader; 

26 import org.apache.xerces . parsers .DOMParser; 

28 import org.w3c.dom.Document; 

import org.w3c.dom.Node; 

30 import org.w3c.dom.NodeList; 

32 import org.xml.sax.InputSource; 

34 /** This class provides the methods for accessing an incoming ( reveived ) message */ 

public class RecvMessage extends XMLMessage { 

36 

protected Document doc; 

38 protected NodeList nodeList; 

protected Node node; 

40 

/** Constructor used for initializing the XML message object */ 

42 public RecvMessage(String message) { 

super(message); 

44 doc = getDOMDocument(message); 

} 

46 

/** returns a DOM Document for an incoming XML message string 

48 * as it is received from the MAS remote gateway 

*/ 

50 public Document getDOMDocument(String xmlstring){ 

Reader xmlreader = new StringReader(xmlstring); 

52 InputSource xmlsource = new InputSource(xmlreader); 

54 DOMParser parser = new DOMParser(); 

56 try { 

parser . parse(xmlsource); 


System.err . println (”Error in parsing : ” + e.getMessage()); 


} 

62 Document doc = parser.getDocument(); 

return doc; 

64 } 

66 /** returns the Acknowledgement code out of the DOM document */ 

public String getAckCode() { 

68 nodeList = doc.getElementsByTagName(”MSA.1”); 

node = nodeList.item(0). getFirstChild (); 

70 return node.getNodeValue(); 

} 

72 

/** returns the unique Message Control ID out of the DOM document */ 

74 public String getMsgControlID() { 

nodeList = doc.getElementsByTagName(”MSA.2”); 

76 node = nodeList.item(0). getFirstChild (); 

return node.getNodeValue();


78 } 

80 /** returns the Error comment out of the DOM document */ 

public String getErrorComment() { 

82 nodeList = doc.getElementsByTagName(”MSA.3”); 

node = nodeList.item(0). getFirstChild (); 

84 return node.getNodeValue(); 

} 

86 

/** returns the MeasID out of the DOM document to identify the measurement 

88 * in the database 

*/ 

90 public String getMeasID() { 

String MsgControlID = this.getMsgControlID(); 

92 int ColonPos = MsgControlID.indexOf(’:’); 

return MsgControlID.substring(ColonPos+1); 

94 } 

} 

C.1.13 

/** 

RecvMessageServer.java 

2 * $Workfile : RecvMessageServer.java 

* 



6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


* 





18 * 

*/ 

20 

22 

24 

26 





28 import java.io .IOException; 

import java.io .BufferedReader; 

30 import java.io .InputStreamReader; 

import java.io . PrintWriter ; 

32 import java.io .Reader; 

import java.io .StringReader; 

34 

import java.net.BindException; 

36 import java.net.ServerSocket;


38 

40 

42 

import java.net.Socket; 

import java. sql .Connection; 

import org.apache.xerces . parsers .DOMParser; 

import org.w3c.dom.Document; 

44 import org.w3c.dom.Node; 

import org.w3c.dom.NodeList; 

46 

48 

import org.xml.sax.InputSource; 

/** This class provides the methods for receiving incoming LIS AA and AE messages 

50 * send through the MAS remote gateway. It validates the message and sends an 

* acknowledgement message back to LIS during the same socket connection. 

52 */ 

public class RecvMessageServer extends Thread { 

54 public static int CICOUTPORT = 5001; 

public static long TIMEOUT = 10L; 

56 private long sleepTimer; 

private String configFileName; 

58 

60 /** Constructor sets the member values as configured in given configuration file */ 

public RecvMessageServer(String cfgFileName) { 

62 this .configFileName = cfgFileName; 

Config cfg = new Config(cfgFileName); 


66 sleepTimer = cfg.getRMSTimeOut(); 

setDaemon(true); 

68 } 

70 /** returns a DOM document generated out of an incoming XML message string */ 

public Document getDOMDocument(String xmlstring){ 

72 Reader xmlreader = new StringReader(xmlstring); 

InputSource xmlsource = new InputSource(xmlreader); 

74 

76 

DOMParser parser = new DOMParser(); 

try { 

78 parser . parse(xmlsource); 

} catch (Exception e) { 

80 System.err . println (”RMS: Error in parsing ” + e.getMessage()); 


82 } 

Document doc = parser.getDocument(); 

84 return doc; 

} 

86 

88 

90 

92 

/* public static void main(String [] args ) throws IOException { 

System.out. println (”RMS: Pilot Server Gateway Interface ”); 

Thread first = new RecvMessageServer(TIMEOUT);


94 

96 

System.out. println (”press enter to quit . ”); 

first . start (); 

try { 

98 System.in.read (); 

System.out. println (”RMS: RecvMessageServer shutdown.”); 


System.err . println (”RMS: ” + e); 



104 } 

106 return ; 

} 

108 */ 

public void run() { 

110 

ServerSocket serverSocket = null; 

112 Socket clientSocket = null; 

DateFormat defaultDate; 

114 PrintWriter out; 

BufferedReader in ; 

116 String inputLine , outputLine , message=””; 

Document doc; 

118 NodeList nodeList; 

Node nodeMSH2Text; 

120 String endDocumentTag=””; 

String AckCode=””; 

122 String MeasID=””; 

String MessageControlID=””; 

124 String ErrorComment=””; 


128 System.out. println (”RMS: ready to listen on port #” + CICOUTPORT + ”.\n”); 

130 try { 

serverSocket = new ServerSocket(CICOUTPORT); 


System.err . println (”RMS: Can not listen on port #” + CICOUTPORT); 




} 

138 

try { 

140 clientSocket = serverSocket .accept (); 


142 System.err . println (”RMS: Accept failed.”); 



} 

146 

defaultDate = DateFormat.getDateInstance(); 

148 System.out. println (”RMS: ” + defaultDate.format(new Date()));


150 

System.out. println (”RMS: incoming socket connection established.”); 

try { 

152 out = new 

PrintWriter ( clientSocket .getOutputStream(),true); 

154 in = new BufferedReader(new 

InputStreamReader(clientSocket.getInputStream())); 

156 

158 



160 if ( inputLine .indexOf(”ORR O02”, 0) > 0) 



// System.out. println (”RMS: ” + inputLine); 


break; 

166 } else { 

// System.out. println (”RMS: ” + inputLine); 


} 

170 } 

172 // creating DOM Document out of incoming String 

174 RecvMessage msgIN = new RecvMessage(message); 

176 AckCode = msgIN.getAckCode(); 

MeasID = msgIN.getMeasID(); 

178 MessageControlID = msgIN.getMsgControlID(); 

ErrorComment = msgIN.getErrorComment(); 

180 

System.out. println (”RMS: incoming MsgAckCode: ” + AckCode); 

182 System.out. println (”RMS: incoming MsgControlID: ” + MessageControlID); 

// System.out. println (”RMS: incoming MeasID: ” + MeasID); 

184 

186 

System.out. println (”RMS: End of message, generating CA.\n”); 

SendMessage msg = new SendMessage(MessageControlID, ”CA”); 

188 out. println (msg.toString ACK()); 

190 in . close (); 

out. close (); 

192 clientSocket . close (); 

serverSocket . close (); 

194 


196 System.err . println (”RMS: ” + e); 



} 

200 

DBSession db = new DBSession(configFileName); 

202 String timeStamp; 

204 Connection conn = db.openDB();


timeStamp = MiscDate.todaysDate(); 

206 db.updateTimeStampLIS(conn, MeasID, timeStamp); 

if (AckCode.equals(”AA”)) { 

208 db.updateFlagAA(conn, MeasID, true); 

db.updateFlagAE(conn, MeasID, false); 

210 } else if (AckCode.equals(”AE”)) { 

db.updateFlagAE(conn, MeasID, true); 

212 db.updateFlagAA(conn, MeasID, false); 

db.updateComment(conn, MeasID, ErrorComment); 

214 } 

db.closeDB(conn); 

216 

try { 


} catch (InterruptedException e) { 

220 System.err . println (”RMS: ” + e); 



} 

224 } 

} 

226 } 

C.1.14 

/** 

SendMessage.java 

2 * $Workfile : SendMessage.java 

* 



6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


* 





18 * 

*/ 

20 

22 



24 import java.io .*; 

26 import org.w3c.dom.*; 

import org.apache.xerces .dom.DocumentImpl; 

28 import org.apache.xerces .dom.DOMImplementationImpl; 

import org.w3c.dom.Document; 

30 import org.apache.xml. serialize .OutputFormat; 

import org.apache.xml. serialize . Serializer ; 

32 import org.apache.xml. serialize . SerializerFactory ;


34 

36 

38 

import org.apache.xml. serialize .XMLSerializer; 

/** This class provides the methods for accessing an outgoing (to be send) message */ 

public class SendMessage extends XMLMessage { 

/** Constructor calls constructor of SuperClass XMLMessage */ 

40 public SendMessage (int PatientID, String kppID, int MeasID, 

float ObservationValue, float CalCode, String ObservationTime) { 

42 super(PatientID, kppID, MeasID, ObservationValue, CalCode, ObservationTime); 

} 

44 

/** Constructor calls constructor of SuperClass XMLMessage */ 

46 public SendMessage (String MessageControlID, String ACKType) { 

super(MessageControlID, ACKType); 

48 } 

50 /** returns a ORM O01 type XML message string from document */ 

public String toString ORM O01() { 

52 StringWriter stringOut = new StringWriter(); 

try { 

54 DOMImplementation domImpl = new DOMImplementationImpl(); 

DocumentType docType = domImpl.createDocumentType(”ORM O01”, null, 

56 ”hl7 v231.dtd”); 

Document doc = new DocumentImpl(docType); 

58 Element root = doc.createElement(”ORM O01”); 

Element msh = doc.createElement(”MSH”); 

60 

Element item = doc.createElement(”MSH.1”); 

62 item.appendChild(doc.createTextNode(”|”)); 

msh.appendChild(item); 

64 

item = doc.createElement(”MSH.2”); 

66 item.appendChild(doc.createTextNode(”ˆ˜\\&”)); 


68 


70 Element itemChild = doc.createElement(”HD.1”); 

itemChild.appendChild(doc.createTextNode(”CICDMS”)); 

72 item.appendChild(itemChild); 


74 


76 itemChild = doc.createElement(”HD.1”); 

itemChild.appendChild(doc.createTextNode(”OBSREP”)); 



80 


82 itemChild = doc.createElement(”HD.1”); 

itemChild.appendChild(doc.createTextNode(”CICLIS”)); 



86 


88 itemChild = doc.createElement(”HD.1”);


itemChild.appendChild(doc.createTextNode(”OBSREV”)); 



92 


94 item.appendChild(doc.createTextNode(MiscDate.MessageDate())); 


96 


98 itemChild = doc.createElement(”CM MSG TYPE.1”); 

itemChild.appendChild(doc.createTextNode(”ORM”)); 


itemChild = doc.createElement(”CM MSG TYPE.2”); 

102 itemChild.appendChild(doc.createTextNode(”O01”)); 

item.appendChild(itemChild); 

104 msh.appendChild(item); 

106 item = doc.createElement(”MSH.10”); 

item.appendChild(doc.createTextNode(MiscDate.MessageDate()+”:” 

108 +MessageControlID)); 


110 


112 itemChild = doc.createElement(”PT.1”); 

itemChild.appendChild(doc.createTextNode(”P”)); 



116 


118 itemChild = doc.createElement(”VID.1”); 

itemChild.appendChild(doc.createTextNode(”2.3.1”)); 



122 


124 item.appendChild(doc.createTextNode(”AL”)); 


126 




130 

132 

134 

root.appendChild(msh); 

Element pid = doc.createElement(”PID”); 

item = doc.createElement(”PID.3”); 

136 itemChild = doc.createElement(”CX.1”); 

itemChild.appendChild(doc.createTextNode(”12345678”)); 


itemChild = doc.createElement(”CX.4”); 

140 itemChild.appendChild(doc.createTextNode(”1”)); 


142 pid.appendChild(item); 

144 item = doc.createElement(”PID.18”);


itemChild = doc.createElement(”CX.1”); 



148 itemChild = doc.createElement(”CX.4”); 

itemChild.appendChild(doc.createTextNode(”1”)); 


pid.appendChild(item); 

152 

154 

156 

root.appendChild(pid); 

Element orc = doc.createElement(”ORC”); 

item = doc.createElement(”ORC.1”); 

158 item.appendChild(doc.createTextNode(”NW”)); 

orc .appendChild(item); 

160 

162 

164 

root.appendChild(orc); 

Element obr = doc.createElement(”OBR”); 

item = doc.createElement(”OBR.4”); 

166 itemChild = doc.createElement(”CE.1”); 

itemChild.appendChild(doc.createTextNode(”L12345”)); 


itemChild = doc.createElement(”CE.2”); 

170 itemChild.appendChild(doc.createTextNode(”GLU”)); 


172 obr.appendChild(item); 

174 item = doc.createElement(”OBR.11”); 

item.appendChild(doc.createTextNode(”O”)); 


178 item = doc.createElement(”OBR.16”); 

itemChild = doc.createElement(”XCN.1”); 



182 itemChild = doc.createElement(”XCN.2”); 

itemChild.appendChild(doc.createTextNode(”Smith”)); 



186 itemChild.appendChild(doc.createTextNode(”John”)); 


188 itemChild = doc.createElement(”XCN.4”); 

itemChild.appendChild(doc.createTextNode(”J”)); 



192 itemChild.appendChild(doc.createTextNode(”Dr”)); 



196 root.appendChild(obr); 

198 Element obx = doc.createElement(”OBX”); 

200 item = doc.createElement(”OBX.2”);


item.appendChild(doc.createTextNode(”ST”)); 

202 obx.appendChild(item); 

204 item = doc.createElement(”OBX.3”); 


206 itemChild.appendChild(doc.createTextNode(”L12345”)); 



itemChild.appendChild(doc.createTextNode(”GLU”)); 


obx.appendChild(item); 

212 

item = doc.createElement(”OBX.5”); 

214 item.appendChild(doc.createTextNode(””+ObservationValue)); 


216 



itemChild.appendChild(doc.createTextNode(”mg/dl”)); 



222 


224 item.appendChild(doc.createTextNode(”F”)); 


226 


228 item.appendChild(doc.createTextNode(””+ObservationTime)); 


230 



itemChild.appendChild(doc.createTextNode(”LifeScan SureStep”)); 






240 item = doc.createElement(”OBX.16”); 





246 root.appendChild(obx); 

248 Element nte = doc.createElement(”NTE”); 

250 item = doc.createElement(”NTE.3”); 

item.appendChild(doc.createTextNode(”Home˜Measurement˜(”+CalCode+”)”)); 


254 root.appendChild(nte); 

256 doc.appendChild(root);


258 OutputFormat format = new OutputFormat(doc); // Serialize DOM 

format.setOmitDocumentType(false); 

260 format.setDoctype(null,”hl7 v231.dtd”); 

262 XMLSerializer serial = new XMLSerializer(stringOut, format); 

264 serial .asDOMSerializer(); 

serial . serialize (doc.getDocumentElement()); 

266 

} catch (Exception ex) { 

268 ex. printStackTrace (); 

} 

270 return stringOut . toString (); 

} 

272 

/** returns an Acknowledgement XML message string from DOM document */ 

274 public String toString ACK() { 

StringWriter stringOut = new StringWriter(); 

276 try { 

DOMImplementation domImpl = new DOMImplementationImpl(); 

278 DocumentType docType = domImpl.createDocumentType(”ACK”, null, 

”hl7 v231.dtd”); 

280 Document doc = new DocumentImpl(docType); 

Element root = doc.createElement(”ACK”); 

282 Element msh = doc.createElement(”MSH”); 

284 Element item = doc.createElement(”MSH.1”); 

item.appendChild(doc.createTextNode(”|”)); 



item.appendChild(doc.createTextNode(”ˆ˜\\&”)); 



Element itemChild = doc.createElement(”HD.1”); 

294 itemChild.appendChild(doc.createTextNode(”SendingApplication”)); 




itemChild = doc.createElement(”HD.1”); 

300 itemChild.appendChild(doc.createTextNode(SendingFacility )); 





306 itemChild.appendChild(doc.createTextNode(ReceivingApplication )); 





312 itemChild.appendChild(doc.createTextNode( ReceivingFacility ));





item.appendChild(doc.createTextNode(MiscDate.MessageDate())); 




322 itemChild.appendChild(doc.createTextNode(”ACK”)); 




item.appendChild(doc.createTextNode(MiscDate.MessageDate()+ACKType)); 



itemChild = doc.createElement(”PT.1”); 

332 itemChild.appendChild(doc.createTextNode(”P”)); 




itemChild = doc.createElement(”VID.1”); 

338 itemChild.appendChild(doc.createTextNode(”2.3.1”)); 




item.appendChild(doc.createTextNode(”NE”)); 



item.appendChild(doc.createTextNode(”NE”)); 


350 root.appendChild(msh); 

352 Element msa = doc.createElement(”MSA”); 

354 item = doc.createElement(”MSA.1”); 

item.appendChild(doc.createTextNode(ACKType)); 

356 msa.appendChild(item); 

358 item = doc.createElement(”MSA.2”); 

item.appendChild(doc.createTextNode(MessageControlID)); 

360 msa.appendChild(item); 

362 if (ACKType.equals(”CE”) || ACKType.equals(”CR”)) { 

item = doc.createElement(”MSA.3”); 

364 item.appendChild(doc.createTextNode(errorComment)); 

msa.appendChild(item); 

366 } 

368 root.appendChild(msa);


370 doc.appendChild(root); 

372 OutputFormat format = new OutputFormat(doc); // Serialize DOM 

format.setOmitDocumentType(false); 

374 format.setDoctype(null,”hl7 v231.dtd”); 

376 XMLSerializer serial = new XMLSerializer(stringOut, format); 

378 serial .asDOMSerializer(); 

serial . serialize (doc.getDocumentElement()); 

380 

} catch (Exception ex) { 

382 ex. printStackTrace (); 

} 

384 return stringOut . toString (); 

} 

386 

/** returns an ORR O02 message string from DOM document */ 

388 public String toString ORR O02() { 

StringWriter stringOut = new StringWriter(); 

390 try { 

DOMImplementation domImpl = new DOMImplementationImpl(); 

392 DocumentType docType = domImpl.createDocumentType(”ORR O02”, null, 

”hl7 v231.dtd”); 

394 Document doc = new DocumentImpl(docType); 

Element root = doc.createElement(”ORR O02”); 

396 Element msh = doc.createElement(”MSH”); 

398 Element item = doc.createElement(”MSH.1”); 

item.appendChild(doc.createTextNode(”|”)); 



item.appendChild(doc.createTextNode(”ˆ˜\\&”)); 



Element itemChild = doc.createElement(”HD.1”); 

408 itemChild.appendChild(doc.createTextNode(”SendingApplication”)); 





414 itemChild.appendChild(doc.createTextNode(SendingFacility )); 





420 itemChild.appendChild(doc.createTextNode(ReceivingApplication )); 



424 item = doc.createElement(”MSH.6”);



426 itemChild.appendChild(doc.createTextNode( ReceivingFacility )); 




item.appendChild(doc.createTextNode(MiscDate.MessageDate())); 




436 itemChild.appendChild(doc.createTextNode(”ORR”)); 


438 itemChild = doc.createElement(”CM MSG TYPE.2”); 

itemChild.appendChild(doc.createTextNode(”O02”)); 



442 


444 item.appendChild(doc.createTextNode(MiscDate.MessageDate()+”AA”)); 


446 


448 itemChild = doc.createElement(”PT.1”); 

itemChild.appendChild(doc.createTextNode(”P”)); 



452 


454 itemChild = doc.createElement(”VID.1”); 

itemChild.appendChild(doc.createTextNode(”2.3.1”)); 



458 




462 


464 item.appendChild(doc.createTextNode(”NE”)); 


466 

468 

470 

root.appendChild(msh); 

Element msa = doc.createElement(”MSA”); 


472 item.appendChild(doc.createTextNode(ACKType)); 


474 


476 item.appendChild(doc.createTextNode(MessageControlID)); 


478 


480 item.appendChild(doc.createTextNode(errorComment));


482 

484 

486 


root.appendChild(msa); 

doc.appendChild(root); 

OutputFormat format = new OutputFormat(doc); // Serialize 

488 format.setOmitDocumentType(false); 

format.setDoctype(null,”hl7 v231.dtd”); 

490 

492 

XMLSerializer serial = new XMLSerializer(stringOut, format); 

serial .asDOMSerializer(); 

494 serial . serialize (doc.getDocumentElement()); 

DOM 

496 } catch (Exception ex) { 

ex. printStackTrace (); 

498 } 

return stringOut . toString (); 

500 } 

} 

C.1.15 

/** 

Timer.java 

2 * $Workfile : Timer.java 

* 



6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


* 





18 * 

*/ 

20 

22 

24 



public class Timer extends Thread { 

26 protected int m rate = 100; 

private int m length; 

28 private int m elapsed; 

30 public Timer(int length ) { 

m length = length; 

32 m elapsed = 0; 

}


34 

public synchronized void reset() { 

36 m elapsed = 0; 

} 

38 

public void run() { 

40 for (;;) { 

// put the timer to sleep 

42 try { 

Thread.sleep(m rate); 

44 } catch (InterruptedException ioe ) { 

continue; 

46 } 

48 // use ’ synchronized ’ to prevent conflicts 

synchronized (this) { 

50 m elapsed =+ m rate; 

if (m elapsed > m length) { 

52 timeout(); 

} 

54 } 

} 

56 } 

58 public void timeout() { 

System.err . println (”timeout occured. terminating .” ); 

60 } 

} 

C.1.16 

/** 

XMLMessage.java 

2 * $Workfile : XMLMessage.java 

* 



6 * @date $Date: 02/11/00 10:00a $ 

* 




* 


* 





18 * 

*/ 

20 

22 

24 



public class XMLMessage { 

26 protected String FieldSeparator ; // MSH.1


protected String EncodingCharacters; // MSH.2 

28 protected String SendingApplication ; // MSH.3 HD.1 

protected String SendingFacility ; 

// MSH.4 HD.1 

30 protected String ReceivingApplication ; // MSH.5 HD.1 

protected String ReceivingFacility ; // MSH.6 HD.1 

32 protected String DateOfMessage; // MSH.7 

protected String MessageType1; 

// MSH.9 CM MSG TYPE.1 

34 protected String MessageType2; // MSH.9 CM MSG TYPE.2 

protected String MessageControlID; // MSH.10 

36 protected char ProcessingID; // MSH.11 PT.1 

protected String VersionID; 

// MSH.12 VID.1 

38 protected String AcceptAckType; // MSH.15 

protected String ApplAckType; 

// MSH.16 

40 protected String PatientID1; // PID.3 CX.1 

protected int PatientID4; 

// PID.3 CX.4 

42 protected String OrderControl; // ORC.1 

protected String LOINCCode; 

// OBR.4 CE.1 

44 protected String MnemonicCode; // OBR.4 CE.2 

protected String ValueType; 

// OBX.2 

46 protected float ObservationValue; // OBX.5 

protected String ObservationUnits; // OBX.6 CE.1 

48 protected String ObservationResultStatus ; // OBX.11 

protected String ObservationTime; // OBX.14 

50 protected float CalCode; 

protected String Comment; 

// NTE.3 

52 

protected String ACKType; 

// MSA.1 

54 protected String errorComment; // MSA.3 

56 protected String MessageString; 

58 public XMLMessage (int PatientID, String kppID, int MeasID, 

float ObservationValue, float CalCode, String ObservationTime) { 

60 

this . FieldSeparator = ”|”; 

62 this .EncodingCharacters = ”ˆ˜\\&”; 

// this . SendingApplication = Config.getSendingApplication (); 

64 this . SendingFacility = Config. getSendingFacility (); 

this . ReceivingApplication = Config. getReceivingApplication (); 

66 this . ReceivingFacility = Config. getReceivingFacility (); 

this .MessageControlID = ””+MeasID; 

68 this .PatientID1 = ””+PatientID; 

this .ObservationValue = ObservationValue; 

70 this .ObservationTime = ObservationTime; 

this .CalCode = CalCode; 

72 this .Comment = ”Home Measurement (CAL=”+CalCode+”)”; 

} 

74 

public XMLMessage(String MessageControlID, String ACKType) { 

76 this . FieldSeparator = ”|”; 

this .EncodingCharacters = ”ˆ˜\\&”; 

78 this . SendingFacility = Config. getSendingFacility (); 

this . ReceivingApplication = Config. getReceivingApplication (); 

80 this . ReceivingFacility = Config. getReceivingFacility (); 

this .MessageControlID = MessageControlID; 

82 this .ACKType = ACKType;


84 

} 

public XMLMessage(String message) { 

86 this .MessageString = message; 

} 

88 

public String getMessageControlID() { 

90 return MessageControlID; 

} 

92 

public String getDateOfMessage() { 

94 return DateOfMessage; 

} 

96 

public String getPatientID () { 

98 return PatientID1; 

} 

100 

public float getObservationValue() { 

102 return ObservationValue; 

} 

104 

public float getCalCode() { 

106 return CalCode; 

} 

108 

public String getComment() { 

110 return Comment; 

} 

112 

public String getSendingApplication () { 

114 return SendingApplication ; 

} 

116 

public String getSendingFacility () { 

118 return SendingFacility ; 

} 

120 

public String getReceivingApplication () { 

122 return ReceivingApplication ; 

} 

124 

public String getReceivingFacility () { 

126 return ReceivingFacility ; 

} 

128 

public String getErrorComment() { 

130 return errorComment; 

} 

132 public void setErrorComment(String errorComment) { 

this .errorComment = errorComment; 

134 } 

}

C.2. SQL 125 

C.2 SQL 

C.2.1 

/** 

MeasXferStatus.sql 

2 * $Workfile : MeasXferStatus.sql 

* 



6 * @date $Date: 10/23/00 12:00p $ 

* @description 

8 * 

* (C) Copyright Agilent Technologies Company 2000. All rights reserved . 

10 * Reproduction, adaptation or translation withour prior written 



* 

14 */ 

16 set quoted identifier OFF 

GO 

18 

20 

PRINT ’Creating table dbo.MeasXferStatus’ 

CREATE TABLE [dbo].[MeasXferStatus] ( 

22 measID int primary key NOT NULL, 

timeStampSent datetime, 

24 timeStampRcvd datetime, 

timeStampLIS datetime, 

26 flagCA bit , 

flagCE bit , 

28 flagCR bit , 

flagAA bit , 

30 flagAE bit , 

flagNotified bit , 

32 timesSent int , 

comment varchar(80) 

34 ) ON [PRIMARY] 

GO 

C.2.2 

/** 

MeasXferInsertTrigger.sql 

2 * $Workfile : MeasXferInsertTrigger . sql 

* 



6 * @date $Date: 10/23/00 12:00p $ 

* @description 

8 * 

* (C) Copyright Agilent Technologies Company 2000. All rights reserved . 

10 * Reproduction, adaptation or translation withour prior written 



* 

14 */

C.3. CONFIGURATION FILES 126 

16 set quoted identifier OFF 

GO 

18 

20 

PRINT ’Creating Trigger dbo.MeasXferInsertTrigger’ 

CREATE TRIGGER [MeasXferInsertTrigger] ON dbo.Measurement FOR INSERT AS 

22 INSERT dbo.MeasXferStatus (measID) 

SELECT ID FROM Inserted 

24 GO 

C.3 Configuration Files 

C.3.1 

// gatewayif . cfg 

gatewayif.cfg 

2 // configuration file for the KPP Gateway Interface 

4 // Socket specific settings 

6 PilotServer = 130.29.247.111 

RemoteGateway = 130.29.247.27 

8 CICInPort = 5000 

CICOutPort = 5001 

10 

12 

14 

// XML message and HL7 specific settings 

DOCTYPE = hl7 v231.dtd 

SendingApplication = CICDMS 

16 SendingFacility = OBSREP 

ReceivingApplication = CICLIS 

18 ReceivingFacility = OBSREV 

20 // Database specific settings 

22 dbUser = sa 

dbPassword = 

24 dbServer = med−iris 

dbName = demodb 

26 dbDriver = com.inet.tds .TdsDriver 

28 // timeouts 

30 SocketTimeOut = 45000 

ACKTimeOut = 15000 

32 ScanDBTimeOut = 15000 

CPMTimeOut = 180000 

34 RMSTimeOut = 1000 

MASRcvdTimeOut = 45000 

36 LISTimeOut = 240000 

38 // logfile 

LogFile = gatewayif. log 

40 

// send message 

42 EmailFrom = gatewayif@agilent.com

C.3. CONFIGURATION FILES 127 

EmailTo = david@localhost 

44 EmailSubject = Gateway Interface Status Report 

EmailHost = localhost 

C.3.2 

AA 

2 CA 

00 

4 CE 

CE 

6 CR 

AE 

8 CA 

AA 

10 AA 

MAS.cfg 

C.3.3 hl7 v231.dtd 

 

2 

4 

 

6 

 

8 

 

10 

 

12 

 

14 

 

16 

 

18 

 

20 

 

22 

 

24 

26 

 

28 

 

30 

 

32 

 

34 

 

36

internship report

Create successful ePaper yourself

Delete template?

Save as template?