STANDARD DATA DICTIONARY #51.28 -- PHARMACOGENOMIC PHENOTYPES FILE 3/2/26 PAGE 1
STORED IN ^PS(51.28, (51 ENTRIES) SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 1.0)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
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.
This file contains a list of standard phenotypes, associated synonyms, and a corresponding vendor phenotype for every standard
phenotype. The associated vendor phenotype will be used for the pharmacogenomic order checks provided by the vendor. Updates cannot
be made at a local facility.
DD ACCESS: @
RD ACCESS: Pp
WR ACCESS: @
DEL ACCESS: @
LAYGO ACCESS: @
AUDIT ACCESS: @
POINTED TO BY: STANDARD PHENOTYPE field (#.01) of the STANDARD PHENOTYPE sub-field (#51.263) of the PHARMACOGENOMIC GENES File
(#51.26)
REPLACED BY VHA STANDARD TERM field (#99.97) of the PHARMACOGENOMIC PHENOTYPES File (#51.28)
CROSS
REFERENCED BY: REPLACED BY VHA STANDARD TERM(AREPLACETERM), VUID(AVUID)
INDEXED BY: VUID & MASTER ENTRY FOR VUID (AMASTERVUID), NAME (B), FIRST DATABANK PHENOTYPE (C), SYNONYM (D)
LAST MODIFIED: MAR 2,2026@02:07:48
51.28,.01 NAME 0;1 FREE TEXT (Required)
INPUT TRANSFORM: K:$L(X)>75!($L(X)<1)!'(X'?1P.E) X
MAXIMUM LENGTH: 75
LAST EDITED: APR 23, 2025
HELP-PROMPT: Enter the name of the Phenotype. The answer must be 1-75 characters in length.
DESCRIPTION: This is the name of the Phenotype. This field, in addition to the synonyms also in this file, will
enable the software to derive a vendor phenotype to be used in the pharmacogenomic order check for
medication orders.
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")
DELETE TEST: 1,0)= D:'$D(XUMF) EN^DDIOL("Entries must be inactivated via the Master File Server(MFS).","","!?5")
I '$D(XUMF)
LAYGO TEST: 1,0)= D:'$D(XUMF) EN^DDIOL("Entries must be added via the Master File Server(MFS).","","!?5") I $D(
XUMF)
WRITE AUTHORITY: ^
FIELD INDEX: B (#1721) REGULAR IR LOOKUP & SORTING
Short Descr: This cross reference sets the global PS(51.28,"B",X,DA)="".
Description: This is the "B" cross reference on the NAME (#01) Field. This cross reference, along with the
Synonym and Name cross references, will be used when converting a Phenotype from a lab test to a
First DataBank Phenotype, enabling successful pharmacogenomic order checking.
Set Logic: S ^PS(51.28,"B",$E(X,1,75),DA)=""
Kill Logic: K ^PS(51.28,"B",$E(X,1,75),DA)
Whole Kill: K ^PS(51.28,"B")
X(1): NAME (51.28,.01) (Subscr 1) (Len 75) (forwards)
51.28,1 FIRST DATABANK PHENOTYPE 0;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>75!($L(X)<1) X
MAXIMUM LENGTH: 75
LAST EDITED: APR 23, 2025
HELP-PROMPT: Enter the name of the First Databank Phenotype. The answer must be 1-75 characters in length.
DESCRIPTION: This field provides the mapping from the lab test Phenotype to the First DataBank Phenotype. The
First DataBank Phenotype will be used when processing the pharmacogenomic order checks provided by
First DataBank.
FIELD INDEX: C (#1722) REGULAR IR LOOKUP & SORTING
Short Descr: This cross reference sets the global PS(51.28,"C",X,DA)="".
Description: This is the "C" cross reference on the FIRST DATABANK PHENOTYPE (#1) Field. This cross reference,
along with the SYNONYM and NAME cross references, will be used when converting a Phenotype from a
lab test to a corresponding First DataBank Phenotype, enabling successful pharmacogenomic order
checking.
Set Logic: S ^PS(51.28,"C",$E(X,1,75),DA)=""
Kill Logic: K ^PS(51.28,"C",$E(X,1,75),DA)
Whole Kill: K ^PS(51.28,"C")
X(1): FIRST DATABANK PHENOTYPE (51.28,1) (Subscr 1) (Len 75) (forwards)
51.28,2 SYNONYM 1;0 Multiple #51.282
DESCRIPTION:
This multiple contains a list of synonyms for the NAME field, which is the name of the Phenotype.
51.282,.01 SYNONYM 0;1 FREE TEXT (Multiply asked)
INPUT TRANSFORM: K:$L(X)>75!($L(X)<1) X
MAXIMUM LENGTH: 75
LAST EDITED: APR 24, 2025
HELP-PROMPT: Enter a synonym for the name of the Phenotype. The answer must be 1-75 characters in length.
DESCRIPTION: This is a synonym for the NAME field, which is the name of the Phenotype. The synonym will be
used for mapping Phenotypes from lab test results to a First DataBank Phenotype that can be used
in pharmacogenomic order checking.
CROSS-REFERENCE: 51.282^B
1)= S ^PS(51.28,DA(1),1,"B",$E(X,1,30),DA)=""
2)= K ^PS(51.28,DA(1),1,"B",$E(X,1,30),DA)
FIELD INDEX: D (#1723) REGULAR IR LOOKUP & SORTING WHOLE FILE (#51.28)
Short Descr: This cross reference will be used to map phenotypes.
Description: This is a whole file cross reference on the SYNONYM (#.01) Field of the SYNONYM (#51.282)
Subfile. It sets the global ^PS(51.28,"D",SYNONYM,DA(1),DA)="".
Set Logic: S ^PS(51.28,"D",$E(X,1,75),DA(1),DA)=""
Kill Logic: K ^PS(51.28,"D",$E(X,1,75),DA(1),DA)
Whole Kill: K ^PS(51.28,"D")
X(1): SYNONYM (51.282,.01) (Subscr 1) (Len 75) (forwards)
51.28,99.97 REPLACED BY VHA STANDARD TERM VUID;3 POINTER TO PHARMACOGENOMIC PHENOTYPES FILE (#51.28)
LAST EDITED: APR 22, 2025
HELP-PROMPT: Enter the VHA standard term that replaces this term.
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. This field
contains a pointer to a VHA standard term that replaces this entry.
CROSS-REFERENCE: 51.28^AREPLACETERM
1)= S ^PS(51.28,"AREPLACETERM",$E(X,1,30),DA)=""
2)= K ^PS(51.28,"AREPLACETERM",$E(X,1,30),DA)
This cross-reference can be used to identify the replacement entries associated with a
Term/Concept.
51.28,99.98 MASTER ENTRY FOR VUID VUID;2 SET (Required)
'0' FOR NO;
'1' FOR YES;
LAST EDITED: APR 22, 2025
HELP-PROMPT: Enter '1' for 'Yes' if this entry is the Master entry for this VUID.
DESCRIPTION:
This field identifies the Master entry for a VUID associated with a Term/Concept.
RECORD INDEXES: AMASTERVUID (#1702)
51.28,99.99 VUID VUID;1 FREE TEXT
INPUT TRANSFORM: S X=+X K:$L(X)>20!($L(X)<1)!'(X?1.20N) X
MAXIMUM LENGTH: 20
LAST EDITED: APR 23, 2025
HELP-PROMPT: : Enter the VHA Unique ID (VUID) that represents this VHA wide term.
DESCRIPTION: This number represents the VHA Unique ID (VUID). It is a unique meaningless integer assigned to
reference terms VHA wide.
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER
CROSS-REFERENCE: 51.28^AVUID
1)= S ^PS(51.28,"AVUID",$E(X,1,30),DA)=""
2)= K ^PS(51.28,"AVUID",$E(X,1,30),DA)
This cross-reference is by VUID.
RECORD INDEXES: AMASTERVUID (#1702)
51.28,99.991 EFFECTIVE DATE/TIME TERMSTATUS;0 DATE Multiple #51.2899 (Add New Entry without Asking)
DESCRIPTION: This multiple field contains the history of changes to the status of this reference term, along
with the date/time of each change.
51.2899,.01 EFFECTIVE DATE/TIME 0;1 DATE (Required)
INPUT TRANSFORM: S %DT="ESTX" D ^%DT S X=Y K:Y<1 X
LAST EDITED: APR 23, 2025
HELP-PROMPT: Enter the Date/Time when the Status of the reference term was established or changed.
DESCRIPTION:
This is the date/time when the Status of the reference term was established.
CROSS-REFERENCE: 51.2899^B
1)= S ^PS(51.28,DA(1),"TERMSTATUS","B",$E(X,1,30),DA)=""
2)= K ^PS(51.28,DA(1),"TERMSTATUS","B",$E(X,1,30),DA)
This cross-reference is by Effective Date/Time.
51.2899,.02 STATUS 0;2 SET
'1' FOR ACTIVE;
'0' FOR INACTIVE;
LAST EDITED: APR 23, 2025
HELP-PROMPT: Enter the current status of the term, either ACTIVE or INACTIVE.
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.
UNEDITABLE
FILES POINTED TO FIELDS
PHARMACOGENOMIC PHENOTYPES
(#51.28) REPLACED BY VHA STANDARD TERM (#99.97)
File #51.28
Record Indexes:
AMASTERVUID (#1702) 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 ^PS(51.28,"AMASTERVUID",$E(X(1),1,30),X(2),DA)=""
Kill Logic: K ^PS(51.28,"AMASTERVUID",$E(X(1),1,30),X(2),DA)
Whole Kill: K ^PS(51.28,"AMASTERVUID")
X(1): VUID (51.28,99.99) (Subscr 1) (Len 30) (forwards)
X(2): MASTER ENTRY FOR VUID (51.28,99.98) (Subscr 2) (forwards)
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):