HP RPG/iX Utilities Reference Manual (30318-90006)

2- 144
| position of the record pointer.) | |
|| |
---------------------------------------------------------------------------------------
|| |
| (The special character, @, may be used in | L@-5/@+5 |
| place of * to indicate record pointer | |
| position.) | |
|| |
---------------------------------------------------------------------------------------
|| |
| (Specifications may be mixed.) | LF[IRST]/* +10 L* -5/L L 10/L |
|| |
---------------------------------------------------------------------------------------
Increments for Sequence Numbers
Every text record in RISE's work file has a unique sequence number that RISE uses to access the KSAM
work file. The difference in value between each sequence number is known as the increment. RISE uses a
default increment value of 1 which you may replace with the INCR[ment] command followed by the new
value, so long as that value is between .001 and 5000 inclusively.
Those RISE commands which create new sequence numbers and text records for you need an increment
value to determine the next new number. Some of the commands involved are RENUM, ADD, COPY,
MOVE, and JOIN. Each of the commands provides the optional paramater "BY inc" to allow you to specify
the increment for RISE to use while executing the command. If you omit "BY inc", RISE will use the
current default increment value.
At times you will want to add or merge new text records between two existing sequence numbers. If the
current increment value that RISE is using is too large, the new sequence numbers being generated may
exceed the existing upper sequence number. If this happens, RISE will automatically make room for your
new lines by reducing the large increment to a smaller one to stay within the upper limit while keeping
your text records in proper order.
If, however, RISE cannot determine a small enough increment value because you are attempting to
introduce too many lines into a restricted space between two existing line numbers, RISE will display the
following error message:
Error 144: No room between line numbers.
In such a case, you can use the RENUM[ber] command to change the sequence numbers and continue with
your editing.
About the Examples
Examples of commands in the section which follows use a short RPG source file called SIMCAL (SIMple
CALculator). The program will perform simple calculations--addition, subtraction, multiplication, and
division. Here is a listing of the file which was made using RISE's PRINT command.