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

System Functions (n - p) PUT_FILE_CLOSE_(2)
NAME
PUT_FILE_CLOSE_ - Closes an open Guardian file
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_FILE_CLOSE_(
short filenum,
short tape_disposition);
PARAMETERS
filenum Specifies the file number of a Guardian file open instance that identifies the file
to be closed.
tape_disposition
(Optional) Indicates the tape control action to take:
0 Rewind and unload; do not wait for completion.
1 Rewind and unload, do not wait for completion.
2 Rewind and leave online; do not wait for completion.
3 Rewind and leave online; wait for completion.
4 Do not rewind; leave online.
Other input values result in no error if the file is a tape device; the control action
might be unpredictable. If this parameter is omitted, 0 (zero) is used.
DESCRIPTION
The PUT_FILE_CLOSE_ () function is a thread-aware version of the Guardian FILE_CLOSE_
procedure.
The FILE_CLOSE_ procedure closes a Guardian file open instance. Closing a file open instance
terminates access to the file through that open instance. You can use PUT_FILE_CLOSE_() to
close files that were opened by PUT_FILE_OPEN_().
For programming information about the FILE_CLOSE_ procedure, see the Enscribe
Programmer’s Guide and 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.
527186-023 Hewlett-Packard Company 5−197