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

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

Reference Type: Supported, Category: User, ICR#: 2343

Description

The $$PROVIDER^XUSER extrinsic function is used to indicate any provider in the NEW PERSON (#200) file. The definition of a provider is any entry in the NEW PERSON (#200) file that does not have a termination date.

NOTE: This API was requested to be added by the Computerized Patient Record System (CPRS) Development Team.

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 (#200) file.

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.

Examples

Example 1

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

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

>WRITE X
1

Example 2

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

>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 (#200) file, returns a NULL string:

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

>W X

>