═══ 1. RegShare - A ShareWare Registration Tracking System ═══ RexxBase is a trademark of American Coders, LTD. OS/2 is a registered trademark of the International Business Machines Corporation. VisPro/Rexx is a trademark of HockWare Corporation. Other trademarks are the trademarks of their respective trademark owners. Contacts: American Coders, LTD. Post Office Box 97462 Raleigh, NC 27624 (919) 846-2014 CompuServe ID: 74150,2370 Internet(USENET) ID: joe@usacoder.rtp.nc.us Copyright 1993-94 American Coders LTD Raleigh NC USA ═══ 2. Rights and Limitations ═══ American Coders, LTD makes no warranties as to the information in this guide. Additionally, American Coders Ltd is not responsible or liable for any loss or damage of any kind resulting from use of this product. This is freeware. If it doesn't work or doesn't do the job - THEN - DON'T USE IT. The Software is protected by the copyright laws of the United States of America, as well as by the copyright laws of many other countries pursuant to international treaties. All rights reserved. system, or transmitted except as provided by U. S. copyright law. ═══ 3. System Overview. ═══ This product is free to use and pass along. RegShare is OS/2 PM program for shareware authors to track registration. Others may find use to track other types of products, good luck. The program was written using VisPro/Rexx (HockWare - Cary, NC) and RexxBase. RexxBase is a product American Coders LTD markets through the shareware channels. The source code is available for a fee, this is discussed elsewhere. The program can track registered customers, multiple products and accounts receivable. ═══ 4. How To Set Up. ═══ Do the following: 1. Get a copy of RexxBase. Make sure to get the latest. As of July 15, 1994 it was RXBAS132.ZIP. There should be copies on the BBS where you found this file. Copies are on CompuServe in OS2SHARE Lib 1 as rxbase.zip. 2. Place the REGSHARE executable in a PATH directory. Place the RexxBase DLL in a LIBPATH directory. Create a WorkPlace shell object, for the executable. 3. Create the database files. Run the four command files: CREATCUS.CMD, CREATBIL.CMD, CREATPRD.CMD and CREATSVC.CMD. If you put the executable in a different directory than the database files then you change the PARAMETERS option in the SETTINGS for the WorkPlace Object for the executable. The parameter is the name of the directory the databases reside. Include a '\' at the end of the directory name. ═══ 5. How To Use. ═══ Fire up the executable and enter at least one product. Click on the product menu option. Fill in the information and press ADD. And then DONE. This is the most non-CUA window you will ever see. I figured since the screen won't be used to often I would leave it alone. If you use any shareware registration services, such as PsL, Compuserve SWREG, Norloff's BBS Registration, etc, then you will want to add some services. Pull down BILLING menu and select SERVICES. Pick NEW from the untitled listbox. This will take you to the SERVICES window. Fill in all appropriate information. Repeat until done. Now to enter registrations. If you have more than one product make sure the product to be register is selected from the drop down list box on the main window. Pick ADD. Enter customer information. Press OKAY. This will take you to the BILL selection window. Pick an item from the untitled listbox and then enter billing info. If you don't have billing information, simply CANCEL out. You will then be mysteriously transferred back to the User registration screen. Press either CANCEL or OKAY. That's it. ═══ 6. There is more to it. ═══ The screens and database files offer several other features not discussed above. For instance, from the User Registration screen you can request to make a ShareWare Diskette. This accomplished by specifying the MAKE command file from the PRODUCT screen. Somethings work and some should work better. For instance, the 5 1/4 checkbox is tracked but not usable with the MAKE DISKETTE function. ═══ 6.1. The Product Database And Screen. ═══ The following is a discussion of the product database and screen. ┌──────────┬─────────────────────────────────────────────┐ │Fields │Description │ ├──────────┼─────────────────────────────────────────────┤ │NAME │Product Name. The index key in product.ndx. │ │ │Must be unique. │ ├──────────┼─────────────────────────────────────────────┤ │PREFIX │Registration Number Prefix. I like to use the│ │ │version number with some unique letter. For │ │ │instance, for RexxBase V 1.32 I have R132 in │ │ │this field. │ ├──────────┼─────────────────────────────────────────────┤ │SUFFIX │Serves same purpose as prefix. │ ├──────────┼─────────────────────────────────────────────┤ │NEXTAVL │Next available number for registrations. │ │ │This field is not shown on the screen. If │ │ │you need to change this then you will need to│ │ │write a command file using RexxBase calls to │ │ │update the database. │ ├──────────┼─────────────────────────────────────────────┤ │PREFIX │This fields are concatenated together to make│ │NEXTAVL │the product registration number. │ │SUFFIX │ │ ├──────────┼─────────────────────────────────────────────┤ │MAKE │A logic switch (T or F). Used to indicate if │ │ │the MAKE SHAREWARE function is available from│ │ │the Registration screen. Set the CHECKBOX if│ │ │TRUE. │ ├──────────┼─────────────────────────────────────────────┤ │COMMAND │The name of the command to execute the MAKE │ │ │SHAREWARE function. │ ├──────────┼─────────────────────────────────────────────┤ │FNAME │A Logic switch. If TRUE then the registered │ │ │user's name is passed with the above command.│ │ │Select it in the listbox if TRUE. │ ├──────────┼─────────────────────────────────────────────┤ │FCOMPANY │A Logic switch. If TRUE then the registered │ │ │user's company name is passed with the above │ │ │command. Select it in the listbox if TRUE. │ ├──────────┼─────────────────────────────────────────────┤ │FADDR1 │Same │ ├──────────┼─────────────────────────────────────────────┤ │FADDR2 │Same │ ├──────────┼─────────────────────────────────────────────┤ │FCITY │Same │ ├──────────┼─────────────────────────────────────────────┤ │FST │Same │ ├──────────┼─────────────────────────────────────────────┤ │FZIP │Same │ ├──────────┼─────────────────────────────────────────────┤ │FPHONE │Same │ ├──────────┼─────────────────────────────────────────────┤ │FPRODUCT │Same │ ├──────────┼─────────────────────────────────────────────┤ │FREGNO │Same │ ├──────────┼─────────────────────────────────────────────┤ │FCOUNTRY │Same │ ├──────────┼─────────────────────────────────────────────┤ │FEMAIL │Same │ └──────────┴─────────────────────────────────────────────┘ ═══ 6.2. The Customer Database And Screen. ═══ The following is a discussion of the customer database and screen. ┌──────────┬─────────────────────────────────────────────┐ │Fields │Description │ ├──────────┼─────────────────────────────────────────────┤ │NAME │Registered User's Name │ ├──────────┼─────────────────────────────────────────────┤ │COMPANY │User's Company Name │ ├──────────┼─────────────────────────────────────────────┤ │ADDRESS1 │User's Address │ ├──────────┼─────────────────────────────────────────────┤ │ADDRESS2 │Same │ ├──────────┼─────────────────────────────────────────────┤ │CITY │User's City │ ├──────────┼─────────────────────────────────────────────┤ │STATE │State or Province │ ├──────────┼─────────────────────────────────────────────┤ │ZIP │ZIP or Postal Code │ ├──────────┼─────────────────────────────────────────────┤ │COUNTRY │What it is │ ├──────────┼─────────────────────────────────────────────┤ │PHONE │Should be big enough │ ├──────────┼─────────────────────────────────────────────┤ │EMAIL_TYPE│Pull down is limitted to None, CIS, Fido and │ │ │InterNet. │ ├──────────┼─────────────────────────────────────────────┤ │EMAIL_ID │See email_type │ ├──────────┼─────────────────────────────────────────────┤ │PRODUCT │Product, not enterable from screen. Can't be│ │ │changed. It comes from the current Product │ │ │drop down list box on the main screen. │ ├──────────┼─────────────────────────────────────────────┤ │REG_NO │Registration number, created from the │ │ │product file PREFIX NEXT AVAILABLE and SUFFIX│ │ │fields. │ ├──────────┼─────────────────────────────────────────────┤ │STARTDATE │Not used │ ├──────────┼─────────────────────────────────────────────┤ │LASTDATE │Not used │ ├──────────┼─────────────────────────────────────────────┤ │LASTMAIL │Not used │ ├──────────┼─────────────────────────────────────────────┤ │DISK525 │Logic field to indicate the user needs 5 1/4 │ │ │format diskette. Check the box if TRUE. │ └──────────┴─────────────────────────────────────────────┘ ═══ 6.3. The Billing Database And Screen. ═══ The following is a discussion of the billing database and screen. ┌──────────┬─────────────────────────────────────────────┐ │Fields │Description │ ├──────────┼─────────────────────────────────────────────┤ │BILL_TO │Who is to pay for the registration │ ├──────────┼─────────────────────────────────────────────┤ │REG_NO │Product Registration Number billed for │ ├──────────┼─────────────────────────────────────────────┤ │ADDRESS1 │Bill address │ ├──────────┼─────────────────────────────────────────────┤ │ADDRESS2 │Same │ ├──────────┼─────────────────────────────────────────────┤ │CITY │Bill City │ ├──────────┼─────────────────────────────────────────────┤ │STATE │Bill State or Province │ ├──────────┼─────────────────────────────────────────────┤ │ZIP │Bill ZIP or Postal Code │ ├──────────┼─────────────────────────────────────────────┤ │COUNTRY │Bill Country │ ├──────────┼─────────────────────────────────────────────┤ │PAID │Logic switch. If TRUE then the bill has been │ │ │paid. When TRUE this record WILL NOT show up│ │ │on the aging report. │ ├──────────┼─────────────────────────────────────────────┤ │HOWPAID │Indicates check number or credit card number.│ ├──────────┼─────────────────────────────────────────────┤ │WHENPAID │Date of payment │ ├──────────┼─────────────────────────────────────────────┤ │AMOUNT │Amount billed or paid. │ └──────────┴─────────────────────────────────────────────┘ ═══ 6.4. The Service Database And Screen. ═══ The following is a discussion of the service database and screen. Services are companies that take your registration order and bill the customer. A month or two later they mail you a check, less their take. I highly recommend CIS and PsL. ┌──────────┬─────────────────────────────────────────────┐ │Fields │Description │ ├──────────┼─────────────────────────────────────────────┤ │NAME │Service name │ ├──────────┼─────────────────────────────────────────────┤ │ADDRESS1 │Service Address │ ├──────────┼─────────────────────────────────────────────┤ │ADDRESS2 │Same │ ├──────────┼─────────────────────────────────────────────┤ │CITY │City │ ├──────────┼─────────────────────────────────────────────┤ │STATE │State or province │ ├──────────┼─────────────────────────────────────────────┤ │ZIP │ZIP or Postal Code │ ├──────────┼─────────────────────────────────────────────┤ │PHONE │What it is │ ├──────────┼─────────────────────────────────────────────┤ │CONTACT │Person to contact at service │ └──────────┴─────────────────────────────────────────────┘ ═══ 7. You want the source. ═══ The VisPro/Rexx source code is available. SEND $25.00 (US currency only, CHECK or MONEY ORDER, NOT CASH) to: RegShare Source. American Coders LTD POB 97462 Raleigh, NC 27624 Make the check payable to AMERICAN CODERS, LTD. All you get is the source program at this time there is no documentation. Obviously you will need the VisPro/Rexx Product. Contact HockWare in Cary NC or call your mail order software house.