HLCS2 ;SF/JC - More Communication Server utilities ;7/10/2008 16:57
;;1.6;HEALTH LEVEL SEVEN;**14,40,43,49,57,58,82,84,109,1006**;Oct 13, 1995
;
; Modified - IHS/OIRM/DSD/AEF - 01/02/03 - Line PARAM+12
; IHS/CNI/VEN/TOAD - 10 July 2008 - explanation of mod by Rick Marshall,
; VISTA Expertise Network: During the post-install of HL7*1.6*92, the
; Mail Group field in the HL Communication Server Parameters file is a
; dangling pointer, which can cause an <UNDEF>PARAM+12^HLCS2 error.
; This modification uses the $GET function in the reference to
; ^XMB(3.8,HLMAILP,0) to prevent this error. Although we are long past
; the install of HL*1.6*92, we should keep the $GET protection because
; it's always good practice when accessing global nodes that aren't
; guaranteed to exist. Anne Fugatt of IHS developed this mod.
;
FWD ; Add supplemental clients from HLL("LINKS") to HLSUP array
;This enhancement also supports distribution of a message to
;the same client over multiple logical links.
Q:'$D(HLL("LINKS"))
N CNT,LNK,CLIAP
S CNT=0,ROUTINE=1 F S CNT=$O(HLL("LINKS",CNT)) Q:CNT<1 D
. S PTR=$P(HLL("LINKS",CNT),"^"),LNK=$P(HLL("LINKS",CNT),"^",2)
. Q:PTR="" I +PTR<1 S PTR=$O(^ORD(101,"B",PTR,0)) Q:PTR<1
. Q:LNK="" I +LNK<1 S LNK=$O(^HLCS(870,"B",LNK,0)) Q:LNK<1
. Q:'$D(^HLCS(870,LNK))
. S CLIAP=$$PTR^HLUTIL2(PTR)
. S HLSUP("S",PTR,+LNK)=CLIAP_$S(CLIAP<1:U_HLL("LINKS",CNT),1:"")
Q
ADD ;Deliver message to supplemental client list.
;Invoked by HLTP before and after processing normal clients
;Only processes remote links. Local clients must be subscribing
;protocols.
Q:'$D(HLSUP("S"))
N HLTCP,HLTCPI,HLTCPO,ZHLEIDS,ZLCLIENT,ZLOGLINK,ZMTIENS
S ZHLEIDS=0 F S ZHLEIDS=$O(HLSUP("S",ZHLEIDS)) Q:ZHLEIDS<1 D
.S ZLOGLINK=0 F S ZLOGLINK=$O(HLSUP("S",ZHLEIDS,ZLOGLINK)) Q:ZLOGLINK<1 D
..S ZLCLIENT=+HLSUP("S",ZHLEIDS,ZLOGLINK)
..I ZLCLIENT<1 S:$G(HLERROR)="" HLERROR="15^Invalid Subscriber Protocol in HLL('LINKS'): "_$P(HLSUP("S",ZHLEIDS,ZLOGLINK),U,2,9) Q
..S HLOGLINK=ZLOGLINK D SEND^HLMA2(ZHLEIDS,HLMTIEN,ZLCLIENT,"D",.ZMTIENS,ZLOGLINK),STATUS^HLTF0(+ZMTIENS,1)
K HLL("LINKS"),HLSUP
Q
STALL ;STOP ALL LINKS AND FILERS
N DIR,Y
W ! S DIR(0)="Y",DIR("A")="Okay to shut down all Links and Filers"
D ^DIR
I 'Y!($D(DIRUT))!($D(DUOUT)) W !!,"Shutdown Aborted!" Q
W !,"Shutting down all Links and Filers..."
D CLEAR
D LLP(1)
Q
QUE ;Restart Filers and AUTOSTART Logical Links after system re-boot
N DIR,Y
I '$D(ZTQUEUED) D Q:'Y!($D(DIRUT))!($D(DUOUT))
.W ! S DIR(0)="Y",DIR("A")="Shutdown and restart ALL AUTOSTART links and filers. Okay"
.D ^DIR
.I 'Y!($D(DIRUT))!($D(DUOUT)) W !!,"RESTART Aborted!" Q
.W !,"Restarting all Autostart-Enabled Links and Filers..."
D CLEAR
D STARTF
D LLP(0)
D STRT
Q
CLEAR ;Reset state of 869.3
S DA(1)=1,DA=0,DIK="^HLCS(869.3,1,2,"
F S DA=$O(^HLCS(869.3,DA(1),2,DA)) Q:DA<1 D ^DIK
S DA=0,DIK="^HLCS(869.3,1,3,"
F S DA=$O(^HLCS(869.3,DA(1),3,DA)) Q:DA<1 D ^DIK
Q
STARTF ;Start filers
;Get Defaults
N TMP,PTR,DEFCNT,DA,HLCNT,HLNODE1
S PTR=+$O(^HLCS(869.3,0)) Q:'PTR
;default # of incoming filers
S HLNODE1=$G(^HLCS(869.3,PTR,1)),DEFCNT=+$P(HLNODE1,U) S:'DEFCNT DEFCNT=1
F HLCNT=1:1:DEFCNT S TMP=$$TASKFLR^HLCS1("IN")
;default # of outgoing filers
S DEFCNT=+$P(HLNODE1,U,2) S:'DEFCNT DEFCNT=1
F HLCNT=1:1:DEFCNT S TMP=$$TASKFLR^HLCS1("OUT")
Q
LLP(ALL) ;Stop Logical Links
;ALL=1 OR 0 IF zero, only AUTOSTART LINKS get stopped
N HLDP,HLDP0,HLPARM0,HLPARM4,HLJ,X,Y S HLDP=0
F S HLDP=$O(^HLCS(870,HLDP)) Q:'HLDP S HLDP0=$G(^(HLDP,0)),X=+$P(HLDP0,U,3) D:X
.;skip this link if not stopping all and Autostart not enabled
. I 'ALL&('$P(HLDP0,U,6)) Q
. S HLPARM4=$G(^HLCS(870,HLDP,400))
. ;TCP Multi listener for non-Cache uses UCX
. I $P(HLPARM4,U,3)="M" Q:^%ZOSF("OS")'["OpenM" Q:$$OS^%ZOSV["VMS"
. ;4=status,10=Time Stopped,9=Time Started,11=Task Number,3=Device Type,14=shutdown?
. S X="HLJ(870,"""_HLDP_","")",@X@(4)="Halting",@X@(10)=$$NOW^XLFDT,(@X@(11),@X@(9))="@",@X@(14)=1
. I $P(HLPARM4,U,3)="C"&("N"[$P(HLPARM4,U,4)),'$P(HLDP0,U,12) S @X@(4)="Shutdown"
. D FILE^HLDIE("","HLJ","","LLP","HLCS2") ;HL*1.6*109
. ;Cache system, need to open TCP port to release job
. I ^%ZOSF("OS")["OpenM",($P(HLPARM4,U,3)="M"!($P(HLPARM4,U,3)="S")) D
.. ;pass task number to stop listener
.. S:$P(HLDP0,U,12) X=$$ASKSTOP^%ZTLOAD(+$P(HLDP0,U,12))
.. D CALL^%ZISTCP($P(HLPARM4,U),$P(HLPARM4,U,2),10)
.. I POP D HOME^%ZIS Q
.. D CLOSE^%ZISTCP
Q
STRT ;Start Links
N HLDP,HLDP0,HLDAPP,HLTYPTR,HLBGR,HLENV,HLPARAM0,HLPARM4,HLQUIT,ZTRTN,ZTDESC,ZTSK,ZTCPU
S HLDP=0
F S HLDP=$O(^HLCS(870,HLDP)) Q:HLDP<1 S HLDP0=$G(^(HLDP,0)) D
. S HLPARM4=$G(^HLCS(870,HLDP,400))
. ;quit if no parameters or AUTOSTART is disabled
. Q:'$P(HLDP0,U,6)
. ;HLDAPP=LL name, HLTYPTR=LL type, HLBGR=routine, HLENV=environment check
. S HLDAPP=$P(HLDP0,U),HLTYPTR=+$P(HLDP0,U,3),HLBGR=$G(^HLCS(869.1,HLTYPTR,100)),HLENV=$G(^(200))
. ;quit if no LL type or no routine
. Q:'HLTYPTR!(HLBGR="")
. I HLENV'="" K HLQUIT X HLENV Q:$D(HLQUIT)
. ;TCP Multi listener for non-Cache uses UCX
. I $P(HLPARM4,U,3)="M" Q:^%ZOSF("OS")'["OpenM" Q:$$OS^%ZOSV["VMS"
. I $P(HLPARM4,U,3)="C"&("N"[$P(HLPARM4,U,4)) D Q
.. ;4=status 9=Time Started, 10=Time Stopped, 11=Task Number
.. ;14=Shutdown LLP, 3=Device Type, 18=Gross Errors
.. N HLJ,X
.. I $P(HLDP0,U,15)=0 Q
.. L +^HLCS(870,HLDP,0):2
.. E Q
.. S X="HLJ(870,"""_HLDP_","")"
.. S @X@(4)="Enabled",@X@(9)=$$NOW^XLFDT,@X@(14)=0
.. D FILE^HLDIE("","HLJ","","STRT","HLCS2") ; HL*1.6*109
.. L -^HLCS(870,HLDP,0)
.. Q
. S ZTRTN=$P(HLBGR," ",2),ZTIO="",ZTDTH=$H,HLTRACE=""
. S ZTDESC=HLDAPP_" Low Level Protocol",ZTSAVE("HLDP")=""
. ;get startup node
. I $P(HLPARM4,U,6),$D(^%ZIS(14.7,+$P(HLPARM4,U,6),0)) S ZTCPU=$P(^(0),U)
. D ^%ZTLOAD
Q
SITEP ;Edit Site Parameters
S DDSFILE=869.3,DA=1,DR="[HL SITE PARAMETERS]" D ^DDS
Q
PARAM() ;Return HL7 site parameters
;HLPARAM=domain ien^domain name^production or test^institution ien^
;institution name^institution number^mail group ien^mail group name^
;purge completed messages^purge awaiting ack messages^purge all msgs^
;default retention
N HLX,HLX4,HLX5,HLDOMP,HLDOMN,HLPROD,HLINSP,HLINSN,HLINSNM,HLMAILP,HLMAILN,HLPARAM,HLPRGAA,HLPRGALL,HLPRGCMP,HLDEFRET
S HLX=$G(^HLCS(869.3,1,0))
S HLX4=$G(^HLCS(869.3,1,4))
S HLX5=$G(^HLCS(869.3,1,5))
S HLDOMP=$P(HLX,U,2) I HLDOMP S HLDOMN=$P(^DIC(4.2,HLDOMP,0),U)
S HLPROD=$P(HLX,U,3)
S HLINSP=$P(HLX,U,4) I HLINSP S HLINSN=$P(^DIC(4,HLINSP,0),U),HLINSNM=$P($G(^DIC(4,HLINSP,99)),U)
;
; ** IHS mod ** IHS/OIRM/DSD/AEF - 01/02/03 - Prevent UNDEF error
;S HLMAILP=$P(HLX,U,5) I HLMAILP S HLMAILN=$P(^XMB(3.8,HLMAILP,0),U)
S HLMAILP=$P(HLX,U,5) I HLMAILP S HLMAILN=$P($G(^XMB(3.8,HLMAILP,0)),U)
;
S HLPRGCMP=$P(HLX4,U),HLPRGAA=$P(HLX4,U,2),HLPRGALL=$P(HLX4,U,3)
S HLDEFRET=$P(HLX5,U)
S HLPARAM=HLDOMP_U_$G(HLDOMN)_U_$G(HLPROD)_U_HLINSP_U_$G(HLINSN)_U_$G(HLINSNM)_U_HLMAILP_U_$G(HLMAILN)_U_HLPRGCMP_U_HLPRGAA_U_HLPRGALL_U_HLDEFRET
Q HLPARAM
;
GETAPP(HLAPP) ;Function to Retrieve parameters pertaining to a specific sending or receiving application
;HLAPP=APPLICATION NAME OR IEN OF FILE 771
;Returns MAIL GROUP NAME^'a' or 'i' (active or inactive)
S HLAPP=$G(HLAPP)
I HLAPP]"",'HLAPP S HLAPP=$O(^HL(771,"B",$E(HLAPP,1,30),0))
I 'HLAPP Q ""
I HLAPP S HLM=$P(^HL(771,HLAPP,0),U,4)
I HLM S HLM=$P($G(^XMB(3.8,HLM,0)),U)
Q $G(HLM)_U_$P(^HL(771,HLAPP,0),U,2)
HLCS2 ;SF/JC - More Communication Server utilities ;7/10/2008 16:57
+1 ;;1.6;HEALTH LEVEL SEVEN;**14,40,43,49,57,58,82,84,109,1006**;Oct 13, 1995
+2 ;
+3 ; Modified - IHS/OIRM/DSD/AEF - 01/02/03 - Line PARAM+12
+4 ; IHS/CNI/VEN/TOAD - 10 July 2008 - explanation of mod by Rick Marshall,
+5 ; VISTA Expertise Network: During the post-install of HL7*1.6*92, the
+6 ; Mail Group field in the HL Communication Server Parameters file is a
+7 ; dangling pointer, which can cause an <UNDEF>PARAM+12^HLCS2 error.
+8 ; This modification uses the $GET function in the reference to
+9 ; ^XMB(3.8,HLMAILP,0) to prevent this error. Although we are long past
+10 ; the install of HL*1.6*92, we should keep the $GET protection because
+11 ; it's always good practice when accessing global nodes that aren't
+12 ; guaranteed to exist. Anne Fugatt of IHS developed this mod.
+13 ;
FWD ; Add supplemental clients from HLL("LINKS") to HLSUP array
+1 ;This enhancement also supports distribution of a message to
+2 ;the same client over multiple logical links.
+3 IF '$DATA(HLL("LINKS"))
QUIT
+4 NEW CNT,LNK,CLIAP
+5 SET CNT=0
SET ROUTINE=1
FOR
SET CNT=$ORDER(HLL("LINKS",CNT))
IF CNT<1
QUIT
Begin DoDot:1
+6 SET PTR=$PIECE(HLL("LINKS",CNT),"^")
SET LNK=$PIECE(HLL("LINKS",CNT),"^",2)
+7 IF PTR=""
QUIT
IF +PTR<1
SET PTR=$ORDER(^ORD(101,"B",PTR,0))
IF PTR<1
QUIT
+8 IF LNK=""
QUIT
IF +LNK<1
SET LNK=$ORDER(^HLCS(870,"B",LNK,0))
IF LNK<1
QUIT
+9 IF '$DATA(^HLCS(870,LNK))
QUIT
+10 SET CLIAP=$$PTR^HLUTIL2(PTR)
+11 SET HLSUP("S",PTR,+LNK)=CLIAP_$SELECT(CLIAP<1:U_HLL("LINKS",CNT),1:"")
End DoDot:1
+12 QUIT
ADD ;Deliver message to supplemental client list.
+1 ;Invoked by HLTP before and after processing normal clients
+2 ;Only processes remote links. Local clients must be subscribing
+3 ;protocols.
+4 IF '$DATA(HLSUP("S"))
QUIT
+5 NEW HLTCP,HLTCPI,HLTCPO,ZHLEIDS,ZLCLIENT,ZLOGLINK,ZMTIENS
+6 SET ZHLEIDS=0
FOR
SET ZHLEIDS=$ORDER(HLSUP("S",ZHLEIDS))
IF ZHLEIDS<1
QUIT
Begin DoDot:1
+7 SET ZLOGLINK=0
FOR
SET ZLOGLINK=$ORDER(HLSUP("S",ZHLEIDS,ZLOGLINK))
IF ZLOGLINK<1
QUIT
Begin DoDot:2
+8 SET ZLCLIENT=+HLSUP("S",ZHLEIDS,ZLOGLINK)
+9 IF ZLCLIENT<1
IF $GET(HLERROR)=""
SET HLERROR="15^Invalid Subscriber Protocol in HLL('LINKS'): "_$PIECE(HLSUP("S",ZHLEIDS,ZLOGLINK),U,2,9)
QUIT
+10 SET HLOGLINK=ZLOGLINK
DO SEND^HLMA2(ZHLEIDS,HLMTIEN,ZLCLIENT,"D",.ZMTIENS,ZLOGLINK)
DO STATUS^HLTF0(+ZMTIENS,1)
End DoDot:2
End DoDot:1
+11 KILL HLL("LINKS"),HLSUP
+12 QUIT
STALL ;STOP ALL LINKS AND FILERS
+1 NEW DIR,Y
+2 WRITE !
SET DIR(0)="Y"
SET DIR("A")="Okay to shut down all Links and Filers"
+3 DO ^DIR
+4 IF 'Y!($DATA(DIRUT))!($DATA(DUOUT))
WRITE !!,"Shutdown Aborted!"
QUIT
+5 WRITE !,"Shutting down all Links and Filers..."
+6 DO CLEAR
+7 DO LLP(1)
+8 QUIT
QUE ;Restart Filers and AUTOSTART Logical Links after system re-boot
+1 NEW DIR,Y
+2 IF '$DATA(ZTQUEUED)
Begin DoDot:1
+3 WRITE !
SET DIR(0)="Y"
SET DIR("A")="Shutdown and restart ALL AUTOSTART links and filers. Okay"
+4 DO ^DIR
+5 IF 'Y!($DATA(DIRUT))!($DATA(DUOUT))
WRITE !!,"RESTART Aborted!"
QUIT
+6 WRITE !,"Restarting all Autostart-Enabled Links and Filers..."
End DoDot:1
IF 'Y!($DATA(DIRUT))!($DATA(DUOUT))
QUIT
+7 DO CLEAR
+8 DO STARTF
+9 DO LLP(0)
+10 DO STRT
+11 QUIT
CLEAR ;Reset state of 869.3
+1 SET DA(1)=1
SET DA=0
SET DIK="^HLCS(869.3,1,2,"
+2 FOR
SET DA=$ORDER(^HLCS(869.3,DA(1),2,DA))
IF DA<1
QUIT
DO ^DIK
+3 SET DA=0
SET DIK="^HLCS(869.3,1,3,"
+4 FOR
SET DA=$ORDER(^HLCS(869.3,DA(1),3,DA))
IF DA<1
QUIT
DO ^DIK
+5 QUIT
STARTF ;Start filers
+1 ;Get Defaults
+2 NEW TMP,PTR,DEFCNT,DA,HLCNT,HLNODE1
+3 SET PTR=+$ORDER(^HLCS(869.3,0))
IF 'PTR
QUIT
+4 ;default # of incoming filers
+5 SET HLNODE1=$GET(^HLCS(869.3,PTR,1))
SET DEFCNT=+$PIECE(HLNODE1,U)
IF 'DEFCNT
SET DEFCNT=1
+6 FOR HLCNT=1:1:DEFCNT
SET TMP=$$TASKFLR^HLCS1("IN")
+7 ;default # of outgoing filers
+8 SET DEFCNT=+$PIECE(HLNODE1,U,2)
IF 'DEFCNT
SET DEFCNT=1
+9 FOR HLCNT=1:1:DEFCNT
SET TMP=$$TASKFLR^HLCS1("OUT")
+10 QUIT
LLP(ALL) ;Stop Logical Links
+1 ;ALL=1 OR 0 IF zero, only AUTOSTART LINKS get stopped
+2 NEW HLDP,HLDP0,HLPARM0,HLPARM4,HLJ,X,Y
SET HLDP=0
+3 FOR
SET HLDP=$ORDER(^HLCS(870,HLDP))
IF 'HLDP
QUIT
SET HLDP0=$GET(^(HLDP,0))
SET X=+$PIECE(HLDP0,U,3)
IF X
Begin DoDot:1
+4 ;skip this link if not stopping all and Autostart not enabled
+5 IF 'ALL&('$PIECE(HLDP0,U,6))
QUIT
+6 SET HLPARM4=$GET(^HLCS(870,HLDP,400))
+7 ;TCP Multi listener for non-Cache uses UCX
+8 IF $PIECE(HLPARM4,U,3)="M"
IF ^%ZOSF("OS")'["OpenM"
QUIT
IF $$OS^%ZOSV["VMS"
QUIT
+9 ;4=status,10=Time Stopped,9=Time Started,11=Task Number,3=Device Type,14=shutdown?
+10 SET X="HLJ(870,"""_HLDP_","")"
SET @X@(4)="Halting"
SET @X@(10)=$$NOW^XLFDT
SET (@X@(11),@X@(9))="@"
SET @X@(14)=1
+11 IF $PIECE(HLPARM4,U,3)="C"&("N"[$PIECE(HLPARM4,U,4))
IF '$PIECE(HLDP0,U,12)
SET @X@(4)="Shutdown"
+12 ;HL*1.6*109
DO FILE^HLDIE("","HLJ","","LLP","HLCS2")
+13 ;Cache system, need to open TCP port to release job
+14 IF ^%ZOSF("OS")["OpenM"
IF ($PIECE(HLPARM4,U,3)="M"!($PIECE(HLPARM4,U,3)="S"))
Begin DoDot:2
+15 ;pass task number to stop listener
+16 IF $PIECE(HLDP0,U,12)
SET X=$$ASKSTOP^%ZTLOAD(+$PIECE(HLDP0,U,12))
+17 DO CALL^%ZISTCP($PIECE(HLPARM4,U),$PIECE(HLPARM4,U,2),10)
+18 IF POP
DO HOME^%ZIS
QUIT
+19 DO CLOSE^%ZISTCP
End DoDot:2
End DoDot:1
+20 QUIT
STRT ;Start Links
+1 NEW HLDP,HLDP0,HLDAPP,HLTYPTR,HLBGR,HLENV,HLPARAM0,HLPARM4,HLQUIT,ZTRTN,ZTDESC,ZTSK,ZTCPU
+2 SET HLDP=0
+3 FOR
SET HLDP=$ORDER(^HLCS(870,HLDP))
IF HLDP<1
QUIT
SET HLDP0=$GET(^(HLDP,0))
Begin DoDot:1
+4 SET HLPARM4=$GET(^HLCS(870,HLDP,400))
+5 ;quit if no parameters or AUTOSTART is disabled
+6 IF '$PIECE(HLDP0,U,6)
QUIT
+7 ;HLDAPP=LL name, HLTYPTR=LL type, HLBGR=routine, HLENV=environment check
+8 SET HLDAPP=$PIECE(HLDP0,U)
SET HLTYPTR=+$PIECE(HLDP0,U,3)
SET HLBGR=$GET(^HLCS(869.1,HLTYPTR,100))
SET HLENV=$GET(^(200))
+9 ;quit if no LL type or no routine
+10 IF 'HLTYPTR!(HLBGR="")
QUIT
+11 IF HLENV'=""
KILL HLQUIT
XECUTE HLENV
IF $DATA(HLQUIT)
QUIT
+12 ;TCP Multi listener for non-Cache uses UCX
+13 IF $PIECE(HLPARM4,U,3)="M"
IF ^%ZOSF("OS")'["OpenM"
QUIT
IF $$OS^%ZOSV["VMS"
QUIT
+14 IF $PIECE(HLPARM4,U,3)="C"&("N"[$PIECE(HLPARM4,U,4))
Begin DoDot:2
+15 ;4=status 9=Time Started, 10=Time Stopped, 11=Task Number
+16 ;14=Shutdown LLP, 3=Device Type, 18=Gross Errors
+17 NEW HLJ,X
+18 IF $PIECE(HLDP0,U,15)=0
QUIT
+19 LOCK +^HLCS(870,HLDP,0):2
+20 IF '$TEST
QUIT
+21 SET X="HLJ(870,"""_HLDP_","")"
+22 SET @X@(4)="Enabled"
SET @X@(9)=$$NOW^XLFDT
SET @X@(14)=0
+23 ; HL*1.6*109
DO FILE^HLDIE("","HLJ","","STRT","HLCS2")
+24 LOCK -^HLCS(870,HLDP,0)
+25 QUIT
End DoDot:2
QUIT
+26 SET ZTRTN=$PIECE(HLBGR," ",2)
SET ZTIO=""
SET ZTDTH=$HOROLOG
SET HLTRACE=""
+27 SET ZTDESC=HLDAPP_" Low Level Protocol"
SET ZTSAVE("HLDP")=""
+28 ;get startup node
+29 IF $PIECE(HLPARM4,U,6)
IF $DATA(^%ZIS(14.7,+$PIECE(HLPARM4,U,6),0))
SET ZTCPU=$PIECE(^(0),U)
+30 DO ^%ZTLOAD
End DoDot:1
+31 QUIT
SITEP ;Edit Site Parameters
+1 SET DDSFILE=869.3
SET DA=1
SET DR="[HL SITE PARAMETERS]"
DO ^DDS
+2 QUIT
PARAM() ;Return HL7 site parameters
+1 ;HLPARAM=domain ien^domain name^production or test^institution ien^
+2 ;institution name^institution number^mail group ien^mail group name^
+3 ;purge completed messages^purge awaiting ack messages^purge all msgs^
+4 ;default retention
+5 NEW HLX,HLX4,HLX5,HLDOMP,HLDOMN,HLPROD,HLINSP,HLINSN,HLINSNM,HLMAILP,HLMAILN,HLPARAM,HLPRGAA,HLPRGALL,HLPRGCMP,HLDEFRET
+6 SET HLX=$GET(^HLCS(869.3,1,0))
+7 SET HLX4=$GET(^HLCS(869.3,1,4))
+8 SET HLX5=$GET(^HLCS(869.3,1,5))
+9 SET HLDOMP=$PIECE(HLX,U,2)
IF HLDOMP
SET HLDOMN=$PIECE(^DIC(4.2,HLDOMP,0),U)
+10 SET HLPROD=$PIECE(HLX,U,3)
+11 SET HLINSP=$PIECE(HLX,U,4)
IF HLINSP
SET HLINSN=$PIECE(^DIC(4,HLINSP,0),U)
SET HLINSNM=$PIECE($GET(^DIC(4,HLINSP,99)),U)
+12 ;
+13 ; ** IHS mod ** IHS/OIRM/DSD/AEF - 01/02/03 - Prevent UNDEF error
+14 ;S HLMAILP=$P(HLX,U,5) I HLMAILP S HLMAILN=$P(^XMB(3.8,HLMAILP,0),U)
+15 SET HLMAILP=$PIECE(HLX,U,5)
IF HLMAILP
SET HLMAILN=$PIECE($GET(^XMB(3.8,HLMAILP,0)),U)
+16 ;
+17 SET HLPRGCMP=$PIECE(HLX4,U)
SET HLPRGAA=$PIECE(HLX4,U,2)
SET HLPRGALL=$PIECE(HLX4,U,3)
+18 SET HLDEFRET=$PIECE(HLX5,U)
+19 SET HLPARAM=HLDOMP_U_$GET(HLDOMN)_U_$GET(HLPROD)_U_HLINSP_U_$GET(HLINSN)_U_$GET(HLINSNM)_U_HLMAILP_U_$GET(HLMAILN)_U_HLPRGCMP_U_HLPRGAA_U_HLPRGALL_U_HLDEFRET
+20 QUIT HLPARAM
+21 ;
GETAPP(HLAPP) ;Function to Retrieve parameters pertaining to a specific sending or receiving application
+1 ;HLAPP=APPLICATION NAME OR IEN OF FILE 771
+2 ;Returns MAIL GROUP NAME^'a' or 'i' (active or inactive)
+3 SET HLAPP=$GET(HLAPP)
+4 IF HLAPP]""
IF 'HLAPP
SET HLAPP=$ORDER(^HL(771,"B",$EXTRACT(HLAPP,1,30),0))
+5 IF 'HLAPP
QUIT ""
+6 IF HLAPP
SET HLM=$PIECE(^HL(771,HLAPP,0),U,4)
+7 IF HLM
SET HLM=$PIECE($GET(^XMB(3.8,HLM,0)),U)
+8 QUIT $GET(HLM)_U_$PIECE(^HL(771,HLAPP,0),U,2)
