home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / os2 / 4os2b.zip / README.DOC < prev    next >
Text File  |  1993-12-16  |  19KB  |  407 lines
  1.  
  2.                                   JP Software
  3.  
  4.                            4OS2 Shareware README.DOC
  5.  
  6.                        Version 2.0 -- December 16, 1993
  7.  
  8.  
  9.    [Copyright 1992 - 1993, JP Software Inc., All Rights Reserved. 
  10.    Published by JP Software Inc., P.O. Box 1470, E. Arlington, MA 02174
  11.    USA, (617) 646-3975.  4OS2, 4OS2/16, and 4OS2/32 are trademarks and 4DOS
  12.    is a registered trademark of JP Software Inc.  OS/2 is a trademark of
  13.    IBM Corporation.  Other product and company names are trademarks of
  14.    their respective owners.]
  15.  
  16.  
  17.    Greetings, and thanks for trying 4OS2!
  18.  
  19.    This file contains a variety of information you should read before using
  20.    4OS2, including:
  21.  
  22.       * Changes in version 2.0          * Technical support
  23.       * Files included with 4OS2        * Bulletin board support
  24.       * Installation instructions       * Shareware and ASP policies
  25.       * Upgrading from 4OS2 1.x
  26.  
  27.    If you have tried a shareware copy of 4OS2 and want to place an order,
  28.    or if you'd like to find out about our other products (including our
  29.    enhanced command processors for DOS and Windows NT:  4DOS and 4DOS/NT),
  30.    see the product and ordering information in the file ORDERINF.DOC, or
  31.    call us at (800) 368-8777 (USA only, orders only please!) or (617) 646-
  32.    3975.  The order form is included separately in the file ORDER.FRM.
  33.  
  34.    For complete installation instructions, see page 4.  These instructions
  35.    cover installation procedures for both new users and those upgrading
  36.    from a previous version of 4OS2.  
  37.  
  38.    The license agreement which governs your use of 4OS2 is included
  39.    separately in the file LICENSE.DOC.  Please read it before ordering. 
  40.    The text is written in plain English, and clearly explains your rights
  41.    and responsibilities as a user of 4OS2.  For more information on the
  42.    shareware system under which you obtained this copy of 4OS2, see page 6.
  43.  
  44.    This file, like all 4OS2 ASCII documentation files, is formatted at 58
  45.    lines per page, and contains form feeds and page footers.  It can be
  46.    viewed with a file viewer such as the 4OS2 LIST command, or printed on
  47.    most PC printers using the command:
  48.  
  49.             copy readme.doc prn
  50.  
  51.    Printing it with a program that formats the pages is not likely to work
  52.    due to the formatting included in the file.
  53.                                                                (12/93-2.0A)
  54.  
  55.  
  56.  
  57.    4OS2 2.0  [12-16-93]           README.DOC                         page 1
  58.  
  59.  
  60.    Changes in Version 2.0
  61.  
  62.       Be sure to read the installation instructions in this file before
  63.       installing 4OS2 !
  64.  
  65.       Version 2.0 is a major new release of 4OS2.  It coincides with
  66.       similar major releases of our other command processors:  4DOS version
  67.       5.0 and 4DOS for Windows NT version 2.0.
  68.  
  69.       If you are a current 4OS2 user, be sure to check over the list of
  70.       changes in this version, in the file UPDAT20.DOC, BEFORE you begin
  71.       using version 2.0!  The list below gives only a very small sample of
  72.       what's new in this version.  If you're a new 4OS2 user, you can skip
  73.       UPDAT20.DOC.
  74.  
  75.       Major new features in this version include:
  76.  
  77.           "Ranges" allow you to select files for processing based on the
  78.           date and / or time a file was last modified, or the file's size.
  79.  
  80.           .BTM files can now be compressed, to make it easier for PC and
  81.           network managers to distribute batch files whose contents cannot
  82.           readily be altered by the end user.
  83.  
  84.           The maximum file description length has been increased to 200
  85.           characters.
  86.  
  87.           You can select the colors used for command line input.
  88.  
  89.           There is a popup directory history window which shows recent
  90.           directories you've used (this was available in version 1.11, but
  91.           was not documented in the manual).
  92.  
  93.           There is a new filename completion window which allows you to pop
  94.           up a pick-list window of all the matching files, and insert a
  95.           selected filename into the command line.
  96.  
  97.           DO is a new loop control command for batch files.  
  98.  
  99.           KEYBD is a new command to toggle the state of the Caps Lock, Num
  100.           Lock, and Shift Lock keys.
  101.  
  102.           LIST has been completely rewritten and offers many new features.
  103.  
  104.           ON is a new error-handling command for batch files.
  105.  
  106.           There are dozens of new variables and variable functions for use
  107.           in batch files and aliases.
  108.  
  109.           The help system has been extensively revised to offer more
  110.           complete information.
  111.  
  112.  
  113.  
  114.  
  115.    4OS2 2.0  [12-16-93]           README.DOC                         page 2
  116.  
  117.  
  118.    Files Included with 4OS2 2.0
  119.  
  120.       Please note that the way your copy of 4OS2 is "packaged" will vary
  121.       depending on the distribution method (5.25" disk, 3.5" disk, or on-
  122.       line).  In general there will be one 5.25" 1.2MB disk, or one 3.5"
  123.       720K disk.
  124.  
  125.       On-line copies will be in three .ZIP files.  Part "A" consists of
  126.       files specific to the 16-bit or 32-bit version, and will be in
  127.       4OS216.ZIP or 4OS216A.ZIP (16-bit), and 4OS232.ZIP or 4OS232A.ZIP
  128.       (32-bit).  You only need to download the file for the version you use
  129.       (see below, or see the 4OS2.DOC file for more details on 16-bit and
  130.       32-bit versions of 4OS2).  Part "B", the files which are the same for
  131.       both the 16-bit and 32-bit versions, will be in 4OS2B.ZIP or
  132.       4OS220B.ZIP.
  133.  
  134.       In addition, you may choose to download the 4DOS, 4OS2, and 4DOS/NT
  135.       Reference Manual (the file is named REFMAN.DOC, and is typically
  136.       stored in the file JP4REF.ZIP).  This is a large file and much of the
  137.       same information is available in the online help system, but we do
  138.       make the ASCII version of the manual available for those who wish to
  139.       download it.
  140.  
  141.       ZIP files distributed by JP Software will display the message
  142.       "Authentic files Verified!   # VHJ325   JP Software Inc." when they
  143.       are unzipped.  If you do not see this message, the ZIP file you are
  144.       using has been modified.  This does not necessarily indicate a
  145.       problem (for example, some BBS sysops "brand" 4OS2 with their BBS
  146.       name using software from us; 4OS2 ZIP files on these BBSes will not
  147.       show the JP Software verification message).  However it does alert
  148.       you to the fact that the file has been changed since it was created
  149.       by JP Software.
  150.  
  151.       The following files are included with this version of 4OS2:
  152.  
  153.           4OS2.EXE*           4OS2 program file
  154.           4OS2.DOC            ASCII copy of the 4OS2 Introduction and
  155.                               Installation Guide
  156.           4OS2.INF            4OS2 help text for use with OS/2's VIEW.EXE
  157.           4OS2A.ICO*          A sample 4OS2 icon (see page ? for more
  158.                               information)
  159.           4OS2B.ICO*          Another sample 4OS2 icon
  160.           4OS2H.MSG           4OS2 quick-help text (for "/?" help)
  161.           ALIASES             Sample aliases
  162.           BATCOMP.EXE         Batch file compression utility
  163.           LICENSE.DOC         The 4OS2 shareware license agreement
  164.           ORDER.FRM           4OS2 shareware and upgrade order forms 
  165.           ORDERINF.DOC        Ordering and product information
  166.           README.DOC          This file
  167.           REFMAN.DOC          4DOS, 4OS2, and 4DOS/NT combined reference
  168.                               manual (must be downloaded separately, see
  169.                               above)
  170.  
  171.  
  172.  
  173.    4OS2 2.0  [12-16-93]           README.DOC                         page 3
  174.  
  175.  
  176.           SAMPLES.BTM         Sample 4OS2 batch files (all samples are
  177.                               included in one file)
  178.           SHRALIAS.EXE*       Utility program for retention of global alias
  179.                               and history lists
  180.           SUPPORT.BBS         Information on Channel 1, the independent BBS
  181.                               used for 4OS2 support
  182.           SYSOP.DOC           4OS2 information for BBS sysops
  183.           TOUR1.BTM           Batch file used for the 4OS2 "tour" (see
  184.             and TOUR2.BTM       TOUR.DOC)
  185.           TOUR.DOC            The 4OS2 Guided Tour documentation
  186.           UPDAT20.DOC         Information on changes in 4OS2 2.0
  187.           VENDOR.DOC          4OS2 information for shareware disk vendors
  188.  
  189.             * Files marked with an asterisk differ between the 16-bit and
  190.             32-bit versions of 4OS2.  If you have a diskette copy, for each
  191.             file marked above there are two files on the shareware disk,
  192.             and the appropriate file is extracted and renamed during the
  193.             installation process.  If you have a downloaded copy, your copy
  194.             will contain either the 16-bit or 32-bit files, but not both;
  195.             in this case no renaming is necessary.
  196.  
  197.  
  198.    Installation Instructions
  199.  
  200.       (These instructions do not cover diskette installation, because when
  201.       4OS2 is installed from diskette this file is not visible until after
  202.       installation is complete.)
  203.  
  204.       Whether or not you presently have 4OS2 installed, create a new
  205.       directory for 4OS2 2.0 (do not install it in the same directory as a
  206.       previous version of 4OS2).  Decompress your downloaded 4OS2 2.0 files
  207.       into this directory.  You can print the 4OS2 Introduction and
  208.       Installation Guide, or any 4OS2 documentation file (including this
  209.       one), by copying it to the printer with the COPY command.
  210.  
  211.       Please note that the 4OS2 Introduction and Installation Guide is
  212.       about 30 pages long, and the Reference Manual is over 380 pages long! 
  213.       If you don't want to print these files they can be viewed on-screen
  214.       with a file viewer such as the 4OS2 LIST command.  Most of what's in
  215.       the Reference Manual is also available in the 4OS2 help system.
  216.  
  217.       For a guided tour of 4OS2 features see the instructions in TOUR.DOC. 
  218.       To install 4OS2 completely, follow the manual installation
  219.       instructions in Chapter 1 of 4OS2.DOC, disregarding the discussion of
  220.       extracting files from the diskettes.
  221.  
  222.       If you install 4OS2 manually, be sure to read the notes in chapter 1
  223.       of the Introduction and Installation Guide about modifying the
  224.       BOOKSHELF environment variable to make 4OS2's full cross-referenced
  225.       help work properly, and about modifying the DPATH variable to make
  226.       the "/?" quick help work properly.
  227.  
  228.  
  229.  
  230.  
  231.    4OS2 2.0  [12-16-93]           README.DOC                         page 4
  232.  
  233.  
  234.       4OS2 comes with both 16-bit and 32-bit versions.  If you have a
  235.       diskette copy of 4OS2 with our automated installation program, the
  236.       correct version is installed automatically.  If you have a downloaded
  237.       copy of 4OS2, be sure you have the correct version for your system
  238.       before beginning the installation process, as the 16-bit and 32-bit
  239.       versions are uploaded separately.  In general you should use the 16-
  240.       bit version for OS/2 1.x and 2.0, and the 32-bit version for OS/2 2.1
  241.       and above.  See the 4OS2 Introduction and Installation Guide for
  242.       further details.
  243.  
  244.       If you are using the 16-bit version of 4OS2 and upgrade to the 32-bit
  245.       version, be sure to replace all the 16-bit files with their 32-bit
  246.       equivalents -- don't use some 16-bit files and other 32-bit files, or
  247.       4OS2 will not work properly.
  248.  
  249.  
  250.    Upgrading from 4OS2 Version 1.0, 1.1, or 1.11 to Version 2.0
  251.  
  252.       Be sure to go over the changes in version 2.0, in the file
  253.       UPDAT20.DOC, before you start using it.  4OS2 2.0 can be run in "test
  254.       drive" mode over previous versions of 4OS2, so you can test the new
  255.       version before fully installing it.  4OS2 2.0 should always be
  256.       installed in a different directory than any earlier version of 4OS2.
  257.  
  258.       To upgrade from 4OS2 1.x to version 2.0, make the following changes
  259.       in your system configuration:
  260.  
  261.           * Modify the SET OS2_SHELL line in your OS/2 2.x CONFIG.SYS file
  262.             (or the PROTSHELL line in your OS/2 1.x CONFIG.SYS file) to
  263.             reflect the new directory where 4OS2.EXE is stored.  Make a
  264.             similar modification to the SET COMSPEC statement in
  265.             CONFIG.SYS.
  266.  
  267.           * If you keep any 4OS2 startup or exit files (4OS2.INI, 4START,
  268.             or 4EXIT) in your 4OS2 directory, be sure to move or copy the
  269.             old files into the directory where 4OS2 2.0 is stored.  (If the
  270.             files are in the root directory of the boot drive they do not
  271.             need to be moved.)
  272.  
  273.           * Be sure that any OS/2 objects which explicitly name 4OS2.EXE
  274.             (rather than using the "*" to start the default command
  275.             processor) are modified to reflect the new directory where
  276.             4OS2.EXE is stored.  See the 4OS2 Introduction and Installation
  277.             Guide for complete details on using settings for OS/2 and 4OS2
  278.             objects.
  279.  
  280.           * Obtain a copy of the BRAND program which came with your
  281.             registered copy of 4OS2 version 1.x, put it in the same
  282.             directory as the 4OS2 version 2.0 files.  Run it and follow the
  283.             on-screen instructions to install your name and serial number
  284.             into 4OS2.  The information needed to BRAND your copy is on the
  285.             small blue or yellow "Brand ID Card" which came with your copy
  286.  
  287.  
  288.  
  289.    4OS2 2.0  [12-16-93]           README.DOC                         page 5
  290.  
  291.  
  292.             of 4OS2.  If you cannot find this card with your branding
  293.             codes, you can order a replacement from JP Software for $5.
  294.  
  295.       Once you've made these changes, you can reboot your system and you'll
  296.       be running 4OS2 2.0.
  297.  
  298.  
  299.    Technical Support
  300.  
  301.       We support 4OS2 in our own CompuServe area, section 10 of the PC
  302.       Vendor B forum (GO PCVENB).  If you are not currently a CompuServe
  303.       subscriber, consider a special offer CompuServe has made to 4OS2
  304.       users:  call 1-800-848-8199 (outside the US and Canada call 614-457-
  305.       0802) and ask for operator 178 to receive a free CompuServe
  306.       introductory membership, including user ID, password, and a $15
  307.       connect time credit.
  308.  
  309.       For technical support on the Internet send mail to
  310.       75300.1215@compuserve.com.
  311.  
  312.       Support is also available by phone (617-646-3975), fax (617-646-
  313.       0904), and mail (JP Software, PO Box 1470, E. Arlington, MA 02174). 
  314.       Telephone support hours and availability may vary depending on our
  315.       current staffing pattern and workload; there may not always be a
  316.       support representative available when you call, in which case we will
  317.       take a message and call you back.  We return calls as soon as
  318.       possible, and our normal policy is to return all calls within at most
  319.       24 hours (weekends and holidays excluded).
  320.  
  321.  
  322.    Bulletin Board Support for 4OS2
  323.  
  324.       4OS2 product support is always available on our support BBS, Channel
  325.       1 in Boston.  Channel 1 is an independent BBS (not operated by JP
  326.       Software) which has generously offered to provide a home for 4OS2 BBS
  327.       support.  Phone 617-354-5776 to access Channel 1 at 2400 - 14,400
  328.       baud (no parity, 8 data bits, 1 stop bit).
  329.  
  330.       If you have access to a local bulletin board which is a member of any
  331.       of the major BBS networks (RIME / PC Relay, ILink, SmartNet, or
  332.       FidoNet), you can discuss 4OS2 with other users, and obtain limited
  333.       support from JP Software, by leaving messages in the network's "4DOS"
  334.       conference.
  335.  
  336.  
  337.    Shareware Copies of 4OS2
  338.  
  339.       If you obtained 4OS2 from a shareware disk vendor, an on-line
  340.       computer service or bulletin board, a friend or colleague, or another
  341.       similar source, you have an unregistered (trial) copy.  As the
  342.       copyright holder for this software, JP Software allows and encourages
  343.       you to use this trial copy without charge for a limited period of
  344.  
  345.  
  346.  
  347.    4OS2 2.0  [12-16-93]           README.DOC                         page 6
  348.  
  349.  
  350.       time, under the terms of our license agreement (see LICENSE.DOC). 
  351.       After this time is up, you must purchase (register and pay for) the
  352.       product to continue using it.
  353.  
  354.       This method of distribution is known as shareware.  It allows you to
  355.       determine whether the product meets your needs before you pay for it.
  356.  
  357.       Payment of the shareware registration fee for 4OS2 entitles you to a
  358.       complete copy of the product with typeset-quality printed and bound
  359.       manuals; the ability to download an upgrade to the next major release
  360.       of the product; continued technical support via electronic mail or
  361.       telephone; and a subscription to "The Prompt Solution", JP Software's
  362.       customer newsletter.
  363.  
  364.  
  365.    Other JP Software Products
  366.  
  367.       JP Software offers other products which complement 4OS2, like the
  368.       4OS2 Utility Disk, and the Personal REXX language for powerful batch
  369.       file extensions.  For more information, see the product and ordering
  370.       information in the file ORDERINF.DOC, or call us at (800) 368-8777
  371.       (USA only, orders only please!) or (617) 646-3975.  An order form is
  372.       included separately in the file ORDER.FRM.
  373.  
  374.  
  375.    Association of Shareware Professionals
  376.  
  377.       The authors and publisher of 4OS2 are members of the Association of
  378.       Shareware Professionals (ASP), an organization formed to strengthen
  379.       the future of shareware.  Its members, all of whom are programmers
  380.       who subscribe to a code of ethics, are committed to the concept of
  381.       shareware as a method of marketing.
  382.  
  383.       The ASP sets standards for its members and their shareware products
  384.       which provide that programs produced by ASP members must be fully
  385.       documented, non-crippled, and offered with at least a minimum level
  386.       of support.  It also sets standards for shareware disk vendors and
  387.       provides information to the public about shareware.
  388.  
  389.  
  390.    ASP Ombudsman Statement
  391.  
  392.       JP Software is a member of the Association of Shareware Professionals
  393.       (ASP).  ASP wants to make sure that the shareware principle works for
  394.       you. If you are unable to resolve a shareware-related problem with an
  395.       ASP member by contacting the member directly, ASP may be able to
  396.       help. The ASP Ombudsman can help you resolve a dispute or problem
  397.       with an ASP member, but does not provide technical support for
  398.       members' products.  Please write to the ASP Ombudsman at 545 Grover
  399.       Road, Muskegon, MI 49442 or send a CompuServe message via CompuServe
  400.       Mail to ASP Ombudsman 70007,3536.
  401.  
  402.  
  403.  
  404.  
  405.    4OS2 2.0  [12-16-93]           README.DOC                         page 7
  406.  
  407.