Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

SPT_WRITEUPDATEX(2) OSS System Calls Reference Manual

Magnetic Tape Considerations

Supported equipment

SPT_WRITEUPDATEX() is permitted only on the 3202 Controller for the

5103 or 5104 Tape Drives. This function is not supported on any other

controller/tape drive combination. SPT_WRITEUPDATEX() is speciﬁcally

not permitted on the following controller/tape drive pairs:

• 3206 Controller and the 5106 Tri-Density Tape Drive

• 3207 Controller and the 5103 & 5104 Tape Drives

• 3208 Controller and the 5130 & 5131 Tape Drives

Specifying the correct number of bytes written

When SPT_WRITEUPDATEX() is used with magnetic tape, the number of

bytes to be written must ﬁt exactly; otherwise, information on the tape can be

lost. However, no error indication is given.

Limitation of SPT_WRITEUPDATEX() to the same record

Five is the maximum number of times a SPT_WRITEUPDATEX() call can be

executed to the same record on tape.

RETURN VALUES

The SPT_WRITEUPDATEX() function returns 0 (zero) upon successful completion. Other-

wise, this function returns a nonzero Guardian ﬁle-system error number that indicates the out-

come of the operation.

For information about Guardian ﬁle-system error numbers, see the Guardian Procedure Errors

and Messages Manual.

ERRORS

None. This function does not set the errno variable.

RELATED INFORMATION

Functions: SPT_CANCEL(2), SPT_CONTROL(2), SPT_FILE_CLOSE_(2),

SPT_FILE_OPEN_(2), SPT_LOCKFILE(2), SPT_LOCKREC(2), SPT_READLOCKX(2),

SPT_READUPDATELOCKX(2), SPT_READUPDATEX(2), SPT_READX(2),

SPT_SETMODE(2), SPT_UNLOCKFILE(2), SPT_UNLOCKREC(2),

SPT_WRITEREADX(2), SPT_WRITEUPDATEUNLOCKX(2), SPT_WRITEX(2).

STANDARDS CONFORMANCE

This function is an extension to the UNIX 98 speciﬁcation. Interfaces documented on this refer-

ence page conform to the following industry standards:

• IEEE Std 1003.1c-1995, POSIX System Application Program Interface

The use of the header ﬁle spthread.h is an HP exception to the POSIX standard.

7−464 Hewlett-Packard Company 527186-023