Legacy Text Examples - Retrieval of Archived Nlets Data (RAND) (NLQ/NLR, NFQ/NFR)
Legacy (DEPRECATED)
Retrieval of Archived Nlets Data Legacy Specifications
This section describes the format and provides examples for queries (NLQ/NFQ) to the Nlets message log of traffic that travels through it and the corresponding responses (NLR/NFR).
Messages can be retrieved by message type, time range, originator, member, and by character string within a message.
All messages will be preceded by a standard input header.
All data elements are preceded by a prefix and terminated by a period with the exception of the last character of the message.
Query Formats
Query requirements for legacy messages are the same as noted above.
The table below shows the fields for an NLQ message.
Entry:
Size:
Explanation:
NLQ.
3
Message type for searching the RAND message
database.
Sender ORI
9
Sender ORI followed by a period.
Destination ORI
2
Must always be NL followed by a period.
TXT
3
Field prefix denoting beginning of message.
TYP/
4
Prefix to identify message types of interest.
Message Types
100
One or more message types, separated by commas
and optional spaces, ending with a period. A value of
ALL indicates searching all message types.
SRC/
4
Prefix to identify source member or ORI followed
by a period.
Source ORI or Member
2 or 9
Source of messages either in the form of a two
character member code or a full 9 character ORI
followed by a period.
DST/
4
Prefix to identify destination member or ORI
followed by a period.
Destination ORI or
Member
2 or 9
Destination of messages either in the form of a two
character member code or a full 9 character ORI
followed by a period.
BEG/
4
Prefix to identify the beginning date and optional time
for the query.
Beginning Date and
Optional Time
8 or 13
The beginning date and optional time for the query,
followed by period. The format is ccyymmdd or
ccyymmdd@hhmm.
END/
4
Prefix to identify the ending date and optional time for
the query.
Ending Date and
Optional Time
8 or 13
The ending date and optional time for the query,
followed by period. The format is ccyymmdd or
ccyymmdd@hhmm.
FND/
4
Prefix to identify the free text information needed.
Free Text
250
A character string containing text to search for. This
string need not be padded and will be stored with
leading and trailing spaces and carriage return-line
feed sequences removed. The string is terminated by
the end of message or by a period. Most characters in
this field represent themselves. The field can,
however, contain several characters with special
meanings: described in the text below.
An automated response from the Nlets system will be returned advising that the query (NLQ) was successfully received and placed in the queue for processing.
Once processing is complete, the response (NLR) will be returned.
- Output begins with stating the search string as received in the NLQ, followed by the search string the RAND service interpreted and processed.
- The next line will be either the number of results found (up to 100) or a message stating none were found, followed by an instruction for how to receive the original version of a message.
- A series of lines follow, each starting with a date/time and continuing with the sequence number of the message (used to retrieve the message via NFQ), the originator ORI, the message type, the destination ORI, and the first 80 characters of message data transformed from its original format to Legacy text format for easier human readability.
- There is a limit of 100 hits for a given NLR. If more than 100 hits are necessary, the time and date of the last hit can be used as the beginning date field of a subsequent NLQ query where all other fields are as they were in the original NLQ.
The NFQ transaction is based on the NLR message generated by an NLQ transaction.
- The standard Nlets message header and all of the fields listed in the table below are required to retrieve a full text message.
- The DAT field is optional.
Entry:
Size:
Explanation:
NFQ.
3
Message type for RAND full text retrieval followed by
period.
DAT/
8
Date of the transaction.
MSG/
51
9 to 51 digit message sequence number as shown in the
NLR message.
Retrieval of Archived Nlets Data Legacy Examples
Example 1: A RAND Message querying by free text.
NLQ.AZNLETS47.NL.*NLQ2NL0100.TXTTYP/RQ,RR.BEG/2021-01-01@0000.END/2021-12-31@2359.FND/CORVETTE OR 123ABC
Example 2: A response from RAND by free text.
NLR.NL0000000
14:30 09/08/2021 08966
14:30 09/08/2021 00054 AZNLETS47
*NLQ2ME0105
TXT
SEARCH STRING RECEIVED: CORVETTE OR 123ABC
SEARCH STRING PROCESSED: CORVETTE OR 123ABC
THE SEARCH PRODUCED 11 RESULTS.
TO RECEIVE THE ORIGINAL VERSION OF DETAIL MESSAGE, ADD 'X' TO THE END OF THE SEQUENCE NUMBER WHEN RUNNING THE FOLLOW-UP NFQ.
DATETIME SEQ ORIGORI MKE DESTORI CONTROL SAMPLE
20210907@0000 10111-001 NYDMVNY00 RR FL04900N9 0887899338 *** REGISTRATION DETAILS *** REGISTRATION ID: XXXXXXXXXXXXXXXXXXX VEHICLE REGISTRATIO
20210907@0000 10111-002 WIDOT0000 RR IL099143N MRI1238845 *** REGISTRATION DETAILS *** VEHICLE REGISTRATION EXPIRATION DATE: 2022-04-28 REGISTR
20210907@0000 10111-003 INBMV0000 RR IL04906M1 MRI0932624 *** REGISTRATION DETAILS *** REGISTRATION ID: XXXXXXXXX REGISTRATION AUTHORITY NAME:
20210907@0000 10111-004 GA0601501 RR AZNLETS90 CA0010400B Query Data: Plate: 123ABC Type: PC-Meritorious Service Medal Marine Corps Plate Numbe
20210907@0000 10111-005 GA0601501 RR FL0410000 0887857528 Query Data: VIN: XXXXXXXXXXXXX Plate Number: XXXXXXX Plate Type: A1 - Standard Altern
20210907@0000 10111-006 AZ007C100 RR VACBP8100 NN89532799 Query Data: Plate: XXXXXXX Type: PC Year: 2022 Plate Number: XXXXXXX Plate Type: Stan
20210907@0000 10111-007 NHMAAP000 RR MA0093588 RQ43405465 INQUIRY: LIC/XXXXXXX.LIT/PC NAM/CALLAHAN, HARRY DIRTY DOB/19300531 SEX/M PVS/ 2ND OWN
20210907@0000 10111-008 NHMAAP000 RR MA0090088 RQ75125005 INQUIRY: LIC/XXXXXXX.LIT/PC NAM/JOVONOVICH, JARDANI JOHN WICK DOB/19640902 SEX/M PVS/
20210907@0000 10111-009 OK00000VS RR NV00262E0 NV5049A3B9 OKLAHOMA TAX COMMISSION RESPONSE FOR LIC/ABC123 *** REGISTRATION INFO *** Primary Pla
20210907@0000 10111-010 IL04906M1 RQ IN MRI0932624 LIC/123ABC.LIY/2022.LIT/PC.
20210907@0000 10111-011 AZNLETS90 RQ GA CA0010400B LIC/123ABC.LIY/2022.LIT/PC.
Example 3: A RAND Message querying by name.
NLQ.AZNLETS47.NL.*NLQ2NL0002.TXTTYP/AM,CR,RQ,RR.BEG/2021-01-01@0000.END/2021-12-31@2359.NAM/MERIDIUS, MAXIMUS DECIMUS
Example 4: A response from RAND by name.
NLR.NL0000000
14:30 09/08/2021 08968
14:30 09/08/2021 00056 AZNLETS47
*NLQ2ME0106
TXT
SEARCH STRING RECEIVED: MERIDIUS, MAXIMUS DECIMUS
SEARCH STRING PROCESSED: MERIDIUS NEAR MAXIMUS NEAR DECIMUS
THE SEARCH PRODUCED 5 RESULTS.
TO RECEIVE THE ORIGINAL VERSION OF DETAIL MESSAGE, ADD 'X' TO THE END OF THE SEQUENCE NUMBER WHEN RUNNING THE FOLLOW-UP NFQ.
DATETIME SEQ ORIGORI MKE DESTORI CONTROL SAMPLE
20210801@0000 10109-001 INTGTST01 AM INTGTST02 AMINTTEST1 THIS IS A TEST MESSAGE ABOUT GLADIATOR MAXIMUS DECIMUS MERIDIUS LAST SEEN DESTROYING
20210801@0000 10109-002 INTGTST01 AM INTGTST02 AMINTTEST2 THIS IS A TEST MESSAGE ABOUT GLADIATOR MAXIMUS DECIMUS MERIDIUS FIGHTING WILD BEASTS
20210801@0000 10109-003 INTGTST01 AM INTGTST02 AMINTTEST3 THIS IS A TEST MESSAGE ABOUT GLADIATOR MAXIMUS DECIMUS MERIDIUS LAST SEEN ENGAGED IN
20210801@0000 10109-004 INTGTST01 CR INTGTST02 CRINTTEST4 CRIMINAL HISTORY TRANSACTION DATA REDACTED.
20210907@0000 10110-005 GA0601501 RR FL0410000 0887857528 Query Data: VIN: XXXXXXXXXXXXX Plate Number: XXXXXXX Plate Type: A1 - Standard Altern
Example 5: A RAND message by sequence number to retrieve the default human readable TEXT format of the message.
NFQ.AZNLETS47.NL.*NFQ2NL0100.TXTMSG/10109-005
Example 6: A response from RAND by sequence number with the default human readable TEXT format of the message.
NFR.NL0000000
14:33 09/08/2021 08970
14:33 09/08/2021 00058 AZNLETS47
*NFQ2ME0103
TXT
MESSAGE TYPE: RR
SOURCE ORI: GA0601501
DESTINATION ORI: FL0410000
CONTROL FIELD: 0887857528
RECEIVED: 09/07/2021 AT 12:00
MESSAGE SENT:
Query Data:
VIN: XXXXXXXXXXXXX
Plate Number: XXXXXXX
Plate Type: A1 - Standard Alternate
Permanent Registration: true
Registration Authority: 1550 Schley - N. Pecan
Effective Date: 2021-08-20
Expiration Date: 2021-08-31
State: GA
Status: Plate Transferred
Registered Party: MAXIMUS DECIMUS MERIDIUS
Address: 123 COLOSSEUM WAY ATLANTA, GA 318065466
FULTON
USA
DOB: 2000-09-01
Driver License: XXXXXXXXX
VIN: XXXXXXXXXXXXX
Make: CHEV
Make: Chevrolet
Model: CORVETTE
Year: 1972
Style: 2S
Color (Primary): WHITE
CMV: false
Commercial Vehicle Data:
Insurance Carrier: State Farm Mutual Automobile Insurance Company
Insurance Policy ID: XXXXXXXX
Insurance Effective: 2021-08-12
Additional State Information:
Field Name: Notes
Field Value: This plate was transferred in the last 30 days.
Field Name: InsuranceStatus
Field Value: VALID INSURANCE COVERAGE
Field Name: Reference ID
Field Value: XXXXXXXXXXXX
Example 7: A RAND message by sequence number to retrieve the original XML format of the message.
NFQ.AZNLETS47.NL.*NFQ2NL0101.TXTMSG/10107-005X
Example 8: A response from RAND by sequence number with the original XML format of the message.
NFR.NL0000000 14:34 09/08/2021 08971 14:34 09/08/2021 00059 AZNLETS47 *NFQ2ME0104 TXT
<?xml version="1.0" encoding="UTF-8"?>
<n2:NLETS xmlns:n2="http://www.nlets.org/niem/1.0"
n2:version="4.00">
<n2:NLETSMessageHeader xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0">
<nh2:MessageKeyCodeText>RR</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>GA0601501</nh2:OriginatingORIID>
<nh2:DestinationORIID>FL0410000</nh2:DestinationORIID>
<nh2:DocumentControlFieldText>
<![CDATA[0887857528]]></nh2:DocumentControlFieldText>
</n2:NLETSMessageHeader>
<n2:NLETSInquiryData n2:key="RQ">
<nc2:Vehicle xmlns:nc2="http://www.nlets.org/niem/nlets-core/1.0">
<nc:VehicleIdentification xmlns:nc="http://niem.gov/niem/niem-core/2.0">
<nc:IdentificationID>XXXXXXXXXXXXX</nc:IdentificationID>
</nc:VehicleIdentification>
<nc:ConveyanceRegistration xmlns:nc="http://niem.gov/niem/niem-core/2.0">
<nc:ConveyanceRegistrationPlateIdentification/>
</nc:ConveyanceRegistration>
</nc2:Vehicle>
</n2:NLETSInquiryData>
<n2:NLETSResponseData n2:key="RR">
<nrs2:RegistrationStatus xmlns:nrs2="http://www.nlets.org/niem/nlets-registration-status/1.0">
<nrs2:StandardResponse>
<nc2:Vehicle xmlns:nc2="http://www.nlets.org/niem/nlets-core/1.0">
<nc:VehicleCMVIndicator xmlns:nc="http://niem.gov/niem/niem-core/2.0">false</nc:VehicleCMVIndicator>
<nc:VehicleIdentification xmlns:nc="http://niem.gov/niem/niem-core/2.0">
<nc:IdentificationID>XXXXXXXXXXXXX</nc:IdentificationID>
</nc:VehicleIdentification>
<nc:VehicleMakeCode xmlns:nc="http://niem.gov/niem/niem-core/2.0">CHEV</nc:VehicleMakeCode>
<nc:ItemMakeName xmlns:nc="http://niem.gov/niem/niem-core/2.0">Chevrolet</nc:ItemMakeName>
<nc:ItemModelName xmlns:nc="http://niem.gov/niem/niem-core/2.0">CORVETTE</nc:ItemModelName>
<nc:ItemModelYearDate xmlns:nc="http://niem.gov/niem/niem-core/2.0">1972</nc:ItemModelYearDate>
<nc:PropertyStyleText xmlns:nc="http://niem.gov/niem/niem-core/2.0">2S</nc:PropertyStyleText>
<nc:ConveyanceColorPrimaryText xmlns:nc="http://niem.gov/niem/niem-core/2.0">WHITE</nc:ConveyanceColorPrimaryText>
<nc:ConveyanceRegistration xmlns:nc="http://niem.gov/niem/niem-core/2.0">
<nc2:RegistrationHolder>
<nc2:Person>
<nc:PersonBirthDate>
<nc:Date>2000-09-01</nc:Date>
</nc:PersonBirthDate>
<nc:PersonName>
<nc:PersonGivenName>MAXIMUS</nc:PersonGivenName>
<nc:PersonMiddleName>DECIMUS</nc:PersonMiddleName>
<nc:PersonSurName>MERIDIUS</nc:PersonSurName>
</nc:PersonName>
<nc2:PersonResidentialAddress>
<nc:LocationStreet>
<nc:StreetFullText>123 COLOSSEUM WAY</nc:StreetFullText>
</nc:LocationStreet>
<nc:LocationCityName>ATLANTA</nc:LocationCityName>
<nc:LocationCountyName>FULTON</nc:LocationCountyName>
<nc:LocationStateName>GA</nc:LocationStateName>
<nc:LocationCountryName>USA</nc:LocationCountryName>
<nc:LocationPostalCode>318065466</nc:LocationPostalCode>
</nc2:PersonResidentialAddress>
<nc:DriverLicense>
<nc:DriverLicenseIdentification>
<nc:IdentificationID>XXXXXXXXX</nc:IdentificationID>
</nc:DriverLicenseIdentification>
</nc:DriverLicense>
</nc2:Person>
</nc2:RegistrationHolder>
<nc:RegistrationAuthorityName>1550 Schley - N. Pecan</nc:RegistrationAuthorityName>
<nc:DealerName>-</nc:DealerName>
<nc:RegistrationEffectiveDate>
<nc:Date>2021-08-20</nc:Date>
</nc:RegistrationEffectiveDate>
<nc:RegistrationExpirationDate>
<nc:Date>2021-08-31</nc:Date>
</nc:RegistrationExpirationDate>
<nc:RegistrationJurisdictionNCICLISCode>GA</nc:RegistrationJurisdictionNCICLISCode>
<nc:ConveyanceRegistrationPermanentIndicator>true</nc:ConveyanceRegistrationPermanentIndicator>
<nc:ConveyanceRegistrationPlateIdentification>
<nc:IdentificationID>XXXXXXX</nc:IdentificationID>
</nc:ConveyanceRegistrationPlateIdentification>
<nc:ConveyanceRegistrationPlateCategoryText>A1 - Standard Alternate</nc:ConveyanceRegistrationPlateCategoryText>
<nc:RegistrationStatus>
<nc:StatusText>Plate Transferred</nc:StatusText>
</nc:RegistrationStatus>
</nc:ConveyanceRegistration>
<nc:CommercialVehicle xmlns:nc="http://niem.gov/niem/niem-core/2.0"/>
<nc:Insurance xmlns:nc="http://niem.gov/niem/niem-core/2.0">
<nc:InsurancePolicyIdentification>
<nc:IdentificationID>XXXXXXXX</nc:IdentificationID>
</nc:InsurancePolicyIdentification>
<nc:InsuranceCarrierName>State Farm Mutual Automobile Insurance Company</nc:InsuranceCarrierName>
<nc:InsuranceEffectiveDate>
<nc:Date>2021-08-12</nc:Date>
</nc:InsuranceEffectiveDate>
</nc:Insurance>
</nc2:Vehicle>
</nrs2:StandardResponse>
<nc2:AdditionalInformation xmlns:nc2="http://www.nlets.org/niem/nlets-core/1.0">
<nc2:StateElement>
<nc2:ElementFieldName>Notes</nc2:ElementFieldName>
<nc2:ElementFieldValue>This plate was transferred in the last 30 days.</nc2:ElementFieldValue>
</nc2:StateElement>
<nc2:StateElement>
<nc2:ElementFieldName>InsuranceStatus</nc2:ElementFieldName>
<nc2:ElementFieldValue>VALID INSURANCE COVERAGE</nc2:ElementFieldValue>
</nc2:StateElement>
<nc2:StateElement>
<nc2:ElementFieldName>Reference ID</nc2:ElementFieldName>
<nc2:ElementFieldValue>XXXXXXXXXXXX</nc2:ElementFieldValue>
</nc2:StateElement>
</nc2:AdditionalInformation>
</nrs2:RegistrationStatus>
</n2:NLETSResponseData>
</n2:NLETS>