NEC Mcs Host Interface Link Hl7 Installation And Configuration Guide

							MCS HOST INTERFACE LINK HL7
INSTALLATION/CONFIGURATION GUIDE
NEC America, Inc.
NDA-30088-001
Revision 1.0
March, 1998
Stock # 200785 
						

							LIABILITY DISCLAIMER
NEC America reserves the right to change 
the specifications,  functions, or features in 
this document at any time without notice.  
NEC America has prepared this document 
for use by its employees and customers.  The 
information contained herein is the property 
of NEC  America and shall not be repro-
duced without prior written approval from 
NEC America.
Copyright 1997
NEC America, Inc. 
						

							NDA-30088  Revision 1.0Page i
MCS Host Interface Link CONTENTS
TABLE OF CONTENTS
Page
Chapter 1 - HL7 INTERFACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
Shared Libraries (LLP and Link Type) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
HL7 Configurations (User Definable) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
Interface Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
Shared Library Configuration (LLP and Link Type) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
Link Specific Parameters Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  6
Miscellaneous Configurations (Timers, Counters, Etc.) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
HL7 Configurations (User Definable) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10 
						

							Page iiNDA-30088  Revision 1.0
CONTENTS MCS Host Interface Link
This Page Left Blank. 
						

							NDA-30088  Revision 1.0Page iii
MCS Host Interface LinkFIGURES
LIST OF FIGURES
Figure TitlePage
1-1 Main Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
1-2 Configuration Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
1-3 Shared Library Selection Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
1-4 Low Level Protocol Selection Menu  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
1-5 Link Type Selection Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
1-6 Shared Library Load Menu  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  6
1-7 TCP/IP Link Specific Parameters  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
1-8 Asynchronous Serial Link Specific Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
1-9 Miscellaneous Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
1-10 HL7 User-Definable Configuration  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
1-11 HL7 Receiving Application Configuration  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
1-12 HL7 Sending Application Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
1-13 HL7 Sending Application Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13 
						

							Page ivNDA-30088  Revision 1.0
FIGURESMCS Host Interface Link
This Page Left Blank. 
						

							NDA-30088   Revision 1.0Page 1
MCS Host Interface Link HL7 INTERFACE
Chapter 1 HL7 INTERFACE
Background
The HL7 interface provided for the MCS supports several communication low 
level protocols and two physical interface types. 
The MCS HL7 interface software has many configurable items that can be tailored 
for a particular site’s communication link. Background information of these 
configurable items is described below. For more detailed information on the 
available options for these fields, refer to the section, Shared Library Configuration 
(LLP and Link Type) and,  Link Specific Parameters Configuration.
Shared Libraries 
(LLP and Link 
Ty p e )The Link Type defines the hardware link to the MCS HL7 interface. Currently, the 
MCS HL7 interface supports 1) a TCP/IP Ethernet connection, and 2) an 
asynchronous, serial line (RS-232) connection. In addition, different selections are 
available for the Low Level Protocol (LLP). The LLP defines a data encapsulation 
method to provide flow control and error recovery issues of data transmissions.
The installer selects from a menu of shared libraries to define the LLP and Link 
Type applicable to the site’s communication link. Shared libraries provide a means 
to dynamically load the needed processing code into the MCS HL7 interface 
application without the need to have separate interface applications for each site 
specific communication link.
HL7 
Configurations 
(User Definable)The HL7 Standard Version document defines some fields as user-definable. For 
those fields that are applicable to the MCS, a configuration screen is provided to 
define the values expected in the HL7 message for correct processing of these 
fields by the MCS HL7 interface application.
Installation
The MCS HL7 interface software is installed using the OAI APM Installation of 
Applications/Packages command. The installer will need to know the ‘root’ 
password for the system. After the files have been installed, the installation routine 
will prompt the installer to configure the MCS HL7 interface software. The 
configuration process is discussed in the following sections.
Interface Configuration
Configuration of the MCS HL7 interface must be completed before the MCS HL7 
interface application can be started. At each administrative login (as the user 
mcshost), if the MCS HL7 interface software has not yet been configured, the user 
is prompted to configure the interface. 
						

							Page 2NDA-30088   Revision 1.0
HL7 INTERFACE MCS Host Interface Link
Interface Configuration (Cont)
If the MCS HL7 interface software was not configured during the installation of 
the application, follow steps 1. - 2. to get to the Configuration option display.  
Otherwise, if configuration is being performed as part of installation, skip to step 3.
1. From the login:
 prompt enter the user account name
