Print Page as PDF
PID SEGMENT BUILDING - RETURN RACE AND ETHNICITY ICR (6144)

PID SEGMENT BUILDING - RETURN RACE AND ETHNICITY    ICR (6144)

Name Value
NUMBER 6144
IA # 6144
DATE CREATED 2015/01/13
CUSTODIAL PACKAGE REGISTRATION
USAGE Private
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE VAFHLPI1
NAME PID SEGMENT BUILDING - RETURN RACE AND ETHNICITY
GENERAL DESCRIPTION 
VAFHLPI1 is a routine that is used to build the PID
segment of HL7 messages. It is comprised of functions that return the race and
the ethnicity of a patient.
STATUS Active
KEYWORDS
  • MAG VAFHLPI1
  • MAG RACE/ETHNICITY PID SEGMENT
DURATION Till Otherwise Agreed
ID VAFHLPI1
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
SEQ10 
This function returns the race of a specific patient.
The validity and existence of the input is assumed. Use of the 'T' & 'B'
qualifiers assumes use of the 'N' qualifier. This function assumes no
individual component is greater than 245 characters in length.
VARIABLES TYPE VARIABLES DESCRIPTION
HOW Input 
Passes in qualifiers denoting how and which (new or
historic) race information is to be returned.
"N": Return new race value (2.02 multiple)
"T": Include text (components 2 & 5)
"B": Include second triplet (components 4 - 6)
Null: Return historical value (.06 field)
HLQ Input 
HLQ is the variable used to insert null field values
in segments.
VAFY Output 
The array in which race information is returned for a
specific patient.
SEQ22 
This function returns the ethnicity of a specific
patient. The validity and existence of the input variables are assumed. This
function assumes no individual component is greater than 245 characters in
length.
VARIABLES TYPE VARIABLES DESCRIPTION
HOW Input 
Passes in qualifiers denoting how and which (new or
historic) race information is to be returned.
"T": Include text (components 2 & 5)
"B": Include second triplet (components 4 - 6)
Null: Only return components 1 - 3.
HLQ Input 
HLQ is the variable used to insert null field values
in segments.
VAFY Output 
The array in which ethnicity information is returned
for a specific patient.
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE SUBSCRIBING DETAILS
IMAGING 
With the activation of this Integration Agreement (IA),
VistA Imaging will build their PID segment with the race and ethnicity data
returned from the functions SEQ10 (race) and SEQ22 (ethnicity) provided in the
routine: VAFHLPI1.
DATE ACTIVATED 2015/08/04