S

Positions the  active input buffer pointer to a specified parameter, or sets the buffer pointer to a specified column in the primary input buffer and selects that buffer as active.

Syntax

Sp
S(n)

Syntax Elements

p is the number of the parameter to where the buffer pointer is to be set.

p can be a direct or indirect reference to a buffer or select register that contains the number of the parameter.

(n) specifies the number of the column where the buffer pointer is to be set.

Operation

The S command positions the buffer pointer to a specified parameter or column.

Setting to a Parameter

Sp sets the buffer pointer in the active input buffer to the attribute mark prior to the parameter number specified by p.

If the specified parameter number is past the current last parameter, the buffer pointer is positioned at the end of the buffer. To create parameters past the current end of the buffer, use the MV command.

If the specified parameter number is less than 2, the buffer pointer is placed at the beginning of the active input buffer.

Setting to a Column

S(n) sets the buffer pointer in the primary input buffer to the n'th column.

Setting the buffer pointer to a particular column position selects the primary input buffer as the active buffer. The contents of the secondary input buffer is unchanged, but is accessible only with the MS command.

If the specified column number is past the current last parameter, the buffer pointer is positioned at the end of the primary input buffer.

If the specified column number is less than 2, the buffer pointer is placed at the beginning of the primary input buffer.

Example 1

Command	PIB Before	PIB After
S3	DSP^12-A^71	DSP^12-A^71

Example 2

Command	PIB Before	PIB After
S(4)	1234567^ABC	1234567^ABC

Example 3

File Buffer 3 contains:

000 123-A
001 JOHN DOE
002 13
003 2

Command	PIB Before	PIB After
S&3.%4	ABC^DEF^GHI^3	ABC^DEF^GHI^3