HP 3000 Manuals HP 3000 Manuals
USING RTOKSAM
The RTOKSAM program will create a KSAM/3000 file from an existing INDEX
file. The KSAM file will have the same key structure as the INDEX file.
Any number of INDEX files can be converted to KSAM/3000 files in one
RTOKSAM run provided that you have sufficient disc space within your
group and account for all the files.
Program RTOKSAM is run as follows:
:RUN RTOKSAM.PUB.SYS.
HP32208.A.0.00 INDEX TO KSAM CONVERTER
ENTER INDEX KEY, KSAM DATA, AND KSAM KEY FILE NAMES
>indexkey,ksamdata,ksamkey
The names of the INDEX key file, the KSAM data file, and the KSAM key
file must be entered in that order. Only the INDEX key file already
exists; a new KSAM/3000 file wll be created with the specified names.
After converting the INDEX file to the KSAM file, the program continues
to prompt you for additional file names for conversion. When you wish to
stop processing, simply press the carriage return key in response to the
greater than (>) prompt. Or, if you are in a job, enter an :EOD record.
Record numbering in INDEX files always starts with record number 1. The
KSAM file created by the RTOKSAM conversion program will also have record
number starting with 1. Note that this is not the standard KSAM file
default. Key blocking, on the other hand, does follow the KSAM file
defaWt. That is, the number of keys per block is determined by KSAM so
that each key block has 1024 (1K) words.
If errors occur during execution of RTOKSAM, the following error messages
may be displayed:
INPUT/OUTPUT ERROR ON $STDIN/$STDLIST
COMMAND TOO LONG
DUPLICATED FILE NAME
INSUFFICIENT PARAMETERS
INDEX OPEN ERROR (detail line follows message)
INDEX FREADLABEL ERROR (detail line follows message)
UNABLE TO BUILD KSAM FILE (detail line follows message)
KSAM FILE WRITE ERROR (detail line follows message)
INDEX FILE READ ERROR (detail line follows message)
The detail line that follows certain of the RTOKSAM messages explains in
more detail the input/output error that occurred.
The normal MPE security provisions for files apply when the INDEX file is
specified in this program. The KSAM file that is created must be within
the same log on group.
NOTE It is good practice to make a back-up copy of the INDEX file on
off-line storage such as magnetic tape before running RTOKSAM to
copy the file to a KSAM file. This allows you to purge the INDEX
file once it is copied.