OpenTP1 Version 7 Operation
jnlcolc (Integrate file recovery journals)
Format
jnlcolc -k recovery-type [-f] [-l] [-n] [-m] [-i online-backup-information-name] [-c key] [[file name] [file-name]...] |
Function
The jnlcolc command extracts journal records required for DAM file, TAM file or ISAM file recovery from specified unload journal files and then outputs them to the standard output. The integrated result can also be redirected and output to a file.
Options
-k recovery-type
Specifies the type of file to be subject to recovery:
-f
Specifies that the journals required for file recovery are to be extracted from the first unload journal files. The command checks whether or not the journal file generation numbers are n ascending order beginning with 1. If not, processing terminates.
When this option is omitted, the command assumes that information is to be inherited from the previous journal record extraction processing and checks whether or not the inheritance file generation numbers are arranged in ascending order beginning with the last generation number + 1. If not, processing terminates.
-l
Specifies that the journals required for file recovery are to be extracted from the last unload journal files. The command then deletes the inheritance file.
If file recovery journals are integrated by specifying this option, the -f option must be specified when another online journal is integrated.
When this option is omitted, inheritance files are not deleted.
-n
Specifies that all FJ records are to be output, even if there is update information for the same logical file or the same relative block number in the transaction (information about FJ before and after update processing is not checked, and duplicate information is not deleted).
When this option is omitted and there is update information for the same logical file or the same relative block number in the transaction, only the final update information is output.
This option is applicable only when the recovery type indicates a DAM file.
-m
Integrates journal records on the file to be recovered. If this option is specified, it is assumed that the -n option has been specified. If the option is omitted, a buffer is allocated on memory for integration of journal records.
-i online-backup-information-name
Collects integration startup information of the file recovery journal from the specified file, and skips the records preceding the startup location. This option is applicable only when d or t (DAM or TAM file as the recovery type) is specified in the -k option. If the -i option is omitted, file recovery journals are integrated from the beginning of the file.
-c key~((001-999)) <<001>>
Specifies the last three characters of the inheritance file name. OpenTP1 creates an inheritance file under the name jnlcolc***, replacing *** with the value specified with this option.
Command arguments
file-name~<path name>
Specifies the name of the file containing journal records needed for file recovery. When the multinode facility is used, the name of the file whose journal records have been sorted and merged by the jnlsort command must be specified. If the multinode function is not used, the name of the unload journal file must be specified. When more than one file is specified, a space must be placed between files. You can specify a maximum of 256 files.
When this command argument is omitted, the standard input is assumed.
Output messages
Message ID | Description | Output destination |
---|---|---|
KFCA02600-E | An error occurred while the unload journal file was being accessed. | Standard error output |
KFCA02601-E | The unload journal file is invalid. | Standard error output |
KFCA02602-E | The journal block is invalid. | Standard error output |
KFCA02603-E | The journal record is invalid. | Standard error output |
KFCA02604-E | Memory cannot be allocated. | Standard error output |
KFCA02606-E | The inheritance information file is invalid. | Standard error output |
KFCA02607-E | The relationship between the inheritance information file and the unload journal file is invalid. | Standard error output |
KFCA02621-W | A record, required for file recovery, that was to be output does not exist. | Standard error output |
KFCA02650-I | Help message | Standard output, standard error output |
KFCA02651-E | A parameter in the jnlcolc command is invalid or its value exceeds the limit. | Standard error output |
KFCA02652-E | The combination of options in the jnlcolc command is invalid. | Standard error output |
KFCA02653-E | An option in the jnlcolc command is specified incorrectly. | Standard error output |
KFCA02654-E | A file name in the jnlcolc command is specified incorrectly. | Standard error output |
KFCA02655-E | The information before and after update specified in the jnlcolc command is inconsistent. | Standard error output |
KFCA02657-E | The -k option is not specified in the jnlcolc command. | Standard error output |
KFCA02658-E | A record, required for file recovery, that is specified in the jnlcolc command is invalid. | Standard error output |
Notes
Examples
In the examples below, the generation numbers are 1,2,...
Unload journal files: sysjnl001, sysjnl002,...
(1) Integrate journal records for DAM FRC from an unload journal file that has not been split
jnlcolc -k d -f -l /OpenTP1/jnl/sysjnl001 |
(2) Integrate journal records for TAM FRC in one step from an unload journal file that has been split into three files
jnlcolc -k t -f -l /OpenTP1/jnl/sysjnl001 /OpenTP1/jnl/sysjnl002 /OpenTP1/jnl/sysjnl003 |
(3) Integrate journal records for DAM FRC in three steps from an unload journal file that has been split into four files
Step 1: jnlcolc -k d -f /OpenTP1/jnl/sysjnl001 /OpenTP1/jnl/sysjnl002 Step 2: jnlcolc -k d /OpenTP1/jnl/sysjnl003 Step 3: jnlcolc -k d -l /OpenTP1/jnl/sysjnl004 |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.