filrstr [-y] [-q] [-{t|o|r}] [-{c|1}] backup-file-name [/OpenTP1-file-name] OpenTP1-file-system-area-name

The filrstr command restores to an OpenTP1 file system area an OpenTP1 file system backed up by the filbkup command.

The filrstr command requests confirmation from the user before restoring the OpenTP1 file system, but there is an option that enables restoration processing to be performed immediately without requesting user confirmation.

Only the superuser and a user authorized to initialize the OpenTP1 file system can execute the filrstr command.

It is also possible to restore a specified OpenTP1 file by specifying its OpenTP1 file name, but this method is usually used to collect maintenance information.

-y

Specifies that the OpenTP1 file system is to be restored immediately without requesting user confirmation.

When this option is omitted, the OpenTP1 file system is restored after the user confirms restoration.

-q

Specifies that file management information on the OpenTP1 file system is to be written in a batch and then the OpenTP1 file system is to be restored at high speed.

-{t|o|r}

Specifies the handling of restoration when the restoration source file and the restoration destination OpenTP1 file system contain the same OpenTP1 file name:

-t

Compare their most recent update dates and times and restore the OpenTP1 file from the restoration source file only if it has the more recent date and time;

-o

Do not restore an OpenTP1 file with the same name;

-r

Restore the OpenTP1 file regardless of the most recent update date and time.

{c|l}

-c

Specifies that if an OpenTP1 file in the OpenTP1 file system is being used by another process or another user, the OpenTP1 file system is not to be restored.

-l

Specifies that if an OpenTP1 file in the OpenTP1 file system is being used by another process or another user, that OpenTP1 file only is not to be restored.

backup-file-name~<path name>

Specifies the name of the file containing the backup of the OpenTP1 file system.

OpenTP1-file-name~<OpenTP1 file name>

Specifies the name of an OpenTP1 file to be restored.

When this command argument is specified, only the specified OpenTP1 file is restored.

OpenTP1-file-system-area-name~<path name>

Specifies the name of the character special file or ordinary file into which the OpenTP1 file system is to be restored. The specified character special file or ordinary file must have already been initialized as an OpenTP1 file system.

• The filbkup command backs up an invalid file whose file management table has been isolated due to process cancellation. If the -r option is specified and a file is found with the same name as such an invalid file, that file will be replaced with the invalid file. For this reason, the -t or -o option should usually be specified.
• If an OpenTP1 file in the specified OpenTP1 file system is being used by another process or another user, the OpenTP1 file system will not be restored unless the -l option is specified for forcible restoration.
• If the filrstr command is executed without the restoration destination OpenTP1 file system having been initialized, the previous OpenTP1 files are retained after the filrstr command has executed, because the OpenTP1 file system is restored in units of OpenTP1 files.
• If the record length of a file in the backup file is less than the sector length of the restoration destination special file, or if it is not a multiple of the sector length of the restoration destination special file, that file will not be restored and restoration processing will be performed on the next file.
• If the OpenTP1 file system was not backed up correctly, a warning message is issued and restoration processing on the OpenTP1 file system is resumed.
• If you create a backup file using the filbkup command that can handle an OpenTP1 file system up to 4 GB or OpenTP1 files of up to 4 GB, you cannot restore the file using the filrstr command, since it can only handle up to 4 GB. If you use the filbkup command, which cannot handle 4 GB for an OpenTP1 file system of 4 GB, operation is not guaranteed.
• If the filrstr command terminates abnormally due to an error or in response to the kill command provided with the operating system, the integrity of the OpenTP1 file system will be compromised. If this occurs, remove the cause of the error and restore the file system.
  If the filrstr command with the -q option specified terminates abnormally, the management information for the OpenTP1 file system is restored at the end of the restoration process, and the file system will no longer be recognized as the OpenTP1 file system. If this occurs, initialize the OpenTP1 file system.