This subroutine deletes a record from the Hook file.
This subroutine deletes a record from the Hook file. All parameters are required, if any required parameters are missing, the subroutine will CANCEL.
<error_msg> will contain a detailed error message if the Hook record was not able to be deleted (Required). This must be PASSed Share "Y" to return the value.
The above fields identify the hook record to be deleted. (Application, Version, Process Type, Process Name, Database and User Id). The remaining fields will be ignored.
This subroutine is different from .UTIL GET HOOK RECORDS/.UTIL PUT HOOK RECORDS in that the the changes are permanent, and they do not take effect immediately. If you want the changes to take effect immediately, use.UTIL GET HOOK RECORDS to get the current hook records from the engine, make the same changes as you did with this subroutine, then update the engine with.UTIL PUT HOOK RECORDS. Or you can do nothing, and the changes will take effect the next time users log on.
Also see .UTIL ADD HOOK and .UTIL CHG HOOK.
Note that although --- HOOK is an indexed file that can contain more than one record, only the current record buffer will be processed.