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

SCAPMC28.m

Go to the documentation of this file. 
  1. SCAPMC28 ;ALB/REW - Patients with an Appointment ; 1/10/05 2:49pm
  1.  ;;5.3;Scheduling;**41,140,346,564**;AUG 13, 1993;Build 8
  1.  ;;1.0
  1. PTAP(SCCL,SCDATES,SCMAXCNT,SCLIST,SCERR,MORE) ; -- list of patients with an appointment in a given clinic
  1.  ; 
  1.  ; input:
  1.  ;  SCCL = Pointer to File #44
  1.  ;  SCDATES("BEGIN") = begin date to search (inclusive)
  1.  ;                      [default: TODAY]
  1.  ;        ("END")   = end date to search (inclusive)
  1.  ;                      [default: TODAY]
  1.  ;        ("INCL")  = 1: only use patients who were assigned to
  1.  ;                       team for entire date range
  1.  ;                    0: anytime in date range
  1.  ;                      [default: 1] 
  1.  ;  SCMAXCNT        - Maximum # of patients to return, default=99
  1.  ;  SCLIST -array name to store list
  1.  ;          [ex. ^TMP("SCPT",$J)]
  1.  ;        
  1.  ;  SCERR = array NAME to store error messages.
  1.  ;          [ex. ^TMP("ORXX",$J)]
  1.  ;  MORE - This is a flag that says that this list exists and has been
  1.  ;         aborted because it reached the maxcount.  If this =1 it means
  1.  ;         'kill the old list & start where you finished'
  1.  ;  Note: Don't Return DFNs where $D(^TMP("SCMC",$J,"EXCLUDE PT","SCPTA",+DFN)) is true
  1.  ; Output:
  1.  ;  SCLIST() = array of patients
  1.  ;             Format:
  1.  ;               Subscript: Sequential # from 1 to n
  1.  ;               Piece     Description
  1.  ;                 1       IEN of PATIENT file entry
  1.  ;                 2       Name of patient
  1.  ;                 3       ien to 40.7 - Not Stop Code!! stp=$$intstp
  1.  ;                 4       AMIS reporting stop code
  1.  ;                 5       Patient's Long ID (SSN)
  1.  ;
  1.  ; SCEFFDT - negative of effective date
  1.  ; SCN     - current subscript (counter) 1->n
  1.  ; SCPTA0   is 0 node of Patient Team Assignment file 1st piece is DFN
  1.  ;  SCERR() = Array of DIALOG file messages(errors) .
  1.  ;  @SCERR@(0)=number of errors, undefined if none
  1.  ;             Foramt:
  1.  ;               Subscript: Sequential # from 1 to n
  1.  ;               Piece     Description
  1.  ;                 1       IEN of DIALOG file
  1.  ;
  1.  ;   Returned: 1 if ok, 0 if error^More?
  1.  ;
  1.  ;
  1. ST N SCEND,SCVSDT,SCSTART
  1.  N SCLSEQ,SCN,SCESEQ,SCPARM,SCP,SCBEGIN,SCEND,SCINCL,SCDTS
  1.  G:'$$OKDATA APQ ;check/setup variables
  1.  ; -- loop through visit file
  1. LP S SCDT=SCBEGIN
  1.  S:'$P(SCEND,".",2) SCEND=$$FMADD^XLFDT(SCEND,1) ;ending is end of day
  1.  IF $G(MORE) D
  1.  .S SCSTART=$P($G(@SCLIST@(0)),U,2)
  1.  .S SCBEGIN=$P($G(@SCLIST@(0)),U,3)
  1.  .K @SCLIST
  1. APQ Q $$PTAPX(.SCCL,.SCBEGIN,.SCEND,.SCMAXCNT,.SCLIST,.SCERR,.SCSTART)
  1.  ;
  1. PTAPX(SCCL,SCBEGIN,SCEND,MAXCNT,SCLIST,SCERR,SCSTART) ;return appointments in dt range
  1.  ; Input: (As above plus:)
  1.  ;    SCSTART - Continue with list at this point
  1.  ; output: SCN - COUNT OF PTS
  1.  ; returns:      dfn^ptname^clinic^apptdt^long id
  1.  ; 
  1.  ;initialize variables
  1.  N SCDT,SCARRAY,DFN,SDAPTCNT,SDARRAY,SDERR,SDX,SDY
  1.  K ^TMP($J,"SDAMA301")
  1.  ;setup call to SDAPI
  1.  ;filter for OUTPATIENT ENCOUNTER (OE) pointer for only "KEPT" appointment- sd/564
  1.  ;include field 12 - pointer to OE file
  1.  S SDARRAY(1)=$G(SCBEGIN)_";"_$G(SCEND),SDARRAY(2)=$G(SCCL),SDARRAY("FLDS")="4;12"
  1.  S SDARRAY("SORT")="P"
  1.  ;call SDAPI to retrieve appointments
  1.  S SDAPTCNT=$$SDAPI^SDAMA301(.SDARRAY)
  1.  ;handle errors if any returned from SDAPI and QUIT
  1.  I SDAPTCNT<0 D  Q ($G(@SCERR@(0))<1)_U_(SCN'<SCMAXCNT)
  1.  .;call existing error handler
  1.  .D ERR^SCAPMCU1(.SCESEQ,,,"",.SCERR)
  1.  .K ^TMP($J,"SDAMA301")
  1.  ;if appointments returned 
  1.  I SDAPTCNT>0 D
  1.  .;retrieve patient ID to start at if continuing list (was appt ifn)
  1.  .; * no code could be found to utilize continuation of a list
  1.  .; * if this changes this code should be revisited to ensure only 1
  1.  .;   call to SDAPI is made.
  1.  .S DFN=+$G(SCSTART)
  1.  .S SCSTART=0
  1.  .S SCDT=0
  1.  .;resort appts to ensure same data is returned to user
  1.  .;only 1st appt date/time is needed for each patient
  1.  .;as patient can only be added to the list once.
  1.  .K ^TMP($J,"RE-SORT","SDAMA301")
  1.  .;
  1.  .;identify appointment entries without pointers to OE to exclude them - SD/564
  1.  .S (SDY,SDX)=0
  1.  .F  S SDX=$O(^TMP($J,"SDAMA301",SDX)) Q:'SDX  D
  1.  ..S SDY="" F  S SDY=$O(^TMP($J,"SDAMA301",SDX,SDY)) Q:SDY=""  D
  1.  ...;eliminate not kept appointments; no entry in OUTPATIENT ENCOUNTER
  1.  ...I $P(^TMP($J,"SDAMA301",SDX,SDY),U,12)="" K ^TMP($J,"SDAMA301",SDX,SDY)
  1.  .;
  1.  .S (SDY,SDX)=0
  1.  .F  S SDX=$O(^TMP($J,"SDAMA301",SDX)) Q:'SDX  D
  1.  ..S SDY=$O(^TMP($J,"SDAMA301",SDX,""))
  1.  ..S ^TMP($J,"RE-SORT","SDAMA301",SDY,SDX)=""
  1.  .K ^TMP($J,"SDAMA301")
  1.  .;loop through re-sorted appts returned from SDAPI until
  1.  .; 1. no more patients with appointments exist
  1.  .; 2. number of patients found that match criteria is not less than max
  1.  .F  S SCDT=$O(^TMP($J,"RE-SORT","SDAMA301",SCDT)) Q:'SCDT!(SCN'<SCMAXCNT)  D
  1.  ..;get patient for the kept appointment in the re-sorted list
  1.  ..F  S DFN=$O(^TMP($J,"RE-SORT","SDAMA301",SCDT,DFN)) Q:'DFN!(SCN'<SCMAXCNT)  D
  1.  ...;quit if patient is found in either of the following lists
  1.  ...;this list may be used elsewhere, left in for compatibility
  1.  ...Q:$D(@SCLIST@("SCPTAP",+DFN))
  1.  ...Q:$D(^TMP("SCMC",$J,"EXCLUDE PT","SCPTA",+DFN))
  1.  ...;increment the patient counter and store in SCLIST
  1.  ...S SCN=$G(@SCLIST@(0))+1
  1.  ...S @SCLIST@(0)=SCN
  1.  ...;get the patient's long ID (SSN) and Name
  1.  ...D GETS^DIQ(2,+DFN,".01;.363","","SCARRAY")
  1.  ...;add the following appt info to SCLIST at the current Patient Counter
  1.  ...;1. Patient DFN 2. Patient Name 3. Clinic IEN 4. Appt DTM 5. Patients Long ID
  1.  ...S @SCLIST@(SCN)=DFN_U_$G(SCARRAY(2,+DFN_",",.01))_U_SCCL_U_SCDT_U_$G(SCARRAY(2,+DFN_",",.363))
  1.  ...;add the patient's DFN to the exclusion list
  1.  ...S @SCLIST@("SCPTAP",+DFN,+SCN)=""
  1.  ;kill the re-sorted appt global reference generated
  1.  K ^TMP($J,"RE-SORT","SDAMA301")
  1.  ;if # of patients found that match criteria is NOT LESS than the requested Max then
  1.  ;set SCLIST at the 0 Node to:
  1.  ;1.Current Patient Count 2. Current Patient Processing 3. Appt DTM 4. Clinic IEN
  1.  S:(SCN'<SCMAXCNT) @SCLIST@(0)=SCN_U_+$G(DFN)_U_+$G(SCDT)_U_+$G(SCCL)
  1.  Q ($G(@SCERR@(0))<1)_U_(SCN'<SCMAXCNT)
  1.  ;
  1. OKDATA() ;check/setup variables
  1.  N SCOK
  1.  S SCOK=1
  1.  S SCMAXCNT=$G(SCMAXCNT,99)
  1.  D INIT^SCAPMCU1(.SCOK) ; set default dates & error array (if undefined)
  1.  IF '$D(^SC(+$G(SCCL),0)) D  S SCOK=0
  1.  . S SCPARM("CLINIC")=$G(SCCL,"Undefined")
  1.  . D ERR^SCAPMCU1(.SCESEQ,4045101,.SCPARM,"",.SCERR)
  1.  ; -- is it a valid TEAM ien passed (Error # 4045101 in DIALOG file)
  1.  Q SCOK