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