|Home||Free Software||Software Support||Training||Conferences|
Using ServerZip under the .NET Framework. The ServerZip component is not specifically designed for use under the Microsoft .NET Framework. It is a standard COM DLL, and so will require you to run any managed code application or ASP.NET page that uses it in "compatibility" mode (i.e. include AspCompat="true" in the <%@Page ... %> directive). Alternatively you can use the .NET TLBIMP utility to create a managed code wrapper for the component. However, please note that we cannot provide support for issues that arise in conjunction with using the component within a .NET application.
How to I UNZIP files using ServerZip? The bad news is that you can't. ServerZip only includes a ZIP function, and not an UNZIP function. The reason is that unzipping files is a process more likely to cause errors or to prompt for input from the user. For example, files are encrypted, the zip file of some of the contents are damaged, the files to unzip already exist in the target folder, etc. So far we have been unable to guarantee that the compression system used by ServerZip can successfully suppress all these errors when running on a remote machine under the control of a Web server. However, progress in this area means that we are now investigating the possibilities of offering such a feature. Details of this will be posted on our Web site.
Checking the component version number. If you are having problems with ServerZip, you should check the component version number and include this with your inquiry. The component file is stnbsz20.dll, which is installed by default in your Winnt\System32 folder. To check which version you have installed:
Changed features in version 2.0. If you have used a previous version of ServerZip, you will find that the new version has some differences:
Changed features in version 2.2x. The following changes were made to ServerZip as of version 2.2x. They are designed to make it easier to get status information about the zip process and its outcome, especially when the hideResponse property is set to True.
Changed features in version 2.3x. The following change was made to ServerZip as of version 2.3x. It is designed to make it easier to control the final location of the compressed download file.
Changed features in version 2.4x. The following change was made to ServerZip as of version 2.4x. ServerZip2 now supports the use of UNC path names for the sourceFileList property, which allows the files on networked machines to be included in the zip file. For example:
Getting the latest version of ServerZip. The main ServerZip file is stnbsz20.dll, which is installed by default in your Winnt\System32 folder. The current versions of this file are 2.40 (evaluation version) and 2.41 (full version). To check which version you have installed:
Updated compression system file. The compression system file has been updated to provide better performance and to solve other minor issues. The file affected is lspzipx.dll, which is installed by default in your Winnt\System32 folder. The current version of this file is 2.509. Note that you can only use UNC path names (i.e. paths that start with \\servername) to
specify the source files if you have installed this or a higher version of the DLL. To check which version you have installed:
The Stonebroom.ServerZip2 Start Menu is empty. Some builds of ServerZip2 escaped from our labs with an error in the setup.lst file that causes the Stonebroom.ServerZip2 entry on the Start menu to remain empty after a successful installation. To fix this, add shortcuts to the following files to the Stonebroom.ServerZip2 folder that the setup program creates (note that you will need to change the drive letter and path if you installed the component into a different folder):
The 'ERROR: Nothing To Do' message. The most common cause of this error is that ServerZip cannot find the source files that you specified in the sourceFileName property. To help you test the installation of the component and make sure it is working correctly, we have available a small demonstration file set with detailed instructions that you can use to try it out.
The 'ERROR: Cannot create unique download directory' message. ServerZip requires appropriate disk access permissions to be able to create the download directories and zip files. If you encounter the message: ERROR: Cannot create unique download directory you will need to edit the Permissions list in the Properties dialog for the directory specified as the virtualTargetRoot property (using Windows NT Explorer). Give the account that will use the component Write or Full Control permission. If the component is being accessed anonymously, the account in use will be either IUSR_machinename or IWAM_machinename depending on whether you have installed the component as a Virtual Application in Internet Service Manager.
I can't replace or delete the ServerZip DLL file. Windows NT and the Web server cache the components they use in memory, and lock them so that they cannot be moved or deleted while in use. In some cases stopping and restarting the Web server may release the component. Otherwise restarting Windows or rebooting the server will do the trick. To avoid this problem, if you are using Internet Information Server 4 or higher, you can create Virtual Applications and place all your ASP pages that use the component inside this folder. It's then possible to unload the component from memory using the Properties dialog of the Virtual Application folder in Internet Service Manager.
I'm confused about physical and virtual file paths. The
Tell me more about using physical source file paths. Physical source files give the most freedom when specifying the
Tell me more about using virtual source file paths. Virtual source files give less freedom when specifying the
How do I view the documentation from a remote machine? The documentation and sample pages for ServerZip are found in the directory where you installed ServerZip. By default this is
I get errors when two people use the component at the same time. The ServerZip component is only designed to carry out one zip operation at a time. If two or more users access it concurrently the last one will get an error message. To prevent this, you can attempt to queue operations by checking the
'see if the component is busy or can start the zip operation If objSZ.zipIsBusy Then Response.Write "Waiting to access the component ...<P>" Response.Flush 'force display by the browser with two Write and Flush operations Response.Write "" Response.Flush 'then wait for up to two minutes for the component to become available intWaitUntil = (Minute(Now) + 2) Mod 60 Do While (objSZ.zipIsBusy) And (Minute(Now) <> intWaitUntil) Loop End If If objSZ.zipIsBusy Then 'still busy after 2 minutes Response.Write "Sorry, the component is too busy at present.<P>" Response.Flush Else 'OK to do the zip blnWorked = objSZ.doZip() 'call the doZip method to create the new zip file End IfNote: The account that the component is running under must have Read/Write/Delete permission for the Temporary directory on your system for this property to work correctly. The Temporary directory is usually specified by the TMP or TEMP environment variable, and the default is usually C:\Temp or Winnt\Temp.
Runtime error 800a01ad 'ActiveX component can't create object'. This general error message can be caused by many things. To cure it, try the following:
Installation error 'A required .DLL file, MSVBVM50.DLL, was not found'. The error message: 'Error Starting Program. Installation error A required .DLL file, MSVBVM50.DLL, was not found' may appear when running the security configuration tool if your system does not already have the required file installed. This file can be obtained from the Microsoft MSDN site at: http://support.microsoft.com/default.aspx?scid=kb;EN-US;180071 which also contains a link with instructions on how to download and install the file. Alternatively, you can download an updated version of the security configuration tool. Click here and select Save when prompted to download the file named
Finally, if you've got any suggestions - or any comments on ServerZip generally - we'd love to hear from you.