| 1 | SCMCHLA ;ALB/KCL - PCMM HL7 Transmission Log File API'S ;25-JAN-2000
 | 
|---|
| 2 |  ;;5.3;Scheduling;**210,272**;AUG 13, 1993
 | 
|---|
| 3 |  ;
 | 
|---|
| 4 | LOCK(SCTLIEN) ; Description: Used to lock a record in the PCMM HL7
 | 
|---|
| 5 |  ; TANSMISSION LOG file.
 | 
|---|
| 6 |  ;
 | 
|---|
| 7 |  ;  Input:
 | 
|---|
| 8 |  ;   SCTLIEN - ien of a record in the PCMM HL7 TRANSMISSION LOG file
 | 
|---|
| 9 |  ;
 | 
|---|
| 10 |  ; Output:
 | 
|---|
| 11 |  ;  Function Value: Returns 1 on success, 0 on faliure
 | 
|---|
| 12 |  ;
 | 
|---|
| 13 |  I $G(SCTLIEN) L +^SCPT(404.471,SCTLIEN):3
 | 
|---|
| 14 |  ;
 | 
|---|
| 15 |  Q $T
 | 
|---|
| 16 |  ;
 | 
|---|
| 17 |  ;
 | 
|---|
| 18 | UNLOCK(SCTLIEN) ; Description: Used to unlock a record in the PCMM HL7
 | 
|---|
| 19 |  ; TANSMISSION LOG file.
 | 
|---|
| 20 |  ;
 | 
|---|
| 21 |  ;  Input:
 | 
|---|
| 22 |  ;   SCTLIEN - ien of a record in the PCMM HL7 TRANSMISSION LOG file
 | 
|---|
| 23 |  ;
 | 
|---|
| 24 |  ; Output: None
 | 
|---|
| 25 |  ;
 | 
|---|
| 26 |  I $G(SCTLIEN) L -^SCPT(404.471,SCTLIEN)
 | 
|---|
| 27 |  Q
 | 
|---|
| 28 |  ;
 | 
|---|
| 29 |  ;
 | 
|---|
| 30 | GETLOG(SCTLIEN,SCECIEN,TLOG) ;
 | 
|---|
| 31 |  ; Description: Used to obtain a record in the PCMM HL7 TRANSMISSION LOG
 | 
|---|
| 32 |  ; file and a record in the Error Code subfile.  The field values will
 | 
|---|
| 33 |  ; be returned in the TLOG array.
 | 
|---|
| 34 |  ;
 | 
|---|
| 35 |  ;  Input:
 | 
|---|
| 36 |  ;   SCTLIEN - ien of a record in the PCMM HL7 TRANSMISSION LOG file
 | 
|---|
| 37 |  ;   SCECIEN - ien of record in the Error Code subfile
 | 
|---|
| 38 |  ;
 | 
|---|
| 39 |  ; Output:
 | 
|---|
| 40 |  ;  Function Value: Returns 1 on success, 0 on faliure
 | 
|---|
| 41 |  ;  TLOG - this is the name of a local array, it should be passed by
 | 
|---|
| 42 |  ;         reference.  If the function is successful the array will
 | 
|---|
| 43 |  ;         contain the PCMM HL7 TRANSMISSION LOG record and the
 | 
|---|
| 44 |  ;         Error Code subfile record.
 | 
|---|
| 45 |  ;
 | 
|---|
| 46 |  ;         subscript           field name
 | 
|---|
| 47 |  ;         ---------           ----------
 | 
|---|
| 48 |  ;         "MSGID"             Message Control ID
 | 
|---|
| 49 |  ;         "DFN"               Patient
 | 
|---|
| 50 |  ;         "TRANS"             Transmission Date/Time
 | 
|---|
| 51 |  ;         "STATUS"            Status
 | 
|---|
| 52 |  ;         "ACK DT/TM"         ACK Received Date/Time
 | 
|---|
| 53 |  ;
 | 
|---|
| 54 |  ;  Error Code subfile record:
 | 
|---|
| 55 |  ;         "ERR","CODE"        Error Code
 | 
|---|
| 56 |  ;         "ERR","SEG"         Segment
 | 
|---|
| 57 |  ;         "ERR","SEQ"         Sequence
 | 
|---|
| 58 |  ;         "ERR","ZPCID"       ZPC ID
 | 
|---|
| 59 |  ;         "ERR","EPS"         Error Processing Status
 | 
|---|
| 60 |  ;
 | 
