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

Arguments
operation-ID
A character string that uniquely identifies the operation to be performed. Information in the operation
definition file linked to the specified operation ID is used when executing an extended command.
-cg copy-group
When usual operation is in the split state, specify the name of the copy group to clear the cache of
the secondary volume. When the copy group to be used at the next backup is identified, specify the
copy group. When the copy group to be used at the next backup is not identified, specify all the copy
groups.
-cg_file copy-group-list-file
When usual operation is in the split state, use an absolute path name to specify the copy-group list
file that records the copy group for which you want to clear the cache of the secondary volume. Use
this option if you want to clear the caches for many copy groups at the same time. When the copy
group to be used at the next backup is identified, specify the copy group. When the copy group to
be used at the next backup is not identified, specify all copy groups.
Note
Before you attempt to back up the file system or the database to a secondary volume, execute this
extended command for all secondary volumes of resources to be backed up. Assume that you back
up data without clearing the cache of the secondary volume. In this case, when you mount the
secondary volume, the existing cache is overwritten to the secondary volume and the backup data
may be destroyed.
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 operation definition file linked to the operation
ID.
• The backup ID could not be acquired from the backup ID file (when the copy group was not spe-
cified).
• Information could not be acquired from the copy-group list file (when the file was specified).
• Information could not be acquired from the host environment settings file.
• No storage directory for extended-command temporary files has been specified in the operation
definition 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.
• The command fails to obtain the name of the dictionary map files storage directory.
Examples
• In this example, the extended command is used to clear the cache of the secondary volume that
belongs to the CG001,dev01 copy group:
CLI Reference Guide 37