Use XML to modify subclient properties. Run the operation from the command line, or automate configuration by combining command line operations in a script.
The XML parameters can be included in the XML file, or specified on the command line when they frequently change. For more information on command line parameters and XML elements, see Command Line - Syntax.
Procedure
-
On the SAP for Oracle Agent host, run the qlogin command to log on to the CommServe computer.
-
Download the modify_subclient_template.xml file and save it on the computer where you will run the command.
-
Open the modify_subclient_template.xml file, add your specific parameters and save the file.
For information on supported subclient XML parameters, see SAP for Oracle Subclient XML Parameters.
-
On the command line, go to Software_Installation_Directory/Base and type the command.
qoperation execute -af $[xml_path]\modify_subclient_template.xml -subClientEntity/appName '$[SAP for Oracle]' -subClientEntity/clientName '$[client_name]' -subClientEntity/instanceName '$[dbname]' -subClientEntity/Subclient name '$[subclient_name]'
Examples
Rename a subclient
To rename the subclient set the following elements:
|
Parameter |
Value |
|---|---|
|
subclientName |
The existing subclient name, in this example, "subclient1". |
|
newName |
The new subclient name, in this example, "subclient1a". |
qoperation execute –af modify_subclient_template.xml -subClientEntity/appName '$[SAP for Oracle]' -subClientEntity/clientName '$[cn]' -subClientEntity/instanceName '$[instance]' -subClientEntity/subclientName '$[subclient1]' -newName '$[subclient1a]'
Configure the Number of Backup Streams for a Subclient
To configure subclient set the following elements:
|
Parameter |
Value |
|---|---|
|
numberOfBackupStreams |
The number of backup streams, in this example, "5". |
qoperation execute –af modify_subclient_template.xml -subClientEntity/appName '$[SAP for Oracle]' -subClientEntity/clientName "$[saporavm1]" -subClientEntity/instanceName "$[TRD]" -subClientEntity/subclientName "$[util_data_only]" -numberOfBackupStreams "$[5]"