damrstr [-c batch-processing-blocks-count][-e restore-destination-physical-file-block-length|-p restore-destination-physical-file-block-length] {backup-file-name physical-file-name|-s physical-file-name}

The damrstr command restores to a specified physical file data or standard input data from a file backed up by the dambkup command.

-c batch-processing-blocks-count~<unsigned integer> ((1-2147483647)) <<10>>

Specifies the number of blocks to be input or output simultaneously.

-e restore-destination-physical-file-block-length~<unsigned integer> ((sector-length x n-8))

Specifies the block length of the restore destination physical file in bytes, up to a maximum of 32,760 bytes. Specify a value that is either the same as or larger than the block length of the backup source physical file. Specifying this option maintains the block structure of the backup source physical file. The extended portions of each block in the restore destination DAM file are filled with NULL characters. If you omit this option and the -p option, the file is restored with the same block length as the backup source physical file.

-p restore-destination-physical-file-block-length~<unsigned integer> ((sector-length x n-8))

Specifies the block length of the restore destination physical file in bytes, up to a maximum of 32,760 bytes. Specify a value that is either the same as or larger than the block length of the backup source physical file. If you specify this option, the restore destination physical file does not keep the block structure of the backup source physical file because the backup data is saved starting from the first block in the destination file. If you omit both this option and the -e option, the file is restored with the same block length as the backup source physical file.

-s

This option must be specified when the restore source is a standard input.

file-name~<path name>

Specifies the name of the restore source file.

This command argument cannot be specified with the -s option.

physical-file-name~<path name>

Specifies the physical file name of the restore destination DAM file, expressed as the full path name.

• If message KFCA02587-E is output with cause code CREATE (physical file allocation processing) and reason code 1514, take the following countermeasures:
  
  • When no block length is specified for the restore destination physical file
    The block length of the specified backup file is not supported in the environment where the damrstr command was executed. Execute the damrstr command again, specifying the block length of the restore destination physical file (using the -e or -p option).
    
  • When a block length is specified for the restore destination physical file
    The block length specified for the restore destination physical file (using the -e or -p option) is not supported in the environment where the damrstr command was executed. As the physical file block length, specify the value obtained by the formula (sector-length-of-restore-destination-file-system x n - 8). Specify a block length that is the same as or larger than that of the backup source physical file.
    
• You cannot restore a backed up file to an existing physical file that has a shorter block length than the backup source physical file.
• When you specify the -e option, you cannot restore a backed up file to an existing physical file that has a lower block count than the backup source physical file.
• When you specify the -p option, you cannot restore a backed up file in which the user data occupies a greater number of blocks than the block count of the existing restore destination physical file.
• When you specify the -p option, you can determine the block count required of the restore destination physical file by using the following formula (rounding up to a whole number):
  backup-source-physical-file-block-length x backup-source-physical-file-block-count / restore-destination-physical-file-block-length
  
• You cannot specify the -e or -p option when you restore physical file data that was backed up using the dambkup command in online mode.
• You cannot specify a DAM file whose block length has been extended as the recovery definition file in the damfrc command arguments.
• The maximum block length you can specify with the damrstr command is 32,760.
• With the -e or -p option, if you specify a larger block length than that of the backup source physical file, review the size of the I/O area specified as an argument of the DAM access function that is accessing the physical file.
• If the physical file specified in the physical file name argument is yet to be allocated, the access rights to the physical file will be 0644 (read/write permission by the owner, read permission by the group, and read permission by others).