ampex-data dstdis tape drive programmer s guide, part no. 1308911-02 User Manual
Ampex 1308911-02
6-5
DD-2 Utilities Manual Pages
DD-2 Utilities Overview
6.2.6
Environment
The $TAPE environment variable specifies the tape device to use if the
-f <device_special_file> option is omitted. There is no default if $TAPE is not defined.
-f <device_special_file> option is omitted. There is no default if $TAPE is not defined.
6.2.7
Exit Status
The dd2 utilities use the following exit status codes to indicate success or failure. To view an
exit status code in C-shell, type
exit status code in C-shell, type
echo $status
.
0
Operation succeeded.
nonzero
Operation failed.
A nonzero return value describes the error encountered error during processing. An error
message is written to stderr along with the return value.
message is written to stderr along with the return value.
•
When a utility fails because it cannot open the tape drive, it sets
errno
and writes the
following DUE message to stderr:
DUE0012: Open Error %d (%s) on '%s'\
where
(%d)
is the errno value and
(%s)
is a descriptive string
•
When a utility fails because of an unsuccessful libdd2 API function call , it sets
errno
and writes the following DUE message to stderr:
DUE0013: IOCTL Error %d (%s) on '%s' during '%s'\n
•
When a utility fails because the volume id of a token doesn’t match the volume id of the
tape cartridge, it sets exit status to
tape cartridge, it sets exit status to
EFAULT
and writes the following DUE message to
stderr:
DUE0019: Volume Verification Failed
•
When a utility fails because of an incorrect option flag on the command line, it sets exit
status to
status to
EINVAL
and writes one of the following DUE messages to stderr:
DUE0009: Option Specification Error - extraneous options
specified: '%s'
DUE0008: Option Specification Error - required option '%s' is
missing
DUE0005: Option Specification Error - out-of-range value
specified for '%s'%s
DUE0007: Option Specification Error - value is missing for '%s'
DUE0006: Option Specification Error - syntax or semantics
incorrect for'%s'%s
•
When a utility fails because of an incorrect keyword in the stdout string, it sets exit status
to
to
EINVAL
and writes one of the following DUE message(s) to stderr:
DUE0010: Output Specification Error - bad keyword syntax %s
DUE0011: Output Specification Error - unknown keyword %s