home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / rexx / ntrexx / readme next >
Text File  |  1994-06-15  |  6KB  |  161 lines
  1.  
  2.                                rxsh
  3.  
  4.                      Pre-Release version 0.0.1
  5.  
  6.  
  7.                             *   *   *
  8.                              +--+--+
  9.                               +===+
  10.  
  11.  
  12.                 A Rexx-aware command shell for the
  13.             Microsoft Windows NT v3.5 Operating System
  14.  
  15.  
  16.        Copyright (c) 1994  Wm. Potvin II  All Rights Reserved.
  17.  
  18.  
  19. rxsh is a command shell much like cmd.exe which includes support for
  20. the execution of Rexx EXECs via Quercus Systems Personal Rexx for
  21. Windows NT.  This functionality is *NOT* available via the IBM OS/2
  22. Rexx implementation; rxsh *requires* Personal Rexx for Windows NT.
  23.  
  24. rxsh has been compiled and link-edited under MS Windows NT v3.5 and
  25. the SDK for that system.  rxsh has *NOT* been tested with Windows NT
  26. v3.1, so it may or may not work on that system.  rxsh has been tested
  27. with the most recent Beta release of Quercus Systems Personal Rexx
  28. for Windows NT as well as with the most recent Beta release of my
  29. merxutil function package for Personal Rexx for Windows NT.  rxsh does
  30. not in and of itself require my merxutil function package, however
  31. that function package does provide access to many Windows NT system
  32. services from a Rexx EXEC.  For more information, down load the help
  33. file for the merxutil function package from the Quercus Library on
  34. PCVENA in Library 11 on Compuserve.
  35.  
  36. rxsh is meant to compliment the rexx.exe program which ships with
  37. Personal Rexx for Windows NT.  rxsh will *NOT* run an EXEC which is
  38. specified on the command line, i.e. "c:\>rxsh myexec.rex".  To do
  39. that, use the rexx.exe program that ships with Personal Rexx.
  40.  
  41. To run rxsh, simply execute the program either from a cmd.exe command
  42. line, or by double-clicking the rxsh.exe file via File Manager, or by
  43. using the File|Run menu option in either the Program Manager or the
  44. File Manager.  You may optionally create a PIF file for rxsh and
  45. install it in a Program Manager Group.  A sample PIF file, as well as
  46. a sample icon file are provided in this distribution.
  47.  
  48. To quit rxsh, type either "exit" or "quit" on the command line.  Note
  49. that, as with cmd.exe, any changes made to the environment via SET
  50. commands persist only for the life of the current shell.  rxsh also
  51. recognizes the more common prompt strings such as $p, $g, $t, $d, $l,
  52. $$ and $_, plus introduces a couple of it's own:
  53.  
  54.     $u - prints USERID env var, or username if USERID does not exist
  55.     $c - prints the computer name on which rxsh was started.
  56.  
  57. Thus, you might set a prompt such as:
  58.  
  59.     rxsh c:\>set prompt=$u on $c in $p at $t on $d$_$$
  60.  
  61. which would produce the following, (for example):
  62.  
  63.     rxsh bill on mersoft in C:\ at 19:24:16.202 on Wed 1994/06/15
  64.     $
  65.  
  66. rxsh is a *preliminary* shell implementation released to determine
  67. interest.  There are many features standard in mature shells which
  68. are not present in rxsh.  For example, rxsh does not read and
  69. execute a startup file, (ala autoexec.nt).  rxsh does not offer a
  70. direct interface with the Rexx interpreter in the sense of being
  71. able to enter a command such as:
  72.  
  73.          rxsh c:\>if date('w')=='Wednesday' then say '"hump" day'
  74. or
  75.          rxsh c:\>do 5; say 'hello'; end
  76.  
  77. on the command line.  You can, however, issue cmd.exe batch language
  78. commands on the command line:
  79.  
  80.          rxsh c:\>if exist myfile.data echo found
  81.  
  82. rxsh does *NOT*, however, support the command "stacking" capability
  83. that exists in cmd.exe, i.e. "cls&dir".
  84.  
  85. This preliminary implementation of rxsh is designed only to offer a
  86. method of seamless execution of Rexx EXECs:
  87.  
  88.          rxsh c:\>myexec.rex
  89.  
  90. as opposed to having to use the rexx.exe utility:
  91.  
  92.          c:\>rexx myexec.rex
  93.  
  94. If it is determined that there is sufficient interest in rxsh, then
  95. follow-on development will progress; startup file processing will be
  96. added as will the ability to issue Rexx statements on the command
  97. line.  The "down" side to that is the fact that access to cmd.exe
  98. batch language commands from the command line will disappear.  Other
  99. enhancements such as documentation and built-in help will also be
  100. included.
  101.  
  102.  
  103. Contact Information
  104.  
  105. Please send any comments to me at either of the following addresses:
  106.  
  107.     70540,120 (from CompuServe directly)
  108.  
  109.     70540.120@compuserve.com (from the Internet)
  110.  
  111.  
  112. For information regarding Personal Rexx for Windows NT, contact
  113. Quercus Systems:
  114.  
  115.     Quercus Systems
  116.     P.O. Box 2157
  117.     Saratoga, CA 95070
  118.     (408)867-REXX (voice)
  119.     (408)867-7489 (fax)
  120.     (408)867-7488 (BBS)
  121.     Compuserve PCVENA, Library 11
  122.  
  123.  
  124. Distribution File List:
  125.  
  126.     rxsh.exe    - rxsh program
  127.     rxsh.pif    - sample PIF file
  128.     rxsh.ico    - sample icon
  129.     readme      - this file
  130.  
  131.  
  132. Warranty/Licence
  133.  
  134. This Pre-Release software is Copyright 1994 William Potvin II. All
  135. Rights Reserved.
  136.  
  137. The author of this Pre-Release software will, as revisions evolve, make
  138. those revisions available via the Compuserve Information Service in the
  139. Quercus section, (Library 11), of the PCVENA forum.
  140.  
  141. This Pre-Release software is provided by the author without any warranty
  142. of any kind, either expressed or implied, including, but not limited to,
  143. the fitness of this Pre-Release software for a particular purpose or
  144. merchantability.  The user holds all risk with respect to the quality
  145. and performance of this Pre-Release software and the user assumes all
  146. costs relative to all necessary servicing, repair or correction.
  147.  
  148. Under no circumstances will the author of this Pre-Release software be
  149. liable to the user for any damages whatsoever, including general,
  150. incidental or consequential damages resulting from the use, or from the
  151. inability to use this Pre-Release software, including, but not limited
  152. to loss of data or business profits or business interruption or a
  153. failure of this Pre-Release software to operate with any other programs
  154. or any other pecuniary loss sustained by you or third party users, even
  155. if the author has been advised of the possibility of such damages.
  156.  
  157. The general availability of this software does not in any way imply
  158. that it will ever be released as a product.  This software will remain
  159. in Pre-Release or Beta Release status at least until Personal Rexx for
  160. Windows NT is released from Beta test.
  161.