home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / c.lbr / CMD.HZP / CMD.HLP
Encoding:
Text File  |  1991-11-18  |  4.1 KB  |  80 lines
  1. ;
  2.                                   CMD.COM                                     
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. CMD.COM        2k (12)   B8EE  1.4        Bruce Morgen 4/91        Z3COM2
  6. CMD.3OM        2k (12)   4C79  1.4        Bruce Morgen 4/91        Z3COM2
  7. CMD.4OM        2k (16)   C82C  1.4        Bruce Morgen 4/91        Z3COM2
  8.  
  9.   1- Syntax  2- Notes  3- Examples of Use  4- CMDPATCH.Z80                    
  10.  
  11.    CMD  is  used  to define and run a command line.   It  either  accepts  the 
  12. command line (including semicolons) which follow the verb CMD into the command 
  13. line  buffer or,  if no input is provided,  it prompts the user for input  and 
  14. then  places this into the command line buffer.   Vs 1.0 (7/19/84) by R. Conn.
  15.  
  16.    The  problem  that CMD addresses is the case where the main  program  in  a 
  17. shell  sequence  knows nothing about shells,  and it is desired to  leave  the 
  18. sequence sometime.   CMD provides this out.  It was built specifically for use 
  19. with the SHSET command, although it may find other applications.
  20. :1
  21.  
  22.    Syntax    CMD cmd1&cmd2;... or CMD (prompted input)
  23.  
  24.    The sequence of commands "cmd1;cmd2;..." becomes the command line.
  25.  
  26.    Accepts the '&' substitute command separator and aborts  the current shell,
  27. if any, if a Ctrl-C is entered in prompted mode.
  28. :2
  29.  CMD Notes - 1/2 
  30.  
  31.    a. CMD sets the ERROR message of  ZCPR3,  so that programs on down the line
  32.       can determine if input was made when CMD was run.   If the  user  simply
  33.       strikes a RETURN in response to the  CMD prompt,  an error is indicated.
  34.       Tests can later be made,  like  IF ERROR,  to  check  this  and make the
  35.       command flow change depending on the outcome.
  36.  
  37.    b. Version 1.4 updates (3/23/91, Bruce Morgen):
  38.       - Major change in prompted operation  --  CMD now reinvokes itself after
  39.         each command until an  empty  command  line  (a  RETURN  alone)  or  a
  40.         Control-C is entered.  Control-C also exits the current shell (if any)
  41.         as in Version 1.3.   In this way,  CMD can act like an  MS-DOS or UNIX 
  42.         "secondary shell" invocation for true  Z-System  shells as well as for
  43.         "ZCPR2-style" shells like MEX with MEX2Z or Sage-modified WS4.
  44.  
  45.    c. Version 1.3 updates (8/16/88, Bruce Morgen):
  46.       - Pre-release tweak to shell name printing code.
  47.  CMD Notes - 2/2 
  48.  
  49.    d. Version 1.2 updates (3/9/88, Bruce Morgen):
  50.       - Now accepts the  "&"  substitute  command  separator  and  aborts  the
  51.         current shell, if any, if a control-C is entered in prompted mode.  
  52.       - Prompt shows current shell instead of silly "Noname" message.
  53.       - Z33 type format with safety header, Z80 code with SYSLIB4 and DSEG.
  54. :3
  55.  Examples of Use 
  56.  
  57.    a. SHSET MU3;CMD       <-- This will run MU3, allow the user to do what 
  58.                               he wants, and then reenter MU3.  'SHCTRL POP' 
  59.                               would  pop the shell stack and break the 
  60.                               'MU3;CMD' loop.
  61. :4
  62.                               CMDPATCH.Z80 
  63.  
  64.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  65.                                1.0        Jay Sage 4/87            Z3UTIL10
  66. ==============================================================================
  67.  
  68.    CMDPATCH.Z80 is  an overlay  which patches  two changes into version 1.0 of 
  69. CMD.  The  first change  makes it reset  the shell  bit in  the message buffer 
  70. command status  flag so  that the external or  internal error  handler will be 
  71. invoked for  bad commands.  Before,  the error  was treated  as a shell error, 
  72. which resulted  in the  entire shell  stack being  cleared.  The second change 
  73. eliminates  the  extra space  after the  prompt character  '>' in  the command 
  74. prompt.  This extra space was confusing in cases where one wanted deliberately 
  75. to enter a command with  a leading  space to  force invocation  of the  ZCPR33 
  76. extended command processor.
  77.  
  78.    CMDPATCH.Z80 should  be assembled  to  a HEX  file  and overlaid on CMD.COM 
  79. using the MLOAD command line: MLOAD CMDNEW=CMD.COM,CMDPATCH1.
  80.