IBM Tivoli Monitoring, Version 6.2.2 Fix Pack 2

tacmd exportQueries

Description

Use the tacmd exportQueries command to export one or more Tivoli Enterprise Portal queries from the Tivoli Enterprise Portal Server to an XML file.

Note:
If you want to use the current tacmd tepsLogin values for username, password, and server hostname, do not enter any of these options for the exportQueries command. If you specify values for some, but not all of these options, you are prompted to specify the username and password if they are missing.

CLI syntax

tacmd exportQueries
                       {-x|--xmlFile} XMLFILE
                       [{-u|--username} TEPS_USER]
                       [{-p|--password} TEPS_PASSWORD]
                       [{-s|--server} TEPS_HOST[:PORT]]
                       [{-q|--query} QUERY ... ]
                       [{-t|--type} TYPE ... ]
                       [{-e|--exclude} ]
                       [{-f|–force}]
            

where:

-x|--xmlFile
Specifies the name of the XML file accessible to the local file system where the query definitions are exported. The file name can either be a relative or an absolute file name.
-s|--server
Specifies which Tivoli Enterprise Portal Server to use.
-u|--username
Specifies the identifier of the user to authenticate to the Tivoli Enterprise Portal Server. The user must have 'Modify' permissions for the 'Query' object enabled on the server to execute the exportQueries command. The 'Modify' permission for the 'Query' object is disabled by default for most users. The software prompts you for the username if you do not specify one.
-p|--password
Specifies the password of the user to authenticate to the Tivoli Enterprise Portal Server. The software prompts you for the password if you do not specify one.
-q|--query
Specifies the names of one or more queries to display.
-t|--type
Specifies the IBM® Tivoli® Monitoring version 6.1 or 6.2 product type code. If a 2-character type is entered, the letter 'k' will be prepended automatically to form a 3-character product type code.
Note:
For the Monitoring Agent for UNIX OS, you must specify omunx as the product code. For example: 
./tacmd exportqueries -t omunx -x /temp/test.xml
-e|--exclude
Specifies the query names and also product types to be excluded from the operation.
-f|–force
Exports the queries without confirmation.

CLI example

The following example exports all the queries from the Tivoli Enterprise Portal Server on HDCHASDSTC0420 to the file exportQueries.xml:

tacmd exportqueries -x exportQueries.xml -s HDCHASDSTC0420 -u sysadmin -p ***** -f

Return values

See Table 6.

Related commands

Return to Table 1.

[ Top of Page | Previous Page | Next Page ]