CLI Reference > Workflows and Documents Commands > im deletequery
im deletequery
deletes an existing Windchill RV&S query
im deletequery [--[no]confirm] [--hostname=value] [--port=value] [--password=value] [--user=value] [(-?|--usage)] [(-g|--gui)] [(-F value|--selectionFile=value)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=value] [--forceConfirm=[yes|no]] [user:]query...
Eventually, you may want to delete queries that you no longer use, or if you have too many to manage.
You can only delete named queries that you created unless you are an administrator and the query has been shared to you. If you are not authorized to delete the query, you are presented with an error message stating that you may not delete the selected query.
Important: You cannot delete the Quick Query; however, you can clear it in the graphical user interface or Web interface, resetting the default fields to empty values.
This command takes the universal options available to im commands, as well as some general options. See the options reference page for descriptions.
specifies whether to be prompted to confirm the deletion of the query. By default, you are prompted to confirm the deletion of the query.
specifies the name of the user who the query belongs to and the query name, for example, jhoyt:"Cosmos Critical Defects". If you are deleting your own query and if no other queries exist with the same name, you do not have to specify the user name, but you must specify the query name. Use spaces to specify more than one user and query name. This option is useful for administrators who want to delete queries that belong to users who no longer exist.
Windchill RV&S initially assumes that text before the colon (:) is a user name and text after it is a query name. If Windchill RV&S fails to find a matching user name and query name, it searches for a query name matching the exact text. For example, if you type jhoyt:CosmosDefects, Windchill RV&S searches for the CosmosDefects query created by jhoyt. If Windchill RV&S cannot find the query or user, it searches for the jhoyt:CosmosDefects query created by any user.
See Also
Commands: im copyquery, im createquery, im editquery, im viewquery, im queries
Miscellaneous: options