BUMP

The BUMP instruction increments or decrements the form pointer of the destination string variable. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

dest

Required. A previously defined Character String Variable or National Character String Variable whose form pointer is modified.

sep

Required. A comma or one of the following prepositions: BY, TO, OF, FROM, USING, WITH, IN, or INTO.

count

Required. A previously defined Numeric Variable, decimal constant, Expression, or equivalent {ctrl} character added to the form-pointer of the {dest} variable.

Flags Affected: EOS

Note the following:

1. If the {count} operand is not specified, the Form Pointer of {dest} is incremented by one.

2. If the {count} operand is specified, the Form Pointer of {dest} is incremented by the value specified or the integer value of the variable (i.e., 5 if 5.75).

3. If the new Form Pointer exceeds the Length Pointer or is beyond of the physical boundaries of {dest}, the Form Pointer does not change and the EOS Condition Flag is set.

4. Enhanced ARRAY processing is supported for the BUMP instruction.

Example 1:

The EOS Condition Flag is set. The new Form Pointer would exceed the Length Pointer.

Example 3:

No Condition Flags are set (all FALSE).

Example 5:

No Condition Flags are set (all FALSE).

See Also: RESET, Character String Instructions