Open System Services System Calls Reference Manual (G06.25+, H06.03+)

System Functions (s and S) spt_interruptTag(2)
NAME
spt_interruptTag - Interrupts thread awaiting tagged I/O
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
H-series OSS processes: /G/system/zdllnnn/zsptdll
SYNOPSIS
#include <spthread.h>
spt_error_t spt_interruptTag(
const short filenum,
const long tag,
const spt_error_t error_SPT);
PARAMETERS
filenum Specifies the Guardian file number for the file whose awaiting I/O is to be inter-
rupted
tag Specifies tag whose awaiting I/O is to be interrupted
error_SPT Specifies SPT error returned to awaiting IO
DESCRIPTION
Interrupts the thread awaiting the tagged I/O on file number. Note that the I/O is not cancelled by
this function. Interrupted threads will return from the spt_awaitio() function with a return value
of error_SPT. Additionally, the error parameter passed to spt_awaitio() will be set as shown in
the ERRORS section.
RETURN VALUES
SPT_SUCCESS
Awaiting IO was interrupted.
SPT_ERROR One of the following conditions exists:
• The value of filenum was less than 0 (zero), or no awaiting I/O was
found
• The value of filenum is not registered
• The value for error_SPT is invalid
ERRORS
-1 SPT_ERROR
40 SPT_TIMEDOUT
EINTR SPT_INTERRUPTED
STANDARDS CONFORMANCE
This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this
reference 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-003 Hewlett-Packard Company 7−113