dc_dam_close - Close a logical file

ANSI C, C++

#include <dcdam.h>
int dc_dam_close (int damfd, DCLONG flags)

K&R C

#include <dcdam.h>
int dc_dam_close (damfd, flags)
int      damfd;
DCLONG   flags;

The function dc_dam_close() closes logical files.

For recoverable DAM files
If a logical file opened within the transaction is not closed before the transaction terminates, the DAM service closes it at the synchronization point processing. However, the DAM service does not close a logical file opened outside the transaction (before the function dc_trn_begin() is called) or an unrecoverable DAM file.
If a logical file is opened before the transaction is started, it must be closed before the UAP processing is terminated.
For unrecoverable DAM files
Since a logical file is not synchronized with the transaction, the function dc_dam_close() can arbitrarily be called when a logical file is closed. However, opened logical files must be closed with the function dc_dam_close() before the function dc_dam_end() is called.

When closing a logical file, specify the file descriptor which is the return value of the function dc_dam_open().

damfd

Specify the file descriptor of the file to be closed.

flags

Specify DCNOFLAGS.

Return value	Return value (numeric)	Explanation
DC_OK	0	The logical file was closed normally.
DCDAMER_PROTO	-1600	The function dc_rpc_open() is not called.
		A DAM file opened outside the transaction is closed within the transaction. (This value is returned only when a recoverable DAM file is accessed.)
		N is specified for atomic_update in the user service definition. (This value is returned only when a recoverable DAM file is accessed.)
		The function dc_dam_start() is not called. (This value is returned only when an unrecoverable DAM file is accessed.)
		The UAP is incorrectly linked as follows: The library (-1tdam) to be used for access to a TAM file using a DAM service function is linked incorrectly. The definition of the resource manager for transaction control object files is incorrect.
DCDAMER_BADF	-1603	The file descriptor specified for damfd is not the one which was acquired by opening the file normally, or the file of the file descriptor is not open.
DCDAMER_PARAM_FLAGS	-1611	The value specified for flags is invalid.