Open System Services System Calls Reference Manual (G06.28+, H06.05+)

System Functions (s and S) SPT_WRITEUPDATEX(2)
Specifying the correct number of bytes written
When SPT_WRITEUPDATEX() is used with magnetic tape,
the number of bytes to be written must fit exactly; otherwise,
information on the tape can be lost. However, no error indica-
tion 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 file-system error number that indicates the out-
come of the operation.
For information about Guardian file-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 specification. 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 file spthread.h is an HP exception to the POSIX standard.
527186-007 Hewlett-Packard Company 7−361