|---|
| 61 |  N NODE
 | 
|---|
| 62 |  K TLOG S TLOG=""
 | 
|---|
| 63 |  Q:'$G(SCTLIEN) 0
 | 
|---|
| 64 |  ;
 | 
|---|
| 65 |  S NODE=$G(^SCPT(404.471,SCTLIEN,0))
 | 
|---|
| 66 |  Q:(NODE="") 0
 | 
|---|
| 67 |  S TLOG("MSGID")=$P(NODE,"^")
 | 
|---|
| 68 |  S TLOG("DFN")=$P(NODE,"^",2)
 | 
|---|
| 69 |  S TLOG("TRANS")=$P(NODE,"^",3)
 | 
|---|
| 70 |  S TLOG("STATUS")=$P(NODE,"^",4)
 | 
|---|
| 71 |  S TLOG("ACK DT/TM")=$P(NODE,"^",5)
 | 
|---|
| 72 |  S TLOG("WORK")=$P(NODE,"^",7)
 | 
|---|
| 73 |  ;
 | 
|---|
| 74 |  S TLOG("ERR")=""
 | 
|---|
| 75 |  I $G(SCECIEN) D
 | 
|---|
| 76 |  .S NODE=$G(^SCPT(404.471,SCTLIEN,"ERR",SCECIEN,0))
 | 
|---|
| 77 |  .S TLOG("ERR","CODE")=$P(NODE,"^")
 | 
|---|
| 78 |  .S TLOG("ERR","SEG")=$P(NODE,"^",2)
 | 
|---|
| 79 |  .S TLOG("ERR","SEQ")=$P(NODE,"^",3)
 | 
|---|
| 80 |  .S TLOG("ERR","ZPCID")=$P(NODE,"^",5)
 | 
|---|
| 81 |  .S TLOG("ERR","EPS")=$P(NODE,"^",6)
 | 
|---|
| 82 |  ;
 | 
|---|
| 83 |  Q 1
 | 
|---|
| 84 |  ;
 | 
|---|
| 85 |  ;
 | 
|---|
| 86 | STATUS(SCTLIEN) ;
 | 
|---|
| 87 |  ; Description: Used to get STATUS field for record in PCMM HL7
 | 
|---|
| 88 |  ; TRANSMISSION LOG file.
 | 
|---|
| 89 |  ;
 | 
|---|
| 90 |  ;  Input:
 | 
|---|
| 91 |  ;   SCTLIEN - IEN of PCM HL7 TRANSMISSION LOG file
 | 
|---|
| 92 |  ;
 | 
|---|
| 93 |  ; Output:
 | 
|---|
| 94 |  ;  Funtion Value: Returns STATUS field value, null otherwise.
 | 
|---|
| 95 |  ;
 | 
|---|
| 96 |  Q:'$G(SCTLIEN) ""
 | 
|---|
| 97 |  Q $P($G(^SCPT(404.471,SCTLIEN,0)),"^",4)
 | 
|---|
| 98 |  ;
 | 
|---|
| 99 |  ;
 | 
|---|
| 100 | UPDSTAT(SCTLIEN,STATUS,ERROR) ;
 | 
|---|
| 101 |  ; Description: Used to update the STATUS field of record in PCMM HL7
 | 
|---|
| 102 |  ; TRANSMISSION LOG file.
 | 
|---|
| 103 |  ;
 | 
|---|
| 104 |  ;  Input:
 | 
|---|
| 105 |  ;   SCTLIEN - IEN of PCM HL7 TRANSMISSION LOG file
 | 
|---|
| 106 |  ;    STATUS - T=Transmitted, A=Accepted, RJ=Rejected,
 | 
|---|
| 107 |  ;             M=Marked for re-transmission, RT=Re-transmitted
 | 
|---|
| 108 |  ;
 | 
|---|
| 109 |  ; Output:
 | 
|---|
| 110 |  ;  Funtion Value: Returns 1 on success, 0 on failure.
 | 
|---|
| 111 |  ;  ERROR - returns error message on failure, pass by reference 
 | 
|---|
| 112 |  ;
 | 
|---|
| 113 |  N SCERR,SCFDA,SCIENS
 | 
|---|
| 114 |  ;
 | 
|---|
| 115 |  S ERROR=""
 | 
|---|
| 116 |  ;
 | 
|---|
| 117 |  I '$G(SCTLIEN) S ERROR="NO RECORD SPECIFIED" Q 0
 | 
