This statement sets the options for RECOVER and REFRESH runs.
Scope of validity
A higher-level DBH option (the particular occurrences of the lower-level options are also described in this section)
Function
You use the DBH option RECOVER-OPTIONS to set the following options which are used in the case of a RECOVER or REFRESH run for the DBH in the service task:
The size of the buffer for system-access data
The size of the buffer for user data
The storage information for the transaction log files (TA-LOG files)
The storage information for the restart log file (WA-LOG file)
You can adjust the values of the operands during the DBH session by means of the MODIFY-RECOVER-OPTIONS administration statement (see "MODIFY-RECOVER-OPTIONS").
RECOVER-OPTIONS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
RECOVER-OPTIONS = *STD
The default values are used for all options (see the description of the operands below).
RECOVER-OPTIONS = *PARAMETERS(...)
Changes the settings for the options concerned.
SYSTEM-DATA-BUFFER = *STD / <integer 80..1000000>
Size of the buffer for system-access data in a RECOVER or REFRESH run in units of 1 Kbyte. The DBH calculates the default value internally according to the value of the session to be recovered.
USER-DATA-BUFFER = *STD / <integer 80..1000000>
Size of the buffer for user data in a RECOVER or REFRESH run in units of 1 Kbyte. The DBH calculates the default value internally according to the value of the session to be recovered.
MEDIA-CATALOG = *STD
The TA-LOG and WA-LOG files are created with default values on a public disk.
MEDIA-CATALOG = *PARAMETERS(...)
Changes the settings for the TA-LOG and WA-LOG files.
TALOG-SUPPORT =
Defines the volume for the TA-LOG files. There are a total of two TA-LOG files (TA-LOG1, TA-LOG2) that are written to one after the other in rotation.
TALOG-SUPPORT = *PUBLIC-DISK(...)
Causes the TA-LOG files to be created on a public disk.
CAT-ID = *STD / <cat-id>
Catalog ID of the pubset on which the files are to be stored. The default is the DBH catalog ID.
PRIMARY-ALLOCATION = *STD / <integer 1..16777215>
Number of PAM pages for the initial allocation of memory space. The specified number of PAM pages is reserved immediately. It should correspond to the expected file size. The DBH calculates the default value internally. If you enter a value lower than the calculated default, the DBH uses the default.
SECONDARY-ALLOCATION = *STD / <integer 1..32767>
Number of PAM pages for subsequent extensions to files. The DBH calculates the default value internally. If you enter a value lower than the calculated default, the DBH uses the default.
TALOG-SUPPORT = *PRIVATE-DISK(...)
The TA-LOG files are to be created on a private disk. To do this, you must make an entry for DEVICE-TYPE.
CAT-ID = *STD / <cat-id>
Catalog ID of the pubset on which the files are to be stored. The default is the DBH catalog ID.
PRIMARY-ALLOCATION = *STD / <integer 1..16777215>
Number of PAM pages for the initial allocation of memory space. The specified number of PAM pages is reserved immediately. It should correspond to the expected file size. The DBH calculates the default value internally. If you enter a value lower than the calculated default, the DBH uses the default.
SECONDARY ALLOCATION = *STD / <integer 1..32767>
Number of PAM pages for subsequent extensions to files. The DBH calculates the default value internally. If you enter a value lower than the calculated default, the DBH uses the default.
DEVICE-TYPE = <structured-name 1..8>
BS2000 device type to which the required disks are assigned. If you make an incorrect entry, the DBH aborts the start procedure.
VOLUME = list-poss(6): <alphanum-name 1..6>
VSNs of the disks on which the files are to be created. Up to 6 VSNs are permitted, each of which can be specified only once. VOLUME is not evaluated unless the DEVICE-TYPE operand is specified.
WALOG-SUPPORT =
Defines the volume for the WA-LOG file. The operands are identical to those in the operand descriptions for TALOG-SUPPORT.