NIEM Examples - Hazardous Material File (MQ/MR)
NIEM
Hazardous Materials NIEM Specifications
This section provides NIEM format and examples for a hazardous material file inquiry and response (MQ/MR).
Inquiries must be sent to the Destination "NL". The inquiry can be made on a four (4) digit internationally recognized code called a "UN number". This number, normally found on a placard on the vehicle, will relate directly to the hazardous material therein.
The response will indicate a variety of information including:
- chemical name
- personal safety precautions
- general handling procedures
- disposal methods
- degree of hazard to public health
- availability of countermeasure materials.
The National Response Center is staffed 24/7/365 by qualified people who can assist you with hazardous materials. Each guide delivered by Nlets will refer to the National Response Center which can be reached by calling 800-424-8802.
All Nlets NIEM messages must be based on the Nlets NIEM Message Structure and include the standard Nlets XML Header as detailed in Message Structure. The NIEM header and hierarchy of the elements in this section have been omitted to avoid redundancy. The associated schemas and instances should be consulted to determine the correct XPaths of the elements.
Note: Queries by rail car ID are currently not supported.
Element Dictionary
Transaction types detailed below include: Query by United Nations Number (MQ), Query by Chemical Name (MQ) and Response Messages (MR)
Query Formats
Query by UN Number (MQ)
n2:NLETSInquiryData
This element will contain all elements specific to this transaction.
n2-mr:ChemicalInquiry
This element will encapsulate the inquiry information about a chemical.
nc:Chemical
This element will include chemical information.
j5:HazardousMaterialCode
A hazardous material.
This element will contain the United Nations Number, also called a material code number or UNN of the chemical being queried.
Query by Chemical Name (MQ)
n2:NLETSInquiryData
This element will contain all elements specific to this transaction.
n2-mr:ChemicalInquiry
This element will encapsulate the inquiry information about a chemical.
nc:Chemical
This element will include chemical information.
n2-mr:ChemicalNameText
This element will contain the chemical name to be queried.
Response Formats
Response Messages (MR)
n2:NLETSResponseData
n2:ResponseText
This element will contain the free text response. Nlets recommends the use of a CDATA section
to ensure that the response does not contain any characters illegal in XML.
Hazardous Materials NIEM Examples
Example 1: Hazardous Material query by United Nations Number.
<n2:NLETS xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0"
n2:version="4.00"
xmlns:nc="http://niem.gov/niem/niem-core/2.0"
xmlns:n2="http://www.nlets.org/niem/1.0">
<n2:NLETSMessageHeader>
<nh2:MessageKeyCodeText>MQ</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>AZNLETS20</nh2:OriginatingORIID>
<nh2:DestinationORIID>NL</nh2:DestinationORIID>
</n2:NLETSMessageHeader>
<n2:NLETSInquiryData n2:key="MQ">
<n2-mr:ChemicalInquiry xmlns:n2-mr="http://www.nlets.org/niem/nlets-hazardous-materials/1.0">
<nc:Chemical xmlns:nc="http://release.niem.gov/niem/niem-core/3.0/">
<n2-mr:ChemicalNameText>1236</n2-mr:ChemicalNameText>
</nc:Chemical>
</n2-mr:ChemicalInquiry>
</n2:NLETSInquiryData>
</n2:NLETS>
Example 2: Hazardous Material response based on United Nations Number.
<n2:NLETS xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0" n2:version="4.00" xmlns:j52="http://release.niem.gov/niem/domains/jxdm/5.2/" xmlns:n2-mr="http://www.nlets.org/niem/nlets-hazardous-materials/1.0" xmlns:nc3="http://release.niem.gov/niem/niem-core/3.0/" xmlns:n2="http://www.nlets.org/niem/1.0">
<n2:NLETSMessageHeader>
<nh2:MessageKeyCodeText>MR</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>NL0000000</nh2:OriginatingORIID>
<nh2:DestinationORIID>AZNLETS20</nh2:DestinationORIID>
<nh2:DocumentControlFieldText><![CDATA[1234567890]]></nh2:DocumentControlFieldText>
<nh2:MessageReceiveDate>06/23/2019</nh2:MessageReceiveDate>
<nh2:MessageReceiveTime>06:39</nh2:MessageReceiveTime>
<nh2:MessageSendDate>06/23/2019</nh2:MessageSendDate>
<nh2:MessageSendTime>06:39</nh2:MessageSendTime>
<nh2:ReceiveMessageNumeric>00000</nh2:ReceiveMessageNumeric>
<nh2:SendMessageNumeric>00002</nh2:SendMessageNumeric>
</n2:NLETSMessageHeader>
<n2:NLETSInquiryData n2:key="MQ">
<n2-mr:ChemicalInquiry>
<nc3:Chemical>
<j52:HazardousMaterialCode>1268</j52:HazardousMaterialCode>
</nc3:Chemical>
</n2-mr:ChemicalInquiry>
</n2:NLETSInquiryData>
<n2:NLETSResponseData n2:key="MR">
<n2-mr:ChemicalInformation>
<nc3:Chemical>
<j52:HazardousMaterialCode>UN1268</j52:HazardousMaterialCode>
<n2-mr:ChemicalNameText>PETROLEUM DISTILLATES, N.O.S.</n2-mr:ChemicalNameText>
<n2-mr:ChemicalNameText>PETROLEUM PRODUCTS, N.O.S.</n2-mr:ChemicalNameText>
<n2-mr:SubstanceAugmentation>
<n2-mr:ChemicalGuideText><![CDATA[
============================= REPORTING HAZARDS =============================
REPORT SPILLS TO THE NATIONAL RESPONSE CENTER: 800-424-8802 HOURS: 24/7
============================= REPORTING HAZARDS =============================
=============================== CHEMICAL NAMES ==============================
UN# 1268 CHEM NAME: PETROLEUM DISTILLATES, N.O.S.
UN# 1268 CHEM NAME: PETROLEUM PRODUCTS, N.O.S.
============================= POTENTIAL HAZARDS =============================
FIRE OR EXPLOSION:
HIGHLY FLAMMABLE: WILL BE EASILY IGNITED BY HEAT, SPARKS OR FLAMES.
VAPORS MAY FORM EXPLOSIVE MIXTURES WITH AIR.
VAPORS MAY TRAVEL TO SOURCE OF IGNITION AND FLASH BACK.
MOST VAPORS ARE HEAVIER THAN AIR. THEY WILL SPREAD ALONG GROUND AND COLLECT IN LOW OR CONFINED AREAS (SEWERS, BASEMENTS, TANKS).
VAPOR EXPLOSION HAZARD INDOORS, OUTDOORS OR IN SEWERS.
THOSE SUBSTANCES DESIGNATED WITH A (P) MAY POLYMERIZE EXPLOSIVELY WHEN HEATED OR INVOLVED IN A FIRE.
RUNOFF TO SEWER MAY CREATE FIRE OR EXPLOSION HAZARD.
CONTAINERS MAY EXPLODE WHEN HEATED.
MANY LIQUIDS ARE LIGHTER THAN WATER.
SUBSTANCE MAY BE TRANSPORTED HOT.
. FOR HYBRID VEHICLES, GUIDE 147 (LITHIUM ION BATTERIES) OR GUIDE 138 (SODIUM BATTERIES) SHOULD ALSO BE CONSULTED.:
IF MOLTEN ALUMINUM IS INVOLVED, REFER TO GUIDE 169.
HEALTH:
INHALATION OR CONTACT WITH MATERIAL MAY IRRITATE OR BURN SKIN AND EYES.
FIRE MAY PRODUCE IRRITATING, CORROSIVE AND/OR TOXIC GASES.
VAPORS MAY CAUSE DIZZINESS OR SUFFOCATION.
RUNOFF FROM FIRE CONTROL OR DILUTION WATER MAY CAUSE POLLUTION.
=============================== PUBLIC SAFETY ===============================
CALL EMERGENCY RESPONSE TELEPHONE NUMBER ON SHIPPING PAPER FIRST. IF SHIPPING PAPER NOT AVAILABLE OR NO ANSWER, REFER TO APPROPRIATE TELEPHONE NUMBER LISTED ON THE INSIDE BACK COVER.
AS AN IMMEDIATE PRECAUTIONARY MEASURE, ISOLATE SPILL OR LEAK AREA FOR AT LEAST 50 METERS (150 FEET) IN ALL DIRECTIONS.
KEEP UNAUTHORIZED PERSONNEL AWAY.
STAY UPWIND, UPHILL AND/OR UPSTREAM.
VENTILATE CLOSED SPACES BEFORE ENTERING.
PROTECTIVE CLOTHING:
WEAR POSITIVE PRESSURE SELF-CONTAINED BREATHING APPARATUS (SCBA).
STRUCTURAL FIREFIGHTERS' PROTECTIVE CLOTHING WILL ONLY PROVIDE LIMITED PROTECTION.
EVACUATION:
LARGE SPILL:
CONSIDER INITIAL DOWNWIND EVACUATION FOR AT LEAST 300 METERS (1000 FEET).
FIRE:
IF TANK, RAIL CAR OR TANK TRUCK IS INVOLVED IN A FIRE, ISOLATE FOR 800 METERS (1/2 MILE) IN ALL DIRECTIONS; ALSO, CONSIDER INITIAL EVACUATION FOR 800 METERS (1/2 MILE) IN ALL DIRECTIONS.
IN CANADA, AN EMERGENCY RESPONSE ASSISTANCE PLAN (ERAP) MAY BE REQUIRED FOR THIS PRODUCT. PLEASE CONSULT THE SHIPPING DOCUMENT AND/OR THE CANADA AND UNITED STATES NATIONAL RESPONSE CENTERS REFERENCE DOCUMENT. :
============================= EMERGENCY RESPONSE ============================
FIRE:
CAUTION: ALL THESE PRODUCTS HAVE A VERY LOW FLASH POINT: USE OF WATER SPRAY WHEN FIGHTING FIRE MAY BE INEFFICIENT.:
CAUTION: FOR MIXTURES CONTAINING ALCOHOL OR POLAR SOLVENT, ALCOHOL-RESISTANT FOAM MAY BE MORE EFFECTIVE.:
SMALL FIRE:
DRY CHEMICAL, CO2, WATER SPRAY OR REGULAR FOAM.
LARGE FIRE:
WATER SPRAY, FOG OR REGULAR FOAM.
DO NOT USE STRAIGHT STREAMS.
MOVE CONTAINERS FROM FIRE AREA IF YOU CAN DO IT WITHOUT RISK.
FIRE INVOLVING TANKS OR CAR/TRAILER LOADS:
FIGHT FIRE FROM MAXIMUM DISTANCE OR USE UNMANNED HOSE HOLDERS OR MONITOR NOZZLES.
COOL CONTAINERS WITH FLOODING QUANTITIES OF WATER UNTIL WELL AFTER FIRE IS OUT.
WITHDRAW IMMEDIATELY IN CASE OF RISING SOUND FROM VENTING SAFETY DEVICES OR DISCOLORATION OF TANK.
ALWAYS STAY AWAY FROM TANKS ENGULFED IN FIRE.
FOR MASSIVE FIRE, USE UNMANNED HOSE HOLDERS OR MONITOR NOZZLES; IF THIS IS IMPOSSIBLE, WITHDRAW FROM AREA AND LET FIRE BURN.
SPILL OR LEAK:
ELIMINATE ALL IGNITION SOURCES (NO SMOKING, FLARES, SPARKS OR FLAMES IN IMMEDIATE AREA).
ALL EQUIPMENT USED WHEN HANDLING THE PRODUCT MUST BE GROUNDED.
DO NOT TOUCH OR WALK THROUGH SPILLED MATERIAL.
STOP LEAK IF YOU CAN DO IT WITHOUT RISK.
PREVENT ENTRY INTO WATERWAYS, SEWERS, BASEMENTS OR CONFINED AREAS.
A VAPOR-SUPPRESSING FOAM MAY BE USED TO REDUCE VAPORS.
ABSORB OR COVER WITH DRY EARTH, SAND OR OTHER NON-COMBUSTIBLE MATERIAL AND TRANSFER TO CONTAINERS.
USE CLEAN, NON-SPARKING TOOLS TO COLLECT ABSORBED MATERIAL.
LARGE SPILL:
DIKE FAR AHEAD OF LIQUID SPILL FOR LATER DISPOSAL.
WATER SPRAY MAY REDUCE VAPOR, BUT MAY NOT PREVENT IGNITION IN CLOSED SPACES.
================================== FIRST AID ================================
ENSURE THAT MEDICAL PERSONNEL ARE AWARE OF THE MATERIAL(S) INVOLVED AND TAKE PRECAUTIONS TO PROTECT THEMSELVES.
MOVE VICTIM TO FRESH AIR.
CALL 911 OR EMERGENCY MEDICAL SERVICE.
GIVE ARTIFICIAL RESPIRATION IF VICTIM IS NOT BREATHING.
ADMINISTER OXYGEN IF BREATHING IS DIFFICULT.
REMOVE AND ISOLATE CONTAMINATED CLOTHING AND SHOES.
IN CASE OF CONTACT WITH SUBSTANCE, IMMEDIATELY FLUSH SKIN OR EYES WITH RUNNING WATER FOR AT LEAST 20 MINUTES.
WASH SKIN WITH SOAP AND WATER.
IN CASE OF BURNS, IMMEDIATELY COOL AFFECTED SKIN FOR AS LONG AS POSSIBLE WITH COLD WATER. DO NOT REMOVE CLOTHING IF ADHERING TO SKIN.
KEEP VICTIM CALM AND WARM.
LAST UPDATED: 4/27/2017
POWERED BY NLETS
US DEPARTMENT OF TRANSPORTATION
]]></n2-mr:ChemicalGuideText>
</n2-mr:SubstanceAugmentation>
</nc3:Chemical>
</n2-mr:ChemicalInformation>
</n2:NLETSResponseData>
</n2:NLETS>