HP 3000 Manuals

ERASE [ KSAM/3000 Reference Manual ] MPE/iX 5.0 Documentation


KSAM/3000 Reference Manual

ERASE 

Clears the contents of a KSAM file.

     >ERASE filereference 

The contents of a KSAM file, both the data and key files, can be cleared
to an empty state with the KSAMUTIL ERASE command.

PARAMETERS 

filereference    Actual file designator that identifies the KSAM data
                 file.  It is specified exactly like filereference1 in
                 the >BUILD command.

                 (Required parameter.)

CLEARING A KSAMFILE 

EXECUTE access is required to erase a KSAM file.  If the group in which
the KSAM file resides does not have EXECUTE access, any attempt to erase
a file results in an error and the message, "FSERR 93 SECURITY
VIOLATION."

When ERASE is specified for a KSAM file, the end-of-file pointer that
follows all data is reset to point to the first record in the data file.
This position of the pointer is identical to its position when the file
is created and before any data is written to the file.

All pointers and control words in the key file are reset to indicate that
the data file is empty.

Note that the file is still created and new data may be written to it.

For example, to clear the contents from the file identified as KSAMFILE:

     >ERASE KSAMFILE 



MPE/iX 5.0 Documentation