The archecker utility configuration parameters and environment variable
These topics describe the AC_CONFIG environment variable and the configuration parameters that you use with the archecker utility.
The archecker utility uses the configuration parameters in the ac_config.std template to verify a backup or perform a table-level restore. If you need to change these parameters, copy the ac_config.std template to the AC_CONFIG file. The AC_CONFIG environment variable specifies the location of the AC_CONFIG file.
Because ON-Bar calls the archecker utility to verify backups, you must configure the archecker environment variable and parameters before you can use the onbar -v option.
You can also use other archecker configuration parameters that do not have default have default values in the ac_config.std file, but are valid in that file.
| Configuration parameter | Description |
|---|---|
| AC_DBSPACE | Specifies a list of dbspaces that the archecker utility will verify during a backup verification process. Starting with Informix server version 15.0.1.x, AC_DBSPACE is an optional parameter. When it is not set, active dbspace list is used and it is identified using ixbar.servernum file. |
| AC_DEBUG | Prints debugging messages in the archecker message log. |
| AC_IXBAR | Specifies the path name to the IXBAR file. If not set in the ac_config file, the value of the BAR_IXBAR_PATH configuration parameter is used. |
| AC_LTAPEBLOCK | Specifies the ontape block size
for reading logical logs. If not set in the ac_config file, the value of the LTAPEBLOCK configuration parameter is used. |
| AC_LTAPEDEV | Specifies the local device name used by ontape for
reading logical logs. If not set in the ac_config file, the value of the LTAPEDEV configuration parameter is used. |
| AC_MAX_RESTORE | Specifies the number of processes to be started during a parallel table
level restore using archecker. Each process will perform physical restore
of a table from a dbspace. Note: Parallel physical table level restore
is not supported on Windows platform. |
| AC_MSGPATH | Specifies the location of the archecker message
log. This configuration parameter is in the default ac_config file. |
| AC_SCHEMA | Specifies the path name to the archecker schema command file. |
| AC_STORAGE | Specifies the location of the temporary files that archecker builds. This configuration parameter is in the default ac_config file. |
| AC_TAPEBLOCK | Specifies the tape block size in kilobytes. If not set in the ac_config file, the value of the TAPEBLOCK configuration parameter is used. |
| AC_TAPEDEV | Specifies the local device name used by the ontape utility. If not set in the ac_config file, the value of the TAPEDEV configuration parameter is used. |
| AC_TIMEOUT | Specifies the timeout value for the onbar and the archecker processes if one of them exits prematurely. |
| AC_VERBOSE | Specifies either verbose or terse mode for archecker messages. This configuration parameter is in the default ac_config file. |
| BAR_BSALIB_PATH | Identical to the BAR_BSALIB_PATH server configuration
parameter that is in the onconfig.std file. For more information, see BAR_BSALIB_PATH configuration parameter. |
If you use the ontape utility and the AC_TAPEDEV, AC_TAPEBLK, AC_LTAPEDEV and AC_LTAPEBLK configuration parameters are not set in the AC_CONFIG file, the archecker utility will use the values specified in the TAPEDEV, TAPEBLK, LTAPEDEV, LTAPEBLK configuration parameters specified in the onconfig file.