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

System Functions (s and S) spt_regPathsendTagHandler(2)
NAME
spt_regPathsendTagHandler
- Registers the user-supplied Pathsend tag
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_regPathsendTagHandler(
const long tag,
spt_FileIOHandler_p callback,
void * userdata );
PARAMETERS
tag Specifies the Pathsend tag that should be registered.
callback Specifies a user-supplied callback function. This function
should not block its invoking thread. The callback function
should have the following prototype:
callback(const short filenum,
/* Guardian file number
being waited on */
const long tag,
/* tag being waited on or
-1 for all tags */
const long completionCount,
/* byte transfer count
of completed IO */
const long fserror,
/* Guardian error number for IO */
void * userdata
/* for communication between
I/O initiator and callback. */
);
userdata Specifies data to be communicated between the I/O initiator and
the callback function.
DESCRIPTION
This function registers the Pathsend tag as a tag that the user will manage through a user-supplied
callback function. The callback function is invoked when a Pathsend operation that uses the tag
completes.
RETURN VALUES
SPT_SUCCESS
The specified tag was registered.
SPT_ERROR Another Pathsend handler has already registered the tag.
527186-003 Hewlett-Packard Company 7−133