home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / rexxlb.zip / READ.ME next >
Text File  |  1995-08-09  |  11KB  |  256 lines
  1. REXXLIB Read.Me
  2. Version 1.32-DEMO
  3. August 9, 1995
  4.  
  5.  
  6. === About this package...
  7.  
  8. REXXLIB is a collection of over 150 functions designed to extend the
  9. capabilities of REXX in OS/2. It covers five principal areas: compound
  10. variable handling, interprocess communication, mathematical functions,
  11. OS/2 system services, and text-mode user interfacing.
  12.  
  13. Here is a sample of what you can do with REXXLIB functions:
  14.  
  15.     * convert between different REXX date formats and do date
  16.       arithmetic
  17.     * copy, sort, or merge REXX "arrays" and compound variable
  18.       collections, and read or write them from/to disk
  19.     * make a list of all "tails" of a given compound variable
  20.     * do "regular expression" searches in strings, files, and
  21.       compound variable values
  22.     * compute CRC values for files
  23.     * change a file date/time stamp
  24.     * add commonly-used REXX routines to "macro spaces" for shared
  25.       use by other REXX programs and protection from end-user
  26.       tampering
  27.     * create and access local or remote OS/2 named pipes
  28.     * evaluate standard transcendental math functions
  29.     * obtain lists of active OS/2 applications
  30.     * create multiple threads in REXX programs
  31.  
  32. REXXLIB is commercial software, and continued use or inclusion with any
  33. other product for redistribution requires registration with Quercus
  34. Systems. The files in this package are distributed for demonstration
  35. only. However, all code is fully functional.
  36.  
  37.                     ---------- ********** ----------
  38.  
  39. THE CODE IN THIS DEMONSTRATION PACKAGE MAY BE USED FOR A TOTAL OF 30
  40. DAYS. THE TIME NEED NOT BE CONSECUTIVE - YOU MAY CONTINUE USING IT UNTIL
  41. IT HAS BEEN USED 30 DIFFERENT DAYS. AT THAT TIME THE CODE WILL CEASE TO
  42. FUNCTION, AND YOU MUST GET A REGISTERED COPY IN ORDER TO CONTINUE USING
  43. REXXLIB.
  44.  
  45.                     ---------- ********** ----------
  46.  
  47. Registration of REXXLIB entitles you to a printed manual and support.
  48. The basic level of support is available electronically through CompuServe
  49. and the Quercus Systems BBS. Hotline telephone support is also available
  50. for an extra charge.
  51.  
  52. See below for information on how to register REXXLIB.
  53.  
  54.  
  55. === Installing REXXLIB
  56.  
  57. To install REXXLIB you need only copy the .DLL files (REXXLIB.DLL and
  58. RXWIN30.DLL) to a directory named in your system LIBPATH. Alternatively,
  59. you can copy all files on the distribution disk to a new directory on
  60. your hard disk, and add that directory to your LIBPATH.
  61.  
  62. There are also online documentation files (.INF) that you can read with
  63. the VIEW command, and a number of sample programs. We recommend that you
  64. keep all of these online for easy reference while you are learning to
  65. use REXXLIB.
  66.  
  67. Before you can run any REXX programs that use REXXLIB, you must register
  68. the functions with the operating system. The following statements placed
  69. in a REXX program will do this:
  70.  
  71.     call rxfuncadd 'rexxlibregister', 'rexxlib', 'rexxlibregister'
  72.     call rexxlibregister
  73.     call rxfuncadd 'w_register', 'rxwin30', 'rxwindow'
  74.     call w_register
  75.  
  76. NOTE!!! The third argument of RXFUNCADD is case sensitive. You must
  77. enter it in lower case exactly as shown.
  78.  
  79. Instead of placing these statements in every program that uses REXXLIB,
  80. we recommend that you execute these from a REXX program that is run only
  81. once when the system is loaded. The easiest way to do this is with a
  82. STARTUP.CMD file. If you do not already have one, simply place the above
  83. lines in a file called STARTUP.CMD. Provide a REXX comment (/* ... */)
  84. as the first line of the file. And place the file in the root directory
  85. of your system boot drive. STARTUP.CMD will then run every time the
  86. system is loaded, and all of the REXXLIB functions will be registered.
  87.  
  88.  
  89. === Online documentation
  90.  
  91. Online documentation for REXXLIB consists of two .INF files. These can
  92. be read with the VIEW command, like most other online OS/2
  93. documentation. RLDEMO.INF contains complete descriptions of all REXXLIB
  94. functions except for RXWINDOW functions. RXWINDOW.INF contains the
  95. documentation for RXWINDOW functions.
  96.  
  97. We have an 87-page printed manual that contains the same descriptive
  98. information on REXXLIB functions as the online document. It also contains
  99. an overview of each of the different function groups, as well as more
  100. detailed information on certain topics, such as semaphores, named pipes,
  101. common function calling conventions, and regular expressions. You need
  102. to register REXXLIB, as described below, in order to get the printed
  103. manual.
  104.  
  105. If you would like a hardcopy reference summary of all REXXLIB functions,
  106. we highly recommend the REXX Reference Summary Handbook written by Dick
  107. Goran of CFS Nevada. This is a summary only, and is not a substitute for
  108. the REXXLIB manual, but it does cover all REXX language statements,
  109. functions, and REXX-related WorkPlace Shell usage information. The
  110. Handbook may be ordered directly from Quercus Systems.
  111.  
  112.  
  113. === Sample programs
  114.  
  115. The SAMPLES directory contains a number of sample programs that
  116. illustrate REXXLIB usage. Read the file SAMPLES.DOC in the SAMPLES
  117. directory for an overview of the purpose of each file.
  118.  
  119. One of the sample programs, called FL.CMD, is a text mode file manager
  120. program. It is fairly lengthy and provides a very good illustration of
  121. the use of RXWINDOW functions.
  122.  
  123. Note that the sample programs assume that REXXLIB functions have already
  124. been registered. The samples will not run unless you have called the
  125. REXXLIBREGISTER function as discussed above.
  126.  
  127. If you would like to contribute any programs that illustrate useful
  128. REXXLIB techniques, please feel welcome to upload them to our bulletin
  129. board or CompuServe.
  130.  
  131.  
  132. === Other Quercus Systems products
  133.  
  134. Our primary emphasis is the development of REXX-related software and
  135. tools. In addition to REXXLIB, we have Personal REXX, which is a full
  136. implementation of the REXX language for DOS, OS/2, and Windows. Personal
  137. REXX for OS/2 includes all of the functions in REXXLIB, and a number of
  138. additional utilities and enhancements, such as global variables and
  139. better support for external data queues. It comes with complete printed
  140. documentation, and for many applications is significantly faster than
  141. IBM's REXX.
  142.  
  143. We also have REXXTERM, which is a full-featured asynchronous
  144. communication package for DOS and OS/2. REXXTERM scripts can be written
  145. in REXX. REXXTERM provides a set of commands and functions that can be
  146. used to develop communications applications in REXX.
  147.  
  148. Please contact us by any of the means listed below if you would like a
  149. copy of our newsletter or information on any of these products.
  150.  
  151. You may also obtain further information by visiting our Web pages:
  152.  
  153.     http://www.quercus-sys.com
  154.  
  155.  
  156. === Disclaimers
  157.  
  158. Quercus Systems excludes any and all implied warranties, including
  159. warranties of merchantability and fitness for a particular purpose, and
  160. limits your remedies to return of the software and manual to the
  161. location of original retail sale for replacement or refund. Quercus
  162. Systems specifically excludes any warranty coverage for incidental and
  163. consequential damages.
  164.  
  165. We have provided this demonstration version of REXXLIB so that you can
  166. test the product thoroughly before any personal or commercial use. It is
  167. entirely your responsibility to ensure, when REXXLIB is used in
  168. conjunction with software you supply, that the combined product
  169. functions acceptably and does not cause undesirable side effects such as
  170. loss of data. In no case will Quercus Systems be responsible for damages
  171. alleged to be caused by your software in conjunction with REXXLIB.
  172.  
  173.  
  174. === Registering REXXLIB
  175.  
  176. Two types of single-user registration are available:
  177.  
  178. 1. Basic registration: includes an 87-page printed manual and
  179.    electronic technical support through CompuServe and our bulletin
  180.    board. The price is $20.
  181.  
  182. 2. Full registration: includes hotline telephone and fax support, and
  183.    priority service electronically, as well as the printed manual. This
  184.    also includes the rights to redistribute REXXLIB as part of an
  185.    application. The price is $50.
  186.  
  187. A $3 shipping and handling fee (for U. S. customers) and any applicable
  188. sales taxes will be added to all orders. For special handling or
  189. customers outside the U. S., please contact us for the exact fee.
  190.  
  191. A basic registration can be upgraded at any time to a full registration
  192. by payment of the difference in price current at the time of upgrade.
  193.  
  194. Multiple copy discounts and site licensing terms are available by
  195. arrangement with Quercus Systems.
  196.  
  197. You may place orders by credit card (Master Card, VISA, or Amex) using
  198. any of the following:
  199.  
  200.     1. Telephone: (408) 867-7399
  201.     2. Fax: (408) 867-7489
  202.     3. Quercus Systems Bulletin Board: (408) 867-7488
  203.        (Send a message to "SYSOP".)
  204.     4. CompuServe: send mail to 75300,2450
  205.     5. Internet: send mail to 75300.2450@compuserve.com
  206.  
  207. Please include your phone number, credit card number, and expiration
  208. date with any credit card order.
  209.  
  210. For company POs please contact Quercus Systems for approval.
  211.  
  212. Orders with payment by credit card or check (U. S. funds only, drawn on
  213. a U. S. bank) may also be sent to:
  214.  
  215.     Quercus Systems
  216.     P. O. Box 2157
  217.     Saratoga, CA 95070
  218.  
  219.  
  220. === Redistribution policy
  221.  
  222. This REXXLIB demo package may be freely redistributed as long as all
  223. files are included and nothing is modified in any way. You may not
  224. include the demo package as a whole as part of another product, except
  225. for products, such as CD-ROMs, which consist entirely of demonstration
  226. software, shareware, or the like. If you distribute the demo package by
  227. itself you may not charge more than a reasonable amount as a copying
  228. fee. For a disk containing only REXXLIB, this would be at most $5.
  229. Please contact Quercus Systems for permission in other cases, such as
  230. inclusion with books.
  231.  
  232. The executable portions (only) of REXXLIB may be included with
  233. commercial, "shareware", or "freeware" application software or
  234. applications distributed "in-house" as long as you pay for one full
  235. registration and agree to the following terms and conditions:
  236.  
  237.     1. Only executable .EXE and .DLL files may be included. No other
  238.        copyrighted files of Quercus Systems (including all or any
  239.        portion of the online documentation) may be included with the
  240.        product.
  241.  
  242.     2. Included files must not be modified in any way. In particular,
  243.        embedded copyright notices must be left intact.
  244.  
  245.     3. Your documentation should explicitly state that REXXLIB is
  246.        copyrighted software belonging to Quercus Systems and is included
  247.        with your software by permission of Quercus Systems.
  248.  
  249.     4. Users of your product are not permitted to use REXXLIB except
  250.        in conjunction with your product. Any further use by an end user
  251.        (except for evaluation) requires purchase of at least a basic
  252.        registration.
  253.  
  254.     5. No part of REXXLIB may be included with other collections of
  255.        tools or libraries intended primarily for use by programmers.
  256.