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

1- 134
following: * SHOW the first page (10 lines) of the source code for the modification. (Your Command Window
will also appear on the screen.) * Type in your modifications to the program directly. * Type in DELETE
100/150 in the Command Window. * Press the ENTER key. After you press ENTER, RISE reads in your
changes, then pauses and executes your DELETE command, leaving you in the page modification mode of
the SHOW command.
Special Function Keys (Softkeys)
The terminal special keys are fully integrated into the functional features of RISE. The editing keys and
cursor positioning keys allow you to edit directly a displayed page. The special function keys give you
push-button control of scrolling, mode shift, and a display of editor sequence numbers, among other
capabilities. The function of the keys changes, depending upon the command which has been entered.
You do not have to memorize the function of the softkeys; descriptive labels associated with the activated
keys appear at the top of the screen whenever the keys are available for use.
In the commands section of the manual (See chapter 2), the special function keys, also called softkeys, are
discussed with the commands that bring them to the screen.
Files
The Work File
RISE performs all of your editing commands on a work file. The File and Text commands tell RISE which
permanent file you wish to become your work file. The work file is a KSAM file (Keyed Sequential Access
Method), and is used so that RISE can quickly random access your source records. (See the KSAM/3000
Reference Manual for more information on this file organization.)
The name of the work file is in the form Wdddhhmm, where "ddd" is the day of the year, "hh" is the hour of
the day, and "mm" is the minute of the hour. The name of the associated key file is WKddhhmm, where "K"
overlays the first "d" in the day of the year, and "ddhhmm" have the same meaning as they do with the
work file. If there is an existing file with the same name, RISE will increment the last digit.
RISE automatically supplies sequence numbers to the KSAM work file in columns 81-88 if none already
exist. These sequence numbers serve as search keys when RISE accesses the KSAM work file. In your
command parameters you specify which source lines you want to work on. For example "LIST 1/10" will
list to the screen the source lines whose seqence numbers are included in the range 1 to 10.
The renumber command allows you to manage the sequence numbers. Note that the sequence numbers
are not associated with the RPG line numbers in columns 1-5 of your source program. The sequence
numbers are not a part of the RPG program.
There are several ways in which you may specify which sequence numbers you want processed. You may
give the precise number, as in "LIST 1/10", or you may use relative numbers in relation to the current
position of the record pointer. You may also use the literal specifications FIRST, LAST, or ALL. More
information concerning the specification of sequence numbers with various commands appears in the
command section (chapter 2).
Accessing Files
When you TEXT your files, your permanent file is copied into a work file (which is a KSAM file). It is
copied back to a permanent file when you use the KEEP command. Using TEXT and KEEP you edit work
files only, bringing them to the screen for editing and storing them as permanent files when the work is
concluded.
The TEXT/KEEP commands provide a safeguard in that the editing done to a work file is not made
permanent until the KEEP is given. Thus, if erroneous deletions were made to the work file, you would