home *** CD-ROM | disk | FTP | other *** search
/ DOS/V Power Report 1997 March / VPR9703A.ISO / MS_DEV / VID / SERVER / ASF / DATA.Z / readme.txt < prev    next >
Text File  |  1996-10-25  |  13KB  |  375 lines
  1.        ------------------------------------
  2.        Microsoft Active Server Pages 
  3.               Beta 2  Release Notes
  4.        ------------------------------------
  5.  
  6.  
  7.        Copyright Microsoft Corporation, 1996
  8.  
  9. Contents: 
  10. 1. Installation Issues
  11. 2. Where is the Product Documentation?
  12. 3. Object and Component Notes
  13. 4. Known Issues
  14. 5. Using a Text Editor with ASP Files
  15. 6. Notes for Windows 95
  16. 7. Notes for Alpha and PowerPC
  17. 8. Server-Side Includes Syntax
  18.  
  19. -------------------------------------------------
  20. Active Server Pages is a feature of the following Web 
  21. server releases:
  22.  
  23. * Microsoft(R) Internet Information Server 3.0 on Windows NT(R)
  24.    Server version 4.0
  25.  
  26.  * Microsoft Peer Web Services 3.0 on Windows NT Workstation
  27.     version 4.0
  28.  
  29. * Microsoft Personal Web Server on Windows(R) 95
  30.  
  31. =================================
  32. 1. Installation Issues
  33. =================================
  34.  
  35. Installing JavaVM
  36. ------------------------
  37.  
  38. To install and use the JavaVM included with 
  39. Active Server Pages, you must first install Microsoft(R)
  40. Internet Explorer version 3.0 or later on your computer.  
  41. If you install JavaVM before Internet Explorer  is 
  42. installed, you will see the following message the next 
  43. time you restart your computer:
  44.  
  45. OleMainThreadWndName regsrv32.exe entry point not found
  46.     URLDownloadToCacheFileW not in urlmon.dll
  47.  
  48.  
  49. Cannot upgrade ASP while Event Viewer is open
  50. -----------------------------------------------------------------
  51. You cannot upgrade Active Server Pages while the 
  52. Windows NT Event Viewer is open.  You will see the 
  53. following error message:
  54.  
  55. "The requested operation cannot be performed on a 
  56. file with a user mapped section open."
  57.  
  58. Close the Event Viewer and try installing Active 
  59. Server Pages again.
  60.  
  61.  
  62. Install Peer Web Services before Active Server Pages
  63. ---------------------------------------------------------------------
  64. If you intend to use Active Server Pages with Peer Web 
  65. Services (PWS), be sure to install Peer Web Services before 
  66. installing ASP.  Active Server Pages uses a newer version 
  67. of ODBC; installing PWS after installing Active Server Pages
  68. will write over the Odbcint.dll and Odbccp32.dll files with 
  69. older versions.  If you get an error message about an ODBC 
  70. conflict, reinstall Active Server Pages to install
  71. the newer ODBC files.  For important information about using
  72. ASP on Peer Web Services, see "Notes for Windows 95 and Peer 
  73. Web Services".
  74.  
  75.  
  76. Install Internet Explorer 3.0 on Windows 95
  77. ---------------------------------------------------------
  78. Active Server Pages on Windows 95 requires Internet Explorer
  79. version 3.0. 
  80.  
  81.  
  82. =====================================
  83. 2. Where is the Product Documentation?
  84. =====================================
  85.  
  86. The Active Server Pages documentation is in HTML format and 
  87. is installed with the product.  After you have installed 
  88. Active Server Pages, you can view the documentation by choosing
  89. Active Server Pages Roadmap from your Web server's program 
  90. group.  From the Roadmap you can also view the Adventure Works
  91. sample Web site, which demonstrates many of the features of 
  92. Active Server Pages scripting and is an excellent source of 
  93. sample code.  You can also view the Roadmap by typing the following
  94. address:  http://<server>/iasdocs/aspdocs/roadmap.htm.
  95.  
  96. The documentation Roadmap requires either  Internet Explorer version 3.0
  97. or later or a browser that supports frames.   You will get the 
  98. best results with Internet Explorer.
  99.  
  100. When you browse the Roadmap using Internet Explorer, you 
  101. may see a message that the page you are viewing contains 
  102. potentially unsafe active content.  This message is caused by
  103. the ActiveX control used to provide the table of contents. To view the table of contents:
  104.  
  105. 1.  From the View menu, choose Options, then click the Security
  106.     tab.
  107.  
  108. 2.  Click Safety Level, then click either the Medium or None 
  109.     safety level.
  110.  
  111. This problem will be fixed in the final release of the documentation.
  112.  
  113. ===================================== 
  114. 3.  Object and Component Notes 
  115. =====================================
  116.  
  117. The following methods and properties have not been 
  118. implemented for this release.
  119.  
  120.  
  121. ActiveX Server Components
  122. -------------------------------------
  123.  
  124. Content Linking Component
  125.  
  126.        NextLink.GetNextURL, NextLink.GetPreviousURL, 
  127.        NextLink.GetNextDescription, 
  128.        NextLink.GetPreviousDescription, and
  129.        NextLink.GetListIndex are not yet implemented 
  130.        for fully qualified URLs.
  131.      
  132.  
  133. =================================
  134. 4.  Known Issues
  135. =================================
  136.  
  137. Setting CacheExtensions Registry Entry to 0 Stops Server
  138. --------------------------------------------------------------------------
  139. Setting the CacheExtensions registry entry to 0 will cause
  140. your Web server to stop responding when Active Server Pages
  141. is unloaded from memory.
  142.  
  143.  
  144. Running Out of Virtual Memory
  145. ------------------------------------------
  146. Under heavy loads, an ASP-based application might run
  147. out of virtual memory because memory becomes fragmented
  148. over time as Active Server Pages allocates and deallocates memory.
  149.  
  150. To correct this problem, adjust the value of the MemFreeFactor
  151. registry entry for your site.  The default value is 50%.  
  152. A value of 0 will increase virtual memory fragmentation but 
  153. allow other applications to use more memory. A value of 100 
  154. decreases virtual memory fragmentation but prevents other 
  155. applications from using more memory.  Thus, if your server
  156. is used entirely for ASP-based applications, setting the value
  157. to 100 will produce the best results. 
  158.  
  159.  
  160. Updating a File Included by Global.asa
  161. --------------------------------------------------
  162. Updating a file that is included by Global.asa does 
  163. not restart sessions. Therefore, objects stored in 
  164. the Application object are not reset. 
  165. To restart sessions, save the Global.asa file.
  166.  
  167.  
  168. VBScript Line Continuation Character
  169. -------------------------------------------------
  170.  
  171. You cannot use the VBScript line continuation character (_) 
  172. within an <%= expression%>.  For example, the following 
  173. script directive will generate a VBScript compilation error:
  174.  
  175. <%= "Variable1" & _
  176.     "Variable2" %>
  177.  
  178. To work around this problem, you can use the
  179. Response.Write method:
  180.  
  181. <% Response.Write("Variable1" & _
  182.                   "Variable2") %>
  183.  
  184.  
  185. Registering Components
  186. --------------------------------
  187. If you have trouble registering components
  188.  on Windows NT Server and Windows NT Workstation, 
  189. you may be using the wrong version of Regsvr32.  
  190. Please use the version installed by default in the directory 
  191. c:\Winnt\System32\Inetsrv\Denali\Cmpnts.
  192.  
  193.  
  194. Using OnStartPage in  Server Components
  195. --------------------------------------------------------
  196. If you have written an ActiveX server component that
  197. uses OnStartPage, you must recompile the component
  198. using the header file shipped with the Beta 2 release
  199. of Active Server Pages. The header file is in 
  200. \<Installdir>\ASP\Cmpnts\Asptlb.h.
  201. On Windows NT Server and Windows NT Workstation,
  202. the default installation directory is \winnt\system32\Inetsrv.
  203. On Windows 95, the default installation directory is
  204. \Program Files\WebSvr\System.
  205.  
  206.  
  207. Creating Single-threaded Components
  208. ---------------------------------------------------
  209. Objects that are marked as single threaded or free
  210. threaded cannot access the scripting context inside
  211. OnStartPage.  Objects marked as apartment threaded or marked
  212. as both apartment threaded and single threaded are OK.
  213. This will be fixed for the final version of Active
  214. Server Pages.
  215.  
  216.  
  217. Providing Unknown Scripting Language Causes Error
  218. -----------------------------------------------------------------------
  219. Specifying an unknown scripting language as the value of
  220. the DefaultScriptLanguage registry entry may cause the 
  221. following error message:
  222.  
  223.      http/1.0 500 server error
  224.  
  225. If you get this error, check the DefaultScriptLanguage 
  226. registry entry. Make sure that you have supplied a 
  227. valid language.
  228.  
  229.  
  230. Starting and Stopping Web Services
  231. -----------------------------------------------
  232. Your Web server may erroneously report that a service could
  233. not be stopped when the Active Server Pages DLL is unloaded
  234. from memory.  
  235.  
  236.  
  237. Using Microsoft JScript
  238. -------------------------------
  239. To use JavaScript in your ASP files, use "JScript"
  240. as the language attribute of the <SCRIPT> tag.  While
  241. "JavaScript" is supported for backward compatibility,
  242. mixing blocks of code labeled "JScript" with blocks of
  243. code labeled "JavaScript" will cause errors.
  244.  
  245.  
  246. NCompass Billboard Control
  247. ---------------------------------------
  248. The NCompass billboard control is only provided for 
  249. Intel processors. This release does not include versions
  250. for the Alpha and PPC processors.  
  251.  
  252.  
  253. Adventure Works Sample Site
  254. ----------------------------------------
  255. The following issues pertain to the Adventure Works
  256. sample application:
  257.  
  258. *  The shopping cart currently does not support more 
  259.    than five items at any given time. If you order more
  260.    than five items at any one time, a "Subscript Out of
  261.    Range" error will occur.
  262.    
  263. *  The pie chart found on the "Sales by Product" page
  264.    currently displays only the first six  products. 
  265.    However, you can change the parameters to accommodate
  266.    the dynamic content if you wish.
  267.    
  268. *  "Warning: Avalanche Area" indicates a page 
  269.    under construction.
  270.  
  271. *  The Adventure Works visitors number count currently is
  272.    set to 0 whenever the site is restarted.  For the final
  273.    release of Active Server Pages,  the site will save the 
  274.    number of visitors upon reboot or shutdown.  
  275.  
  276.  
  277. Ad Rotator Component
  278. ------------------------------
  279. Repeatedly requesting a nonexistent file from the 
  280. Ad Rotator component might cause the Web server to 
  281. stop responding.  
  282.  
  283.  
  284. Database Access Component Issues
  285. -------------------------------------------------
  286. Deleting a database record might cause a dynamic cursor 
  287. to be lost.  Further attempts to move the cursor will
  288. return unexpected results.  To locate the cursor in the
  289. database, use the MoveFirst method to return to the first
  290. record, then relocate the cursor.
  291.  
  292. Deleting a row in a recordset and then trying to 
  293. update the row at the same location may fail. If you 
  294. need to update rows that may have been  previously deleted
  295. on the current recordset, you should close the recordset
  296. and requery the data to be sure all rows are visible.
  297.  
  298. Null data can be stored as a column value in a database.  
  299. The corresponding Visual Basic data type is Empty which is 
  300. equivalent to an empty string. Accessing a Null value and 
  301. printing it will thus display nothing.  To print a string 
  302. for Null values, use a statement similar to the following:  
  303.  
  304. <% If IsNull(RScatalog_item("ProductSize")) Then  
  305.        Response.Write("ProductSize" & "is Null") %>
  306.  
  307. ==================================
  308. 5.  Using a Text Editor with ASP Files
  309. ==================================
  310.   Here is a tip about using Notepad to create .Asp files:
  311.       In the Save or Save As dialog boxes, if the Save As 
  312.       Type box displays "Text Documents (*.txt)", the 
  313.       extension .txt is added to whatever you type in the 
  314.       File Name box.  So, if you type Myfile.Asp in the 
  315.       File Name box, the saved text file is actually named 
  316.       Myfile.Asp.txt. To avoid this, select "All Files" in 
  317.       the Save As Type list, or enclose the file name 
  318.       in quotation marks before saving.
  319.  
  320.  
  321. =====================================
  322. 6. Notes for Windows 95
  323. =====================================
  324. The Active Server Pages version for Windows 95 
  325. should be considered an alpha-quality release.  
  326.  
  327. Personal Web Server on Windows 95 does not support 
  328. the new server-side includes enhancements.
  329.  
  330. Active Server Pages for Personal Web Server requires
  331. the installation of Internet Explorer version 3.0.
  332.  
  333.  
  334. =====================================
  335. 7. Notes for Alpha and PowerPC
  336. =====================================
  337. If you want to use the Access ODBC driver on PowerPC
  338. computers, you must create and set a new value entry in
  339. the registry.  Use the Registry Editor to open the key 
  340. HKEY_LOCAL_MACHINE
  341.    \System
  342.      \CurrentControlSet
  343.         \Control
  344.            \SessionManager 
  345.  
  346. Add a value entry called EnableAlignmentFaultExceptions. 
  347. Set the class to REG_DWORD, and set the value to 0.
  348.  
  349. This registry entry causes the system to catch alignment
  350. faults that exist in this release of Active Server Pages.
  351. Because catching alignment faults hampers performance,
  352. do not run ASP permanently with this setting.  The final
  353. release of ASP will correct this problem.  
  354.  
  355. The AdventureWorks sample site and the tutorial  both require
  356. the Access ODBC driver. 
  357.  
  358.  
  359. You cannot use the table of contents in the documentation roadmap
  360. from a browser running on Alpha or PowerPC computers that
  361. access the files from an i386 server.
  362.  
  363. =====================================
  364. 8. Server-Side Includes (SSI) Support
  365. =====================================
  366. This release of Internet Information Server and 
  367. Peer Web Services includes enhancements to 
  368. server-side includes syntax.  For information on
  369. server-side includes, use your Web browser to open
  370. the SSI documentation at the following location:
  371.  
  372. http://<your-server>/iasdocs/aspdocs/ssi/isiall.htm
  373.  
  374.  
  375.