The recovery log (RLOG) must be prepared before it can be used. The following steps are required to start the RLOG file:
Before running ADARAI PREPARE, the RLOG data set must be formatted using the RLOGFRM function of the ADAFRM utility. If it is not, an error 159 is returned.
ADARAI PREPARE must be executed with the database inactive.
The ADARAI PREPARE function is used to define
the size of the RLOG (the size must be the same as the value of the SIZE parameter of the ADAFRM RLOGFRM function);
the minimum number of generations to retain (4 is the default); and
the device type (the default is the device type specified by the ADARUN DEVICE parameter).
After the PREPARE function executes, logging begins for the initial generation; however, this generation has a restricted status because it has not been started by a full database save or restore.
See the Adabas Operations documentation for more information about generation statuses.
This document covers the following topics:
RLOGSIZE defines the size of the RLOG file in cylinders or blocks. This value must be the same as that defined by the SIZE parameter of the ADAFRM RLOGFRM function. RLOGSIZE must be specified; there is no default.
Note:
The RLOG data set is limited to 16,777,215 (x'FFFFFF')
blocks/RABNs.
MINGENS specifies the number of logging generations to hold in the RLOG. The RLOG numbers the generations in ascending order starting with "0". The minimum is 4 generations (the default); the maximum is 32.
RLOGDEV specifies the device type containing the RLOG file. If the RLOG file is located on the device type specified by the ADARUN DEVICE parameter (the default device type), you do not need to specify RLOGDEV.
Important:
If you choose a device type for the RLOG data set that is
different from the default, you must specify the RLOGDEV parameter for all
ADARES PLCOPY and COPY executions as well.
ADARAI PREPARE MINGENS=4,RLOGSIZE=5
This ADARAI PREPARE function defines and initializes the RLOG to hold the minimum of four generations in a log size of five cylinders. The RLOG device defaults to that specified by the ADARUN DEVICE parameter.
ADARAI PREPARE RLOGSIZE=20,MINGENS=20,RLOGDEV=3390
This example defines a larger RLOG size (20 cylinders) to hold as many as 20 generations on a 3390 device type.