EMS Manual

EMS Procedures
EMS Manual—426909-005
15-20
EMSTEXT Procedure

In a modified version of the display format in which the format of the message
header and the indentation of the message body are specified by the EMSTEXT
parameters header template key and indent
For the steps to use EMSTEXT, and for error results, see Text Formatting Tools on
page 2-12. For an explanation of the template compiler, see the DSM Template
Services Manual.
status
INT(32):value
is a pair of 16-bit integer status codes, as described in Table 15-4 on page 15-23.
Compare to extended-status on page 15-22.
event-message-buffer
INT .EXT:ref:*
is the buffer containing the event message from which displayable text is derived.
displayable-text-buffer
STRING .EXT:ref:*
is the buffer in which EMSTEXT stores the displayable text. The buffer is a
sequence of fixed-length logical lines. Each logical line will contain a line of text to
be displayed, including indent blanks (if any), text characters, and trailing blanks (if
any).
Here is how EMSTEXT places the text of an event message into this buffer. In the
first logical line, EMSTEXT left-justifies the text, puts in as many words as fit, and
fills any remaining spaces with blanks. In each logical line thereafter, EMSTEXT
first puts the number of blanks specified by indent on page 15-22, then as many
more words of the text as fit, then trailing blanks.
Consequently, this buffer contains d * n character spaces, where:

d is the number of character spaces in each logical line (the value of
display-line-length)
{ status := } EMSTEXT( event-message-buffer ! i
{ CALL } (, displayable-text-buffer ! o
, display-line-length ! i
, number-display-lines ! i
, actual-lengths ! o
, [ header-template-key ] ! i
, [ indent ] ! i
, < RESERVED >
, [ extended-status ] ); ! o