OpenTP1 Version 7 Programming Reference C Language
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. |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.