API Programming Guide › CA Enterprise Log Manager API Examples › Query and Report Viewer Calls › Query Specifications

Query Specifications

You can prequalify the results of a getQueryViewer, run getReportViewer, or runQuery call by adding specifications. You can set present detailed information that can be a subset of an existing query, or relevant to particular consumers. For example, you can use specifications to query one server for a certain type of events in the past day only.

You can set the following specifications:

• server

  Specifies the CA Enterprise Log Manager server queried. The default is localhost, the server named in the getQuery call. You can use this specification to target a different server.

• timezone

  Defines the time zone in which the query appears. The default is the time zone in which the CA Enterprise Log Manager server is running. You can use this specification to set your results in a different time zone.

• federated

  Specifies (using true or false) whether the query is applied to the appropriate federated servers. The default value is true, which applies the query across federated servers. This behavior applies the normal CA Enterprise Log Manager rules for querying federation hierarchies.

• filterXml

  Defines the data filters applied to the query, in XML format. You could use this specification to filter on hostname or other CEG fields.

• params

  Defines the result conditions applied to the query, in XML format.

• prompt

  Controls (using true or false) whether the additional prompt controls are displayed. The default value is false. This value is only valid if the query type is prompt. The value is ignored if the query is not a prompt.

  The following specifications are only used if you have set "prompt=true":

  • promptvalue

    Sets the filter value for a prompt query.

  • col

    Lists the event columns the prompt query searches. You can use multiple col terms to identify more than one target column.