CLI Reference > Workflows and Documents Commands > im queries
 
im queries
displays the list of queries
Synopsis
im queries[--fields=field1[:width1],field2[:width2]...] [--fieldsDelim=value] [--height=value] [--width=value] [-x value][-y value] [--user=value] [--hostname=value] [--password=value] [--port=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]] query...
Description
im queries displays the list of Integrity Lifecycle Manager queries. By default, the command displays all queries that are currently shared to you.
Options
This command takes the universal options available to im commands, as well as some general options. See the options reference page for descriptions.
--fields=field1[:width1],field2[:width2]...
specifies the query fields to display and the width of each field in characters. If the output is directed to the GUI, the width is specified in pixels.
For example,
im queries --fields=name,description,lastModified --fieldsDelim=, "Release 2 Features"
displays the name, description, and date of the last modification for the Release 2 Features query, with each field separated by a comma.
The query fields you can specify are:
createdBy
displays the name of the user who created the query.
description
displays a description of the query.
fields
displays the fields visible in the associated column set.
id
displays the database ID of the query. This is for PTC Technical Support only.
image
displays whether there is an image, and if so, whether it uses the default funnel image or a custom image.
lastModified
displays the date the query was last modified.
name
displays the name of the query.
shareWith
displays the users and groups that the query is shared with.
sortDirection
displays the order that issues display in the associated column set.
sortfield
displays the field that issues are sorted by in the associated column set.
queryDefinition
displays the query definition that specifies the query constraints.
references
displays all system provided and user objects that reference the query.
isAdmin
displays whether the query is a system provided object.
--fieldsDelim=value
specifies the string to be used as a delimiter between fields.
query...
identifies the names of the queries to view.
SEE ALSO
Commands: im copyquery, im createquery, im deletequery, im editquery, im viewquery
Miscellaneous: options