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

GMRCTU.m

Go to the documentation of this file.
  1. GMRCTU ; SLC-SLC/PKS Consults - Terminated users/remove pointers. ; [2/8/00 11:15am]
  1. ;;3.0;CONSULT/REQUEST TRACKING;**9**;Dec 27, 1997
  1. ;
  1. ; OE/RR V3.0 - CONSULTS V3.0
  1. ;
  1. ; CONSULTS - Removes pointers upon termination.
  1. ; The records to be edited are pointers to file #200, NEW PERSON.
  1. ;
  1. ; ------------------------------------------------------------------
  1. ; Enter new files/fields at end of routine under entry label "TEXT."
  1. ; ------------------------------------------------------------------
  1. ;
  1. ; Triggered by Kernel's XU USER TERMINATE event.
  1. ; Applicable piece set to null or multiples delted.
  1. ; Variable "USER" is DUZ of user for whom pointers will be removed.
  1. ; The "USER" value must be passed to the routine by Kernel.
  1. ;
  1. ; Variables used:
  1. ; NPARY = DB array with info on file/field.
  1. ; CNT = Overall counter variable.
  1. ; INFO = TEXT list variable.
  1. ; VALUE = Value match string.
  1. ; DIE,DA,DR,X = Used by calls to ^DIE.
  1. ; NODE = Node to edit, if applicable.
  1. ; PIECE = Piece of node to edit.
  1. ; RSTR = Global root file string.
  1. ; SSTR = Subfile string.
  1. ; FILENUM = File number.
  1. ; IEN = IEN string.
  1. ; SIEN = Subfile IEN string.
  1. ; FIELDNUM = Data Dictionary field number.
  1. ; APPSTR = Append string variable.
  1. ;
  1. Q
  1. ;
  1. EN ; Entry point - called by option: CONSULT TERMINATE CLEANUP.
  1. ;
  1. S USER=$GET(XUIFN) ; Assign user variable.
  1. I USER="" Q ; If there's a problem, dump out right now.
  1. D START(USER) ; Call the Control sequence for whole routine.
  1. Q
  1. ;
  1. FINDVAL ; See if VALUE (desired USER) exists in the record.
  1. ;
  1. S VALUE="" ; Initialize.
  1. ;
  1. I SSTR="" D Q ; If no subfile, quit after this IF.
  1. .I $P($G(@(RSTR_+IEN_","_NODE_APPSTR)),"^",PIECE)=USER S VALUE=USER
  1. ;
  1. ; Process subfiles:
  1. I $P($G(@(RSTR_+IEN_","_SSTR_","_SIEN_","_NODE_APPSTR)),"^",PIECE)=USER S VALUE=USER
  1. ;
  1. Q
  1. ;
  1. CALLDIE ; Set FM variables and call DIE.
  1. ;
  1. N DIE,DA,DR,X
  1. ;
  1. I SSTR="" D Q ; No subfile involved.
  1. .S DA=IEN,DIE=RSTR,DR=FIELDNUM_"///^S X=""@"""
  1. .LOCK +@(DIE_IEN_")"):0
  1. .D ^DIE ; User terminated, so call regardless of lock success.
  1. .LOCK -@(DIE_IEN_")")
  1. ;
  1. ; Process subfile:
  1. S DA(1)=IEN,DA=SIEN,DIE=RSTR_DA(1)_","_SSTR_",",DR=FIELDNUM_"///^S X=""@"""
  1. LOCK +@(DIE_IEN_")"):0
  1. D ^DIE ; User terminated, so call regardless of lock success.
  1. LOCK -@(DIE_IEN_")")
  1. ;
  1. Q
  1. ;
  1. MAIN ; Outer FOR loop to scan file for IENs, deleting pointer entries.
  1. ;
  1. D INFO^GMRCTU1(FILENUM,FIELDNUM,.NPARY) ; DB call, gets information.
  1. ;
  1. I (NPARY("DIC",0)="")!(NPARY("LOC")="") Q ; Problems? Dump out.
  1. ;
  1. ; Assign variables from resulting call:
  1. S (RSTR,SSTR,NODE,PIECE,APPSTR)="" ; Initialize.
  1. S RSTR=NPARY("DIC",1) ; Assign global root string.
  1. ;
  1. ; If a multiple, set flag and assign subfile string:
  1. I $L($G(NPARY("DIC",2))) S SSTR=$P(NPARY("DIC",2),",",3)
  1. S NODE=$P(NPARY("LOC"),";",1) ; Assign node variable.
  1. S PIECE=$P(NPARY("LOC"),";",2) ; Assign piece variable.
  1. S APPSTR=")" ; Assign append string.
  1. ;
  1. ; Order through file root entries:
  1. S IEN="" ; Initialize.
  1. ;
  1. F S IEN=$O(@(RSTR_+IEN_")")) Q:+IEN=0 D
  1. .I SSTR="" D Q ; Is subfile involved?
  1. ..D FINDVAL ; Check for value match.
  1. ..I VALUE=USER D CALLDIE ; If a match, clean out pointer entry.
  1. .;
  1. .; Process subfile multiples:
  1. .S SIEN=0 ; Initialize.
  1. .;
  1. .F S SIEN=$O(@(RSTR_+IEN_","_SSTR_","_SIEN_")")) Q:+SIEN=0 D
  1. ..D FINDVAL ; Check for value match.
  1. ..I VALUE=USER D CALLDIE ; If a match, clean out pointer entry.
  1. ;
  1. Q
  1. ;
  1. START(USER) ;Control sequence for complete process.
  1. ;
  1. N CNT,INFO
  1. S CNT=4 ; Set CNT to first TEXT entry.
  1. ;
  1. ; Overall loop to get data from TEXT entries (at end of routine):
  1. F D Q:INFO="QUIT"
  1. .N NPARY,VALUE,DIE,DA,DR,X,NODE,PIECE,RSTR,SSTR,FILENUM,IEN,SIEN,FIELDNUM,APPSTR
  1. .S CNT=CNT+1 ; Increment for each TEXT entry.
  1. .S INFO=$P($TEXT(TEXT+CNT),";;",2) ; Get TEXT string.
  1. .Q:INFO="QUIT" ; Finished when no more valid entries are found.
  1. .;
  1. .; Assign two variables from INFO string for each file/field:
  1. .S FILENUM=$P(INFO,",",1)
  1. .S FIELDNUM=$P(INFO,",",2)
  1. .;
  1. .D MAIN ; Proceed to main processing for each file/field.
  1. ;
  1. Q
  1. ;
  1. ; *******************************************************************
  1. ;
  1. ; Informational comments on files/fields added to TEXT section.
  1. ;
  1. ; File Name File#,Field Field Name
  1. ; ------------------------------------------------------------------
  1. ; REQUEST SERVICES 123.5,123.5 SPECIAL UPDATES INDIVIDUAL
  1. ; REQUEST SERVICES 123.5,123.08 SERVICE INDIVIDUAL TO NOTIFY
  1. ; (NOTIF. BY PT. LOC) 123.54,1 INDIVIDUAL TO NOTIFY
  1. ; (UPD. USERS W/O NOT.) 123.55,.01 UPDATE USERS W/O NOTIFICATION
  1. ; (ADM. UPDATE USERS) 123.555,.01 ADMINISTRATIVE UPDATE USER
  1. ;
  1. ; ===================================================================
  1. ;
  1. ; EXAMPLES of files/pointer entries being removed for above list:
  1. ; (Where "777" is the USER) -
  1. ;
  1. ; ^GMR(123.5,2,0) = MEDICINE^1^^18^777
  1. ; ^GMR(123.5,2,123) = 30^1795^2112^^^^^777^11^2199^^
  1. ; ^GMR(123.5,2,123.2,2,0) = 1;DIC(42,^777^138
  1. ; ^GMR(123.5,2,123.3,7,0) = 777 (<--Multiple)
  1. ; ^GMR(123.5,2,123.33,2,0) = 777 (<--Multiple)
  1. ;
  1. ; *******************************************************************
  1. ;
  1. TEXT ; Make entries below for new files/fields for pointer removal.
  1. ; DO NOT remove or change the last line.
  1. ; Enter comma-delimited lists using DD "pointers in" format:
  1. ; Filenumber,Fieldnumber,EntryPersonLocation/Initials
  1. ;
  1. ;;123.5,123.5,ISC-SLC/PKS
  1. ;;123.5,123.08,ISC-SLC/PKS
  1. ;;123.54,1,ISC-SLC/PKS
  1. ;;123.55,.01,ISC-SLC/PKS
  1. ;;123.555,.01,ISC-SLC/PKS
  1. ;;QUIT
  1. Q
  1. ;
  1. CLNLIST(ORLTEAM,ORLTASK) ; Clean out pointers to 100.21 from 123.5 when a Team List is deleted.
  1. ;
  1. ; Called by MAIN^ORLPTU (which deletes Personal Team Lists upon
  1. ; termination of a sole or last user of the list).
  1. ;
  1. ; Called by DEL^ORLP1 (when a non-Personal Team List is deleted).
  1. ;
  1. ; Called by DEL^ORLP3U2 (when a Personal Team List is deleted
  1. ; by menu action.
  1. ;
  1. ; The following pointers from 123.5 are processed here:
  1. ;
  1. ; Subfile Name File#,Field Field Name
  1. ; ----------------------------------------------------------------
  1. ; (SERVICE TEAM(S) TO NOTIFY) 123.1,.01 SERVICE TEAM TO NOTIFY
  1. ; (NOTIF. BY PT LOCATION) 123.2,2 TEAM TO NOTIFY
  1. ; (UPD. TEAMS W/O NOT.) 123.31,.01 UPDATE TEAMS W/O NOTIF.
  1. ; (ADM. UPDATE TEAMS) 123.34,.01 ADMIN. UPDATE TEAM
  1. ;
  1. ; =================================================================
  1. ;
  1. ; Variables used:
  1. ;
  1. ; ORLTEAM = Team IEN, passed in call to this tag.
  1. ; ORLTASK = Running via Taskman or not? 0=No, 1=Yes.
  1. ; ORLGSTR = String for ^GMR(123.5 subfile.
  1. ; ORLGIEN = Temporary GMRC target file IEN holder.
  1. ; ORLSIEN = Temporary subfile IEN holder.
  1. ;
  1. I +ORLTEAM="" Q ; Punt here if there's a problem.
  1. Q:'$D(ORLTASK) ; Ditto.
  1. N ORLGSTR,ORLGIEN,ORLSIEN
  1. ;
  1. ; Check for team entry in 123.1,.01 via "AST" x-ref:
  1. S ORLGSTR="123.1"
  1. S ORLGIEN=0
  1. F S ORLGIEN=$O(^GMR(123.5,"AST",ORLTEAM,ORLGIEN)) Q:+ORLGIEN=0 D
  1. .S ORLSIEN=0
  1. .F S ORLSIEN=$O(^GMR(123.5,"AST",ORLTEAM,ORLGIEN,ORLSIEN)) Q:+ORLSIEN=0 D KPOINT
  1. ;
  1. ; Check for team entry in 123.2,2 via "ANT" x-ref:
  1. S ORLGSTR="123.2"
  1. S ORLGIEN=0
  1. F S ORLGIEN=$O(^GMR(123.5,"ANT",ORLTEAM,ORLGIEN)) Q:+ORLGIEN=0 D
  1. .S ORLSIEN=0
  1. .F S ORLSIEN=$O(^GMR(123.5,"ANT",ORLTEAM,ORLGIEN,ORLSIEN)) Q:+ORLSIEN=0 D KPOINT
  1. ;
  1. ; Check for team entry in 123.31,.01 via "AUT" x-ref:
  1. S ORLGSTR="123.31"
  1. S ORLGIEN=0
  1. F S ORLGIEN=$O(^GMR(123.5,"AUT",ORLTEAM,ORLGIEN)) Q:+ORLGIEN=0 D
  1. .S ORLSIEN=0
  1. .F S ORLSIEN=$O(^GMR(123.5,"AUT",ORLTEAM,ORLGIEN,ORLSIEN)) Q:+ORLSIEN=0 D KPOINT
  1. ;
  1. ; Check for team entry in 123.34,.01 via "AAT" x-ref:
  1. S ORLGSTR="123.34"
  1. S ORLGIEN=0
  1. F S ORLGIEN=$O(^GMR(123.5,"AAT",ORLTEAM,ORLGIEN)) Q:+ORLGIEN=0 D
  1. .S ORLSIEN=0
  1. .F S ORLSIEN=$O(^GMR(123.5,"AAT",ORLTEAM,ORLGIEN,ORLSIEN)) Q:+ORLSIEN=0 D KPOINT
  1. ;
  1. Q
  1. ;
  1. KPOINT ; Set variables and call DIK to kill the pointer entry.
  1. ;
  1. N DIK,DA
  1. ;
  1. S DA=ORLSIEN
  1. S DA(1)=ORLGIEN
  1. S DIK="^GMR(123.5,"_DA(1)_","_ORLGSTR_","
  1. ;
  1. ; Wrap locking functionality around call to DIK:
  1. L +(^GMR(123.5,ORLGIEN)):0
  1. D ^DIK ; User terminated, so call regardless of lock success.
  1. L -(^GMR(123.5,ORLGIEN))
  1. I ORLTASK D MES^XPDUTL("Pointer to team IEN "_ORLTEAM_" removed from file 123.5, field "_ORLGSTR_" - service IEN "_ORLGIEN_".") ; Installation message to run under Taskman.
  1. ;
  1. Q
  1. ;