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

Full-Screen Automation
322 Programming: Pipes
When using VET on subsequent stages, you can specify the data to be written to
the virtual screen, the cursor position where the data is written, and the action key
to be pressed after the data is written to the virtual screen.
For example, ATTACH NPDA creates a VOST running NPDA. The first panel
presented on the virtual screen is NPDA-01A. To request the total events panel
(NPDA-40A):
NETVIEW VET /2/
In this example, a row.col was not specified, so the string /2/ is written to the
VOST in the first unprotected field on the panel at, or after, the current cursor
position. Because NPDA-01A only has one unprotected field, which is the
command line, 2 is written to the unprotected field. The VET action key defaults to
ENTER. After 2 is written to the command line, information is passed to NPDA
indicating that the Enter key was executed on the VOST. NPDA responds to the
VOST as though a human operator entered 2, which is a NPDA subcommand or
selection choice, and pressed the Enter key.
Notes:
1. You can use ENTER, PF, PA, and CLEAR keys as action keys. ENTER is the
default.
2. Using NOKEY as an action key enables you to enter data on the virtual screen,
but indicates that no action is to be taken. This is the same as when a human
operator types data on a panel and does not press an action key, such as Enter,
to indicate to the application that the input is complete.
3. If the application running on the VOST enables dynamic remapping of PF and
PA keys using the NCCF SET command, the PF and PA key action keys cannot
be used on the VET command. Instead, use the command to be executed in the
/string/ with an Enter action key. For example, if the application running on
the VOST can have PF keys remapped and as a default has PF3 set to END,
code VET /END/ ENTER.
Using Delimiters
Delimited strings can be used when VET is a command.
Strings to be written to the virtual screen must be enclosed in delimiters. 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 VET. The delimited
string ends when the same character is encountered a second time.
If you want to execute an action key on the VOST without entering data on the
virtual screen, specify either a null string with two delimiters with no space
between them or omit the /string/ altogether. For example, if you want to press
PF8 without entering data on a panel, code either of the following statements:
NETVIEW VET // PF8
VET PF8
Writing in Protected Fields
After a string is written to a panel on the virtual screen, the cursor is moved to the
next field on the panel. If you attempt to write a string to a protected field, the
cursor moves to the next unprotected field before writing the data. If there are no
more unprotected fields, the cursor wraps back to the top of the panel and finds
the first unprotected field and writes the data. Strings are truncated if they are
longer than the unprotected field in which they are written.