OpenTP1 Version 7 Programming Reference C Language
dc_tam_status - Acquire TAM table information
Format
ANSI C, C++
#include <dctam.h> int dc_tam_status (char *tblname, struct DC_TAMSTAT *stbuf, DCLONG flags) |
K&R C
#include <dctam.h> int dc_tam_status (tblname, stbuf, flags) char *tblname; struct DC_TAMSTAT *stbuf; DCLONG flags; |
Description
The function dc_tam_status() returns TAM table information in a structure DC_TAMSTAT. The following values are returned by the function:
Arguments whose value is set in the UAP
tblname
Specify the name of the TAM table from which information is acquired up to 32 characters. End the character string with a null character.
stbuf
Specify the address of a structure DC_TAMSTAT that receives TAM table information. The TAM table status set in the function dc_tam_status() is returned in the structure.
flags
Specify DCNOFLAGS.
Argument whose value is returned from OpenTP1
stbuf
TAM table information is returned in the format of structure DC_TAMSTAT as follows:
struct DC_TAMSTAT { char st_file_name[64]; DCLONG st_tbl_stat; DCLONG st_rec_usenum; DCLONG st_tbl_maxnum; char st_idx_type; char st_acs_type; char st_lod_type; char reserve1; DCLONG st_rec_len; DCLONG st_key_len; DCLONG st_key_pos; DCLONG st_tbl_sec; DCLONG reserve2[8]; }; |
Return values
Return value | Return value (numeric) | Explanation |
---|---|---|
DC_OK | 0 | Information was acquired from the TAM table normally. |
DCTAMER_PARAM_TBL | -1701 | The value specified for tblname is invalid. |
DCTAMER_PARAM_FLG | -1708 | The value specified for flags is invalid. |
DCTAMER_NOTTAM | -1709 | The name specified for tblname is not a TAM file name. |
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 transactions control having a linkage with the UAP is invalid. Alternatively, there is no linkage between the object file for control of transactions and the UAP. |
||
atomic_update=N (nontransaction attribute) is specified in the user service definition of the UAP which called the function. | ||
DCTAMER_TBLVR | -1760 | The version of the TAM library linked to the UAP does not allow the UAP to operate with the current TAM table. |
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_OPENNUM | -1766 | The number of open character special files exceeds the specified limit. |
DCTAMER_ACCESSS | -1767 | The access permission for special files has not been granted. |
DCTAMER_MEMORY | -1769 | The memory became insufficient. |
DCTAMER_IO | -1770 | An input/output error occurred. |
DCTAMER_NO_ACL | -1772 | The TAM table from which information is acquired is protected with the security facility. There is no ACL for the corresponding TAM table. |
DCTAMER_ACCESS | -1773 | The TAM table from which information is acquired is protected with the security facility. The UAP that called the function dc_tam_status() has no access permission. |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.