outtrap()


>>-outtrap--(--+---------------------------+--)----------------><
               '-name-+------------------+-'      
                      '-,max-+---------+-'        
                             '-,catopt-'

Function

Enables or disables the trapping of output from commands run using ADDRESS TSO, and returns the name of the variable in which trapped output is stored. If trapping is off, the word OFF is returned. Note that outtrap does not trap output for ADDRESS SH or any other command environment besides TSO. To trap shell command output, see bpxwunix() .

Parameters

name

The name of a stem, a variable prefix used to contain command output, or the string OFF to turn off trapping.

max

The maximum number of lines to trap. If max is not specified, or if it is specified as * or a blank, the number of lines is set to 999 999 999.

catopt

Specify one of these:

concat: Each command output trapping begins following the previous command output.
noconcat: Output from each command is trapped starting with the variable concatenated with 1. Unused variables do not have their values altered.

For additional information about using the TSO command environment, see The TSO command environment.

Example

To trap TSO command output, use the stem OUT, rewriting the stem on each command:

call outtrap 'out.',,'NOCONCAT'