STANDARD DATA DICTIONARY #10.99 -- RACE MASTER FILE 3/24/25 PAGE 1
STORED IN ^DGRAM(10.99, (5 ENTRIES) SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 5.3)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
The Race Master file contains standard Health Level Seven (HL7) race codes.
Per VHA Directive 2005-044, this file has been "locked down" by Data Standardization (DS). The file definition (i.e. data
dictionary) shall not be modified. All additions, changes and deletions to entries in the file shall be done by Enterprise
Reference Terminology (ERT) using the Master File Server (MFS), provided by Common Services (CS). Creating and/or editing locally
defined fields in the file are not permitted. Use of locally defined fields that were created prior to the VHA Directive's
2005-044 effective date shall not be supported.
DD ACCESS: @
RD ACCESS:
WR ACCESS: @
DEL ACCESS: @
LAYGO ACCESS: @
AUDIT ACCESS: @
POINTED TO BY: RACE MASTER field (#90) of the RACE File (#10)
REPLACED BY VHA STANDARD TERM field (#99.97) of the RACE MASTER File (#10.99)
CROSS
REFERENCED BY: ASSOCIATED VA RACE(S)(AC), REPLACED BY VHA STANDARD TERM(AREPLACETERM), NAME(B)
INDEXED BY: VUID & MASTER ENTRY FOR VUID (AMASTERVUID)
LAST MODIFIED: FEB 28,2018@17:14:56
10.99,.01 NAME 0;1 FREE TEXT (Required)
INPUT TRANSFORM: K:$L(X)>60!($L(X)<3)!'(X'?1P.E) X
MAXIMUM LENGTH: 60
LAST EDITED: AUG 03, 2017
HELP-PROMPT: Answer must be 3-60 characters in length.
DESCRIPTION:
The descriptive text name of the HL7 race.
PRE-LOOKUP: I $G(DIC(0))["L",'$D(XUMF) K X D EN^DDIOL("Entries must be edited via the Master File Server (MFS).
","","!?5,$C(7)")
DELETE TEST: 1,0)= D:'$D(XUMF) EN^DDIOL("Entries must be inactivated via the Master File Server (MFS).","","!?5,
$C(7)")
LAYGO TEST: 1,0)= D:'$D(XUMF) EN^DDIOL("Entries must be added via the Master File Server (MFS).","","!?5,$C(7)"
) I $D(XUMF)
WRITE AUTHORITY: ^
CROSS-REFERENCE: 10.99^B
1)= S ^DGRAM(10.99,"B",$E(X,1,60),DA)=""
2)= K ^DGRAM(10.99,"B",$E(X,1,60),DA)
10.99,1 CODE 0;2 FREE TEXT (Required)
INPUT TRANSFORM: K:$L(X)>30!($L(X)<2) X
MAXIMUM LENGTH: 30
LAST EDITED: AUG 03, 2017
HELP-PROMPT: Answer must be 2-30 characters in length.
DESCRIPTION:
The RxNorm Concept Unique Identifier (RXCUI) code representing the HL7 Race concept.
WRITE AUTHORITY: ^
10.99,99 ASSOCIATED VA RACES ASSOC;0 Multiple #10.99901 (Add New Entry without Asking)
LAST EDITED: AUG 03, 2017
DESCRIPTION:
This contains the VA Races associated with this Health Level Seven (HL7) Master file entry.
WRITE AUTHORITY: ^
10.99901,.01 ASSOCIATED VA RACE(S) 0;1 FREE TEXT (audited)
INPUT TRANSFORM: K:$L(X)>45!($L(X)<4) X
MAXIMUM LENGTH: 45
LAST EDITED: SEP 15, 2017
HELP-PROMPT: Answer must be 4-45 characters in length.
DESCRIPTION:
This field contains an entry from the VA RACE file (#10) associated with this Master entry.
AUDIT: YES, ALWAYS
AUDIT CONDITION: D QUE^DGNDSU I $G(XUMF)
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER
CROSS-REFERENCE: 10.99901^B
1)= S ^DGRAM(10.99,DA(1),"ASSOC","B",$E(X,1,45),DA)=""
2)= K ^DGRAM(10.99,DA(1),"ASSOC","B",$E(X,1,45),DA)
CROSS-REFERENCE: 10.99^AC
1)= S ^DGRAM(10.99,"AC",$E(X,1,45),DA(1),DA)=""
2)= K ^DGRAM(10.99,"AC",$E(X,1,45),DA(1),DA)
This cross reference sorts ASSOCIATED VA RACES (#90) field values by RACE MASTER (#10.99) entry.
10.99,99.97 REPLACED BY VHA STANDARD TERM VUID;3 POINTER TO RACE MASTER FILE (#10.99)
LAST EDITED: AUG 16, 2017
HELP-PROMPT: Enter the Term/Concept that replaces this entry.
DESCRIPTION: This field is populated when one Term/Concept replaces another Term/Concept. This field is
controlled by standardization and should only be changed by standardization processes.
WRITE AUTHORITY: ^
CROSS-REFERENCE: 10.99^AREPLACETERM
1)= S ^DGRAM(10.99,"AREPLACETERM",$E(X,1,30),DA)=""
2)= K ^DGRAM(10.99,"AREPLACETERM",$E(X,1,30),DA)
This cross reference can be used to identify the replacement entries associated with a
Term/Concept.
10.99,99.98 MASTER ENTRY FOR VUID VUID;2 SET
'1' FOR YES;
'0' FOR NO;
LAST EDITED: AUG 04, 2017
HELP-PROMPT: Enter 1 if this is the master entry.
DESCRIPTION:
This field identifies the Master entry for a VUID associated with a Term/Concept.
WRITE AUTHORITY: ^
RECORD INDEXES: AMASTERVUID (#1504)
10.99,99.99 VUID VUID;1 FREE TEXT (Required)
INPUT TRANSFORM: K:$L(X)>20!($L(X)<1) X
MAXIMUM LENGTH: 20
LAST EDITED: AUG 04, 2017
HELP-PROMPT: Answer must be 1-20 characters in length.
DESCRIPTION: VHA Unique ID (VUID). A unique, arbitrarily-assigned integer assigned to reference terms, and used
to identify the terms across the VHA enterprise.
WRITE AUTHORITY: ^
RECORD INDEXES: AMASTERVUID (#1504)
10.99,99.991 EFFECTIVE DATE/TIME TERMSTATUS;0 DATE Multiple #10.9901 (Add New Entry without Asking)
DESCRIPTION: This sub-file contains the current status of the term/concept and the date/time the term/concept's
status went into effect.
WRITE AUTHORITY: ^
10.9901,.01 EFFECTIVE DATE/TIME 0;1 DATE (Required)
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: AUG 01, 2017
HELP-PROMPT: Enter the Date/Time the status became effective.
DESCRIPTION:
This is the date/time when the status of the reference term was established.
WRITE AUTHORITY: ^
CROSS-REFERENCE: 10.9901^B
1)= S ^DGRAM(10.99,DA(1),"TERMSTATUS","B",$E(X,1,30),DA)=""
2)= K ^DGRAM(10.99,DA(1),"TERMSTATUS","B",$E(X,1,30),DA)
10.9901,.02 STATUS 0;2 SET (Required)
'1' FOR ACTIVE;
'0' FOR INACTIVE;
LAST EDITED: AUG 01, 2017
HELP-PROMPT: Enter the status of this term.
DESCRIPTION: The Status of a reference term is either 'ACTIVE' or 'INACTIVE'. If 'ACTIVE', then the term will
be accessible by end-users to document a particular patient event. If 'INACTIVE', then the term
will only be accessible by the application to display legacy data.
WRITE AUTHORITY: ^
FILES POINTED TO FIELDS
RACE MASTER (#10.99) REPLACED BY VHA STANDARD TERM (#99.97)
File #10.99
Record Indexes:
AMASTERVUID (#1504) RECORD REGULAR IR SORTING ONLY
Short Descr: This cross reference identifies the Master Entry for a VUID.
Description: If multiple entries have the same VUID in the file, this cross-reference can be used to identify the Master
entry for a VUID associated with a Term/Concept.
Set Logic: S ^DGRAM(10.99,"AMASTERVUID",$E(X(1),1,30),X(2),DA)=""
Kill Logic: K ^DGRAM(10.99,"AMASTERVUID",$E(X(1),1,30),X(2),DA)
Whole Kill: K ^DGRAM(10.99,"AMASTERVUID")
X(1): VUID (10.99,99.99) (Subscr 1) (Len 30) (forwards)
X(2): MASTER ENTRY FOR VUID (10.99,99.98) (Subscr 2) (forwards)
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):