TS/MP Management Programming Manual (G06.24+, H06.03+)

Event Management

NonStop TS/MP Management Programming Manual—540082-001

10-4

Event Messages and the ViewPoint Application

Event messages logged to $0 result in a textual display on the ViewPoint screen.

Console messages that are logged to $0 are normally also echoed to the ViewPoint

application. To avoid duplication, console messages logged to $0 are only included on

the ViewPoint display when neither the LOG1 nor the LOG2 command specifies the

EVENTFORMAT parameter.

Event Message Destinations

Event messages are sent to the files you specified in the PATHCOM LOG1 and LOG2

commands, or in the ZLOG1INFO and ZLOG2INFO fields of

ZPWY-MAP-PAR-CONTROL-PM token (sent in the CONTROL PM command buffer).

The Pathway subsystem does not report event messages to the HP Tandem

Maintenance and Diagnostic System (TMDS).

HP recommends that the collector process, $0, be specified for event logging. You can

also use a process or disk file as the destination for event messages. If you log events

to a disk file, it is simplest to use an entry-sequenced structured file and specify a

record length that is at least equal to the length of the longest event message. You can

write a program to read event messages from the file and use the EMSTEXT

procedure to format them as display-format messages.

If you specify event reporting to an unstructured file, special processing is required

when reading the file. Your program must first extract the length of the current event

message from the event by calling the SSGETTKN procedure with the ZSPI-TKN-

USEDLEN token to determine how to position to the next event message. For odd

unstructured files, event messages always begin on a word boundary.

Console Printing

The Pathway subsystem does not use the ZEMS-TKN-CONSOLE-PRINT token. This

means that event messages are not processed by the compatibility distributor and,

therefore, are not displayed on consoles running versions earlier than C00. If Pathway

subsystem messages must appear on the console, configure the your subsystem to

send messages to $0 in console format.

For example, this command prints text messages on the console:

LOG1 $0, STATUS

The console message is also routed to the ViewPoint application, unless the log

specified with the LOG2 command has been configured with the EVENTFORMAT

attribute.