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.