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:
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.
