How to Use This Tutorial

This tutorial is presented in a two-page format. The left-hand pages contain sample terminal sessions. Information that you enter at the terminal is in lower case; the responses from TSO/E are in upper case. The right-hand pages contain explanations of the sample terminal sessions.

To use this tutorial at your terminal, enter the commands shown on the sample terminal sessions (left-hand pages) and, at the same time, read the corresponding explanations on the right-hand pages. Numbers provide a cross-reference from the sample terminal sessions to the explanations.

You will need copies of the sample programs that are supplied in SYS1.SAMPLIB, along with their corresponding object files. The table below shows the members of SYS1.SAMPLIB that contain the source and object data used in this tutorial.

Source Member	Object Member
IKJSAMP1	IKJOBJ1
IKJSAMP2	IKJOBJ2

To use this tutorial at your terminal, create a data set called ‘prefix.SAMPLE1.ASM’ that is a sequential data set of one track, with DCB characteristics of RECFM=FB, LRECL=80, BLKSIZE=3120. Copy the source code from ‘SYS1.SAMPLIB(IKJSAMP1)’ into your data set.

Note: The source code and the assembler listings for the sample programs used in this tutorial are also shown in Example programs for the TEST tutorial.

This tutorial guides you through:

Using the subcommands of TEST to:
- Change the contents of general purpose registers.
- Control the execution of a program including the re-execution of instructions.
- Change the contents of main storage variables and buffers.
- Assign names to main storage locations.
- Obtain and free additional main storage, as needed.
- Locate the real address of your program.
- List the PSW.
Using the various methods of addressing main storage under TEST.