IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

PIPE VET
Usage Notes
264 Programming: Pipes
A null string (//) is handled as a tab to the next unprotected field. By using
null strings you can tab through the unprotected fields on the virtual screen,
filling in data as you proceed. If you specify more tabs than unprotected fields
on the virtual screen, you can return to the first unprotected field on the screen
and continue with your data input.
All pending application I/O requests are applied to the virtual screen before
writing the /string/ to the virtual screen.
/string/
Specifies the data to be written to the virtual screen.
/string/ is only valid when VET is used as a command.
Data that is too long for the unprotected field is truncated. When the data is
truncated, no error condition or warning is returned to the stage.
Data that is shorter than the unprotected field is padded on the right with
blanks.
The first nonblank character encountered after the stage name or row.col is the
delimiter, which establishes the boundary of the text string used by the stage.
The delimited string ends when the same character is encountered a second
time.
Multiple unprotected fields on the virtual screen can be filled by including null
values for /string/. A null value is indicated by coding two delimiters
consecutively, for example:
//
A null string causes nothing to be written to the unprotected field, but the
cursor tabs to the next field on the virtual screen. In this way you can input
data to some fields and skip other fields. If you specify more tabs than
unprotected fields on the virtual screen, the cursor tabs back to the first
unprotected field on the screen and continues with your data input.
v While the application is still locked from accepting input, VET enables you to
queue input for the application. Queued input assumes that the application
accepts your input without any intervening errors. You can queue as much input
as necessary, but the chance for error increases dramatically with each queued
input request. If the application ends before all queued input has been passed to
the application, the remaining queued input is discarded without generating an
error or warning.
v If PIPE VET NEXT is issued while queued inputs are pending, the results of
PIPE VET NEXT are not returned to the stage until all pending queued inputs
have been passed to the application and inputs have been processed by the
application and the results displayed on the VOST virtual screen.
v A null string (//) does not need to be specified on VET. If you want to send a
PF3 action key to the application running on the VOST without altering any
fields on the virtual screen, you can specify the following statement:
VET PF3
v If VET has both an input stream and a /string/ specified, the /string/ is written to
the panel first, followed by data from the input stream.
v PF and PA keys cannot be specified for action key if the application running on
the VOST allows user-defined PF keys. The BNH150I application field contains
the application name if the application enables the user to define PF keys. If
BNH150I contains a value in the application field, the NetView program rejects