tacmd histcreatecollection

Use the tacmd histcreatecollection command to create 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 histcreatecollection 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 -o|--object option cannot have multiple values when the -a|--name option has been specified.

CLI syntax

tacmd histcreatecollection
              {-a|--name} COLLECTIONNAME
              [{-e|--description} DESCRIPTION]
              {-t|--type} PRODUCTTYPE
              {-o|--object} ATTRIBUTEGROUPNAME
              [{-c|--collectioninterval} COLLECTIONINTERVAL]
              [{-l|--collectionlocation} COLLECTIONLOCATION]
              [{-i|--warehouseinterval} WAREHOUSEINTERVAL]
              [{-f|--filter} FILTERFORMULA]
              [{-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 used 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.
-t|--type: Specifies the product code or product name. Use the tacmd histlistproduct command to determine the codes and names.
-o|--object: Specifies the attribute group name to be configured. Use the tacmd histlistattributegroups command to find the correct values to use.
-a|--name: Specifies the name of collection to create or modify. Do not use the ampersand (&) when specifying this name. The maximum value for this option is 256 bytes.
-e|--description: Specifies the description of the named historical collection to create. The maximum value for this option is 64 bytes.
-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. By default no filter is applied if you do not specify one.

CLI example

The following example creates a collection called newCollection for the BIX InterChange Server Memory attribute group:

tacmd histcreatecollection -a newCollection -t BIX -o 

"BIX InterChange Server Memory"

The following example creates a collection called newCollection for the AMN TMW DNS Response Time attribute group with a description, a collection interval, a collection location, and a warehouse interval:

tacmd histcreatecollection -a newCollection -t AMN -o "AMN TMW DNS Response Time" 

-e "Response Time" -c 30m -l TEMS -i 12h

The following example creates a collection with a specified warehouse interval of 15 minutes and a collection interval of 30 minutes:

tacmd histcreatecollection -a newCollection -t KNT -o "DNS Query" -i 15m -c 30m

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

tacmd histcreatecollection -a coll1 -t nt -o "Active Server Pages" -f "*IF 

( ( *VALUE Active_Server_Pages.System_Name *EQ Test ) )"