ACCESS TO FILE 20 NAME COMPONENTS    ICR (3041)

All fields can be accessed/edited using FileMan tools.
Each entry in the NAME COMPONENTS file (#20) corresponds to a single source
name field in another file. The following three fields in the NAME COMPONENTS
file contain information about the source name field. These three fields
comprise the Primary Key for the NAME COMPONENTS file.

.01 File Number of file that contains source name field
.02 Field Number of the field that contains the source name field
.03 IENS (Internal Entry Number string) of the record that contains the
name to which this entry corresponds.

The name field in the source file should have cross-references that keep its
value in synchronization with the corresponding entry in the NAME COMPONENTS
file. For an example of this, see the .01 field of the NEW PERSON file.

The following fields are normally available for editing by end-users.

Field #     Name
1           FAMILY (LAST) NAME
2           GIVEN (FIRST) NAME
3           MIDDLE NAME
4           PREFIX (ex., MR, MS)
5           SUFFIX (ex., JR, III, ESQ)
6           DEGREE (ex., PHD)

(The DEGREE and PREFIX field are not part of the source name field (#.01) of
the NEW PERSON file.) Kernel APIs that return the name components are
available.

When any of the following fields in the NAME COMPONENTS file are edited via
FileMan tools:

Field #     Name
.01         FILE
.02         FIELD
.03         IENS
1           FAMILY (LAST) NAME
2           GIVEN (FIRST) NAME
3           MIDDLE NAME
5           SUFFIX
7           SOURCE NAME FORMAT FLAGS

the "ANAME" MUMPS cross-reference automatically updates the corresponding
source name field in the source file to reflect the changes. To prevent this
cross-reference from firing, you can NEW the variable XUNOTRIG and SET it to 1
before editing the any of the above fields.