IBH

Places text in the active input buffer, retaining embedded blanks in the text string.

Syntax

IBHtext-string

IBHreference

IBHreference;input-conversion;

IBHreference:output-conversion:

Syntax Elements

text-string The text to be placed in the input buffer, supplied as a literal or a SYSTEM function call.

Do not use value marks or subvalue marks in the text; they can cause unpredictable results.

reference A direct or indirect reference to a buffer or a select register.

input-conversion An English input conversion to be applied to the string at reference before putting it in the input buffer.

output-conversion
An English output conversion to be applied to the string at reference before putting it in the input buffer (see Conversion Codes).

Operation

The IBH command is the same as the IH command except that blanks occurring within the string (including leading and trailing blanks) are not replaced with single attribute marks. Instead, the text is placed in the active input buffer as a single parameter with all blanks intact.

Use the IH command if you want the blanks occurring within the text replaced with single attribute marks thereby creating new, separate parameters to replace the current single parameter.

If a buffer reference is used instead of literal text, the reference must immediately follow the letters IBH; otherwise, it is loaded as text.

The IBH command leaves the position of the buffer pointer unchanged.

Depending on the position of the buffer pointer, IBH either replaces an existing parameter or adds a new parameter at the end of the input buffer as follows:

• If the buffer pointer is at the beginning of an existing parameter, IBH replaces the current parameter with the text - including leading and trailing blanks.
• If the buffer pointer is in the middle of a parameter, IBH concatenates the new parameter (without a leading attribute mark) to the original parameter, starting at the location of the buffer pointer.
• If the buffer pointer is at the end of the input buffer, IBH creates a new parameter at the end of the input buffer. After the parameter is added, the buffer pointer points to the attribute mark preceding the new parameter.

Example 1

Command	PIB Before	PIB After
IBHRED CHAIR	INV^BBB^3	INV^RED CHAIR^3

Example 2

Command	PIB Before	PIB After
IBH   EE	AA^BB^CC^DD	AA^BB^CC^DD^   EE

Example 3

File buffer 7 contains:

000 17113
001 3091

Command	PIB Before	PIB After
IBH&7.1:D2:	UPD^AB^333^4	UPD^AB^17 JUN 76^4