Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1488

News	FAQ
Search	Home

ms - Constructor

	Package	general
	Module	ms
	Tool	ms

Create an ms tool attached to a measurement set

Synopsis
ms(filename, readonly, lock, host, forcenewserver)

Arguments

filename	in	measurement set file-name
		Allowed:	String
		Default:	no default
readonly	in	open for read access only
		Allowed:	Boolean
		Default:	T
lock	in	lock the table for exclusive use
		Allowed:	Boolean
		Default:	F
host	in	host to start ms tool on
		Allowed:	String
		Default:	''
forcenewserver	in	start a new server tool
		Allowed:	Boolean
		Default:	F

Returns
ms tool or fail

Description
This is the most commonly used constructor. It creates an ms tool which is attached to the specified measurement set table.

By default the table is opened read only to prevent you from accidently making changes to the measurement set. Set readonly to F you you do intend to make changes.

Setting the lock argument to T will permanently lock the table preventing other processes from writing to the measurement set. Unless you expect this to happen, and want to prevent it, you should leave the lock argument at the default value which implies auto-locking.

The host argument specifies which machine the precompiled ms process should be started on. The default value starts it on the same machine as the one that Glish is running on.

In order to run the ms tool on a remote machine you need to satisfy all the following conditions.

• It must be possible to start AIPS++ on the remote machine
• You must be able to log onto the remote machine without having to type a password
• The AIPSPATH environment variable must be defined on the remote machine. You may want to set this up in the relevant ``dot'' file eg., adding a line like source /usr/local/aips++/aipsinit.csh in your .cshrc file (for csh).

One quick way to check if all three conditions are met is to type, on your local machine rsh host 'echo $AIPSPATH' where host is replaced by the name of the remote machine. If the value of the AIPSPATH variable that is printed does not contain something like aips-root architecture site host and that all the values are correct for the remote machine you can be certain that starting the ms tool, or any AIPS++ server, on the remote host will not work

Each ms tool can only run one function at a time. To solve this you start two servers. The forcenewserver argument allows you to do this by overriding the default behaviour of having each ms tool share the same server. This function returns an ms tool or fail if something went wrong, like an error in the measurement set name.

Example
See the example for the nrow function.