Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

abtsev

Shows  the  current abort severity or specifies the error level at which command
file execution terminates.

Format

abtsev [-internal | -error]

Description

The DSEE facility recognizes  two  levels  of  errors:  expected  errors,  which
include such user errors as an incorrect specification for a branch name, or the
specification of an nonexistent version; and unexpected  (or  internal)  errors,
which include problems beyond the DSEE facility's scope such as network failure.
By default, either  type  of  error  aborts  execution  of  a  command  file  (a
redirected  input  file). If the command file is nested within one or more other
command files, an error aborts execution of all calling command files  as  well.
(The default is akin to abtsev -error.)

Abort  severity is inherited. However, you can also embed abtsev commands within
nested command files, changing the abort severity at  different  levels  in  the
nesting.

When  a  nested  command file encounters an error beyond its abort severity, the
DSEE facility stops executing the  command  file  and  returns  to  the  calling
command  file.  The calling command file's abort severity determines whether the
error encountered by the called command file aborts the  calling  command  file,
also.    Internal  errors  abort execution of all levels of command files in the
nesting, because no level of abort severity negates internal errors' effects  on
command files.

abtsev with no options shows you the current abort severity.


 Options:

 -internal       Sets abort severity to recognize internal errors only.

 -error (D)      Sets abort severity to recognize all errors.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026