ORIGIN

DEBUG Commands

origin.helpdbg.txt
ORIGIN                                                         DEBUG subcommand

Use the ORIGIN subcommand to set an origin or base address to be used in the
debug environment.

The format of the ORIGIN subcommand is:
+----------+------------------------------------------------------------------+
| ORigin   | 0|symbol|hexloc                                                  |
+----------+------------------------------------------------------------------+
where:

symbol   is a symbolic name that was previously assigned (via the DEFINE
         subcommand) to a storage address.

hexloc   is a hexadecimal location within the limits of your virtual storage.
         If you do not explicitly set an origin, then it has a value of 0.


Usage Notes:

1.  When the ORIGIN subcommand specifies a symbol, the debug symbol table is
    searched.  If a match is found, the value corresponding to the symbol
    becomes the new origin. When a hexadecimal location is specified, that
    value becomes the origin.  In either case, the operand cannot specify an
    address greater than your virtual storage size.

2.  Any origin set by an ORIGIN subcommand remains in effect until another
    ORIGIN subcommand is issued, or until you obtain a new copy of CMS.
    Whenever a new ORIGIN subcommand is issued, the value specified in that
    subcommand overlays the previous origin setting.  If you obtain a new copy
    of CMS (via IPL), the origin is set to 0 until a new ORIGIN subcommand is
    issued.

3.  You can use the ORIGIN subcommand to set the origin to your program's base
    address, and then refer to actual instruction addresses in your program,
    rather than to virtual storage locations.