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

Attaching and Detaching Virtual OSTs
The NetView program provides an ATTACH command to create VOSTs and a
DETACH command to explicitly end VOSTs. An ATTACH command must be
executed in the code before the VET stage or command.
Attaching VOSTs
VOSTs, and the applications running on them, are started using the ATTACH
command. The simplest form of command that starts a VOST to run NPDA code
is:
ATTACH NPDA
Full-Screen Automation
An ATTACH command, without a name, creates a VOST that is dependent on the
procedure group. A dependent VOST terminates after all procedures in the
procedure group terminate except under the following conditions:
v A DETACH command for the VOST is included within the procedure group.
v The command running on the VOST terminates.
In both conditions, the VOST detaches before all the procedures in the procedure
group terminate.
A name must be specified on the ATTACH command to create an independent
VOST. For example, to start an independent VOST named RUN$NPDA running
NPDA, code:
ATTACH NAME RUN$NPDA NPDA
The RUN$NPDA VOST continues to run until NPDA terminates or the VOST is
specifically terminated using the DETACH command.
VOST names can be 1-8characters in length and must only contain uppercase
and lowercase alphabetic characters, numbers, or the characters @, #, and $.
Note:
v Some commands are not valid for ATTACH. See the NetView online help for the
ATTACH command for a list of commands that are not valid.
v VOSTs are accessible only from the owning task. In addition, dependent VOSTs
are accessible only from the procedure family in which they were attached.
v The attached command is checked against the authority of the owner of the
VOST.
v If you want to use NAME or DUMP as the NetView command running on the
VOST, consider:
– If the NetView command you want to run on the VOST is NAME, you cannot
code:
ATTACH NAME
However, you can use the CMD command to start the NetView command
NAME. For example:
ATTACH CMD NAME
To attach a VOST called NAME that can run the NetView NAME command,
code:
ATTACH NAME NAME NAME
– If the NetView command you want to run on the VOST is DUMP, and you do
not want to use the ATTACH DUMP keyword, you can use the CMD
command to start NetView DUMP:
Chapter 5. Full-Screen Automation 319