DEBUG                                                       CMS Nucleus command

Use the DEBUG command to enter the debug environment from the CMS environment.
In the debug environment you can use a variety of DEBUG subcommands that allow
you to test and debug your programs.  The format of the DEBUG command is:
+----------+------------------------------------------------------------------+
| DEBUG    |                                                                  |
+----------+------------------------------------------------------------------+

Debug subcommands:

The following subcommands are avaiable when you enter the debug environment:

BREAK    Stop execution of a program at a symbol or address.
CAW      Display the CAW (Channel Address Word).
CSW      Display the CSW (Channel Status Word).
DEFINE   Assign a symbolic name to a storage address.
DUMP     Print virtual storage on the printer.
GO       Exit the debug evironment and resume program execution.
GPR      Display contents of the General Purpose Registers.
HX       Exit the debug envionment and halt program execution.
ORIGIN   Set a base address for use in the debug environment
PSW      Display the PSW (Program Status Word).
RETURN   Exit the debug enfironment.
SET      Set the value of the CAW, CSW, PSW, or a GPR.
STORE    Store values in virtual storage.
X        Display the contents of virtual storage.

For help on any subcommand, enter HELP DEBUG subcommand.


Usage notes:

1.  The debug environment is also entered as a result of an external
    interruption or the result of a breakpoint (address stop) encountered
    during program execution.

2.  Once you are in the debug environment, you can enter only DEBUG subcommands
    and CP commands via the #CP function.

3.  To return to the CMS environment, enter the DEBUG subcommand RETURN.

Responses:

DMSDBG728I    Debug entered
    This message indicates that you are in the debug environment.