INCR [ HP RPG/XL Utilities-Part 2 RISE ] MPE/iX 5.0 Documentation
HP RPG/XL Utilities-Part 2 RISE
INCR
INCRement resets default increment.
Form
I[NCR] [value]
Parameter Explanation
value New increment value you wish to establish. (For
limitations, see Note below.)
Purpose
The INCRement command resets the default INCRement to your new "value".
Once you use the INCR command, all subsequent commands which require the
increment value will use your new value unless you specify a different
increment in the parameters of the command. Typing "I[NCR]" without
"value" resets the default value of RISE, which is 1.
NOTE There are limits to the INCREMENT value that RISE will accept. The
increment value must be between 0.001 and 5000 inclusively.
Execution mode: Line or Block
Examples
The following are legal abbreviations which may be used with the
INCrement command and its parameters:
I 100 Sets increment value to 100.
I Resets increment value to default system value of 1.
In the first example, an error message results from an incorrect entry of
the INCR command (1). When a parameter that should be numeric is entered
alphabetically, a second error message appears (2). The command is then
entered correctly but a listing of the file in this case a five line
truncation of SIMCAL--does not indicate any change in the increment value
(3). However, when RENUMber is entered, a LIST ALL then produces the
effects of the changed increment value (4).
(1) >INCC
^
Error 21: Syntax error on INCR command.
(2) >INCR FIVE
^
Error 76: Illegal numeric increment value.
>INCR 5
Increment set.
(3) >L A
1 00011H
SIMCAL
2 00012FINPUT I P F 72 DISK
3 00013FOUTPUT O F 72 DISK
4 00014IINPUT AA 01 1 CA
5 00015I OR 02 1 CS
>RENUM ALL
Renum completed.
>L ALL
5 00011H
SIMCAL
10 00012FINPUT I P F 72 DISK
15 00013FOUTPUT O F 72 DISK
20 00014IINPUT AA 01 1 CA
(4) 25 00015I OR 02 1 CS
In the second example, the I command without a value resets the default
increment value of 1, and the RENUMber command is entered (1). When an
illegal abbreviation of LIST is entered, an error is generated (2). A
legal abbreviation of LIST ALL is then entered, and the command is
executed (3).
>I
(1) Increment reset to 1.
>RENUM
Renum completed.
(2) >LI AL
^
Error 112: Can't distinguish between LINe or LISt command.
(3) >LIS AL
1 00011H
SIMCAL
2 00012FINPUT IP F 72 DISK
3 00013FOUTPUT O F 72 DISK
4 00014IINPUT AA 01 1 CA
5 00015I OR 02 1 CS
In the third example, a series of errors establishes the limits of
increment values acceptable to RISE. It will not accept a value of zero
(1). The minimum increment cannot be be more than three digits to the
right of the decimal point (2). The maximum cannot exceed 5000 (3).
(1) >I0
Error 78: An increment value cannot be zero.
(2) >I.0001
^
Error 74: A maximum of 3 digits is allowed right of decimal.
(3) >IN6000
Error 156: BY increment cannot be greater than 5000.
>
>
MPE/iX 5.0 Documentation