GLIM release 4 GESU408NAG/H/I Sun SPARCstation/SunOS 4.1.x Users' Note Contents 1. Introduction 2. Running GLIM 3. Characteristics of this Implementation 3.1. Data Space 3.2. Channel Numbers 3.3. Local Pseudo Random Number Generator 3.4. Soft Break-in 3.5. The $PAUSE Directive 3.6. The PASS Facility 3.7. Initialisation File 3.8. Graphical Facilities 3.9. Floating Point Error Detection 3.10. Termination Status 4. Documentation and Example Analyses 5. Extending GLIM 6. Support from NAG 7. NAG Users Association 1. Introduction This document accompanies GLIM release 4 for Sun SPARCstation series computers running SunOS 4.1.x. It provides details of how to run GLIM, and other relevant information for GLIM users. The use of GLIM is described in the Reference Manual, but this note gives information specific to this implementation. Some of the details discussed in this document are site specific. Whoever is responsible for installing GLIM should ensure that these details are correct. The Installer's Note describes how GLIM should be installed at a site, and gives implementation-specific details on how the program can be modified to extend the data space or the PASS facility as described in chapter 17 of the manual. Other documentation for users is described in Section 4 of this Note. The latest information about new or amended facilities can be obtained from within GLIM by issuing the command $MAN NEWS$. 2. Running GLIM GLIM is invoked by the command % glim [parameter [parameter ...]] where each optional parameter is of the form keyword=argument. Parameters must be separated by one or more spaces, and there may also be spaces around the =. The following keywords assign the file named by the argument to GLIM's input and output channels as follows: pip - primary input channel (5 %pic) pop - primary output channel (6 %poc) sip - secondary input channel (7) sop - secondary output channel (8) dmp - dump channel (3 %pdc) log - transcript channel (4) lib - macro library channel (9 %plc) jou - journal channel (10) If no pip parameter is present, primary input will be read from the standard input (usually the keyboard) and GLIM will operate in interactive mode, issuing prompts and keeping a record of the session in the journal and transcript files. If no pop parameter is present, primary output will be written to the standard output (usually the terminal). Unless the appropriate parameter is used, the transcript channel and the journal channel are assigned to the files glim.tra and glim.jou. The default file assigned to the macro library channel is named in the environment variable GLIMLIB. The other channels do not have any default filenames. 3. Characteristics of this Implementation 3.1. Data Spaces By default the numerical data space can hold up to 400,000 values. This may be increased up to 4,000,000 by setting the environment variable GLIMSIZE before invoking GLIM, to a value equal to half the desired size, e.g. % setenv GLIMSIZE 1000000 % glim will give a data space of 2,000,000 values. If more space than this is required, the program must be recompiled as described in the Installer's Note. 3.2. Channel Numbers GLIM uses the channel numbers 3-10 for the files that may be assigned on the command line (see section 2). This implementation also uses channels 97-99 for graphical output. Other user files should be opened only on channel numbers 11 to 96. 3.3. Local Pseudo Random Number Generator The local pseudo random number generator in this implementation (accessed by the function %LR) is the drand48 function from the standard C library libc.a; the seed of this function is set by the seed48 function in the same library, via the GLIM $LSEED directive. 3.4. Soft Break-in The soft break-in facility is implemented using the INTR key (^C). Repeated use of the INTR key will cause the session to be abandoned. 3.5. The $PAUSE Directive The $PAUSE directive is implemented. If it is used without a string, the GLIM session may be resumed by entering the command exit. 3.6. The PASS Facility This implementation includes the following PASS options: %RUNDEMO ( OPT=1 ) Run Demonstration Program %SUBSRCH ( OPT=2 ) Fast Subfile Search %MATMULT ( OPT=3 ) Matrix Multiplication %CUBSPLI ( OPT=4 ) Cubic spline smoothing Only %MATMULT and %CUBSPLI are supported in this release (update 8) of the software. Further facilities may be available with later updates. %MATMULT is described in chapter 17 of the GLIM 4 Manual. %CUBSPLI is used by macros in the macro library. No other use of %CUBSPLI is supported in this release. 3.7. Initialisation File Before reading the primary input, GLIM will search for a file named .glimrc in the following directories. The commands in the first file found will be executed. The directories are: the current working directory your home directory the GLIM system home directory 3.8. Graphical Facilities The default filenames and the channels used for graphical output are: Filename Channel HPGL : glimplot.hp 97 PostScript : glimplot.ps 98 Colour PostScript : glimplot.cps 99 In addition to the facilities described in the manual, this implementation includes an X11 driver, which will produce plots in an X window on an appropriate display. The GLIM name (used in the $SET directive) for this device is 'X'. 3.9. Floating Point Error Detection GLIM attempts to ensure that all operands in arithmetic operations are valid, and will produce a valid result. However not all errors can be detected before the operation takes place. All underflows are ignored. If another type of floating point error occurs, and GLIM is being used interactively, the program will abandon the current statement and prompt for more input. 3.10. Termination Status When GLIM terminates, the exit status has a value representing success/failure of the run. The value 0 indicates normal successful termination, 1 represents failure in a controlled fashion (usually in batch), 2 represents a severe failure, from which GLIM could not recover, and 3 represents catastrophic collapse. 4. Documentation and Example Analyses Example jobs are available in the examples subdirectory of the GLIM system directory. For each job, the input file (with extension .exa) and results file (with extension .res) are supplied. Each job may be run with the input file as the primary input to GLIM. The following jobs are available: maclib - examples of use of the library macros The primary source of information is the GLIM 4 Manual (O.U.P. 1993). The GLIM 4 Quick Reference Card and the GLIM 4 Macro Library Manual are published by NAG. One copy of each of these is supplied with the software. Further copies are available from NAG. The GLIM Newsletter is published twice a year by NAG and is distributed to all GLIM sites which subscribe to the GLIM support service. Other sites and individuals may take out subscriptions for the Newsletter by contacting NAG. 5. Extending GLIM As described in Chapter 17 of the GLIM Reference Manual, the program may be extended by using the PASS facility. The source code for this purpose is available in the directory: $GLIM_HOME/system The Installer's Note for this implementation gives details on how these routines should be compiled and a modified version of GLIM created. It is also possible to increase the size of the data space within GLIM and/or increase the range of graphical devices supported. Details are given in the Installer's Note. 6. Support from NAG (a) Contact with NAG Queries concerning this document or the implementation generally should be directed initially to your local Advisory Service. If you have difficulty in making contact locally, you can write to NAG directly, at one of the supplied addresses. Users subscribing to the support service are encouraged to contact one of the NAG Response Centres (see below). (b) NAG Response Centres The NAG Response Centres are available for general enquiries from all users and also for technical queries from sites with an annually licensed product or support service. The Response Centres are open during office hours, but contact is possible by fax, email and phone (answering machine) at all times. When contacting a Response Centre please quote your NAG user reference and NAG product code. (c) Network Network, NAG's newsletter, is produced quarterly and sent free of charge to sites with a supported product or service. (d) NAG Bulletin Board The NAG Bulletin Board is an information service providing items of interest to users and prospective users of NAG products and services. The information is regularly updated and reviewed; new features are added and special interest groups are continually developing. 7. NAG Users Association NAGUA, the NAG Users Association, is a self-financing, non-profitmaking body. It exists to promote communications between NAG and users of its products and services. It provides information to NAG on the requirements of users, who are in turn kept informed of developments in services. Membership is available to any institution or individual which holds a licence for any NAG product or service. Members receive discounts on the registration fees at conferences and workshops. Members also receive 'NAGUA News', NAGUA's own newsletter. For an information pack and membership application form, please contact NAGUA at the supplied address. Appendix - supplied addresses NAG Ltd Wilkinson House Jordan Hill Road OXFORD OX2 8DR NAG Ltd Response Centre United Kingdom email: support@nag.co.uk Tel: +44 (0)1865 511245 Tel: +44 (0)1865 311744 Fax: +44 (0)1865 310139 Fax: +44 (0)1865 310139 NAG Inc 1400 Opus Place, Suite 200 Downers Grove IL 60515-5702 NAG Inc Response Center USA email: infodesk@nag.com Tel: +1 708 971 2337 Tel: +1 708 971 2345 Fax: +1 708 971 2706 Fax: +1 708 971 2346 NAG Users Association PO Box 426 OXFORD OX2 8SD United Kingdom email: nagua@nag.co.uk Tel: +44 865 311102