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

System Functions (n - p) PUT_FILE_OPEN_(2)
primary_proc esshandle
Indicates that the caller is requesting a backup open and specifies the process
handle of the primary process that already has the file open when its backup
attempts to open the file. If this parameter is supplied and not null (a null pro-
cess handle has -1 in each word), filenum must contain the filenum value that was
returned to the primary. If a null process handle is supplied, or the parameter is
omitted, a normal open is being requested. Use this option only when the
backup process is the caller. It is more common for the primary process to per-
form this operation by a call to the FILE_OPEN_CHKPT_ procedure.
elections Specifies the following options as a bit mask:
0 through 30 Reserved; specify 0 (zero).
31 Use 64-bit primary keys. For disk files only, bit 31 specifies that
64-bit primary-key values are used instead of 32-bit values for
unstructured, relative, or entry-sequenced files. Bit 31 is ignored
for key-sequenced files and nondisk devices.
You can use the elections parameter with both Format 1 and Format 2 Guardian
files. If this parameter is omitted, 0 (zero) is used for all bits.
DESCRIPTION
The PUT_FILE_OPEN_() function is a thread-aware version of the Guardian FILE_OPEN_
procedure.
The PUT_FILE_OPEN_() function establishes a communication path between an application
process and a file. When PUT_FILE_OPEN_() successfully completes, it returns a Guardian
file number to the caller. The file number identifies this access path to the file in subsequent
Guardian file-system calls.
To use this function on systems running J06.10 or later RVUs or H06.21 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.
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.
527186-023 Hewlett-Packard Company 5−203