DSM Template Services Manual
Template Language
DSM Template Services Manual—427187-004
3-20
Edit Descriptors
Edit Descriptors
An edit descriptor describes the way token-value substitution, requested by an edit
marker, is to be performed. The syntax for an edit descriptor is:
nn
is a one-digit or two-digit number that identifies the edit descriptor. Within an MSG
statement, nn must be unique.
token-reference
specifies the value (or values) to be inserted at the corresponding edit marker. This
can be anything from a token code to a range of fields. That is, you can use any
value reference included in Tokens (Unqualified) on page 3-4, Qualified Tokens on
page 3-4, and Fields on page 3-5.
edit-code
if present, is an edit code. Otherwise, a default edit code is provided for most
tokens. For more information, see Edit Codes on page 3-23.
Example
In this example, the edit markers <1>, <2>, and <3> show where token values are
inserted. The edit descriptors (lines beginning 1:, 2:, and 3:) show how to format those
values as they are inserted.
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
*IF Edit Descriptor
The *IF edit descriptor enables you to test whether a token or field is present or absent,
or to compare a token or field with a numeric constant.
To test whether a token or field is present or absent, the edit descriptor contains
TOKENPRESENT or NOT TOKENPRESENT, which has a value of true or false. To
compare a token or field with a numeric constant, the edit descriptor contains one of
these operators: less than (<), equal to (=), greater than (>), less than or equal to (<=),
greater than or equal to (>=), and not equal to (<>). Edit descriptors containing
operators also evaluate to either true or false.
nn: token-reference [ , edit-code ]