STANDARD DATA DICTIONARY #11.99 -- MASTER MARITAL STATUS FILE 3/24/25 PAGE 1
STORED IN ^DGMMS(11.99, (5 ENTRIES) SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 5.3)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
The MASTER MARITAL STATUS file (#11.99) contains the standard set of marital statuses from the HL7 Standards Development
Organization (SDO).
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: MASTER MARITAL STATUS field (#90) of the MARITAL STATUS File (#11)
REPLACED BY VHA STANDARD TERM field (#99.97) of the MASTER MARITAL STATUS File (#11.99)
CROSS
REFERENCED BY: ASSOCIATED VA MARITAL STATUSES(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
11.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 07, 2017
HELP-PROMPT: Answer must be 3-60 characters in length.
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: 11.99^B
1)= S ^DGMMS(11.99,"B",$E(X,1,60),DA)=""
2)= K ^DGMMS(11.99,"B",$E(X,1,60),DA)
11.99,1 CODE 0;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>30!($L(X)<1) X
MAXIMUM LENGTH: 30
LAST EDITED: AUG 02, 2017
HELP-PROMPT: Answer must be 1-30 characters in length.
DESCRIPTION:
This field contains the code representing the HL7 Standard Marital Status.
WRITE AUTHORITY: ^
11.99,99 ASSOCIATED VA MARITAL STATUSES ASSOC;0 Multiple #11.99901 (Add New Entry without Asking)
DESCRIPTION: This contains the VA Marital Status(es) associated with this Health Level Seven (HL7) Master File
entry.
WRITE AUTHORITY: ^
11.99901,.01 ASSOCIATED VA MARITAL STATUSES 0;1 FREE TEXT (audited)
INPUT TRANSFORM: K:$L(X)>15!($L(X)<2) X
MAXIMUM LENGTH: 15
LAST EDITED: SEP 15, 2017
HELP-PROMPT: Answer must be 2-15 characters in length.
DESCRIPTION: This field contains the name of a VA MARITAL STATUS file (#11) entry associated with this Health
Level Seven (HL7) Term/Concept.
AUDIT: YES, ALWAYS
AUDIT CONDITION: I $G(XUMF)
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER
CROSS-REFERENCE: 11.99901^B
1)= S ^DGMMS(11.99,DA(1),"ASSOC","B",$E(X,1,15),DA)=""
2)= K ^DGMMS(11.99,DA(1),"ASSOC","B",$E(X,1,15),DA)
CROSS-REFERENCE: 11.99^AC
1)= S ^DGMMS(11.99,"AC",$E(X,1,15),DA(1),DA)=""
2)= K ^DGMMS(11.99,"AC",$E(X,1,15),DA(1),DA)
This cross reference sorts ASSOCIATED VA MARITAL STATUSES (#90) field values by MASTER MARITAL
STATUSES (#11.99) file entry.
11.99,99.97 REPLACED BY VHA STANDARD TERM VUID;3 POINTER TO MASTER MARITAL STATUS FILE (#11.99)
LAST EDITED: AUG 04, 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: 11.99^AREPLACETERM
1)= S ^DGMMS(11.99,"AREPLACETERM",$E(X,1,30),DA)=""
2)= K ^DGMMS(11.99,"AREPLACETERM",$E(X,1,30),DA)
This cross reference can be used to identify the replacement entries associated with a
Term/Concept.
11.99,99.98 MASTER ENTRY FOR VUID VUID;2 SET
'1' FOR YES;
'0' FOR NO;
LAST EDITED: AUG 04, 2017
HELP-PROMPT: Enter YES if this is the master entry for the Term/Concept.
DESCRIPTION:
This field identifies the Master Entry for a VUID associated with a Term/Concept.
WRITE AUTHORITY: ^
RECORD INDEXES: AMASTERVUID (#1505)
11.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 (#1505)
11.99,99.991 EFFECTIVE DATE/TIME TERMSTATUS;0 DATE Multiple #11.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: ^
11.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 02, 2017
HELP-PROMPT: Enter the Date/Time the Term status went into effect.
DESCRIPTION:
This is the date/time when the status of the reference term was established.
WRITE AUTHORITY: ^
CROSS-REFERENCE: 11.9901^B
1)= S ^DGMMS(11.99,DA(1),"TERMSTATUS","B",$E(X,1,30),DA)=""
2)= K ^DGMMS(11.99,DA(1),"TERMSTATUS","B",$E(X,1,30),DA)
11.9901,.02 STATUS 0;2 SET (Required)
'0' FOR INACTIVE;
'1' FOR ACTIVE;
LAST EDITED: AUG 02, 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
MASTER MARITAL STATUS (#11.99) REPLACED BY VHA STANDARD TERM (#99.97)
File #11.99
Record Indexes:
AMASTERVUID (#1505) 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 ^DGMMS(11.99,"AMASTERVUID",$E(X(1),1,30),X(2),DA)=""
Kill Logic: K ^DGMMS(11.99,"AMASTERVUID",$E(X(1),1,30),X(2),DA)
Whole Kill: K ^DGMMS(11.99,"AMASTERVUID")
X(1): VUID (11.99,99.99) (Subscr 1) (Len 30) (forwards)
X(2): MASTER ENTRY FOR VUID (11.99,99.98) (Subscr 2) (forwards)
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):