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
Summary of Contents for NonStop Pathway/iTS
Page 28: ...Introduction NonStop Pathway iTS Management Programming Manual 426749 002 1 8 SPI Interface ...
Page 270: ...PROG Commands NonStop Pathway iTS Management Programming Manual 426749 002 9 20 START PROG ...
Page 480: ...TCP Event Messages NonStop Pathway iTS Management Programming Manual 426749 002 11 202 ...