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