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

System Functions (n - p) PUT_SETMODE(2)
NAME
PUT_SETMODE - Sets device-dependent Guardian file-system functions
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_ SETMODE(
short filenum,
short function,
short param1,
short param2,
short *last_params);
PARAMETERS
filenum Specifies the Guardian file number of a Guardian file open instance, identifying
the file to receive the requested function.
function Specifies the number of a device-dependent function. For a description of valid
values, see the table of SETMODE functions in the Guardian Procedure Calls
Reference Manual.
param1 (Optional) Provides the first value or pattern of set bits that defines the specific
function setting to be used. For a description of valid values, see the table of
SETMODE functions in the Guardian Procedure Calls Reference Manual.
param2 (Optional) Provides the second value or pattern of set bits that defines the
specific function setting to be used. For a description of valid values, see the
table of SETMODE functions in the Guardian Procedure Calls Ref erence
Manual.
last_params (Optional) Returns the previous settings of param1 and param2 associated with
the current function.
DESCRIPTION
The PUT_SETMODE() function is a thread-aware version of the Guardian SETMODE pro-
cedure.
The PUT_SETMODE() function is used to set device-dependent Guardian file-system func-
tions. A call to the PUT_SETMODE() function is rejected with an error indication if incom-
plete nowait operations are pending on the specified file.
For programming information about the Guardian SETMODE file-system procedure, see the
Guardian Programmer’s Guide and the manual for the data communication protocol you are
using.
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.
527186-023 Hewlett-Packard Company 5−269