RI

Reset (clears) the primary input buffer.

Syntax

RI
RIp
RI(n)

Syntax Elements

p is the number of the parameter to be cleared and from which to clear to the end of the buffer. Can be a direct or indirect reference to a buffer or select register that contains the number of the parameter.

(n) specifies the starting column from which to clear to the end of the buffer.

Operation

The RI command clears the entire primary input buffer, and positions the buffer pointer at the beginning of the buffer. It also selects the primary input buffer as the active buffer and all data in the secondary input buffer is lost.

RIp clears the primary input buffer starting from the parameter number specified by p and continuing to the end of the buffer. The buffer pointer is positioned at the new end of the primary input buffer. If you specify a parameter number that is past the current last parameter, the buffer pointer is positioned at the end of the primary input buffer following the last parameter. If p is less than 2, the entire primary input buffer is cleared.

RI(n) clears the primary input buffer starting at the column number specified by n. The buffer pointer is positioned at the new end of the primary input buffer. If n is less than 2, the entire primary input buffer is cleared.

Example 1

Command

PIB Before

PIB After

RI

ABC^DEF^GHI
       


Example 2

Command

PIB Before

PIB After

RI3

INQ^PO^12719
     

INQ^PO
     

Example 3

Command

PIB Before

PIB After

RI(7)

123^456^789

123^45