STANDARD DATA DICTIONARY #727.802 -- ADMISSION EXTRACT FILE 9/29/25 PAGE 1
STORED IN ^ECX(727.802, *** 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 MAS Admission extract
from existing DHCP files. Entries into this file are made by extracting data from several 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: ECX802
CROSS
REFERENCED BY: EXTRACT NUMBER(AC)
LAST MODIFIED: NOV 18,2023@19:04:17
727.802,.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: SEP 06, 2000
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.802,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: OCT 02, 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.802,2 EXTRACT NUMBER 0;3 POINTER TO DSS EXTRACT LOG FILE (#727)
Extract Number
LAST EDITED: JUL 31, 1996
HELP-PROMPT: Enter the extract number for this entry.
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.802^AC
1)= S ^ECX(727.802,"AC",$E(X,1,30),DA)=""
2)= K ^ECX(727.802,"AC",$E(X,1,30),DA)
3)= DO NOT DELETE.
This cross reference is essential for managing and purging data in this file.
727.802,3 FACILITY 0;4 POINTER TO MEDICAL CENTER DIVISION FILE (#40.8)
Facility
LAST EDITED: APR 17, 2012
HELP-PROMPT: Enter the medical center division associated with this admission.
DESCRIPTION:
This is the medical center division where the extract was performed.
TECHNICAL DESCR: An indicator of the medical center division where this event happened. It is derived from the
DIVISION field (.015) of the WARD LOCATION file (#42) which points to the MEDICAL CENTER DIVISION
file (#40.8).
727.802,4 PATIENT NO. - DFN 0;5 POINTER TO PATIENT FILE (#2)
Patient No. - DFN
LAST EDITED: OCT 14, 1996
HELP-PROMPT: Enter the name of the patient for this extract record.
DESCRIPTION:
An identifying number for the patient at the local site.
TECHNICAL DESCR: Pointer to the PATIENT file (#2). This data represents the patient DFN. Using the "ATT1" cross
reference on the PATIENT MOVEMENT file (#405), the PATIENT NO. - DFN data is derived from the
PATIENT field (.03).
727.802,5 SSN 0;6 FREE TEXT
Social Security Number
INPUT TRANSFORM: K:$L(X)>10!($L(X)<9)!'(X?9N!X?9N1"P") X
LAST EDITED: JUL 31, 1996
HELP-PROMPT: Your answer must be 9 to 10 characters in length.
DESCRIPTION:
The patient's social security number.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the ADMISSION EXTRACT
file (#727.802), SSN data is derived from the SOCIAL SECURITY NUMBER field (#.09) in the PATIENT
file (#2).
"Test" patient status is determined in PAT^ECXUTL3. Any patient with an SSN beginning with "00000"
will not be included in the extract.
727.802,6 NAME 0;7 FREE TEXT
Name
INPUT TRANSFORM: K:$L(X)>4!($L(X)<4) X
LAST EDITED: JUL 31, 1996
HELP-PROMPT: Your answer must be 4 characters in length.
DESCRIPTION:
The first four characters of the patient's last name.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the ADMISSION EXTRACT
file (#727.802), NAME data is derived from the NAME field (#.01) in the PATIENT file (#2). The
first four characters of the first "," piece are used, padded with trailing spaces if necessary.
The name value is returned by the supported call DEM^VADPT.
727.802,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 26, 2018
HELP-PROMPT: Enter the patient's status for this extract entry.
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.802,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:
This 8-character string represents the date on which the admission occurred.
TECHNICAL DESCR: Data source:
PATIENT MOVEMENT file (#405); DATE/TIME field (#.01)
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) concatenated with "01" for the day (DD) portion.
727.802,9 PLACEHOLD PRIMARY CARE TEAM 0;10 FREE TEXT
INPUT TRANSFORM: K:$L(X)>4!($L(X)<1) X
MAXIMUM LENGTH: 4
LAST EDITED: APR 27, 2018
HELP-PROMPT: Answer must be 1-4 characters in length.
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.802,10 SEX 0;11 SET
Sex
'M' FOR MALE;
'F' FOR FEMALE;
LAST EDITED: AUG 01, 1996
HELP-PROMPT: Enter the patient's sex.
DESCRIPTION:
Data is M if this patient is a male, or F if female.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (4) in the ADMISSION EXTRACT
file (#727.802), this data is derived from the SEX field (.02) in the PATIENT file (#2).
727.802,11 DATE OF BIRTH 0;12 FREE TEXT
Date of Birth
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:
Patient's date of birth.
TECHNICAL DESCR: Data source:
PATIENT MOVEMENT file (#405); PATIENT field (#.03) then to PATIENT file (#2); DATE OF BIRTH field
(#.03)
Date of Birth is returned through the supported call DEM^VADPT. It is then represented by an
8-character numeric string in the YYYYMMDD format.
727.802,12 PLACEHOLD RELIGION 0;13 POINTER TO RELIGION FILE (#13)
Religion
LAST EDITED: FEB 04, 2019
HELP-PROMPT: Enter the patient's religious preference.
DESCRIPTION: This field, previously known as RELIGION, is no longer needed. The name has been changed to
PLACEHOLD RELIGION and its value will be set to null.
TECHNICAL DESCR:
This field is no longer in use as of patch ECX*3*174.
727.802,13 EMPLOYMENT STATUS 0;14 SET
Employment Status
'1' FOR EMPLOYED FULL TIME;
'2' FOR EMPLOYED PART TIME;
'3' FOR NOT EMPLOYED;
'4' FOR SELF EMPLOYED;
'5' FOR RETIRED;
'6' FOR ACTIVE DUTY MILITARY;
'9' FOR UNKNOWN;
LAST EDITED: AUG 01, 1996
HELP-PROMPT: Select the appropriate employment status.
DESCRIPTION:
The patient's current employment status.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the ADMISSION EXTRACT
file (#727.802), EMPLOYMENT STATUS data is derived from the EMPLOYMENT STATUS field (#.31115) in
the PATIENT file (#2).
727.802,14 HEALTH INSURANCE 0;15 SET
Health Insurance
'1' FOR INSURED;
'0' FOR UNINSURED;
LAST EDITED: JAN 23, 2012
HELP-PROMPT: Select the appropriate health insurance status.
DESCRIPTION:
Identifies if patient is covered by health insurance.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the ADMISSION EXTRACT
file (#727.802), a call is made to the Integrated Billing API, INSURED^IBCNS1. The API returns 1 if
the patient is insured, or 0 if the patient is uninsured.
727.802,15 STATE 0;16 FREE TEXT
State
INPUT TRANSFORM: K:$L(X)>2!($L(X)<2) X
LAST EDITED: AUG 01, 1996
HELP-PROMPT: Enter the VA STATE CODE for this patient.
DESCRIPTION:
The state in which the patient resides.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (4) in the ADMISSION EXTRACT
file (#727.802), STATE data is derived from the STATE field (.115) in the PATIENT file (#2) which
points to the STATE file (#5). For the STATE file entry, data transmitted is the two character VA
STATE CODE, field (2).
727.802,16 COUNTY 0;17 FREE TEXT
INPUT TRANSFORM: K:$L(X)>3!($L(X)<3) X
LAST EDITED: MAY 05, 1999
HELP-PROMPT: Answer must be 3 characters in length.
DESCRIPTION:
County in which the patient resides.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (4) in the ADMISSION EXTRACT
file (#727.802), data is taken from the COUNTY field (.117) in the PATIENT file (#2), which points
to a subfile record in the COUNTY multiple field (#3) of the STATE file (#5). The three character
VA COUNTY CODE field (#2) within the COUNTY multiple field (#3) is used.
727.802,17 ZIP+4 0;18 FREE TEXT
INPUT TRANSFORM: K:$L(X)>10!($L(X)<5) X
LAST EDITED: MAY 17, 1999
HELP-PROMPT: Answer must be 5-10 characters in length.
DESCRIPTION: The zip code for where the patient resides. The 5-character zip code is provided if zip+4 is not
available.
TECHNICAL DESCR: The patient's zip code with optional 4-digit extension as found in the ZIP+4 field (#.1112) of the
patient's record in the PATIENT file (#2).
727.802,18 ELIGIBILITY 0;19 FREE TEXT
Eligibility
INPUT TRANSFORM: K:$L(X)>3!($L(X)<1) X
LAST EDITED: JUL 08, 1998
HELP-PROMPT: Answer must be 1-3 characters in length.
DESCRIPTION:
Appropriate eligibility code based on veteran or non-veteran status.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (4) in the ADMISSION EXTRACT
file (#727.802), ELIGIBILITY data is derived from the PRIMARY ELIGIBILITY CODE field (.361) in the
PATIENT file (#2). PRIMARY ELIGIBILITY CODE is a pointer to the ELIGIBILITY CODE file (#8). The
data is derived from the MAS ELIGIBILITY CODE field (#8) in the ELIGIBILITY CODE file (#8) which in
turn is a pointer to the MAS ELIGIBILITY CODE file (#8.1).
The pointer value to file (#8.1) is converted by ELIG^ECXUTL3 to the corresponding eligibility code
used by NPCD. This code is composed of two or three numeric characters.
727.802,19 VETERAN 0;20 SET
Veteran
'Y' FOR YES;
'N' FOR NO;
LAST EDITED: AUG 01, 1996
HELP-PROMPT: Select the appropriate veteran status for this patient.
DESCRIPTION:
Patient's Veteran status.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the ADMISSION EXTRACT
file (#727.802), VETERAN data is derived from the VETERAN (Y/N)? field (#1901) in the PATIENT file
(#2). Veteran is returned by the supported call ELIG^VADPT.
727.802,20 VIETNAM 0;21 SET
Vietnam
'Y' FOR YES;
'N' FOR NO;
'U' FOR UNKNOWN;
LAST EDITED: AUG 01, 1996
HELP-PROMPT: Select the appropriate Vietnam service status for this patient.
DESCRIPTION:
Indicates if patient is a Vietnam era veteran.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the ADMISSION EXTRACT
file (#727.802), VIETNAM data is derived from the VIETNAM SERVICE INDICATED? field (#.32101) in the
PATIENT file (#2).
727.802,21 AGENT ORANGE STATUS 0;22 SET
'Y' FOR YES;
'N' FOR NO;
'U' FOR UNKNOWN;
LAST EDITED: MAY 05, 1999
HELP-PROMPT: Enter the Agent Orange status for this patient.
DESCRIPTION:
Indicates whether patient was exposed to Agent Orange.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the ADMISSION EXTRACT
file (#727.802), AGENT ORANGE data is derived from the AGENT ORANGE EXPOS. INDICATED? field
(.#32102) in the PATIENT file (#2).
The status indicator is returned by SVC^VADPT.
727.802,22 RADIATION STATUS 0;23 SET
'N' FOR NO;
'Y' FOR YES;
'U' FOR UNKNOWN;
'1' FOR NO RADIATION;
'2' FOR HIROSHIMA/NAGASAKI;
'3' FOR ATMOSPHERIC NUCLEAR TESTING;
'4' FOR H/N AND ATMOSPHERIC TESTING;
'5' FOR UNDERGROUND NUCLEAR TESTING;
'6' FOR EXPOSURE AT NUCLEAR FACILITY;
'7' FOR OTHER;
LAST EDITED: APR 26, 2017
HELP-PROMPT: Enter the Radiation Status for this patient.
DESCRIPTION:
Indicates if the patient claims exposure to ionizing radiation.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the ADMISSION EXTRACT
file (#727.802), RADIATION data is derived from the RADIATION EXPOSURE INDICATED? field (#.32103)
in the PATIENT file (#2).
The status indicator is returned by SVC^VADPT.
727.802,23 POW STATUS 0;24 SET
'Y' FOR YES;
'N' FOR NO;
'U' FOR UNKNOWN;
LAST EDITED: MAY 05, 1999
HELP-PROMPT: Enter the patient's POW status.
DESCRIPTION:
Indicates if patient was confined as a Prisoner of War.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the ADMISSION EXTRACT
file (#727.802), POW data is derived from the POW STATUS INDICATED? field (#.525) in the PATIENT
file (#2).
The status indicator is returned by SVC^VADPT.
727.802,24 PERIOD OF SERVICE 0;25 FREE TEXT
Period of Service
INPUT TRANSFORM: K:$L(X)>1!($L(X)<1) X
LAST EDITED: AUG 01, 1996
HELP-PROMPT: Enter the period of service code from the PERIOD OF SERVICE file (#21).
DESCRIPTION:
The period of service which best classifies this patient based on eligibility code.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the ADMISSION EXTRACT
file (#727.802), PERIOD OF SERVICE data is derived from the PERIOD OF SERVICE field (#.323) in the
PATIENT file (#2). This field is a pointer to the PERIOD OF SERVICE file (#21). Using the period
of service pointer, the data is derived from the CODE field (#.03) in the PERIOD OF SERVICE file
(#21). This code is a single alpha numeric character.
The veteran's period of service indicator is returned by ELIG^VADPT.
727.802,25 PLACEHOLD MEANS TEST 0;26 SET
Means Test
LAST EDITED: FEB 13, 2020
HELP-PROMPT: Select the appropriate means test category.
DESCRIPTION: This field, previously known as MEANS TEST, is no longer needed. The name has been changed to
PLACEHOLD MEANS TEST and its value will be set to null.
TECHNICAL DESCR:
This field is no longer in use as of patch ECX*3*178.
727.802,26 MARITAL STATUS 0;27 POINTER TO MARITAL STATUS FILE (#11)
Marital Status
LAST EDITED: AUG 01, 1996
HELP-PROMPT: Enter the marital status for this patient.
DESCRIPTION:
Current marital status for this patient.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the ADMISSION EXTRACT
file (#727.802), MARITAL STATUS data is derived from the MARITAL STATUS field (#.05) in the PATIENT
file (#2). MARITAL STATUS is a pointer to the MARITAL STATUS file (#11).
727.802,27 WARD 0;28 POINTER TO HOSPITAL LOCATION FILE (#44)
Ward
LAST EDITED: AUG 06, 1996
HELP-PROMPT: Enter the current ward location for this patient.
DESCRIPTION:
Current ward for this patient.
TECHNICAL DESCR: Using the "ATT1" cross reference on the PATIENT MOVEMENT file (#405) and the patient pointer (DFN)
stored in the PATIENT NO. - DFN field (4) in the ADMISSION EXTRACT file (#727.802), WARD data is
derived from the WARD LOCATION field (#.06) in the PATIENT MOVEMENT file (#405). This ward data is
a pointer to the WARD LOCATION file (#42). Using the ward pointer, the data is derived from the
HOSPITAL LOCATION FILE POINTER field (#44) in the WARD LOCATION file (#42) which is a pointer to
the HOSPITAL LOCATION file (#44).
727.802,28 TREATING SPECIALTY 0;29 FREE TEXT
Treating Specialty
INPUT TRANSFORM: K:$L(X)>3!($L(X)<2) X
LAST EDITED: NOV 03, 2009
HELP-PROMPT: PTF Code from Specialty File (42.4)
DESCRIPTION:
The PTF CODE of the treating specialty associated with this extract record.
TECHNICAL DESCR: Using the "ATT1" cross reference on the PATIENT MOVEMENT file (#405) and the patient pointer (DFN)
stored in the PATIENT NO. - DFN field (#4) in the ADMISSION EXTRACT file (#727.802), TREATING
SPECIALTY data is derived from the FACILITY TREATING SPECIALTY field (#.09) in the PATIENT MOVEMENT
file (#405). This facility treating specialty data is a pointer to the FACILITY TREATING SPECIALTY
file (#45.7). Using the SPECIALTY field (#1) in the FACILITY TREATING SPECIALTY file (#45.7), the
pointer to the SPECIALTY file (#42.4) is obtained and stored instead of the IEN of the specialty.
727.802,29 ATTENDING PHYSICIAN 0;30 FREE TEXT
Attending Physician
INPUT TRANSFORM: K:$L(X)>11!($L(X)<1) X
LAST EDITED: OCT 15, 1996
HELP-PROMPT: Enter attending physician for this patient.
DESCRIPTION:
The attending physician assigned to this patient at the time of admission.
TECHNICAL DESCR: Using the "ATT1" cross reference on the PATIENT MOVEMENT file (#405) and the patient pointer (DFN)
stored in the PATIENT NO. - DFN field (#4) in the ADMISSION EXTRACT file (#727.802), ATTENDING
PHYSICIAN data is derived from the ATTENDING PHYSICIAN field (#.19) in the PATIENT MOVEMENT file
(#405). This attending physician data is a pointer to the NEW PERSON file (#200). This data is
stored as "2"_pointer value. For example, if the IEN of the provider in file #200 is 98765, the
value that will be stored is 298765.
727.802,30 MOVEMENT FILE # 0;31 POINTER TO PATIENT MOVEMENT FILE (#405)
LAST EDITED: AUG 09, 2018
HELP-PROMPT: Enter the current movement number for this patient.
DESCRIPTION:
Current movement number for this patient.
TECHNICAL DESCR: Pointer to the PATIENT MOVEMENT file (#405). Using the "ATT1" or "ATT2" cross reference on the
PATIENT MOVEMENT file (#405) and the patient pointer (DFN) stored in the PATIENT NO. - DFN field
(#4) in the ADMISSION EXTRACT file (#727.802), this is a pointer to the file #405 record for the
patient's admission.
In addition to standard admission movements found in the "ATT1" cross reference, the "ATT2" cross
reference is used to find any ASIH OTHER FACILITY type transfers. When a patient goes ASIH OTHER
FACILITY, this starts a new episode of care and an admission record, related to that movement, is
created.
727.802,31 PLACEHOLD DRG 0;32 POINTER TO DRG FILE (#80.2)
LAST EDITED: FEB 04, 2019
HELP-PROMPT: Enter the appropriate DRG for this patient.
DESCRIPTION: This field, previously known as DRG, is no longer needed. The name has been changed to PLACEHOLD
DRG and its value will be set to null.
TECHNICAL DESCR:
This field is no longer in use as of patch ECX*3*174.
727.802,32 PLACEHOLDER 0;33 FREE TEXT
INPUT TRANSFORM: K:$L(X)>7!($L(X)<1) X
LAST EDITED: APR 19, 2016
HELP-PROMPT: Your answer must be 1 to 7 characters in length.
DESCRIPTION: This field, previously known as PRINCIPAL DIAGNOSIS, 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.802,33 TIME 0;34 FREE TEXT
Time
INPUT TRANSFORM: K:$L(X)>6!($L(X)<6)!'(X?6N) X
OUTPUT TRANSFORM: S Y=$$ECXTIMEX^ECXUTL(Y,0)
LAST EDITED: SEP 24, 1997
HELP-PROMPT: Answer must be 6 characters in length.
DESCRIPTION:
A 6-character numeric string which represents the time of day at which the admission occurred.
TECHNICAL DESCR: Data source:
PATIENT MOVEMENT file (#405); DATE/TIME field (#.01)
This field is always exactly 6 numeric characters in length; if time cannot be determined, then
"000300" is used as default.
727.802,34 PLACEHOLD PC PROVIDER 0;35 FREE TEXT
Primary Care Provider
INPUT TRANSFORM: K:$L(X)>11!($L(X)<1) X
MAXIMUM LENGTH: 11
LAST EDITED: APR 30, 2018
HELP-PROMPT: Answer must be 1-11 characters in length.
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.802,35 PLACEHOLD RACE 0;36 FREE TEXT
INPUT TRANSFORM: K:$L(X)>1!($L(X)<1) X
MAXIMUM LENGTH: 1
LAST EDITED: MAR 27, 2018
HELP-PROMPT: Answer must be 1 character in length.
DESCRIPTION: This field, previously known as RACE, is no longer needed. The name has been changed to PLACEHOLD
RACE and its value will be set to null.
TECHNICAL DESCR:
This field is no longer in use as of patch ECX*3*170.
727.802,36 PRIMARY WARD PROVIDER 0;37 FREE TEXT
INPUT TRANSFORM: K:$L(X)>11!($L(X)<1) X
LAST EDITED: JAN 26, 1998
HELP-PROMPT: Answer must be 1-11 characters in length.
DESCRIPTION:
The provider assigned to the ward where the patient is located at the time of admission.
TECHNICAL DESCR: Source: field #.08; file #405
The PRIMARY CARE PHYSICIAN field (#.08) associated with the PATIENT MOVEMENT file (#405) record for
the Treating Specialty Change record related to the Admission record.
The value obtained is a pointer to the NEW PERSON file (#200). A "2" is prefixed to the pointer
value to indicate that it points to file #200. For example, if the IEN of the provider in file
#200 is 98765, the value that will be stored is 298765.
727.802,37 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.802,38 PLACEHOLDER 1;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>10!($L(X)<4) X
LAST EDITED: APR 19, 2016
HELP-PROMPT: Answer must be 4-10 characters in length.
DESCRIPTION: This field, previously known as DSS DEPT., 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.802,39 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.802,40 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.802,41 PLACEHOLDER 1;5 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.802,42 ADMISSION ELIGIBILITY 1;6 FREE TEXT
INPUT TRANSFORM: K:$L(X)>3!($L(X)<1) X
LAST EDITED: JUL 08, 1998
HELP-PROMPT: Answer must be 1-3 characters in length.
DESCRIPTION:
The eligibility of the patient for this specific admission.
TECHNICAL DESCR: The Admission Eligibility is derived from the ADMITTING ELIGIBILITY field (#.2) of the PATIENT
MOVEMENT file (#405) record associated with this patient admission.
Field (#.2) points to the ELIGIBILITY CODE file (#8). Then the MAS ELIGIBILITY CODE field (#8) of
file #8 points to the MAS ELIGIBILITY CODE file (#8.1).
The pointer value to file #8.1 is converted by ELIG^ECXUTL3 to the corresponding eligibility code
used by NPCD. This code is composed of two or three numeric characters.
727.802,43 MST STATUS 1;7 SET
'Y' FOR Yes, screened reports MST;
'N' FOR Screened, does not report MST;
'D' FOR Screened, declines to answer;
'U' FOR Unknown, not screened;
LAST EDITED: JUN 13, 2012
HELP-PROMPT: Enter the patient's MST Status.
DESCRIPTION:
The MST Status of the patient on the date of the patient's admission.
TECHNICAL DESCR: The MST HISTORY file (#29.11) holds data regarding military sexual trauma claims and effective
dates. The patients MST status is stored in the MST STATUS field (#3). A call will be made to
$$GETSTAT^DGMSTAPI(DFN,DGDATE) using the DFN in the PATIENT NO. DFN field (#4) and the date in the
DAY (#8) field in the ADMISSION EXTRACT file (#727.802).
727.802,44 SHAD STATUS 1;8 SET
'Y' FOR YES;
'N' FOR NO;
'U' FOR UNKNOWN;
LAST EDITED: FEB 11, 2010
HELP-PROMPT: Enter SHAD Status.
DESCRIPTION:
Indicates whether patient meets requirements for Shipboard Hazard and Defense (SHAD) status.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the ADMISSION EXTRACT
file (#727.802), Shipboard Hazard and Defense data is derived from using DBIA #4462
GETSHAD^DGUTL3(DFN).
727.802,45 PLACEHOLD SHARE AGREEMNT PAYOR 1;9 FREE TEXT
INPUT TRANSFORM: K:$L(X)>1!($L(X)<1) X
LAST EDITED: FEB 04, 2019
HELP-PROMPT: Answer must be 1 character in length.
DESCRIPTION: This field, previously known as SHARING AGREEMENT PAYOR, is no longer needed. The name has been
changed to PLACEHOLD SHARE AGREEMNT PAYOR and its value will be set to null.
TECHNICAL DESCR:
This field is no longer in use as of patch ECX*3*174.
727.802,46 PLACEHOLD SHARE AGREEMNT INSUR 1;10 FREE TEXT
INPUT TRANSFORM: K:$L(X)>11!($L(X)<1) X
LAST EDITED: FEB 04, 2019
HELP-PROMPT: Answer must be 1-11 characters in length.
DESCRIPTION: This field, previously known as SHARING AGREEMENT INSURANCE, is no longer needed. The name has been
changed to PLACEHOLD SHARE AGREEMNT INSUR and its value will be set to null.
TECHNICAL DESCR:
This field is no longer in use as of patch ECX*3*174.
727.802,47 ENROLLMENT LOCATION 1;11 FREE TEXT
INPUT TRANSFORM: K:$L(X)>7!($L(X)<3) X
LAST EDITED: AUG 08, 2002
HELP-PROMPT: Answer must be 3-7 characters in length
DESCRIPTION:
The facility that the patient chooses to designate as his preferred location for care.
TECHNICAL DESCR: The PREFERRED FACILITY field (# 27.02) of the PATIENT file (#2) is defined as the facility that the
patient chooses to designate as his preferred location for care. The PREFERRED FACILITY field (#
27.02) is a pointer to the INSTITUTION file (#4). From file #4, the value in the STATION NUMBER
field (#99) is used.
727.802,48 PLACEHOLD PC PROV PERSON CLASS 1;12 FREE TEXT
INPUT TRANSFORM: K:$L(X)>7!($L(X)<7) X
MAXIMUM LENGTH: 7
LAST EDITED: APR 30, 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.802,49 PLACEHOLD ASSOC PC PROVIDER 1;13 FREE TEXT
INPUT TRANSFORM: K:$L(X)>11!($L(X)<2) X
MAXIMUM LENGTH: 11
LAST EDITED: APR 30, 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.802,50 PLACEHOLD AS PC PROV PERSON CL 1;14 FREE TEXT
INPUT TRANSFORM: K:$L(X)>7!($L(X)<7) X
MAXIMUM LENGTH: 7
LAST EDITED: MAY 02, 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.802,51 PLACEHOLDER 1;15 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.802,52 DOM, PRRTP AND SAARTP 1;16 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. CET/TR;
LAST EDITED: APR 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 exists in the DSS TREATING SPECIALTY TRANSLATION (#727.831)
file, data is derived from the DOM/PRRTP/SARRTP CODE field (#2) of the DSS TREATING SPECIALTY
TRANSLATION (#727.831) file.
Otherwise, the value is null.
727.802,53 ENROLLMENT CATEGORY 1;17 FREE TEXT
INPUT TRANSFORM: K:$L(X)>1!($L(X)<1) X
LAST EDITED: JUN 14, 2000
HELP-PROMPT: Answer must be 1 character in length.
DESCRIPTION:
Patient's enrollment category.
TECHNICAL DESCR: ENROLLMENT CATEGORY is derived from the standard call $$CATEGORY^DGENA4 using the patient's DFN and
the CURRENT ENROLLMENT field (#27.01) of the PATIENT file (#2).
727.802,54 ENROLLMENT STATUS 1;18 FREE TEXT
INPUT TRANSFORM: K:$L(X)>2!($L(X)<1) X
LAST EDITED: JUN 14, 2000
HELP-PROMPT: Answer must be 1-2 characters in length.
DESCRIPTION:
Patient's enrollment status.
TECHNICAL DESCR: ENROLLMENT STATUS is derived from the standard call $$STATUS^DGENA using the patient's DFN and
returns the ENROLLMENT STATUS field (#.04) of the PATIENT ENROLLMENT file (#27.11).
727.802,55 ENCOUNTER SHAD 1;19 SET
'Y' FOR YES;
'N' FOR NO;
LAST EDITED: FEB 12, 2010
HELP-PROMPT: Indicate if encounter is related to treatment for PROJ 112/SHAD condition.
DESCRIPTION: Indicates if treatment provided during the patient's admission is related to the Shipboard Hazard
And Defense (SHAD) condition.
TECHNICAL DESCR: Using the VISIT FILE ENTRY field (#.27) in the PATIENT MOVEMENT file (#405) a call is made to API
VISIT^ECXSCX1 which in turn calls ENCEVENT^PXAPI. The ENCEVENT^PXAPI returns the Shipboard Hazard
and Defense conditions indicator stored at the PROJ 112/SHAD field (#80008) in the VISIT file
(#9000010). The value will be stored in the output array subscripted by "SHAD".
727.802,56 PURPLE HEART INDICATOR 1;20 SET
Purple Heart Indicator
'Y' FOR YES;
'N' FOR NO;
LAST EDITED: OCT 09, 2002
HELP-PROMPT: Enter the Purple Heart Indicator for the patient.
DESCRIPTION:
Indicates whether or not a patient is a Purple Heart recipient.
TECHNICAL DESCR: PATIENT file (#2); CURRENT PH INDICATOR field (#.531). The status indicator is returned by
SVC^VADPT.
727.802,57 OBSERVATION PATIENT INDICATOR 1;21 SET
'NO' FOR NO;
'YES' FOR YES;
LAST EDITED: APR 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 exists 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.802,58 ENCOUNTER NUMBER 1;22 FREE TEXT
INPUT TRANSFORM: K:$L(X)>18!($L(X)<1) X
LAST EDITED: MAY 03, 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.802,59 AGENT ORANGE LOCATION 1;23 FREE TEXT
INPUT TRANSFORM: K:$L(X)>1!($L(X)<1) X
MAXIMUM LENGTH: 1
LAST EDITED: MAY 23, 2023
HELP-PROMPT: Choose the location where the patient was exposed to Agent Orange. Answer must be 1 character in
length.
DESCRIPTION: This field indicates the location where the patient was exposed to Agent Orange. Values are:
"B" = BLUE WATER NAVY
"K" = KOREAN DMZ
"V" = VIETNAM
"T" = THAILAND(U.S. OR ROYAL THAI MIL BASE)
"L" = LAOS
"C" = CAMBODIA(MIMOT OR KREK,KAMPONG CHAM)
"G" = GUAM, AMERICAN SAMOA, OR TERRITORIAL WATERS
"J" = JOHNSTON ATOLL
"O" = OTHER
TECHNICAL DESCR: The location is returned by a call to SVC^VADPT which gets its data from the AGENT ORANGE EXPOSURE
LOCATION field (#.3213) of the PATIENT file (#2). Values are:
"B" = BLUE WATER NAVY
"K" = KOREAN DMZ
"V" = VIETNAM
"T" = THAILAND(U.S. OR ROYAL THAI MIL BASE)
"L" = LAOS
"C" = CAMBODIA(MIMOT OR KREK,KAMPONG CHAM)
"G" = GUAM, AMERICAN SAMOA, OR TERRITORIAL WATERS
"J" = JOHNSTON ATOLL
"O" = OTHER
727.802,60 PRODUCTION DIVISION CODE 1;24 FREE TEXT
INPUT TRANSFORM: K:$L(X)>7!($L(X)<3) X
LAST EDITED: APR 17, 2012
HELP-PROMPT: Answer must be 3-7 characters in length.
DESCRIPTION:
Identifies the division/facility where the work was performed.
TECHNICAL DESCR: Data comes from the WARD LOCATION field (#.06) in the PATIENT MOVEMENT file (#405). This value is a
pointer to the WARD LOCATION file (#42) which in turn is used to get the DIVISION field (#.015) in
the WARD LOCATION file (#42), a pointer to the MEDICAL CENTER DIVISION file (#40.8). This value is
then used to call the API GETDIV^ECXDEPT to get the STATION NUMBER field (#99) from the INSTITUTION
file (#4).
727.802,61 POW LOCATION 1;25 POINTER TO POW PERIOD FILE (#22)
POW Location
LAST EDITED: OCT 09, 2002
HELP-PROMPT: Enter the patient's POW location.
DESCRIPTION: If POW status is indicated, then this is the POW confinement location/period.
1 WORLD WAR I
2 WORLD WAR II - EUROPE
3 WORLD WAR II - PACIFIC
4 KOREAN
5 VIETNAM
6 OTHER
TECHNICAL DESCR: PATIENT file (#2); POW CONFINEMENT LOCATION field (#.526). This is a pointer value to the POW
PERIOD file (#22). The location indicator is returned by SVC^VADPT.
727.802,62 SOURCE OF ADMISSION 1;26 SET
Source of Admission
'1' FOR HOSPITAL;
'2' FOR NHCU;
'3' FOR DOMICILIARY;
'4' FOR MILITARY HOSPITAL;
'5' FOR CNH;
LAST EDITED: DEC 10, 2002
HELP-PROMPT: Answer must be 1 character in length
DESCRIPTION:
Indicates where the admission took place.
TECHNICAL DESCR: Obtained via the PTF file (#45), SOURCE OF ADMISSION field (#20) which is a pointer to the SOURCE
OF ADMISSION file (#45.1), PLACE OF ADMISSION field (#11).
727.802,63 HEAD & NECK CANCER INDICATOR 1;27 SET
Head and Neck Cancer Indicator
'Y' FOR YES;
'N' FOR NO;
LAST EDITED: AUG 27, 2002
HELP-PROMPT: Enter the Head & Neck Cancer Indicator for the patient.
DESCRIPTION:
Identifies whether patient has head and/or neck cancer.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4), a call is made to
$$GETCUR^DGNTAPI to retrieve the HEAD/NECK CA DX field (#2.01) of the NOSE AND THROAT RADIUM
HISTORY file (#28.11).
727.802,64 PLACEHOLD ETHNICITY 1;28 FREE TEXT
INPUT TRANSFORM: K:$L(X)>6!($L(X)<1) X
MAXIMUM LENGTH: 6
LAST EDITED: MAR 27, 2018
HELP-PROMPT: Answer must be 1-6 characters in length.
DESCRIPTION: This field, previously known as ETHNICITY, is no longer needed. The name has been changed to
PLACEHOLD ETHNICITY and its value will be set to null.
TECHNICAL DESCR:
This field is no longer in use as of patch ECX*3*170.
727.802,65 PLACEHOLD RACE 1 1;29 FREE TEXT
INPUT TRANSFORM: K:$L(X)>6!($L(X)<1) X
MAXIMUM LENGTH: 6
LAST EDITED: MAR 27, 2018
HELP-PROMPT: Answer must be 1-6 characters in length.
DESCRIPTION: This field, previously known as RACE 1, is no longer needed. The name has been changed to
PLACEHOLD RACE 1 and its value will be set to null.
TECHNICAL DESCR:
This field is no longer in use as of patch ECX*3*170.
727.802,66 ENROLLMENT PRIORITY 1;30 FREE TEXT
INPUT TRANSFORM: K:$L(X)>2!($L(X)<1) X
LAST EDITED: MAR 01, 2004
HELP-PROMPT: Answer must be 1-2 characters in length.
DESCRIPTION:
This field contains the enrollment priority group and the enrollment priority subgroup.
TECHNICAL DESCR: ENROLLMENT PRIORITY field contains the enrollment priority group and the enrollment priority
subgroup from the PATIENT ENROLLMENT File (#27.11). ENROLLMENT PRIORITY Groups determined for a
patient enrollment include:
'1' FOR GROUP 1
'2' FOR GROUP 2
'3' FOR GROUP 3
'4' FOR GROUP 4
'5' FOR GROUP 5
'6' FOR GROUP 6
'7' FOR GROUP 7
'8' FOR GROUP 8
ENROLLMENT PRIORITY Subgroups determined for a patient enrollment include:
'1' FOR a
'3' FOR c
'5' FOR e
'7' FOR g
Data is obtained from a call to $$ENRSBGRP^DGENA4(DFN) using the patient's DFN.
727.802,67 USER ENROLLEE 1;31 SET
'U' FOR USER ENROLLED;
LAST EDITED: APR 16, 2012
HELP-PROMPT: Enter patient's current enrollment status.
DESCRIPTION:
Indicates whether a Veteran has User Enrollee status for the current or future fiscal year.
TECHNICAL DESCR: User enrollee is determined by checking the PATIENT ENROLLMENT (#27.11) file. When a user has a
current or future fiscal year in the ENROLLMENT STATUS (#.04) field, the value is set to 'U' and is
null if no date or a past year's value is contained. Determined by the use of an API:
$$UESTAT^EASUSER where the Patient Identifier (DFN) is passed in.
727.802,68 PATIENT TYPE 1;32 SET
'AC' FOR ACTIVE DUTY;
'AL' FOR ALLIED VETERAN;
'CO' FOR COLLATERAL;
'EM' FOR EMPLOYEE;
'IN' FOR INELIGIBLE;
'MI' FOR MILITARY RETIREE;
'NO' FOR NON-VETERAN (OTHER);
'NS' FOR NSC VETERAN;
'SC' FOR SC VETERAN;
'TR' FOR TRICARE;
LAST EDITED: APR 16, 2012
HELP-PROMPT: Enter type of patient.
DESCRIPTION: Refers to the various types of patient which may be seen at a VA facility. Every patient in the
system must have a TYPE specified.
TECHNICAL DESCR: PATIENT TYPE is derived from a call to TYPE^ECXUTL5(DFN). Using the patient's DFN, the NAME field
(#.01) of the TYPE OF PATIENT file (#391) as pointed to by the TYPE field (#391) of the PATIENT
file (#2) is shortened to the first two characters to determine the value stored in the PATIENT
TYPE field (#68).
727.802,69 CV STATUS ELIGIBILITY 1;33 SET
'Y' FOR YES;
'E' FOR ELIGIBILITY EXPIRED;
LAST EDITED: APR 16, 2012
HELP-PROMPT: Enter patient's combat veteran eligibility.
DESCRIPTION: Records if veteran served on active duty in a theater of combat operations during a period of war
after the Persian Gulf War or in combat against a hostile force during a period of hostilities
after November 11, 1998.
TECHNICAL DESCR: CV STATUS ELIGIBILITY is determined by the use of API $$CVEDT^DGCV(DFN,DATE) that checks the COMBAT
VET END DATE field (#.5295) from the PATIENT file (#2) to determine CV Status. API returns three
pieces (i.e. 1^20010106^0) and the first piece is resolved as follows.
1 - veteran qualifies as a CV
0 - veteran does not qualify as a CV
-1 - bad DFN
Based on this result the field will be set to 'Y' for 'YES' or 'E' for 'ELIGIBILITY EXPIRED' or
'NULL' for not eligible.
727.802,70 CV ELIGIBILITY END DATE 1;34 FREE TEXT
INPUT TRANSFORM: K:$L(X)>8!($L(X)<8) X
LAST EDITED: APR 16, 2012
HELP-PROMPT: Answer must be 8 characters in length.
DESCRIPTION: Records the Combat Veteran eligibility expiration date of the veteran who served on active duty in
a theater of combat operations during a period of war after the Persian Gulf War or in combat
against a hostile force during a period of hostilities after November 11, 1998.
TECHNICAL DESCR: CV ELIGIBILITY END DATE is determined by the use of API $$CVEDT^DGCV(DFN,DATE) that checks the
COMBAT VET END DATE field (#.5295) from the PATIENT file (#2) to determine CV Status. API returns
three pieces (i.e. 1^20010106^0) the 2nd piece is the COMBAT VET END DATE in HL7 format.
727.802,71 ENCOUNTER CV 1;35 SET
'Y' FOR YES;
LAST EDITED: APR 16, 2012
HELP-PROMPT: Enter patient's combat veteran eligibility.
DESCRIPTION: Records if a veteran served on active duty in a theater of combat operations during a period of war
after the Persian Gulf War or in combat against a hostile force during a period of hostilities
after November 11, 1998.
TECHNICAL DESCR: ENCOUNTER CV is determined by the use of API $$CVEDT^DGCV(DFN,DATE) that checks the COMBAT VET END
DATE field (#.5295) from the PATIENT file #(2) to determine CV Status. API returns three pieces
(i.e. 1^20100106^0). The third piece returns:
1 - vet was eligible on date specified
0 - vet was not eligible on date specified
Based on these returns, the value for this field shall be Y for Yes if value is 1 or left blank if
0 to indicate ineligibility.
727.802,72 PLACEHOLD NAT'L PAT REC FLAG 1;36 SET
'Y' FOR YES;
LAST EDITED: FEB 04, 2019
HELP-PROMPT: Indicate if patient is associated with a category 1 patient record flag.
DESCRIPTION: This field, previously known as NATIONAL PATIENT RECORD FLAG, is no longer needed. The name has
been changed to PLACEHOLD NAT'L PAT REC FLAG and its value will be set to null.
TECHNICAL DESCR:
This field is no longer in use as of patch ECX*3*174.
727.802,73 ATTENDING PHYSICIAN PC 1;37 FREE TEXT
INPUT TRANSFORM: K:$L(X)>7!($L(X)<7) X
LAST EDITED: AUG 19, 2005
HELP-PROMPT: Answer must be 7 characters in length.
DESCRIPTION:
The VA Code of the Person Class of the Attending Physician associated with this record.
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.802,74 PRIMARY WARD PROVIDER PC 1;38 FREE TEXT
INPUT TRANSFORM: K:$L(X)>7!($L(X)<7) X
LAST EDITED: AUG 19, 2005
HELP-PROMPT: Answer must be 7 characters in length.
DESCRIPTION:
The VA Code of the Person Class of the Primary Ward Provider associated with this record.
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.802,75 SW ASIA CONDITIONS 1;39 SET
'Y' FOR YES;
'N' FOR NO;
'U' FOR UNKNOWN;
LAST EDITED: MAY 27, 2009
HELP-PROMPT: Enter patient's Southwest Asia Indicator status.
DESCRIPTION:
This field is used to indicate if this patient claims exposure to Southwest Asia Conditions.
TECHNICAL DESCR: This field is derived from the SOUTHWEST ASIA CONDITIONS? field (#.322013) in the PATIENT file (#2)
using the patient's DFN. The status indicator is returned by SVC^VADPT.
727.802,76 ERI 1;40 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 length is extracted from the EMERGENCY RESPONSE INDICATOR field (#.181) located in the
PATIENT file (#2). Values are:
"K" = Hurricane Katrina
"P" = Pandemic
Null
727.802,77 AGENT ORANGE ENC INDICATOR 1;41 SET
'Y' FOR YES;
'N' FOR NO;
LAST EDITED: APR 16, 2012
HELP-PROMPT: Enter patient's agent orange exposure indicator.
DESCRIPTION: Indicates whether service provided during this patient encounter is related to exposure to Agent
Orange.
TECHNICAL DESCR: Using the VISIT FILE ENTRY field (#.27) in the PATIENT MOVEMENT file (#405) a call is made to API
VISIT^ECXSCX1 which in turn calls ENCEVENT^PXAPI. The ENCEVENT^PXAPI returns the agent orange
indicator stored at the AGENT ORANGE EXPOSURE field (#80002) in the VISIT file (#9000010).
727.802,78 ENCOUNTER SWAC 1;42 FREE TEXT
INPUT TRANSFORM: K:$L(X)>1!($L(X)<1) X
LAST EDITED: MAY 13, 2009
HELP-PROMPT: Answer must be 1 character in length.
DESCRIPTION: Indicates the appropriate response for exposure to Southwest Asia conditions as related to this
patient's episode of care:
Y = Yes
N = No
Null
TECHNICAL DESCR: Using the VISIT FILE ENTRY field (#.27) in the PATIENT MOVEMENT file (#405) a call is made to API
VISIT^ECXSCX1 which in turn calls ENCEVENT^PXAPI. The ENCEVENT^PXAPI returns the Southwest Asia
conditions indicator stored at the SW ASIA CONDITIONS field (#80004) in the VISIT file (#9000010).
The value will be stored in the output array subscripted by "PGE".
727.802,79 ENC HEAD/NECK CA 1;43 FREE TEXT
INPUT TRANSFORM: K:$L(X)>1!($L(X)<1) X
LAST EDITED: JUN 23, 2006
HELP-PROMPT: Answer must be 1 character in length.
DESCRIPTION: Indicates the appropriate response for head/neck cancer as related to this patient's episode of
care:
Y = Yes
N = No
Null
TECHNICAL DESCR: Using the VISIT FILE ENTRY field (#.27) in the PATIENT MOVEMENT file (#405) a call is made to API
VISIT^ECXSCX1 which in turn calls ENCEVENT^PXAPI. The ENCEVENT^PXAPI returns the head/neck cancer
data stored at the HEAD AND/OR NECK CANCER field (#80006) in the VISIT file (#9000010). The value
will be stored in the output array subscripted by "HNC".
727.802,80 ENCOUNTER MST 1;44 FREE TEXT
INPUT TRANSFORM: K:$L(X)>1!($L(X)<1) X
LAST EDITED: JUN 23, 2006
HELP-PROMPT: Answer must be 1 character in length.
DESCRIPTION: Indicates the appropriate response for military sexual trauma as related to this patient's episode
of care:
Y = Yes
N = No
Null
TECHNICAL DESCR: Using the VISIT FILE ENTRY field (#.27) in the PATIENT MOVEMENT file (#405) a call is made to API
VISIT^ECXSCX1 which in turn calls ENCEVENT^PXAPI. The ENCEVENT^PXAPI returns the military sexual
trauma data stored at the MILITARY SEXUAL TRAUMA field (#80005) in the VISIT file (#9000010). The
value will be stored in the output array subscripted by "MST".
727.802,81 RADIATION ENCOUNTER INDICATOR 1;45 FREE TEXT
INPUT TRANSFORM: K:$L(X)>1!($L(X)<1) X
LAST EDITED: JUN 23, 2006
HELP-PROMPT: Answer must be 1 character in length.
DESCRIPTION: Indicates the appropriate response for ionizing radiation exposure as related to this patient's
episode of care:
Y = Yes
N = No
Null
TECHNICAL DESCR: Using the VISIT FILE ENTRY field (#.27) in the PATIENT MOVEMENT file (#405) a call is made to API
VISIT^ECXSCX1 which in turn calls ENCEVENT^PXAPI. The ENCEVENT^PXAPI returns the ionizing radiation
exposure indicator stored at the IONIZING RADIATION EXPOSURE field (#80003) in the VISIT file
(#9000010). The value will be stored in the output array subscripted by "IR".
727.802,82 OEF/OIF 2;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>9!($L(X)<1) X
LAST EDITED: AUG 16, 2007
HELP-PROMPT: Answer must be 1-9 characters in length.
DESCRIPTION: The Military Operation in which the patient was in combat during the specified time period. This
field is a length of nine characters and reflects the OEF or OIF where this patient was in combat.
TECHNICAL DESCR: The Military Operation in which the patient was in combat during the specified time period. This
field is a length of nine characters and reflects the OEF or OIF where this patient was in combat.
The value of this field is derived from the LOCATION OF SERVICE field (#.01) from SERVICE [OEF OR
OIF] sub-file (#2.3215) of field (#.3215) located in the PATIENT File (#2). DSS will capture once,
each location where the veteran served. In order to accommodate multiple locations, the values for
this field are concatenated into this 9-character field. Possible field values are one or more
combinations of the following: OEF = Operation Enduring Freedom OIF = Operation Iraqi Freedom UNK =
Unknown OEF/OIF
727.802,83 OEF/OIF RETURN DATE 2;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>8!($L(X)<1) X
LAST EDITED: MAY 02, 2007
HELP-PROMPT: Answer must be 1-8 characters in length.
DESCRIPTION: The date the patient left the OEF/OIF area, if known. Otherwise, it is the end date of military pay
for this OEF/OIF deployment.
TECHNICAL DESCR: The date the patient left the OEF/OIF area, if known. Otherwise, it is the end date of military pay
for this OEF/OIF deployment. This date field has a format equal to YYYYMMDD. The value of this
field is derived from the OEF/OIF TO DATE field (#.03) from sub-file (#2.3215) of field (#.3215)
located in the PATIENT file (#2). In cases of multiple OEF/OIF tours, this field contains only
most recent return date.
727.802,84 PLACEHOLD ASSOC PC PROV NPI 2;3 FREE TEXT
INPUT TRANSFORM: K:$L(X)>15!($L(X)<1) X
LAST EDITED: APR 30, 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.802,85 ATTENDING PHYSICIAN NPI 2;4 FREE TEXT
INPUT TRANSFORM: K:$L(X)>15!($L(X)<1) X
LAST EDITED: MAY 02, 2007
HELP-PROMPT: Answer must be 1-15 characters in length.
DESCRIPTION: Standard unique life-long identifier of the attending physician. This field has a length of fifteen
characters.
TECHNICAL DESCR: Standard unique life-long identifier of the attending physician. This field has a length of fifteen
characters. The qualified identifier is retrieved via the supporting Kernel API: $$NPI^XUSNPI.
727.802,86 PLACEHOLD PC PROVIDER NPI 2;5 FREE TEXT
INPUT TRANSFORM: K:$L(X)>15!($L(X)<1) X
LAST EDITED: APR 30, 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.802,87 PRIMARY WARD PROVIDER NPI 2;6 FREE TEXT
INPUT TRANSFORM: K:$L(X)>15!($L(X)<1) X
LAST EDITED: MAY 02, 2007
HELP-PROMPT: Answer must be 1-15 characters in length.
DESCRIPTION: A standard unique life-long identifier of the primary ward provider. This field has a length of
fifteen characters.
TECHNICAL DESCR: A standard unique life-long identifier of the primary ward provider. This field has a length of
fifteen characters. The qualified identifier is retrieved via the supporting Kernel API:
$$NPI^XUSNPI.
727.802,88 ADMIT OUTPATIENT TX FLAG 2;7 SET
'Y' FOR YES;
LAST EDITED: JUL 13, 2009
HELP-PROMPT: Enter 'Y' if source of admission is set to admit outpatient treatment ('1P').
DESCRIPTION: This field contains the patient's source of admission flag. YES, if admit outpatient treatment
('1P').
TECHNICAL DESCR: This field is set based on the value found at the PTF CODE field (#.01) of the SOURCE OF ADMISSION
file (#45.1) as pointed to by the SOURCE OF ADMISSION field (#20) of the PTF file (#45) as pointed
to by the PTF ENTRY field (#.16) of the PATIENT MOVEMENT file (#405). If the value found there is
"1P" then this field is set to yes otherwise it is left blank.
727.802,89 COUNTRY CODE 2;8 FREE TEXT
INPUT TRANSFORM: K:$L(X)>3!($L(X)<1) X
LAST EDITED: JUN 09, 2009
HELP-PROMPT: The code for the country. Answer must be 1-3 characters in length.
DESCRIPTION:
This is the code for the country associated with the address.
TECHNICAL DESCR: The three-character alpha identifying code is copied from the CODE (#.01) field of the COUNTRY
(#779.004) file.
727.802,90 PATCAT 2;9 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 (#391) field of the Patient (#2) file) = Active Duty, Military
Retiree, or TRICARE, then the value(s) in the VistA Other Eligibility multiple (PATIENT
ELIGIBILITIES (#361) field of the PATIENT (#2) file), which points to locally modifiable
ELIGIBILITY CODE (#8) file 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.802,91 ADMIT SOURCE 2;10 FREE TEXT
INPUT TRANSFORM: K:$L(X)>3!($L(X)<2) X
LAST EDITED: MAR 14, 2011
HELP-PROMPT: This is the source of admission PTF code.
DESCRIPTION: This field contains the source of admission for the PTF entry. This is a two character code in the
format of 1 numeric and 1 alphanumeric.
TECHNICAL DESCR: Obtained via the PTF file (#45), SOURCE OF ADMISSION field (#20) which is a pointer to the SOURCE
OF ADMISSION file (#45.1), PTF CODE field (#.01). This is up to three characters long to account
for any PTF code field expansion.
727.802,92 ED DISPOSITION CODE 2;11 SET
'A' FOR ADMIT;
'D' FOR DECEASED;
'E' FOR ERROR;
'L' FOR LEFT;
'R' FOR REFERRED;
'T' FOR TRANSFERRED;
'U' FOR UNKNOWN;
'N' FOR NONE;
LAST EDITED: MAR 02, 2012
HELP-PROMPT: Enter the disposition code for the emergency room visit.
DESCRIPTION:
Disposition code associated with the patient's emergency room visit.
TECHNICAL DESCR: The emergency room disposition is derived by calling $$EDIS^ECXUTL, which uses the TIME OUT field
(#.09) of the ED LOG file (#230) to determine if the patient was seen in the emergency room in the
24 hours prior to or the 24 hours after the admission date/time. If the patient was seen within
that time frame then the NAME field (#.01) of the TRACKING CODE file (#233.1) as pointed to by the
DISPOSITION field (#1.2) of the ED LOG file (#230) is used to identify the disposition code.
727.802,93 PRIMARY ICD-10 CODE 2;12 FREE TEXT
INPUT TRANSFORM: K:$L(X)>8!($L(X)<1) X
LAST EDITED: MAR 08, 2012
HELP-PROMPT: Enter the primary ICD-10 code for this admission.
DESCRIPTION:
The primary ICD-10 diagnosis code for this admission.
TECHNICAL DESCR: Using the "ATT1" cross reference on the PATIENT MOVEMENT file (#405) and the patient pointer (DFN)
stored in the PATIENT NO. - DFN field (#4) in this file, PRIMARY ICD-10 CODE is derived by using
the PTF ENTRY field (.16) in the PATIENT MOVEMENT file (#405) to get the ICD 1 field (#5) within
the 501 multiple (#50) in the PTF file (#45).
727.802,94 CAMP LEJEUNE STATUS 2;13 SET
'Y' FOR YES;
'N' FOR NO;
LAST EDITED: MAR 08, 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.802,95 ENCOUNTER CAMP LEJEUNE 2;14 SET
'Y' FOR YES;
'N' FOR NO;
LAST EDITED: MAR 08, 2013
HELP-PROMPT: Indicate if this encounter is related to exposure at Camp Lejeune.
DESCRIPTION: Indicates if episode of care is related to exposure to contaminated water while stationed at Camp
Lejeune, NC between January 1, 1957 and December 31, 1987.
TECHNICAL DESCR: Using a pointer to the VISIT file (#9000010) a call is made to API VISIT^ECXSCX1 which in turn
calls ENCEVENT^PXAPI. The ENCEVENT^PXAPI returns the encounter Camp Lejeune data from the VISIT
file (#9000010).
727.802,96 ENCOUNTER SC 2;15 SET
'Y' FOR YES;
'N' FOR NO;
LAST EDITED: MAR 10, 2013
HELP-PROMPT: Is this Encounter Service Connected?
DESCRIPTION:
Indicates if treatment provided during this patient encounter is Service Connected.
TECHNICAL DESCR: Using a pointer to the VISIT file (#9000010) a call is made to API VISIT^ECXSCX1 which in turn
calls ENCEVENT^PXAPI. This call returns visit data, including the SERVICE CONNECTED field (#80001)
in the VISIT file (#9000010).
727.802,97 COMBAT VETERAN INDICATOR 2;16 SET
'Y' FOR YES;
'N' FOR NO;
LAST EDITED: MAR 06, 2014
HELP-PROMPT: Enter 'YES' if this patient is a Combat Veteran.
DESCRIPTION:
Identifies if the patient served in a combat zone.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in this file, COMBAT
SERVICE INDICATOR data is derived from the COMBAT SERVICE INDICATED field (#.5291) in the PATIENT
file (#2). COMBAT SERVICE INDICATED is returned by the supported call SVC^VADPT.
727.802,98 COMBAT VETERAN LOCATION 2;17 FREE TEXT
INPUT TRANSFORM: K:$L(X)>14!($L(X)<1) X
LAST EDITED: APR 03, 2014
HELP-PROMPT: Answer must be 1-14 characters in length.
DESCRIPTION:
Identifies the war in which the combat service was incurred.
TECHNICAL DESCR: Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in this file, COMBAT
SERVICE LOCATION data is derived from the COMBAT SERVICE LOCATION field (#.5292) in the PATIENT
file (#2). The COMBAT SERVICE LOCATION IEN is returned by the supported call SVC^VADPT, this IEN
is then used to retrieve the ABBREVIATION field(#1) from the POW PERIOD file (#22).
727.802,99 PATIENT DIVISION 2;18 FREE TEXT
INPUT TRANSFORM: K:$L(X)>7!($L(X)<3) X
MAXIMUM LENGTH: 7
LAST EDITED: JUN 29, 2017
HELP-PROMPT: Enter the 3 to 7 character Station Number of the facility where the patient is admitted.
DESCRIPTION:
This field will identify the Station Number of the facility where the patient is admitted.
TECHNICAL DESCR: Data comes from the WARD LOCATION field (#.06) in the PATIENT MOVEMENT file (#405). This value is a
pointer to the WARD LOCATION file (#42), which in turn is used to get the DIVISION field (#.015) in
the WARD LOCATION file (#40.8). This value is then used to call the API RADDIV^ECXDEPT to get the
STATION NUMBER field (#99) from the INSTITUTION file (#4).
727.802,100 PLACEHOLD CERNER 3;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>312!($L(X)<1) X
MAXIMUM LENGTH: 312
LAST EDITED: APR 29, 2022
HELP-PROMPT: Answer must be 1-312 characters in length.
DESCRIPTION:
Placeholder for Cerner fields. Reserved for EHRM conversion.
TECHNICAL DESCR:
This field is reserved for CERNER extract data.
727.802,101 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.802,102 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: The 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 ADMISSION EXTRACT
file (#727.802), this data is extracted from the SELF IDENTIFIED GENDER field (#.024) of the
PATIENT file (#2).
FILES POINTED TO FIELDS
DRG (#80.2) PLACEHOLD DRG (#31)
DSS EXTRACT LOG (#727) EXTRACT NUMBER (#2)
HOSPITAL LOCATION (#44) WARD (#27)
MARITAL STATUS (#11) MARITAL STATUS (#26)
MEDICAL CENTER DIVISION (#40.8) FACILITY (#3)
PATIENT (#2) PATIENT NO. - DFN (#4)
PATIENT MOVEMENT (#405) MOVEMENT FILE # (#30)
POW PERIOD (#22) POW LOCATION (#61)
RELIGION (#13) PLACEHOLD RELIGION (#12)
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):