HP P9000 Replication Manager Software 7.3.1-00 Application Agent CLI Reference Guide

replaced because of a failure or other reason, or when an LDEV number or SERIAL number was
changed. Data might be lost if you specify this option for a normal backup operation.
-bup_env configuration-definition-file-name
Specify this option if you want 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. For further information, see the description of configuration definition file creation in the HP P9000
Replication Manager Software Application Agent CLI User Guide.
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 cannot acquire information from the definition file linked to the operation ID.
• The arguments of this extended command include an option of an Application Agent command
that cannot be used for this extended command.
• Information cannot 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 fails.
• Information cannot be acquired from the host environment settings file.
• No storage directory for extended-command temporary files is specified in the operation definition
file.
• The command fails to obtain the name of the directory where dictionary map files are stored.
Examples
• In this example, the extended command is used to back up the secondary volume as a raw device,
based on the settings in the operation definition file operation01:
EX_DRM_TAPE_BACKUP operation01 -exopt -raw
• In this example, the extended command is used to forcibly mount the secondary volume identified
by the operation ID operation01 and execute a tape device backup:
EX_DRM_TAPE_BACKUP operation01 -exopt -backup -force
Application Agent CLI Reference Guide 43