OpenTP1 Version 7 Programming Reference C Language

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

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.