HP 3000 Manuals HP 3000 Manuals
PURGE
Purges a KSAM file from the system.
>PURGE filereference [,TEMP]
The KSAMUTIL PURGE command can be used to remove a KSAM file, both data
and key files, from the system. Although the MPE :PURGE command can also
be used, it must be specified twice, once for the data file and once for
the key file. If you are programming in COBOL, BASIC, or RPG, you should
use the KSAMUTIL PURGE command to purge a KSAM file. In SPL or FORTRAN
you could also use the FCLOSE intrinsic (described in section IV) to
purge a KSAM file.
PARAMETERS
filereference Actual file designator identifying the KSAM data file.
Specified exactly like filereference1 in the >BUILD
command.
(Required parameter.)
TEMP Must be specified if file is a temporary file in
session/job temporary file domain. If omitted, a
permanent file is assumed.
(Optional parameter.)
PURGING A KSAM FILE
When PURGE is executed, the specified KSAM data file and its associated
key file are removed from the system and can no longer be referenced.
For example, to purge a temporary KSAM file called KTEMP:
>PURGE KTEMP,TEMP
KTEMP.KSAM.DATAMGT & KKEY PURGED.
To purge the permanent file KSAMFILE:
>PURGE KSAMFILE
KSAMFILE.KSAM.DATAMGT & KFILE PURGED.
The system prints the data and key file names of a successfully purged
KSAM file. It also prints the group and account names in which the file
was created (in this case KSAM and DATAMGT).