TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-156
#EMSTEXTV Built-In Function
#EMSTEXTV Built-In Function
Use #EMSTEXTV to obtain data from an event buffer and put the printable text derived
from the event into a STRUCT.
option
is one of these:
INDENT num-chars
INITTEMPLATE struct
LINES num-lines
OPRLOG num
WIDTH num-chars
These have the same definitions as those in the #EMSTEXT built-in function.
buffer-var
is the name of a STRUCT containing an SPI buffer.
formatted-var
is the name of a STRUCT that is to receive the formatted text. The STRUCT can
have any definition, but it must be large enough to contain at least num-lines of
num-chars each.
lengths-var
is the name of a STRUCT that is to receive the lengths result from the EMSTEXT
procedure; lengths indicates the actual length of each line in the printable text
result. If, for example, the formatted-var STRUCT can contain 5 lines of 80
characters each, and the formatting of a given message places 75 characters in
the first line, 28 characters in the second, and nothing at all in the remaining three
lines, the EMSTEXT procedure puts [75, 28, -1, -1, -1] into lengths-var. This
STRUCT can have any definition, but it must be at least large enough to contain 2
* num-lines characters.
Result
#EMSTEXTV returns a space-separated pair of signed integers representing the result
of EMSTEXT. Their meaning is:
#EMSTEXTV [ / option [ , option ] ... / ] buffer-var
formatted-var [ lengths-var ]
Result Description
0 0 No error
0 22 Invalid parameter address or invalid parameter
0 29 Missing parameter