HP Data Entry and Forms Management System (VPLUS) Reference Manual (32209-90024)
616 AppendixH
Version Control
KSAM File Management
KSAM File Management
Since the release of version B.03.23 of VPLUS, VPLUS accepts only MPE files with the file
code of VFORM. VPLUS has created only MPE files since VPLUS version A.01.01. Prior to
A.01.01, VPLUS created KSAM files. Any KSAM file created by VPLUS 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: