Caché ObjectScript Reference - InterSystems Documentation

System and Other Functions$ZUTIL(78,23)Deletes a journal file.$ZUTIL(78,23,filename)$ZU(78,23,filename)ParametersfilenameThe name of the journal file to delete, specified as a quoted string.DescriptionYou can use $ZUTIL(78,23) to delete a journal file from within Caché. This function doesnot check that the file to be deleted is a journal file, so it may also delete non-journal files ordirectories.You must have the %Admin_Manage:Use privilege to execute any of the $ZUTIL(78) functions.These functions can also be invoked by % routines located in the manager's directory.For further details, refer to the Privileges and Permissions chapter of the Caché SecurityAdministration Guide.ParametersfilenameThe name of the file to delete, specified as a quoted string. $ZUTIL(78,23) expands filenames to full canonical form. On VMS systems it automatically specifies the latest versionof the file.Return Values$ZUTIL(78,23) returns one of the following values:1other valuesSuccessful file deletionFailure. A positive number other than 1 or a negative number indicatefailure. The exact return value is platform-dependent. Possible reasonsare file not found or file locked by another user.If the file is locked by another process, you cannot delete a file using $ZUTIL(78,23). If thespecified file is the active journal, a error is generated.686 Caché ObjectScript Reference