Syntax


OR[n]

ORR / ORR

ORR is the block form of this command.


Operands


n

The number of lines to be overlay-replaced. If you do not type a number, the default is 1.


Description

The Overlay-Replace line command operates similar to the standard Overlay line command, with a slight difference. Overlay-Replace is used to unconditionally overlay data from the ‘sending' lines to the ‘receiving' lines.


The standard Overlay line command takes a set of one or more ‘sending' lines and overlays them on top of a set of one or more ‘receiving' lines. Sending lines are marked by C/CC or M/MM line commands, and receiving lines are marked by O/OO or O&/OO& line commands. (The & versions are persistent variants of the standard O and OO commands).


In the standard Overlay, non-blank characters in the sending lines overlay only blank characters in the receiving lines, on a character by character basis. 


For Overlay-Replace command, the overlay is performed regardless of whether the position in the receiving line is blank or not.



O/OO Examples


Before:


O 0001 A CD

C 0002 ABX


After: (no message issued)


000001 ABCD

000002 ABX


Before:


O 0001 A CD

M 0002 ABX


After: (message:  MOVE data not deleted – all data not overlaid,  line 2 not deleted)


000001 ABCD

000002 ABX


OR/ORR Examples


Before:


OR 001 A CD

C 0002 ABX


After: (no message issued)


000001 ABXD

000002 ABX


Before:


OR 001 A CD

M 0002 ABX


After: (no message issued, line 2 is gone)


000001 ABXD                because line 2 is moved over line 1



See O / OO - Overlay Lines for an Application Note regarding use of excluded lines when performing an overlay.