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

XQALBUTL.m

Go to the documentation of this file.
  1. XQALBUTL ; ISC-SF/JLI - Utilities for OE/RR notifications ;10/19/18 13:24
  1. ;;8.0;KERNEL;**114,125,171,285,602,653**;Jul 10, 1995;Build 18
  1. ;Per VHA Directive 2004-038, this routine should not be modified
  1. ; PROVIDES FUNCTIONALITY USED BY ORBUTL
  1. EN ;
  1. Q
  1. RECIPURG(XQX) ; SR. ICR #3010 (supported)
  1. ; Called by option ORB PURG RECIP - purge existing notifs: recipient/DUZ
  1. N XQK,XQA,XQADAT S XQADAT=$$NOW^XLFDT()
  1. F XQK=0:0 S XQK=$O(^XTV(8992,XQX,"XQA",XQK)) Q:XQK'>0 S XQA=$P(^(XQK,0),"^",2) D OLDPURG
  1. Q
  1. ;
  1. PTPURG(DFN) ; SR. ICR #3010 (supported)
  1. ; Called by option ORB PURG PATIENT - purge existing notifs: patient
  1. N XQX,XQK,XQA,XQADAT S XQADAT=$$NOW^XLFDT()
  1. F XQX=0:0 S XQX=$O(^XTV(8992,XQX)) Q:XQX'>0 F XQK=0:0 S XQK=$O(^XTV(8992,XQX,"XQA",XQK)) Q:XQK'>0 S XQA=$P(^(XQK,0),"^",2) I $P($P(XQA,";"),",",2)=DFN D OLDPURG
  1. Q
  1. ;
  1. NOTIPURG(Y) ; SR. ICR #3010 (supported)
  1. ; Called by option ORB PURG NOTIF - purge existing notifs: notification
  1. N XQX,XQK,XQA,XQADAT S XQADAT=$$NOW^XLFDT()
  1. F XQX=0:0 S XQX=$O(^XTV(8992,XQX)) Q:XQX'>0 F XQK=0:0 S XQK=$O(^XTV(8992,XQX,"XQA",XQK)) Q:XQK'>0 S XQA=$P(^(XQK,0),"^",2) I $P($P(XQA,";"),",",3)=+Y D OLDPURG
  1. Q
  1. ;
  1. OLDPURG ;called by RECIPURG, PTPURG, NOTIPURG - KILLs specified alert entries
  1. N XQAID S XQAID=XQA D DELA^XQALDEL ; JLI 9-3-99 FIXES NULL SUBSCRIPT IN DELA+1^XQALDEL
  1. Q
  1. ;
  1. AHISTORY(XQAID,ROOT) ; SR. ICR #2778 (supported)
  1. ; Returns information from alert tracking file for alert with XQAID as its alert ID. The data is returned desendent from the closed root passed in ROOT.
  1. N X
  1. K @ROOT
  1. S X=$O(^XTV(8992.1,"B",XQAID,0)) I X'>0 Q
  1. M @ROOT=^XTV(8992.1,X)
  1. Q
  1. ;
  1. PENDING(XQAUSER,XQAID) ; SR. ICR #2778 (supported)
  1. ; Returns whether the user specified has the alert indicated by XQAID pending. (1=YES, 0=NO)
  1. Q $D(^XTV(8992,"AXQA",XQAID,XQAUSER))/10
  1. ;
  1. PKGPEND(XQAUSER,XQAPKG) ; SR. ICR #2778 (supported)
  1. ; Returns 1 if the user indicated by XQAUSER has any pending alerts with the first ';'-piece of XQAID contains the package identifier indicated by XQAPKG.
  1. N I,X
  1. F I=0:0 S X="",I=$O(^XTV(8992,XQAUSER,"XQA",I)) Q:I'>0 S X=$P($P(^(I,0),U,2),";") I X[XQAPKG Q
  1. Q $S(X'="":1,1:0)
  1. ;
  1. ALERTDAT(XQAID,ROOT) ; SR. ICR #2778 (supported)
  1. ; Returns information from alert tracking file for alert with XQAID in array XQALERTD. If the alert is not present, the array is undefined.
  1. N IEN
  1. I $G(ROOT)="" S ROOT="XQALERTD"
  1. K @ROOT
  1. S IEN=$O(^XTV(8992.1,"B",XQAID,0)) I IEN'>0 S @ROOT="" Q
  1. D MAKELIST(ROOT,8992.1,(IEN_","))
  1. Q
  1. ;
  1. USERLIST(XQAID,ROOT) ; SR. ICR #2778 (supported)
  1. ; Returns recipients of alert with ID of XQAID from alert tracking file in array XQALUSER
  1. N IEN,N,I,X
  1. I $G(ROOT)="" S ROOT="XQALUSRS"
  1. K @ROOT
  1. S IEN=$O(^XTV(8992.1,"B",XQAID,0)) I IEN'>0 S @ROOT="" Q
  1. S N=0 F I=0:0 S I=$O(^XTV(8992.1,IEN,20,I)) Q:I'>0 S N=N+1,X=+^(I,0),X=X_U_$$GET1^DIQ(8992.11,(I_","_IEN_","),.01),@ROOT@(N)=X
  1. Q
  1. ;
  1. USERDATA(XQAID,XQAUSER,ROOT) ; SR. ICR #2778 (supported)
  1. ; Returns information from alert tracking file related to alert with ID of XQAID for user specified by XQAUSER
  1. N IEN,IEN2
  1. I $G(ROOT)="" S ROOT="XQALUSER"
  1. K @ROOT
  1. S IEN=$O(^XTV(8992.1,"B",XQAID,0)) I IEN'>0 S @ROOT="" Q
  1. S IEN2=$O(^XTV(8992.1,IEN,20,"B",XQAUSER,0)) I IEN2'>0 S @ROOT="" Q
  1. D MAKELIST(ROOT,8992.11,(IEN2_","_IEN_","))
  1. Q
  1. ;
  1. MAKELIST(ARRAY,FILE,IENS) ; Makes a list of fields as subscripts in ARRAY with the values of the fields as the value. If internal and external differ, the value is given as internal^external.
  1. N ROOT,FIELD,X
  1. K @ARRAY
  1. S ROOT=$NA(^TMP("XQALMAKELIST",$J))
  1. K @ROOT
  1. D GETS^DIQ(FILE,IENS,"*","IE",ROOT)
  1. F FIELD=0:0 S FIELD=$O(@ROOT@(FILE,IENS,FIELD)) Q:FIELD'>0 D
  1. . ;patch 653 long infor text.
  1. . I FIELD'=4 D
  1. . . S X=^(FIELD,"I") S:X'=^("E") X=X_U_^("E")
  1. . . S @ARRAY@(FIELD)=X
  1. . I FIELD=4 D
  1. . . N XQALX
  1. . . S:'$D(@ARRAY@(FIELD)) @ARRAY@(FIELD)=""
  1. . . S XQALX=0 F XQALX=0:0 S XQALX=$O(@ROOT@(FILE,IENS,FIELD,XQALX)) Q:'XQALX S X=$G(@ROOT@(FILE,IENS,FIELD,XQALX)) S @ARRAY@(FIELD,XQALX)=X
  1. . . Q
  1. . S @ARRAY@(FIELD,$$GET1^DID(FILE,FIELD,"","LABEL"))=""
  1. K @ROOT
  1. Q
  1. ;
  1. ;; DELSTAT - For the most recent alert with XQAIDVAL as the PackageID
  1. ;; passed in, on return array VALUES contains the DUZ for users in
  1. ;; VALUES along with an indicator of whether the alert has been
  1. ;; deleted or not, e.g., DUZ^0 if not deleted or DUZ^1 if deleted.
  1. ;; Note that contents of VALUES will be killed prior to building the
  1. ;; list.
  1. ;;
  1. ;; Example: D DELSTAT^XQALBUTL("OR;14765;23",.RESULTS)
  1. ;;
  1. ;; Returned: The value of RESULTS indicates the number of entries in
  1. ;; the array. The entries are then ordered in numerical
  1. ;; order in the RESULTS array.
  1. ;; RESULTS = 3
  1. ;; RESULTS(1) = "146^0" User 146 - not deleted
  1. ;; RESULTS(2) = "297^1" User 297 - deleted
  1. ;; RESULTS(3) = "673^0" User 673 - not deleted
  1. ;;
  1. DELSTAT(XQAIDVAL,VALUES) ; .SR ICR #3197 (supported)
  1. N XQAX,XQADATE,XQAID,XQAFN,I,X,X1,X
  1. S XQAX=XQAIDVAL,XQADATE=0,XQAID="" K VALUES S VALUES=0
  1. F S XQAX=$O(^XTV(8992.1,"B",XQAX)) Q:XQAX'[XQAIDVAL I XQADATE<$P(XQAX,";",3) S XQADATE=$P(XQAX,";",3),XQAID=XQAX
  1. Q:XQAID="" S XQAFN=$O(^XTV(8992.1,"B",XQAID,0)) Q:XQAFN'>0
  1. F I=0:0 S I=$O(^XTV(8992.1,XQAFN,20,I)) Q:I'>0 S X=^(I,0),X1=+X,X2=($P(X,U,5)>0!($P(X,U,6)>0)),VALUES=VALUES+1,VALUES(VALUES)=X1_U_X2
  1. Q
  1. ;
  1. BKUPREVW ;OPT - SET BACKUP REVIEWER(S) IN PARAMETER FILE - Moved from XQALDEL
  1. N DIR,DIRUT,XQALBKUP,XQALCASE,XQPARAM,ERR
  1. S XQPARAM="XQAL BACKUP REVIEWER"
  1. BK1 ; Select NEW PERSON entry as backup reviewer
  1. F S XQALBKUP=$$NEWPERSN() Q:$D(DIRUT) Q:XQALBKUP'>0 D Q:$D(DIRUT)
  1. . D LISTCURR(XQALBKUP)
  1. BK2 . ; Select Entity type for backup reviewer - XQALLAST indicates maximum number of choices, last is SYSTEM.
  1. . N XQALVALS,XQALLAST
  1. . S XQALLAST=4,XQALVALS(1)="User^200^USER^USR",XQALVALS(2)="Service^49^SERVICE^SRV",XQALVALS(3)="Division^4^DIVISION^DIV",XQALVALS(4)="System^"
  1. . F S XQALCASE=$$ENTTYPE(.XQALVALS,XQALLAST) Q:$D(DIRUT) Q:XQALCASE'>0 D K:X="" DIRUT Q:$D(DIRUT)
  1. . . ; Select individual in Entity for backup reviewer
  1. . . I XQALCASE<XQALLAST D
  1. . . . S DIR(0)="PO^"_$P(XQALVALS(XQALCASE),U,2)_":AEQM",DIR("A")="Select "_$P(XQALVALS(XQALCASE),U,3)_" to set "_$P(XQALBKUP,U,2)_" as BACKUP REVIEWER for"
  1. . . . F D ^DIR Q:Y'>0 S XQAENT=+Y D CHKCURR($P(XQALVALS(XQALCASE),U,4)_".`"_XQAENT,+XQALBKUP)
  1. . . . K DIR
  1. . . . Q
  1. . . ; Special handling for SYSTEM entity
  1. . . I XQALCASE=XQALLAST S Y=$$GET1^DIQ(8989.3,"1,",.01,"I") D CHKCURR("SYS.`"_Y,+XQALBKUP)
  1. . . Q
  1. . Q
  1. Q
  1. ;
  1. NEWPERSN() ;
  1. ; Select a Backup Reviewer, then select parameter cases for this Backup
  1. ; Reviewer. You may then select another Backup Reviewer for additional
  1. ; parameter cases if necessary.
  1. ;
  1. ; Select NEW PERSON entry to be BACKUP REVIEWER
  1. NEWLOOP ;
  1. W ! S DIR(0)="PO^200:AEQM",DIR("A")="Select NEW PERSON entry to be BACKUP REVIEWER",DIR("A",1)="Select a Backup Reviewer, then select parameter cases for this Backup"
  1. S DIR("A",2)="Reviewer. You may then select another Backup Reviewer for additional",DIR("A",3)="parameter cases if necessary.",DIR("A",4)=""
  1. D ^DIR K DIR I X="" K DIRUT
  1. I Y>0,'$$ACTIVE^XUSER(+Y) W !,$C(7),"This is not an ACTIVE USER... Select an Active user",! G NEWLOOP
  1. Q Y
  1. ;
  1. ENTTYPE(XQALVALS,XQALLAST) ;
  1. K DIR("A")
  1. S XQALCASE="" F I=1:1:XQALLAST S XQALCASE=XQALCASE_I_":"_$P(XQALVALS(I),U)_";"
  1. S DIR(0)="SO^"_XQALCASE D ^DIR K DIR I X="" K DIRUT
  1. Q Y
  1. ;
  1. CHKCURR(ENTITY,XQALBKUP) ;
  1. S XQAINST=$$GETINST(ENTITY,XQALBKUP)
  1. I XQAINST>0 D PUT^XPAR(ENTITY,XQPARAM,XQAINST,XQALBKUP,.ERR) W " ...Done"
  1. I XQAINST<0 D PUT^XPAR(ENTITY,XQPARAM,-XQAINST,"@",.ERR) W " ...Done"
  1. Q
  1. ;
  1. GETINST(ENTITY,XQALBKUP) ;
  1. N DIR,DIRUT,I,J,IMAX,XQAA,XQATYP,XQAI,Y,ISELF,IEN,XQAVAL
  1. D GETLST^XPAR(.XQAA,ENTITY,XQPARAM,"Q",.XQERR) I XQAA=0 Q 1
  1. LOOP ;
  1. W !,"There "_$S(XQAA=1:"is",1:"are")_" currently "_XQAA_" instance"_$S(XQAA>1:"s",1:"")_" for this entity"
  1. S ISELF=0
  1. F I=0:0 S I=$O(XQAA(I)) Q:I'>0 S IEN=+$P(XQAA(I),U,2) W !,?5,+XQAA(I),?10,$$GET1^DIQ(200,IEN_",",.01) S IMAX=+XQAA(I) I IEN=XQALBKUP S ISELF=+XQAA(I)
  1. S DIR(0)="S^"_$S(ISELF=0:";a:Add an instance;r:Replace an instance;",1:"")_"d:Delete an instance;q:Quit",DIR("A")="Select Action" D ^DIR K DIR I $D(DIRUT)!(Y="q") K DIRUT Q 0
  1. S XQATYP=Y I XQATYP="a" S J=0 D Q J
  1. . F XQAI=1:1 I +$G(XQAA(XQAI))'=XQAI S J=XQAI I J>0 Q
  1. E D Q:Y=0 0
  1. . S Y=IMAX I XQAA>1 S DIR(0)="N^1:"_IMAX,DIR("A")="Select Instance number to "_$S(XQATYP="r":"REPLACE",1:"DELETE") D ^DIR K DIR I $D(DIRUT) K DIRUT S Y=0 Q
  1. . F XQAI=1:1 Q:'$D(XQAA(XQAI)) I +XQAA(XQAI)=Y Q
  1. . I '$D(XQAA(XQAI)) S Y=-1
  1. I Y<0 W $C(7),!!,"To "_$S(XQATYP="r":"REPLACE",1:"DELETE")_" an entry enter an instance number from the list." G LOOP
  1. S XQAVAL=+Y I XQATYP="d" S XQAVAL=-Y
  1. Q XQAVAL
  1. ;
  1. LISTCURR(XQALBKUP) ;
  1. N XLIST,NVALS,ENT,XQIEN,X,ENTIEN,ENTFIL,FILNAM,FILNUM
  1. S NVALS=$$LISTGET(+XQALBKUP,.XLIST) I NVALS>0 D
  1. . W !,"Currently Backup Reviewer for:"
  1. . S ENT="" F S ENT=$O(XLIST(ENT)) Q:ENT="" F XQIEN=0:0 S XQIEN=$O(XLIST(ENT,XQIEN)) Q:XQIEN'>0 D
  1. . . S X=$$GET1^DIQ(8989.5,XQIEN_",",.01,"I"),ENTIEN=$P(X,";"),ENTFIL=$P(X,";",2),FILNAM=$P(@(U_ENTFIL_"0)"),U),FILNUM=+$P(@(U_ENTFIL_"0)"),U,2) I FILNUM>0 D
  1. . . . W !?10,$S(FILNUM=4:"Division",FILNUM=4.2:"System",FILNUM=49:"Service",FILNUM=200:"User",1:"UNKNOWN???")_":",?25,$$GET1^DIQ(FILNUM,ENTIEN_",",.01)
  1. . . . Q
  1. . . Q
  1. . Q
  1. Q
  1. ;
  1. LISTGET(XQALBKUP,XLIST) ;
  1. N PARAMIEN,ENT,INST,X,IEN,ENT1,CNT
  1. S PARAMIEN=$$FIND1^DIC(8989.51,"","","XQAL BACKUP REVIEWER"),CNT=0
  1. S ENT="" F S ENT=$O(^XTV(8989.5,"AC",PARAMIEN,ENT)) Q:ENT="" F INST=0:0 S INST=$O(^XTV(8989.5,"AC",PARAMIEN,ENT,INST)) Q:INST'>0 S IEN=^(INST),X=$O(^(INST,"")) I IEN=XQALBKUP S ENT1=$P(ENT,";",2),XLIST(ENT1,X)="",CNT=CNT+1
  1. Q CNT