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

Full-Screen Automation
ATTACH CMD DUMP
For the NetView commands NAME and DUMP, you can define a CMDSYN
or embed the commands in a REXX procedure.
Detaching VOSTs
VOSTs can be detached explicitly or implicitly. In most cases, it is not necessary to
explicitly detach a VOST. As described in “Attaching VOSTs” on page 319, if a
VOST was created without a NAME on the ATTACH command, the VOST is
detached when the procedure group terminates.
Interacting with Virtual OSTs
320 Programming: Pipes
However, both named and unnamed VOSTs can be explicitly detached using the
DETACH command. DETACH is the same as a LOGOFF on an end-user terminal.
The simplest form of the DETACH command is:
DETACH
Note: A DETACH with no keywords detaches one VOST. Do not use DETACH
without a name if you have more than one VOST created within the
procedure group. An unnamed DETACH, in the case of multiple VOSTs in a
procedure group, can cause unpredictable results. The VOST intended might
not be detached.
If a name was not specified on an ATTACH, you can still detach using a DETACH
NAME. Default attach names are the same as the command name. So, you can
code: DETACH NPDA if you previously coded: ATTACH NPDA
You can also use the STOP FORCE command to terminate a VOST. However, STOP
FORCE can end the VOST before all VOST processing completes. You can get
unpredictable results.
After starting the application using the ATTACH command, you are ready to
interact with the application running on the VOST. The VET command and PIPE
stage are used to communicate with a VOST.
Hint: VOSTIO is synonymous with VET.
VET has two forms: a first stage form and a form that can be used as a subsequent
stage or a command.
In both forms, the NAME keyword on the VET command permits interaction with
a specific VOST if you have more than one VOST attached. The parameter
specified on VET NAME must match the default name or the name specified on
the NAME keyword of the ATTACH command. For example, if you attached two
VOSTs using the following commands:
ATTACH NAME VOST1 NPDA
ATTACH NLDM
The first ATTACH creates an independent VOST named VOST1 running NPDA.
The second creates an unnamed, dependent VOST running NLDM. If you want to
interact with the NPDA application, include NAME VOST1 in your VET stage
specification.