dambkup (Back up a physical file)
Format
dambkup [-c batch-processing-blocks-count] [-o|-d]
{physical-file-name backup-file-name|-s physical-file-name} |
Function
The dambkup command backs up the contents of a specified physical file into a specified file or standard output.
Options
-c batch-processing-blocks-count~<unsigned integer> ((1-2147483647)) <<10>>
Specifies the number of blocks to be input or output simultaneously. The specified number of blocks will be input from or output to disk.
-o
Backs up physical files in the online mode. This option is valid only when the target DAM file is in the online mode. If the option is not specified, physical files are backed up in the offline mode. In this case, take the following steps to back up a file:
- Execute the damhold command to shut down the logical files logically.
- Execute the damrm command to remove the logically shut down logical files from the online system.
- Execute the dambkup command with its -o option not specified to back up the DAM file.
-d
Backs up only the user data in the backup source physical file, excluding the management block and the check bytes at the start of the file.
-s
This option must be specified to output the backup to the standard output.
Command arguments
physical-file-name~<path name>
Specifies the name of the backup source physical file, expressed as the full path name.
backup-file-name~<path name>
Specifies the name of the backup destination file.
This command argument cannot be specified with the -s option.
Notes
- The dambkup command cannot be executed for DAM files used in the online mode if its -o option is not specified.
- Upon completion of backing up, a message (KFCA02531-I) is displayed. This message is usually output to the standard output, but output to the standard error output when the -s option is specified.
- The message contains the generation number and block number of the journal file to be recovered. Unload journal files with higher generation numbers and block numbers are needed when the DAM file is recovered.
- The dambkup command that is executed with its -o and -s options specified may terminate abnormally and the KFCA00107-E message is output when the amount of available area under current directory is smaller than the following:
Capacity of DAM file to be backed up + 128 bytes or greater ((Number of blocks + 1) x block length)
In this case, check the disk capacity, delete the unnecessary file, and then allocate the area.
- Data backed up using the -d option cannot be restored to a physical file.
- You cannot extract only user information from a DAM file that is being used in online mode.