ViewPoint Manual

Customizing ViewPoint
ViewPoint Manual—426801-001
6-12
EVENTCX Record Structure
The other file, EVENTCX, can contain user-supplied entries. EVENTCX need not
exist; however, if it does, it probably exists on the default program subvolume. It can,
be placed anywhere if the CUSTOM-DETAIL server assign is used to refer to the file
(see Appendix A, Server Assigns and Parameters
for a description of the CUSTOM-
DETAIL assign).
You use the EVENTCX file to add “Cause” and “Recovery” advisory text to be
displayed about specified event messages. To do this, you must build the EVENTCX
file and then add records containing the appropriate text to the file. Once this is done,
the text you supplied appears in the display whenever the operator selects the Event
Detail screen for an event message of that type.
By customizing your advisory text, you can allow the operator to look up the probable
causes and recovery actions for Compaq subsystem events as they apply to your
particular system or network. For instance, an advisory display for an event message
requesting the operator to mount another tape could include specific information on tape
mounting procedures at your installation. Likewise, you can allow the operator to see
advisory text for events reported by a non-Compaq application—for example, startups
and shutdowns of automatic teller machines (ATMs).
EVENTCX Record Structure
The DDL shown in Figure 6-3 describes the records for the EVENTCX file. Refer to
the SPI Programming Manual for a more thorough description of the fields within the
subsystem ID, but note that the version number is not included in the SUBSYSTEM-ID
definition in EVENTCX. For Compaq subsystems, event numbers are compatible from
release to release. Subsystems you write should also follow this convention.
Example 6-3. EMS Template
VERSION: "T9153C20 - 15JUN88"
SSID: ZPWY-VAL-SSID
SSNAME: "PATHWAY"
== Probable cause text for event 1034
MSG: ZVPT-TKN-CAUSE, 10340001
"The following text is only for demonstration purposes:<*CR>"
"<*CR>"
"The dolphin is a marine mammal known for its intelligence and playfulness.
Dolphins are related to whales, but are smaller and have a beak-like snout.
Many people wonder about the difference between dolphins and porpoises;
porpoises are a type of dolphin. Both belong to the order Cetacea.
Porpoises have blunt snouts and triangular dorsal fins. An Orca (known as
Killer Whale) is a dolphin."
Caution. The entries in EVENTCX override the matching Tandem entries in EVENTTD.
Note. The Z-NUMBER definition might generate a different range of values depending on the
language that you use. TAL generates a 16-bit value, and SCOBOL generates a 4-digit value
no longer than 9999. Refer to the Pathway SCREEN COBOL Reference Manual for more
details about this value range.