A Tutorial Using the TEST Command

This chapter is presented in tutorial form, and is intended for TSO/E users who have never used the TEST command to test a program. Before reading this chapter, you must be familiar with the concepts and terminology presented in Testing a Program.

This tutorial describes how to use TEST subcommands to test and debug a program. If you are an authorized user, you can use the TESTAUTH command to test authorized programs. Because TESTAUTH supports the same subcommands as TEST, you can use this tutorial to learn about using TESTAUTH.

This tutorial describes how to use the following subcommands:

Task	Subcommands
View storage and registers	LIST, LISTMAP, LISTPSW, LISTDCB, LISTDEB, LISTTCB, LISTVP, LISTVSR
Find addresses	WHERE
Control breakpoints	AT, OFF
Alter storage and registers	COPY, assignment of values function (=)
Alter vector registers	SETVSR
Add and alter symbols	EQUATE, DROP
Modify a base address	QUALIFY
Control program execution	GO, CALL, RUN
Obtain and free additional storage	GETMAIN, FREEMAIN
Obtain and free other programs	LOAD, DELETE
Obtain help information	HELP
Terminate a TEST session	END, RUN

The TEST subcommands use the address types described in Addressing Conventions Associated with TEST and TESTAUTH. This tutorial shows you how to use the following address forms and their notation:

Table 1. Address Forms Supported by TEST
Address Form	Notation
Single address	A single address.
Range of addresses	Two addresses separated by a colon.
List of addresses	Addresses enclosed in parentheses, and separated by blanks or commas.

The tutorial is presented in the following sequence:

Preparing to Use TEST describes how to assemble and link-edit your program, and how to invoke TEST, run the program, and terminate the TEST session.
Viewing a Program in Storage shows several examples using the LIST subcommand to view registers and storage. It also shows how to use the different forms and types of addresses TEST supports.
Monitoring and Controlling Program Execution shows you how to use breakpoints with the AT, GO, and OFF subcommands.
Altering Storage and Registers illustrates the use of the assignment function and the COPY subcommand for altering storage to set up test cases.
Using Additional Features of TEST shows you how to use the specialized LIST subcommands: LISTMAP, LISTPSW, LISTDCB, LISTDEB, and LISTTCB. Also, it further demonstrates the use of the WHERE subcommand, and introduces the QUALIFY and EQUATE subcommands.

More TEST Subcommands follows the tutorial and describes the uses of the GETMAIN, FREEMAIN, LOAD, DELETE, and CALL subcommands. Testing Programs That Use the Vector Facility discusses how to test programs that use vector registers and elements.