TS/MP 2.5 Management Programming Manual

Unlisted Tokens
When a token is common to all event messages but is not specific to any one event message, it is
not listed in the syntax boxes and token descriptions in this section. For a description of all tokens
not listed in this section, see Table 26 (page 167) in “Event Management” (page 163).
Listed Tokens
These unconditional tokens, which can have different values for each event message, are present
in each event message generated by the PATHMON process and are individually listed in the
syntax boxes and token descriptions:
• ZEMS-TKN-EMPHASIS (ZSPI-VAL-TRUE or ZSPI-VAL-FALSE)
• ZEMS-TKN-EVENTNUMBER
• ZEMS-TKN-SUBJECT-MARK
• Subject token for ZEMS-TKN-SUBJECT-MARK
• ZEMS-TKN-EVENTCLASS
Additionally, any conditional tokens, HP internal tokens, and nested tokens that are specific to an
event message are included in the syntax boxes and token descriptions.
NOTE: With the exception of ZEMS-TKN-SUBJECT-MARK and the subject token, the order of the
tokens in the box is not necessarily the order in which they appear in the event message. The token
ZEMS-TKN-SUBJECT-MARK always immediately precedes the subject token of an event message.
Subject Tokens
Subject tokens (for example, ZPWY-TKN-SCNAME) contain the name of the PATHMON-controlled
object that is the subject of the event message. Within the syntax boxes in this section, subject
tokens may be presented in the form ZPWY-TKN-nnnNAME, where nnn represents one of these
TS/MP object types:
SCPARAMSCASSIGNLM
SCPROCESSSCDEFINEPMREQUESTER
SCSTARTUPSCLMSC
For descriptions of these object types, see “Object Types” (page 32). Object types not listed above
are Pathway/iTS objects, described in the Pathway/iTS Management Programming Manual.
Event-Message Text
The syntax box contains the text version of the event message, which is available through the
EMSTEXT procedure. When you use the EMSTEXT procedure to get the text version of an event
message, you request either the display format or the console compatible format, as described in
the EMS Manual. In the case of Pathway subsystem event messages, the two versions are identical.
Simple Tokens
The notation used in the box for simple tokens is a shorthand version of the essential information
given in the DDL TOKEN-CODE statement.
Error Recovery
When an error originates in the SCREEN COBOL program, use the additional event-message text
to obtain the name, version, and instruction address of the program unit being executed. You can
isolate the problem to a paragraph in the source program by using the information obtained from
the additional event-message text and the compiler listing with a MAP.
Error Recovery 177