Testing A Program - IBM System 360 User Manual

Testing a Program
The operating system provides you with facilities to test your program
from the terminal. They are the test facilities, if any, provided by
your compiler, ~nd the TSO TEST command. The compiler test faciliti~
are described in the publications associated with the compiler. A brief
description of the TEST command follows.
The TEST command allows you to "debug" your program. That is, it
helps you to test a program for proper execution and to find programming
errors. To use TEST effectively, you should be familiar with the
assembler language. If you are using another language, for example
COBOL, you can still use the TEST command to obtain listings and other
information to give to your installation's system programmer who can
help you debug your program. (You can use the full facilities of the
TEST command to debug your program if you can correlate the statements
in your source program listing to the resultant assembler language
statements in the object listing.)
If you are an assembler language programmer, refer to the
publications" TSO Guide to Writing a Terminal Monitor Program or a
Command Processor and Command Language Reference for a complete
description of the facilities of the TEST command.
If you are not an assembler language programmer, your system
programmer will probably provide you with a· test procedure. The most
common situation he may provide for occurs when your program is
executing and you receive a message that the program has abnormally
terminated,. He may tell you to enter the TEST command and then the LOAD
subcommand with the name of a program that will test your program. For
example, if the name of the program that will test yours is DPTEST, use
the following sequence,.
READY
test
TEST
load (dptest)
If the system programmer does not give you the name of a testing
program, he may instruct you to use the TEST command and a set of its
subcommands that produce listings of your program and other pertinent
information. For example, he could ask you to perform procedures
similar to the following,.
Example 1:
READY
test
TEST
listpsw
SYSTEM MASK KEY AMWP INTRPT CODE ILC CC PROG MASK INSTR ADDR
11111111 D 0101 0061 11 00 0000
061A~8
TEST
where 61ab8.
61AB8,. LOCATED AT +38 IN (load-module name.csectname) UNDER TCB
LOCATED AT 660DO.
TEST
list 61ab8·.-32n length(32)
First" you begin testing by entering the TEST command. You can now use
the subcommands of TEST to "debug" your program.
Testing a Program 19