Aug 1, 1979 COMMANDS TO COLLECT AND ANALYZE SYSTEM INFORMATION This section discusses five commands to collect and analyze
information when you are debugging. These are theADSTOP and
commands and theLOCATE, MONITOR, and TRACE commands.
syste m
BEGIN
TheADS TOP command stops the execution of a virtual machine at a
specific address; causes the virtual machine to resume execution.
Execution halts when the instruction at the address specified in theADSTOP command is reached. At this point, you may invoke other CP debugging commands.
The address stop should be set after the program is loaded but before
it executes. When the specified location is reached during program
execution, execution halts and theCP command environment is entered. You may then enter other CP commands to examine and alter the status of
the program.Set an address stop at a location where you suspect the error in the
program.You can then display the registers, control words, and data
areas to check the program at that point in its execution. This
procedure helps you locate program errors.You may be able to alter the
contents of storage in such a way that the program will execute
correctly.You can then correct the error you have detected and, if
necessary, compile and execute the program again.
To successfully set an address stop, the virtual instruction address
must be in real storage at the time theADSTOP command is issued. Use the LOCATE command to find the address of CP control blocks
associated with a particular user, a user's device, or a real system
device. The control blocks and their functions are described in theXnLllQ £Qnt£Ql Blg£! Logic. Once you know the location of the control blocks, you can examine (DUMP or DISPLAY) the block you want to look at. When you want to
examine specific control blocks, use theLOCATE and DUMP or DISPLAY commands to examine the control blocks instead of taking a dump. A
discussion of the most important fields of theVMBLOK, VCUBLOK, VDEVBLOK, RCHBLOK, RCUBLOK, and RDEVBLOK are included in "Reading CP Abend Dumps." COMMANDS THAT TRACE EVENTS IN VIRTUAL MACHINES Use the TRACE command to trace the following virtual machine events: • SVC interruption • I/O interruption • Program interruption • External interruption 40 System Programmer's Guide
information when you are debugging. These are the
commands and the
syste m
BEGIN
The
specific address;
Execution halts when the instruction at the address specified in the
The address stop should be set after the program is loaded but before
it executes. When the specified location is reached during program
execution, execution halts and the
the program.
program.
areas to check the program at that point in its execution. This
procedure helps you locate program errors.
contents of storage in such a way that the program will execute
correctly.
necessary, compile and execute the program again.
To successfully set an address stop, the virtual instruction address
must be in real storage at the time the
associated with a particular user, a user's device, or a real system
device. The control blocks and their functions are described in the
examine specific control blocks, use the
discussion of the most important fields of the