z/OS TSO/E System Programming Command Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


CONSOLE-CART subcommand

z/OS TSO/E System Programming Command Reference
SA32-0974-00

Use the CART subcommand to set the command and response token (CART). The CART is used to associate commands and their responses. Applications can use the CART with the GETMSG service to retrieve responses to specific command invocations. See z/OS TSO/E Programming Services for information about using the GETMSG programming service and z/OS TSO/E REXX User's Guide for information about using the TSO/E REXX external GETMSG function in a REXX exec.

You can change the CART for different groups of commands or you can make the CART unique for each system command invocation to distinguish the responses.

If the CONSOLE command is used by multiple applications in a single TSO/E user's address space, the CART must be used to ensure that each application retrieves only messages destined for that application. For specific guidelines, see Associating commands and their responses.

The syntax of the CART subcommand is:

 CART cartval
cartval
The command and response token
value:
  • 1-8 alphanumeric characters
  • 1-16 hexadecimal digits
Note:
  1. The CART value is padded to the right with blanks.
  2. If you specify a value that is too long, only the first eight bytes (alphanumeric characters or hexadecimal digits) are kept. Any remaining bytes are truncated. No error message is issued.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014