MPIF UPDATE NAME COMP FLAG (4167)    REMOTE PROCEDURE (8994)

This Remote Procedure updates or retrieves the Name Components flag in
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)
VistA, which controls how names passed in HL7 ADT-A31 messages to VistA
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".
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 

• FLAG
  PARAMETER TYPE:   LITERAL
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

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

• VALUE
  PARAMETER TYPE:   LITERAL
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  This 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).
  

If the FLAG parameter contains a "G": 
 
        1^Successfully update flag to <value> in File #984.8
 
        -1^<error message>
 
        1^<value of parameter, 0 or 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 <value> in
          File #984.8