Kernel APIs: $$PROVIDER^XUSER

$$PROVIDER^XUSER(): Providers in New Person File

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

Description

This extrinsic function was requested to be added by the Computerized Patient Record System (CPRS) Development Team. It is used to indicate any provider in the NEW PERSON file (#200). The definition of a provider is any entry in the NEW PERSON file (#200) that doesn't have a termination date. Additional parameters may be added in the future in order to perform other tests/checks.

Format

  $$PROVIDER^XUSER(ien)

Input Parameters

ien:

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

Output

OUTPUT

Returns any of the following codes:

1—Provider has a record and no termination date.
0^TERMINATED^FMDATE—Provider terminated on date indicated.
""—Null, no provider record found.

Example 1

This is an example of an Active Provider in the NEW PERSON file (#200):

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

>WRITE X
1

Example 2

This is an example of a Terminated Provider in the NEW PERSON file (#200):

>S X=$$PROVIDER^XUSER(957)

>W X
0^TERMINATED^2980504

Example 3

This is an example of a Provider with no record in the NEW PERSON file (#200), returns a null string:

>S X=$$PROVIDER^XUSER(999999999)

>W X

>

VA (Internet) / VA (Intranet) / OI / HSD&D / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: December 14, 2005

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.