Print Page as PDF
HLO CONVERSION APIS (2) ICR (4728)

HLO CONVERSION APIS (2)    ICR (4728)

Name Value
NUMBER 4728
IA # 4728
DATE CREATED 2005/08/19
CUSTODIAL PACKAGE HEALTH LEVEL SEVEN
USAGE Supported
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE HLOCVU
NAME HLO CONVERSION APIS (2)
GENERAL DESCRIPTION
These utilities provide help to applications that were
developed before HLO convert to HLO. See also IA# 4727 and IA#4731.
STATUS Active
DURATION Till Otherwise Agreed
ID HLOCVU
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
APAR(HLOEID,.APPARMS,.WHO,.WHOTO)
Designed to retrieve pre-HLO HL 1.6 parameters from
the existing HL 1.6 protocol and translate to HLO format.
VARIABLES TYPE VARIABLES DESCRIPTION
HLOEID Input
Event Protocol IEN.
APPARMS Output
Array containing HLO message parameters.


Specific translation from HL 1.6 parameters to HLO is as follows:

HL 1.6 APPLICATION PROTOCOL            =>      HLO APPARMS ARRAY PARAMETERS
COUNTRY CODE                           =>      APPARMS("COUNTRY") APPLICATION
ACK TYPE                   =>      APPARMS("APP ACK TYPE") EVENT TYPE
=>      APPARMS("EVENT") SENDING APPLICATION
=>      APPARMS("SENDING APPLICATION") TRANSACTION MESSAGE TYPE
=>      APPARMS("MESSAGE TYPE") VERSION ID                             =>
APPARMS("VERSION") HL7 FIELD SEPARATOR                    =>
APPARMS("FIELD SEPARATOR")      HL7 ENCODING CHARACTERS
=>      APPARMS("ENCODING CHARACTERS")

HL 1.6 Passed Parameters               =>      HLO APPARMS ARRAY PARAMETERS
HLP("SECURITY")                                =>      APPARMS("SECURITY")
HLP("CONTPTR")                         =>      APPARMS("CONTINUATION POINTER")
HLP("QUEUE")*                          =>      APPARMS("QUEUE")

*NOTE: HLP("QUEUE") is not actually a current HL 1.6 parameter but can be
added to the HLP array to allow a converted application to define HLO private
queues.

For Sending Messages To One Application
_
RECEIVING APPLICATION                  =>      WHO("RECEIVING APPLICATION")
LOGICAL LINK                           =>      WHO("FACILITY LINK NAME")

For Sending Messages To Multiple Applications (where "n" is a numeric index
(0,1,2, ))              _ RECEIVING APPLICATION                  =>
WHOTO(n,"RECEIVING APPLICATION")  LOGICAL LINK                           =>
WHOTO(n,"FACILITY LINK NAME")

WHO Output
For single HLO message recipients, receiving
application parameters.
WHOTO Output
For multiple HLO message recipients, receiving
application parameters.