z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

tso
Examples
a mini-TSO/E environment is to be established, use environment variables
to specify the allocations that you need.
If you do not specify an option, the following rules determine how to run the TSO/E
command:
v If stdout is not a tty, the TSO/E service routine is used because it is possible
that the command output will be redirected to a file or piped to another
command.
v If the controlling tty supports 3270 passthrough mode, the OMVS interface is
used.
v If neither is applicable, then the TSO/E service routine is used.
1. To use OPUT to copy a file to a file in your current directory, issue:
tso –t "oput source.c(hello) 'hello.c' "
If you do not specify –t, the command is run in your TSO/E session through
OMVS, if possible. This copies the file to a file relative to the working directory
of your TSO/E session, which is usually your home directory.
Quotes are used around the command to avoid shell parsing.
2. To use OPUTX to copy all members of a PDS to your current directory, issue:
tso –t "oputx source.c . lc suffix(c)"
If you do not specify the –t option, the command is run in your TSO/E session
through OMVS, if possible. This copies the file to a file relative to the working
directory of your TSO/E session which is usually your home directory.
Quotes are used around the command to avoid shell parsing.
Since OPUTX uses ISPF, allocations for the ISPF DD names must be
performed to run this command. The following is an example of the environment
variables that are set to perform these allocations. This can be included in your
.profile for convenience. Make sure the export statements start in column one.
The data set names may differ on your system.
# Assign the DD names to allocate
#
export TSOALLOC=ispprof:ispplib:ispmlib:isptlib:ispllib:ispslib:\
isptabl:isplog:sysexec
#
# Allocate an empty, temporary ISPF profile data set
#
export ispprof="alloc new unit(sysvio) space(1,1) cyl dir(5) \
recfm(f,b) lrecl(80) blksize(3120)"
#
# Allocate an empty, temporary ISPF table data set
#
export isptabl="alloc new unit(sysvio) space(1,1) cyl dir(5) \
recfm(f,b) lrecl(80) blksize(3120)"
#
# Allocate the ISPF log to SYSOUT
#
export isplog="alloc sysout(a) recfm(v,a) lrecl(125) blksize(129)"
#
# Allocate the OpenMVS and ISPF panel data sets to ISPPLIB
#
export ispplib=SYS1.SBPXPENU:SYS1.ISP.SISPPENU
#
# Allocate the OpenMVS and ISPF message data sets to ISPMLIB
#
710 z/OS V1R9.0 UNIX System Services Command Reference