hercules_commands_r

=Hercules Commands - r - Display / Alter Storage=

The r command allows you to display or alter real storage.

R {addr | addr.length | addr-addr | addr=value}

Examples :

1) Display storage at address x'2000 :
 * r 2000**

R:00002000:K:00=00000000 00000000 00000000 00000000 R:00002010:K:00=00000000 00000000 00000000 00000000 R:00002020:K:00=00000000 00000000 00000000 00000000 R:00002030:K:00=00000000 00000000 00000000 00000000 2) Display 8 bytes of storage starting at address x'2000 :

R:00002000:K:00=00000000 00000000 00000000 00000000
 * r 2000.8**

3) Alter storage at addresses x'2000', x'2001'


 * r 2000= 05 C0

r 2000.1** Even though a length of 1 was specified, a minimum of 16 bytes is always displayed.


 * R:00002000:K:06=05C00000 00000000 00000000 00000000 .{..............

**

Alter Storage tricks & Tips
** 1) When altering storage there cannot be any whitespace between the address and the '=' sign. **

E.g.
 * r 2000= 05 C0** * Ok *


 * r 2000 = 05 c0**


 * HHCPN144E Invalid operand: 2000 = 05 c0

2) Data bytes to be entered must be entered in pairs of hex digits : **


 * r 2000= 0 5 c 0**


 * HHCPN143E Invalid value: 5 c 0

3) As per #2, entering pairs of hex digits implies that an even number of data bytes must be entered.

E.g. Filling / clearing an area of memory :

r 2000=000000000000000000000000000000000000000000000000000000000000000000

Just hold down the '0' key or whatver value you want to use, if you get 'Invalid value', press the up-arrow key to recall / repeat the command and add one more hex digit to the end **