Kernel 8.0 APIs Banner [skip navigation]
Office of Information & Technology (OIT) Banner

$$NAME^XUSER(): Get Name of User

Reference Type: Supported, Category: User, Integration Agreement: 2343

Description

This extrinsic function returns the full name of the specified user in a mixed case displayable format. The user's given name (i.e., First Last) is returned unless a second parameter of "F" is passed in to get the Family name (i.e., Last,First).

Format

  $$NAME^XUSER(ien[,format])

Input Parameters

ien:

(required) Internal Entry Number (IEN) of the provider to be checked in the NEW PERSON file (#200).

format:

(optional) This parameter indicates if the user's name should be returned formatted by Family or Given name, respectively. Possible values are:

  • F—Family (e.g., "Doe,John").

  • G (default)—Given (e.g., "John Doe").

Output

returns:

Returns user's family or given name.

Example 1

Retrieving the user name in Given format:

>S X=$$NAME^XUSER(1529)

>W X
Thomas E. Blue

Example 2

Retrieving the user name in Family format:

>S X=$$NAME^XUSER(1529,"F")

>W X
Blue,Thomas E.

 


VA (Internet) / VA(Intranet) / OI / PD / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: August 26, 2011

If you have questions, need more information, or are having accessibility problems with this website, please contact us by E-Mail: Webmasters, Phone: 510-768-6800, or FAX: 510-768-6850.