TEST subcommands (overview)

The following are TSO/E commands you can use in the TEST environment:

ALLOCATE   EXEC       LISTALC    LISTDS     RENAME   SUBMIT
ATTRIB     HELP       LISTBC     PROFILE    SEND     TERMINAL
CANCEL     LINK       LISTCAT    PROTECT    STATUS   UNALLOC (FREE)

The preceding commands are described with the TEST subcommands in alphabetical order. For a complete description of the syntax and function of those TSO/E commands that you can use in the TEST environment, see the corresponding TSO/E command.

Use the various TEST subcommands to perform the following basic functions:

Execute the program from its starting address or from any address within the program.
Display selected areas of the program as they currently appear in virtual storage, or display the contents of any of the registers. With the exception that access registers cannot be specified for indirect addressing or address expressions, you can use access registers as you need to general registers.
Interrupt the program at specified locations. After you have interrupted the program, you can display areas of the program or any of the registers, or you can issue other subcommands of TEST to be executed before returning control to the program being tested.
Change the contents of specified program locations in virtual storage or the contents of specific registers.

For a discussion on how to use these basic functions, see z/OS TSO/E Programming Guide. The subcommands of the TEST command and the TSO/E commands you can use in the TEST environment are listed in Table 56:

Table 1. Subcommands and functions of the TEST command
Subcommand	Function
ALLOCATE	Dynamically allocates the data sets required by a program intended for execution.
AND	Performs a logical AND operation on data in two locations, placing the results in the second location specified.
ASSIGNMENT OF VALUES(=)	Modifies values in virtual storage and in registers.
AT	Establishes breakpoints at specified locations.
ATTRIB	Builds a list of attributes for non-VSAM data sets, which are to be dynamically allocated.
CALL	Initializes registers and initiates processing of the program at a specified address using the standard subroutine linkage.
CANCEL	Halts processing of batch jobs submitted for the terminal.
COPY	Moves data.
DELETE	Deletes a load module from virtual storage.
DROP	Removes symbols established by the EQUATE command from the symbol table of the module being tested.
END	Terminates all operations of the TEST command and the program being tested.
EQUATE	Adds a symbol to the symbol table and assigns attributes and a location to that symbol.
EXEC	Executes a CLIST or REXX exec.
FREEMAIN	Frees a specified number of bytes of virtual storage.
GETMAIN	Acquires a specified number of bytes of virtual storage for use by the program being processed.
GO	Restarts the program at the point of interruption or at a specified address.
HELP	Lists the subcommands of TEST and explains their function, syntax, and operands.
LINK	Invokes the binder or the linkage editor service program.
LIST	Displays the contents of a virtual storage area or registers.
LISTALC	Displays a list of the names of data sets allocated during the current TSO/E session.
LISTBC	Displays a listing of the contents of the broadcast data set or a user log data set, which contains messages of general interest (NOTICES) and messages directed to a particular user (MAIL).
LISTCAT	Lists catalog entries by name or entry type; lists selected fields for each entry.
LISTDCB	Lists the contents of a data control block (DCB). You must specify the address of the DCB.
LISTDEB	Lists the contents of a data extent block (DEB). You must specify the address of the DEB.
LISTDS	Displays attributes of specific data sets at the terminal.
LISTMAP	Displays a map of the user's virtual storage.
LISTPSW	Displays a program status word (PSW).
LISTTCB	Lists the contents of the current task control block (TCB). You can specify the address of another TCB.
LISTVP	Displays the partial sum number and the vector section size of a vector machine.
LISTVSR	Displays the vector status register (VSR™).
LOAD	Loads a program into virtual storage for execution.
OFF	Removes breakpoints.
OR	Performs a logical OR operation on data in two locations, placing the results in the second location specified.
PROFILE	Establishes, changes, or lists the user profile.
PROTECT	Controls unauthorized access to a non-VSAM data set.
QUALIFY	Establishes the starting or base location for resolving symbolic or relative addresses; resolves identical external symbols within a program.
RENAME	Changes the name of a non-VSAM cataloged data set or a member of a partitioned data set (PDS) or creates an alias for a member of a PDS.
RUN	Terminates TEST and completes execution of the program.
SEND	Sends a message to another terminal user or to the system operator.
SETVSR	Sets fields in the vector status register.
STATUS	Displays status of batch jobs at terminal.
SUBMIT	Submits one or more batch jobs for processing.
TERMINAL	Defines the operating characteristics for the terminal being used.
UNALLOC	Frees data sets under TSO/E TEST. Because FREE is an alias for the FREEMAIN subcommand, use UNALLOC to free files under TEST.
WHERE	Displays the virtual address of a symbol or entry point, or the address of the next executable instruction. WHERE can also be used to display the module and CSECT name and the displacement into the CSECT corresponding to an address.