MPIF UPDATE NAME COMP FLAG

TITLEVALUE
NAMEMPIF UPDATE NAME COMP FLAG
DESCRIPTIONThis Remote Procedure updates or retrieves the Name Components flag in
VistA, which controls how names passed in HL7 ADT-A31 messages to VistA
are processed.

If the flag is set to 0 or null, then the component parts of the name that
are passed in the HL7 message are used to build a name, possibly shortened
to 30 characters, and then filed into the PATIENT file (#2) NAME field
(#.01) The same is true for aliases. The components parts of any aliases
are used to build a possibly shortened alias, and filed into the ALIAS
multiple (#1) NAME field (#.01) of the PATIENT file. MUMPS cross
references on the PATIENT file (#2) NAME field (#.01) and the ALIAS
multiple (#1) NAME field (#.01) will update the corresponding NAME
COMPONENTS file (#20) entry with the name components passed in the ADT-A31
message.

If the Name Components flag is set to 1, then the component parts of the
name or alias are filed directly into the NAME COMPONENTS file. A MUMPS
cross reference on the fields in the NAME COMPONENTS file will update the
source field -- the Patient Name field (#.01) or the Alias multiple (#2)
Name field (#.01) -- with a formatted name.

The flag will be stored in the MPI ICN BUILD MANAGEMENT file (#984.8),
LAST PATIENT BUILT field (#3) of entry number 3, that has the NAME of
"THREE".
TAGUPDFLAG
ROUTINEMPIFNAMC
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERFLAG
DESCRIPTIONThis parameter contains a flag to control how the Remote Procedure works.
If it contains a "G", the Remote Procedure operates in "GET" mode,
and simply returns the value of the flag; otherwise, the flag is set
to the value passed in the VALUE parameter.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH

INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERVALUE
DESCRIPTIONThis is the value to set the flag to. A value of 0 indicates that the
Name and Aliases passed in an ADT-A31 should be filed into the NAME
field (#.01) or ALIAS multiple (#1) NAME field (#.01) of the PATIENT file
(#2). A value of 1 indicates that the Name and Aliases should be filed
into the NAME COMPONENTS file (#20).
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH

RETURN VALUE TYPESINGLE VALUE
RETURN PARAMETER DESCRIPTIONIf the FLAG parameter contains a "G":

1^

If the FLAG parameter does not contain a "G" one of three strings will be
returned:

1^Successfully added entry THREE and updated flag to in
File #984.8

1^Successfully update flag to in File #984.8

-1^
AVAILABILITYPUBLIC
INACTIVE
CLIENT MANAGER
WORD WRAP ON
VERSION1
SUPPRESS RDV USER SETUP
APP PROXY ALLOWEDNo