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

System Functions (s and S) spt_INITRECEIVE(2)
NAME
spt_INITRECEIVE - Registers $RECEIVE filename
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
H-series OSS processes: /G/system/zdllnnn/zsptdll
SYNOPSIS
#include <spthread.h>
long spt_INITRECEIVE (
const short filenum,
const short receive_depth);
PARAMETERS
filenum Specifies Guardian file number whose IO has completed
receive_depth Specifies the maximum number of incoming messages as specified in the filenum
value is FILE_OPEN() call
DESCRIPTION
This function registers filenum as being managed by the $RECEIVE callback.
RETURN VALUES
This function returns Guardian error numbers, which include:
0 $RECEIVE was successfully registered.
29 $RECEIVE was already registered prior to this call.
29 FILE_COMPLETE_SET_() addition of $RECEIVE returned nonzero.
29 Value for filenum not 0.
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−111