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

PIPE VET
Note: For any field of data that has an intensity attribute of DARK (ID), the
entire returned field information has presentation attribute of DARK. As
a result, the data cannot be displayed. One way to see the data is to use
a COLOR NORMAL stage subsequent to the VET stage.
NAME
Specifies the name of the VOST. NAME must correspond to the NAME on the
ATTACH command that created the VOST or attach name. VET NAME
indicates that the VET stage is to interact with the named VOST.
If a VOST was created by the ATTACH command without a NAME, the VOST
is dependent on the invoking procedure. In the case of a dependent ATTACH,
if you code VET without specifying a NAME, VET interacts with only one
VOST: the VOST created by the ATTACH command within the same procedure
as the VET stage. NAME must be specified if VET is to interact with an
independent VOST, that is, a VOST created outside of the procedure family.
NAME must be specified if VET is to interact with an independent VOST, that
is, a VOST created outside of the procedure family.
NEXT
Specifies that the next update to the virtual screen is to be returned to the
stage. This update can either be currently pending or can be received at a
future point in time when the application next updates the virtual screen.
Specify CORRWAIT as the next stage after VET NEXT. CORRWAIT
automatically ends when:
v The application running on the VOST is ready for input.
v The application terminates.
For additional information on CORRWAIT, see “PIPE CORRWAIT ” on page
54.
In general, VET NEXT does not return a complete screen image. Only the parts
of the virtual screen sent by the application as the screen updates are returned.
Depending on the application, all or part of the virtual screen can be updated.
ROWS
Specifies that the data displayed on the virtual screen is to be returned to the
stage as a series of 24 lines of 80 characters each following the BNH150I
message header. Positions on the virtual screen occupied by start field orders
are blank (X'40'). When using VET NEXT ROWS, those screen positions not
updated by the application running on the VOST contain X'FF' characters.
Note: For any row of data that contains any field with an attribute of DARK,
the returned row has a presentation attribute of DARK. As a result, the
data is not displayed. One way to see the data is to use a COLOR
NORMAL stage subsequent to the VET stage.
For additional information about start field orders, refer to the 3270
Information Display System library.
ROW.COL
Specifies the starting row and column on the virtual screen where the data
specified by the input stream or /string/ is to be written. If ROW is specified
without COL, the default value of 1 is used for COL.
If ROW.COL is not specified, VET writes the data specified in the input stream
/string/ beginning at the current cursor position on the VOST virtual screen. If
the current cursor position is in a protected field, VET simulates a tab to the
next unprotected field and writes the data beginning in that unprotected field.
Chapter 2. Pipeline Stages and Syntax 263