POI Command Processors › OPSCMD Command Processor—Issue z/OS, JES, VM, and IMS Commands › CLIST Variables That TSO/E Creates

CLIST Variables That TSO/E Creates

Under TSO, if the variable &SYSOUTTRAP has a value greater than zero, the first n lines of command output (where n is the value of &SYSOUTTRAP) go into CLIST variables called &SYSOUTLINEx (x is the line number).

Note: These variables are not created if the OPSCMD command processor includes the CMDRESP(REXX) or CMDRESP(CLIST) keyword. For more information, see CMDRESP Keyword in this chapter.

Typical &SYSOUTTRAP values range from 1 to several thousand. When TSO/E captures command output, it also sets the variable &SYSOUTLINE to the number of &SYSOUTLINEx variables it created. You must do the following:

• Copy the value of &SYSOUTLINE into a separate CLIST variable before your CLIST does any further processing. You must copy the &SYSOUTLINE value because the next TSO command in the CLIST will reset it.
• Set &SYSOUTTRAP to zero immediately so that output from a subsequent command does not overlay the CLIST variables just created.

CLIST variables that OPSCMD creates exist until you delete them. Thus, issuing an OPSCMD that generates 100 lines of output creates variables &SYSOUTLINE1 through &SYSOUTLINE100. If you issue another OPSCMD that produces 10 output lines, &SYSOUTLINE1 through &SYSOUTLINE10 contain the new output lines, while &SYSOUTLINE11 through &SYSOUTLINE100 contain the rest of the output of the previous command.