Failure in FIT2D Start-up

    If FIT2D fails to start-up properly, this can be due to one of a number of reasons, which are outside the control of FIT2D.

If the welcome text appears in the terminal window, but the graphics window does not appear, and a message similar to the following appears, it is necessary to authorise another workstation (client) to communicate with your workstation (you have a remote login), or perhaps the ``DISPLAY'' environment variable is not defined correctly.

Xlib: connection to ``expgf:0.0'' refused by server
Xlib: Client is not authorized to connect to Server
Failed to open X-11 display
ERROR: X-11 workstation not opened successfully (EXPG_LG_OPEN_WK)

To add the remote workstation to the list of allowed communicating workstations use xhost e.g. if the remote workstation is called expga, it is necessary to type the following command on your workstation:

xhost +expga

If the problem is not easily cured, contact your system administrator for further advice and assistance.

In addition to the above problems, the graphics window can also fail to be created if the X-terminal window is of the wrong type. The FIT2D graphics are presently only written for ``8-bit plane pseudo-colour X-windows'' (X-11 terminology). If this is not the case, the following error message will be output to the terminal window:

ERROR: At  present the  LG  system  is  only written  to  cope  with  8-bit
       plane  pseudo-colour X-displays.  Your  display  default  window  is
       not presently supported.  If  you  can  change the default behaviour
       to  8-bit  plane   pseudo-colour,   LG  should   be  able  to  work.
       Otherwise extra code will need  to  be  added  to  either  create  a
       pseudo-colour window  (a medium sized task),  or  add  functionality
       to cope with true colour or monochrome displays (a very large task).

In almost all cases it should be possible to change the set-up of the X-display, or X-emulation, such that the FIT2D graphics can work (local documentation will need to be consulted).

If the following message appears, or one similar, it means that the present available system virtual memory size is too small for the program to start.

Not enough memory

This could be because you have accidently demanded enormous internal arrays to be created. If this is the case, then re-starting FIT2D and specifying smaller arrays may solve the problem. If not, then some system parameter may need to be changed; see your system administrator (see the next section).

(This problem may appear and go away owing to other users starting and finishing processes, and therefore variable amounts of memory being available for FIT2D.)

FIT2D may also produce a message explaining that it is ``protected by a software key, which is presently not defined.''. After exiting the text viewer, a message will be left in the terminal window with information needed to calculate the ``key value''. To use FIT2D users must register and are given a personnel code or ``key'', and simple instructions on how to set the key value. If this message occurs it probably means that this procedure has not been carried out, and a key needs to be obtained.