IBM Tivoli Monitoring, Version 6.3

tacmd histeditcollection

Description

Use the tacmd histeditcollection command to edit the given collection by using specified inputs.

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 histeditcollection 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 histeditcollection
              {-a|--name} COLLECTIONNAME
              [{-n|--newname} DESCRIPTION]
              [{-e|--description} DESCRIPTION]
              [{-c|--collectioninterval} COLLECTIONINTERVAL]
              [{-l|--collectionlocation} COLLECTIONLOCATION]
              [{-i|--warehouseinterval} WAREHOUSEINTERVAL]
              [{-f|--filter} FILTERFORMULA]
              [{-s|--server} TEPSHOSTNAME]
              [{-u|--userid} TEPS_USERID]
              [{-w|--password} TEPS_PASSWORD]

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.
-w|--password: Specifies the password of the user to authenticate. The software prompts you for the password if you do not specify one.
-a|--name: Specifies the name or the ID of the historical collection to edit.
-n|--newname: Specifies the new name to be used for indicated collection. A value of 256 bytes is the maximum value.
-e|--description: Specifies the description of the named historical collection to edit. A value of 64 bytes is the maximum value.
-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 (1 day).
-f|--filter: Specifies the formula used to filter data stored at the binary file. You can remove an existing filter for the indicated collection by specifying this option.

CLI example

The following example edits a collection called newCollection:

tacmd histeditcollection -a newCollection

The following example edits a collection called NewCollection to have a new name, New_Coll, a description, a collection interval of 1 hour, a collection location of TEMS, and a warehouse interval of 12 hours:

tacmd histeditcollection -a NewCollection -n New_Coll -e description 
-c 1h -l TEMS -i 12h

The following example edits a collection with a formula used to filter the data stored at the binary file:

tacmd histeditcollection -a coll1 
-f "*IF ( ( *VALUE Active_Server_Pages.System_Name *EQ Test ) )"

Return values

See Table 1.

Related commands

Return to Table 1.

Feedback