% VAX-11 Librarian V04-00`-А`|EА05#ICONTICONXIEXE@=А1 ICONT> Translates and links an Icon source program, creating a fileB suitable for execution by ICONX. Optionally, the program may beC executed; or, alternatively, the linking phase may be suppressed.F Each .ICN file is translated into an intermediate form called ucode;? then ucode files are combined to produce a single icode file. Format:/ ICONT [options] file-spec [...] [-x arguments] 2 Parameters file-spec A Each file-spec with a .ICN file type is assumed to contain IconD source code, and is translated and linked. .ICN is the default if no file type is given.G A file-spec of form "-" causes source code to be read from SYS$INPUT.; The icode file produced in this case will be named STDIN.E Each file-spec with a type of .U calls for the two ucode files with9 .U1 and .U2 file types to be read at the linking phase. 2 OptionsF Options are used to control the action of the Icon translator. EachF option consists of a h yphen and one or more characters. Options are? separated by spaces and must precede any file specifications.3 -cF Suppresses the linking phase of the translator. Ucode files created' by the translator are left undeleted.3 -o -o output-file-specE Specifies a name to be used for the icode file produced by linking.3 -sA Suppresses informative messages produced during translation and linking.3 -S "-S[cfgilnrsCFL]n"G Alters the amount of memory allocated during transla tion and linking.E This option is case sensitive and must therefore be given in double/ quotes. It is NOT the same as the -s option.E The letter following the S specifies the table; n is the number ofE storage units to allocate for the region. Default table sizes are:' c constant table 100' f field table 100' g global symbol table 200' i identifier table 500' l local symbol table 100' n line number space 1000' r field table for records 100' s string space 20000' t tree space 15000' C code buffer 20000' F file names 10' L labels 5003 -tD Arrange for &trace to have an initial value of -1 when the program> is interpreted. Normally, &trace has an initial value of 0.3 -u? Issue warning messages for undeclared identifiers used in the: prog ram. Such messages appear during the linking phase.2 -x< If -x follows the file specification[s], the icode file isD automatically executed. Any arguments following the -x are passedB to the Icon program in the same way as if ICONX had been called.2 IPATHE The logical name IPATH defines a list of directories to be searchedA for files specified in link directives within Icon source code.D Each directory is searched in turn. The default value of IPATH is' "[]" (the current default directory).F IPATH can be set by the VMS ASSIGN command. Directories in the list are separated by spaces. Example: $ ASSIGN "[] [-.MYLIB]" IPATH 2 Examples 1. $ ICONT PROG -X P1 P2? The Icon source file PROG.ICN is translated, linked, and then% executed with parameters P1 and P2.' 2. $ ICONT -O BIG PART1 PART2 PART3@ The three source files PART1.ICN, PART2.ICN, and PART3.ICN are8 compiled and linked together to produce a program BIG. 2 Reference- The Icon Language is described in the book: The Icon Programming Language( Ralph E. Griswold and Madge T. Griswold7 Prentice-Hall Inc., Englewood Cliffs, New Jersey, 1983wwCА1 ICONX: Executes an Icon program translated and linked by ICONT. Format:' ICONX [-e efile] file-spec [arguments]2 -e -e efile/ Causes the file efile to be used for &errout. 2 file-specA Names a file containing icode, as output by ICONT. A file type of .ICX is assumed. 2 Ar gumentsA Program arguments of the form ofile cause ifile and7 ofile to be used for &input and &output respectively.? Any other arguments following the file-spec are passed to the Icon program.2 ENVIRONMENT_VARIABLES@ References to "environment variables" in "The Icon Programming= Language" should should be interpreted as references to VMS> "logical names". See the HELP information on LOGICAL_NAMES.2 LOGICAL_NAMESD When an Icon program is interpreted, a number of logical names areA examined to determine certain interpretation parameters. TheseC should have numeric values. Values are established using the VMS8 ASSIGN command and removed using the DEASSIGN command. Example: $ ASSIGN 100 TRACE $ ICONX PROG $ DEASSIGN TRACE3 TRACEE Initialize the value of &trace. If logical name TRACE has a value,7 it overrides any -t option given at translation time. 3 NOERRBUFC By default, &errout is buffered. If NOERRBUF is defined, &errout is not buffered. 3 STRSIZEC The initial size of the string space, in bytes. The string spaceE grows if necessary, but it never shrinks. The string default value is 51,200 bytes. 3 HEAPSIZEG The initial size of the heap, in bytes. The heap grows if necessary,; but it never shrinks. The default value is 51,200 bytes. 3 COEXPSIZED The size of each co-expression block, in words. The default value is 2000 words. 3 MSTKSIZEE The size in words of the main interprete r stack. The default value is 10,000 words. 3 STATSIZEF The size in bytes of the static region in which co-expression blocks. are allocated. The default value is 20,480. 3 STATINCRB The size of the increment used when expanding the static region.C The default is one quarter of the initial size, i.e. 512 bytes if STATSIZE is defaulted.3 MAXMEMB The maximum amount of memory, in bytes, that can be allocated in> total by all of Icon's memory regions. The default value is 1,000,000.ww`|EА1 IEXEB defines a command allowing execution of an Icon program by name.; The name used is that of the file containing the program. Format: IEXE file-spec Example: IEXE MYPROG8 defines MYPROG as a command equivalent to ICONX MYPROG.ww