ViewPoint Manual

Customizing ViewPoint
ViewPoint Manual—426801-001
6-23
Passing Marked Event Messages
"Alt-Event" Alternate Events screen
"Last-Event" Last Events screen
"TACL" TACL conversational screen
"Profile" Profile screen
"Exit" Exit the ViewPoint application for
this terminal
Z-OPTION-LINE of ZVPT-USER-REQUEST
is optional text to be passed to the invoked screen. On entry, this contains the text
that was on the option line when the Extras screen was invoked. If the Extras screen
was invoked from the conversational TACL screen, the value is the text entered on
the option line before the Extras function key was pressed. The text is padded on
the right with blanks.
On exit, if the Z-FUNCTION-KEY field is set, your program should set Z-OPTION-
LINE to whatever text should be passed to the new screen as an option. If the
Z-FUNCTION-KEY field is not modified, Z-OPTION-LINE is ignored.
If the Extras function key is pressed from the Primary Events, Alternate Events, or Last
Events screen, any marked events are also passed to the ZVPT-EXTRAS program unit.
Events passed are those marked by a nonblank character in column 1 or by cursor
position. These events are passed as event messages in SPI format in a data file
described under “Passing Marked Event Messages” below.
Your ZVPT-EXTRAS program unit can call other program units you write. It should not
call program units delivered with the ViewPoint product. Program units you write can
send commands to server classes your application creates. They should not send
commands to server classes delivered with the ViewPoint product.
Passing Marked Event Messages
Event messages that are marked on an Events screen when the Extras function key is
pressed are passed to the ZVPT-EXTRAS program unit. Event messages are marked by
a nonblank character in column 1 or by cursor position on the screen. Only messages
from the current screen are passed. Event messages are passed as messages in SPI
format in an ENSCRIBE key-sequenced data file (EVNTMRKD) in the ViewPoint data
subvolume.
EVNTMRKD is shared among all terminal threads and contains a record for each event
message passed. The key for each record includes the logical terminal name and an
event count (1, 2, 3, and so on). The logical terminal name portion of the key can be
used to position (generic position) on event messages passed for a given terminal. The
event count distinguishes successive event messages marked on a screen. The header
structure on each record includes the filter return code and a deleted flag.
On entry to a ZVPT-EXTRAS program unit, messages for events marked on the
ViewPoint Events screen are present in EVNTMRKD. After returning to ViewPoint
from a ZVPT-EXTRAS program unit, all event records corresponding to the logical
terminal are automatically deleted from EVNTMRKD.