Global: ^VA(20

FileMan FileNo	FileMan Filename	Package
20	NAME COMPONENTS	Kernel

FileMan FileNo

FileMan Filename

Package

NAME COMPONENTS

Kernel

Description

This file, introduced with Name Standardization (Patch XU*8.0*134), holds the component parts of a person's name as follows: Family (Last) Name (field #1) Given (First) Name (field #2) Middle Name (field #3) Prefix (field #4) Suffix (field #5) Degree (field #6) The "source name" that has these components is identified by the following three fields: File (field #.01) Field (field #.02) IENS (field #.03) The "ANAME" cross-reference on the Family (Last) Name, Given (First) Name, Middle Name, and Suffix fields keeps each component in synchronization with the corresponding source name. In the case of Patch XU*8.0*134, the source name is the .01 field (the Name field) of the NEW PERSON file (#200). The Degree and Prefix fields are not considered part of a standard name, but can be used to build formatted names for display.

Package	Total	Routines
Kernel	9	XLFNAME1 XLFNAME2 XLFNP152 XLFNP176 XU8P799 XUESSO3 XUMVINPU XUSERNEW ^VA(20
Registration	6	DG53P543 DG53P750 DG702PST DGNAME DGRPECE VAFCPTED
Oncology	2	ONCORIS ONCORIST
HealtheVet Desktop	1	XHDAUTH
Income Verification Match	1	IVMZ07C
VBECS	1	VBECLU0

Package

Total

Routines

Kernel

XLFNAME1 XLFNAME2 XLFNP152 XLFNP176 XU8P799 XUESSO3 XUMVINPU XUSERNEW
^VA(20

Registration

DG53P543 DG53P750 DG702PST DGNAME DGRPECE VAFCPTED

Oncology

ONCORIS ONCORIST

HealtheVet Desktop

XHDAUTH

Income Verification Match

IVMZ07C

VBECS

VBECLU0

Package	Total	Routines
Registration	9	DG702PST DGNAME DGRP1 DGRPECE DGRRLU0 DPTNAME VAFCPDT2 VAFCPTAD VAFCSB
Clinical Information Resource Network	1	RGADTP3
Outpatient Pharmacy	1	PSOSPMUT
VistALink Security	1	XOBSCAV2
Wounded Injured and Ill Warriors	1	WIIGATD

Package

Total

Routines

Registration

DG702PST DGNAME DGRP1 DGRPECE DGRRLU0 DPTNAME VAFCPDT2 VAFCPTAD
VAFCSB

Clinical Information Resource Network

RGADTP3

Outpatient Pharmacy

PSOSPMUT

VistALink Security

XOBSCAV2

Wounded Injured and Ill Warriors

WIIGATD

Package	Total	FileMan Files
Kernel	1	NEW PERSON(#200)[10.1]
Registration	1	PATIENT(#2)[1.01, 1.02, 1.03, 1.04, 1.05, 1.06, 1.07, 1.08, 1.09, #2.01(100.03), #2.101(100.21)]

Package

Total

FileMan Files

Kernel

NEW PERSON(#200)[10.1]

Registration

PATIENT(#2)[1.01, 1.02, 1.03, 1.04, 1.05, 1.06, 1.07, 1.08, 1.09, #2.01(100.03), #2.101(100.21)]

Fields, Total: 11

Field #	Name	Loc	Type	Details
.01	FILE	0;1	NUMBER	**********************REQUIRED FIELD********************** INPUT TRANSFORM: `K:+X'=X!(X>999999999999)!(X<0)!(X?.E1"."8N.N) X` LAST EDITED: `AUG 17, 2001` HELP-PROMPT: `Answer must be a number between 0 and 999999999999, with up to 7 decimal digits. Answer '??' for more help.` DESCRIPTION: `Answer must be the number of the file or subfile that contains the name field.` `UNEDITABLE` CROSS-REFERENCE: `20^B` `1)= S ^VA(20,"B",$E(X,1,30),DA)=""` `2)= K ^VA(20,"B",$E(X,1,30),DA)` RECORD INDEXES: `ADEG (#3), ANAME (#4), ASIG (#1737), BB (#6)`
.02	FIELD	0;2	NUMBER	**********************REQUIRED FIELD********************** INPUT TRANSFORM: `K:+X'=X!(X>999999999999)!(X<0)!(X?.E1"."8N.N) X` LAST EDITED: `AUG 17, 2001` HELP-PROMPT: `Answer must be a number between 0 and 999999999999, with up to 7 decimal digits. Answer '??' for more help.` DESCRIPTION: `Answer must be the number of the field that contains the name.` `UNEDITABLE` RECORD INDEXES: `ADEG (#3), ANAME (#4), ASIG (#1737), BB (#6)`
.03	IENS	0;3	FREE TEXT	**********************REQUIRED FIELD********************** INPUT TRANSFORM: `K:$L(X)>50!($L(X)<2) X` LAST EDITED: `AUG 17, 2001` HELP-PROMPT: `Answer must be 2-50 characters in length. Answer '??' for more help.` DESCRIPTION: `Answer must be the IENS of the entry that contains the name.` `UNEDITABLE` RECORD INDEXES: `ADEG (#3), ANAME (#4), ASIG (#1737), BB (#6)`
1	FAMILY (LAST) NAME	1;1	FREE TEXT	**********************REQUIRED FIELD********************** INPUT TRANSFORM: K:$L(X)>35!($L(X)<1)!'(X?1U.UNP)!(X["`") X LAST EDITED: `AUG 17, 2001` HELP-PROMPT: `Answer must be 1-35 characters in length. Answer '??' for more help.` DESCRIPTION: Answer with the person's family (last) name. It must begin with an upper-case letter and can contain only upper-case letters, numbers, and punctuation, excluding circumflexes (^) and grave accents (`). NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER` RECORD INDEXES: `ANAME (#4), ASIG (#1737), C (#7)`
2	GIVEN (FIRST) NAME	1;2	FREE TEXT	**********************REQUIRED FIELD********************** INPUT TRANSFORM: K:$L(X)>25!($L(X)<1)!'(X?1U.UNP)!(X["`") X LAST EDITED: `AUG 17, 2001` HELP-PROMPT: `Answer must be 1-25 characters in length. Answer '??' for more help.` DESCRIPTION: Answer with the person's given (first) name. It must begin with an upper-case letter and can contain only upper-case letters, numbers, and punctuation, excluding circumflexes (^) and grave accents (`). NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER` RECORD INDEXES: `ANAME (#4), ASIG (#1737), C (#7)`
3	MIDDLE NAME	1;3	FREE TEXT	INPUT TRANSFORM: K:$L(X)>25!($L(X)<1)!'(X?1U.UNP)!(X["`")!(X="NMI")!(X="NMN") X LAST EDITED: `AUG 17, 2001` HELP-PROMPT: `Answer must be 1-25 characters in length. Answer '??' for more help.` DESCRIPTION: Answer with the person's middle name. It must begin with an upper-case letter and can contain only upper-case letters, numbers, and punctuation, excluding circumflexes (^) and grave accents (`). Middle names of NMI and NMN `are not accepted.` NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER` RECORD INDEXES: `ANAME (#4), ASIG (#1737), C (#7)`
4	PREFIX	1;4	FREE TEXT	INPUT TRANSFORM: K:$L(X)>10!($L(X)<1)!'(X?1U.UNP)!(X["`") X LAST EDITED: `OCT 12, 1999` HELP-PROMPT: `Answer must be 1-10 characters in length. Answer '??' for more help.` DESCRIPTION: Answer with the name prefix, such as MR or MS. Answer must begin with an upper-case letter and can contain only upper-case letters, numbers, and punctuation, excluding circumflexes (^) and grave accents (`). NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER`
5	SUFFIX	1;5	FREE TEXT	INPUT TRANSFORM: K:$L(X)>10!($L(X)<1)!'(X?1UN.UNP)!(X["`") X LAST EDITED: `AUG 17, 2001` HELP-PROMPT: `Answer must be 1-10 characters in length. Answer '??' for more help.` DESCRIPTION: Answer with the name suffix(es), such as JR, SR, II, or III. Answer must begin with an upper-case letter and can contain only upper-case letters, numbers, and punctuation, excluding circumflexes (^) and grave accents (`). NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER` RECORD INDEXES: `ANAME (#4), ASIG (#1737), C (#7)`
6	DEGREE	1;6	FREE TEXT	INPUT TRANSFORM: `K:$L(X)>10!($L(X)<1)!($$PATM^XUSESIG3(X))!($$COMP^XUSESIG3(X)) X I $G(X)'="" N I,Z S Z=X F I=1:1:$L(Z," ") I '$D(^DIC(20.11,"C",$P(Z," ",I))) K X` `MAXIMUM LENGTH: 10` LAST EDITED: `DEC 20, 2018` HELP-PROMPT: `Answer must be valid code/s from the EDUCATION (#20.11) file. The field can contain multiple degree codes delimited by single blank space up to the 10 character length. No leading or trailing spaces.` DESCRIPTION: `This field holds any academic or professional degree that have been earned by the user. This would be things like BS, BA, MD, and PHD. Each degree must be a valid code from the EDUCATION (#20.11) file. The field can` `contain multiple degrees delimited by a single blank space up to the 10 character field length. This would be like PHD MD or BA CNA etc. No leading or trailing spaces.` NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER` RECORD INDEXES: `ADEG (#3)`
7	SOURCE NAME FORMAT FLAGS	1;7	FREE TEXT	INPUT TRANSFORM: `K:$L(X)>15!($L(X)<1) X` LAST EDITED: `DEC 28, 2001` HELP-PROMPT: `Answer must be 1-15 characters in length. Answer '??' for more help.` DESCRIPTION: `When the name fields in the Name Components file are edited, the "ANAME" cross-reference updates the corresponding name field in the source file. This SOURCE NAME FORMAT FLAGS field can be used to control the format of` `the name placed in the source name field.` `Answer with the flags used in $$NAMEFMT^XLFNAME API. For example,` `C : Return a Comma between the Family (Last) and Given (First)` `Names.` `L : Truncate the returned name to the maximum length as specified` `by the data type of the source name field.` `L# : Truncate the returned name to a maximum length of #` `characters, where # is an integer between 1 and 256.` `S : Standardize the name components before building the formatted` `name.` `If this field is null (i.e., no flags are specified), the default is "CLS".` RECORD INDEXES: `ANAME (#4)`
11	NOTES ABOUT NAME	11;1	FREE TEXT	INPUT TRANSFORM: `K:$L(X)>100!($L(X)<3) X` LAST EDITED: `JAN 31, 2000` HELP-PROMPT: `Answer must be 3-100 characters in length. Answer '??' for more help.` DESCRIPTION: `This field stores notes about the name.` `During the New Person Name Conversion, which is run as part of the post-install routine of Patch XU8.0134, if a name in the NEW PERSON file contains text in parentheses (), brackets [], or braces {}, that text is removed` `from the name, and the original name with the parenthetical text is recorded in this field.`

ICR, Total: 2

ICR LINK	Subscribing Package(s)	Fields Referenced	Description
ICR #3041	Registration Income Verification Match VistALink Security HealtheVet Desktop	FILE (.01). Access: Both R/W w/Fileman FIELD (.02). Access: Both R/W w/Fileman IENS (.03). Access: Both R/W w/Fileman FAMILY (LAST) NAME (1). Access: Both R/W w/Fileman GIVEN (FIRST) NAME (2). Access: Both R/W w/Fileman MIDDLE NAME (3). Access: Both R/W w/Fileman PREFIX (4). Access: Both R/W w/Fileman SUFFIX (5). Access: Both R/W w/Fileman DEGREE (6). Access: Both R/W w/Fileman SOURCE NAME FORMAT FLAGS (7). Access: Both R/W w/Fileman NOTES ABOUT NAME (11). Access: Both R/W w/Fileman
ICR #3640	M DATA EXTRACTOR

Name	Field # of Occurrence
EN^DDIOL	IDNAME+1
FILE^DIE	IXADEGSL+1, IXADEGKL+1, IXASIGSL+1
$$NAMEFMT^XLFNAME	IDNAME+1, IXASIGSL+1, IXCP8CC+1
UPDNAME^XLFNAME2	IXANAMESL+1
$$COMP^XUSESIG3	6+1
$$PATM^XUSESIG3	6+1

Name

Field # of Occurrence

EN^DDIOL

IDNAME+1

FILE^DIE

IXADEGSL+1, IXADEGKL+1, IXASIGSL+1

$$NAMEFMT^XLFNAME

IDNAME+1, IXASIGSL+1, IXCP8CC+1

UPDNAME^XLFNAME2

IXANAMESL+1

$$COMP^XUSESIG3

6+1

$$PATM^XUSESIG3

6+1

Name	Line Occurrences (* Changed, ! Killed)
^DIC(20.11 - [#20.11]	6+1
^VA(20 - [#20]	IXBBSL+1, IXBBKL+1!, IXBBKEIC+1!, IXCSL+1, IXCKL+1!, IXCKEIC+1!, .01(XREF 1S), .01(XREF 1K)

Name

Line Occurrences (* Changed, ! Killed)

^DIC(20.11 - [#20.11]

6+1

^VA(20 - [#20]

IXBBSL+1*, IXBBKL+1!, IXBBKEIC+1!, IXCSL+1*, IXCKL+1!, IXCKEIC+1!, .01(XREF 1S), .01(XREF 1K)

Name	Field # of Occurrence
^(1	IDNAME+1

Name

Field # of Occurrence

^(1

IDNAME+1

Local Variables

Legend:

>>	Not killed explicitly
*	Changed
!	Killed
~	Newed

Name	Field # of Occurrence
COMP	IXASIGSL+1~
COMP("FAMILY"	IXASIGSL+1*
COMP("GIVEN"	IXASIGSL+1*
COMP("MIDDLE"	IXASIGSL+1*
COMP("SUFFIX"	IXASIGSL+1*
>> DA	IXBBSL+1, IXBBKL+1, IXCSL+1, IXCKL+1, .01(XREF 1S), .01(XREF 1K)
DIERR	IXADEGSL+1~, IXADEGKL+1~, IXASIGSL+1~
FDA	IXADEGSL+1~, IXADEGKL+1~, IXASIGSL+1~
FDA(200	IXADEGSL+1, IXADEGKL+1, IXASIGSL+1*
I	6+1~*
MSG	IXADEGSL+1~, IXADEGKL+1~, IXASIGSL+1~
SIG	IXASIGSL+1~
U	IDNAME+1
X	IXCP8CC+1*, .01+1!, .01(XREF 1S), .01(XREF 1K), .02+1!, .03+1!, 1+1!, 2+1!, 3+1!, 4+1! , 5+1!, 6+1!, 7+1!, 11+1!
X(1	IXADEGSL+1, IXADEGKL+1, IXANAMESL+1, IXASIGSL+1, IXBBSL+1, IXBBKL+1, IXCP8CC+1
X(2	IXADEGSL+1, IXADEGKL+1, IXANAMESL+1, IXASIGSL+1, IXBBSL+1, IXBBKL+1, IXCP8CC+1
X(3	IXADEGSL+1, IXADEGKL+1, IXANAMESL+1, IXASIGSL+1, IXBBSL+1, IXBBKL+1, IXCP8CC+1
X(4	IXADEGSL+1, IXANAMESL+1, IXASIGSL+1, IXCP8CC+1
X(5	IXANAMESL+1, IXASIGSL+1, IXCSL+1, IXCKL+1
X(6	IXANAMESL+1, IXASIGSL+1
X(7	IXANAMESL+1, IXASIGSL+1
X(8	IXANAMESL+1
>> X2(4	IXADEGSL+1, IXADEGKL+1
XUCOMP	IXANAMESL+1~
XUCOMP("FAMILY"	IXANAMESL+1*
XUCOMP("GIVEN"	IXANAMESL+1*
XUCOMP("MIDDLE"	IXANAMESL+1*
XUCOMP("SUFFIX"	IXANAMESL+1*
XUN	IDNAME+1~, IXCP8CC+1~
XUN("FAMILY"	IDNAME+1, IXCP8CC+1
XUN("GIVEN"	IDNAME+1, IXCP8CC+1
XUN("MIDDLE"	IDNAME+1, IXCP8CC+1
XUN("SUFFIX"	IDNAME+1, IXCP8CC+1
XUNODEGT	IXADEGSL+1~, IXADEGKL+1~
XUNOSIGT	IXASIGSL+1~*
XUNOTRIG	IXANAMESL+1~*
Z	6+1~*

FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200
FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200
FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200
FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200
FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200
FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200
FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200
FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200
FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200
FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200
FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200
FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200	FILE: 200
FILE: 200	FILE: 200	FILE: 200	FILE: 200

Customize PDF page

Package: Kernel

Global: ^VA(20

Information

Description

Directly Accessed By Routines, Total: 20

Accessed By FileMan Db Calls, Total: 13

Pointed To By FileMan Files, Total: 2

Fields, Total: 11

Found Entries, Total: 100

ICR, Total: 2

External References

Global Variables Directly Accessed

Naked Globals

Local Variables

Legend: