IBM Books

Administrative API Reference

SQLM-COLLECTED

This structure is used to return information after a call to the Database System Monitor APIs. It will only be filled in for snapshot requests made at the SQLM_DBMON_VERSION5_2 level and lower.

Table 55. Fields in the SQLM-COLLECTED Structure
Field Name Data Type Description
SIZE UNSIGNED LONG The size of the structure.
DB2 UNSIGNED LONG Obsolete.
DATABASES UNSIGNED LONG Obsolete.
TABLE_DATABASES UNSIGNED LONG Obsolete.
LOCK_DATABASES UNSIGNED LONG Obsolete.
APPLICATIONS UNSIGNED LONG Obsolete.
APPLINFOS UNSIGNED LONG Obsolete.
DCS_APPLINFOS UNSIGNED LONG Obsolete.
SERVER_DB2_TYPE UNSIGNED LONG The database manager server type (defined in sqlutil.h).
TIME_STAMP TIMESTAMP Time that the snapshot was taken.
GROUP_STATES OBJECT SQLM_ RECORDING_ GROUP Current state of the monitor switch.
SERVER_PRDID CHAR(20) Product name and version number of the database manager on the server.
SERVER_NNAME CHAR(20) Configuration node name of the server.
SERVER_ INSTANCE_NAME CHAR(20) Instance name of the database manager.
RESERVED CHAR(22) Reserved for future use.
NODE_NUMBER UNSIGNED SHORT Number of the node sending data.
TIME_ZONE_DISP LONG The difference (in seconds) between GMT and local time.
NUM_TOP_LEVEL_ STRUCTS UNSIGNED LONG The total number of high-level structures returned in the snapshot output buffer. A high-level structure can be composed of several lower-level data structures. This counter replaces the individual counters (such as table_databases) for each high-level structure, which are now obsolete.
TABLESPACE_ DATABASES UNSIGNED LONG Obsolete.
SERVER_VERSION UNSIGNED LONG The version of the server returning the data.

For information about programming the database monitor, see the System Monitor Guide and Reference.

Language Syntax

C Structure



/* File: sqlmon.h */
/* Structure: SQLM-COLLECTED */
/* ... */
typedef struct sqlm_collected
{
  unsigned long  size;
  unsigned long  db2;
  unsigned long  databases;
  unsigned long  table_databases;
  unsigned long  lock_databases;
  unsigned long  applications;
  unsigned long  applinfos;
  unsigned long  dcs_applinfos;
  unsigned long  server_db2_type;
  sqlm_timestamp time_stamp;
  sqlm_recording_group group_states[SQLM_NUM_GROUPS];
  _SQLOLDCHAR    server_prdid[SQLM_IDENT_SZ];
  _SQLOLDCHAR    server_nname[SQLM_IDENT_SZ];
  _SQLOLDCHAR    server_instance_name[SQLM_IDENT_SZ];
  _SQLOLDCHAR    reserved[22];
  unsigned short node_number;
  long           time_zone_disp;
  unsigned long  num_top_level_structs;
  unsigned long  tablespace_databases;
  unsigned long  server_version;
}sqlm_collected;
/* ... */
 

COBOL Structure



* File: sqlmonct.cbl
01 SQLM-COLLECTED.
    05 SQLM-SIZE               PIC 9(9) COMP-5.
    05 DB2                     PIC 9(9) COMP-5.
    05 DATABASES               PIC 9(9) COMP-5.
    05 TABLE-DATABASES         PIC 9(9) COMP-5.
    05 LOCK-DATABASES          PIC 9(9) COMP-5.
    05 APPLICATIONS            PIC 9(9) COMP-5.
    05 APPLINFOS               PIC 9(9) COMP-5.
    05 DCS-APPLINFOS           PIC 9(9) COMP-5.
    05 SERVER-DB2-TYPE         PIC 9(9) COMP-5.
    05 TIME-STAMP.
        10 SECONDS              PIC 9(9) COMP-5.
        10 MICROSEC             PIC 9(9) COMP-5.
    05 GROUP-STATES OCCURS 6.
        10 INPUT-STATE          PIC 9(9) COMP-5.
        10 OUTPUT-STATE         PIC 9(9) COMP-5.
        10 START-TIME.
    05 SERVER-PRDID            PIC X(20).
    05 SERVER-NNAME            PIC X(20).
    05 SERVER-INSTANCE-NAME    PIC X(20).
    05 RESERVED                PIC X(32).
    05 TABLESPACE-DATABASES    PIC 9(9) COMP-5.
    05 SERVER-VERSION          PIC 9(9) COMP-5.
*
 


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]

[ DB2 List of Books | Search the DB2 Books ]