IBM Tivoli Monitoring, Version 6.3

tacmd cleanMS

Description

Use the tacmd cleanMS command to delete the entries for offline managed systems from the Tivoli Enterprise Monitoring Server. You must log in by using the tacmd login command before you run the tacmd cleanMS command.

Note: Specifying tacmd cleanMS shows you the prompt information. You must specify either the -m option, the -a option, or the -g option to clear any offline entries.

Note: If an error is encountered while clearing one or more offline managed system entries, the command logs the name of the managed system and the nature of the failure to the log file and continues to process the other offline entries.

Note: You cannot use the -m option if you are also using the -p option.

Note: In large-scale environments with significant numbers of nodes registered (for example, 10-20 thousand), using the tacmd cleanMS command or removing a node through the TEPS console can take several seconds to complete. If the -a option is used with the tacmd cleanMS command, and there are many offline nodes, the tacmd cleanMS command might take a long time to complete (that is, hours).

CLI syntax

tacmd cleanMS {-m|--systems} MANAGEDSYSTEMNAME...

tacmd cleanMS {-g|--age} NUMDAYSOFFLINE [-p|-- preview]

tacmd cleanMS {-a|--all} [-p|--preview]

where:

-m|--systems: Specifies the name of the offline managed systems in the Tivoli Enterprise Monitoring Server. Valid values include letters (upper or lowercase), numbers, periods (.), at symbols (@), dollar signs ($), asterisks (*), number signs (#), underscores (_), colons (:) or blanks ( ).
-g|--age: Clears all the offline managed system entries present in the Tivoli® Enterprise Monitoring Server that have been offline for NUMDAYSOFFLINE or more.
-a|--all: Clears all the offline managed system entries present in the Tivoli Enterprise Monitoring Server.
-p|--preview: Checks the number of offline managed system entries present in the Tivoli Enterprise Monitoring Server, according to chosen condition. Only a simulation of clearing occurs to obtain the number of offline affected entries. Also specifies the names of eligible managed systems to be deleted.

CLI example

This example clears all the offline managed systems present on the Tivoli Enterprise Monitoring Server.

tacmd cleanms –a

This example clears the offline entries for the two managed systems specified:

tacmd cleanms –m Primary:HDCHASDSTC0061:NT  HDCHASDSTC0061:UA

Note: When Universal Agent nodes that have sub nodes are specified with the -m option, the command will delete the offline entries for the sub nodes as well after prompting for your confirmation.

Return values

See Table 1.

Related commands

Return to Table 1.

Feedback