Guardian Procedure Calls Reference Manual

Returned Value
INT
A file-system error code that indicates the outcome of the call. No error is retryable; most of the
possible error conditions are the result of programming errors.
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 concurrently.
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.
• Closing a nowait file
If FILE_CLOSE_ is executed for a nowait file that has pending operations, any incomplete
operations are canceled. There is no indication as to whether the operation completed or not.
• Labeled tape processing
If your system has labeled tape processing enabled, all tape actions (as specified by
tape-disposition) wait for completion.
• Closing a process
FILE_CLOSE_ is executed for a process in a nowait manner (even if the process was opened
for waited I/O). FILE_CLOSE_ returns to the caller after initiating a process close request,
regardless of whether completion has occurred.
Messages
• Process close message
A process can receive a process close system message when it is closed by another process.
It can obtain the process handle of the closer by a subsequent call to FILE_GETRECEIVEINFO_.
For detailed information about system messages, see the Guardian Procedure Errors and
Messages Manual.
NOTE: This message is also received if the close is made by the backup process of a process
pair. Therefore, a process can expect two of these messages when being closed by a process
pair.
Related Programming Manuals
For programming information about the FILE_CLOSE_ procedure, see the Guardian Programmer's
Guide.
FILE_CLOSE_Procedure 363