| 1 | PRSARC04 ;WOIFO/JAH - Recess Tracking Functions ;11/1/06
 | 
|---|
| 2 |  ;;4.0;PAID;**112**;Sep 21, 1995;Build 54
 | 
|---|
| 3 |  ;;Per VHA Directive 2004-038, this routine should not be modified.
 | 
|---|
| 4 |  Q
 | 
|---|
| 5 | GETFSCYR(PRSDT) ; Given a date get the 9-month AWS fiscal year.
 | 
|---|
| 6 |  ; This is the fiscal year during which the 9-month AWS is effective.
 | 
|---|
| 7 |  ; The fiscal year for 2006 (FY06, sometimes written FY05-06) is from
 | 
|---|
| 8 |  ; October 1, 2005 through September 30, 2006.  However, the fiscal
 | 
|---|
| 9 |  ; year for purposes of the 9-month AWS will be governed also by
 | 
|---|
| 10 |  ; complete pay periods, since the nurses normal hours=80 and duty
 | 
|---|
| 11 |  ; basis = part-time, must be in effect for the entire pay period.
 | 
|---|
| 12 |  ; Thus some 9-month AWS fiscal years may have 50, 52 or 54 weeks. 
 | 
|---|
| 13 |  ; The fiscal year is defined as the 12 months from the first full
 | 
|---|
| 14 |  ; pay period after October 1 through the pay period that contains
 | 
|---|
| 15 |  ; September 30.  In the example below September 30, 2007 is the
 | 
|---|
| 16 |  ; first day of the pay period 20 and thus the entire pay period is
 | 
|---|
| 17 |  ; included in the weeks for the 9-month AWS schedule for FY07. 
 | 
|---|
| 18 |  ;          
 | 
|---|
| 19 |  ;            Week    PayPd Sun Mon Tue Wed Thu Fri Sat
 | 
|---|
| 20 |  ;          
 | 
|---|
| 21 |  ;                    =============Oct 2006============
 | 
|---|
| 22 |  ;              1     06-20   1   2   3   4   5   6   7
 | 
|---|
| 23 |  ;              2             8   9  10  11  12  13  14
 | 
|---|
| 24 |  ;              3     06-21  15  16  17  18  19  20  21
 | 
|---|
| 25 |  ;              ...
 | 
|---|
| 26 |  ;          
 | 
|---|
| 27 |  ;             51     07-19  16  17  18  19  20  21  22
 | 
|---|
| 28 |  ;             52            23  24  25  26  27  28  29
 | 
|---|
| 29 |  ;             53     07-20  30   1   2   3   4   5   6
 | 
|---|
| 30 |  ;                    =============Oct 2007============
 | 
|---|
| 31 |  ;             54             7   8   9  10  11  12  13
 | 
|---|
| 32 |  ;
 | 
|---|
| 33 |  ; Get pay period with PRSDT and the 1st day of that pp
 | 
|---|
| 34 |  N X1,X2,%H,X,D1,PPE,YR,DAY,TMPYR,FFPPE,PPE,FISCALYR,PPDT1,FY1,FY2,FYLONG
 | 
|---|
| 35 |  S D1=PRSDT D PP^PRSAPPU
 | 
|---|
| 36 |  S FFPPE=PPE
 | 
|---|
| 37 |  S X2=(1-DAY),X1=PRSDT D C^%DTC S PPDT1=X
 | 
|---|
| 38 |  S TMPYR=$E(PPDT1,1,3)
 | 
