.
contact contact


store utility

» Usage | Directives | Notes | Examples | See also
 
.
  The store utility may be used to compile Eloquence programs into internal representation

Usage

Usage: store [options] inputfile
options:
 -help       = show usage (this list)
 -o file     = specify output filename. Default is 'inputfile.PROG'
               (this is required if reading from stdin)
 -n          = don't create output file
 -e          = change error message form
 -v          = Verbose. Output source lines
 -s          = Use space dependent mode
 -t wdth     = tab width (default is 8, 0 = off)
 -f lno      = first line number (default is 1)
 -i inc      = line number increment (default is 1)
 -r rev      = use specified program format (default is 2)
               (0 = compatible, 1 = A.05.01, 2 = A.06.00)
 -p pswd     = specify program password
Specifying '-' as inputfile will force reading from stdin
The store utility will read the input file (- for stdin) and compile this into an Eloquence program file.

The options are:

-help
The -help option displays a brief help text.

-o file
This option is used to specify an output file name. If not specified, the input file name will be used. Whether the output file name is specified or not, the extension .PROG is automatically added to the file name. Note that this option must be specified if reading from stdin.

-n
This option specifies that an output file not be created; however, the syntax of the input file is still checked.

-v
This option causes the lines of the input file being echoed to stdout.

-s
This option activates the SPACE DEPENDENT mode.

-t wdth = tab width (default is 8, 0 = off)
When editing your programs in an editor rather than the integrated Eloquence editor, tab characters provide a convenient way to format your source code. Tab characters in the source code caused a syntax error. When specifying a tab width, all tab characters read from input file are replaced by the appropriate number of spaces. A zero tab width will disable tab expansion. This may also be controlled by the $TAB directive.

-f lno = first line number (default is 1)
When no line numbers are included in source code, store will provide its own, starting with 1. This command-line switch makes it possible to define the first line number to use for automatically generated line numbers. This may also be controlled by the $LINE directive.

-i inc = line number increment (default is 1)
This command-line switch makes it possible to define the increment, used for automatically generated line numbers. This may also be controlled by the $LINE directive.

-e
If the -e command-line argument is present, store will output error messages is a format more suitable for automatic processing.

-r rev
This option specifies the program file format for the output file. 0 = HP260 compatible, 1 = A.05.01, 2 = A.06.00. The default is 2.

-p password
This option is used to specify a password protecting the program file. Please notice that this option is only available with program format 2.

Directives

The following directives, if included in the source code, make it possible to control the behavior of some store options within the code.

$TAB wdth
This will define a different tab character handling. For example:
$TAB 8
Will define the tab expansion to 8 for subsequent source lines.

$LINE fline,inc
This will define a different automatically generated line numbers. For example:
$LINE 1000,10
Will preset the next automatically generated line number to 1000 and the line increment to 10.
$LINE 1000
Will preset the next automatically generated line number to 1000 and the line increment to 10.

Notes

If the -e command-line argument is present, the error message will be of the following format:
store: "file.in", line 1: IMPROPER STATEMENT
^      ^	  ^	  ^
|      |	  |	  The error message
|      |	  The line number of the input file
|      The name of the input file or stdin if read from stdin
To indicate it's a message from the store utility

Without the -e command-line argument, store will output the following error message:

STOP HERE
     ^
IMPROPER STATEMENT
store: "file.in", line 37
With the -e command-line argument, store will output the following error message:
store: "file.in", line 1: IMPROPER STATEMENT

Examples

store sample.eq
This compiles the input file sample.eq into the program file sample.PROG.

See also

list utility


 
 
.
 
 
  Privacy | Webmaster | Terms of use | Impressum Revision:  2014-08-15  
  Copyright © 2012-2014 Marxmeier Software AG