IBM Tivoli Monitoring, Version 6.3

tacmd histlistcollections

Description

Use the tacmd histlistcollections command to list all the collections that are started for a managed system, all the collections that are defined for a product, or all that are defined for an attribute group.

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 histlistcollections 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 histlistcollections
              {-m|--system} MANAGED_SYSTEM
              [{-u|--userid} TEPS_USERID]
              [{-w|--password} TEPS_PASSWORD]
              [{-s|--server} TEPSHOSTNAME]

tacmd histlistcollections
              {-t|--type} PRODUCTTYPE
              [{-o|--object} ATTRIBUTEGROUPNAME...]
              [{-u|--userid} TEPS_USERID]
              [{-w|--password} TEPS_PASSWORD]
              [{-s|--server} TEPSHOSTNAME]

where:

-m|--system: Specifies the managed system for which collections should be listed.
-t|--type: Specifies the product code or product name of the product to which the attribute group specified by -o|--object belongs. Use the tacmd histlistproduct command to determine the codes and names.
-o|--object: Specifies the attribute group name for which collections should be listed. Use the tacmd histlistattributegroups command to find the correct values to use.
-s|--server: Specifies the Tivoli Enterprise Portal Server hostname to log on to. By default, the local hostname is taken if you do not specify one.
-u|--userid: Specifies the user to authenticate. The software prompts you for the username if you do not specify one.
-w|--password: Specifies the password of the user to authenticate. The software prompts you for the password if you do not specify one.

The output of histlistcollections shows the defined filter, if any. For example:

tacmd histlistcollections -t nt -o "Active Server Pages"
KUIHLC001I Validating user credentials...
Collection Name        : coll1
Collection ID          : KNT_ACTSRVPG
Description            :
Product Name           : Windows OS
Attribute Group Name   : Active Server Pages
Collection Location    : TEMA
Status                 : Not started
Filter                 : *IF ( ( *VALUE Active Server Pages.ORIGINNODE *EQ Test ) )

CLI example

The following example lists a collection for the LZ product code:

histlistcollections -t KLZ

The following example lists a collection for the specified managed system name, LZ:

histlistcollections -m managedSystemName:LZ

The following example lists a collection for the LZ product code and the attribute group, Linux Disk:

histlistcollections -t KLZ -o "Linux Disk"

Return values

See Table 1.

Related commands

Return to Table 1.

Feedback