Previous Page | Next Page

Windows and Commands in z/OS Environments

TSO Command: z/OS

Issues a TSO command or starts a CLIST or a REXX exec from the command line.
z/OS specifics: all

See Also


TSO <command>


The TSO command is similar to the TSO (or X) statement, the TSO (or SYSTEM) CALL routine, the TSO (or SYSTEM) function, and the %TSO (or %SYSEXEC) macro statement. It accepts the following argument:


is a system command. Under z/OS, "system command" includes TSO commands, CLISTs, and REXX execs.

To submit a TSO command, or to invoke a CLIST or a REXX exec, use the TSO command form of the command. You can use the TSO command from the command line of any window. SAS executes the TSO command immediately.

Under z/OS, TSO is an alias for the X command. On other operating environments, the TSO command has no effect, whereas the X command is always processed.

You can use the TSO command to issue most TSO commands or to execute CLISTs or REXX execs. However, you cannot issue the TSO commands LOGON and LOGOFF, and you cannot execute CLISTs that include the TSO ATTN statement. Nor can you issue authorized commands, such as some RACF commands; however, you can use the TSOEXEC command to issue authorized commands, as in this example:


You can also use the TSO command to go into TSO submode from within a SAS session. To start the submode, enter TSO from the command line without specifying a TSO command. When the command is executed, SAS goes into TSO submode and prompts you for TSO commands. Any commands that you enter in TSO submode are processed by TSO, not by the windowing environment. They can be any length; however, if the command is longer than one line, you must enter a TSO continuation symbol.

In addition, you can use the TSO command to issue the following UNIX System Services shell commands: cd, pwd, and umask. The shell command names must be specified in lowercase.

To return to the SAS session, enter RETURN , END , or EXIT . Any characters that follow the RETURN, END, or EXIT subcommand are ignored. An END command that occurs within a CLIST terminates the CLIST without ending the TSO submode.

Note:   The TSO command processor does not know when or if it is invoking an interactive windowing application. To avoid problems with screen clearing, you might want to invoke ISPF, IOF, or similar facilities directly. For example:

tso ispf

This method works only if you invoked SAS from the TSO READY prompt. It does not work if you were already in ISPF when you invoked your current SAS session.  [cautionend]

See Also

Previous Page | Next Page | Top of Page