.UTIL DEL HOOK

This subroutine deletes a record from the Hook file.

Usage:

      PASS         <error_msg>                FIELD            SHARE? Y
      PASS     --- HOOK RECORD                FIELD            SHARE? N
      GOSUB    --- .UTIL DEL HOOK
      *        Check for errors
      IF       --- .UTIL DEL HOOK             NE

Description:

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 mandatory fields are:

HOOK AP:
HOOK VER:
HOOK PROC TYPE:
HOOK PROC NAM:
HOOK DB:
HOOK USER ID:

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.

Comments:

Read what other users have said about this page or add your own comments.

-- JeanNeron - 2012-03-12