User Guide

ManualsBrandsAmpex Data Systems ManualsOtherDSTDIS TAPE DRIVE PROGRAMMER S GUIDE, PART NO. 1308911-02

111

112

113

114

115

116

117

118

119

120

Ampex 1308911-02 6-5

DD-2 Utilities Manual Pages DD-2 Utilities Overview

6.2.6 Environment

The $TAPE environment variable speciﬁes the tape device to use if the

-f <device_special_ﬁle> option is omitted. There is no default if $TAPE is not deﬁned.

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

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.

• 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

EFAULT and writes the following DUE message to

stderr:

DUE0019: Volume Verification Failed

• When a utility fails because of an incorrect option ﬂag on the command line, it sets exit

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

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