EMS Manual

EMS Procedures
EMS Manual—426909-005
15-19
EMSTEXT Procedure
subject-value
STRING .EXT:ref:*
if present, is the value of the subject to be added to the event message.
subject-length
INT:value
is the length, in bytes, of the subject-value field. This parameter is ignored
unless the subject-token-code is defined as a variable-length token. For more
information, see Considerations on page 15-19.
subject-ssid
INT .EXT:ref:6
is the subsystem ID of the subsystem to which the subject token belongs. If you
omit this parameter or supply all zeros (6*[0]), the generating-ssid is used by
default. The version field of this parameter is not stored in the event message.
timestamp
FIXED:value
is the time stamp in Julian GMT (64-bit) format for the event message. If you omit
this parameter, the current time is used.
Considerations

Choose one of these ways to specify the length, in bytes, if the subject token has a
variable-length value.

Use the subject-length parameter to specify the length.

Place the token length in the two bytes that immediately precede the token
value; make the subject-value parameter point to the extra bytes. (Do not
count the extra bytes as part of the length.) When using this method, omit the
subject-length parameter.

If the length of the value of a variable-length subject token is zero, you cannot just
omit both value and length parameters. Use one of the previously described
methods to specify the length (zero) explicitly.
EMSTEXT Procedure
The EMSTEXT procedure produces displayable text from an event message. In TACL,
the equivalent command is #EMSTEXT or #EMSTEXTV. You can have text laid out:

In the newer, more readable DSM display format