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

put_regPathsendTagHandler(2) OSS System Calls Reference Manual
NAME
put_regPathsendTagHandler - Registers the user-supplied Pathsend tag
LIBRARY
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zputdll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/yputdll
SYNOPSIS
#include <pthread.h>
put_error_t put_regPathsendTagHandler(
const long tag,
put_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.
To use this function on systems running H06.21 or later RVUs or J06.10 or later RVUs, you must
perform all of the following tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library (/G/system/zdllnnn/zputdll).
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
this function with 32-bit or 64-bit applications.
5−260 Hewlett-Packard Company 527186-023