home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 5 / 05.iso / a / a523 / 13.ddi / ORACA.H < prev    next >
Encoding:
C/C++ Source or Header  |  1987-12-01  |  5.6 KB  |  140 lines
  1. /* Copyright (c) 1985 by Oracle Corporation. */
  2.  
  3. /*
  4. NAME
  5.   ORACA : Oracle Communications Area.
  6. FUNCTION
  7.   Contains no code. Provides supplementary communications to/from
  8.   Oracle (in addition to standard SQLCA).
  9. NOTES
  10.   oracchf : Check cursor cache consistency flag. If set AND oradbgf
  11.             is set, then directs SQLLIB to perform cursor cache
  12.             consistency checks before every cursor operation
  13.             (OPEN, FETCH, SELECT, INSERT, etc.).
  14.   oradbgf : Master DEBUG flag. Used to turn all DEBUG options
  15.             on or off.
  16.   orahchf : Check Heap consistency flag. If set AND oradbgf is set,
  17.             then directs SQLLIB to perform heap consistency checks
  18.             everytime memory is dynamically allocated/free'd via
  19.             sqlalc/sqlfre/sqlrlc. MUST BE SET BEFORE 1ST CONNECT
  20.             and once set cannot be cleared (subsequent requests
  21.             to change it are ignored).
  22.   orastxtf: Save SQL stmt text flag. If set, then directs SQLLIB
  23.             to save the text of the current SQL stmt in orastxt
  24.             (in VARCHAR format).
  25.   orastxt : Saved len and text of current SQL stmt (in VARCHAR
  26.             format).
  27.   orasfnm : Saved len and text of filename containing current SQL
  28.             stmt (in VARCHAR format).
  29.   oraslnr : Saved line nr within orasfnm of current SQL stmt.
  30.  
  31.   Cursor cache statistics. Set after COMMIT or ROLLBACK. Each
  32.   CONNECT'd DATABASE has its own set of statistics.
  33.  
  34.   orahoc  : Highest Max Open OraCursors requested. Highest value
  35.             for MAXOPENCURSORS by any CONNECT to this DATABASE.
  36.   oramoc  : Max Open OraCursors required. Specifies the max nr
  37.             of OraCursors required to run this pgm. Can be higher
  38.             than orahoc if working set (MAXOPENCURSORS) was set
  39.             too low, thus forcing the PCC to expand the cache.
  40.   oracoc  : Current nr of OraCursors used.
  41.   oranor  : Nr of OraCursor cache reassignments. Can show the
  42.             degree of "thrashing" in the cache. Optimally, this
  43.             nr should be kept as low as possible (time vs space
  44.             optimization).
  45.   oranpr  : Nr of SQL stmt "parses".
  46.   oranex  : Nr of SQL stmt "executes". Optimally, the relation-
  47.             ship of oranex to oranpr should be kept as high as
  48.             possible.
  49.  
  50.  
  51.   If the symbol ORACA_STORAGE_CLASS is defined, then the ORACA
  52.   will be defined to have this storage class. For example:
  53.  
  54.     #define ORACA_STORAGE_CLASS extern
  55.  
  56.   will define the ORACA as an extern.
  57.  
  58.   If the symbol ORACA_INIT is defined, then the ORACA will be
  59.   statically initialized. Although this is not necessary in order
  60.   to use the ORACA, it is a good pgming practice not to have
  61.   unitialized variables. However, some C compilers/OS's don't
  62.   allow automatic variables to be init'd in this manner. Therefore,
  63.   if you are INCLUDE'ing the ORACA in a place where it would be
  64.   an automatic AND your C compiler/OS doesn't allow this style
  65.   of initialization, then ORACA_INIT should be left undefined --
  66.   all others can define ORACA_INIT if they wish.
  67.  
  68. OWNER
  69.   Clare
  70. DATE
  71.   10/19/85
  72. MODIFIED
  73.   Clare      02/20/86 - PCC [10101l] Feature: Heap consistency check.
  74.   Clare      03/04/86 - PCC [10101r] Port: ORACA init ifdef.
  75.   Clare      03/12/86 - PCC [10101ab] Feature: ORACA cuc statistics.
  76.   Noa        11/03/86 - add ORACA_STORAGE_CLASS
  77. */
  78.  
  79. #ifndef  ORACA
  80. #define  ORACA     1
  81.  
  82. struct   oraca
  83.          {
  84.          char      oracaid[8];         /* Reserved                            */
  85.          long      oracabc;            /* Reserved                            */
  86.  
  87. /*       Flags which are setable by User. */
  88.  
  89.          long      oracchf;            /* <> 0 if "check cur cache consistncy"*/
  90.          long      oradbgf;            /* <> 0 if "do DEBUG mode checking"    */
  91.          long      orahchf;            /* <> 0 if "do Heap consistency check" */
  92.          long      orastxtf;           /* SQL stmt text flag                  */
  93. #define  ORASTFNON 0                   /* = don't save text of SQL stmt       */
  94. #define  ORASTFERR 1                   /* = only save on SQLERROR             */
  95. #define  ORASTFWRN 2                   /* = only save on SQLWARNING/SQLERROR  */
  96. #define  ORASTFANY 3                   /* = always save                       */
  97.          struct
  98.            {
  99.            unsigned short orastxtl;
  100.            char           orastxtc[70];
  101.            } orastxt;                  /* text of last SQL stmt               */
  102.          struct
  103.            {
  104.            unsigned short orasfnml;
  105.            char           orasfnmc[70];
  106.            } orasfnm;                  /* name of file containing SQL stmt    */
  107.          long      oraslnr;            /* line nr-within-file of SQL stmt     */
  108.  
  109.          long      orahoc;             /* highest max open OraCurs requested  */
  110.          long      oramoc;             /* max open OraCursors required        */
  111.          long      oracoc;             /* current OraCursors open             */
  112.          long      oranor;             /* nr of OraCursor re-assignments      */
  113.          long      oranpr;             /* nr of parses                        */
  114.          long      oranex;             /* nr of executes                      */
  115.          };
  116.  
  117. #ifdef   ORACA_STORAGE_CLASS
  118. ORACA_STORAGE_CLASS struct oraca oraca
  119. #else
  120.          struct oraca oraca
  121. #endif
  122.  
  123. #ifdef ORACA_INIT
  124.          =
  125.          {
  126.          {'O','R','A','C','A',' ',' ',' '},
  127.          sizeof(struct oraca),
  128.          0,0,0,0,
  129.          {0,{0}},
  130.          {0,{0}},
  131.          0,
  132.          0,0,0,0,0,0
  133.          }
  134. #endif
  135.          ;
  136.  
  137. #endif
  138.  
  139. /* end oraca.h */
  140.