|---|
| 118 |  I '$$LOCK(SCTLIEN) S ERROR="UNABLE TO OBTAIN LOCK ON RECORD" Q 0
 | 
|---|
| 119 |  I ",T,A,RJ,M,RT,"'[(","_$G(STATUS)_",") S ERROR="INVALID STATUS" Q 0
 | 
|---|
| 120 |  ;
 | 
|---|
| 121 |  S SCIENS=SCTLIEN_","
 | 
|---|
| 122 |  S SCFDA(404.471,SCIENS,.04)=STATUS  ; Status
 | 
|---|
| 123 |  D FILE^DIE("","SCFDA","SCERR")
 | 
|---|
| 124 |  ;
 | 
|---|
| 125 |  D UNLOCK(SCTLIEN)
 | 
|---|
| 126 |  ;
 | 
|---|
| 127 |  ; if error returned from DBS call, unable to file data
 | 
|---|
| 128 |  I $G(SCERR) S ERROR="UNABLE TO UPDATE STATUS FIELD" Q 0
 | 
|---|
| 129 |  ;
 | 
|---|
| 130 |  Q 1
 | 
|---|
| 131 |  ;
 | 
|---|
| 132 |  ;
 | 
|---|
| 133 | INCLUDE(SCTLIEN) ;
 | 
|---|
| 134 |  ; Description: Used to get INCLUDED IN REJECT BULLETIN? field for
 | 
|---|
| 135 |  ; record in PCMM HL7 TRANSMISSION LOG file.
 | 
|---|
| 136 |  ;
 | 
|---|
| 137 |  ;  Input:
 | 
|---|
| 138 |  ;   SCTLIEN - IEN of PCM HL7 TRANSMISSION LOG file
 | 
|---|
| 139 |  ;
 | 
|---|
| 140 |  ; Output:
 | 
|---|
| 141 |  ;  Funtion Value: Returns INCLUDED IN REJECT BULLETIN? field value, null otherwise.
 | 
|---|
| 142 |  ;
 | 
|---|
| 143 |  Q:'$G(SCTLIEN) ""
 | 
|---|
| 144 |  Q $P($G(^SCPT(404.471,SCTLIEN,0)),"^",6)
 | 
|---|
| 145 |  ;
 | 
|---|
| 146 |  ;
 | 
|---|
| 147 | UPDINCL(SCTLIEN,SCINCL,ERROR) ;
 | 
|---|
| 148 |  ; Description: Used to update the INCLUDED IN REJECT BULLETIN? field of
 | 
|---|
| 149 |  ; record in the PCMM HL7 TRANSMISSION LOG file.
 | 
|---|
| 150 |  ;
 | 
|---|
| 151 |  ;  Input:
 | 
|---|
| 152 |  ;    SCTLIEN - IEN of record in PCMM HL7 TRANSMISSION LOG file
 | 
|---|
| 153 |  ;     SCINCL - 'Y'=YES
 | 
|---|
| 154 |  ;
 | 
|---|
| 155 |  ; Output:
 | 
|---|
| 156 |  ;  Funtion Value: Returns 1 on success, 0 on failure.
 | 
|---|
| 157 |  ;  ERROR - returns error message on failure, pass by reference 
 | 
|---|
| 158 |  ;
 | 
|---|
| 159 |  N SCERR,SCFDA,SCIENS
 | 
|---|
| 160 |  ;
 | 
|---|
| 161 |  S ERROR=""
 | 
|---|
| 162 |  ;
 | 
|---|
| 163 |  I '$G(SCTLIEN) S ERROR="NO RECORD SPECIFIED" Q 0
 | 
|---|
| 164 |  I $G(SCINCL)'="Y" S ERROR="INVALID FIELD VALUE" Q 0
 | 
|---|
| 165 |  I '$$LOCK(SCTLIEN) S ERROR="UNABLE TO OBTAIN LOCK ON RECORD" Q 0
 | 
|---|
| 166 |  ;
 | 
|---|
| 167 |  S SCIENS=SCTLIEN_","
 | 
|---|
| 168 |  S SCFDA(404.471,SCIENS,.06)=SCINCL  ; Included In Reject Bulletin?
 | 
|---|
| 169 |  D FILE^DIE("","SCFDA","SCERR")
 | 
|---|
| 170 |  ;
 | 
|---|
| 171 |  D UNLOCK(SCTLIEN)
 | 
|---|
| 172 |  ;
 | 
|---|
| 173 |  ; if error returned from DBS call, unable to file data
 | 
