- -b {backup-file-name[,backup-file-name]...|device-symbolic-name[,device-symbolic-name]|device-group-name|object-name|policy-name}
Specifies the names of the backup files.
- When backup-file-name[,backup-file-name]... is specified:
<path name> ((up to 1023 bytes))- Specifies the names of regular files, MT devices, or HiRDB files.
- If you specify the name of a regular file or MT device, also specify -k u; if you specify the name of a HiRDB file, also specify -k i.
- When device-symbolic-name[,device-symbolic-name] is specified:
<identifier>- Specifies EasyMT device symbolic names. In this case, also specify -k e.
- When device-group-name is specified:
<identifier>- Specifies an MTguide device group name. In this case, also specify -k m.
- When object-name is specified:
<identifier>- Specifies a JP1/OmniBack II object name. In this case, also specify -k o.
- When policy-name is specified:
<identifier> ((up to 128 bytes))- Specifies a NetBackup policy name. In this case, also specify -k n.
- Rules
- If a host name is specified, an error results.
- Multiple file names can be specified only if the backup consists of multiple files. When the backup does not consist of multiple files, all file names after the first one specified are ignored. If the backup consists of multiple files, only one file is specified, and the -a option is also specified, the command terminates with an error.
Specifies the type of backup file.
- u:
- Regular file or MT special file.
- i:
- HiRDB file.
- e:
- Backup file acquired using EasyMT.
- m:
- Backup file acquired using MTguide.
- o:
- Backup file acquired using JP1/OmniBack II.
- n:
- Backup file acquired using NetBackup.
- -o backup-information-output-file-name
<path name> ((up to 1023 bytes))
Specifies a file to which the backup file information is to be output. When this option is omitted, the backup file information is output to the standard output.
Specifies that the backup file information is to be output in CSV format. When this option is omitted, the backup file information is output to the standard output.
Specifies that all information is to be output.
When this option is omitted, the command outputs the HiRDB identifier, backup acquisition mode, backup acquisition time, and whether or not a log point information file was specified.
- -s progress-message-output-interval
<unsigned integer> ((1-1024))
Specifies that progress messages are to be output during execution of the pdbkupls command, and specifies the message output interval in terms of the amount of backup file data to be processed in each interval (in gigabytes). For example, when -s 100 is specified, a progress message is displayed after each 100 gigabytes of data has been processed.
Note that this option is applicable only when the -a option is specified.
Specifies the name of the JP1/OmniBack II bar list file used when the database copy utility was executed. This option is applicable only when -k o is specified.
- Rules
- The bar list file must be found at the server machine where the JP1/OmniBack II sell server is located.
- The directory containing the bar list file is /etc/opt/omni/barlists/stream. Note that the protection specification in the bar list file is ignored.
- -U {backup-search-condition-start-date_time,backup-search-condition-end-date_time|,backup-search-condition-end-date_time}
Specifies a time period when only backup information acquired during the specified period under the specified policy is to be included in the output backup information. This option is applicable only when the NetBackup linkage facility is used (-k n is specified). When the NetBackup linkage facility is not used, this option is ignored, if specified.
If backup-search-condition-start-date_time and backup-search-condition-end-date_time are both specified, the most recent backup acquired during the specified period is used. If only backup-search-condition-end-date_time is specified, the backup that was current at the specified time is used.
- Rules
- When this option is omitted, the command uses the most recent backup among the backups acquired under the specified policy.
- You can use the bpimagelist command (with the -policy option specified) to check backup acquisition dates/times.
- When you specify a backup-search-condition-start-date_time or backup-search-condition-end-date_time, specify an underscore (_) between the date and the time, as shown below. If the time is omitted, 000000 is assumed as the start time and 235959 is assumed as the end time.
-U YYYYMMDD[_hhmmss],YYYYMMDD[_hhmmss] |
- YYYY: Year
<unsigned integer> ((1990-2037)) - Specifies the year.
- MM: Month
<unsigned integer> ((01-12))
- DD: Date
<unsigned integer> ((01-31))
- hh: Hour
<unsigned integer> ((00-23))
- mm: Minute
<unsigned integer> ((00-59))
- ss: Second
<unsigned integer> ((00-59)) - To specify the end date/time only, specify the comma (,) and then the end date/time.
- -E MT-attribute-file-name-for-EasyMT
<path name> ((up to 1023 bytes))
Specifies the name of the MT attribute definition file for EasyMT. This option is applicable only when -k e or -k m is specified.
- Rules
- This file must be connected to the server machine where the pdbkupls command is executed.
- In the MT attribute definition file, the following attributes take effect:
buffno: Number of input/output buffer sectors
magazin: MT device allocation pattern
job: Job name
expire: Expiration date
preserve: Retention days
Note that when the -B option is specified, the number of input/output buffer sectors specified in the -B option takes effect.
- The contents of this file are checked when EasyMT is executed.
- -B input/output-buffer-sectors-count-for-EasyMT
<unsigned integer> ((1-255))
Specifies the number of input/output buffer sectors to be used for MT input/output operations. This option is applicable only when -k e or -k m is specified.
- Rules
- A greater value improves performance, but more memory is required.
- If the -E and -B options are both omitted, EasyMT's default value is assumed.
- -v volume-name[,volume-name]...
<alphanumeric characters> ((up to 6 characters))
Specifies the names of MT volumes on which the backup was made. This option is applicable only when -k e or -k m is specified.
- Rules
- If a specified volume does not match a volume mounted on the MT deck, an error results.
- If the number of volumes needed for the backup is greater than the number of volumes specified, the command does not check the names of the excess volumes.
- When this option is omitted, the command does not check the volume names.
- To specify multiple volume names, you must specify -k m. In this case, make sure that no volume name is duplicated.
- -N EasyMT-file-name
<alphanumeric characters> ((up to 17 characters))
Specifies the EasyMT file name that was assigned when the backup file was acquired. This option is applicable only when -k e or -k m is specified.
- Rules
- If this file name does not match the backup file, an error results.
- The backup file must begin at the beginning of the mounted MT (at file sequence 1).