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

PRSAOTT.m

Go to the documentation of this file.
  1. PRSAOTT ;WCIOFO/JAH/PLT- 8B CODES ARRAY. COMPARE OT (8B-vs-APPROVED). ;11/29/2006
  1. ;;4.0;PAID;**37,43,54,112**;Sep 21, 1995;Build 54
  1. ;;Per VHA Directive 2004-038, this routine should not be modified.
  1. ;
  1. ;Function & subroutine Index for this routine.
  1. ;
  1. ; APOTWEEK(PAYPRD,WEEKID,EMP450).....return all approved OT in a week.
  1. ; ARRAY8B(RECORD)...............Build employee 8B array for payperiod.
  1. ; CODES(WEEK)........return string of valid time codes for week 1,2,3.
  1. ; GET8BCDS(TT8B).................return timecode portion of 8B string.
  1. ; GET8BOT(EMPIEN,WEEK,TT8B)..........return all OT in an 8b string.
  1. ; GETOTS(PP,EI,T8,WK,.O8,.OA)......Get overtimes (tt8b & approved).
  1. ; OTREQ(REC).................returns true if Request is type Overtime.
  1. ; OTAPPR(REC)...................returns true if a Request is Approved.
  1. ; WEEKRNG(PPE,WEEK,FIRST,LAST)........1st & last FM days in a pp week.
  1. ; WARNSUP(PPE,EI,E8B,WK,OTERR,O8,OA)... check ot's for a week & warn.
  1. Q
  1. ;= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  1. GETOTS(PP,EI,T8,WK,O8,OA) ;Get overtimes (tt8b & approved)
  1. ; Sample call:
  1. ; D GETOTS("98-05",1255,TT8BSTRING,1,.O8,.OA)
  1. ; where TT8BSTRING might be =
  1. ; "658229548868WIL 8B268380A106 AN320NA060DA030NR300SE080CD000790"
  1. ;
  1. ; subroutine returns overtime from request file & TT8B string for
  1. ; week specified in parameter 4
  1. ;
  1. ; Input: PP - Pay period in format YY-PP.
  1. ; EI - Employees ien from file 450.
  1. ; T8 - Entire 8B record. Stored in
  1. ; ^PRST(458,PP,"E",EI,5).
  1. ; Output: O8 - TT8B overtime calculated
  1. ; OA - approved overtime in request fiLE
  1. ;
  1. S (OA,O8)=0
  1. Q:((WK'=1)&(WK'=2))
  1. ;
  1. S O8=$$GET8BOT^PRSAOTT(EI,WK,T8) ; get all OT from 8b string
  1. S OA=$$APOTWEEK^PRSAOTT(PP,WK,EI) ; get approved overtime
  1. Q
  1. ;
  1. ;= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  1. WARNSUP(PPE,EI,E8B,WK,OTERR,O8,OA) ;Gets overtime from request
  1. ; file & TT8B string & displays warning if 8B string has more
  1. ; OT than approved requests.
  1. ;
  1. ;Input: PPE - (P)ay (P)eriod (E)xternal in format YY-PP.
  1. ; EI - (E)mployees (I)nternal entry # from file 450.
  1. ; E8B - (E)ntire (8B) record. Stored in ^PRST(458,PP,"E",EI,5).
  1. ; WK - week number 1 or 2 of pay period.
  1. ;Output: Warning message to screen.
  1. ;Local: OA - (O)vertime (A)pproved from requests file.
  1. ; O8 - (O)vertime totaled from (8)b string.
  1. ;
  1. S (OA,O8,OTERR)=0
  1. ; Compare week of approved ot requests to 8B OT.
  1. S O8=$$GET8BOT(EI,WK,E8B) ; get all OT from 8b string
  1. S OA=$$APOTWEEK(PPE,WK,EI) ; get approved overtime
  1. I OA<O8 D DISPLAY(EI,O8,OA,WK) S OTERR=1 ; Display warning if calc>apprv
  1. Q
  1. ;
  1. ;= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  1. DISPLAY(IEN,OT8B,OTRQ,WK) ;Output warning message. 8b ot > approved ot.
  1. ;
  1. ; Input: IEN - employees 450 ien.
  1. ; OT8B - employees total overtime calculated from 8b string.
  1. ; OTRQ - employees total approved OT request's from 458.2
  1. ; WK - week 1 or 2 of payperiod.
  1. ;
  1. W !,?3,"WARNING: Week ",WK," -Overtime being paid (",OT8B,") is more than approved (",OTRQ,")."
  1. Q
  1. ;
  1. ;= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  1. GET8BOT(EMPIEN,WEEK,TT8B) ;
  1. ; Output: Function returns total hrs of overtime that is coded
  1. ; into TT8B string for either week (1) or (2).
  1. ; Input: EMPIEN - internal entry # of employee to check 8B overtime
  1. ; WEEK - week (1) or (2) of pay period to check 8B overtime.
  1. ; TT8B - full 8B string stub & values.
  1. ;
  1. N PPIEN,TT8BOT,OTCODES,CODE,OTTOTAL,OTTMP
  1. S OTTOTAL=0
  1. ;
  1. ; get time coded portion of 8B string
  1. ;
  1. S TT8B=$$GET8BCDS(TT8B)
  1. Q:$L(TT8B)<2 OTTOTAL ; Aint no coded OT if there aint no codes.
  1. ;
  1. ; create array of codes & values for this 8b string.
  1. D ARRAY8B(TT8B)
  1. ;
  1. ; create string with all overtime codes.
  1. S OTCODES=$S(WEEK=1:"^DA^DB^DC^OA^OB^OC^OK^",1:"^DE^DF^DG^OE^OF^OG^OS^")
  1. ; Only count total regular hours @ OT rate when not a firefighter
  1. ; with premium pay code "R" or "C". These firefighters get RA/RE from
  1. ; their scheduled tour and do not need to have overtime requests. *54
  1. I "^R^C^"'[(U_$P($G(^PRSPC(EMPIEN,"PREMIUM")),U,6)_U) D
  1. . S OTCODES=OTCODES_$S(WEEK=1:"RA^RB^RC^",1:"RE^RF^RG^")
  1. ;
  1. ; loop thru employees 8b array to see if they have any of
  1. ; overtime codes & add any of them up.
  1. ;
  1. S CODE=""
  1. F S CODE=$O(TT8B(WEEK,CODE)) Q:CODE="" D
  1. . I OTCODES[("^"_CODE_"^") D
  1. .. S OTTMP=TT8B(WEEK,CODE)
  1. .. S OTTOTAL=OTTOTAL+$E(OTTMP,1,2)+($E(OTTMP,3)*.25)
  1. Q OTTOTAL
  1. ;
  1. ;= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  1. ;
  1. APOTWEEK(PAYPRD,WEEKID,EMP450) ;
  1. ;Function returns approved overtime totals for a week.
  1. ;Input: PPE,PAYPRD - pay period of concern. YY-PP
  1. ; WEEKID - week (1) or week (2) of pay period
  1. ; EMP450 - employees internal entry number in file 450.
  1. ;Output: TOTALOT - total hrs of overtime for a week
  1. ;
  1. ;local vars: D1 - 1st day of payperiod-returned by NX^PRSAPPU
  1. ; OTREC - a record containing 1 overtime request.
  1. ; START,STOP - 1st & last FM days of week (Sun,Sat)
  1. ;
  1. ; quit returning 0 if anything is missing.
  1. Q:$G(PAYPRD)=""!$G(WEEKID)=""!$G(EMP450)="" 0
  1. ;
  1. ; Loop thru OT/CT requests file x-ref on requested work date &
  1. ; add up all employees approved OT requests within week.
  1. ;
  1. N D1,PPE,TOTALOT,START,STOP,OTREC
  1. S TOTALOT=0
  1. D WEEKRNG(PAYPRD,WEEKID,.START,.STOP)
  1. S D1=START-.1
  1. F S D1=$O(^PRST(458.2,"AD",EMP450,D1)) Q:D1>STOP!(D1="") D
  1. . S OTREC=""
  1. . F S OTREC=$O(^PRST(458.2,"AD",EMP450,D1,OTREC)) Q:OTREC="" D
  1. .. I $$OTREQ(OTREC),$$OTAPPR(OTREC) D
  1. ... S TOTALOT=TOTALOT+$P($G(^PRST(458.2,OTREC,0)),"^",6)
  1. Q TOTALOT
  1. ;= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  1. OTREQ(REC) ;Function returns true if Request is type Overtime.
  1. Q:$G(REC)="" 0
  1. Q $P($G(^PRST(458.2,REC,0)),"^",5)="OT"
  1. ;= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  1. OTAPPR(REC) ;Function returns true if a Request is Approved.
  1. Q:$G(REC)="" 0
  1. Q "AS"[$P($G(^PRST(458.2,REC,0)),"^",8)
  1. ;= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  1. WEEKRNG(PPE,WEEK,FIRST,LAST) ;
  1. ;
  1. ; Routine takes a pay period & a week number & returns
  1. ; 1st & last FileMan days of specified week.
  1. ; Input: PPE - pay period in format YY-PP.
  1. ; WEEK - week (1) or (2).
  1. ; Output: .FIRST - first day of specified week-FM format
  1. ; .LAST - last day of specified week-FM format
  1. N D1,X1,X2,PPD1
  1. D NX^PRSAPPU S PPD1=D1
  1. I WEEK=1 D
  1. . S (FIRST,X1)=PPD1,X2=6 D C^%DTC S LAST=X
  1. E D
  1. . S X1=PPD1,X2=7 D C^%DTC S FIRST=X
  1. . S X1=PPD1,X2=13 D C^%DTC S LAST=X
  1. Q
  1. ;
  1. ;= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  1. GET8BCDS(TT8B) ; GET 8B time CoDeS
  1. ; Input: Full 8b record as stored on node 5 of employee record
  1. ; in time & attendance file.
  1. ; Output: Function returns section of 8b record with pay
  1. ; codes & values.
  1. ;
  1. ; i.e. return last portion of 8b record ----- <<AN280AL120CD00040>>
  1. ; ^PRST(458,,"E",,5)=658226944741FLI 8B256280A112 AN280AL120CD00040
  1. ;
  1. ; Input: FULL 8B RECORD
  1. ;
  1. Q $E(TT8B,33,$L(TT8B))
  1. ;
  1. ;= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  1. ARRAY8B(RECORD) ; Build employee 8B array.
  1. ; calls to this routine are responsible for cleaning up TT8B( array.
  1. ;
  1. ; Build a TT8B array which contains ONLY codes & values
  1. ; that are in employees 8B record.
  1. ;
  1. ; Input: RECORD - last portion of 8B array with codes & values.
  1. ; e.g. <<AN280AL120CD00040>> (see GET8BCDS^PRSAOTT)
  1. ;
  1. ; Output: array subscripted by time code & set equal to value.
  1. ; e.g. TT8B(1,"AN")=010
  1. ; TT8B(1,"DA")=020
  1. ; TT8B(1,"NA")=020
  1. ; TT8B(2,"SL")=080
  1. ; TT8B(3,"CD")=000130
  1. ;
  1. K TT8B S TT8B(0)=0
  1. Q:$G(RECORD)=""
  1. N EOR,TYPE,VALUE,LOOP,WK
  1. S EOR=0
  1. F D Q:EOR=1
  1. . S TYPE=$E(RECORD,1,2)
  1. .; I TYPE="CD" S VALUE=$E(RECORD,3,$L(RECORD)) S EOR=1
  1. .;
  1. .;traverse record to next code so LOOP gets len of curr code value
  1. .;
  1. . F LOOP=3:1:$L(RECORD) Q:$E(RECORD,LOOP)?1U
  1. . S:LOOP=$L(RECORD) EOR=1
  1. . S VALUE=$S(EOR=1:$E(RECORD,3,LOOP),1:$E(RECORD,3,LOOP-1))
  1. . S:EOR=0 RECORD=$E(RECORD,LOOP,$L(RECORD))
  1. .;
  1. .;Put code into corresponding week of TT8B array.
  1. .;
  1. . S WK=$S($F($$CODES(1),TYPE):1,$F($$CODES(2),TYPE):2,$F($$CODES(3),TYPE):3,1:"unknown")
  1. . S TT8B(WK,TYPE)=VALUE,TT8B(0)=TT8B(0)+1
  1. Q
  1. ;
  1. ;= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  1. CODES(WEEK) ;
  1. ; 8b string can contain any number of codes. Some of codes
  1. ; are strictly for types of time in week 1 & some are for week 2.
  1. ; There are also pay period codes that are independant from weeks.
  1. ;
  1. ; This function returns a string of codes for specified
  1. ; week (1) or (2) -OR- (3)---8b codes independant of week.
  1. ;
  1. ; Input: WEEK - week (1) (2) of pay period.
  1. ;
  1. Q:$G(WEEK)="" 0
  1. Q:WEEK=1 "AN SK WD NO AU RT CE CU UN NA NB SP SA SB SC DA DB DC TF OA OB OC YA OK OM RA RB RC HA HB HC PT PA ON YD HD VC EA EB TA TC FA FC AD NT RS ND SR SD"
  1. ;
  1. Q:WEEK=2 "AL SL WP NP AB RL CT CO US NR NS SQ SE SF SG DE DF DG TG OE OF OG YE OS OU RE RF RG HL HM HN PH PB CL YH HO VS EC ED TB TD FB FD AF NH RN NU SS SH"
  1. ;
  1. Q:WEEK=3 "NL DW IN TL LU LN LD DT TO LA ML CA PC CY RR FF FE CD"
  1. Q 0