IBP

Prompts for and accepts input from the terminal keeping the input data a single parameter and retaining embedded blanks.

Syntax

IBP{c{r}}

Syntax Elements

c is an optional prompt character.

If c is 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 colon (:) if the Proc was invoked from TCL.

r is a direct or indirect reference to a buffer or select register where the input data is to be placed. The prompt character c is required if a reference is specified.

Operation

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

Use the IP command if you want leading and trailing blanks removed and embedded blanks replaced with single attribute marks.

IBP and IBPc place input data in the active input buffer, replacing the parameter pointed to by the buffer pointer.

IBPcr places input data in the buffer or select register specified by r.

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

The input buffer pointer does not change position after an IBP command.

Example 1

Command Input	PIB Before	PIB After
IBP? 3-93	UPDATE^INV	UPDATE^INV^3-93

Example 2

Command Input	PIB Before	PIB After
IBP? XXX  Y  Z	DISP^PO^333	DISP^XXX  Y  Z^333

Example 3

Command Input	PIB Before	PIB After
IBP? RETURN	ABC^DEF^GHI	ABC^^GHI

Example 4

Command Input	File Buffer 1 Before	File Buffer 1 After
IBP:&1.1   DOUG JONES	000 AB-221 001 BOB SMITH 002 2500 003 C	000 AB-221 001 DOUG JONES 002 2500 003 C

Example 5

Command Input	File Buffer 2 Before	File Buffer 2 After
IBP:&2.2 RETURN	000 AB-221 001 3311 002 2900 003 FF	000 AB-221 001 3311 002 003 FF