Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-76
CLOSE Procedure (Superseded by FILE_CLOSE_
Procedure )
2 Rewind, leave online, do not wait for completion
3 Rewind, leave online, wait for completion
4 Do not rewind, leave online
Condition Code Settings
< (CCL) indicates that the file was not open or, for $RECEIVE or the TFILE, there is
an outstanding operation using an active transaction.
= (CCE) indicates that the CLOSE was successful.
> (CCG) does not return from CLOSE.
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 a CLOSE is issued 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.
Messages
•
Process close message
A process can receive a process close system message when it is closed by
another process. You can obtain the process ID of the closer in a subsequent call
to LASTRECEIVE or RECEIVEINFO. Refer to the
Guardian Procedure Errors and
Messages Manual for detailed information of system messages sent to processes.
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.