DSM Template Services Manual

Template Language
DSM Template Services Manual—427187-004
3-19
Edit Markers
Main Templates
For each event, there can be a format template and one or more override templates.
For each of these templates, the key has these parts:
•
Subsystem ID
•
ZEMS-TKN-EVENTNUMBER as token code
•
The event number (ZEMS-EVT-TAKOVER, for example) as token value
•
Template type (format or override)
Main templates can contain references to additional templates, whose keys contain
token codes and token values other than these. See MSG Edit Code on page 3-29.
Edit Markers
An edit marker is an entity with angle brackets that requests an edit operation at the
place it marks in a template string. The bracketed numbers in this MSG statement are
the most common type of edit marker:
MSG: ZEMS-TKN-EVENTNUMBER, ZEMS-EVT-BACKUP-CREATED
"EMS: Created backup in CPU <1>,"
" priority <2>, program file <3>"
1: ZEMS-TKN-NEWPROCESS-CPU, ZI2
2: ZEMS-TKN-NEWPROCESS-PRIORITY, O
3: ZEMS-TKN-PROGRAMFILE
The edit markers in this example show where to insert token values in the display text.
The complete set of edit markers is:
<NN> Refers to the nnth edit descriptor and marks a position in the display text. The
edit-descriptor representation is inserted in the display text at the marked
position.
<*CR> Marks a preferred place for a line break if the number of characters requires
one.
<*IF NN> Causes evaluation of the NNth edit descriptor, which must be an *IF edit
descriptor. *IF, *ELSE, and *ENDIF work together as you might expect.
Specifically, if EMSTEXT evaluates the NNth edit descriptor as true, the portion
of the template string between the *IF and the *ELSE (or *ENDIF) is
interpreted. Otherwise it is ignored.
<*ELSE> If the preceding *IF statement is evaluated as false, the portion of the template
string between the *ELSE and the *ENDIF is interpreted. Otherwise it is
ignored.
<*ENDIF> Marks the end of conditional interpretation begun by an *IF edit marker.