damfrc (Recover logical files)

-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.

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)
        :              :

logical-file-name~<identifier, 1-8 characters>: Specifies the logical file name of a DAM file to be recovered.

physical-file-name~<path name>: Specifies the recovery destination physical file name, expressed as the full path name.; The physical file to be specified is a restored file that has been backed up. Specify a restored file backed up in either the online or offline mode. Online and offline backed-up files cannot coexist.

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.

If the damfrc command is incorrectly specified, a message with no message ID may be output to suggest the correct use of the damfrc command. The jnlcolc command is used inside the damfrc command; an error message for the jnlcolc command may be displayed. Take proper action according to the instructions contained in the manual OpenTP1 Messages.
Set the write authority in the current directory to allow the damfrc command to create a temporary file in the current directory under the following conditions. The disk capacity of the temporary file is as follows:
1. If the damfrc command is executed without the -c option to recover a DAM file restored from the offline backup file^#1:
  Maximum 4096 + a (bytes)
2. If the damfrc command is executed without the -c option to recover a DAM file restored from the online backup file^#2:
  Maximum 90 + 4096 + a (bytes)
3. Other than above (the damfrc command has the -c option specified):
  No temporary file is created.
Legend:
a: Total disk space used by the unload journal file^#3 specified at execution of the damfrc command.
#1
When the dambkup command was executed to back up the DAM file in offline mode (without the -o option).
#2
When the DAM file was backed up by using the dambkup command with the -o option.
#3
Use the ls command in UNIX to find out the total disk space used by the unload journal file. If two or more unload journal files are specified, the sum of their disk capacity applies.
Do not specify an unload journal file that is acquired by specifying the -t option in the jnlunlfg command.

The examples are based on the following information, where generation numbers are assigned consecutively (1,2,...):

Definition files subject to recovery:: damdef, damdef1,...

Unload journal files:: jnl001, jnl002,...

Integrating journal file: jnlcolc01

(1) Execution of DAM FRC in one step using multiple unload journal files

Definition file name subject to recovery:: /work/damdef

Unload journal file names:

/jnldir/jnl001, /jnldir/jnl002

damfrc -se /work/damdef /jnldir/jn1001 /jnldir/jn1002

(2) Execution of DAM FRC in three steps

Definition file name subject to recovery:: /work/damdef

Unload journal file names:

/jnldir/jnl001, /jnldir/jnl002, /jnldir/jnl003, /jnldir/jnl004

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

Definition file names subject to recovery:: /work/damdef1, /work/damdef2

Unload journal file names:

/jnldir/jnl001 (used for both DAM FRCs)

/jnldir/jnl002 (used for the second DAM FRC only)

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

Definition file name subject to recovery:: /work/damdef

Unload journal file names:

/jnldir/jnl002, /jnldir/jnl003

damfrc -seg /work/damdef /jnldir/jnl002 /jnldir/jnl003

(5) Execution of DAM FRC in one step using an integrating journal file

Definition file name subject to recovery:: /work/damdef

Integrating journal file name:

/jnldir/jnlcolc01

damfrc -sec /work/damdef /jnldir/jnlcolc01