Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-15
FILE_CLOSE_ Procedure
is one of the following values, indicating 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.
5 Reserved for parallel backup.
Other input values result in no error if the file is a tape device; the control action
might be unpredictable.
If omitted, 0 is used.
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.
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_. Refer to the
Guardian Procedure Errors and
Messages Manual for detailed information about system messages.
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.