HPFSRem -- HPFS removability software Version 1.1 Copyright (c) 1996 by Jeff Jackowski This software is shareware -- registration is required for commercial use Introduction HPFSRem allows you to use HPFS on some removable drives without losing the ability to remove and replace disks. Although HPFS without any special software can sometimes be used on a removable drive without any problems, I found that often system crashes will be the result and data can be lost. HPFSRem is my attempt to eliminate data loss and system crashes from using HPFS formatted removable media. I can't guarantee HPFSRem will let you use HPFS with any drive, but it works for me and several other people with varying drives. You should test your drive with HPFSRem to see if it works before using HPFS on removable disks on a large scale. Please email me at jackowskij@@email.uah.edu to tell me what works and what doesn't. Be sure to send the output of HPFSRem with the "S" parameter if you're having a problem making it work. PLEASE READ THIS DOCUMENT CAREFULLY! HPFS was not made to support removable drives. HPFSRem attempts to circumvent this limitation and will work if my directions are followed and your removable drive cooperates. Any deviation from my instructions may cause various problems ranging from an inability to use HPFS on removable media to system crashes when a disk formatted with HPFS is removed or inserted. Also, any emails I get with questions that have answers in this text may not receive a response. NOTE TO EXPERTS: You may skip the "Disk setup" section, but should read the rest, paying close attention to the "FYI" and "Known problems and limitations" sections. NOTE TO NON-EXPERTS: Please don't be intimidated by the computer terms I use in this document. Read the whole thing, even if you can't understand it all. Some things, like primary and secondary partitions, don't need to be understood. However, you will need to use FDISK and format properly, and will need to install a package called EMX. These tasks are not difficult if you can follow the instructions and both use and understand the online help for FDISK and format. If you have trouble, ask someone who knows how to do these things (I'm a prime candidate :-). To help you out, here are a few definitions: FAT - File Allocation Table - This is a method of indexing files on a disk. It is a fairly simple system that was developed for use with DOS. FAT was originally made for small (less than 32MB) hard drives and is not well suited to today's 1GB+ (1024MB+) hard disks. HPFS - High Performance File System - This is a newer method of storing files on a disk. HPFS is made to provide excellent performance and is suited for use on hard drives with up to a 2GB capacity. Also, HPFS features greater fault tolerance than FAT. That means that if a problem happens while writing to a disk, a disk formatted with HPFS is more likely to retain its data with fewer problems than a FAT disk. Partition - a division, in this case on a hard disk. More than one partition can be put on a hard disk, and it is the partitions, not the physical drives, that receive drive letters. Thus, on a system with one hard drive, if you put 2 partitions on its hard drive, then the drive letter "C" will be assigned to the first partition, and "D" to the second. This is true with OS/2, DOS, and all Windows. WARNING: Two kinds of partitions exist, primary and logical. Which to use on hard drives is beyond the scope of this text. With removable drives, however, ALWAYS use logical partitions. WPS - Work Place Shell - The graphical user interface that comes with OS/2. System Requirements OS/2 Warp (version 2.x may work, but I'm not sure) HPFS must be installed EMX 0.9a or later installed A removable drive (see "Compatible Drives" and "Drive Requirements" sections below) NOTE: Contrary to SyQuest documentation, partitioned removable disks can be used if OS/2 boots from a logical partition (so you can put OS/2 on drive D and DOS on drive C, for instance). The removable disks should be given a logical, not primary, partition to make this work. Compatible Drives The following drives have been tested by myself and other users. Other drives may work as well. SyQuest's EZ135 and SQ3270 have been tested and work. Iomega's Zip drive has been tested with the OAD drivers and works. FLT drivers may also work. Follow the instructions included with the drivers to format the disks with HPFS, then use HPFSRem. Still working on Jaz support. Drive Requirements SHORT: The drive should be non-removable (from OS/2's point of view) or removable and lockable. Plus, you'll need to format the disk with HPFS. LONG: To use HPFS with a given drive, you need to able able to format the disk with HPFS (consult documentation below and the documentation that came with the drive). This sometimes requires that you lock the disk in the drive. Use HPFSRem with the "I" parameter to lock the disk. Some drives will lock automatically. If the drive won't unlock, then the drive won't let you remove the disk. Error messages (New info for v1.1) HPFSRem v1 would sometimes give error messages that did not stop it from doing its task. I think it mostly has to do with support for locking and unlocking the disk, which was required in v1 to run without errors. I have made v1.1 to better handle the lack of support for locking and unlocking, and to support removable drives that OS/2 sees as non-removable drives. In addition, HPFSRem v1.1 gives error code values that, while not always self-explanatory, should help me to figure out what's wrong. Installation First, install EMX if you haven't already. You can find the file you need at ftp://hobbes.nmsu.edu or ftp://cdrom.com. The directory to look for is EMX???, where the ??? mark the version number, such as 09a and 09b. The file is EMXRT.ZIP. It contains installation instructions for itself. Copy HPFSRem.exe to a directory in your path. Instructions The syntax of HPFSRem is: HPFSRem d [R | I | RI | S] d is the drive letter of the removable drive. R tells HPFSRem to prepare the disk for removal. If the disk is locked (drive won't allow the disk to be ejected), then HPFSRem will unlock it. I tells HPFSRem to allow the insertion of a disk. You will be prompted to insert a disk. The disk will be locked in the drive until the "R" parameter is given. RI, a combination of the separate "R" and "I" parameters, tells HPFSRem to prepare a disk for removal and then allow another disk to be inserted. S will make HPFSRem give you information about the drive you specify. This information includes whether OS/2 sees the drive a removable or not, if the drive is locked, can be locked, or won't tell, and HPFSRem's assessment of the possibility of using HPFS removability on the drive. PLEASE give me this information along with bug reports! Type "hpfsrem" and enter to receive a help screen. Disk setup NOTE: The following procedure only works for removable drives that support partitions, like SyQuest drives. Although the below text says otherwise (I haven't revised it), HPFSRem can be used on drives that do not support partitions so long as its disks can be formatted with HPFS. Follow the instructions included with your drive to do this. Then you can use HPFSRem. To make use of this utility, you must format some of your removable disks with HPFS. To do this, you must first partition your disk using FDISK. You can run FDISK from the command line, or select "Create partition" from the menu of the Drives object. If you are preparing several disks, it is fastest to boot the system to the command line by pressing Alt-F1 before the OS/2 logo is displayed and then pressing "C" for the command line. This is because you will have to reboot every time you set up a partition. HPFSRem can be used to unlock the disk so that you can remove it without having to boot to the WPS. Once you're running FDISK, select the correct disk for your removable drive. FDISK starts with disk 1 (first physical disk) selected. Disk 1 is normally a hard drive -- you will probably need to select disk 2 or higher. If you can't find the removable drive on FDISK's drive list, then you can't use HPFSRem :(. Next, delete any existing partitions on the removable disk. Of course, you should backup any data that may be on the disk if you want to keep it. After that, create a partition on your removable disk that is the full size of the disk. The default partition size FDISK will present is the total remaning space on the disk. Make the partition an extended/logical partition. Then quit FDISK. A reboot is required by the system at this point. After rebooting, you will need to format the disk. Go to the menu of the removable drive in the Drives folder and select format. Tell the format program to use HPFS. Or, you can use the format command from the command line with the "/fs:hpfs" parameter. FYI HPFSRem only needs to be used when a disk being removed or inserted has been formatted with HPFS. When only disks formatted with FAT are involved, the methods supplied with your removable drive may be used. Before you shutdown the system, you may need either an HPFS disk in your removable drive or have used a FAT disk in the drive last. The FAT disk needs to be used in some way (typing "dir" at the command line is good enough) and may be removed before shutdown. Failure to meet these conditions may prevent a proper shutdown of the system if you booted the system with a FAT disk in the removable drive. Booting with an HPFS disk seems to prevent this problem. It is best to partition removable disks with a logical, not primary, partition weather or not HPFS will be used on the disk. If OS/2 is booted from a logical partition, then attempting to use a removable disk with a primary partition will cause the system to crash. Partitioning the disks with a logical partition avoids this problem and works fine with systems that boot OS/2 from a primary partition. If you use a SyQuest drive, the DOS/Windows drivers will have no trouble using logical partitions. Before a disk can be removed, all programs must stop using files on the disk. If a program has a file open on the removable disk, HPFSRem will give an error and will not unlock the disk. Also, it is a good idea to close all views of the files and directories on the disk before removing it. OS/2 uses a feature called lazywrite that buffers data to be written to a disk to improve performance. HPFSRem always makes certain that all data to be written to the removable disk is written before removal. Known problems and limitations If you copy files with long names to a removable HPFS disk using the WPS (drag & drop), the result may be interesting. Although folder views of the directory on the HPFS removable will have long names, the files on the removable disk may not have long names. If you type "dir" at a command prompt, and find that the long names of the files are not in the directory, then you have this problem. One way around this problem seems to be to put an HPFS formatted disk in the removeable drive before booting OS/2. Then, all files copied to the disk from the WPS will retain their long names. Another work around is to use the command line. A copy command issued from the WPS will convert the long names of files to names suitable for FAT volume. However, if you copy files from the command line, the long names will be preserved. Note that from the command line you cannot copy a file with a long name to a FAT volume. This program does not allow the use of HPFS on floppies. This is because HPFS can only be put on partitioned disks. Floppies cannot be partitioned. This is a limitation of OS/2, but so is not supporting HPFS on removable disks :-). HPFSRem supports only a single partition on removable disks. Multiple partitions on a removable disk will cause problems. Occasionally, the system may not complete a shutdown properly. This sometimes seems to be in connection with a drive not ready error from the removable drive. The cause of the error is trying to read from the drive when no disk is in it. Avoid this error. Also, limiting yourself to using the "RI" parameter for HPFSRem and using HPFSRem when any disk is being inserted or removed, not just HPFS disks, may help solve the problem. If data loss occurs when removing FAT disks from the drive, use HPFSRem to remove FAT disks as well as HPFS disks. The data loss may come from using lazywrites on the disk. The lazywrite feature will cache writes to the disk, so some data to be written may be held in buffers when a disk is removed. HPFSRem will make OS/2 write the contents of the buffers to the disk, so no data loss will occur from caching writes to the disk. Labels To help me keep track of what I put on my removable disks, I made a simple disk label template for use with IBM Works. The label, included in this package, is made for EZ135 disks, but could be altered for use with other disks. To make use of the label, load it with IBM Works and save it with a different name. You can change the "Spine Description" by double clicking your mouse on it. You'll be presented with a dialog where you you can change the text and its orientation. Be sure that the bottom right icon on this dialog is pressed or the text won't be vertical anymore. There are two tables on the left and right sides of the label. You can type text into these tables. If you press tab at the end of the table, you'll get another row and a horizontal line to go with it. This can't be undone without deleting and remaking the table. Its not my fault -- IBMWorks needs some work. You can also add a vertical line to the table to separate some of the rows into columns. The vertical line doesn't have to divide all the rows. Also, it seems that only one vertical line can be used. If you add a third, no text will be displayed to the right of the line. Before you print the label, you may have to go to the printer setup dialog and tell your printer to print landscape style. I don't know why this is necessary, as IBM Works has been told to use landscape style for the label. It might be because I'm using OMNI.DRV to run my printer. Next, tell IBM Works to print only the first page, or you'll get an empty page at the end. Finally, cut along the outer lines and put the printed label in place of the blue label shipped with disk. Future posiblities Documentation in HTML (anyone got space on a web server I could use for this?) An install program that adds a menu option to the object of the removeable drive for HPFSRem (way in the futrue) Registration HPFSRem may be employed for personal use at no charge. For commercial use, HPFSRem may be used for a 30 day trial period. For continued use beyond the 30 day trial period, it must be registered. To register, send a check for $20 (in US currency, or discuss other possibilities with me) made out to Jeffrey Jackowski and address the envelope to: 608J South Loop Road Huntsville, AL 35805 Send your email address so that I can send you your registered copy via email. Or, send a floppy with your check and I'll return it with the registered software. (But remeber, I don't know how to send mail internationally.) About the programmer I, Jeff Jackowski, am a student at the University of Alabama in Huntsville. Not long after I bought my computer at the beginning of 1995, I have been running OS/2 Warp on it. I decided to run OS/2 after reading good things about it in some periodicals starting a year or two before I bought it. Too bad its harder to find such good words about OS/2 in the general press now. I can be reached at jackowskij@@email.uah.edu, but since I am sometimes busy with classes, it may take me a while to respond. Copyright HPFSRem -- Copyright 1996 by Jeffrey Jackowski HPFSRem executables and documentation are hereinafter referred to as the Package. The Package may be distributed only in its whole and unmodified form -- there are NO exceptions! Any charges for its distribution on floppy disks may not exceed 25 per-cent of the registration price. Charges for distribution of the Package on CD-ROMs whose contents are limited to shareware, freeware, documentation, and any software which entitles users with a licenced copy of OS/2 to legally posses, may not exceed twice the registration price. For distribution on other CD-ROM's, contact the author for permission. On-line service providers, bulletin board systems, and internet service providers may not charge any fees for the distribution of the Package beyond fees for membership and the connect time required for downloading. The Package may be preloaded onto any sold computers so long as it is NOT installed (user must perform the installation process) and does NOT reside in a directory included in the path environment variable specified in the Config.Sys file. Also, the would-be purchaser of the computer must receive a notice, whether electronic (on a web page or via email) written or voice, prior to making the purchase and a written notice shipped with the computer stating that unregistered software has been loaded on to the computer. Both of these notices must name the Package and state that commercial use of this software after the 30 day trial period is prohibited without registration with the author. The Package may also be preloaded on any removeable disks or installation disks for removeable drives by the manufacturer of the drive provided that the Package works properly with that drive. However, a written or electronic (readme file or on-line documentation) notice must be shipped with the products containing the Package stating that unregistered software has been included in the product. The notice must name the Package and state that commercial use of the Package after the 30 day trial period is prohibited without registration with the author. License HPFSRem is provided without any guarantees of any kind. This software may contain errors and bugs and it might not be able to suit all your needs. The author of this software will in no way be held liable for any problems that you may encounter through its use. The Package is provided AS IS. You may use the Package only at your own risk. You may not modify the Package in any way nor may you reverse engineer its executable code or data. You may make additions to the documentation, including translations into other languages, provided that these additions are contained in separate files from the original distribution files and are identified as additions to the original documentation. Commercial use of the Package is not permitted after a 30 day trial period. The Package must be registered with the author for use beyond the 30 day trial period. There are no warranties, express or implied, of any sort. By your use of the Package you agree to the terms of this license.