STANDARD DATA DICTIONARY #727.813 -- LABORATORY EXTRACT FILE                                                      3/24/25    PAGE 1
STORED IN ^ECX(727.813,  *** NO DATA STORED YET ***   SITE: WWW.BMIRWIN.COM   UCI: VISTA,VISTA                     (VERSION 3.0)   

DATA          NAME                  GLOBAL        DATA
ELEMENT       TITLE                 LOCATION      TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This file contains data elements as specified by the Decision Support System (DSS) Program Office for the Laboratory extract from
existing DHCP files. Entries into this file are made by extracting data by two different methods depending upon whether or not LMIP
codes are used. Using LMIP codes, the data are extracted, in large part, from the WKLD LOG file (#64.03) which is populated by a
routine provided by the Laboratory development team.  Not using LMIP codes, the data are derived from several Lab files as well as
from several other DHCP files. Once approved by the DSS site manager, entries in this file are loaded into an electronic mail
message and sent to the commercial vendor. This file is intended to be used for validation purposes only. Entries should be made
only by the extract load routine.  
  
Since validation techniques will be determined by the local site, it is intended that the site add whatever cross references deemed
necessary.  However, this file contains one nationally determined cross reference, the "AC" cross reference on the EXTRACT NUMBER
field (#2).  This cross reference is used by the DSS Extracts software package as an essential feature for managing and purging
data in this file and should not be modified.  
  
This file should NOT be modified directly using VA FileMan.  


COMPILED CROSS-REFERENCE ROUTINE: ECX813

CROSS
REFERENCED BY: EXTRACT NUMBER(AC)

    LAST MODIFIED: NOV 10,2022@09:15:09

727.813,.01   SEQUENCE NUMBER        0;1 NUMBER (Required)

              Sequence Number   
              INPUT TRANSFORM:  K:+X'=X!(X>999999999)!(X<1)!(X?.E1"."1N.N) X S:$D(X) DINUM=X
              LAST EDITED:      AUG 12, 1998 
              HELP-PROMPT:      Enter a number between 1 and 999999999, 0 decimal digits. 
              DESCRIPTION:
                                The record number for this extract entry.  

              TECHNICAL DESCR:
                                The internal entry number (IEN) for this record.  This entry is DINUMed.  

              NOTES:            XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER


727.813,1     YEAR MONTH             0;2 FREE TEXT

              Year/Month   
              INPUT TRANSFORM:  K:$L(X)>6!($L(X)<6)!'(X?6N) X
              OUTPUT TRANSFORM: S Y=$$ECXYMX^ECXUTL(Y)
              LAST EDITED:      SEP 24, 1997 
              HELP-PROMPT:      Answer must be 6 characters in length. 
              DESCRIPTION:
                                A six character string representing the year and the month for which this extract was performed.  

              TECHNICAL DESCR:  YEAR MONTH is derived by parsing the fileman format end date of the extract. The month is
                                determined by taking the 4th and 5th characters of the end date, the year by taking the 2nd and 3rd
                                characters, and the century is then calculated by taking the 1st character of the end date, and
                                adding 17 to  it. The Century is then concatenated with the year and month, giving the results in
                                YYYYMM format.  


727.813,2     EXTRACT NUMBER         0;3 POINTER TO DSS EXTRACT LOG FILE (#727)

              Extract Number   
              LAST EDITED:      JUL 30, 1996 
              HELP-PROMPT:      Enter the extract number for this extract. 
              DESCRIPTION:
                                The corresponding entry in the DSS EXTRACT LOG file (#727) for this extract.  

              TECHNICAL DESCR:  A pointer to the DSS EXTRACT LOG file (#727). The primary purpose is to pick up the header for the
                                mail message.  

              CROSS-REFERENCE:  727.813^AC 
                                1)= S ^ECX(727.813,"AC",$E(X,1,30),DA)=""
                                2)= K ^ECX(727.813,"AC",$E(X,1,30),DA)
                                3)= DO NOT DELETE.
                                This cross reference is essential for managing and purging data in this file.  



727.813,3     FACILITY               0;4 FREE TEXT

              Facility   
              INPUT TRANSFORM:  K:$L(X)>7!($L(X)<1) X
              MAXIMUM LENGTH:   7
              LAST EDITED:      MAY 10, 2018 
              HELP-PROMPT:      Answer must be 1-7 characters in length. 
              DESCRIPTION:
                                This is the facility/division where the specimen was drawn or the test was accessioned.  

              TECHNICAL DESCR:  An indicator of the facilty/division where the specimen was collected or test was accessioned.
                                Using the ACCESSIONING INSTITUTION field (.112) of the CHEM, HEM, TOX, RIA, SER, etc. multiple (4)
                                in the LAB DATA file (#63), FACILITY is derived from the STATION NUMBER field (99) for that pointer
                                number in the INSTITUTION file (#4).  
                                 
                                If an institution file entry is defined but that entry doesn't have a station number then 9999A
                                will be used to indicate a non-VA site was identified.  


727.813,4     PATIENT NO. - DFN      0;5 NUMBER

              Patient No. - DFN   
              INPUT TRANSFORM:  K:+X'=X!(X>999999999)!(X<1)!(X?.E1"."1N.N) X
              LAST EDITED:      MAR 09, 2012 
              HELP-PROMPT:      Type a number between 1 and 999999999, 0 decimal digits. 
              DESCRIPTION:
                                An identifying number for the patient at the local site.  

              TECHNICAL DESCR:  Data for this field is derived from the PATIENT field (#2) from the WKLD LOG FILE file (64.03)
                                which is a variable pointer field to either the PATIENT file (#2) or the REFERRAL PATIENT file
                                (#67). The patient's Internal entry number is derived by taking the first piece up to the ";" 
                                character.  


727.813,5     SSN IDENTIFYING NUMBER 0;6 FREE TEXT

              Social Security Identifying Number   
              INPUT TRANSFORM:  K:$L(X)>10!($L(X)<9)!'(X?9N!X?9N1"P") X
              LAST EDITED:      OCT 17, 1996 
              HELP-PROMPT:      Your answer must be 9 to 10 characters in length. 
              DESCRIPTION:
                                The patient's social security number or the identifying number for a referral patient. 

              TECHNICAL DESCR:  If the source for the record is the REFERRAL PATIENT file (#67), the data for this field is derived
                                from the IDENTIFIER field (#.09) in the REFERRAL PATIENT file (#67). If that field is NULL, or less
                                than 9 characters, a default value of "000123456" will be used.  
                                 
                                If the source for the record is the PATIENT file (#2), Using the patient pointer (DFN) stored in
                                the PATIENT NO. - DFN (#4) field in this file, SSN data is derived from the SOCIAL SECURITY NUMBER
                                field (#.09) in the PATIENT (#2) file. A "Test" patient status is determined in PAT^ECXUTL3.  Any
                                patient with an SSN beginning with "00000" will not be included in the extract.  


727.813,6     NAME                   0;7 FREE TEXT

              Name   
              INPUT TRANSFORM:  K:$L(X)>4!($L(X)<4) X
              LAST EDITED:      JUL 30, 1996 
              HELP-PROMPT:      Your answer must be 4 characters in length. 
              DESCRIPTION:
                                The first four characters of the patient's last name.  

              TECHNICAL DESCR:  If the source for the record is the REFERRAL PATIENT file (#67), the data for this field is derived
                                from the NAME field (#.01) in the REFERRAL PATIENT file (#67).  
                                 
                                If the source for the record is the PATIENT file (#2), using the patient pointer (DFN) stored in
                                the PATIENT NO. - DFN (#4) field in this file, NAME data is derived from the NAME field (#.01) in
                                the PATIENT (#2) file. The name value is returned by the  supported call DEM^VADPT.  
                                 
                                In both cases, the first four characters of the first "," piece are used, padded with trailing
                                spaces if necessary.  


727.813,7     IN OUT PATIENT INDICATOR 0;8 SET

              In Out Patient Indicator   
                                'I' FOR INPATIENT; 
                                'O' FOR OUTPATIENT; 
                                'A' FOR ASIH (OTHER FACILITY); 
              LAST EDITED:      JUN 29, 2018 
              HELP-PROMPT:      Enter the patient's status at the time of the lab test. 
              DESCRIPTION:
                                Indicates the patient's status for this extract entry.  

              TECHNICAL DESCR:  To determine the value of this field a call is made to $$PATDEM^ECXUTL2. Within this call,
                                $$INP^ECXUTL2 is called to determine patient status.  If the patient is an outpatient, processing
                                stops and the field is set to O.   If the patient is an inpatient then $$INOUTP^ECXUTL4 is called
                                to look at the treating specialty.  If the patient's treating specialty exists in the DSS TREATING
                                SPECIALTY TRANSLATION file (#727.831) then the value of the INPAT/OUTPAT CODE field (#5) of the DSS
                                TREATING SPECIALTY TRANSLATION file (#727.831) is used.  If the treating specialty is not found in
                                the DSS TREATING SPECIALTY TRANSLATION file (#727.831) then the indicator is set to I.  
                                 
                                If the patient is ASIH to another facility at the date/time in question then the indicator is set
                                to A.  


727.813,8     DAY                    0;9 FREE TEXT

              Day   
              INPUT TRANSFORM:  K:$L(X)>8!($L(X)<8) X
              OUTPUT TRANSFORM: S Y=$$ECXDATEX^ECXUTL(Y)
              LAST EDITED:      SEP 24, 1997 
              HELP-PROMPT:      Answer must be 8 characters in length. 
              DESCRIPTION:
                                Date the last test/specimen was collected.  

              TECHNICAL DESCR:  Data is inserted in this field by Laboratory routine ECXLABN and is derived from the DATE/TIME
                                COLLECTED field (#12) of the WKLD LOG file (#64.03).  
                                 
                                The value in the DATE/TIME COLLECTED field (#12) in the WKLD LOG file (#64.03) originated from
                                routine LRCAPDSS and is derived from the INVERSE DATE COMPLETED field (#21) of the ACCESSION WKLD
                                CODE TIME sub-file (#64.1111).  
                                 
                                This field is always exactly 8 numeric characters in length.  The format is YYYYMMDD; for example,
                                19970923.  If the date cannot be determined, then a default is used.  The default date value is the
                                value of the YEAR MONTH field (#1) of this file concatenated with "01" for the day (DD) portion.  


727.813,9     ACCESSION AREA         0;10 FREE TEXT

              Accession Area   
              INPUT TRANSFORM:  K:$L(X)>5!($L(X)<1) X
              LAST EDITED:      JAN 20, 1998 
              HELP-PROMPT:      Answer must be 1-5 characters in length. 
              DESCRIPTION:
                                The accession area where the lab specimen was received.  

              TECHNICAL DESCR:  For a laboratory procedure on a routine medical center patient, this field will contain the IEN of
                                the ACCESSION file (#68) as pointed to by the ACCESSION AREA field (#6) of the WKLD LOG file
                                (64.03).  
                                 
                                For a procedure on a referral patient, this field will contain the first two characters of the
                                AGENCY CODE field (#95) of the INSTITUTION file (#4).  Coinciding with the LOCATION field, If the
                                referring facility doesn't exist or is not found in the INSTITUTION file (#4), this field will be
                                set to XX.  If the referring facility is found in the INSTITUTION file (#4) and not containing a
                                STATION NUMBER (#99), this field will be set to ZZ.  


727.813,10    ABBREVIATION           0;11 FREE TEXT

              Abbreviation   
              INPUT TRANSFORM:  K:$L(X)>5!($L(X)<1) X
              LAST EDITED:      JUL 30, 1996 
              HELP-PROMPT:      Your answer must be 1 to 5 characters in length. 
              DESCRIPTION:
                                The abbreviation for the accession area where the lab specimen was received.  

              TECHNICAL DESCR:
                                Data for this field is derived from the ABBREVIATION field (#.09) in the ACCESSION file (#68).  


727.813,11    TEST                   0;12 POINTER TO LABORATORY TEST FILE (#60)

              Test   
              LAST EDITED:      JUL 30, 1996 
              HELP-PROMPT:      Enter the lab test for this entry. 
              DESCRIPTION:
                                The lab test performed.  

              TECHNICAL DESCR:  Data for this field is derived from the LAB TEST NAME field (#7) from the WKLD LOG FILE file
                                (#64.03) which is a pointer to the LABORATORY TEST file (#60).  


727.813,12    URGENCY OF TEST        0;13 POINTER TO URGENCY FILE (#62.05)

              Urgency of Test   
              LAST EDITED:      JUL 30, 1996 
              HELP-PROMPT:      Enter urgency of test completed. 
              DESCRIPTION:
                                The turnaround time requested.  

              TECHNICAL DESCR:  Data for this field is derived from the URGENCY OF TEST field (#8) from the WKLD LOG FILE file
                                (#64.03), which is a pointer to the URGENCY file (#62.05).  


727.813,13    TREATING SPECIALTY     0;14 FREE TEXT

              Treating Specialty   
              INPUT TRANSFORM:  K:$L(X)>3!($L(X)<2) X
              LAST EDITED:      NOV 03, 2009 
              HELP-PROMPT:      Answer must be 2-3 characters in length 
              DESCRIPTION:
                                The PTF CODE of the treating specialty associated with this extract record.  

              TECHNICAL DESCR:  This field is initialized to a null, indicating an outpatient status. 
                                 
                                If a call to IN5^VADPT (using the patient IEN and the event date) returns a patient movement number
                                (indicating inpatient status), then the value of VAIP(8), which is the pointer to the FACILITY
                                TREATING SPECIALTY file (#45.7), is used to get the SPECIALTY field (1) which points to the 
                                SPECIALTY file (#42.4).  
                                 
                                Then, the PTF CODE field (#7) of the SPECIALTY file (#42.4) is obtained and stored instead of the
                                IEN of the specialty.  
                                 
                                Otherwise, this field is derived from the TREATING SPECIALTY field (#9) of the WKLD LOG FILE file
                                (#64.03).  


727.813,14    LOCATION               0;15 FREE TEXT

              Location   
              INPUT TRANSFORM:  K:$L(X)>20!($L(X)<1) X
              LAST EDITED:      JUL 08, 1998 
              HELP-PROMPT:      Answer must be 1-20 characters in length. 
              DESCRIPTION:
                                The service/location from which the original order came.  

              TECHNICAL DESCR:  For regular patients, this field is set to the IEN of the record in the HOSPITAL LOCATION file
                                (#44) as copied from the ORDERING LOCATION field (#20) of the ACCESSION WKLD CODE TIME field (#1)
                                multiple within the CODE field (#1) multiple within the DATE field (#.03) multiple of the WKLD DATA 
                                file (#64.1).  
                                 
                                For referral patients, and the referring facility is found in the INSTITUTION (#4) file, this field
                                is set to the STATION NUMBER (#99) field of the referring facility.  If the STATION NUMBER (#99)
                                field is null, this field is set to ZZZZZ.  
                                                                 
                                For referral patients, and the referring facility is NOT found in the INSTITUTION file (#4), this
                                field is set to XXXXX.  


727.813,15    PROVIDER               0;16 FREE TEXT

              Provider   
              INPUT TRANSFORM:  K:$L(X)>11!($L(X)<1) X
              LAST EDITED:      OCT 17, 1996 
              HELP-PROMPT:      Enter the provider for this record. 
              DESCRIPTION:
                                The provider assigned to this patient or entity.  

              TECHNICAL DESCR:  Data for this field is derived by concatenating a '2' to the front of the PROVIDER field (#1) from
                                the WKLD LOG FILE file (#64.03). The '2' indicates that the provider information is from the NEW
                                PERSON file (#200).  


727.813,16    MOVEMENT FILE #        0;17 POINTER TO PATIENT MOVEMENT FILE (#405)

              Movement File Number   
              LAST EDITED:      JUL 30, 1996 
              HELP-PROMPT:      Enter the movement number associated with this patient or null for an entity.  
              DESCRIPTION:      Movement number from the PATIENT MOVEMENT file (#405) associated with this event for a patient. 
                                This field will be set to null for non- patient or outpatient events.  

              TECHNICAL DESCR:  This field is initialized to a null, indicating an outpatient status.  If a call to IN5^VADPT
                                (using the patient IEN and the event date) returns a patient movement number (indicating inpatient
                                status), then this field is set to the value of VAIP(1), which is the pointer to the PATIENT
                                MOVEMENT file (#405). 


727.813,17    FILE                   0;18 FREE TEXT

              File   
              INPUT TRANSFORM:  K:$L(X)>5!($L(X)<1) X
              LAST EDITED:      OCT 22, 1996 
              HELP-PROMPT:      Your answer must be 1 to 5 characters in length. 
              DESCRIPTION:      Parent file from which the patient information was extracted. Either the PATIENT file (#2) or
                                REFERRAL PATIENT file (#67).  

              TECHNICAL DESCR:  Data for this field is derived from the Variable Pointer PATIENT NAME field (#2) in the WKLD LOG
                                FILE file (#64.03). If the PATIENT NAME is a pointer the PATIENT file (#2) this field will be set
                                to '2'. If the PATIENT NAME is a pointer to the REFERRAL PATIENT file (#67), this field will be set
                                to '67'.  


727.813,18    TIME                   0;19 FREE TEXT

              Time   
              INPUT TRANSFORM:  K:$L(X)>6!($L(X)<6)!'(X?6N) X
              OUTPUT TRANSFORM: S Y=$$ECXTIMEX^ECXUTL(Y,1)
              LAST EDITED:      SEP 24, 1997 
              HELP-PROMPT:      Answer must be 6 characters in length. 
              DESCRIPTION:      A 6-character numeric string that represents the time of day at which the Laboratory test was
                                collected.  

              TECHNICAL DESCR:  Data is inserted in this field by Laboratory routine ECXLABN and is derived from the DATE/TIME
                                COLLECTED field (#12) of the WKLD LOG file (#64.03).  
                                 
                                The value in the DATE/TIME COLLECTED field (#12) in the WKLD LOG file (#64.03) originated from
                                routine LRCAPDSS and is derived from the INVERSE  DATE COMPLETED field (#21) of the ACCESSION WKLD
                                CODE TIME sub-file (#64.1111).  
                                 
                                This field is always exactly 6 numeric characters in length; if time cannot be determined, then
                                "000300" is used as default.  


727.813,19    WORKLOAD CODE          0;20 FREE TEXT

              Workload Code   
              INPUT TRANSFORM:  K:$L(X)>10!($L(X)<1) X
              LAST EDITED:      OCT 17, 1996 
              HELP-PROMPT:      Your answer must be 1 to 10 characters in length. 
              DESCRIPTION:
                                This is the workload code for this event.  

              TECHNICAL DESCR:  Data for this field is derived by taking the WKLD CODE field (#10) of the WKLD LOG FILE file
                                (#64.03) which is a pointer to the WKLD CODE file (#64) and retrieving the WKLD CODE field (#1)
                                from that file.  


727.813,20    PLACEHOLD PRIMARY CARE TEAM 0;21 FREE TEXT

              Primary Care Team   
              INPUT TRANSFORM:  K:$L(X)>4!($L(X)<1) X
              LAST EDITED:      MAY 01, 2018 
              HELP-PROMPT:      Enter the primary care team assigned to this patient. 
              DESCRIPTION:      This field, previously known as PRIMARY CARE TEAM, is no longer needed.  The name has been changed
                                to PLACEHOLD PRIMARY CARE TEAM and its value will be set to null.  

              TECHNICAL DESCR:
                                This field is no longer in use as of patch ECX*3*170.  


727.813,21    PLACEHOLD PC PROVIDER  0;22 FREE TEXT

              Primary Care Provider   
              INPUT TRANSFORM:  K:$L(X)>11!($L(X)<1) X
              LAST EDITED:      MAY 01, 2018 
              HELP-PROMPT:      Enter primary care provider assigned to this patient. 
              DESCRIPTION:      This field, previously known as PRIMARY CARE PROVIDER, is no longer needed. The name has been
                                changed to PLACEHOLD PC PROVIDER and its value will be set to null.  

              TECHNICAL DESCR:
                                This field is no longer in use as of patch ECX*3*170.  


727.813,22    PLACEHOLD MPI          1;1 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>10!($L(X)<1) X
              LAST EDITED:      APR 29, 2022 
              HELP-PROMPT:      Answer must be 1-10 characters in length. 
              DESCRIPTION:      This field, previously known as MASTER PATIENT INDEX, is no longer needed. The name has been
                                changed to PLACEHOLD MPI and its value will be set to null.  

              TECHNICAL DESCR:
                                This field is no longer in use as of patch ECX*3*184.  


727.813,23    PLACEHOLDER            1;2 FREE TEXT

                  
              INPUT TRANSFORM:  K:$L(X)>10!($L(X)<1) X
              LAST EDITED:      APR 19, 2016 
              HELP-PROMPT:      Answer must be 1-10 characters in length. 
              DESCRIPTION:      This field, previously known as DSS PRODUCT DEPARTMENT, is no longer needed.  The name has been
                                changed to PLACEHOLDER and its value will be set to null.  

              TECHNICAL DESCR:
                                This field is no longer in use as of patch ECX*3*161.  


727.813,24    PLACEHOLDER            1;3 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>8!($L(X)<1) X
              LAST EDITED:      APR 26, 2007 
              HELP-PROMPT:      Answer must be 1-8 characters in length. 
              DESCRIPTION:
                                Currently NULL.  

              TECHNICAL DESCR:
                                Currently NULL.  


727.813,25    PLACEHOLDER            1;4 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>8!($L(X)<1) X
              LAST EDITED:      APR 26, 2007 
              HELP-PROMPT:      Answer must be 1-8 characters in length. 
              DESCRIPTION:
                                Currently NULL.  

              TECHNICAL DESCR:
                                Currently NULL.  


727.813,26    PLACEHOLD PC PROV PERSON CLASS 1;5 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>7!($L(X)<7) X
              LAST EDITED:      MAY 01, 2018 
              HELP-PROMPT:      Answer must be 7 characters in length. 
              DESCRIPTION:      This field, previously known as PC PROVIDER PERSON CLASS, is no longer needed. The name has been
                                changed to PLACEHOLD PC PROV PERSON CLASS and its value will be set to null.  

              TECHNICAL DESCR:
                                This field is no longer in use as of patch ECX*3*170.  


727.813,27    PLACEHOLD ASSOC PC PROVIDER 1;6 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>11!($L(X)<2) X
              LAST EDITED:      MAY 01, 2018 
              HELP-PROMPT:      Answer must be 2-11 characters in length. 
              DESCRIPTION:      This field, previously known as ASSOCIATE PC PROVIDER, is no longer needed. The name has been
                                changed to PLACEHOLD ASSOC PC PROVIDER and its value will be set to null.  

              TECHNICAL DESCR:
                                This field is no longer in use as of patch ECX*3*170.  


727.813,28    PLACEHOLD AS PC PROV PERSON CL 1;7 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>7!($L(X)<7) X
              LAST EDITED:      MAY 01, 2018 
              HELP-PROMPT:      Answer must be 7 characters in length. 
              DESCRIPTION:      This field, previously known as ASSOC. PC PROV. PERSON CLASS, is no longer needed. The name has
                                been changed to PLACEHOLD AS PC PROV PERSON CL and its value will be set to null.  

              TECHNICAL DESCR:
                                This field is no longer in use as of patch ECX*3*170.  


727.813,29    PLACEHOLDER            1;8 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>8!($L(X)<1) X
              LAST EDITED:      APR 26, 2007 
              HELP-PROMPT:      Answer must be 1-8 characters in length. 
              DESCRIPTION:
                                Currently NULL.  

              TECHNICAL DESCR:
                                Currently NULL.  


727.813,30    DOM,PRRTP AND SAARTP INDICATOR 1;9 SET

                                'P' FOR GEN. PRRTP; 
                                'T' FOR PTSD PRRTP; 
                                'S' FOR DOM. PRRTP; 
                                'H' FOR HOMELESS CWT/TR; 
                                'A' FOR SA CWT/TR; 
                                'D' FOR DOMICILIARY; 
                                'B' FOR PTSD CWT/TR; 
                                'C' FOR GEN. CWT/TR; 
              LAST EDITED:      MAR 14, 2012 
              HELP-PROMPT:      Enter the indicator associated with the treating specialty assigned to this record. 
              DESCRIPTION:      Indicates if the patient is admitted to either a RRTP, PRRTP, or SARRTP at the time care is
                                provided.  

              TECHNICAL DESCR:  If the patient's treating specialty exist in the DSS TREATING SPECIALTY TRANSLATION file
                                (#727.831), data is derived from the DOM/PRRTP/SARRTP CODE field (#2) of the DSS TREATING SPECIALTY
                                TRANSLATION file (#727.831).  
                                 
                                Otherwise, the value is null.  


727.813,31    OBSERVATION PATIENT INDICATOR 1;10 SET

                                'NO' FOR NO; 
                                'YES' FOR YES; 
              LAST EDITED:      MAR 14, 2012 
              HELP-PROMPT:      Enter observation patient status for this record. 
              DESCRIPTION:
                                Indicates if patient is considered to be an observation patient.  

              TECHNICAL DESCR:  Data (YES, NO) is retrieved from API call $$OBSPAT^ECXUTL4: 
                                 
                                If the patient's treating specialty exist in the DSS TREATING SPECIALTY TRANSLATION file
                                (#727.831), data is derived from the OBSERVATION PAT INDICATOR field (#4) of the DSS TREATING
                                SPECIALTY TRANSLATION  file (#727.831).  
                                 
                                If patient is outpatient and treating specialty not in file, AND Feeder Key (CLI) or DSS ID
                                (MTL,IVP,ECQ,NOS,SUR) is 290-297, Observation Patient Ind=YES.  Else, Observation Patient Ind=NO.  
                                 
                                Otherwise, Observation Patient Ind=NO.  


727.813,32    ENCOUNTER NUMBER       1;11 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>18!($L(X)<1) X
              LAST EDITED:      MAY 09, 2001 
              HELP-PROMPT:      Answer must be 1-18 characters in length 
              DESCRIPTION:
                                The unique number assigned for DSS.  

              TECHNICAL DESCR:  This field is determined by a call to $$ENCNUM^ECXUTL4.  Within this call the inpatient/outpatient
                                status, SSN, admit/visit date, treating specialty, observation patient indicator, and DSS
                                Identifier or feeder key values of the record are used to create a unique encounter number.  


727.813,33    ORDERING STOP CODE     1;12 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>3!($L(X)<3) X
              LAST EDITED:      MAY 09, 2001 
              HELP-PROMPT:      Answer must be 3 characters in length. 
              DESCRIPTION:
                                This field contains the stop code associated with the order.  

              TECHNICAL DESCR:  The STOP CODE field (#1) associated with the ordering location for this order as obtained from the
                                CLINICS AND STOP CODES file (#728.44).  
                                 
                                Ordering location is derived from the HOSPITAL LOCATION field (#14) of the processing WKLD LOG FILE
                                (#64.03) of this extract.  


727.813,34    ORDERING DATE          1;13 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>8!($L(X)<8) X
              LAST EDITED:      MAY 09, 2001 
              HELP-PROMPT:      Answer must be 8 characters in length 
              DESCRIPTION:
                                Date test was ordered.  

              TECHNICAL DESCR:  ORDERING DATE is derived by parsing the fileman format date of the LAB order. The month is
                                determined by taking the 4th and 5th characters of the order date, the year by taking the 2nd and
                                3rd characters, the Day by taking the 6th and 7th, and the century is then calculated by taking the 
                                1st character of the  order date, and adding 17 to it. The Century is then concatenated with the
                                year, month and day, giving the results in YYYYMMDD format.  


727.813,35    PRODUCTION DIVISION    1;14 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>6!($L(X)<3) X
              MAXIMUM LENGTH:   6
              LAST EDITED:      MAY 10, 2018 
              HELP-PROMPT:      Answer must be 3-6 characters in length. 
              DESCRIPTION:
                                Data represents the facility/division the lab test was performed in.  

              TECHNICAL DESCR:  An indicator of the facility/division where the test was performed. Using the RELEASING SITE field
                                (.345) of the CHEM, HEM, TOX, RIA, SER, etc.  multiple (4) in the LAB DATA file (#63), PRODUCTION
                                DIVISION is derived from the STATION NUMBER field (99) for that pointer number in the INSTITUTION
                                file (#4).  
                                 
                                If an institution file entry is defined but that entry doesn't have a station number then 9999R
                                will be used to indicate a non-VA site was identified.  


727.813,36    PLACEHOLD DSS IP #     1;15 NUMBER

              INPUT TRANSFORM:  K:+X'=X!(X>9999999)!(X<1)!(X?.E1"."1N.N) X
              LAST EDITED:      FEB 04, 2019 
              HELP-PROMPT:      Type a Number between 1 and 9999999, 0 Decimal Digits 
              DESCRIPTION:      This field, previously known as DSS IP #, is no longer needed. The name has been changed to
                                PLACEHOLD DSS IP # and its value will be set to null.  

              TECHNICAL DESCR:
                                This field is no longer in use as of patch ECX*3*174.  


727.813,37    ORDERING PROVIDER PERSON CLASS 1;16 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>7!($L(X)<7) X
              LAST EDITED:      APR 05, 2005 
              HELP-PROMPT:      Answer must be 7 characters in length. 
              DESCRIPTION:
                                VA code of the Person Class of the patient's Ordering Provider.  

              TECHNICAL DESCR:  Active Person Class is determined by the supported call $$GET^XUA4A72(PERS,DATE), where PERS is the
                                IEN from file #200 and DATE is the date of the event.  The VA CODE is determined by the 7th piece
                                of the returned value string.  


727.813,38    ERI                    1;17 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>2!($L(X)<1) X
              MAXIMUM LENGTH:   2
              LAST EDITED:      MAY 05, 2020 
              HELP-PROMPT:      Answer must be 1-2 characters in length. 
              DESCRIPTION:      This field identifies patients from impacted zip code areas designated by the Federal Emergency
                                Management Agency (FEMA).  

              TECHNICAL DESCR:  This field is extracted from the EMERGENCY RESPONSE INDICATOR field (#.181) located in the PATIENT
                                file (#2). Values are: 
                                    "K" = Hurricane Katrina 
                                    "P" = Pandemic 
                                    Null 


727.813,39    PLACEHOLD ASSOC PC PROV NPI 1;18 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>15!($L(X)<1) X
              LAST EDITED:      MAY 01, 2018 
              HELP-PROMPT:      Answer must be 1-15 characters in length. 
              DESCRIPTION:      This field, previously known as ASSOCIATE PC PROVIDER NPI, is no longer needed. The name has been
                                changed to PLACEHOLD ASSOC PC PROV NPI and its value will be set to null.  

              TECHNICAL DESCR:
                                This field is no longer in use as of patch ECX*3*170.  


727.813,40    PLACEHOLD PC PROVIDER NPI 1;19 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>15!($L(X)<1) X
              LAST EDITED:      MAY 01, 2018 
              HELP-PROMPT:      Answer must be 1-15 characters in length. 
              DESCRIPTION:      This field, previously known as PRIMARY CARE PROVIDER NPI, is no longer needed. The name has been
                                changed to PLACEHOLD PC PROVIDER NPI and its value will be set to null.  

              TECHNICAL DESCR:
                                This field is no longer in use as of patch ECX*3*170.  


727.813,41    PROVIDER NPI           1;20 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>15!($L(X)<1) X
              LAST EDITED:      MAY 04, 2007 
              HELP-PROMPT:      Answer must be 1-15 characters in length. 
              DESCRIPTION:      A standard unique life-long identifier of the individuals providing health care services.  This
                                field has a length of fifteen characters.  

              TECHNICAL DESCR:  PROVIDER NPI is a standard unique life-long identifier of the individuals providing health care
                                services.  The qualified identifier shall be retrieved via the supporting Kernel API:$$NPI^XUSNPI.  


727.813,42    LOINC CODE             1;21 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>10!($L(X)<1) X
              LAST EDITED:      MAY 09, 2008 
              HELP-PROMPT:      Answer must be 1-10 characters in length 
              DESCRIPTION:
                                A universal coding standard for identifying laboratory observations.  

              TECHNICAL DESCR:  Using the patient's lab reference number, the accession area subscript (currently only "CH" is
                                supported), the inverse date/time of collection, and the lab data name internal entry number, a
                                call is made to TSTRES^LRRPU.  
                                 
                                This function will return the LOINC CODE from the LAB DATA (#63) file for the specific lab test and
                                is based on the LOINC CODE (#95.3) field of the SITE/SPECIMEN (#100) multiple in the LABORATORY
                                TEST (#60) file.  


727.813,43    LAB BILLABLE PROCEDURE 1;22 SET

                                'Y' FOR YES; 
                                'N' FOR NO; 
              LAST EDITED:      MAR 08, 2010 
              HELP-PROMPT:      Is the test a billable LMIP procedure? 
              DESCRIPTION:      If a "Y" is entered it will indicate that the test is considered a  billable LMIP procedure (lab
                                billable means Lab staff workload).  

              TECHNICAL DESCR:  This field indicates if the test is considered to be a billable LMIP procedure or not (lab billable
                                means Lab staff workload).  
                                 
                                This field is derived from the BILLABLE PROCEDURE (#4) field of the WKLD CODE (#64) file.  


727.813,44    DSS FEEDER KEY         1;23 SET

                                'Y' FOR YES; 
                                'N' FOR NO; 
              LAST EDITED:      SEP 13, 2010 
              HELP-PROMPT:      Should the workload code be used for DSS Laboratory data collection? 
              DESCRIPTION:
                                If a "Y" is entered it indicates the WKLD Code should be used for DSS Laboratory data collection.  

              TECHNICAL DESCR:  This field indicates whether the WKLD CODE should be used for DSS Laboratory data collection. Codes
                                that are defined as 'Y' (YES) will be extracted and passed to the DSS Laboratory API.  
                                 
                                This field is based on the value of the DSS FEEDER KEY (#14) field of the WKLD CODE (#64) file.  


727.813,45    DATA NAME              2;1 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>40!($L(X)<3) X
              LAST EDITED:      AUG 26, 2010 
              HELP-PROMPT:      Answer must be 3-40 characters in length. 
              DESCRIPTION:
                                This field is the Lab Test Data Name.  

              TECHNICAL DESCR:  Obtained via the WKLD LOG FILE (#64.03), DATA NAME field (#20).  
                                 
                                This field will allow lab management and DSS staff to know whether the entry is a panel test and if
                                it has been designated as a separately billable test.  If this field has a value then it is not a
                                panel test and is individually billable.  If this field does not have a value then it's a panel
                                test and is billable as a unit.  


727.813,46    DATA LOCATION          2;2 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>12!($L(X)<4) X
              LAST EDITED:      MAR 08, 2010 
              HELP-PROMPT:      Answer must be 4-12 characters in length. 
              DESCRIPTION:      The Data Location field is only populated if a test is a non-panel test  and is part of the CHEM,
                                HEM, TOX, SER, RIA, etc. area.  

              TECHNICAL DESCR:
                                This field is derived from the LOCATION (DATA NAME) field (#5) of the LABORATORY file (#60).  


727.813,47    PATCAT                 2;3 SET

                                'AD' FOR Active Duty; 
                                'ADD' FOR Active Duty Dependent; 
                                'FNRS' FOR Former Non-Remarried Spouse; 
                                'RET' FOR Retired; 
                                'RETD' FOR Retiree Dependent; 
                                'RES' FOR Reservist; 
                                'REC' FOR Recruit; 
                                'TDRL' FOR Temporary Disability; 
                                'TFL' FOR TRICARE for Life; 
              LAST EDITED:      SEP 03, 2010 
              HELP-PROMPT:      Select the Patient's Category for the FHCC Reconciliation process. 
              DESCRIPTION:      This is the Patient's category which will be used for FHCC (Federal Health Care Center)
                                Reconciliation.  DSS must capture and report DoD patients so that the FHCC reconciliation process
                                can function as designed. "Reconciliation" is the process used within the new FHCC to determine
                                which patients DoD pays for and which VA pays for.  

              TECHNICAL DESCR:  If the VistA Patient Type Code (TYPE field (#391) of the Patient file (#2) ) = Active Duty,
                                Military Retiree, or TRICARE, then the value(s) in the VistA Other Eligibility multiple (PATIENT
                                ELIGIBILITIES field (#361) of the PATIENT file (#2)), which points to locally modifiable
                                ELIGIBILITY CODE file (#8) should be evaluated. If the value in the ELIGIBILITY CODE is equal to
                                any entry in the set of codes in this field, the value should be placed in this field.  


727.813,48    PLACEHOLD ENCOUNTER SC 2;4 SET

                                'Y' FOR YES; 
                                'N' FOR NO; 
              LAST EDITED:      FEB 04, 2019 
              HELP-PROMPT:      Is this Encounter Service Connected? 
              DESCRIPTION:      This field, previously known as ENCOUNTER SC, is no longer needed. The name has been changed to
                                PLACEHOLD ENCOUNTER SC and its value will be set to null.  

              TECHNICAL DESCR:
                                This field is no longer in use as of patch ECX*3*174.  


727.813,49    CAMP LEJEUNE STATUS    2;5 SET

                                'Y' FOR YES; 
                                'N' FOR NO; 
              LAST EDITED:      MAR 09, 2013 
              HELP-PROMPT:      Indicate Camp Lejeune status for the patient. 
              DESCRIPTION:      Indicates if patient was exposed to contaminated water while stationed at Camp Lejeune, NC between
                                January 1, 1957 and December 31, 1987.  

              TECHNICAL DESCR:  Using the patient's DFN, a call is made to PAT^ECXUTL3, which in turn calls SVC^VADPT. This call
                                returns all service related information for a patient, including their Camp Lejeune status.  


727.813,50    PATHOLOGIST            2;6 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>11!($L(X)<2) X
              LAST EDITED:      APR 18, 2014 
              HELP-PROMPT:      Answer must be 2-11 characters in length. 
              DESCRIPTION:
                                This is the pathologist who performed the anatomic pathology workload for the record.  

              TECHNICAL DESCR:  This field comes from the PATHOLOGIST field (#22) of the WKLD LOG FILE (#64.03).  The PATHOLOGIST
                                field (#22) is populated based on data found in the LAB DATA file (#63).  For each accession area
                                that contains pathologist information, the data is found as follows: 
                                 
                                For cytopathology, the data comes from the PATHOLOGIST/CYTOTECHNOLOGIST field (#.02) of the
                                CYTOPATHOLOGY multiple (#9) of the LAB DATA file (#63).  
                                                                 
                                For Surgical Pathology, the data comes from the PATHOLOGIST field (#.02) of the SURGICAL PATHOLOGY
                                multiple (#8) of the LAB DATA file (#63).  
                                                                 
                                For Electron Microscopy, the data comes from the PATHOLOGIST field (#.02) of the EM multiple (#2)
                                of the LAB DATA file (#63).  
                                                                 
                                For Autopsy, the data comes from the SENIOR PATHOLOGIST field (#13.6) of the LAB DATA file (#63).  
                                 
                                A "2" is prefixed to the pointer value to indicate that the source file is "200".  For example, if
                                the IEN of the provider in file #200 is 98765, the value that will be stored is 298765.  


727.813,51    PATHOLOGIST PERSON CLASS 2;7 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>7!($L(X)<1) X
              LAST EDITED:      MAR 06, 2014 
              HELP-PROMPT:      Answer must be 1-7 characters in length. 
              DESCRIPTION:      The VA Code of the Person Class of the pathologist associated with this record.  The VA Code is
                                always of the form "V"_six numeric digits; exactly 7.  

              TECHNICAL DESCR:  Active Person Class is determined by $$GET^XUA4A72(PERS,DATE), where PERS is the IEN from file #200
                                and DATE is the completion date.  


727.813,52    PATHOLOGIST PROVIDER NPI 2;8 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>10!($L(X)<1) X
              LAST EDITED:      MAR 06, 2014 
              HELP-PROMPT:      Answer must be 1-10 characters in length. 
              DESCRIPTION:
                                A standard unique life-long identifier of the pathologist.  

              TECHNICAL DESCR:
                                The qualified identifier is retrieved via the supporting Kernel API: $$NPI^XUSNPI.  


727.813,53    CPT, QTY & MODIFIERS #1 2;9 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>20!($L(X)<1) X
              MAXIMUM LENGTH:   20
              LAST EDITED:      JUN 13, 2018 
              HELP-PROMPT:      Answer must be 1-20 characters in length. 
              DESCRIPTION:
                                This is the CPT code associated with the workload code identified for this specific lab test.  

              TECHNICAL DESCR:  The CPT code is obtained from the CODE field, of the CODE multiple, in the WKLD CODE file (#64) for
                                the related laboratory procedure/test.  


727.813,54    PLACEHOLD CERNER       3;1 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>572!($L(X)<1) X
              MAXIMUM LENGTH:   572
              LAST EDITED:      APR 29, 2022 
              HELP-PROMPT:      Answer must be 1-572 characters in length. 
              DESCRIPTION:
                                Placeholder for Cerner fields. Reserved for EHRM conversion.  

              TECHNICAL DESCR:
                                Placeholder for Cerner fields. Reserved for EHRM conversion.  


727.813,55    NEW MPI                4;1 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>20!($L(X)<1) X
              MAXIMUM LENGTH:   20
              LAST EDITED:      APR 29, 2022 
              HELP-PROMPT:      Answer must be 1-20 characters in length. 
              DESCRIPTION:      A national VA system IDENTIFIER which uniquely identifies a patient.  
                                 
                                Commonly called "Patient ICN" or "Patient IEN"; not to be confused with the IEN from the VistA
                                PATIENT file.  

              TECHNICAL DESCR:  Derived by calling API $$GETICN^MPIF001 (supported DBIA #2701) that returns the Integration Control
                                Number (ICN) and the ICN checksum for the given patient in the PATIENT file (#2).  


727.813,56    SELF IDENTIFIED GENDER 4;2 SET

                                'M' FOR Male; 
                                'F' FOR Female; 
                                'TM' FOR Transgender Male; 
                                'TF' FOR Transgender Female; 
                                'O' FOR Other; 
                                'N' FOR Does not wish to disclose; 
                                'B' FOR Non-Binary; 
              LAST EDITED:      APR 29, 2022 
              HELP-PROMPT:      Answer must be 1-2 characters in length. 
              DESCRIPTION:      This SELF IDENTIFIED GENDER value indicates the patient's personal sense of their gender identity
                                (if they choose to provide it).  
                                 
                                Self-identified gender may be the same or different as the sex assigned at birth.  

              TECHNICAL DESCR:  Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the LABORATORY
                                EXTRACT file (#727.813), this data is derived from the SELF IDENTIFIED GENDER field (#.024) in the
                                PATIENT file (#2).  



      FILES POINTED TO                      FIELDS

DSS EXTRACT LOG (#727)            EXTRACT NUMBER (#2)

LABORATORY TEST (#60)             TEST (#11)

PATIENT MOVEMENT (#405)           MOVEMENT FILE # (#16)

URGENCY (#62.05)                  URGENCY OF TEST (#12)



INPUT TEMPLATE(S):

PRINT TEMPLATE(S):

SORT TEMPLATE(S):

FORM(S)/BLOCK(S):