Interactive Control of Open GENIE Sessions

This section lists command which are primarily designed to be used interactively for the control of an Open GENIE terminal sesssion.

Copying Prints the GNU licensing conditions for Open GENIE
Exit Exits from Open GENIE
Load Loads a file containing GCL procedures into GENIE
Save Saves a complete Open GENIE image file with all variables and procedures.
Warranty Prints the warranty disclaimer for Open GENIE

Copying()

Prints the GNU licensing conditions for Open GENIE

COPYING   Print the distribution licence

Copying()

Prints a copy of the licensing conditions for distribution/re-distribution of Open GENIE under the GNU General Public licence.

Exit()

Exits from Open GENIE

EXIT   Stops Open GENIE

example:

	# Finish an open genie session
	>> Exit
	GENIE exiting
	$

Note: Can also use quit to stop Open GENIE

Exit

Stops an Open GENIE session from the command line.

Load()

Loads a file containing GCL procedures into GENIE

LOAD filename=String Load a command file

example:

	# Load a genie program
	>> Load "myprog.gcl"
	Loading file myprog.gcl ........
	        56 lines scanned/compiled
	>>

Note: Cannot always load one command file from within another.

Load

The load command allows a file consisting of Open GENIE commands and procedure definitions to be read by Open GENIE. It is normally possible to have one file containing "Load" commands for a few other component files but some care should be taken as the Load() command is primarily an interactive command and some odd effects may occur as a result of multiple nesting or calling of Load() within a procedure (not recommended).

Parameters:

Filename (String)

File consisting of valid GCL statements and PROCEDURE definitions.

RESULT = (Boolean)

Returns $FALSE if the load command failed to work.

Save()

Saves a complete Open GENIE image file with all variables and procedures.

SAVE filename=String Save a frozen image of the current Open GENIE

example:

	# Save the current session
	>> Save "mygenie.im"
	Saving GENIE in file mygenie.im ...
	>>

Note: Saving an image after loading a large number of procedures can give a quicker startup.

Save

The save command saves a binary image of the complete internal state of Open GENIE. It is most useful when quite a large number of GCL procedures have been loaded as part of a major program. To save time on startup, use the Save() command to create an image immediately after starting Open GENIE and loading the necessary GCL files.

Open GENIE can be re-invoked with the new image containing all the procedures by the command

$ genie "" mygenie.im

or by defining the symbol or logical name GENIE_SMALLTALK_IMAGE to point to the file. Note that if an image is not found, Open GENIE willl usually start up with some errors.

Parameters:

Filename (String)

File to save the binary image in, convetionally ending with ".im"

Warranty()

Prints the warranty disclaimer for Open GENIE

WARRANTY   Print the warranty disclaimer

Warranty()

Prints a copy of the warranty disclaimer for Open GENIE.