IBN

Prompts for input from the terminal and places the input data in the secondary input buffer as a single parameter, retaining embedded blanks in the input string. The secondary input buffer is selected as the active input buffer.

Syntax

IBN{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 c is not used, it defaults to the last prompt character specified, or to a colon (:) if the Proc was invoked from TCL.

Operation

The IBN command functions the same as the IN command except that the input string is placed in the buffer as a single parameter and all blanks remain intact.

The current contents of the secondary input buffer are destroyed, and the buffer pointer is set to the beginning, prior to placing the input data in the buffer. 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.

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

Example 1

Input	SIB Before	SIB After
111-23		111-23

Example 2

Input	SIB Before	SIB After
XYZ	111-23	XYZ

Example 3

Input	SIB Before	SIB After
123 456 789	XYZ	123 456 789

Example 4

Input	SIB Before	SIB After
RETURN	123 456 789	^