dc_dam_start - Start using an unrecoverable DAM file

OpenTP1 Version 7 Programming Reference C Language

dc_dam_start - Start using an unrecoverable DAM file

Format

ANSI C, C++

#include <dcdam.h>
int  dc_dam_start (DCLONG flags)

K&R C

#include <dcdam.h>
int  dc_dam_start (flags)
DCLONG     flags;

Description

The function dc_dam_start() declares that an unrecoverable DAM file is used. Call the function dc_dam_start() before the function dc_dam_open(). Call the function dc_dam_start() for each UAP process.

When the function dc_dam_start() returns normally, the environment to access an unrecoverable DAM file is established.

Arguments whose value is set in the UAP

flags

Specify DCNOFLAGS.

Return values

Return value	Return value (numeric)	Explanation
DC_OK	0	Normal termination. Unrecoverable DAM files now can be used.
DCDAMER_PROTO	-1600	The function dc_rpc_open() is not called.
DCDAMER_NOMEM	-1607	The memory became insufficient.
DCDAMER_PARAM_FLAGS	-1611	The value specified for flags is invalid.
DCDAMER_VERSION	-1618	The UAP is linked with a DAM library which is inoperable with the current DAM service.
DCDAMER_STARTED	-1647	The function dc_dam_start() has already been called.