| 1 | SCMSVUT0 ;ALB/ESD HL7 Segment Validation Utilities ; 7/8/04 5:06pm | 
|---|
| 2 | ;;5.3;Scheduling;**44,55,66,132,245,254,293,345,472**;Aug 13, 1993 | 
|---|
| 3 | ; | 
|---|
| 4 | ; | 
|---|
| 5 | CONVERT(SEG,HLFS,HLQ) ; Convert HLQ ("") to null in segment | 
|---|
| 6 | ;      Input:  SEG  = HL7 segment | 
|---|
| 7 | ;             HLFS  = HL7 field separator | 
|---|
| 8 | ;              HLQ  = HL7 "" character | 
|---|
| 9 | ; | 
|---|
| 10 | ;     Output:  SEG  = Segment where HLQ replaced with null | 
|---|
| 11 | ; | 
|---|
| 12 | ; | 
|---|
| 13 | N I | 
|---|
| 14 | F I=1:1:55 I $P(SEG,HLFS,I)=HLQ S $P(SEG,HLFS,I)="" | 
|---|
| 15 | Q SEG | 
|---|
| 16 | ; | 
|---|
| 17 | SETID(SDOE,SDDELOE) ; Set PCE Unique Visit Number in field #.2 of #409.68 | 
|---|
| 18 | ;      Input:   SDOE = IEN of Outpatient Encounter (#409.68) file | 
|---|
| 19 | ;            SDDELOE = IEN of Deleted Outpatient Encounter (#409.74) file | 
|---|
| 20 | ; | 
|---|
| 21 | ;     Output:   Unique Visit Number set in field #.2 of #409.68 | 
|---|
| 22 | ;               or field #.2 of #409.74 | 
|---|
| 23 | ; | 
|---|
| 24 | ; | 
|---|
| 25 | N SDOEC,SDARRY | 
|---|
| 26 | S SDOEC=0 | 
|---|
| 27 | S SDOE=+$G(SDOE) | 
|---|
| 28 | S SDDELOE=+$G(SDDELOE) | 
|---|
| 29 | ; | 
|---|
| 30 | ;-Outpatient Enc pointer passed in; use file #409.68 | 
|---|
| 31 | S SDARRY="^SCE("_SDOE_",0)" | 
|---|
| 32 | ; | 
|---|
| 33 | ;-Deleted Outpatient Enc pointer passed in; use file #409.74 | 
|---|
| 34 | S:(SDDELOE) SDARRY="^SD(409.74,"_SDDELOE_",1)" | 
|---|
| 35 | ; | 
|---|
| 36 | ;-Quit if no encounter record or deleted encounter record | 
|---|
| 37 | Q:($G(@SDARRY)="") | 
|---|
| 38 | ;-Add unique ID to parent | 
|---|
| 39 | D GETID | 
|---|
| 40 | ; | 
|---|
| 41 | ;-Add unique ID to children for Outpatient Enc only (quit if no child encounter record) | 
|---|
| 42 | I (SDOE) F  S SDOEC=+$O(^SCE("APAR",SDOE,SDOEC)) Q:'SDOEC  S SDARRY="^SCE("_SDOEC_",0)" Q:($G(@SDARRY)="")  D GETID | 
|---|
| 43 | Q | 
|---|
| 44 | ; | 
|---|
| 45 | GETID ;Get unique visit ID | 
|---|
| 46 | S:$P($G(@SDARRY),"^",20)="" $P(@SDARRY,"^",20)=$$IEN2VID^VSIT($P(@SDARRY,"^",5)) | 
|---|
| 47 | Q | 
|---|
| 48 | ; | 
|---|
| 49 | SETPRTY(SDOE) ;Set outpatient provider type in field #.06 of V PROVIDER | 
|---|
| 50 | ;      Input:  SDOE = IEN of Outpatient Encounter (#409.68) file | 
|---|
| 51 | ; | 
|---|
| 52 | ;     Output:  Provider Type set in field #.06 of V PROVIDER | 
|---|
| 53 | ; | 
|---|
| 54 | ; | 
|---|
| 55 | N SDPRTYP,SDVPRV,SDPRVS | 
|---|
| 56 | S SDOE=+$G(SDOE),SDVPRV=0 | 
|---|
| 57 | ; | 
|---|
| 58 | ;- Get all provider IENs for encounter | 
|---|
| 59 | D GETPRV^SDOE(SDOE,"SDPRVS") | 
|---|
| 60 | F  S SDVPRV=+$O(SDPRVS(SDVPRV)) Q:'SDVPRV  D | 
|---|
| 61 | . S SDPRTYP=0 | 
|---|
| 62 | . ; | 
|---|
| 63 | . ;- If no prov type, call API and add provider type to record | 
|---|
| 64 | . S:$P(SDPRVS(SDVPRV),"^",6)="" SDPRTYP=$$GET^XUA4A72(+SDPRVS(SDVPRV),+$G(^SCE(SDOE,0))) | 
|---|
| 65 | . I +$G(SDPRTYP)>0 D PCLASS^PXAPIOE(SDVPRV) | 
|---|
| 66 | Q | 
|---|
| 67 | ; | 
|---|
| 68 | SETMAR(PIDSEG,HLQ,HLFS) ; Set marital status prior to PID segment validation | 
|---|
| 69 | ;Input:   PIDSEG = Array containing PID segment (pass by reference) | 
|---|
| 70 | ;                  PIDSEG = First 245 characters | 
|---|
| 71 | ;                  PIDSEG(1..n) = Continuation nodes | 
|---|
| 72 | ;            HLQ = HL7 null variable | 
|---|
| 73 | ;           HLFS = HL7 field separator | 
|---|
| 74 | ;Output:  Marital status changed from null to "U" (UNKNOWN) prior to | 
|---|
| 75 | ;         validation of PID segment and transmittal to AAC | 
|---|
| 76 | ;Note: Assumes all input exists and is valid | 
|---|
| 77 | ; | 
|---|
| 78 | ;Declare variables | 
|---|
| 79 | N REBLD,TMPARR,X | 
|---|
| 80 | ;Parse segment | 
|---|
| 81 | D SEGPRSE^SCMSVUT5($NA(PIDSEG),"TMPARR",HLFS) | 
|---|
| 82 | ;Change marital status (if needed) | 
|---|
| 83 | S REBLD=0 | 
|---|
| 84 | S X=$G(TMPARR(16)) | 
|---|
| 85 | I ((X="")!(X=HLQ)) S TMPARR(16)="U",REBLD=1 | 
|---|
| 86 | ;Rebuild segment (if needed) | 
|---|
| 87 | I REBLD K TMPARR(0),PIDSEG D MAKEIT^VAFHLU("PID",.TMPARR,.PIDSEG,.PIDSEG) | 
|---|
| 88 | Q | 
|---|
| 89 | ; | 
|---|
| 90 | SETPOW(DFN,ZPDSEG,HLQ,HLFS)     ; Set POW Status Indicated field prior to ZPD segment validation | 
|---|
| 91 | ; | 
|---|
| 92 | ;     Input:      DFN = IEN of Patient (#2) file | 
|---|
| 93 | ;              ZPDSEG = Array containing ZPD segment (pass by reference) | 
|---|
| 94 | ;                       ZPDSEG = First 245 characters | 
|---|
| 95 | ;                       ZPDSEG(1..n) = Continuation nodes | 
|---|
| 96 | ;                 HLQ = HL7 null variable | 
|---|
| 97 | ;                HLFS = HL7 field separator | 
|---|
| 98 | ; | 
|---|
| 99 | ;    Output:  If Veteran and POW Status Indicated field = null, set to | 
|---|
| 100 | ;              U (Unknown) | 
|---|
| 101 | ;             If Non-Veteran, set to null | 
|---|
| 102 | ; | 
|---|
| 103 | S DFN=$G(DFN) | 
|---|
| 104 | G SETPOWQ:(DFN="")!($G(ZPDSEG)="") | 
|---|
| 105 | ;Declare variables | 
|---|
| 106 | N REBLD,TMPARR,X | 
|---|
| 107 | ;Parse segment | 
|---|
| 108 | D SEGPRSE^SCMSVUT5($NA(ZPDSEG),"TMPARR",HLFS) | 
|---|
| 109 | ;Change POW status (if needed) | 
|---|
| 110 | S REBLD=0 | 
|---|
| 111 | S X=$G(TMPARR(17)) | 
|---|
| 112 | I $P($G(^DPT(DFN,"VET")),"^")="Y",(X=""!(X=HLQ)) S TMPARR(17)="U",REBLD=1 | 
|---|
| 113 | I $P($G(^DPT(DFN,"VET")),"^")="N" S TMPARR(17)=HLQ,REBLD=1 | 
|---|
| 114 | ;Rebuild segment (if needed) | 
|---|
| 115 | I REBLD K TMPARR(0),ZPDSEG D MAKEIT^VAFHLU("ZPD",.TMPARR,.ZPDSEG,.ZPDSEG) | 
|---|
| 116 | ; | 
|---|
| 117 | SETPOWQ Q | 
|---|
| 118 | ; | 
|---|
| 119 | ; | 
|---|
| 120 | SETVSI(DFN,ZSPSEG,HLQ,HLFS) ;Set Vietnam Service Indicated field prior to ZSP segment validation | 
|---|
| 121 | ; | 
|---|
| 122 | ;     Input:      DFN = IEN of Patient (#2) file | 
|---|
| 123 | ;              ZSPSEG = HL7 ZSP segment | 
|---|
| 124 | ;                 HLQ = HL7 null variable | 
|---|
| 125 | ;                HLFS = HL7 field separator | 
|---|
| 126 | ; | 
|---|
| 127 | ;    Output:  If Veteran and Vietnam Service Indicated field = null, | 
|---|
| 128 | ;              set to U (Unknown) | 
|---|
| 129 | ;             If Non-Veteran, set to null | 
|---|
| 130 | ; | 
|---|
| 131 | S DFN=$G(DFN),ZSPSEG=$G(ZSPSEG) | 
|---|
| 132 | G SETVSIQ:(DFN="")!(ZSPSEG="") | 
|---|
| 133 | I $P($G(^DPT(DFN,"VET")),"^")="Y",($P(ZSPSEG,HLFS,6)=""!($P(ZSPSEG,HLFS,6)=HLQ)) S $P(ZSPSEG,HLFS,6)="U" | 
|---|
| 134 | I $P($G(^DPT(DFN,"VET")),"^")="N" S $P(ZSPSEG,HLFS,6)=HLQ | 
|---|
| 135 | ; | 
|---|
| 136 | SETVSIQ Q ZSPSEG | 
|---|
| 137 | ; | 
|---|
| 138 | ; | 
|---|
| 139 | ; | 
|---|
| 140 | ;The following subroutines all have to do with the validation of | 
|---|
| 141 | ;data using the same edit checks that are used by Austin. | 
|---|
| 142 | ; | 
|---|
| 143 | HL7SEGNM(SEG,DATA) ;checks the validity of the HL7 segment name passed in. | 
|---|
| 144 | ;INPUT    SEG  - the HL7 segment name | 
|---|
| 145 | ;         DATA - the data to compare. In this case the HL7 segment name. | 
|---|
| 146 | ; | 
|---|
| 147 | ;OUTPUT   0 (ZERO) if not validate | 
|---|
| 148 | ;         1 if validated | 
|---|
| 149 | ; | 
|---|
| 150 | I '$D(SEG)!('$D(DATA)) Q 0 | 
|---|
| 151 | Q $S(SEG=DATA:1,1:0) | 
|---|
| 152 | ; | 
|---|
| 153 | EVTTYP(SEG,DATA) ;checks the event type of the segment passed in. | 
|---|
| 154 | ;INPUT  SEG  - The HL7 segment name in question | 
|---|
| 155 | ;       DATA - The event type from the HL7 segment in question. | 
|---|
| 156 | ; | 
|---|
| 157 | ;OUTPUT   0 (ZERO) if not validate | 
|---|
| 158 | ;         1 if validated | 
|---|
| 159 | ; | 
|---|
| 160 | I '$D(SEG)!('$D(DATA)) Q 0 | 
|---|
| 161 | I SEG="EVN"&(DATA="A08"!(DATA="A23")) Q 1 | 
|---|
| 162 | Q 0 | 
|---|
| 163 | ; | 
|---|
| 164 | EVTDTTM(DATA) ;Checks the date and time to ensure it is correct. | 
|---|
| 165 | ;INPUT  DATA - this is the date and time in quesiton. | 
|---|
| 166 | ; | 
|---|
| 167 | ;OUTPUT  0 (ZERO) if not validate | 
|---|
| 168 | ;        1 if validated | 
|---|
| 169 | ; | 
|---|
| 170 | I '$D(DATA) Q 0 | 
|---|
| 171 | N STRTDT,%DT,X,Y | 
|---|
| 172 | S STRTDT=+$O(^SD(404.91,0)) | 
|---|
| 173 | S STRTDT=$P($G(^SD(404.91,STRTDT,"AMB")),U,2) | 
|---|
| 174 | I 'STRTDT Q 0 | 
|---|
| 175 | S %DT="T",%DT(0)=STRTDT,X=DATA | 
|---|
| 176 | D ^%DT | 
|---|
| 177 | Q $S(Y=-1:0,1:1) | 
|---|
| 178 | ; | 
|---|
| 179 | VALIDATE(SEG,DATA,ERRCOD,VALERR,CTR) ; | 
|---|
| 180 | ; | 
|---|
| 181 | N ERRIEN,ERRCHK,RES | 
|---|
| 182 | S ERRIEN=+$O(^SD(409.76,"B",ERRCOD,"")) | 
|---|
| 183 | I 'ERRIEN S @VALERR@(SEG,CTR)=ERRCOD D INCR Q | 
|---|
| 184 | S ERRCHK=$G(^SD(409.76,ERRIEN,"CHK")) | 
|---|
| 185 | I ERRCHK="" S @VALERR@(SEG,CTR)=ERRCOD D INCR Q | 
|---|
| 186 | X ERRCHK | 
|---|
| 187 | I 'RES S @VALERR@(SEG,CTR)=ERRCOD D INCR | 
|---|
| 188 | Q | 
|---|
| 189 | ; | 
|---|
| 190 | DFN(DATA) ; | 
|---|
| 191 | ;INPUT   DATA - the DFN of the patient | 
|---|
| 192 | ; | 
|---|
| 193 | I '$D(DATA) Q 0 | 
|---|
| 194 | I DATA=""!(DATA=0) Q 0 | 
|---|
| 195 | I DATA'?1.N.".".N Q 0 | 
|---|
| 196 | Q 1 | 
|---|
| 197 | ; | 
|---|
| 198 | PATNM(DATA) ; | 
|---|
| 199 | ;INPUT  DATA - The name of the patient | 
|---|
| 200 | ; | 
|---|
| 201 | I '$D(DATA) Q 0 | 
|---|
| 202 | I DATA="" Q 0 | 
|---|
| 203 | I DATA?.N.",".N Q 0 | 
|---|
| 204 | I DATA?1.C Q 0 | 
|---|
| 205 | Q 1 | 
|---|
| 206 | ; | 
|---|
| 207 | DOB(DATA,ENCDT) ; | 
|---|
| 208 | ;INPUT  DATA - The DOB to be tested. | 
|---|
| 209 | ;      ENCDT - The date/time of the encounter | 
|---|
| 210 | ; | 
|---|
| 211 | N %DT,X,Y | 
|---|
| 212 | I '$D(DATA) Q 0 | 
|---|
| 213 | I '$D(ENCDT) Q 0 | 
|---|
| 214 | I DATA'?1.N Q 0 | 
|---|
| 215 | S %DT="T",%DT(0)=-ENCDT,X=DATA | 
|---|
| 216 | D ^%DT | 
|---|
| 217 | Q $S(Y=-1:0,1:1) | 
|---|
| 218 | ; | 
|---|
| 219 | SEX(DATA) ; | 
|---|
| 220 | ;INPUT  DATA - The sex code to be validated | 
|---|
| 221 | ; | 
|---|
| 222 | I '$D(DATA) Q 0 | 
|---|
| 223 | I "FMUO"'[DATA Q 0 | 
|---|
| 224 | Q 1 | 
|---|
| 225 | ; | 
|---|
| 226 | RACE(DATA) ; | 
|---|
| 227 | ;INPUT  DATA - the race code to be validated (NNNN-C-XXX) | 
|---|
| 228 | ; | 
|---|
| 229 | N VAL,MTHD | 
|---|
| 230 | I '$D(DATA) Q 0 | 
|---|
| 231 | I DATA="" Q 1 | 
|---|
| 232 | S VAL=$P(DATA,"-",1,2) | 
|---|
| 233 | S MTHD=$P(DATA,"-",3) | 
|---|
| 234 | I VAL'?4N1"-"1N Q 0 | 
|---|
| 235 | I ",SLF,UNK,PRX,OBS,"'[MTHD Q 0 | 
|---|
| 236 | Q 1 | 
|---|
| 237 | ; | 
|---|
| 238 | STR1(DATA) ; | 
|---|
| 239 | ;INPUT   DATA - Street address line 1 | 
|---|
| 240 | ; | 
|---|
| 241 | N LP,VAR | 
|---|
| 242 | I '$D(DATA) Q 0 | 
|---|
| 243 | I DATA="" Q 0 | 
|---|
| 244 | I DATA?1.N Q 0 | 
|---|
| 245 | I DATA=" " Q 0 | 
|---|
| 246 | F LP=1:1:$L(DATA) S VAR=$E(DATA,LP,LP) I $A(VAR)>32,($A(VAR)<127) S LP="Y" Q | 
|---|
| 247 | Q $S(LP="Y":1,1:0) | 
|---|
| 248 | ; | 
|---|
| 249 | STR2(DATA) ; | 
|---|
| 250 | ;INPUT  DATA - Street address line 2 | 
|---|
| 251 | I DATA?1.N Q 0 | 
|---|
| 252 | Q 1 | 
|---|
| 253 | ; | 
|---|
| 254 | CITY(DATA) ; | 
|---|
| 255 | ;INPUT  DATA - The city code to be validated | 
|---|
| 256 | ; | 
|---|
| 257 | I DATA="" Q 0 | 
|---|
| 258 | I DATA?1.N Q 0 | 
|---|
| 259 | Q 1 | 
|---|
| 260 | ; | 
|---|
| 261 | STATE(DATA) ; | 
|---|
| 262 | ;INPUT  DATA - State code to be validated. | 
|---|
| 263 | ; | 
|---|
| 264 | I '$D(DATA) Q 0 | 
|---|
| 265 | I DATA="" Q 0 | 
|---|
| 266 | I '$D(^DIC(5,"C",DATA)) Q 0 | 
|---|
| 267 | Q 1 | 
|---|
| 268 | ; | 
|---|
| 269 | ZIP(DATA) ; | 
|---|
| 270 | ;INPUT  DATA - The zipo code to be validated | 
|---|
| 271 | ; | 
|---|
| 272 | I '$D(DATA) Q 0 | 
|---|
| 273 | I $E(DATA,1,5)="00000" Q 0 | 
|---|
| 274 | I DATA'?5N."-".4N Q 0 | 
|---|
| 275 | Q 1 | 
|---|
| 276 | ; | 
|---|
| 277 | COUNTY(DATA,STATE) ; | 
|---|
| 278 | ;INPUT  DATA  - The county code to be validated | 
|---|
| 279 | ;       STATE - STATE file IEN | 
|---|
| 280 | ; | 
|---|
| 281 | I DATA="" Q 0 | 
|---|
| 282 | I STATE="" Q 0 | 
|---|
| 283 | I '$D(^DIC(5,+$G(STATE),1,"C",DATA)) Q 0 | 
|---|
| 284 | Q 1 | 
|---|
| 285 | ; | 
|---|
| 286 | MARITAL(DATA) ; | 
|---|
| 287 | ;INPUT   DATA - The marital status code to be validated. | 
|---|
| 288 | ; | 
|---|
| 289 | I $L(DATA)>1 Q 0 | 
|---|
| 290 | I "ADMSWU"'[DATA Q 0 | 
|---|
| 291 | Q 1 | 
|---|
| 292 | ; | 
|---|
| 293 | REL(DATA) ; | 
|---|
| 294 | ;INPUT   DATA - The religion abbreviation to the validated | 
|---|
| 295 | ; | 
|---|
| 296 | I '$D(DATA) Q 0 | 
|---|
| 297 | I DATA="" Q 0 | 
|---|
| 298 | I '$D(^DIC(13,"C",+DATA)) Q 0 | 
|---|
| 299 | Q 1 | 
|---|
| 300 | ; | 
|---|
| 301 | SSN(DATA,NOPCHK,NULLOK) ; SD*5.3*345 added optional parameter NULLOK | 
|---|
| 302 | ;INPUT   DATA - The SSN to be validated | 
|---|
| 303 | ;        NOPCHK - O = Check pseudo indicator (default) | 
|---|
| 304 | ;                 1 = Don't check pseudo indicator | 
|---|
| 305 | ;        NULLOK (optional) - 1 = Allow SSN to be null | 
|---|
| 306 | ;                            2 = Don't allow null SSNs (default) | 
|---|
| 307 | ; | 
|---|
| 308 | I $G(DATA)="" Q +$G(NULLOK)  ; SD*5.3*345 | 
|---|
| 309 | I '$D(DATA) Q 0 | 
|---|
| 310 | N SSN,PSD | 
|---|
| 311 | S SSN=$E(DATA,1,9),PSD=$E(DATA,10) | 
|---|
| 312 | I SSN'?9N Q 0 | 
|---|
| 313 | I '$G(NOPCHK) I (PSD'=" "),(PSD'=""),(PSD'="P") Q 0 | 
|---|
| 314 | I $E(SSN,1,5)="00000" Q 0 | 
|---|
| 315 | Q 1 | 
|---|
| 316 | ; | 
|---|
| 317 | INCR ;increases the counter | 
|---|
| 318 | S CTR=CTR+1 | 
|---|
| 319 | Q | 
|---|
| 320 | ; | 
|---|
| 321 | REMOVE(SEG,ERR,VALERR,CNT) ; | 
|---|
| 322 | ;INPUT SEG - The segment being worked on | 
|---|
| 323 | ;    VALERR - The array holding the information | 
|---|
| 324 | ;      CNT - the counter to use | 
|---|
| 325 | ;      ERR - error code to remove | 
|---|
| 326 | ; | 
|---|
| 327 | N LP | 
|---|
| 328 | F LP=1:1:CNT I $G(@VALERR@(SEG,LP))=ERR K @VALERR@(SEG,LP) | 
|---|
| 329 | Q | 
|---|
| 330 | ; | 
|---|
| 331 | DECR(CNT) ; | 
|---|
| 332 | S CNT=CNT-1 | 
|---|
| 333 | Q | 
|---|
| 334 | ; | 
|---|