home *** CD-ROM | disk | FTP | other *** search
/ PC Plus SuperCD (UK) 1995 September / Image.iso / visualob / install / odbc / idms / readme.txt < prev   
Encoding:
Text File  |  1994-10-08  |  7.3 KB  |  184 lines
  1.                     CA-IDMS Server Client Interface
  2.  
  3.  
  4. Notes:
  5.  
  6. 1.  Do not set the Bulk Fetch Row Count to a number greater than 255.
  7.     This will cause the windows application to terminate abnormally.
  8.     This bug is corrected with the 9407 genlevel of the CA-IDMS SQL
  9.     Feature.   This setting should generally be left at 0, which lets the
  10.     driver choose the appropriate value for size of the fetch buffer.
  11.  
  12. 2.  The result set of the SQLTables call can be cached.  Repeated SQLTables
  13.     calls with the same parameters on a connection will use the cached
  14.     result set if this option is off.  Changing the parameters, turning
  15.     cacheing off, changing the catalog accessible tables view name, and
  16.     disconnecting will flush the cache.
  17.  
  18.     The default is no cacheing, use the Database Settings dialog of the
  19.     ODBC administration application to turn it on.
  20.  
  21. 3.  The default for SQLTables is to use the SYSCA.ACCESSIBLE tables view.
  22.  
  23. 4.  The ESCAPE character '\' is supported in identifiers of the
  24.     SQLTables and SQLColumns functions.
  25.  
  26. 5.  SQLStatistics will not update statistics even when ENSURE is specified.
  27.     This can be changed using the administration application.  See note
  28.     below for more information.
  29.  
  30. 6.  All catalog functions are executed on a separate internal SQL session
  31.     to reduce the chance of deadlocks and avoid problems with different
  32.     page groups for the catalog and user data areas.  This session consists
  33.     of just one "transaction" that is set to READ ONLY and TRANSIENT READ.
  34.     SQLTransact has no effect on it, nor does Autocommit.  The session is
  35.     started and released automatically.
  36.  
  37. 7.  The default Cursor Commit behavior is PRESERVE.  The IDMS driver
  38.     issues COMMIT CONTINUE for SQLTransact (and for Autocommit).  This
  39.     can be changed using the administration program.  CLOSE is simulated
  40.     by saving the syntax and reissuing the prepare on SQLExecute.
  41.  
  42.     When Cursor Commit behavior is PRESERVE, SQLGetInfo will report that
  43.     Cursor Rollback behavior is also PRESERVE, even though it is actually
  44.     CLOSE (there is no ROLLBACK CONTINUE SQL command).  This is done so
  45.     that Microsoft Access will allow attached tables to be updated.
  46.  
  47. 8.  Result set information functions can be called before SQLExecute
  48.     (see note below).
  49.  
  50. 9.  The extended syntax for date and time literals using escape sequences
  51.     is supported.  Note that escape sequences are not supported for
  52.     anything else.  Escape sequences are not currently supported for
  53.     date and time values passed as parameters.
  54.  
  55. 10. Tracing options can be specified using the administration program,
  56.     avoiding the need to manually edit the CADSI.INI file.  A separate
  57.     Log Options dialog box has been added to the administration program.
  58.  
  59. 11. All connections from a single Windows application to a single IDMS
  60.     server use the same LTERM on the server, allowing more concurrent
  61.     users than previously.
  62.  
  63. 12. To use Powerbuilder from Powersoft it may be necessary to add the
  64.     following to the CADSI.INI file in the Windows directory:
  65.  
  66.     [Options]                    ; global options
  67.     DisableEnsure=1
  68.  
  69.     ;- or -
  70.  
  71.     [<data source name>]         ; data source specific options
  72.     DisableEnsure=1
  73.  
  74.     This will prevent the ODBC SQLStatistics function from attempting
  75.     to issue an UPDATE STATISTICS FOR TABLE <table> when the SQL_ENSURE
  76.     option is specified.  Powerbuilder currently specifies this option
  77.     when determining what indexes exist for a table.
  78.  
  79.     This option is also useful to prevent SQLStatistics from attempting
  80.     to update statistics for large tables.  This can be a very expensive
  81.     operation, and could cause the CAICCI component to time out (which
  82.     will be reported as a "DTS" error, with more information in the
  83.     CADSI log file).
  84.  
  85.     The default setting for this is 1 (on).
  86.  
  87. 13. Parameters can be defined after a statement is prepared, that is,
  88.     SQLSetParam can be issued after SQLPrepare (but still must be
  89.     issued before SQLExecute or SQLExecuteDirect).  SQLDescribeCol,
  90.     SQLColAttributes, and SQLNumResultCols can be issued before
  91.     SQLExecute and will cause the statement to be compiled on the server.
  92.     Note that all parameters must be specified with SQLSetParam before
  93.     IDMS can compile the command.
  94.  
  95. 14. SQLSetConnectOption allows specification of time out interval.
  96.     SQLGetConnectOption returns a value for time out interval.
  97.     Time out intervals are currently specified using the CCI Configurator,
  98.     and cannot actually be set or queried by ODBC.  The IDMS ODBC driver
  99.     appears to support them for compatibility with Microsoft Access.
  100.  
  101. 15. See documentation for detailed information on IDMS ODBC conformance.
  102.  
  103. 16. The CADSI.LOG file may contain error messages from the DTS component
  104.     (IDMSTD0D.DLL) after a communication error.  These messages may include
  105.     those returned by CAICCI (LCCIWIN.DLL).  The setup utility can be used
  106.     to set a name and path for the log file.
  107.  
  108. 17.  Internal trace information can be controlled using SQLExecuteDirect.
  109.     Syntax is:
  110.  
  111.     TRACE ODBC|IDMS OFF|ON|ALL|0xhhhh
  112.  
  113.     ODBC control ODBC driver trace
  114.     IDMS control IDMS client interface trace
  115.  
  116.     OFF     turn trace off
  117.     ON      turn on minimum trace
  118.     ALL     turn on all trace options
  119.     0xhhhh  turn on specific trace options
  120.  
  121.     Trace bit definitions are included below.
  122.  
  123.  
  124. Trace flag settings:
  125.  
  126. Debugging information can be written to CADSI.LOG.  The following flag
  127. settings are provided for use by CA support staff:
  128.  
  129. IDMSODBC.DLL: set in [Options] or [<data source name>] section:
  130. OdbcTrace=0xXXXX where 0xXXXX can be set with the following values:
  131.  
  132.    0x0001  // Trace function entry.
  133.    0x0002  // Snap environment block.
  134.    0x0004  // Snap connection block.
  135.    0x0008  // Snap statement block.
  136.    0x0010  // Snap SQLDA.
  137.  
  138. IDMSQCLI.DLL: set in [Options] or [<data source name>] section:
  139. IdmsTrace=0xXXXX where 0xXXXX can be set with the following values:
  140.  
  141.    0x0001  // Trace IDMS calls
  142.    0x0002  // Time  IDMS calls
  143.    0x0004  // Snap  IDMS SQLSID
  144.    0x0008  // Snap  IDMS DSICB
  145.    0x0010  // Snap  IDMS SQLCA
  146.    0x0020  // Snap  IDMS SQLCIB
  147.    0x0040  // Snap  IDMS SQLPIB
  148.    0x0080  // Snap  IDMS parm buffer
  149.    0x0100  // Snap  IDMS tuple buffer
  150.    0x0200  // Snap  IDMS input SQLDA
  151.    0x0400  // Snap  IDMS output SQLDA
  152.    0x0800  // Snap  IDMS syntax string
  153.  
  154. IDMSTD0D.DLL: set in [Server <server name>] section:
  155. DtsTrace=0xXXXX where 0xXXXX can be set with the following values:
  156.  
  157.    0x0000  // no tracing
  158.    0x0001  // trace function calls
  159.    0x0002  // trace external calls
  160.    0x0004  // trace events
  161.    0x0008  // trace events
  162.    0x0010  // snap user data arrays
  163.    0x0020  // trace events
  164.    0x0040  // snap PCE
  165.    0x0080  // snap LCE
  166.  
  167. IDMSTD0D.DLL: set in [Server <server name>] section:
  168. DnsTrace=0xXXXX where 0xXXXX can be set with the following values:
  169.  
  170.    0x0000  // no tracing
  171.    0x0001  // trace function calls
  172.    0x0010  // snap unconverted send data
  173.    0x0020  // snap converted send data
  174.    0x0040  // snap received data
  175.    0x0080  // snap converted received
  176.  
  177. IDMSTD0D.DLL: set in [Server <server name>] section:
  178. CmTrace=0xXXXX where 0xXXXX can be set with the following values:
  179.  
  180.    0x0000  // no tracing
  181.    0x0001  // trace function calls
  182.    0x0002  // elapsed CCI call timings
  183.  
  184.