SET

DEBUG Commands

set.helpdbg.txt
SET                                                            DEBUG subcommand

Use the SET subcommand to change the contents of the control words and general
registers.

The format of the SET subcommand is:
+----------+------------------------------------------------------------------+
| SET      | CAW hexinfo                                                      |
| SET      | CSW hexinfo [hexinfo]                                            |
| SET      | PSW hexinfo [hexinfo]                                            |
| SET      | GPR reg hexinfo [hexinfo]                                        |
+----------+------------------------------------------------------------------+
where:

CAW hexinfo
         stores the specified information [hexinfo] in the CAW (channel address
         word) that existed at the time the debug environment was entered.

CSW hexinfo [hexinfo]
         stores the specified information [hexinfo [hexinfo]] in the CSW
         (channel status word) that existed at the time the debug environment
         was entered.

PSW hexinfo [hexinfo]
         stores the specified information [hexinfo [hexinfo]] in the old PSW
         (program status word) for the interruption that caused the debug
         environment to be entered.

GPR reg hexinfo [hexinfo]
         stores the specified information [hexinfo [hexinfo]] in the specified
         general register (reg).


Usage Notes:

1.  The SET subcommand can only change the contents of one control word at a
    time.  For example, you must issue the SET subcommand three times:
       set caw hexinfo
       set csw hexinfo [hex]
       set psw hexinfo [hex]
    to change the contents of the three control words.

2.  The SET subcommand can change the contents of one or two general registers
    each time it is issued.  When four or fewer bytes of information are
    specified, only the contents of the specified register are changed.  When
    more than four bytes of information are specified, the contents of the
    specified register and the next sequential register are changed.  For
    example, the SET subcommand:
       set gpr 2 xxxxxxxx
    changes only the contents of general register 2.  But, the SET subcommand:
       set gpr 2 xxxxxxxx xxxxxxxx
    changes the contents of general registers 2 and 3.

3.  Each hex operand should be from one to four bytes long.  If an operand is
    less than four bytes and contains an uneven number of hexadecimal digits
    (representing half-byte information), the information is right-justified
    and the left half of the uneven byte is set to zero.  If more than eight
    hexadecimal digits are specified in a single operand, the information is
    left-justified and truncated on the right after the eighth digit.

4.  The number of bytes that can be stored using the SET subcommand varies
    depending on the form of the subcommand.  With the CAW form, up to four
    bytes of information may be stored.  With the CSW, GPR, and PSW forms, up
    to eight bytes of information may be stored, but these bytes must be
    represented in two operands of four bytes each.  When two operands of
    information are specified, the information is stored in consecutive
    locations (or registers), even if one or both operands contain less than
    four bytes of information.