Running T/HIS

Running T/HIS

Starting the code

For users on a device with a window manager T/HIS is run from the T/HIS button in the SHELL:

If your system has been customised locally you may have to use some other command or icon: consult your system manager in this case.

Graphics Driver

T/HIS 9.3 onwards uses a OpenGL graphics driver.

T/HIS uses 32 bit (single-precision) numbers to store and plot data.

"Batch" Mode

T/HIS can run in "batch" mode where the main application window is not displayed on the screen. "Batch" mode is available on all platforms.

To start T/HIS in batch mode use the command line option "-batch".

e.g. this14_64.exe -tcf=script.inp -batch

When running in "batch" mode T/HIS will automatically exit at the end of the script regardless of whether or not "-exit" is specified.

NOTE : All image, postscript and PDF outputs require a DISPLAY on UNIX / LINUX systems. If you are running T/HIS in "batch" mode as part of a automatic post processing script then T/HIS must have a X Windows DISPLAY even though the main window is not displayed. If the machine you are using is a server or part of a cluster without an X-Server then T/HIS can be used with the Xvfb software.

Selecting a device when a window manager is not running

If you are running on a non-window device, for example a Tektronix display or emulator, you may not be able to use screen menus. Instead you will have to run in "command-line" mode.

It is very unlikely that a user on a modern workstation will see these options, since the machine will have a window manager and will be running in "screen menu" mode. If they do appear it suggests that the machine and/or software are wrongly set up: see below for suggested remedies.

If T/HIS will not start in screen-menu mode

You may be running on a device with a window manager, but still only get the command-line prompt (and probably no menu driven _93 shell either).

This is almost certainly because of one or both of the following setup errors:

(1)	The DISPLAY environment variable has not been set up, or has been set incorrectly. This tells the X11 window manager where to place windows, and it must be set to point to your screen. Its generic setup string is:
	setenv DISPLAY <hostname>:<display number> (C shell syntax)
	Where <hostname> is your machine's name or internet address, for example:
	setenv DISPLAY :0	(Default display :0 on this machine)
	setenv DISPLAY tigger:0	(Default display :0 on machine "tigger")
	setenv DISPLAY 69.177.15.2:0	(Default display :0, address 69.177.15.2)
	You may have to use the raw network address if the machine name has not been added to your /etc/hosts file, or possibly the "yellow pages" server hosts file.

(2)	Your machine (strictly the X11 "server") has not been told to accept window manager requests from remote machines. This is usually the case when you are trying to display from a remote machine over a network, and you get the message similar to:
	Xlib: connection to "<hostname>" refused by server
	Xlib: Client is not authorised to connect to server
	In this case go to a window with a Unix prompt on your machine, and type:
	xhost +
	Which tells your window manager to accept requests from any remote client. It will produce a confirmatory message, which will be something like:
	access control disabled, clients can connect from any host

If T/HIS still fails to work then please contact your system manager, or contact Oasys Ltd Support for advice and help.

Command Line Mode

Command line mode is the main method of data input on non X-Windows devices. Command line mode is also available within the X-Windows screen interface and is accessed through the dialogue window. In command line mode the user will be presented with a prompt which also indicates which level of the menu structure the user is at. For example:

Defaults >

In response to the prompt a valid option must be given. These are usually a two or three letter abbreviation of a command; for example PL is the command to plot a graph. A list of the commands available is provided by typing M (for Menu). In addition to commands specific to one menu there are a number of commands which have the same effect throughout T/HIS.

Q	- (Quit) Abort and return to current menu
!	- Go up a level in the menu structure
/	- Return to the top level menu
;	- Equivalent to a <carriage return> in a string of commands
M	- Lists menu.

Several commands can be strung together on one line, separated by spaces, for example:

/DE GR ON

Numeric data can also be included in the command line if required, for example:

/OP ADX #1 7.2 #

Commands can be in upper or lower case.

As well as menu level commands you will be asked questions such as:

THF file to read (filename_1)?

The default response, if one exists, is given in parentheses.