About Chandra Archive Proposer Instruments & Calibration Newsletters Data Analysis HelpDesk Calibration Database NASA Archives & Centers Chandra Science Links

Skip the navigation links
Last modified: December 2007

URL: http://cxc.harvard.edu/chips4.0/check_server_exists.sl.html
AHELP for ChIPS 4.0 check_server_exists Context: sl.chips

Synopsis

Determines if the specified server is currently running.

Syntax

check_server_exists(server_id);

Description

  • server_id - the id of the chips server to query; generally a string such as "ChipsServer_17334_1".

The check_server_exists command allows the user to verify that a chips server is running before attempting to connect to it. The call can be used while the client is already connected to a different server without having to first disconnect.

The routine returns 1 if the requested server exists and 0 otherwise. If the server does not exist, the routine may take several seconds to return a value, since the request needs to time out.

The list_servers command ("ahelp sl.chips list_servers") can be used to find out all the ChIPS servers that are currently running on a machine.

Example

chips> check_server_exists("ChipsServer_17991_1");
1
chips> check_server_exists("ChipsServer_7358_1");
0

Two servers are checked: the first is running and the second doesn't exist.

Bugs

See the bugs pages on the ChIPS website for an up-to-date listing of known bugs.

Last modified: December 2007



The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory.
60 Garden Street, Cambridge, MA 02138 USA.    Email: cxcweb@head.cfa.harvard.edu
Smithsonian Institution, Copyright © 1998-2004. All rights reserved.