TACL Reference Manual

Built-In Functions and Variables

HP NonStop TACL Reference Manual—429513-018

9-137

#EMSADDSUBJECT Built-In Function

Use #EMSADDSUBJECT to add a subject token to the event message buffer. This

function places the token that you provide, preceded by a subject-mark token, in the

buffer.

SSID ssid

is a subsystem ID that qualifies the token code; if omitted or zero (0.0.0), it defaults

to the subsystem ID of the current list or, if the current position is not in a list, to the

subsystem ID specified in the event message header (ZSPI-TKN-SSID).

buffer-var

is the name of a writable STRUCT used as an EMS buffer. #EMSADDSUBJECT

automatically passes the data length of the STRUCT to the EMSADDSUBJECT

system procedure.

token-id

is the token code of the subject token to be added to the event message.

token-value

is a value to be given to the new token. Include this parameter if a value is

associated with the token.

Result

#EMSADDSUBJECT returns a numeric status code indicating the outcome of the

EMSADDSUBJECT procedure.

The meaning of the status code:

#EMSADDSUBJECT [ / SSID ssid / ] buffer-var

token-id [ token-value ]

Code Condition

0 No error

-1 Invalid buffer format

-2 Invalid parameter value

-3 Missing parameter

-4 Invalid parameter address

-5 Buffer full

-6 Invalid checksum

-7 Internal error

-8 Token not found