RMRSUBST.OPX ------------ Copyright (c) Otfried Cheong and RMR Software 1998 If you going to distribute the OPX further then please read Part 5 first. This is VERY IMPORTANT. README file ----------- Contents: 1. Introduction 2. File Details 3. Installation 4. Using the OPX 5. Distributing the OPX 6. Registration 7. Other Programs from RMR Software INTRODUCTION ------------ This OPX gives you access to a number of functions in the RMRSUBST Suite, to enable you to access them from within a OPL program. FILE DETAILS ------------ The archive consists of the following files: README.TXT This file RMRSUBST.SIS This is the main OPX file in SIS format RMRSUBST.OPX This is the WINS version of the OPX RMRSUBST.OXH This is the header file RMRSUBST.OPL This is a demonstration program that shows you how the OPX can be used INSTALLATION ------------ 1. Install RMRSUBST.SIS 2. Copy RMRSUBST.OXH into the \System\Opl\ folder on either the C: or D: drive 3. Copy RMRSUBST.OPL any where you like USING THE OPX ------------- 1. First compile and run the RMRSUBST.OPL file to make sure everything works and it communicates with RMRSUBST Suite correctly. 2. To use the OPX in your program add the following line to the top of the code, immediately after the APP...ENDA and before the first procedure INCLUDE "RMRSUBST.OXH" 3. You can now use the following additional procedures in your program. SetSubst:(k$, path$) ==================== This substitutes a new drive letter for a defined path, i.e.  C:\System\Apps\ becomes E:\ DriveAttributes&:(k$) ===================== This returns the attributes associated with a drive Subst$:(k$) =========== This returns the path substituted for drive k$. IMPORTANT --------- Although substituting drives is documented in the official EPOC32 documentation, no utility is provided in ROM for doing so. The reason is quite likely that the feature does not work as well as it should. This has nothing to do with this OPX (which simply calls the EPOC functions to do the substitution), but with the implementation in the EPOC file server. Not everything works perfectly on the substituted drives. We get error RMRSUBSTs trying to copy a whole directory tree from D: to M:, or deleting a directory on S:.  (Doing the same operation on the ``real'' drive D: works fine.)  Maybe this is the reason why Psion doesn't give access to the SUBST feature of the file system command. Even some basic file operations do not work. It does, however, allow you to browse your file tree efficiently. DISTRIBUTING THE OPX -------------------- If you wish to distribute the OPX as part of your program, then you need to include the unchanged RMRSUBST.SIS in the ZIP archive or SIS package for your program. Note that you may not, UNDER NO CIRCUMSTANCES, distribute the unpacked RMRSUBST.OPX file. If you do not follow this rule, you disable the EPOC version control over the OPX, and your application may break when the user installs a different version of the OPX. Worse, installing your application may break other applications, and you can imagine the reactions this may cause you. Don't say you haven't been warned! You may not rename the OPX that you distribute, and you may not redistribute RMRSUBST.OXH or RMRSUBST.OPL, they are simply for use on the developers machine. (The first rule makes sure that multiple copies of OPX with the same UID cannot happen, the second rule is to avoid a proliferation of outdated copies of our OPXs. Please refer interested parties to the RMR website.) Shareware using this OPX must include this information in the "About" screen. (A line like "Contains RMRSUBST.OPX © Otfried Cheong" or similar.) REGISTRATION ------------ RMRSUBST.OPX is free for personal use and for use in Shareware/Freeware programs. If you wish to distribute it in a Shareware Package, then we ask that you register it by E-Mailing us at opx@rmrsoft.com. This is simply to keep track of who is using the OPX. OTHER PROGRAMS FROM RMR ----------------------- If you like the look of this OPX, why not have a look at our programs. A full list is as follows: S5BANK : A Personal Accounts Suite RMRTASK : An Extended Task (ToDo) Manager. RMRNOTES : A Note Taker/Jotter program S5HOME : A Home Inventory program. S5FUEL : A Fuel Consumption Monitor. RMRUTILS : A Utility/Conversion program RMRZIP : A Compression/Archive Utility VACTRAC5 : A Holiday/Leave Tracking program RMRSOL : The classic "Solitaire" patience game RMRFILE : The premier file manager for EPOC machines CONTACT : The only Contact Manager available for EPOC machines Some of these are also available in other languages, such as French, German, Spanish etc.. See the Home Page http://www.rmrsoft.com/ for details.