home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / beehive / zcat / w20.lbr / W.HZP / W.HLP
Text File  |  1991-01-31  |  4KB  |  129 lines
  1. ;
  2.  
  3.                               -- W --
  4.  
  5.                         O -- Overview of W
  6.  
  7.                            U -- Using W
  8.  
  9.              P -- Potential Problems and Current Limitations
  10. :O
  11. OVERVIEW
  12.  
  13. Program: W
  14.  
  15. Syntax:  
  16.     
  17.     W ProgramName AFN parm(1) .. parm(n)
  18.                   or
  19.     W ZEX ZexFileName AFN parm(1) .. parm(n)
  20.     
  21. Function:
  22.  
  23.     W is a ZCPR3 shell that enables wildcard processing for programs that do 
  24.     not usually accept ambiguous file names (AFN).
  25.  
  26. Options:  None
  27.  
  28. Comments:  
  29.     
  30.     W may be invoked directly by typing a command at the system prompt, or 
  31.     indirectly through the use of a program that builds a command line, e.g., 
  32.     VALIAS or ZEX.  The program name that it takes as its first argument may 
  33.     name a transient program, resident program or alias.  The AFN must appear 
  34.     immediately after the program name, or, when being used with ZEX, after 
  35.     the zex file name.
  36.  
  37. Selected Error Messages:  None
  38.  
  39. Example of Use:
  40.     
  41.     W Type *.doc
  42.         Types all document files in current directory.
  43.     
  44.     W Ins *.com 
  45.         If "Ins" is an alias expanded to "Z3INS sys.env $1", all 
  46.         ZCPR3 programs in the current directory would be installed.
  47.     
  48. :U  
  49. USING W
  50.  
  51. Installing W
  52.  
  53. Like other ZCPR3 utilities, W.COM must be installed using Z3INS.COM and 
  54. SYS.ENV before it is used.
  55.  
  56.  
  57. Aborting W in the Middle
  58.  
  59. Pressing the <ESCAPE> key will cause W to abort.  Press it several times at 
  60. about the time that the program you are executing under W is ending.  A 
  61. successful abort will produce the <W aborted> message.
  62.  
  63. Since programs differ in their reaction to random console input, a short 
  64. delay was included at the beginning of each invocation of the W shell ( that 
  65. is as W is creating each of its command lines. ) This delay is user settable 
  66. by changing the QSEC equate in W20.Z80 and reassembling (QSEC represents the 
  67. delay in quarter-seconds, so a value of 4 would be a 1 second delay).  The 
  68. default is a QSEC value of 1 or a .25 second delay, which should be adequate. 
  69.  
  70. Using W with Programs having a Different Syntax
  71.  
  72. Some programs have a syntax different than W requires.  In such cases an 
  73. alias can be constructed that rearranges the command line in a form suitable 
  74. for W.  
  75.  
  76. For example, the resident command CP does not take wildcards.  Since CP 
  77. expects a parameter in the form F1.T1=F2.T2, W cannot handle it directly.  So 
  78. we concoct an alias called CPAL as follows (in ARUNZ script format):
  79.  
  80.     CPAL CP $2=$1.
  81.  
  82. Thus "CPAL SYS.ENV B:" yields a command of
  83.   
  84.     CP B:=SYS.ENV.
  85.  
  86. NOW we can run CPAL with W as follows:
  87.  
  88.      W CPAL *.* B: 
  89.     
  90. which copies all files on A: to B:.
  91. :P
  92. POTENTIAL PROBLEMS AND CURRENT LIMITATIONS
  93.  
  94. Number of Parameters
  95.  
  96. No more than 6 parameters can follow W, including the command name and the 
  97. AFN.
  98.  
  99.  
  100. Command Line Length
  101.  
  102. The total length of the command line invoking W, including the 'W', but not 
  103. including the AFN and its trailing space must not be greater than 32 
  104. characters long.
  105.  
  106.  
  107. Location of W Along the Path
  108.  
  109. To work properly, W  be in the current directory or along the ZCPR3 path.  It 
  110. cannot be invoked with the DU: or DIR: form (e.g.,  A10:W or UTIL:W).  If it 
  111. is, it will not be able to reinvoke itself after building the first command 
  112. line.  
  113.  
  114.  
  115. W and Other Shells
  116.  
  117. The result of using W to invoke other shells is not known and such use is 
  118. discouraged.
  119.  
  120.  
  121. W and the Shell Stack
  122.  
  123. W uses two spaces on the shell stack.  One to store its name  so that it can 
  124. be reinvoked after executing each command line it builds and the other to 
  125. store the name of the next file that matches the AFN.  Since many ZCPR3 
  126. systems have 4 shell stack spaces available, there should be room to run W in 
  127. most situations.
  128.  
  129.