IBM Tivoli Monitoring, Version 6.3

tacmd listSystems

Description

Use the tacmd listSystems command to display a list of known managed systems, optionally filtering for the list by node, server name, and product codes. The managed system name, product code, version, and status are displayed for each managed system. When detail option is provided, a new field, IBM®, is added in the output display that states 'Yes' if the managed system is a standard IBM managed system, and states 'No' in the case of a non-standard IBM managed system.
Note: Extended version information for every agent might not always be available. When this happens, the last two digits of the version displayed are represented as "XX". This occurs for subnode agents or when agents are not enabled for Agent Deploy support.

CLI syntax

tacmd listSystems
                      [{-n|--node} MANAGED-OS]
                      [{-t|--type|--types} TYPE ...]
                      [ {-ns|--nonstandard} NON-STANDARD ]
                      [ {-d|--detail} DETAIL ]

tacmd listSystems
                      [ {-t|--type|--types} TYPE ... ]
                      [ {-s|--server|--servers} SERVER ... ]
                      [ {-ns|--nonstandard} NON-STANDARD ]
                      [ {-d|--detail} DETAIL ]

where:
-n|--node
Identifies the node, the directory on monitoring system where the OS agent is installed, for which you want to list the agents. The name of a node includes the computer where the OS agent is installed and the product code for the OS agent. For example, stone.ibm.com:LZ is the name of the node on computer stone.ibm.com, which has a Linux OS agent installed. Valid values include letters (upper or lower case), numbers, periods (.), at symbols (@), dollar signs ($), asterisks (*), number signs (#), underscores (_), colons (:) or blanks ( ).
-t|--type|--types
Identifies one or more product type codes for which to filter. The value of type is scoped to the node level.
-s|--server|--servers
The identifiers of one or more servers to filter for. Each server must connect to the hub server you are logged on to.
-ns|--nonstandard
Identifiers of the non-standard IBM managed system to filter for.
-d|--detail
Displays the output in detail.

CLI example

This command lists all of the systems in your enterprise.
   tacmd listSystems
This command lists all of the systems in your enterprise with the product code UM (universal agent systems).
   tacmd listSystems –t UM
This command lists all of the systems in your enterprise with the product code NT (NT nodes or operating system agents). This command is effective for listing all of the NT nodes in your enterprise.
   tacmd listSystems –t NT
This command lists all of the systems in your enterprise with product codes NT, LZ, or UX (NT operating system agents). This command is effective for listing all of the nodes in your enterprise.
   tacmd listSystems –t NT UX LZ
This command lists all of the systems on node Primary:STONE:NT with the product code UM (universal agent).
   tacmd listSystems –n Primary:STONE:NT –t UM
This command lists all of the systems on remote monitoring server REMOTE_TEMS5 with the product code UM (universal agent).
	tacmd listSystems –s REMOTE_TEMS5 –t UM

Return values

See Table 1.

Related commands

tacmd viewAgent

tacmd viewNode

Return to Table 1.



Feedback