HP 3000 Manuals HP 3000 Manuals
KSAM FILE MANAGEMENT
Since the release of version B.03.23 of VPLUS/V, VPLUS/V accepts only MPE
files with the file code of VFORM. VPLUS/V has created only MPE files
since VPLUS/3000 version A.01.01. Prior to A.01.01, VPLUS/V created KSAM
files. Any KSAM file created by VPLUS/V before version A.01.01 will
continue to function when accessed through FORMSPEC, REFSPEC, ENTRY or
your applications without any actions on your part. If, however, you
wish to modify the forms file using FORMSPEC or REFSPEC, the file must be
converted using the CONVERT utility, as described below.
Purge Forms File
The MPE :PURGE command will delete a non-KSAM forms file. If, however,
your forms file is a KSAM file, MPE does not provide a direct means to
purge it. If you want to permanently delete a KSAM forms file created
through a prior version of FORMSPEC, you must run the KSAMUTIL utility
program as follows:
:RUN KSAMUTIL.PUB.SYS
This program will issue a greater than sign (>) as a prompt. In response
to this prompt, you enter the PURGE command. Suppose the forms file you
want to purge is named ORDFORM, enter the command as follows:
>PURGE ORDFORM
ORDFORM.PUB.ACCTG & ORDKEY PURGED <---- ??system response??
Note that you need not specify the key file name associated with your
forms file; KSAMUTIL knows this name as it indicates in the response to
the PURGE command. KSAMUTIL also notes the account and group in which
the forms file resides.
Rename Forms File
If you want to rename an existing non-KSAM forms file, simply use the MPE
:RENAME command. In order to rename a KSAM forms file, you must run
program KSAMUTIL. You may rename either the forms file or the key file
with a single RENAME command; or you may rename both files with two
RENAME commands. Suppose you want to rename the forms file ORDFORM and
also its associated key file ORDKEY. To do this, run KSAMUTIL and then
enter two RENAME commands, as shown:
:RUN KSAMUTIL.PUB.SYS
>RENAME ORDFORM, NEWORD
(new names)
>RENAME ORDKEY, NEWKEY
Convert KSAM File
Before converting a KSAM file to the now standard MPE files, you should
first use FCOPY to physically remove any records which have been
logically deleted in the file. This can be accomplished as follows:
:FCOPY FROM=ORDFORM;TO=(ORDFORM2,ORDKEY2)
This will copy only the active records in the KSAM file named ORDFORM to
the new KSAM file named ORDFORM2 whose key file in ORDKEY2, also a new
file.
The utility program CONVERT.PUB.SYS will create an MPE file from the KSAM
file created above:
:RUN CONVERT.PUB.SYS
PLEASE ENTER NAME OF THE OLD FORMS FILE.
ORDFORM
PLEASE ENTER THE NEW FORMS FILE NAME.
ORDNEW
DIRECTORY LENGTH=1264 <----- system response
END OF PROGRAM
The directory is found in an extension to the comarea, and consists of
information regarding the location of the data records in the forms file.
Its length varies from forms file to forms file and is indicated in the
system response as in the example.