7. IN CASE OF TROUBLE

next, previous Section / Table of Contents / Index Due to the complexity of the program system a number of problems can arise if BALSAC is used with false or meaningless parameter settings or run with inappropriate hardware. Some problems and possible solutions are listed in the following where {DOS} refers to the DOS/VGA and {Unix} to the Unix/X.11 version. * GENERAL HARDWARE PROBLEMS: required hardware is {DOS} : - 560 KB free memory, CPU with math coprocessor (included with i486-DX2, Pentium systems), - VGA graphics adapter (256 KB memory), - Mouse with full Microsoft compatibility. {Unix} : - 16 MB memory, - X.11 Windows accessible graphics adapter. * BALSAC FINISHES WITH A RUN TIME ERROR MESSAGE {DOS}. run time error F6002: or run time error F6002 - floating-point support not loaded . You want to run BALSAC on a PC without floating-point hardware. Your system may not have a math coprocessor installed (Intel 80286, 80386, and Intel 80486-SX based systems) or the math coprocessor option may be disabled. :: Check your hardware. Your PC MUST be equipped with the math coprocessor option to be able to run BALSAC. * BALSAC DOES NOT START UP CORRECTLY {DOS} resulting in an error message Program size exceeds available memory or with similar indications of memory shortage. BALSAC uses 560 KB of memory and may not get it due to memory resident utilities or hardware drivers. :: Remove any unnecessary memory resident software (utilities, drivers) or load into high memory. * BALSAC DOES NOT START UP CORRECTLY {DOS/Unix} resulting in an error message INIT FILE ERROR : F = balsac2.ini (or any other file name) WARNING: load new INIT file to continue and finishes after you press [enter]. The initialization file 'balsac2.ini' (or any other file name) does not exist in your directory or in the default directories of your path. Alternatively or in addition, the initialization file may contain incorrect parameter values or file format. :: Search your directory paths for the initialization file or obtain a copy from the original package. Check your initialization file for correct parameter settings and format, see Sec. 6.4.10. * ON-LINE HELP IS NOT AVAILABLE IN BALSAC {DOS/Unix} sessions which may be indicated by an error message WARNING: help file unaccessible, no on-line help available at startup. The on-line help file 'balsac2.hlp' (or any other file name defined in the command line) does not exist in your directory or in the default directories of your path. Alternatively or in addition, the help file may contain incorrect parameter values or file format. :: Search your directory paths for the on-line help file or obtain a copy from the original package. Check your on-line help file for correct parameter settings and format, see Sec. 6.4.11. * BALSAC DOES NOT START UP CORRECTLY {DOS/Unix} finishing with an error message ERROR: Input/output/init file . The structure output file given on the command line does not exist. :: Search for your input file. Check file name syntax. * BALSAC FINISHES WITH A RUN TIME ERROR MESSAGE {DOS}. run time error F6xxx: READ(filename) BALSAC finds a format error during file input from a file "filename". :: Check the detailed format of your input file, see Secs. 6.4.2, 6.4.3. * BALSAC DOES NOT ACCEPT FILE NAMES USED FOR FILE OUTPUT {Unix} in interactive sessions or crashes upon quitting with an error message similar to The I/O operation on unit 2 cannot be completed (Permission denied). You may be running BALSAC in a directory where you do not have write permission. :: Check and change the settings appropriately. * BALSAC STARTS UP WITH THE MESSAGE {Unix} Terminal mode, no graphics display while you are running on an X terminal expecting graphics output {Unix}. Your display address may be incorrect and may need to be reset. :: On the Unix command line (c shell) use "setenv | grep DISPLAY" to obtain your present display setting. Redefine the setting by "setenv DISPLAY DDD" where DDD is the correct internet device address, e.g. "wagner:0.0". Consult you system administrator when you are in doubt about the address. * THE MOUSE POINTER DOES NOT WORK CORRECTLY WITH BALSAC {DOS}. The mouse interface software (drivers MOUSE.SYS or MOUSE.COM) has not been run before BALSAC was started or your mouse is not fully Microsoft compatible. For graphics resolutions other than standard CGA, EGA, VGA special mouse drivers are required to get the mouse to work. :: Load the mouse driver and restart BALSAC. Obtain the correct driver software applicable for your mouse device from your systems administrator or dealer. * You get an ERROR MESSAGE {Unix} ERROR: can't open display DDD when you start graphics output inside a BALSAC session. Your display address may be incorrect and may need to be reset. :: On the Unix command line (c shell) use "setenv | grep DISPLAY" to obtain your present display setting. Redefine the setting by "setenv DISPLAY DDD" where DDD is the correct internet device address, e.g. "wagner:0.0". Consult you system administrator when you are in doubt about the address. * BALSAC GRAPHICS DOES NOT SHOW OR LOOKS INCORRECT {DOS/Unix}. You may be using an inappropriate adapter type or an adapter with incorrect PROM specifications {DOS}. The X.11 Windows implementation of your system does not work with your adapter {Unix}. :: For adapter problems check with your systems administrator or dealer. You may have to execute a warm restart of your PC system before you can continue {DOS}. * BALL SHADING (HARD, FUZZY, DITHERED, GLOSSY) DOES NOT SHOW OR LOOKS INCORRECT {DOS,Unix}. The contrast setting of your monitor may be inappropriate. The color definitions may be incorrect. :: Readjust the monitor contrast setting. Check the color tables inside your BALSAC session (with the basic parameter option) and in the initialization file, see Secs. 5.4, 6.2.15, 6.4.11. * PARTS OF THE GRAPHICS OUTPUT DO NOT APPEAR {DOS,Unix}. You may have chosen "black" as one of the element colors or as the background color. :: Check the color settings inside your BALSAC session (with the control parameter option) and in the initialization file, see Secs. 5.4, 6.2.15, 6.4.11. * THE GRAPHICS OUTPUT EXCEEDS THE SCREEN/WINDOW AREA {DOS,Unix}. You may have chosen too large values of the magnification factor (View option, see Sec. 6.2.6) or of the y/x pixel ratio, see Sec. 6.2.15. If graphics output exceeds the screen area there may arise problems with memory resident screen capture utilities in combination with VGA compatible adapters {DOS}. Graphics windows exceeding the screen area can kill your present BALSAC session destroying all your structure information. Make sure that your graphics window lies always inside the screen area {Unix}. :: Check and readjust all window definitions inside your BALSAC session (with the basic parameter option) and in the initialization file, see Secs. 6.2.15, 6.4.11. * BALSAC CRASHES WITH AN ERROR MESSAGE "X.11 FATAL ERROR" {Unix}. Your X.11 Windows server has encountered a non-recoverable error in one of the BALSAC graphics windows, e. g. when a window was erased erroneously by another X.11 application. The additional message Error exit: session may be recovered with "balsac -Xp" (using file balsac.svX) allows you to resume the BALSAC session where "X" = l for a LATTICE and = c for a CLUSTER session. Note that this message appears only if your BALSAC session has generated a complete set of structure data. * BALSAC CRASHES WITH AN ERROR MESSAGE {Unix} X.11 color allocation error (colors required = nctot, allocated = ncall) BALSAC tries to allocate nctot colors for a graphics or menu window but gets only ncall colors from the X.11 Windows server since other X.11 applications take away too many color cells. The additional message Error exit: session may be recovered with "balsac -Xp" (using file balsac.svX) allows you to resume the BALSAC session where "X" = l for a LATTICE and = c for a CLUSTER session. Note that this message appears only if your BALSAC session has generated a complete set of structure data. :: Close some of your present X.11 applications and restart BALSAC. next, previous Section / Table of Contents / Index