Legacy Text Examples - National Drug Pointer Index System (DEX/DEA, DUX/DUA, DRX/DRR)
National Drug Pointer Index System Legacy Specifications
This section describes the format and provides examples for queries to and responses from the National Drug Pointer Index System (NDPIX) which is an information sharing system for Law Enforcement Agencies (LEAs).
NDPIX messages are identified by a transaction type that follows Nlets standards. All messages addressed to NDPIX must be sent to ORI "VADEADX00".
Note: NDPIX has a test file and a production or live file.
- When an agency is testing, use the test ORI "VADEADX88".
- When an agency initiates participation with actual data, use the production ORI "VADEADX00".
There is additional information on this test system in a kit provided by DEA.
NDPIX messages conform to Nlets message format conventions and consist of two parts: (1) the standard Nlets message header and (2) the formatted entry.
The formatted entry is made up of mandatory and optional data elements. The mandatory elements are italicized in the table below (and with the exception of Control Field and TXT, they are the first 11 entry types in the table).
Entry
# Char.
Explanation
Message Type
4
A 3 character message type followed by a period.
Sending ORI
9
Sending ORI followed by a period (Found in Message Header).
Destination ORI
9
Destination ORI followed by a period (Found in Message Header).
*
1
Asterisk to identify the start of the control field (omit if no control field present).
Control Field
10
Optional Control field followed by a period.
TXT
3
Identifies beginning of text of message.
UID/
4
Prefix to identify User ID field.
User ID
8
User ID number followed by a period.
PWD/
4
Prefix to identify password.
Password
8
Password followed by a period.
OCA/
4
Prefix to identify case number.
Case Number
Variable
Case number followed by a period.
POC/
4
Prefix to identify Point of Contact.
Point of Contact
Variable
Name (last, first MI) followed by a period.
PTL/
4
Prefix to identify Title of Contact.
POCOrganization
Variable
Name of Law Enforcement Agency.
PPN/
4
Prefix to identify phone number of Contact.
Phone number
10
Phone number of contact followed by a period.
NAM/
4
Prefix to identify target's name. May be multiple occurrences.
Name
Variable
Target's name (last name, first name MI) followed by a period. May be multiple occurrences. Inclusion of either AKA or MON will satisfy this mandatory requirement but all three are allowed.
SEX/
4
Prefix to identify sex of subject.
Sex
1
Code followed by period. M or F only, Unknown not valid.
AKA/
4
Prefix to identify Alias name. May be multiple occurrences.
Alias name
Variable
Target's alias (last name, first name MI) followed by a period. May be multiple occurrences.
MON/
4
Prefix to identify targets moniker. May be multiple occurrences.
Moniker
Variable
Target's moniker followed by a period. May be multiple occurrences.
RAC/
4
Prefix to identify race field.
Race
1
Race field followed by a period. Must be one of the following:
I = American Indian or Alaskan native
A = Asian or Pacific Islander
B = Black
W = White
U = Unknown
DOB/
4
Prefix to identify data of birth.
Date of Birth
8 (or 2 if Age)
Entered as CCYYMMDD. If entered as estimated age, NDPIX converts entry to DOB using system date as base. Must be >16, <100 years. Multiple occurrences allowed.
FOR/
4
Prefix to identify the name of the person for whom this record is requested.
For
Variable
Person who authorized or requested entry of the transaction.
HGT/
4
Prefix to identify height.
Height
3
Height is entered as 3 digits followed by a period. The entry 5'9" is entered HGT/509. Range is 3' to 9'.
WGT/
4
Prefix to identify weight.
Weight
3
Entered as 3 digits, zero suppressed followed by a period. E.g., 98 lbs. entered as WGT/98.
EYE/
4
Prefix to identify eye color.
Eye
3
Eye color code followed by a period
BLK = Black HAZ = Hazel
BLU = Blue MAR = Maroon
BRO = Brown PNK = Pink
GRE = Green MUL = Multicolored
GRY = Gray Unknown leave blank
HAI/
4
Prefix to identify hair color.
Hair color
3
Hair color code followed by a period.
BLK = Black RED = Red
BLN = Blonde SDY = Sandy
BRO = Brown WHI = White
GRY = Gray or partly gray Unknown leave blank.
SMT/
4
Prefix to identify scars, marks and tattoos.
Scars, marks and tattoos
3-10
Scars, marks and tattoos followed by a period. Multiple occurrences allowed.
NOTE: For each of multiple addresses, enter ADR, CIT, STE and ZIP in sequence.
ADR/
4
Prefix to identify address of subject.
Address (Street)
Variable
Address of subject followed by a period. Multiple occurrences allowed.
CIT/
4
Prefix to identify city.
City
Variable
City of subject followed by a period. Multiple occurrences allowed.
STE/
4
Prefix to identify State.
State
2
State of subject followed by a period. Multiple occurrences allowed.
ZIP/
4
Prefix to identify ZIP code.
ZIP code
5 or 9
ZIP code followed by a period. Multiple occurrences allowed.
TEL/
4
Prefix to identify telephone number.
Telephone number
10
Telephone number of subject followed by a period. Multiple occurrences allowed.
SCN/
4
Prefix to identify cellular number.
Cellular number
10
Cellular number followed by a period. Multiple occurrences allowed.
PAG/
4
Prefix to identify pager number.
Pager number
10
Pager number followed by a period. Multiple occurrences allowed.
TYP/
4
Prefix to identify type of drug.
Type of Drug
4
Valid "type of drug" codes are listed in the Code Manual of the NCIC, Section 3, Offense Codes = DANGEROUS DRUGS. Multiple occurrences allowed.
DAL/
4
Prefix to identify location-drug activity.
Drug activity location
2
Location (State or Country) of drug activity followed by a period. Multiple occurrences allowed.
ADF/
4
Prefix to identify caution field.
Caution indicator
1
Code (y) to indicate armed or dangerous followed by a period.
FBI/
4
Prefix to identify FBI number.
FBI Number
9
FBI number followed by a period.
SOC/
4
Prefix to identify social security #.
SOC
9
SOC followed by a period.
LIC/
4
Prefix to identify license number of subject.
License #
1-8
Tag number(s) of subject's vehicle followed by a period. Multiple occurrences allowed.
LIS/
4
Prefix to identify license state of subject.
License state
2
State of registration of subject vehicle followed by a period. Multiple occurrences allowed.
BHN/
4
Prefix to identify vessels number or name.
Vessel number or name
Variable
Vessel number or name followed by a period. Multiple occurrences allowed.
RES/
4
Prefix to identify vessel registration state.
Reg. state
2
Vessel registration state. Multiple occurrences allowed.
ACN/
4
Prefix to identify aircraft number.
Aircraft number
8
Aircraft number followed by a period.
TOC/
4
Prefix to identify type of case.
Type of case
1
For future use, to identify type of case.
RTE/
4
Prefix to identify router field.
Router
Variable
Secondary address (used by state agency if state is using a common ORI for its law enforcement agencies).
Formats are described in the sections that follow for the four message types (DEX, DUX and DRX) and the resulting responses (DEA, DUA and DRR)
Entry Formats
Prepare the message header with the DEX message type and provide at least the mandatory data elements.
Responses to a New Entry
When an entry is made to NDPIX, the system performs two primary functions.
- It enters the data onto the file
- It searches the existing file for similar subjects and DOBs.
Note: All responses (DEA) may have a message appended indicating "ARMED AND DANGEROUS" This has been included for officer safety.
NDPIX sends a response for every transaction as follows:
- Point of Contact (POC) for those transactions matching records in the database.
- Acknowledgments for valid transactions which had no matches
- Error message on rejected transactions.
NDPIX assigns a unique number (NDP/) to each valid transaction which record owner would use in any future updating of the record.
Note: When an entry is successfully processed a renewal date is returned with the "entry acknowledgment" message.
Error Response Messages
If the transaction contained data errors, the record would be rejected and an error message sent to the entry maker.
Typical data errors and the appropriate response would include:
- One or more elements missing.
- Alphabetic characters in DOB field, for example.
- The key word OCA was not followed by data.
Note: NDPIX returns the entire input transaction with the error message but replaces the password (PWD) with all X's.
Message to Update an Earlier Entry
Prepare the message header with the DUX message type and enter the following data elements:
- User ID
- Password
- NDPIX number
- Name of Target (Alias or Moniker)
- All data elements to be changed
Users may update any field in a record except the NDPIX Number (NDP/) and the entering ORI.
Responses to Updating a Record
NDPIX returns a response (DUA) for every entry either in the form of "Update Accepted" indicating no matches or match information for accepted records or error messages on rejected input entries. The ORI is found only in the Header portion of the message.
This renews the record for 180 days. The purge date is recalculated to occur 180 days from the date of the update.
Message to Renew an Earlier Entry
NDPIX purges records after they have been in the database for 180 days from the Date of Record unless renewed or updated. To renew the record, the record owner submits a DRX transaction type.
Prepare the message header with the DRX message type and enter the following data elements:
- User ID
- Password
- Name of Target (Alias or Moniker)
- NDPIX Number of the record to be renewed.
Responses to Renewal Messages
NDPIX returns a response (DRR) for every entry either in the form of "Renewal Accepted" with match notification for accepted records or error messages on rejected input entries. This renews the record for 180 days.
Notifications on Record Purges
NDPIX holds entries in its database for 180 days after which they are purged. These messages use the DRR message key.
To Request NDPIX Reports
NDPIX offers supplemental information to its participants. Participants may request copies of all records for which he/she is the originator.
Those requested via contact with DEA's Intelligence Division and satisfied via U.S. mails (off-line requests). To receive a copy of all the records originating from an ORI, the requestor enters an ORI to signify to NDIPIX that the request is ORI based. The requestor has the option to enter Case Number in order to minimize record output.
National Drug Pointer Index System Legacy Examples
Example 1: A query to enter data into the NDPIX System.
DEX.AZNLETS20.VADEADX00.TXT
UID/XXX11111.PWD/XXXXXXXX.OCA/201001AA111111111.ORG/AZNLETS20.
POC/NLETS_ANALYST.PTL/NLETS.PPN/8005284020.NAM/SMITH, JOHN.
DOB/19500101.SEX/M.RTE/00:111111
Example 2: A response to enter data into the NDPIX Record System.
DEA.VADEADX00
05:00 01/01/2011 41238
05:00 01/01/2011 41231 AZNLETS20
TXT
RTE/*1111111111.NDP/111111.NAM/SMITH, JOHN.
DLR/20120101.OCA/00-111.
POC/NLETS_ANALYST.
PTL/NLETS.
PPN/8005284020.MSG/20-ENTRY ACCEPTED-NO MATCHES.
Example 3: A query to modify a record in the NDPIX System.
DUX.AZNLETS20.VADEADX00.TXT
NDP/111111.UID/AAA11111.PWD/XXXXXXXX.OCA/00-111.
POC/NLETS_ANALYST.PTL/NLETS.PPN/8005284020.NAM/SMITH, JOHN.SEX/M.SOC/123456789.RAC/W.
DOB/19500101.ADR/1234 ANY ST.CIT/PHOENIX.STE/FL.ZIP/85000.
SSN/123456789.TOC/M
Example 4: A response to modify a record in the NDPIX System.
DUA.VADEADX00
06:00 01/01/2011 51238
06:00 01/01/2011 61232 AZNLETS20
TXT
RTE/*1111111111.NDP/111111.NAM/SMITH, JOHN.
DLR/20120101.OCA/00-111.POC/NLETS_ANALYST.
PTL/NLETS.
PPN/8005284020.MSG/30-UPDATE ACCEPTED-NO MATCHES.
Example 5: A response to request a NDPIX Record.
DTR.VADEADX00
22:00 01/01/2011 31238
22:00 01/01/2011 41238 AZNLETS20
TXT
NDP/111111.NAM/SMITH, JOHN.DLR/20110101.OCA/CSII-11111111.
MSG/60-RECORD TO BE PURGED IN 15 DAYS NDP-111111.
MSG/************************************************.
MSG/* "D O N O T D I S C A R D" *.
MSG/************************************************.
MSG/ "IMPORTANT NOTIFICATION - ACTION REQUIRED" *.
MSG/* POC: WATCH CENTER STAFF, *.
MSG/* THIS RECORD WILL BE DELETED FROM NDPIX UNLESS *.
MSG/* TIMELY RENEWAL OR UPDATE IS PERFORMED *.
MSG/* DATE OF THIS NOTIFICATION: January 01, 2011 *.
MSG/*************************************************