6.1. STARTING UP

next, previous Section / Table of Contents / Index BALSAC is started from the DOS or Unix command line or as a DOS full screen application inside MS Windows 3.1x. Running BALSAC requires an - initialization file (defaulted to 'balsac2.ini') and an - on-line help file (defaulted to 'balsac2.hlp'). The default files, if used, have to reside in the calling directory or in the BALSAC system directory. Alternatively, initialization and on-line help file names can be given on the command line, see below). For graphics output a graphics interface (VGA monochrome or color graphics adapter for PCs, X.11 Windows system with color adapter for Unix systems) must be installed. The calling command of BALSAC is balsac [-options] [structfile] [initfile] [helpfile] or balsac structfile where all parameters in square brackets [...] are optional. Here "options" is any meaningful combination of characters l = start a BALSAC/LATTICE session in interactive mode or with an input file (for file names see below), see Sec. 6.2, c = start a BALSAC/CLUSTER session in interactive mode or with an input file (for file names see below), see Sec. 6.3, r = used together with session parameters "l" or "c" starts a BALSAC/LATTICE or BALSAC/CLUSTER session with the quicksave file 'balsac.lat' or 'balsac.plt' as input. The file names need not be given on the command line. p = used together with session parameters "l" or "c" starts a BALSAC/LATTICE or BALSAC/CLUSTER session with the safety backup file 'balsac.svl' or 'balsac.svc' as input. The file names need not be given on the command line. 0 - 9 = used together with session parameters "l" or "c" starts a BALSAC/LATTICE or BALSAC/CLUSTER session with stack file 'stckFFF#.lat' or 'stckFFF#.plt' as input. m = mouse use for all option menus, see Sec. 3.3.8, t = start BALSAC in teach mode, see Sec. 3.3.9. The necessary help file is defaulted to 'balsac2.hlp' in the user directory or in the BALSAC system directory, or can be defined on the command line (for file names see below), see Sec. 3.3.9, Parameter "structfile" used together with session parameters "l" or "c" denotes the name of an (optional) structure input file (up to 72 characters) to be loaded when the respective BALSAC session is started. A dummy 1-character file name "-" will ignore the file entry, see examples below. If BALSAC is called with short file input as '> balsac structfile' the run mode depends on the postfix of the input file name. If the file name reads xxx.lat, xxx.svl (postfixes .lat, .svl) the input file is used to start a BALSAC/LATTICE session, no mouse menu option nor teach mode, only default initialization and help file use. xxx.plt, xxx.svc (postfixes .plt, .svc) the input file is used to start a BALSAC/CLUSTER session, no mouse menu option nor teach mode, only default initialization and help file use. Parameter "initfile" denotes the name of an (optional) initialization file (up to 72 characters) to replace the default file 'balsac2.ini' (in the calling directory or in the BALSAC system directory, see below). Note that the content of an initialization file can also be stored in a structure input file, see Secs. 6.2.8, 6.3.6. In this case both the default and any external initialization file will be ignored and all initialization parameters will be taken from the structure input file. A dummy 1-character file name "-" will ignore the file entry, see examples below. Parameter "helpfile" denotes the name of an (optional) on-line help file (up to 72 characters) to replace the default file 'balsac2.hlp' (in the calling directory or in the BALSAC system directory, see below). If BALSAC was installed in a Unix multi-user environment the default initialization and on-line help files reside in the BALSAC system directory (e.g. /usr/local/balsac). If files balsac2.ini and/or balsac2.hlp exist in the directory from which BALSAC is started these files will override the standard defaults of the system directory. This becomes important for graphics systems with restricted capabilities where the default initialization file has to be replaced by a local default. Examples of BALSAC starting commands are > balsac start BALSAC without any options. > balsac -lm start a BALSAC/LATTICE session using a mouse to select menu options. > balsac helpme.lat start a BALSAC/LATTICE session with a structure file 'helpme.lat' as input. > balsac -cm5 start a BALSAC/CLUSTER session with the stack file 'stckFFF5.plt' as input, using a mouse to select menu options. > balsac -l lattice.lat start a BALSAC/LATTICE session with a structure file 'lattice.lat' as input. > balsac -cp start a BALSAC/CLUSTER session with the safety backup file 'balsac.svc' to resume the previous BALSAC/CLUSTER session. > balsac -cpt start a BALSAC/CLUSTER session in teach mode with the safety backup file 'balsac.svc' to resume the previous BALSAC/CLUSTER session. > balsac -c balsac.svc is identical to "balsac -cp". > balsac -crm - myown.ini start a BALSAC/CLUSTER session with the quicksave file 'balsac.plt' as input, using a mouse to select menu options, loading an external initialization file 'myown.ini' (overriding 'balsac2.ini'). > balsac -lp - - myown.hlp start a BALSAC/LATTICE session with the safety backup file 'balsac.svl' to resume the previous BALSAC/CLUSTER session, loading an external on-line help file 'myown.hlp' (overriding 'balsac2.hlp'). If BALSAC is started without any option parameters on the command line the initial interactive startup screen ========================================================= | | | B A L S A C | | | | Build and Analyze Lattices, Surfaces, And Clusters | | | | (C) Copyright 1991-2005. All Rights Reserved | | K. Hermann, Fritz-Haber-Institut Berlin | | | | Version 2.16 April 2005 | | | | /adapter info/ | | | ========================================================= Select: [L]attice [C]luster [M]ouse(fms) [T]each(ftc) [?,]Quit To get help on option [x] press [?]+[x] or select Help from menu window is displayed where the adapter information reads "VGA graphics version" for DOS systems and "X.11/NNbit mode DISPLAY= nodeid" for Unix systems with NN denoting the color depth (2**NN colors) and nodeid giving the network name of the display. Note that nodeid will always be truncated to 32 characters while longer display names may be used internally. If on Unix systems the nodeid is invalid or the display is not X.11 Windows compatible the adapter information reads "Terminal mode, no graphics display" which indicates that all graphics output will be suppressed and respective warnings will be issued. The prompt line shows the interactive startup menu where keywords start with characters enclosed in [ ] brackets. These characters have to be selected (press character key or select with a mouse pointer, see below) to activate the respective option. This selection procedure is common to all menus throughout BALSAC. Pressing an invalid key, e. g. x, asks to repeat the input with a prompt [x] NOT AVAILABLE, enter correct option key : The mouse menu and teach mode options include respective flags fms, fmt, shown in parentheses and reading "on" or "off" depending on the present modes, see below. Further, the line below the prompt line indicates that on-line help is available and explains its use where " or select Help from menu window" is shown only with the Unix/X.11 version which offers a menu window. If the on-line help file (default is 'balsac2.hlp') is not available or corrupt when BALSAC is started the above line is replaced by WARNING: help file unaccessible, no on-line help available which allows you to start BALSAC sessions, however, without on-line help. In the above menu option selecting > [L] starts a BALSAC/LATTICE session moving to the LATTICE session menu. > [C] starts a BALSAC/CLUSTER session moving to the CLUSTER session menu. > [M] switches the mouse selection flag fms in the above menu between "on" and "off" (default is "on" for DOS, "off" for Unix version). For fms = "on" (DOS/VGA version) the mouse text pointer shows on the screen and selecting BALSAC menu options (shown in square brackets []) becomes possible by moving the pointer over the appropriate character on the screen and clicking the left mouse button (L-click) or by pressing the option key character on the keyboard. However, direct keyboard input is still possible. (Unix/X.11 version) a separate menu window named "Options Menu" is opened and remains open until numerical input is requested, mouse selection mode is turned off (see below), or BALSAC finishes. The menu window lists all entries of a given menu as " X: Option text " with X denoting the option key in keyboard mode and the option text being in most cases more explanatory than that of the keyboard menu, see Secs. 3.3.8, 10. Pointing and L-clicking with the mouse inside a rectangle will select the respective key code. With this option direct keyboard input becomes impossible and can be reactivated only by turning mouse mode "off", see above. For further information on the mouse menu selection mode see Sec. 3.3.8. Mouse selection mode can also be reset inside the basic parameter option menu, see Sec. 6.2.15, and by selecting [@] in any BALSAC option menu (DOS) or by L-clicking the button to the right of the entry "Menu off" in any menu window, see Sec. 3.3.8. > [T] selected from submenu P switches the teach mode flag ftc in the above menu between "on" and "off". Selecting [T] with ftc = "off" shows the prompt Teach file name ("+"=def,"-"=esc): asking for a character string fname (up to 72 characters) which defines the file name, e.g. "myteach.hlp", of an on-line help format file, see Sec. 6.4.11 used in teach mode. Here the one-character filename "+" denotes the default on-line help file 'balsac2.hlp', see Sec. 6.4.11.1, while dummy input "-" returns to submenu P. After a valid file name is given the flag ftc is switched to "on" and BALSAC runs in teach mode as indicated by "... (teach) [%,]Quit" in the main option menus and by "[%,]esc" in all other menus. Selecting an option in teach mode does not immediately execute the option. Instead, a short explanatory text taken from the on-line help file is shown and a prompt asks to confirm or reject the selection. For further details see Secs. 3.3.9, 3.3.8. Selecting [T] (twice) with ftc = "on" switches the flag to "off" and returns to default run mode which is confirmed by Teach mode off, help active in the text window (Unix/X.11 version only) and the escape prompt of all option menus changes to "... [?]Help [?,]Quit" and "[?,]esc" respectively. Alternatively, teach mode can be turned off in any menu by selecting [%] with the same result as using option [T] of the present submenu P. > [,] quits BALSAC returning to the DOS or Unix command line. next, previous Section / Table of Contents / Index