home *** CD-ROM | disk | FTP | other *** search
/ PC World 1998 October / PCWorld_1998-10_cd.bin / software / prehled / komix / DATA.Z / readme.1st < prev    next >
Text File  |  1997-05-27  |  43KB  |  941 lines
  1.         Sybase SQL Anywhere Version 5.5.02:    Release Notes
  2.         ====================================================
  3.  
  4. This file contains release notes for Sybase SQL Anywhere 5.5.02. 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 Customer Services
  12. Reference Guide.
  13.  
  14. For existing customers running Sybase SQL Anywhere Release 5.0, 
  15. release 5.5 and its patches are regular patches to the 5.0 software.
  16. Release 5.5 is the patch subsequent to the 5.0.03 patch. Release 5.5
  17. and its patches are developed on the same code line as 5.0. There will
  18. be no further patches beyond 5.0.03 with the version prefix of 5.0.
  19. By installing the maintenance release, your software is automatically
  20. upgraded to the 5.5 Standard Edition.
  21.  
  22. These release notes contain cumulative information from Release 5.0.
  23.  
  24. Sybase's customer support services for this product are subject to
  25. then-current prices, terms, and conditions.
  26.  
  27. Installing SQL Anywhere Professional on Windows NT
  28. --------------------------------------------------
  29.  
  30. Before installing NetImpact Dynamo, you should ensure that no
  31. third party services are running, such as Netscape Enterprise
  32. Server or the Microsoft World Wide Web Publishing Service. You can
  33. stop these services from the Services icon in the Control Panel.
  34.  
  35. To install SQL Anywhere Professional on Windows NT you must be
  36. logged on as a user with administrative privileges.
  37.  
  38. After installing NetImpact Dynamo, a dialog box will open asking you if 
  39. you wish to modify your environment variables. These changes need to be 
  40. made to the local machine variables, not the current user variables.
  41. By default, the changes are made to the local machine variables.
  42.  
  43. ===============================================================================
  44.  
  45. Contents
  46. --------
  47.  
  48.     1.  Default DOS and Windows 3.x I/O method
  49.     2.  Documentation corrections
  50.     3.  The quoted_identifier option and SQL keywords
  51.     4.  External procedure changes
  52.     5.  Note for users of the Open Server Gateway for NetWare
  53.     6.  Known bugs and limitations
  54.     7.  Behavior change in Release 5.0
  55.     8.  About Release 5.0.01
  56.     9.  About Release 5.0.02
  57.     10. About Release 5.0.03
  58.     11. About Release 5.5
  59.     12. About Release 5.5.01
  60.     13. About Release 5.5.02
  61.     14. Notes on replicated Web sites
  62.  
  63. 1. DOS and Windows 3.x I/O 
  64. --------------------------
  65. The default I/O method for DOS and Windows 3.x standalone engines and
  66. network servers is now DOS I/O rather than direct I/O. The -d command
  67. line switch is supported, but ignored.
  68.  
  69. If you are a user of Watcom SQL 4.0 with a large database running on
  70. Windows 3.1 or on Windows 3.11 without 32-bit disk access, you may want
  71. to use a new command-line switch, -di, which means "use direct I/O if
  72. possible". More documentation can be found in the online Help, but not
  73. in the printed manual.
  74.  
  75. 2. Documentation corrections
  76. ----------------------------
  77. Some of the following corrections to the printed User's Guide have been
  78. made in the online Help. The online Help is generally more up to date
  79. than the printed documentation.
  80.  
  81. 2.1 GRANT REMOTE syntax
  82. -----------------------
  83. The syntax of the GRANT REMOTE and GRANT CONSOLIDATE SQL Remote
  84. statements does not include the optional SEND AT and SEND EVERY clause.
  85. See the online Help and the section "Granting and revoking REMOTE and
  86. CONSOLIDATE permissions" in the chapter "SQL Remote Administration" for
  87. a description of these clauses.
  88.  
  89. 2.2 Long binary and long varchar types in Embedded SQL
  90. ------------------------------------------------------
  91. In the section "Length field values" in the chapter "Embedded SQL", the
  92. table states that the database field type LONG BINARY is returned as an
  93. Embedded SQL type DT_LONGBINARY. In fact, it is returned as DT_BINARY.
  94. Similarly, LONG VARCHAR is returned as DT_VARCHAR.
  95.  
  96. 2.3 System procedures
  97. ----------------------
  98. You may wish to correct the following typographic errors in your copy of
  99. the User's Guide:
  100.  
  101.     p 1124: The failure code for xp_startmail is 3.
  102.     p 1125: The correct argument for xp_sendmail is
  103.             include_file, not include-file.
  104.     p 1127: The failure code for xp_stopmail is 2.
  105.  
  106. 2.4 Using xp_startmail with Microsoft Exchange
  107. ----------------------------------------------
  108. When using the xp_startmail system procedure with Microsoft Exchange,
  109. the mail_user parameter is an Exchange profile name, and no password
  110. should be included in the procedure call.
  111.  
  112. 2.5 Network Server -i command-line switch
  113. -----------------------------------------
  114. Pages 60 and 64 of the Network Guide describe the database server -i
  115. command-line switch as disconnecting clients after a specified idle
  116. time.
  117.  
  118. The -i command-line switch for the network server disconnects
  119. connections (not clients) that have not submitted a request for the
  120. specified number of minutes.
  121.  
  122. 3. The quoted_identifier option and SQL keywords
  123. ------------------------------------------------
  124. The quoted_identifier option is a database option introduced for
  125. Transact-SQL compatibility.
  126.  
  127. With the quoted_identifier option set to ON (the default), keywords can
  128. be used as identifiers if surrounded by double quotes. With the
  129. quoted_identifier option set to OFF, the engine treats strings in double
  130. quotes as strings.
  131.  
  132. If you use quoted_identifier set to OFF, you must avoid using keywords
  133. as identifiers or be prepared to flip the setting to ON temporarily.
  134.  
  135. If you set quoted_identifier to OFF, and issue a SET statement in ISQL,
  136. only a subset of the options is displayed. This is because the SET
  137. statement references a table with a column named "option". which is a
  138. keyword.
  139.  
  140. We recommend that you use quoted_identifier ON wherever possible. The
  141. quoted_identifier option should be used as a mechanism to allow existing
  142. queries that use double quotes to work.
  143.  
  144. 4.  External procedure changes
  145. ------------------------------
  146. Calling functions in external libraries from stored procedures is
  147. discussed in the chapter "Procedures, Triggers, and Batches". The
  148. following changes should be noted.
  149.  
  150. 4.1 Calling functions in NLMs
  151. ----------------------------
  152. When a function in a NLM is called, only loaded NLM's are searched for
  153. the function. The database engine does not search or load NLM's that are
  154. currently not loaded.
  155.  
  156. 4.2 Argument order in Windows 3.x DLLs
  157. --------------------------------------
  158. The calls to functions in Windows 3.x DLLs can employ the cdecl calling
  159. convention, as opposed to the default Pascal calling convention. To use
  160. the cdecl calling convention, in which parameters are passed in right to
  161. left rather than left to right, use the VARARGS keyword, as in the
  162. following syntax:
  163.  
  164. CREATE PROCEDURE dll_proc ( parameter-list )
  165.      EXTERNAL NAME 'Windows3X:function_name[varargs]@library.dll';
  166.  
  167. 5. Note for users of the Open Server Gateway for NetWare
  168. --------------------------------------------------------
  169. Before loading the Open Server Gateway for NetWare (DBOS50.MNLM)
  170. you must ensure that certain symbols are defined and required
  171. libraries are loaded. You should ensure that the following tasks
  172. are complete before loading DBOS50.NLM:
  173.  
  174. o   Add the Sybase NLMs directory to the search path. The following
  175.     command carries out this task:
  176.         search add sys:\sybase\nlms
  177. o   Add the Sybase install directory to the search path for Sybinit
  178.     purposes. The following command carries out this task:
  179.         search add sys:\sybase\install
  180. o   Load the NetWare Transport Level Interface Library provided by Novell.
  181.     The following command carries out this task:
  182.         load tli.nlm
  183. o   Load the Sybase LIBSRV NLM. The following command carries out this task:
  184.         load libsrv.nlm
  185.  
  186. You can now load the SQL Anywhere Open Server Gateway.        
  187.  
  188. 6. Known bugs and limitations
  189. -----------------------------------
  190.  
  191. 6.1 Log Translation utility (DBTRAN) output and character sets
  192. --------------------------------------------------------------
  193. Output from the log translation utility that includes binary data, such
  194. as encrypted passwords, cannot be run from Windows ISQL.
  195.  
  196. 6.2. SQL Central limitations
  197. ----------------------------
  198. You can carry out almost all database administration tasks with the SQL
  199. Central database administration tool. The following are known
  200. limitations of SQL Central:
  201.  
  202. 6.2.1 Administrative tasks
  203. --------------------------
  204. The rebuild, dbcollat, and dbinfo command-line tools are not available
  205. in SQL Central.
  206.  
  207. You cannot pre-extend the transaction log file.
  208.  
  209. 6.2.2 Users and groups
  210. ----------------------
  211. You cannot make a user into a group, or vice versa.
  212.  
  213. 6.2.3 Miscellaneous limitations
  214. -------------------------------
  215. You cannot use single or double quotes in entry fields. For example,
  216. user names with apostrophes (Dave O'Brien) are not supported.
  217.  
  218. SQL Central should not be used on a Watcom SQL 4.0 database engine;
  219. instead use the SQL Anywhere 5.0 engine to connect to pre-5.0 databases.
  220.  
  221. When creating foreign keys CHECK ON COMMIT can be selected for
  222. non-RESTRICT actions (but is harmless).
  223.  
  224. 6.3 Dynamo limitations
  225. ----------------------
  226. When copying a database to a new computer, the ODBC data source name must
  227. be exactly the same as specified on the original computer. To ensure that 
  228. it is the same, open the Connections folder, select the "default" connection,
  229. open the Properties window, and select the new ODBC data source name from
  230. the drop down list.
  231.  
  232. 7.  Behavior change in Release 5.0
  233. ----------------------------------
  234.  
  235. The SQLSTATE for the error TABLE_NOT_FOUND has been changed from 52W01
  236. to 42W33, to conform to the ANSI92 standard.
  237.     
  238. 8. About Release 5.0.01
  239. -----------------------
  240.  
  241. 8.1 Numbering scheme
  242. --------------------
  243. Sybase SQL Anywhere uses numbers to indicate patch or maintenance-level
  244. releases. Release 5.0.01 is the first maintenance-level release
  245. for Sybase SQL Anywhere 5.0. The numbering scheme replaces the
  246. alphabetic scheme used for Watcom SQL patch-level releases.
  247.  
  248. 8.2 In release 5.0.01
  249. ---------------------
  250. Release 5.0.01 is being released to address some problems in the
  251. initial 5.0 release, particularly a backwards-compatibility
  252. problem.
  253.  
  254. The backwards-compatibility problem applies only to databases
  255. initialized with Watcom SQL 4.0 or earlier. During recovery following a
  256. system failure or other improper database shutdown, the 5.0 database
  257. engine does not process the transaction log for databases initialized
  258. with Watcom SQL 4.0 or earlier. Consequently, committed transactions
  259. made between the most recent checkpoint and shutdown are not recovered
  260. for these databases. Release 5.0.01 fixes this problem.
  261.  
  262. 9. About Release 5.0.02
  263. -----------------------
  264. This section lists new features in Release 5.0.02, with pointers to
  265. the online Help for more information.  To locate a topic in the
  266. online Help, goto the index or search facility and type the topic name.
  267.  
  268. Some of the new features involve changes to the system tables, and are
  269. accessible only if you upgrade your database, using the SQL Central
  270. Upgrade wizard or the DBUPGRAD command-line utility.
  271.  
  272.     CREATE SCHEMA statement
  273.         Creates a collection of tables, views, and associated
  274.         permissions for a user.  For information, see 
  275.         "CREATE SCHEMA statement". in the online Help index.
  276.  
  277.     FLOAT( P ) data type
  278.         Stored as REAL or DOUBLE, depending on the value of P.
  279.         SQL Central does not allow you to create columns using
  280.         the FLOAT( P ) data type. For information, see "Numeric
  281.         data types" in the online Help index.
  282.  
  283.     Foreign keys
  284.         More than one unnamed foreign key per table can now be created.
  285.         For information, see "CREATE TABLE statement" in the online
  286.         Help.
  287.  
  288.     GRANT statement
  289.         SELECT and REFERENCE permissions can now be granted on a
  290.         column by column basis, and permissions on views can be
  291.         granted by users other than the DBA.  For information,
  292.         see "GRANT statement" in the online Help index.  To take advantage
  293.         of the new permission features, you must upgrade your
  294.         database using the SQL Central Upgrade Wizard or the DBUPGRAD
  295.         command-line utility.
  296.  
  297.     Column default extension
  298.         Constant expressions are now allowed as column defaults, as
  299.         long as they do not reference database objects. For information,
  300.         see "CREATE TABLE statement" and "Constant expression defaults"
  301.         in the online Help index.
  302.  
  303.     SQL Anywhere Service Manager extensions
  304.         SQL Anywhere NT services can now be configured to not interact
  305.         with the NT desktop.  For information, see "Adding a new SQL
  306.         Anywhere service" in the online Help index.
  307.  
  308.     NT Service examples
  309.         Sample Embedded SQL and ODBC applications in C are provided
  310.         that can be run as an NT service from the Service Manager.
  311.         For information, see "NT Service examples" for the Embedded
  312.         SQL example and "The sample program" for the ODBC example
  313.         in the online Help index.
  314.         
  315.     New engine and server switches
  316.         The -m command-line switch truncates the transaction log
  317.         after each checkpoint, for situations where the transaction
  318.         log is not required for recovery and disk space is a concern.
  319.  
  320.         With the -u switch, the engine or server uses the operating
  321.         system disk cache.  This switch is available for the Windows 95
  322.         and Windows NT engine and server only.
  323.  
  324.         The HOST network communications option (-x switch) on the
  325.         Windows 95 and Windows NT server can be used on IPX networks to
  326.         locate servers on specific machines.
  327.         
  328.         For information on new engine and server switches, see
  329.         "The database engine" in the online Help index, and "The database
  330.         server" in the online Server Manual.
  331.         
  332.     New database options
  333.         The NON_KEYWORDS option allows you to avoid incompatibilities
  334.         introduced by new keywords.  For information, see "SET OPTION
  335.         Statement" in the online Help index.
  336.  
  337.         The ANSI_BLANKS option forces a truncation error if a CHAR(N)
  338.         value is read into a char(M) C host variable, and N is
  339.         greater than or equal to M.  For information, see "SET OPTION
  340.         Statement" in the online Help index.
  341.  
  342.     Transact-SQL support
  343.         CREATE TABLE and CREATE INDEX now support the ON segment-name
  344.         clause.  CREATE INDEX permits the CLUSTERED and UNCLUSTERED
  345.         keywords, although no clustering is performed.
  346.         For information, see "Transact-SQL CREATE INDEX statement"
  347.         and "Transact-SQL CREATE TABLE statement" in the online Help index.
  348.  
  349.         The GOTO control of flow statement is now supported.  For
  350.         information, see "Transact-SQL GOTO statement" in the online
  351.         Help.
  352.  
  353.         The system objects owned by the DBO user ID are now not
  354.         unloaded by either the Unload or Extraction utilities.
  355.         For information, see "The Unload utility" and "The
  356.         SQL Remote database extraction utility" in the online Help index.
  357.  
  358.     Client/Server timeout management
  359.         For client/server connections to the network server,
  360.         a set of server and client switches have been introduced
  361.         to control the closing down of inactive connections.
  362.         For information, see "The database server" and "The SQL Anywhere
  363.         Client" in the online Server Help file.
  364.  
  365.     Multiple-event triggers
  366.         A single trigger can now be defined to handle a combination of
  367.         INSERT, UPDATE, and DELETE operations on a table. For
  368.         information, see "CREATE TRIGGER Statement" in the online Help index.
  369.  
  370.     Escape character for loading and unloading data
  371.         The escape character for loading and unloading data can be
  372.         changed from its default value of the backslash.
  373.         For information, see "LOAD TABLE statement", "UNLOAD TABLE
  374.         Statement", "INPUT Statement", "OUTPUT Statement",
  375.         "Unload utility options", and "Extraction utility options"
  376.         in the online Help index.
  377.  
  378.     Support for Borland C++
  379.         SQL Anywhere now supports Borland C++ 4.5 as a development compiler for
  380.         the Windows NT platform.  For information, see "Supported
  381.         Compilers" in the online Help index.
  382.  
  383.     SQLSTATE/SQLCODE can be declared
  384.         For ISO/ANSI compliance, you can declare SQLSTATE and SQLCODE as
  385.         host variables within a declare section of a C program.  For
  386.         information, see "Host variable usage" in the online Help index.
  387.  
  388.     CREATE/DROP DOMAIN as alternative to CREATE/DROP DATATYPE
  389.         The keyword DOMAIN is a synonym for DATATYPE in the CREATE/DROP
  390.         DATATYPE statements.  The use of DOMAIN reflects the ANSI/ISO
  391.         SQL3 draft standard.  For information, see "CREATE DATATYPE
  392.         statement" in the online Help index.
  393.  
  394.     ISQL START DATABASE statement
  395.         The ISQL START DATABASE statement now has an optional AUTOSTOP
  396.         clause.  For information, see "START DATABASE statement" in the
  397.         online Help index.
  398.  
  399.     Beta release of new SQL Remote message types
  400.         DLL's are provided for SMTP and VIM message type support in SQL
  401.         Remote.  These are provided as beta pre-release versions.
  402.         SMTP support is provided for the Windows 95, 3.x, and NT,
  403.         while VIM support is provided for Windows 3.x only.
  404.  
  405.     SQL Central enhancements
  406.         SQL Central shows all running databases on a server, not
  407.             just connected databases.
  408.         You can start and stop databases on a server.
  409.         You can create global temporary tables.
  410.         The enhancements to object permissions, including grant options,
  411.             are accessible from SQL Central.
  412.         You can create user accounts with no password.
  413.         SQL Remote users now have a statistics page.
  414.         A Create Table wizard has been added.
  415.  
  416. 10. About Release 5.0.03
  417. -----------------------
  418.  
  419. 10.1 Behavior change
  420. -------------------
  421. When an INSERT or UPDATE truncates a CHAR or VARCHAR string, previous
  422. versions of SQL Anywhere and Watcom SQL truncated the string silently,
  423. and did not generate an error.  A new default behavior corresponds to
  424. ANSI/ISO SQL/92 behavior, and raises an error when entries are truncated.
  425.  
  426.  
  427. 10.2 New features
  428. ----------------
  429. This section lists new features in Release 5.0.03, with pointers to
  430. the online Help index for more information.  To locate a topic in the
  431. online Help index, goto the index or search facility and type the topic name.
  432.  
  433.     SQL Remote enhancements
  434.         Subqueries in publications can be used in a broader range of
  435.             situations. If a row in a table is updated so as to "move"
  436.             from one subscription to another, you can now ensure that
  437.             all rows in foreign key tables are also moved, by using a
  438.             new syntax for the UPDATE statement.  For information,
  439.             see "UPDATE Statement" and "Using subqueries in publications".
  440.         Subqueries in SUBSCRIBE BY clauses can now return more than
  441.             a single value, so that rows can appear in more than one
  442.             subscription. For information, see "SUBSCRIBE BY subqueries 
  443.             returning multiple values" in the online Help index.
  444.         The Message Agent (DBREMOTE) has a new command-line switch
  445.             (-l) to control the maximum length of messages. For
  446.             information, see "The SQL Remote Message Agent" in
  447.             the online Help index.
  448.         VIM and SMTP message support is now available for each of
  449.             OS/2, Windows 3.x, Windows 95, and Windows NT.
  450.         Registry entries and initialization file entries are
  451.             available for control over some aspects of SQL Remote
  452.             message links.
  453.  
  454.     DBSTOP can stop the server
  455.         The DBSTOP utility can be used to stop the server.  The
  456.         permission required to stop a standalone engine or network
  457.         server can be set using the new -gk engine or server
  458.         command-line switch.  For information, see "The database
  459.         engine" in the online Help index, and "The database server" and
  460.         "Stopping the database server executable" in the online
  461.         Network Guide.
  462.        
  463.     New engine and server switches
  464.         The new -ta command-line switch for the database engine,
  465.         server, and client control the disconnection of connections
  466.         from terminated applications.  This termination prevents
  467.         applications that crash from holding on to a connection
  468.         for longer than a specified time. For information,
  469.         see "The database engine" in the online Help index, and
  470.         "The database server" and "The SQL Anywhere Client" in the
  471.         server online Help index
  472.  
  473.     DESCRIBE statement
  474.         A new clause has been added to the DESCRIBE statement
  475.         to retrieve column names with more than thirty
  476.         characters. For information, see "DESCRIBE statement"
  477.         in the online Help index.           
  478.  
  479.     Procedures with different-shaped result sets
  480.         A new clause on the DESCRIBE statement allows different-shaped
  481.         result sets to be used within a procedure. For information,
  482.         see "DESCRIBE statement" in the online Help index.
  483.             To take advantage of this facility, ODBC developers should
  484.         delay calling SQLDescribeCol until after they have executed
  485.         the statement, instead of calling it after the statement is
  486.         only prepared.
  487.         
  488.  
  489.     SQL Central enhancements
  490.         SQL Central has context-sensitive help.
  491.         SQL Central allows altering of views and triggers. For details,
  492.             see "ALTER TRIGGER statement" and "ALTER TRIGGER statement"
  493.             in the online User's Guide.
  494.         Wizards are now provided to help you write views and stored
  495.             procedures.
  496.         The code editor now has Find, Replace, and Go To facilities,
  497.             and also options to control the display font.
  498.         Support for users without DBA authority has been improved.
  499.         
  500.     ANSI/ISO option
  501.         The STRING_RTRUNCATION option allows control over generation
  502.         of an error when an INSERT or UPDATE truncates a character
  503.         string. For information, see "SET OPTION statement" in the online
  504.         Help.
  505.  
  506.     ALTER VIEW and ALTER TRIGGER statements
  507.         These new statements allow an existing view or trigger definition
  508.         to be replaced by a new definition. For details, see "ALTER
  509.         TRIGGER statement" and "ALTER VIEW statement" in the online Help index.
  510.  
  511.     Transact-SQL accepted by parser
  512.         To enhance SQL Server compatibility, performance parameters
  513.         that can be used in SELECT, UPDATE, and DELETE statements
  514.         in System 11 are now accepted and discarded by SQL Anywhere.
  515.         Also, the PREFETCH System 11 option is allowed, but has no
  516.         effect.
  517.  
  518.     ISO/ANSI SQL/92 flagging
  519.         The embedded SQL preprocessor supports command-line switches
  520.             that flag SQL statements not conforming to entry, intermediate,
  521.             or full SQL/92 with an error or warning. For information,
  522.             see "The SQL Preprocessor" in the online Help index.
  523.         Two database options are available that flag non-conforming
  524.             SQL syntax in the same way within the database engine.
  525.             For information, see "database options" in the online Help index.
  526.  
  527.     Open Server Gateway enhancements
  528.         Several enhancements have been made to improve SQL Server
  529.         compatibility:
  530.             The Open Server Gateway has more complete datatype support.
  531.                 It supports numeric and decimal datatypes, and datatype
  532.                 conversions based on the capabilities of the application.
  533.             Improved text and image support have been added to support
  534.                 replication and to support DBLIB and CTLIB applications
  535.                 that use text and image API calls.
  536.             Improved cursor API support has been added.
  537.             
  538.     New Embedded SQL function
  539.         The db_interface_option function has been added. It has the form:
  540.         
  541.             void db_interface_option( struct sqlca *sqlca,
  542.                                       int option, long value )
  543.  
  544.         The db_interface_option() is an Embedded SQL function used to set
  545.         database interface options. Currently there is only a single
  546.         option, DBO_ANSI_TRUNCATION.
  547.             The DBO_ANSI_TRUNCATION option specifies how to set indicator
  548.         variables in the case of string truncation. If DBO_ANSI_TRUNCATION
  549.         is set to 0, indicator variable values include the null char when
  550.         indicating the size of the truncated string.  Set DBO_ANSI_TRUNCATION
  551.         to 1 to get ANSI/ISO behaviour, which is to not include the null
  552.         char when indicating the size of the truncated string. The default
  553.         value for DBO_ANSI_TRUNCATION is 0, for backwards compatibility.
  554.  
  555. 11. About Release 5.5
  556. ---------------------
  557.  
  558.     With release 5.5, Sybase SQL Anywhere can be obtained in a Standard and
  559.     a Professional Edition. The Professional Edition includes additional
  560.     components. In particular, the following components are included in the
  561.     Professional Edition:
  562.         o   NetImpact Dynamo Internet features
  563.         o   The Powersoft InfoMaker reporting tool
  564.  
  565.     To mark the availability of the new versions, and the new features
  566.     included in the Professional Edition, the version number of this
  567.     release of the software is 5.5.
  568.  
  569.     For last-minute information about Powersoft InfoMaker, see the InfoMaker
  570.     Read Me First, installed into your program group.
  571.  
  572.     The last-minute information about NetImpact Dynamo, below, is also
  573.     included in NetImpact Dynamo online Help, installed into your
  574.     program group.
  575.     
  576.  
  577. 11.1 Behavior changes
  578. ---------------------
  579.     When an arithmetic operation results in an integer overflow, the ISO
  580.     SQL/92 standard requires that an error "SQLSTATE = 22003 - overflow
  581.     error" should be generated. The new default behavior corresponds to
  582.     this behavior. To obtain the same behavior as previous versions, set
  583.     the database compatibility option ANSI_INTEGER_OVERFLOW to OFF.
  584.  
  585.     The LOAD TABLE and UNLOAD TABLE statements now require table
  586.     ownership or DBA authority. Previously, only INSERT/DELETE permission
  587.     was required. As LOAD TABLE adds data without a transaction log record
  588.     or firing triggers, the LOAD TABLE statement provided a loophole
  589.     past enforcement of business rules.
  590.  
  591.     LOAD TABLE and UNLOAD TABLE no longer carry out an automatic commit.
  592.  
  593. 11.2 New features
  594. -----------------
  595. This section lists new features in Release 5.5, with pointers to the
  596. online Help index for more information. To locate a topic in the online Help,
  597. goto the index or search facility and type the topic name.
  598.  
  599.     Compatibility enhancements
  600.         Database options for Transact-SQL and ISO SQL/92 compatibility
  601.             Several database options have been added to allow improved
  602.             compatibility with Sybase SQL Server and with ISO SQL/92,
  603.             while maintaining the ability to be compatibile with existing
  604.             applications. For information on these options, see "SET OPTION
  605.             statement" in the online Help index.
  606.         The CONVERT function now converts strings to dates and times, as
  607.             well as the converse.
  608.  
  609.     Live backup
  610.         A new option for the backup utility allows a continuous backup of
  611.             the transaction log. In case of a server shutdown, this log file
  612.             can be used for a rapid restart of the system.
  613.  
  614.     Embedded SQL enhancements        
  615.         CONNECT USING statement can be used from Embedded SQL. For
  616.             information, see "CONNECT statement" in the online Help index.
  617.         The PREPARE statement has been enhanced to allow immediate
  618.             describing and/or execution of the prepared syntax.
  619.             For information, see PREPARE statement" in the online Help index.
  620.         A new set of statements is available for descriptor handling.
  621.             For information, see "ALLOCATE DESCRIPTOR statement",
  622.             "DEALLOCATE DESCRIPTOR statement", "GET DESCRIPTOR statement",
  623.             and "SET DESCRIPTOR statement", in the online Help index.
  624.         Dynamic loading of Embedded SQL interfacy library DLLs is made possible
  625.             without linking against the imports libraries. For more information
  626.             on this technique, see "Interface library DLL dynamic loading"
  627.             in the online Help index.
  628.  
  629.     SQL Remote enhancements
  630.         The new REPLICATION_ERROR database option allows improved
  631.             tracking and reporting of replication errors. For information,
  632.             see "Error reporting and conflict resolution in SQL Remote",
  633.             in the online Help index.
  634.         A command line argument for DBREMOTE allows memory usage to be
  635.             controlled for environments running with many remote databases
  636.             (over a thousand).
  637.         New features assist in the replication of "blobs": long data types.
  638.             For information, see "Replication of blobs", in the online Help index.
  639.         
  640.     SQL Central enhancements
  641.         A Table Editor window is provided to enable Table creation and editing
  642.             in a single window.
  643.         Database options can now be set from SQL Central. Right-click on
  644.             a database and select Options from the pop-up menu.
  645.         You can unload specific tables from SQL Central, and validate a
  646.             database to which you are not connected.
  647.         A wizard is provided for creating user-defined functions.
  648.  
  649.     Open Server Gateway enhancements
  650.         The Open Server Gateway automatically sets database options to
  651.             help ensure maximal compatibility between SQL Anywhere
  652.             and SQL Server behavior.
  653.         
  654. 11.3  NetImpact Dynamo
  655. ----------------------
  656.  
  657.     Printed Documentation corrections
  658.  
  659.         The following features are not documented in the printed
  660.         documentation:
  661.         
  662.         * Web sites can include linked folders, which link to documents stored
  663.           as files, in addition to documents stored in a database. Linked
  664.           folders cannot contain dynamic content. For more information, see
  665.           "Working with folders and documents" in the online Help index.
  666.         
  667.         * Several of the built-in script objects have additional methods and
  668.         properties. For information, see "Predefined objects" in the online
  669.         Help.
  670.  
  671.         The following are known inaccuracies in the printed documentation:
  672.         
  673.         Page 63-64   The list of required files for deployment has been
  674.         modified. For an updated list, see "Required files for the Application
  675.         Servers" in the online Help index.
  676.  
  677.         Page 64-65   The ISAPI filter DLL described on this page is not
  678.         supported in the current release. 
  679.  
  680.         Page 65      The instructions for Web server configuration have been
  681.         updated and instructions for NSAPI Web server configuration added. For
  682.         updated instructions, see the section Step 2: configure the Web server 
  683.  
  684.         Page 118     The argument to the ExportTo method of the document object
  685.         is a directory, not a file name. 
  686.  
  687.     Sessions
  688.  
  689.         Dynamo applications may use the session object for managing 
  690.     persistent information.  Microsoft's Internet Explorer 2.0 
  691.     does not support the session object and thus applications 
  692.     using it will not work with IE 2.0. The Dynamo demo 
  693.     application uses the session object.
  694.  
  695.         Also, the default timeout on the session object (the idle 
  696.     time before the object will be released) is 5 minutes.  
  697.     Thus, applications such as the Dynamo demo application, 
  698.     will not work properly if left idle for more than 5 minutes.  
  699.     This can be modified by setting the registry entry in the 
  700.     Local Machine key:
  701.         
  702.             Software\Sybase\NetImpact\Dynamo\Cookie Timeout
  703.  
  704.        The setting should be string type and is the number of minutes 
  705.        for the timeout.
  706.  
  707. 12. About Release 5.5.01
  708. ------------------------
  709.  
  710.  
  711. 12.1 New features
  712. -----------------
  713. This section lists new features in Release 5.5.01, with pointers to the
  714. online Help index for more information. To locate a topic in the
  715. online Help index, go to the index or search facility and type the topic
  716. name.
  717.  
  718.     SQL enhancements
  719.         A new special constant, LAST USER, has been added as a way of
  720.         identifying which user last changed a row. For information, see
  721.         "Constants in Expressions" in the online Help index.
  722.  
  723.     New database options
  724.         A new database option, FIRE_TRIGGERS, allows trigger firing to be
  725.         turned off. This is relevant for SQL Server to SQL Anywhere
  726.         replication. For information, see "Compatibility options" in
  727.         the online Help index.
  728.  
  729.         A new database option, BACKGROUND_PRIORITY, allows tasks to run
  730.         with minimal impact on other connections. For information, see
  731.         "Database options" in the online Help index.
  732.  
  733.     SQL Remote enhancements
  734.         A Message Agent for NetWare is now available. This is named
  735.         DBREMOTE.NLM. For information, see "Adding SQL Remote message
  736.         types" in the online Help index.
  737.  
  738.     Server and engine switches
  739.  
  740.         The SESSIONS network communications option (-x switch) on the
  741.         can be used to change the maximum number of NetBIOS connections
  742.         allowed to a given server. For information, see "Network
  743.         communications parameters", in the online Help index.
  744.  
  745.      SQL Central enhancements
  746.         The script editor and script editor console now support printing.
  747.         For information, see the SQL Central online Help.
  748.     
  749.  
  750. 13. About Release 5.5.02
  751. ------------------------
  752.  
  753.     This section includes the following information:
  754.     13.1. SQL Central name change
  755.     13.2. New features
  756.     13.3. Behavior changes
  757.     13.4  NetImpact Dynamo new features
  758.  
  759. 13.1. SQL Central name change
  760. -----------------------------
  761. With this release, the name of the SQL Central management utility has 
  762. changed to Sybase Central.  The utility is now used to manage applications
  763. such as NetImpact Dynamo which, although employing relational databases,
  764. are not themselves relational databases. The name Sybase Central reflects
  765. this broader range of applications managed by the utility.
  766.  
  767. 13.2. New features
  768. ------------------
  769. This section lists new features in Release 5.5.02, with pointers to the
  770. online Help index for more information. To locate a topic in the
  771. online Help index, go to the index or search facility and type the topic
  772. name.
  773.  
  774.     Sybase Central enhancements
  775.         The features of the Service Manager have been incorporated into
  776.         Sybase Central, and enhanced. The Service Manager is still
  777.         included for compatibility, but Sybase Central has more
  778.         functionality and its use is recommended. For information, see
  779.         "Running Programs as Services", in the online Help index and
  780.         the Sybase Central online Help.
  781.  
  782.         A rebuild wizard has been added, to assist with unloading and
  783.         reloading databases. For information, see the Sybase Central
  784.         online Help.
  785.           
  786.     SQL Remote enhancements
  787.         Several options have been added to the Message Agent (DBREMOTE).
  788.         o   The -u switch sends only backed up transactions. For information,
  789.             see  "The SQL Remote Message Agent" in the online Help index
  790.         o   The -x switch renames the transaction log. For information,
  791.             see  "Backup procedures at remote databases" in the
  792.             online Help index.
  793.  
  794.         The UPDATE PUBLICATION statement now allows the old subscribe by
  795.         list as well as the new subscribe by list. Using this feature can
  796.         make SQL Remote triggers more efficient. For information, see
  797.         "UPDATE statement syntax" in the online Help index.
  798.  
  799.         The SMTP message link has a new control parameter indicating
  800.         the local host name. For information, see  "SMTP message control
  801.         parameters" in the online Help index.
  802.  
  803.         
  804.     SQL enhancements
  805.         New properties have been added to the list of properties
  806.         accessible by SQL Anywhere system functions. For information,
  807.         see  "System functions" in the online Help index.
  808.  
  809.         xp_msver is a system stored procedure that returns version and
  810.         other information about the SQL Anywhere softwrare. For information,
  811.         see  "xp_msver system function" in the online Help index.
  812.  
  813.         Search conditions using the IN clause have been expanded.
  814.         For information, see  "IN conditions" in the online Help index.
  815.     
  816.  
  817.     Utility enhancements
  818.         DBTRAN displays the starting offset of the transaction log being
  819.         translated. This is implemented primarily for replication
  820.         installations. For information, see  "DBTRAN command line" in
  821.         the online Help index.
  822.  
  823.     Connection parameter enhancements
  824.         The PORT connection parameter, used with the -x option of the
  825.         client and server, has been changed to ServerPort.
  826.  
  827.         The DoBroadcast and Host connection parameters have been added
  828.         for operating systems other than Windows NT and Windows 95, for
  829.         non-Windows clients to talk more easily with Windows 95 and NT
  830.         servers.
  831.         
  832.  
  833. 13.3. Behavior changes
  834. ----------------------
  835.  
  836.     Permissions for the VALIDATE TABLE statement (used by dbvalid) now
  837.     requires the user ot be the table owner or a user with either DBA
  838.     or REMOTE DBA authority. Previously, VALIDATE TABLE was permitted
  839.     by a user with SELECT permissions on the table and resource
  840.     authority (permission to create tables).
  841.     
  842.     Passthrough mode behavior for CALL statements has changed.
  843.     For information, see  "Stored procedures and control statements
  844.     in passthrough mode" in the online Help index.
  845.  
  846.  
  847. 13.4 NetImpact Dynamo New Features
  848. ----------------------------------
  849.  
  850.     DynaScript
  851.         The DynaScript SCRIPT language has been updated with several new functions and 
  852.         objects to make working with Web sites and databases easier.
  853.  
  854.     Predefined object    
  855.         The predefined objects File and session, have been added to Dynamo for 
  856.         working with Web sites and database content. 
  857.  
  858.     Upgrading previously existing sites
  859.         If reinstalling NetImpact Dynamo over a preexisting version, previously 
  860.         existing sites sometimes need to be upgraded to work with the new version. 
  861.         This may be done automatically the first time the Web site is connected to 
  862.         after a new version has been installed, see "Installation upgrade of Web 
  863.         sites" in the online Help index.
  864.  
  865.     Deployment to Win32s
  866.            A Web site may now be deployed to a Win32s system if first set up on a 
  867.         Windows 95 or Windows NT system. For information, see "Setting up Win32s 
  868.         for remote users" in the online Help index.
  869.         The Personal Web Server for Win32s requires Win32s version 1.30 or later.
  870.  
  871.     Configuring Web servers
  872.         The chapter "Configuring Web Servers and Web Sites" has been rewritten to 
  873.         provide step by step instructions for users that need to configure an ISAPI,
  874.         NSAPI or CGI web server to run with NetImpact Dynamo.
  875.  
  876.         The first three steps of configuring a Web server for NetImpact Dynamo 
  877.         may now be done through the SQL Anywhere installation program. Once SQL 
  878.         Anywhere has been installed, the installation program searches your machine 
  879.         for installed web servers. For each server it detects it will you if you    
  880.         would like to have the server configured at this time to work with 
  881.         NetImpact Dynamo. For more information see "Configuring web servers during    
  882.         installation" in the online Help index.
  883.  
  884.     Running the SQL Anywhere Database server for NetImpact Dynamo
  885.         A new chapter has been added to the NetImpact Dynamo documentation about    
  886.         running the SQL Anywhere server as a service with NetImpact Dynamo. Information
  887.         about why you would want to do this as well as a step by step explanation is    
  888.         provided, see "Setting up the SQL Anywhere Database Server" in the online Help 
  889.         content.
  890.  
  891.     Language Support
  892.         NetImpact Dynamo supports multi-byte character sets. For information, see 
  893.         "Language Support" in the online help index.
  894.  
  895. 14. Notes on replicated Web sites
  896. ---------------------------------
  897.  
  898.     Dynamo 1.2 creates and uses a database table, called WebVersion,
  899.     that was not present in previous releases.
  900.     
  901.     The presence of this table indicates that the Web site has been upgraded
  902.     to version 1.2. This new table needs to be part of the replicated
  903.     environment - it is not replicated automatically. 
  904.  
  905.     The following example script propagates the upgrade of the WebVersion
  906.     table to a subscription named website_publication. website_publication
  907.     should be replaced with your own subscription name and then the script
  908.     should be run against the consolidated database.
  909.  
  910.     1) Create a file, c:\upd_dynamo.sql, containing the following text.
  911.  
  912.         PASSTHROUGH ONLY FOR SUBSCRIPTION TO website_publication;
  913.         CREATE TABLE WebVersion (NIDVersion integer);
  914.         INSERT INTO WebVersion VALUES (2);
  915.         PASSTHROUGH STOP;
  916.         PASSTHROUGH FOR SUBSCRIPTION TO website_publication;
  917.         ALTER PUBLICATION website_publication ADD TABLE WebVersion;
  918.         PASSTHROUGH STOP;
  919.  
  920.     2) Type the following command:
  921.  
  922.         isql -c dba,sql,consolid.db
  923.  
  924.         where the dba is the database administrator of the consolidated database
  925.         and consolid.db is the consolidated database.
  926.  
  927.         If you are in Windows 3.x, run isqlw -c dba,sql,consolid.db
  928.  
  929.     3) Enter the following command:
  930.  
  931.         read c:\upd_dynamo.sql;
  932.  
  933.         where c:\upd_dynamo.sql is the fully qualified file that you created in
  934.         step 1.
  935.  
  936.     4) Press the 'Execute' button.
  937.  
  938.     The next time you run SQL Remote your Web site information will be
  939.     replicated.
  940.  
  941.