Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

spt_regPathsendTagHandler(2) OSS System Calls Reference Manual
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.
RELATED INFORMATION
Functions: spt_unregPathsendTagHandler(2),
SPT_SERVERCLASS_DIALOG_ABORT_(2),
SPT_SERVERCLASS_DIALOG_BEGIN_(2), SPT_SERVERCLASS_DIALOG_END_(2),
SPT_SERVERCLASS_DIALOG_SEND_(2), SPT_SERVERCLASS_SEND_INFO_(2),
SPT_SERVERCLASS_SEND_(2).
7−384 Hewlett-Packard Company 527186-023