get servers

Description

Returns the status for each of the servers that are monitored by the RMS, followed by the status of the RMS environment. The RMS status is a roll-up of the monitored servers, and shows the lowest status reported; for example, if the status of any server in the list is not “UP”, then the status for the RMS is reported as “SUSPECT”.

Syntax

get servers [[for group group_name] | [{ASA | ASE | DirectConnect | IQ |
Replication Agent | MRA | Replication Server | RMS | Open Server |
[server_name,]…}]]

Parameters

ASA, ASE, DirectConnect, IQ, Replication Agent, MRA, Replication Server, RMS, Open Server

Returns only the specified type of server monitored by the RMS. For example, returns all Replication Servers monitored by the RMS.

group_name

Specifies a group for which servers are returned.

server_name

Specifies a specific server or list of servers to return. If the server is not monitored by the RMS, an empty result set is returned.

Examples

Example 1

Returns the status for all servers monitored by the RMS, followed by the status for the RMS environment:

get servers

Example 2

Returns a list of all Adaptive Server Enterprise servers monitored by the RMS:

get servers ASE

Example 3

Returns a list that contains the information for the servers INVENTORY_RS and INVENTORY_PDS”

get servers INVENTORY_RS, INVENTORY_PDS

Usage

Servers monitored by a remote RMS are also returned by this command.

Table 9-20: Column descriptions for get servers

Column

Description

Name

The server name.

Type

The server type (Replication Server, Adaptive Server Enterprise, Replication Agent, and so forth).

Last Monitored

A timestamp indicating that last time the server was monitored by the RMS. The timestamp is in the format MM/DD/YYYY HH:MM:SS.

Version String

The complete version string of the server.

State Constant

The integer constant that defines the state of the server. See Appendix C, “RMS Server and Component States” for server state information.

State

The description that defines the state of the server. This is a string representation of the state constant.

Description

A string that describes the state of the server.

More Descriptions

Indicates whether additional information is available. If true, then the status of the server contains multiple descriptions. Use the get status descriptions command to retrieve a list of all descriptions for the server.

See also

add server, configure server, connect to server, disconnect server, drop server, get component, get status descriptions, shutdown server