The tamfrc command recovers a TAM file from specified journal files.

-s

Specifies that the previous TAM FRC is not to be inherited.

When this option is omitted, the previous TAM FRC is inherited.

-e

Specifies that the inheritance file is to be deleted when TAM FRC terminates.

When TAM FRC is executed with this option specified, the -s option must be specified the next time TAM FRC is executed.

When this option is omitted, the inheritance file is not deleted.

-g

Specifies that TAM FRC is to be executed even if the -s option is specified and unload journal files with journal generation number 1 are not specified.

When this option is omitted, processing is cancelled.

When the -s option is omitted, this option is ignored, if specified.

-k key~((001-999)) <<001>>

Specifies the key of the applicable FRC when multiple TAM FRCs are to be executed.

In addition, specify different keys when the damfrc command and the mqafrc command are executed simultaneously with the tamfrc command or when the damfrc command, mqafrc command, and tamfrc commands are executed in succession.

To inherit the previous TAM FRC, its key must be specified.

-m

Integrates the journal records needed for file recovery on a file. When this option is omitted, a buffer area is allocated on memory for integration of journal records.

-j

Specifies that TAM FRC is to be executed using journal files integrated by the jnlcolc command.

When this option is specified, the -s, -e and -m options must not be specified.

When this option is omitted, TAM FRC is executed using unload journal files created by the jnlunlfg command.

-f recovery-target-definition-file-name~<path name>

Specifies the name of the file that defines the TAM file to be recovered.

The recovery target definition file is created in the following format, using a text editor:

[] TAM-table-nameTAM-file-name (linefeed)
[[] TAM-table-nameTAM-file-name (linefeed)]
       :    :

TAM-table-name~<1-to-32-character identifier>

Name of the TAM table to be recovered

TAM-file-name~<1-to-63-character path name>

Name of the recovery destination TAM file (full path name)

Specify a file restored from the backup file. When specifying multiple files, either the files restored from the online backup files or the files restored from the offline backup files can be specified. These two kinds of files cannot be both specified.

TAM-table-name~<character string, identifier, 1-32 characters>

Specifies the name of the TAM table to be recovered.

TAM-file-name~<path name>

Specifies the name of the TAM file to be recovered, expressed as the full path name.

journal-file-name~<path name>

Specifies the name of a journal file to be used during TAM FRC execution.

If the -j option is specified, the name of an integrating journal file must be specified; if the -j option is omitted, the name of an unload journal file must be specified.

If multiple journal generations are to be processed, all the corresponding journal file names must be specified. No more than one integrating journal file can be specified.

Recovering online backed-up files does not require all unloaded-journals files to be specified. The user has only to specify the unloaded-journals files beginning with the generation number and block number of the journal files to be recovered that are contained in the message (KFCA01738-I) that is output at completion of online backup.

Recovery of offline backed-up files requires specification of all unloaded-journals files.

• If the tamfrc command is incorrectly specified, a message with no message ID may be output to suggest the correct use of the tamfrc command.
• The file attributes (table format, record length, maximum number of records, key value, etc.) of a TAM file specified in tam-file-name must match those of a TAM file that corresponds to the TAM table accessed in the online mode.
• The jnlcolc command is used inside the tamfrc command; an error message for the jnlcolc command may be displayed. Take proper action according to the instructions contained in the manual OpenTP1 Messages.
• When the tambkup command with its -d option specified is executed to exchange the contents of a TAM file, the user must ensure matching in journal generation number. If an attempt is made to recover the TAM file (execute the tamfrc command) with generation mismatching, system operation is not guaranteed.
• When the recovery target definition file is specified by the -f option, do not specify a TAM table name or a TAM file name in the command argument.
• Set the write authority in the current directory to allow the tamfrc 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. When the tamfrc command without the -j option attempts to recover the TAM file restored from the offline backup file^#1:
     Maximum 4096 + a (bytes)
     
  2. When the tamfrc command without the -j option attempts to recover the TAM file restored from the online backup file^#2:
     Maximum 90 + 4096 + a (bytes)
     
  3. Other than above (the tamfrc command has the -j option specified):
     No temporary file is created.
     

  Legend:

  a: Total disk capacity for the unload journal file^#3 specified at execution of the tamfrc command

  #1: TAM file backed up by executing the tambkup command offline (without the -o option).

  #2: TAM file backed up by executing the tambkup command with the -o option specified.

  #3: Use the ls command of UNIX to see the total disk capacity. If two or more unload journal files are specified, the sum of their disk capacity is applicable.

• Do not specify an unload journal file that is acquired by specifying the -t option in the jnlunlfg command.