OpenTP1 Version 7 Programming Reference C Language

[Contents][Index][Back][Next]

dc_tam_get_inf - Acquire TAM table status

Format

ANSI C, C++

#include <dctam.h>
int  dc_tam_get_inf (char *tblname, DCLONG flags)

K&R C

#include <dctam.h>
int  dc_tam_get_inf (tblname, flags)
char    *tblname;
DCLONG  flags;

Description

The function dc_tam_get_inf() acquires the status of a TAM table. The TAM table status to be acquired includes the following:

The function dc_tam_get_inf() can be called both outside and inside the transaction.

The function dc_tam_get_inf() returns assuming that the specified TAM table is open in the following case:

Arguments whose values are set in the UAP

tblname

Specify the address of the name of the TAM table whose status is to be acquired. The TAM table can be specified with up to 32 characters. The character string must end with a null character.

flags

Specify DCNOFLAGS.

Return values

With a positive return value (indicating the TAM table status)

Return value Return value (numeric) Explanation
DCTAM_STS_OPN 1 The TAM table is open.
DCTAM_STS_CLS 2 The TAM table is closed.
DCTAM_STS_LHLD 3 The TAM table is in logical shutdown state.
DCTAM_STS_OHLD 4 The TAM table is in shutdown state due to an error.

With a negative return value (indicating that an error occurred)

Return value Return value (numeric) Explanation
DCTAMER_PARAM_TBL -1701 The value specified for tblname is invalid.
DCTAMER_PARAM_FLG -1708 The value specified for flags is invalid.
DCTAMER_UNDEF -1710 The TAM table has not been defined.
DCTAMER_TAMEND -1720 The TAM service is being terminated.
DCTAMER_PROTO -1721 The sequence of accessing the TAM table is invalid.
The resource manager registration of the object file for transaction control having a linkage with the UAP is invalid.
Alternatively, there is no linkage between the object file for transaction control and the UAP.
atomic_update=N (nontransaction attribute) is specified in the user service definition of the UAP which called the function.
DCTAMER_TAMVR -1762 The version of the TAM library linked to the UAP does not allow the UAP to operate with the current TAM service.
DCTAMER_ACCESS -1773 A TAM file to be accessed is protected with the security facility. The UAP that called the function dc_tam_get_inf() has no access permission.
DCTAMER_NO_ACL -1772 A TAM file to be accessed is protected with the security facility. There is no ACL for the corresponding file.