Last modified: December 2013

URL: https://cxc.cfa.harvard.edu/chips/ahelp/create_server.html
Jump to: Description · Example · Bugs · See Also


AHELP for CIAO 4.11 ChIPS v1

create_server

Context: server

Synopsis

Launches a new ChIPS server and connects the client to it.

Syntax

create_server()
create_server(loadprefs)

Description

The function arguments.

Argument Description
loadprefs A boolean controlling whether the new server should load the user's $HOME/.chips.rc.preference file. The default is False.

The create_server command may be used by a client which is currently not connected to a server. The optional load_prefs parameter indicates whether the server should load the user's preferences file (if not given the preference file is not loaded). The command creates a new server and attaches the client to the server. After the server is created, the get_server_id command will return the id of the new server.

If the client is already connected to a server when a create_server command is invoked, the request will fail and an error message is returned.


Example

chips> print(get_server_id())
ChipsServer_6979_1
chips> disconnect()
chips> create_server(True)
chips> print(get_server_id())
ChipsServer_6979_2

The client is disconnected from the server with id "ChipsServer_6979_1". A new chips server is then created, which loads the user's $HOME/.chips.rc file and attaches the client to the server. The final call to get_server_id returns the id of the new chips server ("ChipsServer_6979_2").


Bugs

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

See Also

server
check_server_exists, connect, disconnect, get_server_cwd, get_server_id, list_servers, lock, unlock