WARNING (Warning)

The WARNING tag defines text that alerts the user to a risk of possible error conditions in the system.

Syntax


>>-<WARNING>--+------+--</WARNING>-----------------------------><
              '-text-'

Parameters

text: This is the text of the warning.

Comments

The WARNING tag defines text that alerts the user to a risk of possible error conditions in the system.

The WARNING tag is one of the tags that alert the user of a possible risk; the others are the CAUTION tag and the ATTENTION tag.

Code a warning statement before the text to which it pertains so that the user can read about the possible risks before reading the text.

When a warning statement is displayed, the string "Warning:" (or its translated equivalent) appears on the screen before the text of the warning statement.

You can code additional paragraphs of warning text by coding the P (paragraph) tag within a WARNING definition. You can also code other tags allowed in an information area within a WARNING definition.

Restrictions

The WARNING tag requires an end tag.
You must code the WARNING tag within an INFO definition. See INFO (Information Region) for a complete description of this tag.
The WARNING tag must be immediately preceded by a P, LI, or LP tag. If the WARNING tag is coded on the same line as one of these tags, there can be no intervening blanks. See P (Paragraph), LI (List Item), and LP (List Part) for descriptions of these tags.
You cannot nest WARNING, ATTENTION, or CAUTION tags within each other.

Processing

Table 1. Tags you can code within a WARNING definition
Tag	Reference	Usage	Required
DL	DL (Definition List)	Multiple	No
FIG	FIG (Figure)	Multiple	No
HP	HP (Highlighted Phrase)	Multiple	No
LINES	LINES (Lines)	Multiple	No
NOTE	NOTE (Note)	Multiple	No
NOTEL	NOTEL (Note List)	Multiple	No
NT	NT (Note)	Multiple	No
OL	OL (Ordered List)	Multiple	No
P	P (Paragraph)	Multiple	No
PARML	PARML (Parameter List)	Multiple	No
PS	PS (Point-and-Shoot)	Multiple	No
RP	RP (Reference Phrase)	Multiple	No
SL	SL (Simple List)	Multiple	No
UL	UL (Unordered List)	Multiple	No
XMP	XMP (Example)	Multiple	No

Examples

Here is help panel markup that contains a warning statement. The warning statement starts at the left margin because it is embedded in the LP tag.

<!DOCTYPE DM SYSTEM>

<HELP NAME=warning DEPTH=20>Help For Changing a File
<AREA>
<INFO>
  <OL>
    <LI>Type over the existing data
    in the entry fields with the new data.
      <LP><WARNING>Performing the next step will save
      all changes and delete the existing data.
      <P>To quit this function without
      deleting the existing data, press F12.
      </WARNING>
    <LI>Press Enter to save the
    updated data.
  </OL>
</INFO>
</AREA>
</HELP>

Figure 1. Warning statement

             Help For Changing a File

 1.  Type over the existing data in the entry
     fields with the new data.

 Warning: Performing the next step will save all
 changes and delete the existing data.

 To quit this function without deleting the
 existing data, press F12.

 2.  Press Enter to save the updated data.





  F1=Help         F3=Exit         F5=Exhelp
  F6=Keyshelp     F7=PrvTopic     F8=NxtTopic
 F10=PrvPage     F11=NxtPage     F12=Cancel