| DESCRIPTION OF ENHANCEMENTS |
This patch addresses the following issues:
$$MSGACT^HLUTIL = outgoing message action, cancel or requeue
position or # of retries^# open failed^ack timeout
status:
0 = message doesn't exist
1 = pending transmission
1.5 = being tranmitted
1.7 = awaiting response, # of retries
2 = awaiting application ack
3 = successfully completed
4 = error
$$CHKLL^HLUTIL = check setup of Logical Link
8 = being generated
9 = awaiting processing
$$MSGACT^HLUTIL(X,HLIENACT) ;outgoing message action
input value: X = message id
HLIENACT = 1-cancel; 2-requeue
return value: 1 = action sucessful
0 = action failed
$$FLD^HLCSUTL = returns a field from a message segment
$$CHKLL^HLUTIL(X) ;check setup of Logical Link
input value: X = institution number or name
return value: 1 = setup OK
0 = LL setup incorrect
$$FLD^HLCSUTL(NODE,FLD) ;This function will return the value for the field
input value: NODE = HLNODE from the HLNEXT call, passed by reference
FLD = number, field position in segment
note: HL("FS") must be defined
return value: value for the field in this segment
Installation Instructions:
==========================
1. Users are allowed to be on the system during the installation.
2. DSM SITES: Review your mapped set. If any of the routines listed in
1. Added new status, AWAITING RESPONSE, to the HL7 MESSAGE STATUS file.
the Routine Summary section are mapped, they should be removed from
the mapped set at this time.
3. Shutdown all Logical Links and incoming and outgoing filers, and
the Link Manager. Use the options:
Filer and Link Management Options ->
SA Stop All Messaging Background Processes
LM TCP/IP Link Manager Start/Stop
2. New parameter, HL("ACKTIME"), will reset the Acknowledgement Timeout,
For DSM sites ONLY, disabled all HL7 UCX Services
for this installation.
4. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This
option will load the KIDS package onto your system.
5. The patch has now been loaded into a Transport global on your
system. You now need to use KIDS to install the Transport global.
On the KIDS menu, under the 'Installation' menu, use the following
for the one message. This parameter can be passed in GENERATE^HLMA or
options:
2 Verify Checksums in Transport Global
3 Print Transport Global
4 Compare Transport Global to Current System
5 Backup a Transport Global
6 Install Package(s)
INSTALL NAME: HL*1.6*64
=========
DIRECT^HLMA APIs.
Answer 'NO' to 'Want KIDS to INHIBIT LOGONS during the install?'.
Answer 'NO' to 'Want to DISABLE Scheduled Options, Menu Options,
and Protocols?'.
6. Startup all Logical Links and incoming and outgoing filers. Use the
Filer and Link Management Options ->
RA Restart/Start All Links and Filers
(Note that links that do not have "autostart" enabled will need to
3. Retransmission alerts are no longer generated.
be restarted manually)
For DSM sites ONLY, if you previously disabled an HL7 UCX Service
for this installation, you may now enable it.
7. DSM Sites: Rebuild your mapped set if necessary.
8. Start Link Manager using the option: "TCP/IP
Link Manager Start/Stop."
4. DEVNOTOPN errors will no longer be recorded.
Routine Information:
====================
The following routines are included in this patch. The second line of each
of these routines now looks like:
;;1.6;HEALTH LEVEL SEVEN;<patchlist>;JUL 17,1995
Checksum
Routine Old New 2nd Line
======== ======== ======== =====================
5. New APIs:
HLCSAC 2497076 2564816 **43,64**
HLCSTCP 5155167 5175308 **19,43,49,57,58,64**
HLCSTCP1 4965932 5081718 **19,43,57,64**
HLCSTCP2 11299763 11197019 **19,43,49,57,63,64**
HLCSUTL 6479348 6969973 **2,19,58,64**
HLMA2 7530649 7925412 **19,43,57,58,64**
HLTF0 3173064 3232637 **12,19,64**
HLUTIL 2643574 3175738 **36,19,57,64**
List of preceding patches: 57, 58, 63
$$MSGSTAT^HLUTIL = returns status of a message
Sites should use CHECK^XTSUMBLD to verify checksums.
Documentation:
==============
$$MSGSTAT^HLUTIL(X) ;message status
input value: X = message id
return value: status^status updated^error msg.^error type pointer^queue
|
