HP NonStop Pathway/iTS

SPI Programming Considerations
NonStop Pathway/iTS Management Programming Manual—426749-002
3-29
Event-Specific Tokens
The subject token indicated by ZEMS-TKN-SUBJECT-MARK contains the name of the
specific object involved in the event. For example, if an event message reports an
event involving a TCP named TCP-8, ZEMS-TKN-SUBJECT-MARK indicates the
subject token ZPWY-TKN-TCPNAME, whose contents is the name TCP-8.
Event-Specific Tokens
Table 3-8 lists event-specific Pathway subsystem EMS tokens. These tokens are
called “program unit location tokens” because they describe the part of a SCREEN
COBOL program unit that was executing when an error was detected. These
conditional tokens appear in some Pathway subsystem event messages.
Error Messages
Most Pathway subsystem errors reported to a management application are returned in
the response buffer the application receives from the PATHMON process. Pathway
subsystem errors reported to SPI requesters are returned in one of the following:
•
In the response buffer for a STATUS TCP or STATUS TERM command (as a
number in the ZERROR field of ZPWY-DDL-STATUS-TCP or
ZPWY-DDL-STATUS-TERMDETAIL)
•
As a number in the ZSPI-TKN-RETCODE token, which is always returned in the
response buffer
•
In an error list, which is a component of a response buffer that is returned only if an
error is detected
ZPWY-TKN-TELLNAME Event concerns a tell message.
ZPWY-TKN-TERMNAME Event concerns a terminal (TERM object).
ZPWY-TKN-UNKNOWNNAME The subject of the event is unknown to PATHMON.
Table 3-8. Event-Specific Pathway EMS Tokens
Token Description
ZPWY-TKN-INSTRUCTION Describes a SCREEN COBOL instruction.
ZPWY-TKN-PUNAME Describes a SCREEN COBOL program unit.
ZPWY-TKN-PUOFFSET Contains an offset into a SCREEN COBOL program
unit.
ZPWY-TKN-PUVERSION Describes a SCREEN COBOL program unit version.
ZPWY-TKN-TCLPROGFNAME Contains the name of the SCREEN COBOL object file in
Distributed Name Service (DNS) format.
Table 3-7. Event Message Subject Tokens
Token Description