[300] | 1 | C0CRNF ; CCDCCR/GPL - Reference Name Format (RNF) utilities; 12/6/08
|
---|
| 2 | ;;0.1;CCDCCR;nopatch;noreleasedate
|
---|
| 3 | ;Copyright 2008 WorldVistA. Licensed under the terms of the GNU
|
---|
| 4 | ;General Public License See attached copy of the License.
|
---|
| 5 | ;
|
---|
| 6 | ;This program is free software; you can redistribute it and/or modify
|
---|
| 7 | ;it under the terms of the GNU General Public License as published by
|
---|
| 8 | ;the Free Software Foundation; either version 2 of the License, or
|
---|
| 9 | ;(at your option) any later version.
|
---|
| 10 | ;
|
---|
| 11 | ;This program is distributed in the hope that it will be useful,
|
---|
| 12 | ;but WITHOUT ANY WARRANTY; without even the implied warranty of
|
---|
| 13 | ;MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
---|
| 14 | ;GNU General Public License for more details.
|
---|
| 15 | ;
|
---|
| 16 | ;You should have received a copy of the GNU General Public License along
|
---|
| 17 | ;with this program; if not, write to the Free Software Foundation, Inc.,
|
---|
| 18 | ;51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
---|
| 19 | ;
|
---|
| 20 | W "This is the Reference Name Format (RNF) Utility Library ",!
|
---|
| 21 | W !
|
---|
| 22 | Q
|
---|
| 23 | ;
|
---|
| 24 | FIELDS(C0CFRTN,C0CF) ; RETURNS AN ARRAY OF THE FIELDS IN FILE C0CF,
|
---|
| 25 | ; C0CFRTN IS PASSED BY NAME, C0CF IS PASSED BY VALUE
|
---|
| 26 | ;
|
---|
| 27 | N C0CFI,C0CFJ ;INNER LOOP, OUTER LOOP
|
---|
| 28 | N C0CFN ; FIELD NAME
|
---|
| 29 | S C0CFI=0 S C0CFJ=C0CF
|
---|
| 30 | K @C0CFRTN ; CLEAR THE RETURN ARRAY
|
---|
| 31 | F Q:C0CFJ'[C0CF D ; FOR THE C0CF FILE AND ALL SUBFILES INCLUSIVE
|
---|
| 32 | . ;W "1: "_C0CFJ," ",C0CFI,!
|
---|
| 33 | . F S C0CFI=$O(^DD(C0CFJ,C0CFI)) Q:+C0CFI=0 D ; EVERY FIELD
|
---|
| 34 | . . ;W "2: "_C0CFJ," ",C0CFI,!
|
---|
| 35 | . . S C0CFN=$P(^DD(C0CFJ,C0CFI,0),"^",1) ;PULL FIELD NAME FROM ^DD
|
---|
| 36 | . . ;W "N: ",C0CFN,!
|
---|
| 37 | . . ;I C0CFN="STR" W C0CFN," ",C0CFJ,!
|
---|
| 38 | . . I $D(@C0CFRTN@(C0CFN)) D ; IS THIS A DUPLICATE?
|
---|
| 39 | . . . W "DUPLICATE FOUND! ",C0CFJ," ",C0CFI," ",C0CFN,!,@C0CFRTN@(C0CFN),!
|
---|
| 40 | . . . S @C0CFRTN@(C0CFN_"_"_C0CFJ)=C0CFJ_"^"_C0CFI
|
---|
| 41 | . . E S @C0CFRTN@(C0CFN)=C0CFJ_"^"_C0CFI
|
---|
| 42 | . S C0CFJ=$O(^DD(C0CFJ)) ; NEXT SUBFILE
|
---|
| 43 | Q
|
---|
| 44 | ;
|
---|
[301] | 45 | GETN(GRTN,GFILE,GIEN,GNN) ; GET FIELDS FOR ACCESS BY NAME
|
---|
| 46 | ; GRTN IS PASSED BY NAME
|
---|
[300] | 47 | ;
|
---|
| 48 | N C0CTMP,C0CI,C0CJ,C0CREF,C0CNAME
|
---|
| 49 | I $D(GNN) I GNN="ALL" S C0CNN=0 ; NOT NON-NULL (ALL FIELDS TO BE RETURNED)
|
---|
| 50 | E S C0CNN=1 ; NON-NULL IS TRUE (ONLY POPULATED FIELDS RETURNED)
|
---|
| 51 | S C0CREF=GIEN_"," ; OPEN ROOT REFERENCE INTO FILE
|
---|
| 52 | D CLEAN^DILF ; MAKE SURE WE ARE CLEANED UP
|
---|
| 53 | D GETS^DIQ(GFILE,C0CREF,"**","","C0CTMP")
|
---|
| 54 | D FIELDS(GRTN,GFILE) ;GET ALL THE FIELD NAMES FOR THE FILE
|
---|
| 55 | S (C0CI,C0CJ)=""
|
---|
| 56 | F S C0CJ=$O(C0CTMP(C0CJ)) Q:C0CJ="" D ; FOR ALL SUBFILES
|
---|
| 57 | . S C0CREF=$O(C0CTMP(C0CJ,"")) ; RECORD REFERENCE
|
---|
| 58 | . F S C0CI=$O(C0CTMP(C0CJ,C0CREF,C0CI)) Q:C0CI="" D ; ARRAY OF FIELDS
|
---|
| 59 | . . ;W C0CJ," ",C0CI,!
|
---|
| 60 | . . S C0CNAME=$P(^DD(C0CJ,C0CI,0),"^",1) ;PULL THE FIELD NAME
|
---|
| 61 | . . S C0CVALUE=C0CTMP(C0CJ,C0CREF,C0CI) ;
|
---|
| 62 | . . I C0CVALUE["C0CTMP" S C0CVALUE=C0CTMP(C0CJ,C0CREF,C0CI,1) ;1ST LINE OF WP
|
---|
| 63 | . . S $P(@GRTN@(C0CNAME),"^",3)=C0CVALUE ;RETURN VALUE IN P3
|
---|
| 64 | I C0CNN D ; IF ONLY NON-NULL VALUES ARE TO BE RETURNED
|
---|
| 65 | . S C0CI=""
|
---|
| 66 | . F S C0CI=$O(@GRTN@(C0CI)) Q:C0CI="" D ; GO THROUGH THE WHOLE ARRAY
|
---|
| 67 | . . I $P(@GRTN@(C0CI),"^",3)="" K @GRTN@(C0CI) ; KILL THE NULL ENTRIES
|
---|
| 68 | Q
|
---|
| 69 | ;
|
---|
[301] | 70 | GETN2(GRTN,GFILE,GREF,GNDX,GNN) ; NEW GET ;GPL ; RETURN A FIELD VALUE MAP
|
---|
| 71 | ; GETN IS AN EXTRINSIC WHICH RETURNS THE NEXT IEN AFTER THE CURRENT GIEN
|
---|
| 72 | ; GRTN, PASSED BY NAME, RETURNS A FIELD MAP AND A VALUE MAP
|
---|
| 73 | ; .. FIELD MAP @GRTN@("F","FIELDNAME^FILE^FIELD#")=""
|
---|
| 74 | ; ... ANY FIELD USED BY ANY RECORD PROCESSED IS IN THE FIELD MAP
|
---|
| 75 | ; .. VALUE MAP @GRTN@("V","IEN","FIELDNAME")=VALUE
|
---|
| 76 | ; .. GRTN IS NOT INITIALIZED, SO MULTIPLE CALLS ARE CUMULATIVE
|
---|
| 77 | ; .. IF GNN="ALL" THEN ALL FIELDS FOR THE FILE ARE IN THE FIELD MAP
|
---|
| 78 | ; .. EVEN IF GNN="ALL" ONLY POPULATED FIELDS ARE RETURNED IN THE VALUE MAP
|
---|
| 79 | ; .. NUL FIELDS CAN BE DETERMINED BY CHECKING FIELD MAP - THIS SAVES SPACE
|
---|
[300] | 80 | ; IF GREF IS "" THE FIRST RECORD IS OBTAINED
|
---|
| 81 | ; IF GNDX IS NULL, GREF IS AN IEN FOR THE FILE
|
---|
| 82 | ; GNDX IS THE INDEX TO USE TO OBTAIN THE IEN
|
---|
| 83 | ; GREF IS THE VALUE FOR THE INDEX
|
---|
| 84 | ; GANN= NOT NULL - IF GANN IS "ALL" THEN EVEN NULL FIELDS WILL BE RETURNED
|
---|
| 85 | ; OTHERWISE, ONLY POPULATED FIELDS ARE RETURNED IN GRTN
|
---|
| 86 | ;
|
---|
[301] | 87 | ;
|
---|
| 88 | N GIEN,GF
|
---|
| 89 | S GF=$$FILEREF(GFILE) ;CLOSED FILE REFERENCE FOR FILE NUMBER GFILE
|
---|
[300] | 90 | I '$D(GNDX) S GIEN=GREF ; IF NO INDEX USED, GREF IS THE IEN
|
---|
| 91 | E D ; WE ARE USING AN INDEX
|
---|
[301] | 92 | . ;N ZG
|
---|
| 93 | . S ZG=$Q(@GF@(GNDX,GREF)) ;ACCESS INDEX
|
---|
| 94 | . I $QS(ZG,3)=GREF D ; IS GREF IN INDEX?
|
---|
| 95 | . . S GIEN=$QS(ZG,4) ; PULL OUT THE IEN
|
---|
| 96 | . E S GIEN="" ; NOT FOUND IN INDEX
|
---|
| 97 | W "IEN: ",GIEN,!
|
---|
[300] | 98 | N C0CTMP,C0CI,C0CJ,C0CREF,C0CNAME
|
---|
| 99 | I $D(GNN) I GNN="ALL" S C0CNN=0 ; NOT NON-NULL (ALL FIELDS TO BE RETURNED)
|
---|
| 100 | E S C0CNN=1 ; NON-NULL IS TRUE (ONLY POPULATED FIELDS RETURNED)
|
---|
| 101 | S C0CREF=GIEN_"," ; OPEN ROOT REFERENCE INTO FILE
|
---|
| 102 | D CLEAN^DILF ; MAKE SURE WE ARE CLEANED UP
|
---|
| 103 | D GETS^DIQ(GFILE,C0CREF,"**","","C0CTMP")
|
---|
| 104 | D FIELDS(GRTN,GFILE) ;GET ALL THE FIELD NAMES FOR THE FILE
|
---|
| 105 | S (C0CI,C0CJ)=""
|
---|
| 106 | F S C0CJ=$O(C0CTMP(C0CJ)) Q:C0CJ="" D ; FOR ALL SUBFILES
|
---|
| 107 | . S C0CREF=$O(C0CTMP(C0CJ,"")) ; RECORD REFERENCE
|
---|
| 108 | . F S C0CI=$O(C0CTMP(C0CJ,C0CREF,C0CI)) Q:C0CI="" D ; ARRAY OF FIELDS
|
---|
| 109 | . . ;W C0CJ," ",C0CI,!
|
---|
| 110 | . . S C0CNAME=$P(^DD(C0CJ,C0CI,0),"^",1) ;PULL THE FIELD NAME
|
---|
| 111 | . . S C0CVALUE=C0CTMP(C0CJ,C0CREF,C0CI) ;
|
---|
| 112 | . . I C0CVALUE["C0CTMP" S C0CVALUE=C0CTMP(C0CJ,C0CREF,C0CI,1) ;1ST LINE OF WP
|
---|
| 113 | . . S $P(@GRTN@(C0CNAME),"^",3)=C0CVALUE ;RETURN VALUE IN P3
|
---|
| 114 | I C0CNN D ; IF ONLY NON-NULL VALUES ARE TO BE RETURNED
|
---|
| 115 | . S C0CI=""
|
---|
| 116 | . F S C0CI=$O(@GRTN@(C0CI)) Q:C0CI="" D ; GO THROUGH THE WHOLE ARRAY
|
---|
| 117 | . . I $P(@GRTN@(C0CI),"^",3)="" K @GRTN@(C0CI) ; KILL THE NULL ENTRIES
|
---|
| 118 | Q
|
---|
| 119 | ;
|
---|
[301] | 120 | GETALL(GARTN,GAFILE,GACNT,GASTRT,GANN) ; RETURN FIELD MAP AND VALUES
|
---|
| 121 | ; GARTN, PASSED BY NAME, RETURNS A FIELD MAP AND A VALUE MAP
|
---|
| 122 | ; .. FIELD MAP @GARTN@("F","FIELDNAME^FILE^FIELD#")=""
|
---|
| 123 | ; ... ANY FIELD USED BY ANY RECORD PROCESSED IS IN THE FIELD MAP
|
---|
| 124 | ; .. VALUE MAP @GARTN@("V","IEN","FIELDNAME")=VALUE
|
---|
| 125 | ; .. GARTN IS NOT INITIALIZED, SO MULTIPLE CALLS ARE CUMULATIVE
|
---|
[300] | 126 | ; .. IF GANN="ALL" THEN ALL FIELDS FOR THE FILE ARE IN THE FIELD MAP
|
---|
[301] | 127 | ; .. EVEN IF GANN="ALL" ONLY POPULATED FIELDS ARE RETURNED IN THE VALUE MAP
|
---|
| 128 | ; .. NUL FIELDS CAN BE DETERMINED BY CHECKING FIELD MAP - THIS SAVES SPACE
|
---|
| 129 | ; GAFILE IS THE FILE NUMBER TO BE PROCESSED. IT IS PASSED BY VALUE
|
---|
| 130 | ; GACNT IS THE NUMBER OF RECORDS TO PROCESS. IT IS PASSED BY VALUE
|
---|
[300] | 131 | ; .. IF GARCNT IS NULL, ALL RECORDS ARE PROCESSED
|
---|
[301] | 132 | ; GASTRT IS THE IEN OF THE FIRST RECORD TO PROCESS. IT IS PASSED BY VALUE
|
---|
[300] | 133 | ; .. IF GARSTART IS NULL, PROCESSING STARTS AT THE FIRST RECORD
|
---|
| 134 | ; GANN= NOT NULL - IF GANN IS "ALL" THEN EVEN NULL FIELDS WILL BE RETURNED
|
---|
| 135 | ; OTHERWISE, ONLY POPULATED FIELDS ARE RETURNED IN GARFLD AND GARVAL
|
---|
| 136 | N GATMP,GAI,GAF
|
---|
| 137 | S GAF=$$FILEREF(GAFILE) ; GET CLOSED ROOT FOR THE FILE NUMBER GAFILE
|
---|
| 138 | W GAF,!
|
---|
| 139 | W $O(@GAF@(0)) ;
|
---|
| 140 | S GAI=0 ;ITERATOR
|
---|
| 141 | ; F S GAI=$O(@GAF@
|
---|
| 142 | Q
|
---|
| 143 | ;
|
---|
| 144 | FILEREF(FNUM) ; EXTRINSIC THAT RETURNS A CLOSED ROOT FOR FILE NUMBER FNUM
|
---|
| 145 | ;
|
---|
[301] | 146 | N C0CF
|
---|
[300] | 147 | S C0CF=^DIC(FNUM,0,"GL") ;OPEN ROOT TO FILE
|
---|
| 148 | S C0CF=$P(C0CF,",",1)_")" ; CLOSE THE ROOT
|
---|
| 149 | Q C0CF
|
---|
| 150 | ;
|
---|
| 151 | ZFILE(ZFN,ZTAB) ; EXTRINSIC TO RETURN FILE NUMBER FOR FIELD NAME PASSED
|
---|
| 152 | ; BY VALUE IN ZFN. FILE NUMBER IS PIECE 1 OF @ZTAB@(ZFN)
|
---|
| 153 | ; IF ZTAB IS NULL, IT DEFAULTS TO C0CA
|
---|
| 154 | I '$D(ZTAB) S ZTAB="C0CA"
|
---|
| 155 | Q $P(@ZTAB@(ZFN),"^",1)
|
---|
| 156 | ZFIELD(ZFN,ZTAB) ;EXTRINSIC TO RETURN FIELD NUMBER FOR FIELD NAME PASSED
|
---|
| 157 | ; BY VALUE IN ZFN. FILE NUMBER IS PIECE 2 OF @ZTAB@(ZFN)
|
---|
| 158 | ; IF ZTAB IS NULL, IT DEFAULTS TO C0CA
|
---|
| 159 | I '$D(ZTAB) S ZTAB="C0CA"
|
---|
| 160 | Q $P(@ZTAB@(ZFN),"^",2)
|
---|
| 161 | ZVALUE(ZFN,ZTAB) ;EXTRINSIC TO RETURN VALUE FOR FIELD NAME PASSED
|
---|
| 162 | ; BY VALUE IN ZFN. FILE NUMBER IS PIECE 3 OF @ZTAB@(ZFN)
|
---|
| 163 | ; IF ZTAB IS NULL, IT DEFAULTS TO C0CA
|
---|
| 164 | I '$D(ZTAB) S ZTAB="C0CA"
|
---|
| 165 | Q $P(@ZTAB@(ZFN),"^",3)
|
---|
[301] | 166 | ;
|
---|