Archiver Exit Script (acpexit)

The Archiver Process Exit command script is executed by the archiver before an error halt. This shell script (acpexit in UNIX or ACPEXIT.COM in VMS) resides in the utility directory. You can use the default script behavior, which sends mail to the installation owner account with the reason for the archiver failure, or, the script allows you to customize certain aspects of archiver recovery.

Because the archiver writes sequentially to the end of journal files, a common problem occurs when the archiver stops as a result of running out of journal disk space. If left unresolved, running an installation without an archiver (and with journaled databases) eventually causes the log file to fill.

To address this concern, whenever the archiver detects an error condition that forces it to stop (including running out of journal disk space) it first executes the archiver exit script.

Customization of Archiver Exit Script

You can modify the archiver exit script to take action appropriate to your installation. For example, one possible course of action is to delete a reserved file on the journal disk to free up space and restart the archiver.

You can customize the archiver exit script in these respects:

The default script sends mail to the installation owner account when archive processing halts, and includes the reason for the failure. You can modify this script to notify the system administrator directly of a situation that needs resolving.
You can tailor the script to handle certain resource and environmental problems automatically. For example, if archive processing has stopped because of insufficient disk space, the script can automatically reclaim disk space and resume archive processing.
The default script is executed with one or two arguments, described in Archiver Exit Script Parameters. You can choose whether to incorporate these arguments if you customize the script.

The default script includes examples of processing you can use for your installation. These examples are formatted as comments, and can be included in the script by removing the comment prefixes. The script is located at $II_SYSTEM/ingres/files/acpexit.

Archiver Exit Script Parameters

The archiver exit script parameters are as follows:

Parameter	Description	Status
errornumber	An error number that describes the reason archive processing has stopped. At the end of the default script is a list of all possible error numbers, with an explanation of the error and, in many cases, the recommended actions to correct the error.	Always passed in default script.
database_name	The name of the database that was being processed at the time archiving stopped. The name is provided only if the halt in archive processing was associated with a particular database problem, as opposed to a general system problem.	Sometimes passed in default script.