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

PUT_CANCEL(2) OSS System Calls Reference Manual
NAME
PUT_CANCEL - Cancels the oldest incomplete operation on a Guardian file opened for nowait
I/O
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 <cextdecs.h>]
#include <pthread.h>
short PUT_CANCEL(
short filenum);
PARAMETERS
filenum Specifies the Guardian file number of a Guardian file open instance whose oldest
incomplete operation you want to cancel.
DESCRIPTION
The PUT_CANCEL() function is a thread-aware version of the Guardian CANCEL procedure.
The PUT_CANCEL() function is used to cancel the oldest incomplete operation on a Guardian
file opened for nowait I/O. The canceled operation might or might not have had effects. For disk
files, the file position might or might not be changed.
For programming information about the Guardian CANCEL procedure, see the Guardian
Programmer’s Guide.
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.
To use this function in a 32-bit application on systems running H06.24 or later RVUs or J06.13 or
later RVUs, perform the same tasks (described above) used to enable the function on systems
running H06.21/J06.10 or later RVUs.
To use this function in a 64-bit application on systems running H06.24 or later RVUs or J06.13 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.
• Compile the application using the -Wlp64 compiler command option.
• Link the application to the yputdll library (/G/system/zdllnnn/yputdll).
5−188 Hewlett-Packard Company 527186-023