|---|
| 174 |  I $G(SCERR) S ERROR="UNABLE TO UPDATE 'INCLUDED IN REJECT BULLETIN?' FIELD" Q 0
 | 
|---|
| 175 |  ;
 | 
|---|
| 176 |  Q 1
 | 
|---|
| 177 |  ;
 | 
|---|
| 178 |  ;
 | 
|---|
| 179 | ACK(SCTLIEN) ;
 | 
|---|
| 180 |  ; Description: Used to get ACK RECEIVED DATE/TIME field for
 | 
|---|
| 181 |  ; record in PCMM HL7 TRANSMISSION LOG file.
 | 
|---|
| 182 |  ;
 | 
|---|
| 183 |  ;  Input:
 | 
|---|
| 184 |  ;   SCTLIEN - IEN of PCM HL7 TRANSMISSION LOG file
 | 
|---|
| 185 |  ;
 | 
|---|
| 186 |  ; Output:
 | 
|---|
| 187 |  ;  Funtion Value: Returns ACK RECEIVED DATE/TIME field value, 0 otherwise.
 | 
|---|
| 188 |  ;
 | 
|---|
| 189 |  Q:'$G(SCTLIEN) 0
 | 
|---|
| 190 |  Q $P($G(^SCPT(404.471,SCTLIEN,0)),"^",5)
 | 
|---|
| 191 |  ;
 | 
|---|
| 192 |  ;
 | 
|---|
| 193 | UPDEPS(SCTLIEN,SCERIEN,EPSTAT,ERROR) ;
 | 
|---|
| 194 |  ; Description: Used to update the ERROR PROCESSING STATUS field of
 | 
|---|
| 195 |  ; record in the Error Code (#404.47142) subfile.
 | 
|---|
| 196 |  ;
 | 
|---|
| 197 |  ;  Input:
 | 
|---|
| 198 |  ;    SCTLIEN - IEN of record in PCMM HL7 TRANSMISSION LOG file
 | 
|---|
| 199 |  ;    SCERIEN - IEN record in ERROR CODE (#404.47142) subfile
 | 
|---|
| 200 |  ;     EPSTAT - 1=NEW, 2=CHECKED
 | 
|---|
| 201 |  ;
 | 
|---|
| 202 |  ; Output:
 | 
|---|
| 203 |  ;  Funtion Value: Returns 1 on success, 0 on failure.
 | 
|---|
| 204 |  ;  ERROR - returns error message on failure, pass by reference 
 | 
|---|
| 205 |  ;
 | 
|---|
| 206 |  N SCERR,SCFDA,SCIENS,STATUS
 | 
|---|
| 207 |  ;
 | 
|---|
| 208 |  S ERROR=""
 | 
|---|
| 209 |  ;
 | 
|---|
| 210 |  I '$G(SCTLIEN) S ERROR="NO RECORD SPECIFIED" Q 0
 | 
|---|
| 211 |  I '$G(SCERIEN) S ERROR="NO SUB-RECORD SPECIFIED" Q 0
 | 
|---|
| 212 |  I '$G(EPSTAT) S ERROR="INVALID ERROR PROCESSING STATUS" Q 0
 | 
|---|
| 213 |  S STATUS=$$STATUS(SCTLIEN)
 | 
|---|
| 214 |  I (STATUS'="RJ")&(STATUS'="M") S ERROR="STATUS IS NOT 'REJECTED' OR 'MARKED FOR RE-TRANSMIT'" Q 0
 | 
|---|
| 215 |  I '$$LOCK(SCTLIEN) S ERROR="UNABLE TO OBTAIN LOCK ON RECORD" Q 0
 | 
|---|
| 216 |  ;
 | 
|---|
| 217 |  S SCIENS=SCERIEN_","_SCTLIEN_","
 | 
|---|
| 218 |  S SCFDA(404.47142,SCIENS,.06)=EPSTAT  ; Error Processing Status
 | 
|---|
| 219 |  D FILE^DIE("","SCFDA","SCERR")
 | 
|---|
| 220 |  ;
 | 
|---|
| 221 |  D UNLOCK(SCTLIEN)
 | 
|---|
| 222 |  ;
 | 
|---|
| 223 |  ; if error returned from DBS call, unable to file data
 | 
|---|
| 224 |  I $G(SCERR) S ERROR="UNABLE TO UPDATE STATUS FIELD" Q 0
 | 
|---|
| 225 |  ;
 | 
|---|
| 226 |  Q 1
 | 
|---|