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

$$DEA^XUSER(): Get DEA Number

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

Description

This extrinsic function returns a user's Drug Enforcement Agency (DEA) number, if it exists in the DEA# field (#53.2) of the NEW PERSON file (#200). If the DEA# field value is null, the value returned depends on the optional FLAG input parameter (see Input Parameters).

NOTE:Fee Basis and C&A providers only return DEA# or NULL

NOTE:This API was originally requested as part of the Public Key Infrastructure (PKI) Project. This API was updated with Kernel Patch XU*8.0*580, which was created in support of the Drug Enforcement Agency (DEA) e-Prescribing of Controlled Substances (ePCS) Utility. This utility uses Public Key Infrastructure (PKI) and meets the requirements proposed by the DEA Interim Final Rule (IFR) for Electronic Prescriptions for Controlled Substances effective as of June 1,2010.

Format

  $$DEA^XUSER([flag],ien) 

Input Parameters

flag:

(optional) This flag controls what is returned when the user does not have a value in the DEA# field (#53.2) of the NEW PERSON file (#200).

  • NULL or 0—This routine will check to see if the user has values in the VA# field (#53.3) of the NEW PERSON file (#200) and the (new) FACILITY DEA NUMBER field (#52) of the INSTITUTION file (#4). If values are found in both of those fields, this routine will return the following:
    FACILITY DEA NUMBER (#52) field_"-"_VA# (#53.3) field
  • 1—This routine will check to see if the user has a value in the VA# field (#53.3) of the NEW PERSON file (#200). If a value is found in that field, this routine will return that field value. Otherwise, this routine returns an empty string.

ien:

This is the NEW PERSON (#200) file IEN for the entry to be checked.

Output

returns:

Returns the DEA# field (#53.2) value or the value returned based on the (optional) flag input parameter.

Example 1

The following are the data values for this example:

If the FLAG input parameter is null or "0", this API would return "AB1234567,"

If the FLAG input parameter is "1", this API would return "AB1234567,"

Example 2

The following are the data values for this example:

If the FLAG input parameter is NULL or "0", this API would return "VA7654321-789":

If the FLAG input parameter is "1", this API would return "789":

Example 3

The following are the data values for this example:

If the FLAG input parameter is NULL or "0", this API would return "":

If the FLAG input parameter is "1", this API would return "":

In both cases, it returns an empty string.

Example 4

The following are the data values for this example:

If the FLAG input parameter is NULL or "0", this API would return "":

If the FLAG input parameter is "1", this API would return "":

In both cases, it returns an empty string.

 


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

Reviewed/Updated: April 19, 2018

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.