Open System Services System Calls Reference Manual (G06.28+, H06.05+)

SPT_FILE_CLOSE_(2) OSS System Calls Reference Manual
NAME
SPT_ FILE_CLOSE_ - Closes an open Guardian file
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
H-series OSS processes: /G/system/zdllnnn/zsptdll
SYNOPSIS
[#include <cextdecs.h>]
#include <spthread.h>
short SPT_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
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 SPT_FILE_CLOSE_ () function is the 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 SPT_FILE_CLOSE_() to
close files that were opened by SPT_FILE_OPEN_().
For programming information about the FILE_CLOSE_ procedure, see the Enscribe
Programmer’s Guide and the Guardian Programmer’s Guide.
Considerations
Returning space allocation after closing a file
Closing a disk file causes the space that is used by the resident file control block
to be returned to the system main-memory pool if the disk file is not open con-
currently. A temporary disk file is purged if the file was not open concurrently.
Any space that is allocated to that file is made available for other files. With any
file closure, the space allocated to the access control block (ACB) is returned to
the system.
7−136 Hewlett-Packard Company 527186-007