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

VAFHLPI1

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 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