HIT User's Guide for UNIX Systems
Contents
1. Name Date Address Computer E mail OS Vers Tel SIMULA Vers Compiler Analyzer Others Documentation O PASSI O SIMUL O FAN O Reference Manual O PASS2 O DOQ4 O OMA O Introduction O EXTREF O LIN2 O Unknown O Others O LINKER O MARKOV O ACG O Suggested O SCG O RESULT Enhancement Version of above Catchword Problem Description Enclosures Please list all concerned filenames and make sure that all files can be accessed by the HIT crew Or append all concerned files to your e mail use Unix shar if available CONTROL SOURCE COPY Files a INFILI EI n The smaller th xample the better the maintenance t o be filled by the Heyl T c r ew History O Corrected O NoError Comments Alternative gt Version gt Module gt Date 3 gt Signature gt Universitaet Dortmund Informatik IV D 44221 Dortmund E mail hit jojo informatik uni dortmund de Tel FRG 231 7554892 Universit t Dortmund Informatik IV Version 3 7 00 December 20002. Al Wser sGu TOF jcla U IND ee ocument Version 3 5 00 rierarchical evaluation Tool Version 3 7 000 HIT User s Guide for UNIX Systems 1 Authors P Lengewitz N WeiBenberg Abstract This guide describes the usage of the HIT system on a workstation or PC under the operating system UNIX valid for most UNIX like systems The standard shellscripts hit and oma are available The use of these scripts and their parameters are described The title page contains two version numbers That of this document and the version number of the HIT system to which this document applies The document version and date is also included in the page footer Here lower version numbers may appear for unchanged pages 2000 Copyright Universit t Dortmund Informatik IV Address Universitat Dortmund Informatik IV Prof Dr Ing H Beilner D 44221 Dortmund Telefon Germany 231 755 2570 Telefax Germany 231 755 4730 E Mail hit jojo informatik uni dortmund de Universitat Dortmund Informatik IV Version 3 7 00 December 2000 HIT User s Guide for UNIX Systems 2 Contents 1 How to Use the Shell script Nit ssssssssssssssssssssssssssssssssssssssssssssesssssesssrsssssd 1 1 Opt ns FAL 4c 6 sates ot cn ete ate eine A E eines at eet dS 4 1 2 Specifi Advice Sa tiise or eeen ere e rea e E EAEE 5 IZI Gen rat d Piles een aaa aaa a a e gaat 5 1 2 1 1 Files created by the Shellscript hit eee 5 1 2
3. 1 2 Files Created by the HIT System eee 5 1 2 2 Usage of HIT in Batch Modes cccicceciceiedidden nied 5 2 How to Use the Shellscript OMa ssssssssrusssnsnnnnnnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnannnann O HIT Error Report li s T A Universit t Dortmund Informatik IV Version 3 7 00 December 2000 HIT User s Guide for UNIX Systems 3 1 Howto Use the Shellscript hit HIT may simultaneously be activated by more than one user The current working directories of simultaneous hit calls must be disjoint since some output files of hit have fixed relative names In the following text installation_path indicates the name of the directory the HIT system is installed in To use HIT it is necessary to call the shellscript hit by entering installation_path hit It is useful to define an alias for hit or to set a path by entering within the login file set path path installation_path The script calls the HI SLANG compiler and the SIMULA compiler for the generated code The compiled module will be executed next There are many options to control the shellscript Most options are similar to those of the original BS2000 installation of HIT and more mnemonical than the UNIX convention to use one letter flags for this purpose The script may be called like this hit control_filename task_option or env option value hit control_ filename task_option The following options are identical control_filename gt
4. following files exist t hitcode the analyzer to be run t hitcode sim the generated code of the HI SLANG compiler t compiler the standard output file of the compiler terminal output t experiment the standard output file of the analyzer terminal output Moreover calling hit temporarily produces a file t sysinit ctl and a soft link named HITs from the current directory to the directory installation_pathiSY STEM DATA but these files are normally deleted after normal termination or interrupting HIT 1 2 1 2 Files Created by the HIT System Their names may either be defined in the control file or by using filename generator of HIT The latter is automatically used for files with a standard linkname which is not bound in the control file The filename generator works as follows The files have the names t lt c gt lt gt with lt c gt being the name of the control file stripped of the directory prefix and a suffix ctl or hitand lt l gt resembling the leading three letters of the standard link name e g lis for listing tra for trace Example For a control file named my_dir example ex1 ctl the standard name of the listing within the current directory would be t ex lis The user may define a different filename pattern by using DEFAULT pattern in his control file Please consult the reference manual for more information 1 2 2 Usage of HIT in Batch M ode HIT can be run in batch mode by typing hit control_ filename ta
5. p gt Directory path of SIMULA system defined by path gt Display of times used for the actions performed time gt Parameters for the HI SLANG compiler p g gt Parameters for the compilation of the analyzers w e h gt Parameters for the analyzer runtime system _ p g see your SIMULA User s Guide for these parameters gt Size parameter for the experiment in kB 4096 gt Size parameter for the HI SLANG compilation in kB 4096 gt Option to use the debugger when running the analyzer 0 1 Only for maintenance gt Sysin file of the compiler lt stdin gt Sysout file of the compiler prefix compiler stdout gt Sysin file of the experiment lt stdin gt Sysout file of the experiment prefix experiment stdout gt SIMULA output file of the HI SLANG compilation without extension sim prefix hitcode gt Calloma after running the HIT system y n Universitat Dortmund Informatik IV Version 3 7 00 December 2000 HIT User s Guide for UNIX Systems 5 1 2 Specific Advices 1 2 1 Generated Files Some new files exist in the current directory after every run of the HIT system There are two classes of files 1 2 1 1 Files created by the Shellscript hit Their names can only be modified by the parameter prefix The contents of the directory depends on the parameters of the script hit but normally the
6. same as option control task_option gt same as option task Since they are frequently used the parameters control and task are both implemented as keyword parameters as well as positional parameters If keyword parameters are to be set for more than one call of hit it is advantageous to use hit like this Within a standard shell Within a C shell option value setenv option value export option is hit hit hit hit Universitat Dortmund Informatik IV Version 3 7 00 December 2000 HIT User s Guide for UNIX Systems 4 1 1 Options of hit The following options are available the default value of every option is underlined control task option output prefix gt simula prtime parme parms parme sizeexp sizecomp debug comdta comlst expdta explst code oma gt Name of the control file The use of wildcards is allowed to start experiment series In this case it is necessary to write the value of control in quotation marks e g hit ctl hit exp1 exp hit mod1 mod2 gt Starting point of the shell com HI SLANG compilation followed by sim SIMULA compilation followed by exp program execution gt Exit point of the shellscript check only HI SLANG compilation run the complete run gt Direction of the output noterm only comlst and explst term only stdout both both Prefix for temporary files t t tm
7. sk_option gt dev null amp or env output noterm hit control_filename task_option amp or the like as described above This is recommended especially for long simulation runs Universitat Dortmund Informatik IV Version 3 7 00 December 2000 HIT User s Guide for UNIX Systems 6 2 How to Use the Shellscript oma The shellscript oma serves to call the HIT object manager which is explained in the HIT OMA User s Manual The script can be called by env option value installation_path oma task It is useful to define an alias to call oma or to set a path The following options are available task gt First oma command output gt Switch of output direction noterm term both omalst gt Sysout file for oma t oma sysout Calling oma produces the file t 0ma lis which contains a protocol of the session while the file given by parameter omalst the terminal output is only created when output is not set to term Moreover a soft link H Ts and the file t sysinit ctl will temporarily be created analogously to hit As an option the shellscript oma may be called with an introductory commandtask as a parameter the command then being executed right at beginning of the object manager e g READ filename The specified file may contain the default settings of the user Universitat Dortmund Informatik IV Version 3 7 00 December 2000 HIT User s Guide for UNIX Systems 7 HIT Bt ee Owe Re np OF E
Download Pdf Manuals
Related Search