sagew: Running a Sculptor screen form program¶
Contents
Syntax¶
sagewc progname [arguments]…
When a screen form program has been successfully compiled with the compiler scc, the run time interpreter sagewc is used to run the program. A screen form program is one that contains no report logic.
progname |
The name of the compiled program. The compiled form of the source code bears the same name (progname) as the source file, but has a .g extension rather than a .f extension. Inclusion of the .g extension in the command line is optional. |
[arguments] |
Command line arguments may be sent to a screen form program, as in this example: sagewc stkcheck 1001 TEST
The arguments may be accessed within the program by means of the subscripted Sculptor system variable sys.Arg. In the example above, sys.Arg[1] is “sagewc”,
sys.Arg[2] is “stkcheck”,
sys.Arg[3] is “1001” and
sys.Arg[4] is “TEST”.
Note that the space character denotes the end of an argument. In order to send an argument which contains a space, enclose it in double quotes. It is recommended that only a few simple arguments are passed on the command line, as some operating systems permit only a short command line. Storing information in a file is a better way to pass it between two Sculptor programs. |
Other versions of sagewc¶
The following additional versions of sagewc are available:
sagewcd |
Used to help debug programs which have been compiled with the -d option. sagewcd is executed automatically by the Sculptor debug program scdebug, which allows source code to be viewed as the program runs. Other features include single stepping of commands, breakpoints, and examination of variable values and of the function stack. sagewcd is intended for automatic use by scdebug only, and should not be used to run programs directly. |
The $SCULPTOR/app directory¶
The directory $SCULPTOR/app may be used to store compiled programs. If the progname begins with a colon (:) the program is loaded from $SCULPTOR/app.
EXAMPLE
sagewc :updctrl
Loading a program from a remote server¶
The run time interpreter sagewc can load a program from a remote server which is running one of the Sculptor server programs kfserver and kfservnt. The full path to the object code file (.g extension) should be specified. See Running Sculptor programs on a server.
EXAMPLE
sagewc myserver:/usr/myapp/myprogram
NOTES
The run time interpreters sagew and sagewd should be treated as obsolescent.
RELATED TOPICS |