CMAMtext
Last modified date:
Mar 23, 2022
Description
An emergency message up to 90 characters in length intended for display on mobile devices as a Wireless Emergency Alert (WEA).
Format
<parameter>
<valueName>CMAMtext</valueName>
<value>text</value>
</parameter>
Where text is an emergency message no longer than 90 characters.
Example
<parameter>
<valueName>CMAMtext</valueName>
<value> Tornado Warning in this area til 3:45 AM CST. Take shelter now. Check local media. -NWS</value>
</parameter>
Inclusion
Included in CAP messages which warn of an imminent threat to life and/or property and are intended to activate WEA.
CMAMlongtext
Last modified date:
Mar 23, 2022
Description
An emergency message up to 360 characters in length intended for display on mobile devices as a Wireless Emergency Alert (WEA).
Format
<parameter>
<valueName>CMAMText</valueName>
<value>text</value>
</parameter>
Where text is an emergency message no longer than 360 characters.
Example
<parameter>
<valueName>CMAMText</valueName>
<value>National Weather Service: A FLASH FLOOD WARNING is in effect for this area until 5:45 PM MST. This is a dangerous and life-threatening situation. Do not attempt to travel unless you are fleeing an area subject to flooding or under an evacuation order.</value>
</value>
</parameter>
Inclusion
Included in CAP messages which warn of an imminent threat to life and/or property and are intended to activate WEA.
maxWindGust
Last modified date:
Mar 23, 2022
Description
Anticipated maximum wind gust potential of a storm.
Format
<parameter>
<valueName>maxWindGust</valueName>
<value>XXX MPH</value>
</parameter>
Where XXX is the anticipated maximum wind gust potential of the storm.
Example
<parameter>
<valueName>windGust</valueName>
<value>80 MPH</value>
</parameter>
Inclusion
Included with Severe Thunderstorm Warnings, some Special Marine Warnings, some Severe Weather Statements, and some Marine Weather Statements.
maxHailSize
Last modified date:
Mar 23, 2022
Description
Maximum hail size expected from the storm.
Format
<parameter>
<valueName>maxHailSize</valueName>
<value>X.XX</value>
</parameter>
Where X.XX is the expected maximum hail size in inches.
Example
<parameter>
<valueName>maxHailSize</valueName>
<value>1.75</value>
</parameter>
Inclusion
Included with Severe Thunderstorm Warnings, Tornado Warnings, Special Marine Warnings, some Severe Weather Statements and some Marine Weather Statements
windThreat
Last modified date:
Mar 23, 2022
Description
Source of information for the wind threat.
Format
<parameter>
<valueName>windThreat</valueName>
<value>windThreat</value>
</parameter>
Where windThreat is "RADAR INDICATED" or "OBSERVED"
Example
<parameter>
<valueName>windThreat</valueName>
<value>RADAR INDICATED</value>
</parameter>
Inclusion
Included with Severe Thunderstorm Warnings, some Special Marine Warnings, some Severe Weather Statements, and some Marine Weather Statements.
hailThreat
Last modified date:
Mar 23, 2022
Description
Source of Information for the hail threat.
Format
<parameter>
<valueName>hailThreat</valueName>
<value>hailThreat</value>
</parameter>
Where hailThreat is "RADAR INDICATED" or "OBSERVED"
Example
<parameter>
<valueName>hailThreat</valueName>
<value>OBSERVED</value>
</parameter>
Inclusion
Included with Severe Thunderstorm Warnings, some Special Marine Warnings, some Severe Weather Statements, and some Marine Weather Statements.
thunderstormDamageThreat
Last modified date:
Mar 23, 2022
Description
Impact in terms of damage expected from a thunderstorm.
Format
<parameter>
<valueName>thunderstormDamageThreat</valueName>
<value>damage</value>
</parameter>
Where damage is “CONSIDERABLE” or “DESTRUCTIVE”.
Example
<parameter>
<valueName>thunderstormDamageThreat</valueName>
<value>CONSIDERABLE</value>
</parameter>
Inclusion
Only included in Severe Thunderstorm Warnings when there is credible evidence that the thunderstorm is producing considerable or greater damage.
AWIPSidentifier
Last modified date:
Mar 23, 2022
Description
Advanced Weather Interactive Processing System (AWIPS) Identifier
Format
<parameter>
<valueName>AWIPSidentifier</valueName>
<value>NNNXXX</value>
</parameter>
Where:
NNN is the AWIPS product category and XXX is the AWIPS office identifier. If the XXX is less than 3 characters, the character(s) shall be left justified and filled with blanks to complete the 3-character field. See https://www.weather.gov/tg/awips for more information.
Example
<parameter>
<valueName>AWIPSidentifier</valueName>
<value>FFWPSR</value>
</parameter>
Inclusion
Included in every <info> block.
eventMotionDescription
Last modified date:
Mar 23, 2022
Description
The position and motion of a hazardous event given in local time.
Format
<parameter>
<valueName>eventMotionDescription</valueName>
<value>YYYY-MM-DDThh:mm:ssXzh:zm...event…dirDEG...spKT...lat,lon [, lat,lon…] </value>
</parameter>
Where:
- YYYY = Year
- MM = Month (01-12)
- DD = Day, 2 digits with leading zeros (01-31)
- T marks the start of the time section
- hh = 24-hour format of an hour with leading zeros (00-23)
- mm = Minutes with leading zeros (00-59)
- ss = Seconds, with leading zeros (00-59)
- X = The symbol "+" if the preceding date and time are in a time zone ahead of UTC, or the symbol "-" if the preceding date and time are in a time zone behind UTC. If the time is in UTC, the symbol "-" will be used.
- zh = Hours of offset from the preceding date and time to UTC, or "00" if the preceding time is in UTC
- zm = Minutes of offset from the preceding date and time to UTC, or "00" if the preceding time is in UTC
- event = storm
- dirDeg = three-digit direction from which the storm is moving, in degrees from 000 to 359 nonzero direction
- sp = speed of movement of the storm, in knots from 0 to 99 without a leading zero
- lat,lon = coded pair(s) identifying the latitude and longitude of the storm center expressed as a single point (in the case of one pair) or a line (if more than one pair is used) using WGS 84 (see Implementation Notes section of the OASIS CAP Profile document)
Example
<parameter>
<valueName>eventMotionDescription</valueName>
<value>2010-08-05T08:46:00-05:00...storm...062DEG...16KT...30.62,-90.82 30.40,-90.91 30.25,-90.79</value>
</parameter>
Means that on August 8, 2010 at 8:46:00 AM Central Daylight Time, the storm was moving from the northeast (to the southwest) at 16 knots. The storm center was located along the line connected by latitude 30.62 longitude -90.82, latitude 30.40 longitude -90.91, and latitude 30.25 longitude -90.79.
Inclusion
Included in NWS CAP messages with the following <eventCode>:
- TOR (Tornado Warning)
- SVR (Severe Thunderstorm Warning)
- SVS (Severe Weather Statement)
- SMW (Special Marine Warning)
- MWS (Marine Weather Statement)
- EWW (Extreme Wind Warning)
WMOidentifier
Last modified date:
Mar 23, 2022
Description
World Meteorological Organization (WMO) identifier
Format
<parameter>
<valueName>WMOidentifier</valueName>
<value>T1T2A1A2ii CCCC YYGGgg [BBB]</value>
</parameter>
Where:
T1 is taken from WMO Manual 386 table A. It is an alpha character that
designates the general code form of the contents of the bulletin (Coded or
plain text).
T2 is taken from WMO Manual 386 tables B1 through B6 depending on the
designator T1 in table A. It is an alpha character that designates the
data type.
A1 is taken from WMO Manual 386 tables C1 through C6 depending on
designator T1 in table A (U.S. National practice through C9). It is an
alpha character that designates the geographical area the content of the
bulletin covers.
A2 is taken from WMO Manual 386 tables C1 through C5 depending on
designator T1 in table A (U.S. National practice through C9). It is an
alpha character that designates the geographical area, or may define the
forecast period.
ii is taken from the WMO Manual 386 paragraph 2.3.2.2 definition, or from
table D1 or D2 depending on designator T1 in table A (U.S. National
practice table D3 replaces D2). It is a numeric set of two characters. Go
to the WMO message structure for more details on this group.
CCCC is the identification of the processing center that generated the
bulletin. Commonly centers use alpha character identification designators
from ICAO's Location Indicators Doc 7910/80, but this is not consistent
throughout the centers.
YYGGgg is the day, hour, and minute the bulletin was prepared or the
reporting time of the contained reports in it.
BBB is an optional group of alpha characters
See https://www.weather.gov/tg/awips for more information.
Example
<parameter>
<valueName>WMOidentifier</valueName>
<value>WGUS55 KPSR 242050</value>
</parameter>
Inclusion
Included in every CAP message that originates from the NWS.
EAS-ORG
Last modified date:
Mar 23, 2022
Description
EAS Originator code of the NWS as required by the IPAWS CAP profile.
Format
<parameter>
<valueName>EAS-ORG</valueName>
<value>XXX</value>
</parameter>
Where XXX is the Special Area Message Encoding (SAME) organization code. If the alert was originated by the NWS, then XXX is assigned a value of "WXR". If the alert was originated by a civil authority, then XXX is assigned a value of "CIV".
Example
<parameter>
<valueName>EAS-ORG</valueName>
<value>WXR</value>
</parameter>
Inclusion
Included in every <info> block.
VTEC
Last modified date:
Mar 23, 2022
Description
Valid Time Event Code (VTEC) of the subject alert message.
Format
<parameter>
<valueName>VTEC</valueName>
<value>VTEC</value>
</parameter>
Where VTEC is the Valid Time Event Code (VTEC).
See https://www.weather.gov/vtec for more information about VTEC.
Example
<parameter>
<valueName>VTEC</valueName>
<value>/O.CON.KDMX.SV.W.0004.000000T0000Z-110321T1845Z/</value>
</parameter>
Inclusion
Included in many, but not all NWS CAP messages.
BLOCKCHANNEL
Last modified date:
Mar 23, 2022
Description
Blocks transmission of the alert across an IPAWS dissemination channel. One or more channels may be blocked.
Format
<parameter>
<valueName>BLOCKCHANNEL</valueName>
<value>channel</value>
</parameter>
Where channel is one of the following values.
• “CMAS” – Refers to Wireless Emergency Alerts (WEA)
• “EAS” – Refers to Emergency Alert System
• “NWEM” – Refers to Non-Weather Emergency Message
• “PUBLIC” – Refers to IPAWS public alert dissemination channel
Example
<parameter>
<valueName>BLOCKCHANNEL</valueName>
<value>EAS</value>
</parameter>
<parameter>
<valueName>BLOCKCHANNEL</valueName>
<value>NWEM</value>
</parameter>
<parameter>
<valueName>BLOCKCHANNEL</valueName>
<value>CMAS</value>
</parameter>
Inclusion
NWS often blocks CMAS, since WEA is intended only for the most critical alerts. NWS blocks EAS for alerts which are not intended for EAS via the IPAWS EAS channel. NWS always blocks messages to NWEM, since NWEMs push CAP messages back the NWS which would cause an undesirable dissemination loop. NWS never blocks PUBLIC.
expiredReferences
Last modified date:
Mar 23, 2022
Description
References the most recent message to which the current message refers or replaces.
Format
<parameter>
<valueName>expiredReferences</valueName>
<value>sender,identifier,sent</value>
</parameter>
Where sender, identifier, and sent are the <sender>, <identifier>, and <sent> elements from inactive (i.e., <expires> time has been exceeded) CAP message(s) that this CAP message replaces. When multiple messages are referenced, they are separated by whitespace.
Example
<parameter>
<valueName>expiredReferences</valueName>
<value>w-nws.webmaster@noaa.gov,urn:oid:2.49.0.1.840.0.ba78bc1780b07d57760cb3f75be064662620ea40.002.1,2021-02-05T05:58:00-05:00 w-nws.webmaster@noaa.gov,urn:oid:2.49.0.1.840.0.ba78bc1780b07d57760cb3f75be064662620ea40.003.1,2021-02-05T05:58:00-05:00 w-nws.webmaster@noaa.gov,urn:oid:2.49.0.1.840.0.f2d8079fd63d3ebad3bc90e90e1267ab2747da93.003.2,2021-02-05T04:44:00-05:00</value>
</parameter>
Inclusion
Included whenever the NWS updates or cancels an alert for which a CAP message has been produced and at least one prior CAP message for the alert is inactive (i.e., <expires> time has been exceeded). NWS references all inactive messages impacted by the new message. Referencing all inactive alert messages ensures any messages that may still be playing incorrectly are properly superseded by the most recent Update or Cancel. This resolves issues caused by transmission delays and/or lost messages that may result in message chains being broken.
flashFloodDamageThreat
Last modified date:
Mar 23, 2022
Description
Impact in terms of damage expected from a flash flood.
Format
<parameter>
<valueName>flashFloodDamageThreat</valueName>
<value>damage</value>
</parameter>
Where damage is “CONSIDERABLE” or “CATASTROPHIC”.
Example
<parameter>
<valueName>flashFloodDamageThreat</valueName>
<value>CATASTROPHIC</value>
</parameter>
Inclusion
Only included in Flash Flood Warnings when there is credible evidence that the flash flood is producing considerable or greater damage.
snowSquallDetection
Last modified date:
Mar 23, 2022
Description
Describes whether the snow squall is indicated by radar or observed. This is an implied statement of confidence in the evidence that a snow squall is occurring.
Format
<parameter>
<valueName>snowSquallDetection</valueName>
<value>detection</value>
</parameter>
Where detection is “RADAR INDICATED” or “OBSERVED”.
Example
<parameter>
<valueName>snowSquallDetection</valueName>
<value>RADAR INDICATED</value>
</parameter>
Inclusion
Included in most Snow Squall Warnings.
snowSquallImpact
Last modified date:
Mar 23, 2022
Description
Impact of the snow squall.
Format
<parameter>
<valueName>snowSquallImpact</valueName>
<value>impact</value>
</parameter>
Where impact is “SIGNIFICANT”.
Example
<parameter>
<valueName>snowSquallImpact</valueName>
<value>SIGNIFICANT</value>
</parameter>
Inclusion
Only included in Snow Squall Warnings when there is credible evidence that the snow squall is of significant impact.
flashFloodDetection
Last modified date:
Mar 23, 2022
Description
Describes whether the flash flood is indicated by radar or observed. This is an implied statement of confidence in the evidence that a flash flood is occurring.
Format
<parameter>
<valueName>flashFloodDetection</valueName>
<value>detection</value>
</parameter>
For Flash Flood Warnings, detection is “RADAR INDICATED”, "RADAR AND GAUGE INDICATED", or “OBSERVED”.
Example
<parameter>
<valueName>flashFloodDetection</valueName>
<value>RADAR INDICATED</value>
</parameter>
Inclusion
Included with all Flash Flood Warnings.
eventEndingTime
Last modified date:
Mar 23, 2022
Description
The expected end time of the subject event in the alert message. This is the time at which the hazard conditions of the subject event are no longer expected.
Format
<parameter>
<valueName>eventEndingTime</valueName>
<value>YYYY-MM-DDThh:mm:ssXzh:zm</value>
</parameter>
Where:
- YYYY = Year
- MM = Month (01-12)
- DD = Day, 2 digits with leading zeros (01-31)
- T marks the start of the time section
- hh = 24-hour format of an hour with leading zeros (00-23)
- mm = Minutes with leading zeros (00-59)
- ss = Seconds, with leading zeros (00-59)
- X = The symbol "+" if the preceding date and time are in a time zone ahead of UTC, or the symbol "-" if the preceding date and time are in a time zone behind UTC. If the time is in UTC, the symbol "-" will be used.
- zh = Hours of offset from the preceding date and time to UTC, or "00" if the preceding time is in UTC
- zm = Minutes of offset from the preceding date and time to UTC, or "00" if the preceding time is in UTC
Example
<parameter>
<valueName>eventEndingTime</valueName>
<value>2012-05-30T13:30:00-04:00</value>
</parameter>
Means the hazard conditions of the subject event are no longer expected after 1:30 pm Eastern Daylight Time on May 23, 2012.
Inclusion
Included in most <info> blocks. The <eventEndingTime> parameter will not be included for very long duration or open-ended alerts (e.g., hurricanes, tsunamis, some long duration floods, etc.) which are in effect until further notice.