ViewPoint Manual

Customizing ViewPoint
ViewPoint Manual—426801-001
6-21
Linkage Section of ZVPT-EXTRAS
Descriptions of the pertinent fields follow. Fields shown in Figure 6-8 that are not
mentioned below exist for compatibility reasons; your ZVPT-EXTRAS program unit
should not alter those fields or rely upon them for information.
Z-VERSION-CODE of ZVPT-IPC-HDR
provides the identifying letter (LETTER) and number (REV-NUMBER) indicating
the version of the ViewPoint software that is running.
Z-COLOR-FLAG of ZVPT-LINK-DATA-L
indicates whether or not the ViewPoint application was invoked with the color
option. A value of 1 in this field denotes the color option. Your ZVPT-EXTRAS
program can use this information to select color or monochrome displays.
For a color display, the default ViewPoint colors are white characters on a blue
background, with special attributes to produce green action event messages and red
critical event messages. If you prefer a different combination of foreground and
background colors, use #push and #set for one or both of the following TACL
variables:
:utils_globals:ViewPoint:_foreground color
:utils_globals:ViewPoint:_background color
where color can be black, blue, green, cyan, red, magenta, brown, or white.
Z-SYSTEM-NAME of ZVPT-LINK-DATA-L
is two to eight characters identifying the system on which the ViewPoint application
is running. The first character is always a backslash (\). This field is padded on the
right with blanks.
Z-PATHMON-NAME of ZVPT-LINK-DATA-L
is two to six characters identifying the process name of the PATHMON process
under which the ViewPoint application is running. The first character is always a
dollar sign ($). This field is padded on the right with blanks.
Z-CLIPBOARD-FILENAME of ZVPT-LINK-DATA-L
is the file name of the clipboard file for the current operator. This file name is in
internal form, ready to be passed to the file-system OPEN procedure. Servers
invoked from the ZVPT-EXTRAS program can read or update this file. The file is
created by the first “copy to clipboard” function. It might not exist if no “copy to
clipboard” function has been invoked. Note that by default, servers run using the
process access ID of the PATHMON process associated with the ViewPoint
application. Clipboard files are created with the default file security of the current
operator, unless you are running ViewPoint without a TACL connection (in which
case the ViewPoint PATHMON user ID security is used). Server file operations on
the clipboard file might yield security errors if the access ID and file security are
incompatible. For more information about the clipboard feature, refer to the
discussion of function keys in Section 3, “Definition of ViewPoint Screens,” and
also to Section 2, “Using ViewPoint.”