Home   Package List   Routine Alphabetical List   Global Alphabetical List   FileMan Files List   FileMan Sub-Files List   Package Component Lists   Package-Namespace Mapping  
Routine: HLCS2

HLCS2.m

Go to the documentation of this file.
  1. HLCS2 ;SF/JC - More Communication Server utilities ; 08/05/2011 11:22
  1. ;;1.6;HEALTH LEVEL SEVEN;**14,40,43,49,57,58,82,84,109,122,157**;Oct 13, 1995;Build 8
  1. ;Per VHA Directive 2004-038, this routine should not be modified.
  1. FWD ; Add supplemental clients from HLL("LINKS") to HLSUP array
  1. ;This enhancement also supports distribution of a message to
  1. ;the same client over multiple logical links.
  1. Q:'$D(HLL("LINKS"))
  1. N CNT,LNK,CLIAP
  1. S CNT=0,ROUTINE=1 F S CNT=$O(HLL("LINKS",CNT)) Q:CNT<1 D
  1. . S PTR=$P(HLL("LINKS",CNT),"^"),LNK=$P(HLL("LINKS",CNT),"^",2)
  1. . Q:PTR="" I +PTR<1 S PTR=$O(^ORD(101,"B",PTR,0)) Q:PTR<1
  1. . ;
  1. . ; patch HL*1.6*122: excluding subscribers defined in
  1. . ; HLP("EXCLUDE SUBSCRIBER",I) = ien of subscriber
  1. . N I,EXCLUDE
  1. . S (EXCLUDE,I)=0
  1. . F S I=$O(HLP("EXCLUDE SUBSCRIBER",I)) Q:'I D Q:EXCLUDE
  1. .. N TEMP
  1. .. S TEMP=HLP("EXCLUDE SUBSCRIBER",I)
  1. .. I 'TEMP,TEMP]"" S TEMP=$O(^ORD(101,"B",TEMP,0))
  1. .. I TEMP=PTR S EXCLUDE=1
  1. . Q:EXCLUDE
  1. . ;
  1. . Q:LNK="" I +LNK<1 S LNK=$O(^HLCS(870,"B",LNK,0)) Q:LNK<1
  1. . Q:'$D(^HLCS(870,LNK))
  1. . S CLIAP=$$PTR^HLUTIL2(PTR)
  1. . ; patch HL*1.6*122: add the 3rd component as receiving facility
  1. . ; S HLSUP("S",PTR,+LNK)=CLIAP_$S(CLIAP<1:U_HLL("LINKS",CNT),1:"")
  1. . S HLSUP("S",PTR,+LNK)=CLIAP_U_$S(CLIAP<1:HLL("LINKS",CNT),1:$P(HLL("LINKS",CNT),"^",3))
  1. Q
  1. ADD ;Deliver message to supplemental client list.
  1. ;Invoked by HLTP before and after processing normal clients
  1. ;Only processes remote links. Local clients must be subscribing
  1. ;protocols.
  1. Q:'$D(HLSUP("S"))
  1. N HLTCP,HLTCPI,HLTCPO,ZHLEIDS,ZLCLIENT,ZLOGLINK,ZMTIENS
  1. S ZHLEIDS=0 F S ZHLEIDS=$O(HLSUP("S",ZHLEIDS)) Q:ZHLEIDS<1 D
  1. .S ZLOGLINK=0 F S ZLOGLINK=$O(HLSUP("S",ZHLEIDS,ZLOGLINK)) Q:ZLOGLINK<1 D
  1. ..S ZLCLIENT=+HLSUP("S",ZHLEIDS,ZLOGLINK)
  1. ..I ZLCLIENT<1 S:$G(HLERROR)="" HLERROR="15^Invalid Subscriber Protocol in HLL('LINKS'): "_$P(HLSUP("S",ZHLEIDS,ZLOGLINK),U,2,9) Q
  1. .. ; patch HL*1.6*122 start
  1. .. ; S HLOGLINK=ZLOGLINK D SEND^HLMA2(ZHLEIDS,HLMTIEN,ZLCLIENT,"D",.ZMTIENS,ZLOGLINK),STATUS^HLTF0(+ZMTIENS,1)
  1. .. S HLOGLINK=ZLOGLINK
  1. .. ; 3rd component for receiving facility
  1. .. S ZMTIENS("REC-FACILITY")=$P(HLSUP("S",ZHLEIDS,ZLOGLINK),U,3)
  1. .. D SEND^HLMA2(ZHLEIDS,HLMTIEN,ZLCLIENT,"D",.ZMTIENS,ZLOGLINK)
  1. .. D STATUS^HLTF0(+ZMTIENS,1)
  1. .. ; patch HL*1.6*122 end
  1. .. ;
  1. K HLL("LINKS"),HLSUP
  1. Q
  1. STALL ;STOP ALL LINKS AND FILERS
  1. N DIR,Y
  1. W ! S DIR(0)="Y",DIR("A")="Okay to shut down all Links and Filers"
  1. D ^DIR
  1. I 'Y!($D(DIRUT))!($D(DUOUT)) W !!,"Shutdown Aborted!" Q
  1. W !,"Shutting down all Links and Filers..."
  1. D CLEAR
  1. D LLP(1)
  1. Q
  1. QUE ;Restart Filers and AUTOSTART Logical Links after system re-boot
  1. N DIR,Y
  1. I '$D(ZTQUEUED) D Q:'Y!($D(DIRUT))!($D(DUOUT))
  1. .W ! S DIR(0)="Y",DIR("A")="Shutdown and restart ALL AUTOSTART links and filers. Okay"
  1. .D ^DIR
  1. .I 'Y!($D(DIRUT))!($D(DUOUT)) W !!,"RESTART Aborted!" Q
  1. .W !,"Restarting all Autostart-Enabled Links and Filers..."
  1. D CLEAR
  1. D STARTF
  1. D LLP(0)
  1. D STRT
  1. Q
  1. CLEAR ;Reset state of 869.3
  1. S DA(1)=1,DA=0,DIK="^HLCS(869.3,1,2,"
  1. F S DA=$O(^HLCS(869.3,DA(1),2,DA)) Q:DA<1 D ^DIK
  1. S DA=0,DIK="^HLCS(869.3,1,3,"
  1. F S DA=$O(^HLCS(869.3,DA(1),3,DA)) Q:DA<1 D ^DIK
  1. Q
  1. STARTF ;Start filers
  1. ;Get Defaults
  1. N TMP,PTR,DEFCNT,DA,HLCNT,HLNODE1
  1. S PTR=+$O(^HLCS(869.3,0)) Q:'PTR
  1. ;default # of incoming filers
  1. S HLNODE1=$G(^HLCS(869.3,PTR,1)),DEFCNT=+$P(HLNODE1,U) S:'DEFCNT DEFCNT=1
  1. F HLCNT=1:1:DEFCNT S TMP=$$TASKFLR^HLCS1("IN")
  1. ;default # of outgoing filers
  1. S DEFCNT=+$P(HLNODE1,U,2) S:'DEFCNT DEFCNT=1
  1. F HLCNT=1:1:DEFCNT S TMP=$$TASKFLR^HLCS1("OUT")
  1. Q
  1. LLP(ALL) ;Stop Logical Links
  1. ;ALL=1 OR 0 IF zero, only AUTOSTART LINKS get stopped
  1. N HLDP,HLDP0,HLPARM0,HLPARM4,HLJ,X,Y S HLDP=0
  1. F S HLDP=$O(^HLCS(870,HLDP)) Q:'HLDP S HLDP0=$G(^(HLDP,0)),X=+$P(HLDP0,U,3) D:X
  1. .;skip this link if not stopping all and Autostart not enabled
  1. . I 'ALL&('$P(HLDP0,U,6)) Q
  1. . S HLPARM4=$G(^HLCS(870,HLDP,400))
  1. . ; patch HL*1.6*122
  1. . ; TCP Multi listener: quit if TCP service as GT.M, DSM,
  1. . ; or Cache/VMS
  1. . ; patch HL*1.6*157
  1. . ; I $P(HLPARM4,U,3)="M" Q:^%ZOSF("OS")'["OpenM" Q:$$OS^%ZOSV["VMS"
  1. . I $P(HLPARM4,U,3)="M" Q:^%ZOSF("OS")'["OpenM" Q:($$OS^%ZOSV["VMS")!($$OS^%ZOSV["UNIX")
  1. . ;
  1. . ;4=status,10=Time Stopped,9=Time Started,11=Task Number,3=Device Type,14=shutdown?
  1. . S X="HLJ(870,"""_HLDP_","")",@X@(10)=$$NOW^XLFDT,(@X@(11),@X@(9))="@",@X@(14)=1
  1. . I "Shutdown,SHUTDOWN"'[$P(HLDP0,U,5) S @X@(4)="Halting"
  1. . I $P(HLPARM4,U,3)="C"&("N"[$P(HLPARM4,U,4)),'$P(HLDP0,U,12) S @X@(4)="Shutdown"
  1. . D FILE^HLDIE("","HLJ","","LLP","HLCS2") ;HL*1.6*109
  1. . ; patch HL*1.6*157
  1. . ; I ^%ZOSF("OS")["OpenM",($P(HLPARM4,U,3)="M"!($P(HLPARM4,U,3)="S")) D
  1. . I ($P(HLPARM4,U,3)="M"!($P(HLPARM4,U,3)="S")) D
  1. .. ; pass task number to stop listener
  1. .. S:$P(HLDP0,U,12) X=$$ASKSTOP^%ZTLOAD(+$P(HLDP0,U,12))
  1. ; patch HL*1.6*122 start
  1. ; .. D CALL^%ZISTCP($P(HLPARM4,U),$P(HLPARM4,U,2),10)
  1. ; .. I POP D HOME^%ZIS Q
  1. ; .. D CLOSE^%ZISTCP
  1. ; patch HL*1.6*122 end
  1. Q
  1. STRT ;Start Links
  1. N HLDP,HLDP0,HLDAPP,HLTYPTR,HLBGR,HLENV,HLPARAM0,HLPARM4,HLQUIT,ZTRTN,ZTDESC,ZTSK,ZTCPU
  1. S HLDP=0
  1. F S HLDP=$O(^HLCS(870,HLDP)) Q:HLDP<1 S HLDP0=$G(^(HLDP,0)) D
  1. . S HLPARM4=$G(^HLCS(870,HLDP,400))
  1. . ;quit if no parameters or AUTOSTART is disabled
  1. . Q:'$P(HLDP0,U,6)
  1. . ;HLDAPP=LL name, HLTYPTR=LL type, HLBGR=routine, HLENV=environment check
  1. . S HLDAPP=$P(HLDP0,U),HLTYPTR=+$P(HLDP0,U,3),HLBGR=$G(^HLCS(869.1,HLTYPTR,100)),HLENV=$G(^(200))
  1. . ;quit if no LL type or no routine
  1. . Q:'HLTYPTR!(HLBGR="")
  1. . I HLENV'="" K HLQUIT X HLENV Q:$D(HLQUIT)
  1. . ; patch HL*1.6*122
  1. . ; TCP Multi listener: quit if TCP service as GT.M, DSM,
  1. . ; or Cache/VMS
  1. . ; patch HL*1.6*157
  1. . ; I $P(HLPARM4,U,3)="M" Q:^%ZOSF("OS")'["OpenM" Q:$$OS^%ZOSV["VMS"
  1. . I $P(HLPARM4,U,3)="M" Q:^%ZOSF("OS")'["OpenM" Q:($$OS^%ZOSV["VMS")!($$OS^%ZOSV["UNIX")
  1. . ;
  1. . I $P(HLPARM4,U,3)="C"&("N"[$P(HLPARM4,U,4)) D Q
  1. .. ;4=status 9=Time Started, 10=Time Stopped, 11=Task Number
  1. .. ;14=Shutdown LLP, 3=Device Type, 18=Gross Errors
  1. .. N HLJ,X
  1. .. I $P(HLDP0,U,15)=0 Q
  1. .. L +^HLCS(870,HLDP,0):2
  1. .. E Q
  1. .. S X="HLJ(870,"""_HLDP_","")"
  1. .. S @X@(4)="Enabled",@X@(9)=$$NOW^XLFDT,@X@(14)=0
  1. .. D FILE^HLDIE("","HLJ","","STRT","HLCS2") ; HL*1.6*109
  1. .. L -^HLCS(870,HLDP,0)
  1. .. Q
  1. . S ZTRTN=$P(HLBGR," ",2),ZTIO="",ZTDTH=$H,HLTRACE=""
  1. . S ZTDESC=HLDAPP_" Low Level Protocol",ZTSAVE("HLDP")=""
  1. . ;get startup node
  1. . I $P(HLPARM4,U,6),$D(^%ZIS(14.7,+$P(HLPARM4,U,6),0)) S ZTCPU=$P(^(0),U)
  1. . D ^%ZTLOAD
  1. Q
  1. SITEP ;Edit Site Parameters
  1. S DDSFILE=869.3,DA=1,DR="[HL SITE PARAMETERS]" D ^DDS
  1. Q
  1. PARAM() ;Return HL7 site parameters
  1. ;HLPARAM=domain ien^domain name^production or test^institution ien^
  1. ;institution name^institution number^mail group ien^mail group name^
  1. ;purge completed messages^purge awaiting ack messages^purge all msgs^
  1. ;default retention
  1. N HLX,HLX4,HLX5,HLDOMP,HLDOMN,HLPROD,HLINSP,HLINSN,HLINSNM,HLMAILP,HLMAILN,HLPARAM,HLPRGAA,HLPRGALL,HLPRGCMP,HLDEFRET
  1. S HLX=$G(^HLCS(869.3,1,0))
  1. S HLX4=$G(^HLCS(869.3,1,4))
  1. S HLX5=$G(^HLCS(869.3,1,5))
  1. S HLDOMP=$P(HLX,U,2) I HLDOMP S HLDOMN=$P(^DIC(4.2,HLDOMP,0),U)
  1. S HLPROD=$P(HLX,U,3)
  1. S HLINSP=$P(HLX,U,4) I HLINSP S HLINSN=$P(^DIC(4,HLINSP,0),U),HLINSNM=$P($G(^DIC(4,HLINSP,99)),U)
  1. S HLMAILP=$P(HLX,U,5) I HLMAILP S HLMAILN=$P(^XMB(3.8,HLMAILP,0),U)
  1. S HLPRGCMP=$P(HLX4,U),HLPRGAA=$P(HLX4,U,2),HLPRGALL=$P(HLX4,U,3)
  1. S HLDEFRET=$P(HLX5,U)
  1. 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
  1. Q HLPARAM
  1. ;
  1. GETAPP(HLAPP) ;Function to Retrieve parameters pertaining to a specific sending or receiving application
  1. ;HLAPP=APPLICATION NAME OR IEN OF FILE 771
  1. ;Returns MAIL GROUP NAME^'a' or 'i' (active or inactive)
  1. S HLAPP=$G(HLAPP)
  1. I HLAPP]"",'HLAPP S HLAPP=$O(^HL(771,"B",$E(HLAPP,1,30),0))
  1. I 'HLAPP Q ""
  1. I HLAPP S HLM=$P(^HL(771,HLAPP,0),U,4)
  1. I HLM S HLM=$P($G(^XMB(3.8,HLM,0)),U)
  1. Q $G(HLM)_U_$P(^HL(771,HLAPP,0),U,2)