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

$$DETOX^XUSER(): Get Detox/Maintenance ID Number

Reference Type: Supported, Category: User: DEA ePCS Utility, ICR#: 2343

Description

The $$DETOX^XUSER extrinsic function obtains the value stored in the DETOX/MAINTENANCE ID NUMBER (#53.11) field in the NEW PERSON (#200) file. It returns one of the following:

NOTE: This API was released 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

  $$DETOX^XUSER(ien)

Input Parameters

ien:

(required) The IEN of the user in NEW PERSON (#200) file.

Output

returns:

Returns: one of the following:

  • User's DETOX/MAINTENANCE ID number—If valid.

  • NULL—DETOX/MAINTENANCE ID number is NULL or the DEA EXPERATION DATE (#747.44) field in the NEW PERSON (#200) file is unpopulated.

  • DEA EXPIRATION DATE (#747.44)—When the DETOX/MAINTENANCE ID number is valid but the DEA EXPIRATION DATE has expired.