mcshost
. Enter a password if required.
2.  If the system has not been previously configured for the
MCS HL7 interface, you will be prompted to do so; other-
wise the main menu screen (Figure 1-1
) will be displayed.
To configure the MCS HL7 interface, select the Configura-
tion
 option from the main menu.  
Figure 1-1   Main Menu
3. The Configuration
 command will display the screen shown
in Figure 1-2
.  This menu displays all configurable items of
the MCS HL7 interface application.  Select the desired con-
figuration option.    
NEC America Inc      MCS Host Link Administration Menu     Tue - Jan 27, 1998
 Version: HL71.03.03                               Interface Status: Idle
                        Options
                        View Log File
                        Erase Log File
                        Initialize Interface
                        Terminate Interface
                        Configuration
                        Statistics
                        UNIX
                        Logout
                        Enter Option:  [ ] 
						

							NDA-30088   Revision 1.0Page 3
MCS Host Interface Link HL7 INTERFACE
Figure 1-2   Configuration Menu
Shared Library 
Configuration (LLP 
and Link Type)The shared library configuration options allow the user to select the LLP
and / or the Link Type configuration items, and to load these libraries to
shared library directory path.
1. Select ‘1’ or ‘S’ to access the MCS Host Link/LLP Shared
Library Installation display (Figure 1-3). 
Figure 1-3   Shared Library Selection Menu
2. Select ‘1’ or ‘P’ to choose the applicable LLP used by the
site. The LLP Shared Library Selection menu screen is dis-
played (Figure 1-4). 
NEC America Inc      MCS Host Link Administration Menu     Tue - Jan 27, 1998
                        MCS Host Interface Configuration
        Options
        1) S
hared Library Configuration (LLP and Link Type)
        2) Link Specific Parameters Configuration
        3) Misc Configurations (Timers, Counters, Etc.)
        4) HL7 Configurations (User Definable)
        9) Return
        Enter Option:  [ ]
NEC America Inc      MCS Host Link Administration Menu     Tue - Jan 27, 1998
               MCS Host Link/LLP Shared Library Installation
     Currently Loaded LLP / Link Type     Current Selected LLP / Link Type
     --------------------------------     --------------------------------
         Low Level Protocol: none
             Low Level Protocol: none
                  Link Type: none                      Link Type: none
        Options
        1) Select Low Level P
rotocol Shared Library
        2) Select Link Type Shared Library
        3) Load Selected Shared Libraries
        9) Return
        Enter Option:  [ ] 
						

							Page 4NDA-30088   Revision 1.0
HL7 INTERFACE MCS Host Interface Link
Figure 1-4   Low Level Protocol Selection Menu
Note:
The available LLP’s are listed. The format of the LLP signifies the data encapsu-
lation of the HL7 message. LLP1 and LLP2 are implementations of the Hybrid 
Lower Layer Protocol and the Minimal Layer Protocol, respectively, described 
in the HL7 Version 2.2. Implementation Guide. LLP3, LLP4 and LLP7 are rec-
ommended for use with the TCP/IP Link Type, while LLP6 is recommended for 
use with the Asynchronous Serial Link Type. For LLP3, ‘{length}’ defines a 4 
character length field, equal to the length of the ‘{data}’ portion of the message. 
For LLP4, ‘’ is equal to the ASCII  character (1C hex). For LLP6, the 
 represents a longitudinal redundancy check byte.
3.  The currently loaded LLP value indicates the LLP presently
used by the MCS HL7 interface application. A ‘none’ indi-
cates the LLP has not yet been configured. Select the appro-
priate LLP number, followed by . The MCS Host
Link/LLP Shared Library Installation menu screen is dis-
played (Figure 1-3).
4. Select ‘2’ or ‘L’ to choose the applicable Link Type used by
the site. The Link Type Shared Library Selection menu
screen is displayed (Figure 1-5). 
NEC America Inc      MCS Host Link Administration Menu     Tue - Jan 27, 1998
Low Level Protocol (LLP) Shared Library Selection
  Currently Loaded LLP: none
  Available LLP Selections -
     LLP    Format
  1) LLP1 - tvv{data}ccccxxx
  2) LLP2 - {data}
  3) LLP3 - {length}{data}
  4) LLP4 - {data}
  6) LLP6 - {data}
  7) LLP7 - {data}
  9) R
eturn
Enter Selection: [ ]