server ping

server ping server_name_list [-timeout timeout_method]

Options

-timeout timeout_method
Specifies the timeout method to use during communication with the server. Legal values are: min (the default), max or default.

Description
The server ping operation queries a server to see whether it is receiving requests. This operation communicates directly with the server. The server_name_list argument is a list that identifies the servers to ping.

The -timeout option controls the communication timeout used in contacting the server being pinged. Use min for speed, max for accuracy, and default for a compromise between speed and accuracy.

This operation returns a list of values, one for each server specified in the argument, in the same order. The values are 1 if the server is listening for RPC requests, 0 if not.

Each argument can be in one of the following formats:

· The name of a server entry in the namespace to be imported from. For example:

/.../brain_cell/hosts/wardr/event_server

· A string binding with an object UUID specified. For example:

{00337ea9-d979-1dd8-923f-0000c08adf56 ncacn_ip_tcp 15.121.12.72}

· A string binding with an endpoint specified. For example:

{ncacn_ip_tcp 15.121.12.72 1075}

· An interface ID followed by a hostname, separated by commas. For example:

{4885772c-c6d3-11ca-84c6-08002bic8fif,oddball}

· An interface ID followed by an object UUID and a hostname, separated by commas. For example:

{4885772c-c6d3-11ca-84c6-08002bic8fif,
019ee420-682d-1109-a607-08002bodea7a,
oddball}

Privileges Required
Often, no special privileges are required, but can vary depending on the individual server.

Examples

dcecp> server ping /.../brain_cell/hosts/wardr/event_server
1
dcecp>