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

write-type
The write-type is either WRITE or ERASE-WRITE. Write-type indicates the
action taken by the application running on the VOST when updating the
panel. WRITE indicates that changes were made to the panel, but the panel
was not totally rewritten. ERASE-WRITE indicates that the panel was
erased and rewritten.
row.col The starting row and column of the options. This is also the current cursor
position on the virtual screen.
options Can be BEEP, LOCK, or both. Options indicates whether the terminal beep
is sounded or the panel is locked from input.
Reference: For more information about 3270 data stream attributes, refer to the
3270 Information Display System library.
For example, if you use the following code in your full-screen automation
application:
ATTACH NPDA
PIPE (NAME BADCOM)
|VET NEXT FIELDS
...
Stages to process returned panel
...
NETVIEW VET /BAD COMMAND/
PIPE (NAME GETPANEL)
|VET NEXT FIELDS
|CONSOLE
A VOST starts running NPDA. BAD COMMAND is entered on the command line.
Because BAD COMMAND is not a valid command, NPDA returns an error. VET NEXT
FIELDS returns only those fields that have changed. In this example, the following
text is displayed on the console:
BNH150I FIELDS/NEXT OUTPUT FOR ’NPDA’ RECEIVED FROM NPDA
WRITE 24.8 BEEP
22.1 FA IN % BNJ905I INVALID COMMAND ENTERED OR INCORRECT OPERANDS
23.1 FA IN %
23.80 FA IH % CMD==>
24.8 FI IH % BAD COMMAND
Figure 20. Example Screen for VET NEXT FIELDS
Full-Screen Automation
The BNH150I message header line indicates that the message results from VET
NEXT FIELDS from a VOST running NPDA. WRITE 24.8 BEEP shows that the
panel was updated without first being erased and that the 3270 data stream BEEP
command was issued. The next four messages show the fields that were changed
by NPDA. The field beginning at row 22 column 1 shows the message that was
displayed on the virtual screen as a result of the command. The other fields show
the changed fields resulting from VET /BAD COMMAND/.
The following example shows a BNH150I message after an ATTACH command
with the COLOR option. Note that the Cz and Ha information is included
indicating color and highlighting for each field:
* NTV7E TOM ATTACH (ACTION=’PIPE VET CURRENT FIELDS|CONS’,COLOR) HELP
* NTV7E TOM PIPE VET CURRENT FIELDS|CONS
’ NTV7E TOM
Chapter 5. Full-Screen Automation 327