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 valueReturn value (numeric)Explanation
DC_OK0Information was acquired from the TAM table normally.
DCTAMER_PARAM_TBL-1701The value specified for tblname is invalid.
DCTAMER_PARAM_FLG-1708The value specified for flags is invalid.
DCTAMER_NOTTAM-1709The name specified for tblname is not a TAM file name.
DCTAMER_UNDEF-1710The TAM table has not been defined.
DCTAMER_TAMEND-1720The TAM service is being terminated.
DCTAMER_PROTO-1721The 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-1760The version of the TAM library linked to the UAP does not allow the UAP to operate with the current TAM table.
DCTAMER_TAMVR-1762The version of the TAM library linked to the UAP does not allow the UAP to operate with the current TAM service.
DCTAMER_OPENNUM-1766The number of open character special files exceeds the specified limit.
DCTAMER_ACCESSS-1767The access permission for special files has not been granted.
DCTAMER_MEMORY-1769The memory became insufficient.
DCTAMER_IO-1770An input/output error occurred.
DCTAMER_NO_ACL-1772The TAM table from which information is acquired is protected with the security facility. There is no ACL for the corresponding TAM table.
DCTAMER_ACCESS-1773The 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.