HP StorageWorks P9000 Command View Advanced Edition Suite Software 7.0 Mainframe Agent Installation and Configuration Guide (TB581-96014, November 2010)

-raw
Specify this option when you want to back up the secondary volume as a raw device. When this
extended command backs up the secondary volume as a raw device, this extended command does
not mount the secondary volume and performs a backup for each logical volume.
When this option is omitted, the extended command backs up the secondary volume as a file system
(or a database).
-force
Specify this option to forcibly mount the secondary volume. If you specify this option and the copy
group name of the primary volume obtained during backup processing on the file server (or the
database server) matches the file server (or the database server) information, the extended command
forcibly mounts the secondary volume, even if the LDEV or SERIAL numbers do not match.
If you omit this option, this extended command terminates with an error without performing mounting
if the following condition also holds: the copy group name, LDEV number, and SERIAL number of the
primary volume, that were obtained when backup was performed on the file server or database
server, do not match the information on the file server or database server.
Specify this option when it is necessary to perform a forced mount on a secondary volume using only
the copy group name of the primary volume as a key: for example, in cases such as when the
secondary volume is to be replaced for a reason such as a failure, or when an LDEV number or SERIAL
number was changed. Data may be damaged if you specify this option for a normal backup operation.
-bup_env configuration-definition-file-name
Specify this option if you wish to use a startup parameter in a user-created configuration definition
file when backing up to, or restoring from a tape device.
If you omit this option, the default configuration definition file is used. As such, you will need to create
the default configuration definition file in advance.
Create the configuration definition file in the same directory as the default configuration definition
file.
The specified configuration definition file name must fulfill the following requirements:
Maximum number of characters (total length of the directory name and file name): 255 bytes
Available characters: Characters that can be used for file names in Windows
Return Values
0: Normal termination
Any value other than 0: Termination with an error
Conditions Causing an Error
This extended command fails in the following cases:
• An invalid option is specified.
• The system could not acquire information from the definition file linked to the operation ID.
• The arguments of this extended command include an option of a Application Agent command
that cannot be used for this extended command.
• Information could not be acquired from the backup ID file.
• A command executed inside the extended command encounters an error.
• The acquisition of the result of a command executed inside the extended command failed.
• Information could not be acquired from the host environment settings file.
Extended commands42