Use XML to rename Oracle subclients. 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 Oracle Agent host:
-
On the Oracle Agent host, run the qlogin command to log on to the CommServe computer.
-
Download the UpdateSubclient.xml file to the computer where you will run the command.
-
Open the UpdateSubclient.xml file, add your specific parameters and save the file.
For information on supported subclient XML parameters, see XML Parameters for Oracle Subclient Configuration.
-
On the command line, go to Software_Installation_Directory/Base and type the following command.
qoperation execute -af <xml_path>\update_subclient_template.xml -appName 'Oracle' -clientName '<client_name>' -instanceName '<dbname>' -subclientName '<subclient_name>' -newName '<new_subclient>'
Examples
Renaming a Subclient
To rename a subclient, specify the following parameters:
-
newName - set to new subclient name
qoperation execute -af update_subclient_template.xml -appName 'Oracle' -clientName dbserve4 -instanceName RDMDB -subclientName 'subclient_offline' -newName 'new_subclient'