IBM Tivoli Monitoring, Version 6.3

tacmd refreshCatalog

Description

Use the tacmd refreshCatalog command to update the catalog file and refresh affinity information. This command allows the data server to reread the catalog files; therefore, it eliminates the need for a Tivoli® Enterprise Monitoring Server recycle after support files are installed. Attribute files, however, are not reread, and Tivoli Enterprise Monitoring Server processing will not process this data from the agent correctly. In most cases, a Tivoli Enterprise Monitoring Server recycle is required after product seeding.

The refreshCatalog command updates the catalog file and refreshes the affinity information on the Tivoli Enterprise Monitoring Server to which it connected. Use -s|--server option to update the catalog files and refresh affinity information on a remote Tivoli Enterprise Monitoring Server. If the corresponding attribute file is manually deployed along with the catalog member the refresh catalog is intended for, then IBM® Tivoli Monitoring based situations are expected to work. However, the following items still require a recycle of the Tivoli Enterprise Monitoring Server:
  • OMEGAMON® Tivoli Event Adapter forwarding
  • Data warehousing
  • Simple Object Access Protocol (SOAP) requests

You must log in by using the login command before running the refreshcatalog command.

CLI syntax

tacmd refreshCatalog [{-s|--server} TEMSNAME]

where:
-s|--server
Specify a Tivoli Enterprise Monitoring Server name where the catalog file needs to be updated and affinity information needs to be refreshed. When this option is not specified, it operates against the Tivoli Enterprise Monitoring Server into which the tacmd is logged.

CLI example

This example updates the catalog file on the Tivoli Enterprise Monitoring Server into which the tacmd command is logged.
   tacmd refreshCatalog
This example updates the catalog file on the remote Tivoli Enterprise Monitoring Server “REMOTE_LEVER2”.
   tacmd refreshCatalog -s REMOTE_LEVER2

Return values

See Table 1.

Related commands

Return to Table 1.



Feedback