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

2- 164
"filename" could represent FILE SIMCAL.
Case 3. Converting Non-KSAM File to New KSAM File
"filename" exists but is not a KSAM file. RISE must convert it. (The converted file is called "newfile"
below.)
You type > FILE " filename "
RISE responds Enter new file name followed by additional number of records.
You type " newfile " 100
(If you are adding records to those in "filename" (now called "newfile") enter the number of additional
records you will add--100 in this example. The default is the number of records in "filename".)
To access converted files in the future, type FILE "newfile ".
Related Commands
The TEXT and KEEP commands achieve results similar to those of FILE and EXIT TEXT and KEEP have
the disadvantage of additional overhead while files are being copied to a work file and recopied to a
permanent file. The advantage is that any erroneous editing of the work file pertains only to the work file.
The permanent file remains in its previous state. See TEXT and KEEP for further information concerning
these commands.
It is recommended that TEXT and KEEP be used with small files since their copy time will be minimal.
FILE and EXIT are best suited to large files in their developmental stage. When the source program is
fully developed and in production, use TEXT and KEEP to avoid key file overhead in storing.
A KSAM file actually consists of two files: the data file and the key file. If you want to purge both parts of
a KSAM file, use the following commands:
:RUN KSAMUTIL.PUB.SYS
>PURGE "filename"
>EXIT
For further information concerning KSAM files, please see the KSAM REFERENCE MANUAL.
Leaving FILE
Use the EXIT command to leave FILE. It will terminate RISE and return you to MPE with your changes
made permanent. You can also use the BEGIN command to leave FILE. It will close the file you are
directly editing and allow you to begin a new editing session as if you had just entered the RPG Interactive
System Environment.
* Execution mode: Line or Block.
* Record Pointer: At first line in file.
Examples
The following are legal abbreviations which may be used with the FILE command and its parameters:
FILE FILE1 N Ready a work file named FILE1 for immediate editing.
FIL FILE1 Ready a work file named FILE1 for editing.