Available Commands
The following section provides a list of commands that can be used by the Notes Document iDataAgent.
Note
Before you run a command, make sure to log on to the CommServe computer using the qlogin command. Similarly, use the qlogout command to log off from the CommServe computer.
qdelete
client
dataagent
Qdelete client
Description
This command can be used to deconfigure and/or delete a client, along with its agents.
By default, the qdelete client command asks for confirmation before deleting the client. You can skip the confirmation prompt with the -y option.
Upon successful completion, qdelete client displays the message "Deleted the client successfully" on the command prompt. In case of an error, an error code and description are displayed as: "client: Error errorcode: errordescription"
Usage
qdelete client [-cs <commserve_host_name>] -c <client> [-deconfigure] [-y] [-tf <tokenfile>] [-tk <token>] [-af <clientfile>] [-h]
Options
-cs |
CommServe host name |
-c |
Client computer name |
-deconfigure |
Deconfigures a client without deleting it |
-y |
Delete without confirmation |
-tf |
Reads token from a file |
-tk |
Token string |
-af |
Reads client name from a file |
-h |
Displays help |
Diagnostics
Possible exit status values are:
0 - Successful completion.
1 - CLI usage failures, due to the use of an unsupported option or missing argument.
2 - Any other failure.
Examples
-
Delete a client with name client1.
qdelete client -c client1 This command deconfigures and deletes a client, do you want to continue (y/n)? [n]
-
Deconfigure, but do not delete, a client with name client1
qdelete client -c client1 -deconfigure -y
-
Delete a set of clients specified in an argument file.
qdelete client -af "E:\clients.txt"
In this example, clients.txt is a text file containing a list of client names. Ensure that the file is in the following format:
[client] Client01 Client02 ClientXX
Note
You can mass-delete clients with or without their associated MediaAgents using the qdelete client command. You can include this command (along with the qdelete mediaagent command, if desired) in a script. Mass deletion of these items is useful if you want to remove them after a split of a CommCell. To mass-delete items where the CommCell is not split, be sure to run the script from the install location of the CommServe.
Qdelete dataagent
Description
This command deconfigures or deletes the specified agent.
By default, the qdelete dataagent command asks for confirmation before deletion. You can skip the confirmation prompt using the "-y" option.
Upon completion, qdelete dataagent displays a message that the agent was successfully deleted on the command prompt. In case of an error, an error code and description are displayed as: "dataagent: Error errorcode: errordescription"
Usage
qdelete dataagent -c client -a agent [-deconfigure] [-y] [-tf tokenfile] [-tk token] [-h]
Options
-c |
Client computer name |
-a |
The agent to be deleted (see Argument Values - Agent Types) |
-d |
Deconfigures the agent without deleting it |
-y |
Delete without confirmation |
-tf |
Reads token from a file |
-tk |
Token string |
-h |
Displays help |
Diagnostics
Possible exit status values are:
0 - Successful completion.
1 - CLI usage failures, due to the use of an unsupported option or missing argument.
2 - Any other failure.
Examples
-
Delete an agent named MyDataAgent under client client1.
qdelete dataagent -c client1 -a MyDataAgent This command deconfigures and deletes an agent, do you want to configure (y/n)
-
Deconfigure an agent named MyDataAgent under client client1 without any confirmation.
qdelete client -c client1 -a MyDataAgent -deconfigure - y