z/OS V1R9.0 TSO/E Command Reference

TEST CommandNote: LUA is the LU used for testing. Also, the transaction program and itsremaining conversations are cleaned up by TEST when TEST terminatesbecause the KEEPTP keyword is not specified. See z/OS TSO/EProgramming Guide, for more information about testing an APPC/MVStransaction program.TEST subcommands (overview)The following are TSO/E commands you can use in the TEST environment:ALLOCATE EXEC LISTALC LISTDS RENAME SUBMITATTRIB HELP LISTBC PROFILE SEND TERMINALCANCEL LINK LISTCAT PROTECT STATUS UNALLOC (FREE)The preceding commands are described with the TEST subcommands inalphabetical order. For a complete description of the syntax and function of thoseTSO/E commands that you can use in the TEST environment, see thecorresponding TSO/E command.Use the various TEST subcommands to perform the following basic functions:v Execute the program from its starting address or from any address within theprogram.v 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 accessregisters cannot be specified for indirect addressing or address expressions, youcan use access registers as you need to general registers.v Interrupt the program at specified locations. After you have interrupted theprogram, you can display areas of the program or any of the registers, or youcan issue other subcommands of TEST to be executed before returning controlto the program being tested.v Change the contents of specified program locations in virtual storage or thecontents of specific registers.For a discussion on how to use these basic functions, see z/OS TSO/EProgramming Guide. The subcommands of the TEST command and the TSO/Ecommands you can use in the TEST environment are:Table 52. Subcommands and functions of the TEST commandALLOCATE Dynamically allocates the data sets required by a program intendedfor execution.AND Performs a logical AND operation on data in two locations, placingthe results in the second location specified.ASSIGNMENT OF Modifies values in virtual storage and in registers.VALUES(=)AT Establishes breakpoints at specified locations.ATTRIB Builds a list of attributes for non-VSAM data sets, which are to bedynamically allocated.CALL Initializes registers and initiates processing of the program at aspecified 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 thesymbol table of the module being tested.END Terminates all operations of the TEST command and the programbeing tested.Chapter 1. TSO/E commands and subcommands 287