(Type: immediate)
Syntax 1
<$.MOVE option>
── $.MOVE ──<first>── - ──<last>── TO ──<baseinc>──────────────────────┤
Syntax 2
<$.MOVE option>
── $.MOVE ──<first>── TO ──<baseinc>───────────────────────────────────┤
. . . <patch records to the moved material> . .
── $. ─┬─ POP ───┬─ MOVE ──<last>──────────────────────────────────────┤
└─ RESET ─┘<baseinc>
──┬─ <base> ─┬─┬──────────────────┬────────────────────────────────────┤ └─ NEXT ───┘ └─ + ──<increment>─┘
The $.MOVE option moves portions of the virtual TAPE file—that is, the TAPE file plus previous patches—to a range beginning at the specified base. The PATCH utility places SET and POP VOIDT around the range to be moved and creates a copy of the moved text at the new range. The $.MOVE option described in syntax 2 permits text that is being moved to be patched.
Explanation
<baseinc>
Specifies the sequence number at which the moved text is to begin. If no increment is specified, then the last value of the sequence increment is used. Since the base and increment used for the $.MOVE option are the same as the base and increment used for handling the $.SEQ $ option and the $.INSERT option, their values can be changed during the MOVE operation by a $ integer record or $ + <increment> option featured in syntax 2. They are not reset to their default values until the next patch ($# record).
NEXT
If the value of $.SEQ is TRUE, then NEXT causes the present value of the sequence base to be used as the base. If the value of $.SEQ is FALSE, NEXT causes the sequence number of the last record in this patch plus the value of the increment to be used as the base.
A MOVE operation cannot be done while VOIDT or VOID is TRUE, while $.MERGE is FALSE, or while an INSERT operation is being performed. $.SEQ cannot be changed and a $ GO TO cannot occur while a MOVE operation is being performed. $.MOVE options cannot be nested. The range to be moved cannot overlap the destination range, and the destination range cannot overlap sequence numbers in the virtual TAPE file.
