MEXTEX Help

3. Remote Control

MEXTEX provides a facility for controlling the main application remotely, that is from a shell script without direct manipulation of the GUI. The program that achieves this remote control is called remote. The program takes three optional command line arguments, -h, -y and -n. Specifying -n or -y will force an answer of yes or no respectively to questions which may be asked by the program. Specifying -h <hostname> will cause the remote command to be sent to that copy of MEXTEX running on the machine <hostname>. By default, the remote command is sent to MEXTEX running on the local machine. Functions that are available for remote execution are
* Loading of operating parameters from a file 
Usage: remote LOADOPVARS <filename> [-y] [-n] [-h <hostname>]
MEXTEX is instructed to read operating variables from <filename>. If <filename> does not exist the program will terminate.
* Saving of operating parameters to a file 
Usage: remote SAVEOPVARS <filename> [-y] [-n] [-h <hostname>]
MEXTEX is instructed to write operating variables to <filename>. If <filename> exists, the user will be prompted for file deletion. This behaviour may be modified by using the optional command line arguments.
* Dumping of statistics to a file 
Usage: remote DUMPSTATS <filename> [-y] [-n] [-h <hostname>]
MEXTEX is instructed to write performance statistics to <filename>. If <filename> exists, the user will be asked whether the file is to be deleted or data appended to it. This behaviour may be modified by using the optional command line arguments.
* Starting threads 
Usage: remote START [-y] [-n] [-h <hostname>]
MEXTEX is instructed to start its I/O threads if they are not already running.
* Stopping threads 
Usage: remote STOP [-y] [-n] [-h <hostname>]
MEXTEX is instructed to stop its I/O threads if they are not already stopped.
* Clearing statistics 
Usage: remote CLEARSTATS [-y] [-n] [-h <hostname>]
MEXTEX is instructed to clear its thread performance statistics.
As an example, suppose the user wanted to load new operating parameters from the file parms1234.ops and then every 10 seconds wanted to append I/O statistics to the file parms1234.sts, the following C-shell script might be used. 
	#! /bin/csh -f

	remote LOADOPVARS parms1234.ops
	while (1) 
		remote DUMPSTATS parms1234.sts -n
		sleep 10
	end

[HOME] [PREVIOUS] [NEXT]