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

PUT_CONTROL(2) OSS System Calls Reference Manual
NAME
PUT_CONTROL - Performs device-dependent input/output operations
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_CONTROL(
short filenum,
short operation,
short param,
long tag);
PARAMETERS
filenum Specifies the Guardian file number of a Guardian file open instance, identifying
the file on which the underlying CONTROL procedure performs an input or out-
put operation.
operation Specifies a value from 1 through 27 that defines a type of operation to be per-
formed. For tables that list operation numbers and the possible param values for
each, see the description of the CONTROL procedure in the Guardian Pro-
cedure Calls Reference Manual.
param (Optional) Specifies a value that defines the operation to be performed. For
tables that list operation numbers and the possible param values for each, see the
description of the CONTROL procedure in the Guardian Procedure Calls Refer-
ence Manual.
tag (Optional) For nowait I/O only. The tag value you define uniquely identifies the
operation associated with this call.
This parameter is supported only for program compatibility; if you provide it, it
is ignored.
DESCRIPTION
The PUT_CONTROL( ) function is a thread-aware version of the Guardian CONTROL pro-
cedure. CONTROL is used to perform device-dependent input or output operations.
If the PUT_CONTROL() function is used on a file that is opened for nowait I/O, the function
must be completed with a call to the AWAITIO procedure.
The following considerations apply to use on disk files:
Writing EOF to an unstructured file
Writing EOF to an unstructured disk file sets the EOF pointer to the relative byte
address indicated by the setting of the next-record pointer and writes the new
EOF setting in the file label on disk. (File pointer action for CONTROL opera-
tion 2, write EOF.)
File is locked If a CONTROL operation is attempted for a file locked through a filenum other
than that specified in the call to PUT_CONTROL(), the call is rejected with a
"file is locked" error 73. If any record is locked in a file, a call to
PUT_CONTROL() to write EOF (operation 2) to that same file will be rejected
with a "file is locked" error 73.
5−190 Hewlett-Packard Company 527186-023