IBM Tivoli Monitoring, Version 6.3

tacmd histconfiguregroups

Description

Use the tacmd histconfiguregroups command to configure the provided attribute group or attribute groups with the specified input values. The command configures the collection settings of the default collection for each attribute group unless you specify the -m|--summarizationonly option.

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 histconfiguregroups 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.

Note: The -c|--collectioninterval, -l|--collectionlocation and -i|--warehouseinterval options cannot be specified with the -m|--summarizationonly option.

CLI syntax

tacmd histconfiguregroups
              {-t|--type} PRODUCTTYPE
              {-o|--object} ATTRIBUTEGROUPNAME...
              [{-c|--collectioninterval} COLLECTIONINTERVAL]
              [{-l|--collectionlocation} COLLECTIONLOCATION]
              [{-i|--warehouseinterval} WAREHOUSEINTERVAL]
              [{-d|--summarizationdetails} SUMMARIZATIONDETAILS]
              [{-p|--pruningdetails} PRUNINGDETAILS]
              [{-u|--userid} TEPS_USERID]
              [{-w|--password} TEPS_PASSWORD]
              [{-s|--server} TEPSHOSTNAME]

tacmd histconfiguregroups
              {-m|--summarizationonly}
              {-t|--type} PRODUCTTYPE
              {-o|--object} ATTRIBUTEGROUPNAME...
              [{-d|--summarizationdetails} SUMMARIZATIONDETAILS]
              [{-p|--pruningdetails} PRUNINGDETAILS]
              [{-u|--userid} TEPS_USERID]
              [{-w|--password} TEPS_PASSWORD]
              [{-s|--server} TEPSHOSTNAME]

where:

-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. The User ID must not contain any blank space characters in it, and its maximum allowed length is 10 characters and it must not begin with '*' or '_' character. The User ID specified must have Configure History permission.
-w|--password: Specifies the password of the user to authenticate. The software prompts you for the password if you do not specify one.
-t|--type: Specifies the product code or product name to list its attribute groups. Use the tacmd histlistproduct command to determine the codes and names.
-o|--object: Specifies the attribute group name(s) to be configured. When multiple attribute groups are specified, each attribute group must be separated by a space. Use the tacmd histlistattributegroups command to find the correct values to use.
-m|--summarizationonly: Specifies the flag for configuring only the summarization and pruning settings.
-c|--collectioninterval: Specifies the collection interval. The acceptable inputs are 1m (1 minute), 5m, 15m, 30m, 1h (1 hour), or 1d (1 day). The default value is 15m (15 minutes).
-l|--collectionlocation: Specifies where the data collection is stored. The acceptable inputs are TEMA or TEMS. The default value is TEMA.
-i|--warehouseinterval: Specifies the warehouse interval. The acceptable inputs are 15m (15 minutes), 30m, 1h (1 hour), 12h, 1d (1 day), or off. The default value is 1d (1day).
-d|--summarizationdetails: Specifies the summarization details. If this option is not specified, summarization will be disabled. This option can be given as YQMWDH where Y=Yearly,Q=Quarterly,M=Monthly,W=Weekly,D=Daily, and H=Hourly.
-p|--pruningdetails: Specifies the pruning details. If this option is not specified, pruning will be disabled. This option can be given as Y=1y,Q=1y,M=2m,W=2m,D=1d,H=2d,R=2d where Y=Yearly,Q=Quarterly,M=Monthly,W=Weekly,D=Daily,H=Hourly, and R=Detailed data.

CLI example

This example configure the attribute group “NT Processor” for historical data collection:

tacmd histconfiguregroups -s LEVER2 -t “Windows OS” -o “NT Processor ” 
-c 5m -l TEMS -i 1h  -d YQMWDH -p Y=1y,Q=2y,M=3m,W=4m,D=5d,H=6d,R=7d  
-u Administrator  -w tivoli123$

Return values

See Table 1.

Related commands

Return to Table 1.

Feedback