ViewPoint Manual

Customizing ViewPoint
ViewPoint Manual—426801-001
6-20
Linkage Section of ZVPT-EXTRAS
The information in ZVPT-IPC-HDR and ZVPT-LINK-DATA-L forms the context for the
thread of execution on a particular terminal. Your ZVPT-EXTRAS program can use this
information, but the program should not alter the information. One exception is where a
terminal is running without a TACL connection. In that case, you might want to change
fields such as Z-CLIPBOARD-FILENAME, Z-CURRENT-VOL- SUBVOL, and Z-
USER-ID to correspond to the user’s environment, if the information is available to you.
The information in ZVPT-USER-REQUEST includes the options specified on entry to
ZVPT-EXTRAS (the contents of the options line on a block-mode screen or, if Extras
was called from TACL, the contents of the input following the TACL prompt). You can
use these fields to invoke a different base ViewPoint screen on exit from
ZVPT-EXTRAS and to pass a different option line to that screen.
Figure 6-4. Linkage Section of ZVPT-EXTRAS
01 ZVPT-IPC-HDR.
02 Z-REQUEST-CODE pic s9(4) comp.
02 Z-PW-REPLY-CODE redefines Z-REQUEST-CODE
pic s9(4) comp.
02 filler pic x.
02 Z-VERSION-CODE.
03 LETTER pic a.
03 REV-NUMBER pic 99.
02 Z-IPC-RETN-CODE pic s9(4) comp.
02 Z-IPC-RETN-CODE-DETAIL pic s9(4) comp.
02 Z-LOG-THIS-IPC pic a.
02 filler pic x.
01 ZVPT-LINK-DATA-L.
02 Z-TMF-STARTED-FLAG pic 9.
88 Z-TMF-STARTED value is 1.
02 Z-COLOR-FLAG pic 9.
88 Z-COLOR value is 1.
02 Z-SYSTEM-NAME pic x(8).
02 Z-PATHMON-NAME pic x(8).
02 Z-TACL-PORT-NAME pic x(24).
02 Z-PRINT-PORT-NAME pic x(34).
02 Z-CLIPBOARD-FILENAME pic x(24).
02 Z-CURRENT-VOL-SUBVOL pic x(16).
02 Z-STATUS-CONFIG-FILENAME pic x(24).
02 Z-EVENT-CONFIG-FILENAME pic x(24).
02 Z-USER-ID.
03 Z-USER-ID-GROUP pic s9(4) comp.
03 Z-USER-ID-USER pic s9(4) comp.
02 Z-HELP-SERVER pic x(16).
02 Z-PREFERRED-LANGUAGE pic x(32).
01 ZVPT-USER-REQUEST.
02 Z-LAST-SCREEN pic x(16).
02 Z-FUNCTION-KEY pic x(16).
02 Z-OPTION-LINE pic x(78).