|---|
| 39 |  S FISCALYR=$S(PPDT1'>(TMPYR_"0930"):TMPYR,1:TMPYR+1)_"0000"
 | 
|---|
| 40 |  S YR=$E(FISCALYR,1,3)
 | 
|---|
| 41 |  S FY1=$E($E(YR,1,3)-1,2,3)
 | 
|---|
| 42 |  S FYLONG=1700+YR
 | 
|---|
| 43 |  S FY2=$E(YR,2,3)
 | 
|---|
| 44 |  Q FISCALYR_"^"_"FY"_FYLONG_"^"_"FY"_FY1_"-"_FY2
 | 
|---|
| 45 |  ;
 | 
|---|
| 46 | FYDAYS(FSCYR) ; Given a fiscal year get the PAID ETA start and stop
 | 
|---|
| 47 |  ; dates (i.e. the first day of the first pay period of the fiscal
 | 
|---|
| 48 |  ; year and the last day of the last pay period in the fiscal year.
 | 
|---|
| 49 |  ; see GETFSCYR for fiscal year info
 | 
|---|
| 50 |  ;
 | 
|---|
| 51 |  Q:($G(FSCYR)'>1992)!($G(FSCYR)>2106) "input date out of range"
 | 
|---|
| 52 |  ;
 | 
|---|
| 53 |  N X1,X2,%H,X,D1,PPE,DAY,END,START,ENDPPE,FYENDT,FYSTDT,STRTPPE
 | 
|---|
| 54 |  ;
 | 
|---|
| 55 |  ; The start pay period can't contain the date Sept 30.
 | 
|---|
| 56 |  ;
 | 
|---|
| 57 |  S START=FSCYR-1701
 | 
|---|
| 58 |  S D1=START_"0930" D PP^PRSAPPU
 | 
|---|
| 59 |  S X2=(15-DAY),X1=D1 D C^%DTC S FYSTDT=X
 | 
|---|
| 60 |  S D1=FYSTDT D PP^PRSAPPU
 | 
|---|
| 61 |  S STRTPPE=PPE
 | 
|---|
| 62 |  ;
 | 
|---|
| 63 |  ; the end pay period must contain sept 30
 | 
|---|
| 64 |  ;
 | 
|---|
| 65 |  S END=FSCYR-1700
 | 
|---|
| 66 |  S D1=END_"0930" D PP^PRSAPPU
 | 
|---|
| 67 |  S ENDPPE=PPE
 | 
|---|
| 68 |  S X2=(14-DAY),X1=D1 D C^%DTC S FYENDT=X
 | 
|---|
| 69 |  ;
 | 
|---|
| 70 |  Q FYSTDT_"^"_FYENDT_"^"_STRTPPE_"^"_ENDPPE
 | 
|---|
| 71 |  ;
 | 
|---|
| 72 | GETPPDY(PRSDT) ; Given FM date--PRSDT--Get pay period + 1st day of that pp
 | 
|---|
| 73 |  N X1,X2,%H,X,D1,PPE,PPD1
 | 
|---|
| 74 |  S D1=PRSDT D PP^PRSAPPU
 | 
|---|
| 75 |  S FFPPE=PPE
 | 
|---|
| 76 |  S X2=(1-DAY),X1=PRSDT D C^%DTC S PPD1=X
 | 
|---|
| 77 |  Q PPD1_U_PPE
 | 
|---|
| 78 |  ;
 | 
|---|
| 79 | ALLFYAWS() ; Ask user if AWS will cover the entire Fiscal Year
 | 
|---|
| 80 |  N DIR,X,Y,DTOUT,DUOUT,DIRUT,DIROUT,FY
 | 
|---|
| 81 |  S DIR(0)="Y"
 | 
|---|
| 82 |  S DIR("B")="NO"
 | 
|---|
| 83 |  S DIR("A")="Does the AWS cover the entire fiscal year"
 | 
|---|
| 84 |  S DIR("?")="Enter Y for Yes or N for No."
 | 
|---|
| 85 |  S DIR("?",1)="  If the Nurse is starting the fiscal year on the"
 | 
|---|
| 86 |  S DIR("?",2)="  9 Month AWS then answer YES.  If they are starting"
 | 
|---|
| 87 |  S DIR("?",3)="  the AWS in a pay period after the 1st pay period"
 | 
|---|
| 88 |  S DIR("?",4)="  of the fiscal year then answer NO."
 | 
|---|
| 89 |  D ^DIR
 | 
|---|
| 90 |  Q:$D(DIRUT) -1
 | 
|---|
| 91 |  Q Y
 | 
|---|
| 92 |  ; 
 | 
|---|
| 93 |  ;
 | 
|---|
| 94 |  ;
 | 
|---|
| 95 | FYWEEKS(WKARRAY,FY,SD) ; RETURN ARRAY WITH WEEKS
 | 
|---|
| 96 |  ; INPUT:
 | 
|---|
| 97 |  ;   FY - fiscal year in 4 digit format
 | 
|---|
| 98 |  ;   SD - (optional) set to 1 if you want week numbers in the subscript
 | 
|---|
| 99 |  ;        otherwise subscript will be fmdates.
 | 
|---|
| 100 |  ;
 | 
|---|
| 101 |  N FD,LD,PRSFYRNG
 | 
|---|
| 102 |  ;
 | 
|---|
| 103 |  ; get range of dates for FY (PRS
 | 
|---|
| 104 |  ; cleaned up at exit from LM)
 | 
|---|
| 105 |  ;
 | 
|---|
| 106 |  S PRSFYRNG=$$FYDAYS(FY)
 | 
|---|
| 107 |  ;
 | 
|---|
| 108 |  S FD=$P(PRSFYRNG,U,1)
 | 
|---|
| 109 |  S LD=$P(PRSFYRNG,U,2)
 | 
|---|
| 110 |  ; Build an array with FMdate for first day of each week in the FY
 | 
|---|
| 111 |  ;
 | 
|---|
| 112 |  D WKSDAY1(.WKARRAY,FD,LD,$G(SD))
 | 
|---|
| 113 |  Q
 | 
|---|
| 114 |  ;
 | 
|---|
| 115 | GETAVHRS(FMWKS,PRSDT) ; calculate the number of weeks in the AWS fiscal year
 | 
|---|
| 116 |  ; from the input date and the hours available for recess from that
 | 
|---|
| 117 |  ; date
 | 
|---|
| 118 |  ; INPUT: PRSDT-must be a first day of a pay period in the input array
 | 
|---|
| 119 |  ;        FMWKS-array produced from FYWEEKS call in this routine.
 | 
|---|
| 120 |  ; OUTPUT: 
 | 
|---|
| 121 |  ;  # of FY weeks from PRSDT ^ available recess hrs ^ avail recess weeks
 | 
|---|
| 122 |  ;
 | 
|---|
| 123 |  N FRSTWK,LASTWK,WKS,HRS,AVWKS
 | 
|---|
| 124 |  Q:'$D(FMWKS($G(PRSDT))) 0
 | 
|---|
| 125 |  S FRSTWK=$G(FMWKS(PRSDT))
 | 
|---|
| 126 |  S LASTWK=$O(FMWKS(9999999),-1),LASTWK=$G(FMWKS(LASTWK))
 | 
|---|
| 127 |  S WKS=LASTWK-FRSTWK+1
 | 
|---|
| 128 |  S HRS=WKS*40*.25
 | 
|---|
| 129 |  S AVWKS=WKS*.25
 | 
|---|
| 130 |  Q WKS_U_HRS_U_AVWKS
 | 
|---|
| 131 |  ;
 | 
|---|
| 132 |  ;
 | 
|---|
| 133 | WKSDAY1(WKARRAY,FD,LD,SF) ;Build FY week array
 | 
|---|
| 134 |  ;
 | 
|---|
| 135 |  ; INPUT FD = fm first day of ETA type fiscal year (i.e. Sunday of pp)
 | 
|---|
| 136 |  ;       LD = last day ETA fiscal year
 | 
|---|
| 137 |  ;       SF = optional subscript flag = 1 use week otherwise use FMDAY
 | 
|---|
| 138 |  ;
 | 
|---|
| 139 |  ; OUTPUT WKARRAY = ARRAY for weeks in a Fiscal Year with
 | 
|---|
| 140 |  ;                 (Subscript) = FMdate 
 | 
|---|
| 141 |  ;                     Value   = FY WEEK of 1st day of week.
 | 
|---|
| 142 |  ;
 | 
|---|
| 143 |  N SUBS,WKD1,WEEK,X1,X2,X,VALUE
 | 
|---|
| 144 |  I $G(SF)=1 S SUBS="WEEK",VALUE="WKD1"
 | 
|---|
| 145 |  E  S SUBS="WKD1",VALUE="WEEK"
 | 
|---|
| 146 |  S WKD1=FD,WEEK=1
 | 
|---|
| 147 |  F  D  Q:WKD1>$G(LD)
 | 
|---|
| 148 |  .  S WKARRAY(@SUBS)=@VALUE
 | 
|---|
| 149 |  .  S WEEK=WEEK+1
 | 
|---|
| 150 |  .  S X2=7,X1=WKD1 D C^%DTC S WKD1=X
 | 
|---|
| 151 |  Q
 | 
|---|
| 152 | ALLOKEY(PRSNURSE) ; Allocate security key to the NURSE if they don't hold it
 | 
|---|
| 153 |  ;
 | 
|---|
| 154 |  ; determine associated NEW PERSON entry
 | 
|---|
| 155 |  Q:+$G(PRSNURSE)'>0
 | 
|---|
| 156 |  Q:'$O(^PRST(458.8,"B",+PRSNURSE,0))
 | 
|---|
| 157 |  N SSN,IEN200
 | 
|---|
| 158 |  S SSN=$$GET1^DIQ(450,+PRSNURSE_",",8,"I")
 | 
|---|
| 159 |  S IEN200=$S(SSN="":"",1:$O(^VA(200,"SSN",SSN,0)))
 | 
|---|
| 160 |  I 'IEN200 D  Q
 | 
|---|
| 161 |  . W $C(7),!!,"Can't find this nurse in the NEW PERSON file.  This must"
 | 
|---|
| 162 |  . W !,"be corrected before they can view their schedule and the"
 | 
|---|
| 163 |  . W !,"PRSAWS9 security key may need to be allocated to this nurse."
 | 
|---|
| 164 |  . S SSN=$$ASK^PRSLIB00(1)
 | 
|---|
| 165 |  ;
 | 
|---|
| 166 |  I '$D(^XUSEC("PRSAWS9",IEN200)) D
 | 
|---|
| 167 |  . W !,"... allocating PRSAWS9 security key for this nurse." H 1 W !!
 | 
|---|
| 168 |  . N KEYIEN,PRSFDA,PRSIENS
 | 
|---|
| 169 |  . S KEYIEN=$$FIND1^DIC(19.1,,"X","PRSAWS9")
 | 
|---|
| 170 |  . I 'KEYIEN D  Q
 | 
|---|
| 171 |  . . W !!,"The PRSAWS9 key is missing from file 19.1."
 | 
|---|
| 172 |  . S PRSFDA(200.051,"?+1,"_IEN200_",",.01)=KEYIEN
 | 
|---|
| 173 |  . S PRSIENS(1)=KEYIEN
 | 
|---|
| 174 |  . D UPDATE^DIE("","PRSFDA","PRSIENS"),MSG^DIALOG()
 | 
|---|
| 175 |  ;
 | 
|---|
| 176 |  Q
 | 
|---|