OpenTP1 Version 7 Operation
damfrc (Recover logical files)
Format
damfrc [-s] [-e] [-g] [-k key] [-n] [-m] [-c] recovery- definition-file-name journal-file-name [[journal-file-name]...] |
Function
The damfrc command uses specified journal files to restore logical files specified in the DAM service definition to their status immediately before an error occurred.
If the damfrc command is executed for a file not to be recovered, the file cannot be recovered.
Options
-s
Specifies that the previous DAM FRC is not to be inherited.
When this option is omitted, the previous DAM FRC is inherited.
-e
Specifies that inheritance files are to be deleted upon termination of DAM FRC.
When DAM FRC is executed with this option specified, the -s option must be specified the next time DAM FRC is executed.
When this option is omitted, inheritance files are not deleted.
-g
Specifies that DAM FRC is to be executed even if the -s option is specified and an unload journal file with journal generation number 1 is not specified.
When this option is omitted, processing is cancelled if the -s option is specified and journal generation number 1 is not specified as an unload journal file.
When the -s option is omitted, this option is ignored, if specified.
-k key~((001-999)) <<001>>
Specifies the key of the DAM FRC that is to be executed when multiple DAM FRCs are to be executed. A different key must be specified for each DAM FRC.
In addition, when you execute the damfrc command together with the tamfrc command and the mqafrc command, or execute the tamfrc command, mqafrc command, and damfrc command in succession, you must specify a different key for each command.
To inherit a previous DAM FRC, its key must be specified.
-n
Specifies that the DAM files are to be recovered from the data obtained by changing the FJ in the integrated journal file.
When this option is omitted, the data before and after the FJ change in the integrating journal file is checked for its validity. If the data is valid, the DAM files are recovered from the data obtained after the change.
-c
Specifies that the DAM files are to be recovered by treating the journal files specified in the command arguments as an integrating journal file created by the jnlcolc command.
When this option is omitted, the journal files specified in the command arguments are treated as unload journal files. Therefore, the damfrc command must be executed after an integrating journal file is created with the jnlcolc command.
-m
Integrates journal records needed for file recovery on a file. If this option is not specified, a buffer area is allocated on memory and journal records are integrated in the area.
Command arguments
recovery-definition-file-name~<path name>
Specifies the name of the file that defines the DAM files to be recovered.
The definition file subject to recovery must be created using the text editor in the following format:
[] logical-file-name physical-file-name[](linefeed) [logical-file-name physical-file-name][](linefeed) : : |
journal-file-name~<path name>
Specifies the name of a journal file to be used during DAM FRC execution.
If the -c option is specified, the name of an integrating journal file must be specified; if it is omitted, the names of unload journal files must be specified.
If multiple generations of a journal are to be processed, the corresponding journal file names must be specified. No more than one integrating journal file can be specified.
When an online backed-up file is recovered, not all unload journal files need be specified. Specify unload journal files with higher generation numbers and block numbers than those of the target journal file specified in the message (KFCA02531-I) that was displayed at completion of online backup. To recover a file backed up in the offline mode, specify all unload journal files.
Notes
Examples
The examples are based on the following information, where generation numbers are assigned consecutively (1,2,...):
(1) Execution of DAM FRC in one step using multiple unload journal files
damfrc -se /work/damdef /jnldir/jn1001 /jnldir/jn1002 |
(2) Execution of DAM FRC in three steps
Step 1: damfrc -s /work/damdef /jnldir/jnl001 jnldir/jnl002 Step 2: damfrc /work/damdef /jnldir/jnl003 Step 3: damfrc -e /work/damdef /jnldir/jnl004 |
(3) Execution of two DAM FRCs simultaneously in one step
First DAM FRC: damfrc -se -k001 /work/damdef1 /jnldir/jnl001 Second DAM FRC: damfrc -se -k002 /work/damdef2 /jnldir/jnl001 /jnldir/jnl002 |
(4) Execution of DAM FRC in one step using intermediate unload journal files
damfrc -seg /work/damdef /jnldir/jnl002 /jnldir/jnl003 |
(5) Execution of DAM FRC in one step using an integrating journal file
damfrc -sec /work/damdef /jnldir/jnlcolc01 |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.