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

• When a reserved character or a one-byte space character is used, the entire value must be enclosed
in double quotation marks (").
• If the value contains a reserved character, but is not enclosed in double quotation marks, the re-
served character is not correctly interpreted as a part of the backup-comment, and is parsed as a
reserved character.
• The following reserved characters cannot be used in backup comments: \ / ` | < > " * ?
& ; ( ) $
A hyphen (-) cannot appear as the first character in the backup comment. If you specify two consecutive
double quotation marks ("") after the -comment option, no backup comment will be registered in
the backup catalog.
-rc name-identifying-the-generation
Use this option to specify the name identifying the generation of the copy group to be backed up.
Execute the drmsqldisplay command with the -cf option specified, and then specify a value for
the displayed GEN-NAME. For single volumes, a hyphen (-) appears. In this case, the -rc option
cannot be specified.
Always specify this option when backing up from a primary volume to a secondary volume on the
remote side. If you omit this option, the secondary volume on the local side is backed up.
If you omit the name-identifying-the-generation parameter, the secondary volume that has the smallest
value among the generation numbers on the remote side becomes the backup destination. In this
case, the generation number is remote_n, where n is the smallest generation number.
-pf copy-parameter-definition-file
Specify this option to use the number of retries and retry interval defined in the copy parameter
definition file. Specify the copy-parameter-definition-file parameter as a file name only; do not specify
the parameter as a path.
If you omit this option, the value in the RAID Manager-linkage definition file (DEFAULT.dat) is used.
The values in the RAID Manager-linkage definition file (DEFAULT.dat) are used for any parameters
that are not included in the copy parameter definition file.
You can create a copy parameter definition file using any name you choose. Specify the file name
by using an alphanumeric character string that is 64 bytes or less. You must save the copy parameter
definition file in the following folder: Application-Agent-installation-directory\DRM\conf\raid
-script user-script-file-name
Specify this option to execute a user script. Specify user-script-file-name as an absolute path. The
conditions for specifying a value in the user-script-file-name parameter are as follows:
• The value must be 255 bytes or less.
• The value can use alphanumeric, one-byte space, and multi-byte characters.
• The value is case sensitive.
• If the value contains space characters, the entire parameter must be enclosed in double quotation
marks (").
• The following reserved characters cannot be used in the parameter: \ / : * ? | < > "
If you specify LOCAL_BACKUP=NO in the user script file, an error will occur when the command is
executed.
If you specified LOCATION=REMOTE in the user script file, you must also specify the -s option.
-s backup-server-name
Specify this option to connect to a remote backup server to perform a backup. Specify the
backup-server-name parameter by using the host name or the IP address of the backup server. Specify
Extended commands50