OPTIONS

DEBUG

Switches on debugging mode. Make sure you have a program listing at hand ! This may vastly increase the amount of output being produced.

This option can be set from the command line on most systems.

[Initially off by default.]

IDENTIFICATION

Prints the names of a few selected subroutines when they are called.

This option can be set from the command line on most systems.

[Initially off by default.]

INPUT-LISTING

Echos input lines to output.

This option can be set from the command line on most systems.

[This option is initially on by default in batch and initially off in interactive mode.]

RECORDING

Requests recording all terminal input in a file, called GARFLAST.DAT, GARFLAST INPUT or garflast.dat depending on the operating system.

This option can be set from the command line on most systems.

[This option is initially off by default in batch and initially on in interactive mode.]

PROGRESS-PRINT

Switching this option on, enables you to follow the progress of a few CPU intensive instructions (such as ARRIVAL and TIMING).

This option can be set from the command line on most systems.

[This option is initially off by default in batch and initially on in interactive mode.]

ON-ERROR-CONTINUE

In case an input error is detected (unknown arguments, wrong syntax, invalid number etc), the command is executed using (partial) defaults.

In case repairable execution time errors are detected, whatever action needed to complete the command is taken. The command is aborted if no fix can be applied but program execution continues.

[This option is default.]

ON-ERROR-SKIP

In case an input error is detected (unknown arguments, wrong syntax, invalid number etc), the command is skipped.

In case of an execution time error, the command is aborted but program execution continues. Thus for instance a cell that contains 2 wires that overlap, is flagged as not usable - and subsequent sections using cell data are skipped.

This setting is useful in batch and also interactively on machines that do not allow control-C type interrupts (stopping a command but not the program).

Note that this option has effect on some CPU intensive instructions only - the effect can, on demand, be extended to other instructions.

[ON-ERROR-CONTINUE is default.]

ON-ERROR-TERMINATE

In case an input error (unknown arguments, wrong syntax etc) or an execution time error is detected, program execution is terminated.

Note that this option has effect on some CPU intensive instructions only - the effect can, on demand, be extended to other instructions.

[ON-ERROR-CONTINUE is default.]

DUMP-ON-GRAPHICS-ERROR

Produces a dump when encountering certain errors while projecting planes and removing hidden parts. Program execution is terminated after the dump has been created.

This is a debugging option.

[This option is switched off initially.]

Additional information on:

PLASPL	GRAREA
BUTFLY

WARN-BUT-WRITE

If an attempt is made to write a member to a dataset that already contains a member with the same name and of the same type, then a warning message will be issued but the member will be written.

Attempts to read such a member will in general lead to unexpected results: the member that already existed will be seen first and will be read instead of the newly written member.

[This is default.]

WARN-AND-NOWRITE

If an attempt is made to write a member to a dataset that already contains a member with the same name and of the same type, then a warning message will be issued and the member will not be written.

Moreover, an error condition is raised and certain instructions that generate dataset output as they proceed, such as ARRIVAL and MINIMISE, will not be executed if the ON-ERROR-SKIP option is active. Program execution will be terminated if ON-ERROR-TERMINATE has been selected.

[WARN-BUT-WRITE is default.]

DELETE-OLD-MEMBER

If an attempt is made to write a member to a dataset that already contains a member with the same name and of the same type, then the already existing member(s) will be marked for deletion and the new member is appended at the end.

As a result, a read will be successful.

The members marked for deletion are not physically removed from the file and can be recovered with the RECOVER dataset command. They can be removed from the file with the PURGE dataset command.

This option requires more extensive dataset access and is therefore slower than its alternatives. Use of this option is nevertheless recommended since dataset access in Garfield is usually a marginal CPU time consumer.

[WARN-BUT-WRITE is default.]

Go to the top level, to OPTIONS, to the topic index, to the table of contents, or to the full text.

Formatted on 21/01/18 at 16:55.