IN

Prompts for input from the terminal and place it in the secondary input buffer. The secondary input buffer is selected as the active buffer input.

Syntax

IN{c}

Syntax Elements

c is an optional prompt character. If used, it remains in effect until reset with a new IBN, IBP, IN, or IP command. If not used, the prompt defaults to the last prompt character used or to a colon (:).

Comment

Because the secondary input buffer has fallen into disuse, the use of the IN command in general programming is not recommended.

Operation

The current contents of the secondary input buffer are destroyed and the buffer pointer is set to the beginning, prior to placing the data in the buffer.

Leading and trailing blanks are removed and embedded blanks are replaced with a single attribute mark.

Use the IBN command if you want to retain the blanks input at the terminal and treat the entered text as a single parameter.

Pressing RETURN only in response to an input prompt creates a null parameter.

The buffer pointer is positioned at the beginning of the buffer after an IN command. The secondary input buffer is selected as the active input buffer. It remains active until an RI, S(n), or MV %n source command is executed.

Example 1

Input	SIB Before	SIB After
145-98		145-98

Example 2

Input	SIB Before	SIB After
XYZ	145-98	XYZ

Example 3

Input	SIB Before	SIB After
3 456 789	XYZ	3^456^789

Example 4

Input	SIB Before	SIB After
RETURN	3^456^789