HOLD_RELEASE function

Use to release documents from a hold. To query the database to determine the documents that should be released from the hold, you can use the following parameters:

SQL query (-i)
public named query (-q)
text search string (-t or -T)
load ID (-x or -X)

If you selected the option in the application group to use implied hold, documents are placed on hold as soon as they are loaded, and there is not a hold name that is associated with the documents that are placed on hold. To release documents from an implied hold, specify IMPLIED_HOLD as the hold name. For best performance when releasing documents from an IMPLIED_HOLD, it is recommended that you use the load ID (-x) parameter instead of the load ID (-X) parameter to determine the documents that should be released from the hold. For example, you might specify -x 770659-1-0-2FAA-19960313000000-19980313000000-770660 to release holds on all documents where 770659-1-0-2FAA-19960313000000-19980313000000-770660 is the load ID of the documents that should be released from the hold.

Ensure that Enhanced Retention Management is turned on for the application group and you have permission to release documents from a hold before you attempt this function. Otherwise, a permission error will occur.

If a duplicate attempt is made to release the same documents from a hold, no error occurs and ARSDOC displays a successful message. However, the system log might contain messages that indicate that the documents were already released.

When you use the parameter file option, you must specify the -F, -h, -p, -u, -U, -v, -1, and -2 parameters on the command line. All other parameters must be specified in the parameter file. The following diagram shows the syntax of the HOLD_RELEASE function when you use the parameter file option:

The syntax of the parameter file for the HOLD_RELEASE function is: