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

ManualsBrandsHP ManualsServerHP NonStop G-Series

851

852

853

854

855

856

857

858

859

860

SPT_WRITEX(2) OSS System Calls Reference Manual

responsibility to ensure this.

— If you initiated the I/O with

SPT_WRITE(), the I/O must be com-

pleted with a call to the Guardian

AWAITIOX procedure.

— A selectable extended data segment

containing the buffer need not be in use

at the time of the call to AWAITIOX.

— You can cancel nowait I/O that was ini-

tiated with SPT_WRITEX() with a call

to SPT_CANCEL() or CANCELREQ.

The I/O is canceled if the ﬁle is closed

before the I/O completes or if the Guar-

dian AWAITIOX procedure is called

with a positive time limit and speciﬁc

ﬁle number and the request times out.

Interprocess Communication Consideration

Indication that the destination process is running

If the SPT_WRITEX() call is to another process, successful

completion of the SPT_WRITEX() call (or a Guardian

AWAITIOX procedure call if nowait) indicates that the destina-

tion process is running.

RETURN VALUES

The SPT_WRITEX() function returns 0 (zero) upon successful completion. Otherwise, this

function returns a nonzero Guardian ﬁle-system error number that indicates the outcome 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_WRITEUPDATEX(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−374 Hewlett-Packard Company 527186-007