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 also 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 also from the command line on most systems.

  [Initially off by default.]

INPUT-LISTING

  Echos input lines to output.

  This option can be set also 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 also 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 also 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 useable - 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.]

Additional Information on:

  • DUMP-ON-GRAPHICS-ERROR

  • 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 not be successful:
      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 recommended.
    
      [WARN-BUT-WRITE is default.]
    

    Keyword index. Formatted on 10/11/98.