home *** CD-ROM | disk | FTP | other *** search
/ PC World 1997 November / PCWorld_1997-11_cd.bin / software / programy / komix / DATA.Z / readme.1st < prev    next >
Text File  |  1996-06-15  |  24KB  |  524 lines
  1.         Sybase SQL Anywhere Version 5.0.03:    Release Notes
  2.         =====================================================
  3.  
  4. This file contains release notes for Sybase SQL Anywhere 5.0.03. If you
  5. purchased this product on CD-ROM, you will find system requirements and
  6. installation guidance in the file INSTALL.TXT in the root directory of
  7. the CD-ROM. You will also find a complete list of installed files in the
  8. file FILELIST.TXT in the root directory of the CD-ROM.
  9.  
  10. If you have problems with this software, please contact Sybase SQL
  11. Anywhere technical support at the address given in the Contact Sheet and
  12. in the online Help.
  13.  
  14. Sybase's customer support services for this product are subject to
  15. then-current prices, terms, and conditions.
  16.  
  17. -----------------------------------------------------------------------
  18.  
  19. Contents
  20. --------
  21.  
  22.     1. Default DOS and Windows 3.x I/O method
  23.     2. Documentation corrections
  24.     3. The quoted_identifier option and SQL keywords
  25.     4. External procedure changes
  26.     5. Note for users of the Open Server Gateway for NetWare
  27.     6. Known bugs and limitations
  28.     7. Behavior change in Release 5.0
  29.     8. About Release 5.0.01
  30.     9. About Release 5.0.02
  31.     10. About Release 5.0.03
  32.  
  33. 1. DOS and Windows 3.x I/O 
  34. --------------------------
  35. The default I/O method for DOS and Windows 3.x standalone engines and
  36. network servers is now DOS I/O rather than direct I/O. The -d command
  37. line switch is supported, but ignored.
  38.  
  39. If you are a user of Watcom SQL 4.0 with a large database running on
  40. Windows 3.1 or on Windows 3.11 without 32-bit disk access, you may want
  41. to use a new command-line switch, -di, which means "use direct I/O if
  42. possible". More documentation can be found in the online Help, but not
  43. in the printed manual.
  44.  
  45. 2. Documentation corrections
  46. ----------------------------
  47. Some of the following corrections to the printed User's Guide have been
  48. made in the online Help. The online Help is generally more up to date
  49. than the printed documentation.
  50.  
  51. 2.1 GRANT REMOTE syntax
  52. -----------------------
  53. The syntax of the GRANT REMOTE and GRANT CONSOLIDATE SQL Remote
  54. statements does not include the optional SEND AT and SEND EVERY clause.
  55. See the online Help and the section "Granting and revoking REMOTE and
  56. CONSOLIDATE permissions" in the chapter "SQL Remote Administration" for
  57. a description of these clauses.
  58.  
  59. 2.2 Long binary and long varchar types in Embedded SQL
  60. ------------------------------------------------------
  61. In the section "Length field values" in the chapter "Embedded SQL", the
  62. table states that the database field type LONG BINARY is returned as an
  63. Embedded SQL type DT_LONGBINARY. In fact, it is returned as DT_BINARY.
  64. Similarly, LONG VARCHAR is returned as DT_VARCHAR.
  65.  
  66. 2.3 System procedures
  67. ----------------------
  68. You may wish to correct the following typographic errors in your copy of
  69. the User's Guide:
  70.  
  71.     p 1124: The failure code for xp_startmail is 3.
  72.     p 1125: The correct argument for xp_sendmail is
  73.             include_file, not include-file.
  74.     p 1127: The failure code for xp_stopmail is 2.
  75.  
  76. 2.4 Using xp_startmail with Microsoft Exchange
  77. ----------------------------------------------
  78. When using the xp_startmail system procedure with Microsoft Exchange,
  79. the mail_user parameter is an Exchange profile name, and no password
  80. should be included in the procedure call.
  81.  
  82. 2.5 Network Server -i command-line switch
  83. -----------------------------------------
  84. Pages 60 and 64 of the Network Guide describe the database server -i
  85. command-line switch as disconnecting clients after a specified idle
  86. time.
  87.  
  88. The -i command-line switch for the network server disconnects
  89. connections (not clients) that have not submitted a request for the
  90. specified number of minutes.
  91.  
  92. 3. The quoted_identifier option and SQL keywords
  93. ------------------------------------------------
  94. The quoted_identifier option is a database option introduced for
  95. Transact-SQL compatibility.
  96.  
  97. With the quoted_identifier option set to ON (the default), keywords can
  98. be used as identifiers if surrounded by double quotes. With the
  99. quoted_identifier option set to OFF, the engine treats strings in double
  100. quotes as strings.
  101.  
  102. If you use quoted_identifier set to OFF, you must avoid using keywords
  103. as identifiers or be prepared to flip the setting to ON temporarily.
  104.  
  105. If you set quoted_identifier to OFF, and issue a SET statement in ISQL,
  106. only a subset of the options is displayed. This is because the SET
  107. statement references a table with a column named "option". which is a
  108. keyword.
  109.  
  110. We recommend that you use quoted_identifier ON wherever possible. The
  111. quoted_identifier option should be used as a mechanism to allow existing
  112. queries that use double quotes to work.
  113.  
  114. 4.  External procedure changes
  115. ------------------------------
  116. Calling functions in external libraries from stored procedures is
  117. discussed in the chapter "Procedures, Triggers, and Batches". The
  118. following changes should be noted.
  119.  
  120. 4.1 Calling functions in NLMs
  121. ----------------------------
  122. When a function in a NLM is called, only loaded NLM's are searched for
  123. the function. The database engine does not search or load NLM's that are
  124. currently not loaded.
  125.  
  126. 4.2 Argument order in Windows 3.x DLLs
  127. --------------------------------------
  128. The calls to functions in Windows 3.x DLLs can employ the cdecl calling
  129. convention, as opposed to the default Pascal calling convention. To use
  130. the cdecl calling convention, in which parameters are passed in right to
  131. left rather than left to right, use the VARARGS keyword, as in the
  132. following syntax:
  133.  
  134. CREATE PROCEDURE dll_proc ( parameter-list )
  135.      EXTERNAL NAME 'Windows3X:function_name[varargs]@library.dll';
  136.  
  137. 5. Note for users of the Open Server Gateway for NetWare
  138. --------------------------------------------------------
  139. Before loading the Open Server Gateway for NetWare (DBOS50.MNLM)
  140. you must ensure that certain symbols are defined and required
  141. libraries are loaded. You should ensure that the following tasks
  142. are complete before loading DBOS50.NLM:
  143.  
  144. o   Add the Sybase NLMs directory to the search path. The following
  145.     command carries out this task:
  146.         search add sys:\sybase\nlms
  147. o   Add the Sybase install directory to the search path for Sybinit
  148.     purposes. The following command carries out this task:
  149.         search add sys:\sybase\install
  150. o   Load the NetWare Transport Level Interface Library provided by Novell.
  151.     The following command carries out this task:
  152.         load tli.nlm
  153. o   Load the Sybase LIBSRV NLM. The following command carries out this task:
  154.         load libsrv.nlm
  155.  
  156. You can now load the SQL Anywhere Open Server Gateway.        
  157.  
  158. 6. Known bugs and limitations
  159. -----------------------------------
  160.  
  161. 6.1 Log Translation utility (DBTRAN) output and character sets
  162. --------------------------------------------------------------
  163. Output from the log translation utility that includes binary data, such
  164. as encrypted passwords, cannot be run from Windows ISQL.
  165.  
  166. 6.2. SQL Central limitations
  167. ----------------------------
  168. You can carry out almost all database administration tasks with the SQL
  169. Central database administration tool. The following are known
  170. limitations of SQL Central:
  171.  
  172. 6.2.1 Administrative tasks
  173. --------------------------
  174. There is no support for setting and viewing database options (SET
  175. OPTION, GET OPTION).
  176.  
  177. The rebuild, dbcollat, and dbinfo command-line tools are not available
  178. in SQL Central.
  179.  
  180. You cannot pre-extend the transaction log file.
  181.  
  182. You cannot unload specific tables.
  183.  
  184. 6.2.2 Users and groups
  185. ----------------------
  186. You cannot make a user into a group, or vice versa.
  187.  
  188. 6.2.3 Miscellaneous limitations
  189. -------------------------------
  190. You cannot use single or double quotes in entry fields. For example,
  191. user names with apostrophes (Dave O'Brien) are not supported.
  192.  
  193. SQL Central should not be used on a Watcom SQL 4.0 database engine;
  194. instead use the SQL Anywhere 5.0 engine to connect to pre-5.0 databases.
  195.  
  196. When creating foreign keys CHECK ON COMMIT can be selected for
  197. non-RESTRICT actions (but is harmless).
  198.  
  199. 7.  Behavior change in Release 5.0
  200. ----------------------------------
  201.  
  202. The SQLSTATE for the error TABLE_NOT_FOUND has been changed from 52W01
  203. to 42W33, to conform to the ANSI92 standard.
  204.     
  205. 8. About Release 5.0.01
  206. -----------------------
  207.  
  208. 8.1 Numbering scheme
  209. --------------------
  210. Sybase SQL Anywhere uses numbers to indicate patch or maintenance-level
  211. releases. Release 5.0.01 is the first maintenance-level release
  212. for Sybase SQL Anywhere 5.0. The numbering scheme replaces the
  213. alphabetic scheme used for Watcom SQL patch-level releases.
  214.  
  215. 8.2 In release 5.0.01
  216. ---------------------
  217. Release 5.0.01 is being released to address some problems in the
  218. initial 5.0 release, particularly a backwards-compatibility
  219. problem.
  220.  
  221. The backwards-compatibility problem applies only to databases
  222. initialized with Watcom SQL 4.0 or earlier. During recovery following a
  223. system failure or other improper database shutdown, the 5.0 database
  224. engine does not process the transaction log for databases initialized
  225. with Watcom SQL 4.0 or earlier. Consequently, committed transactions
  226. made between the most recent checkpoint and shutdown are not recovered
  227. for these databases. Release 5.0.01 fixes this problem.
  228.  
  229. 9. About Release 5.0.02
  230. -----------------------
  231. This section lists new features in Release 5.0.02, with pointers to
  232. the online Help for more information.  To locate a topic in the
  233. online Help, goto the index or search facility and type the topic name.
  234.  
  235. Some of the new features involve changes to the system tables, and are
  236. accessible only if you upgrade your database, using the SQL Central
  237. Upgrade wizard or the DBUPGRAD command-line utility.
  238.  
  239.     CREATE SCHEMA statement
  240.         Creates a collection of tables, views, and associated
  241.         permissions for a user.  For information, see 
  242.         "CREATE SCHEMA statement". in the online Help.
  243.  
  244.     FLOAT( P ) data type
  245.         Stored as REAL or DOUBLE, depending on the value of P.
  246.         SQL Central does not allow you to create columns using
  247.         the FLOAT( P ) data type. For information, see "Numeric
  248.         data types" in the online Help.
  249.  
  250.     Foreign keys
  251.         More than one unnamed foreign key per table can now be created.
  252.         For information, see "CREATE TABLE statement" in the online
  253.         Help.
  254.  
  255.     GRANT statement
  256.         SELECT and REFERENCE permissions can now be granted on a
  257.         column by column basis, and permissions on views can be
  258.         granted by users other than the DBA.  For information,
  259.         see "GRANT statement" in the online Help.  To take advantage
  260.         of the new permission features, you must upgrade your
  261.         database using the SQL Central Upgrade Wizard or the DBUPGRAD
  262.         command-line utility.
  263.  
  264.     Column default extension
  265.         Constant expressions are now allowed as column defaults, as
  266.         long as they do not reference database objects. For information,
  267.         see "CREATE TABLE statement" and "Constant expression defaults"
  268.         in the online Help.
  269.  
  270.     SQL Anywhere Service Manager extensions
  271.         SQL Anywhere NT services can now be configured to not interact
  272.         with the NT desktop.  For information, see "Adding a new SQL
  273.         Anywhere service" in the online Help.
  274.  
  275.     NT Service examples
  276.         Sample Embedded SQL and ODBC applications in C are provided
  277.         that can be run as an NT service from the Service Manager.
  278.         For information, see "NT Service examples" for the Embedded
  279.         SQL example and "The sample program" for the ODBC example
  280.         in the online Help.
  281.         
  282.     New engine and server switches
  283.         The -m command-line switch truncates the transaction log
  284.         after each checkpoint, for situations where the transaction
  285.         log is not required for recovery and disk space is a concern.
  286.  
  287.         With the -u switch, the engine or server uses the operating
  288.         system disk cache.  This switch is available for the Windows 95
  289.         and Windows NT engine and server only.
  290.  
  291.         The HOST network communications option (-x switch) on the
  292.         Windows 95 and Windows NT server can be used on IPX networks to
  293.         locate servers on specific machines.
  294.         
  295.         For information on new engine and server switches, see
  296.         "The database engine" in the online Help, and "The database
  297.         server" in the online Server Manual.
  298.         
  299.     New database options
  300.         The NON_KEYWORDS option allows you to avoid incompatibilities
  301.         introduced by new keywords.  For information, see "SET OPTION
  302.         Statement" in the online Help.
  303.  
  304.         The ANSI_BLANKS option forces a truncation error if a CHAR(N)
  305.         value is read into a char(M) C host variable, and N is
  306.         greater than or equal to M.  For information, see "SET OPTION
  307.         Statement" in the online Help.
  308.  
  309.     Transact-SQL support
  310.         CREATE TABLE and CREATE INDEX now support the ON segment-name
  311.         clause.  CREATE INDEX permits the CLUSTERED and UNCLUSTERED
  312.         keywords, although no clustering is performed.
  313.         For information, see "Transact-SQL CREATE INDEX statement"
  314.         and "Transact-SQL CREATE TABLE statement" in the online Help.
  315.  
  316.         The GOTO control of flow statement is now supported.  For
  317.         information, see "Transact-SQL GOTO statement" in the online
  318.         Help.
  319.  
  320.         The system objects owned by the DBO user ID are now not
  321.         unloaded by either the Unload or Extraction utilities.
  322.         For information, see "The Unload utility" and "The
  323.         SQL Remote database extraction utility" in the online Help.
  324.  
  325.     Client/Server timeout management
  326.         For client/server connections to the network server,
  327.         a set of server and client switches have been introduced
  328.         to control the closing down of inactive connections.
  329.         For information, see "The database server" and "The SQL Anywhere
  330.         Client" in the online Server Help file.
  331.  
  332.     Multiple-event triggers
  333.         A single trigger can now be defined to handle a combination of
  334.         INSERT, UPDATE, and DELETE operations on a table. For
  335.         information, see "CREATE TRIGGER Statement" in the online Help.
  336.  
  337.     Escape character for loading and unloading data
  338.         The escape character for loading and unloading data can be
  339.         changed from its default value of the backslash.
  340.         For information, see "LOAD TABLE statement", "UNLOAD TABLE
  341.         Statement", "INPUT Statement", "OUTPUT Statement",
  342.         "Unload utility options", and "Extraction utility options"
  343.         in the online Help.
  344.  
  345.     Support for Borland C++
  346.         SQL Anywhere now supports Borland C++ 4.5 as a development compiler for
  347.         the Windows NT platform.  For information, see "Supported
  348.         Compilers" in the online Help.
  349.  
  350.     SQLSTATE/SQLCODE can be declared
  351.         For ISO/ANSI compliance, you can declare SQLSTATE and SQLCODE as
  352.         host variables within a declare section of a C program.  For
  353.         information, see "Host variable usage" in the online Help.
  354.  
  355.     CREATE/DROP DOMAIN as alternative to CREATE/DROP DATATYPE
  356.         The keyword DOMAIN is a synonym for DATATYPE in the CREATE/DROP
  357.         DATATYPE statements.  The use of DOMAIN reflects the ANSI/ISO
  358.         SQL3 draft standard.  For information, see "CREATE DATATYPE
  359.         statement" in the online Help.
  360.  
  361.     ISQL START DATABASE statement
  362.         The ISQL START DATABASE statement now has an optional AUTOSTOP
  363.         clause.  For information, see "START DATABASE statement" in the
  364.         online Help.
  365.  
  366.     Beta release of new SQL Remote message types
  367.         DLL's are provided for SMTP and VIM message type support in SQL
  368.         Remote.  These are provided as beta pre-release versions.
  369.         SMTP support is provided for the Windows 95, 3.x, and NT,
  370.         while VIM support is provided for Windows 3.x only.
  371.  
  372.     SQL Central enhancements
  373.         SQL Central shows all running databases on a server, not
  374.             just connected databases.
  375.         You can start and stop databases on a server.
  376.         You can create global temporary tables.
  377.         The enhancements to object permissions, including grant options,
  378.             are accessible from SQL Central.
  379.         You can create user accounts with no password.
  380.         SQL Remote users now have a statistics page.
  381.         A Create Table wizard has been added.
  382.  
  383. 10. About Release 5.0.03
  384. -----------------------
  385.  
  386. 10.1 Behavior change
  387. -------------------
  388. When an INSERT or UPDATE truncates a CHAR or VARCHAR string, previous
  389. versions of SQL Anywhere and Watcom SQL truncated the string silently,
  390. and did not generate an error.  A new default behavior corresponds to
  391. ANSI/ISO SQL/92 behavior, and raises an error when entries are truncated.
  392. To obtain the same behavior as previous versions, set the database
  393. option STRING_RTRUNCATION to OFF.
  394.  
  395. 10.2 New features
  396. ----------------
  397. This section lists new features in Release 5.0.03, with pointers to
  398. the online Help for more information.  To locate a topic in the
  399. online Help, goto the index or search facility and type the topic name.
  400.  
  401.     SQL Remote enhancements
  402.         Subqueries in publications can be used in a broader range of
  403.             situations. If a row in a table is updated so as to "move"
  404.             from one subscription to another, you can now ensure that
  405.             all rows in foreign key tables are also moved, by using a
  406.             new syntax for the UPDATE statement.  For information,
  407.             see "UPDATE Statement" and "Using subqueries in publications".
  408.         Subqueries in SUBSCRIBE BY clauses can now return more than
  409.             a single value, so that rows can appear in more than one
  410.             subscription. For information, see "SUBSCRIBE BY subqueries 
  411.             returning multiple values" in the online Help.
  412.         The Message Agent (DBREMOTE) has a new command-line switch
  413.             (-l) to control the maximum length of messages. For
  414.             information, see "The SQL Remote Message Agent" in
  415.             the online Help.
  416.         VIM and SMTP message support is now available for each of
  417.             OS/2, Windows 3.x, Windows 95, and Windows NT.
  418.         Registry entries and initialization file entries are
  419.             available for control over some aspects of SQL Remote
  420.             message links.
  421.  
  422.     DBSTOP can stop the server
  423.         The DBSTOP utility can be used to stop the server.  The
  424.         permission required to stop a standalone engine or network
  425.         server can be set using the new -gk engine or server
  426.         command-line switch.  For information, see "The database
  427.         engine" in the online Help, and "The database server" and
  428.         "Stopping the database server executable" in the online
  429.         Network Guide.
  430.        
  431.     New engine and server switches
  432.         The new -ta command-line switch for the database engine,
  433.         server, and client control the disconnection of connections
  434.         from terminated applications.  This termination prevents
  435.         applications that crash from holding on to a connection
  436.         for longer than a specified time. For information,
  437.         see "The database engine" in the online Help, and
  438.         "The database server" and "The SQL Anywhere Client" in the
  439.         server online Help
  440.  
  441.     DESCRIBE statement
  442.         A new clause has been added to the DESCRIBE statement
  443.         to retrieve column names with more than thirty
  444.         characters. For information, see "DESCRIBE statement"
  445.         in the online Help.           
  446.  
  447.     Procedures with different-shaped result sets
  448.         A new clause on the DESCRIBE statement allows different-shaped
  449.         result sets to be used within a procedure. For information,
  450.         see "DESCRIBE statement" in the online Help.
  451.             To take advantage of this facility, ODBC developers should
  452.         delay calling SQLDescribeCol until after they have executed
  453.         the statement, instead of calling it after the statement is
  454.         only prepared.
  455.         
  456.  
  457.     SQL Central enhancements
  458.         SQL Central has context-sensitive help.
  459.         SQL Central allows altering of views and triggers. For details,
  460.             see "ALTER TRIGGER statement" and "ALTER TRIGGER statement"
  461.             in the online User's Guide.
  462.         Wizards are now provided to help you write views and stored
  463.             procedures.
  464.         The code editor now has Find, Replace, and Go To facilities,
  465.             and also options to control the display font.
  466.         Support for users without DBA authority has been improved.
  467.         
  468.     ANSI/ISO option
  469.         The STRING_RTRUNCATION option allows control over generation
  470.         of an error when an INSERT or UPDATE truncates a character
  471.         string. For information, see "SET OPTION statement" in the online
  472.         Help.
  473.  
  474.     ALTER VIEW and ALTER TRIGGER statements
  475.         These new statements allow an existing view or trigger definition
  476.         to be replaced by a new definition. For details, see "ALTER
  477.         TRIGGER statement" and "ALTER VIEW statement" in the online Help.
  478.  
  479.     Transact-SQL accepted by parser
  480.         To enhance SQL Server compatibility, performance parameters
  481.         that can be used in SELECT, UPDATE, and DELETE statements
  482.         in System 11 are now accepted and discarded by SQL Anywhere.
  483.         Also, the PREFETCH System 11 option is allowed, but has no
  484.         effect.
  485.  
  486.     ISO/ANSI SQL/92 flagging
  487.         The embedded SQL preprocessor supports command-line switches
  488.             that flag SQL statements not conforming to entry, intermediate,
  489.             or full SQL/92 with an error or warning. For information,
  490.             see "The SQL Preprocessor" in the online Help.
  491.         Two database options are available that flag non-conforming
  492.             SQL syntax in the same way within the database engine.
  493.             For information, see "database options" in the online Help.
  494.  
  495.     Open Server Gateway enhancements
  496.         Several enhancements have been made to improve SQL Server
  497.         compatibility:
  498.             The Open Server Gateway has more complete datatype support.
  499.                 It supports numeric and decimal datatypes, and datatype
  500.                 conversions based on the capabilities of the application.
  501.             Improved text and image support have been added to support
  502.                 replication and to support DBLIB and CTLIB applications
  503.                 that use text and image API calls.
  504.             Improved cursor API support has been added.
  505.             
  506.     New Embedded SQL function
  507.         The db_interface_option function has been added. It has the form:
  508.         
  509.             void db_interface_option( struct sqlca *sqlca,
  510.                                       int option, long value )
  511.  
  512.         The db_interface_option() is an Embedded SQL function used to set
  513.         database interface options. Currently there is only a single
  514.         option, DBO_ANSI_TRUNCATION.
  515.             The DBO_ANSI_TRUNCATION option specifies how to set indicator
  516.         variables in the case of string truncation. If DBO_ANSI_TRUNCATION
  517.         is set to 0, indicator variable values include the null char when
  518.         indicating the size of the truncated string.  Set DBO_ANSI_TRUNCATION
  519.         to 1 to get ANSI/ISO behaviour, which is to not include the null
  520.         char when indicating the size of the truncated string. The default
  521.         value for DBO_ANSI_TRUNCATION is 0, for backwards compatibility.
  522.  
  523.  
  524.