home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / r.lbr / REG.HZP / REG.HLP
Encoding:
Text File  |  1991-11-18  |  2.9 KB  |  79 lines
  1. ;
  2.                                     REG.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. REG.COM        2k (12)   85E6  1.3        Howard Goldstein 8/89    Z3COM5
  6. REG.3OM        2k (12)   3D48  1.3        Howard Goldstein 8/89    Z3COM5
  7. REG.4OM        2k (15)   02A8  1.3        Howard Goldstein 8/89    Z3COM5
  8.  
  9.   1- Syntax  2- Notes  3- Error Messages  4- Examples of Use                   
  10.  
  11.  
  12.    REG  displays,  adds 1 to,  subtracts 1 from,  or loads a value  into,  the 
  13. indicated register.   A ZCPR3 Register is a one-byte buffer (values may  range 
  14. from 0 to 255 decimal).
  15.  
  16.    The value  used to indicate a register is a character from '0' to '9'.  The
  17. character '#' indicates all registers.
  18. :1
  19.  
  20.  
  21.    Syntax   REG Dr or REG r        <-- display Register
  22.  
  23.             REG Mr (or -r)         <-- Minus (Set Register r=r-1)
  24.  
  25.             REG Pr (or +r)         <-- Plus (Set Register r=r+1)
  26.  
  27.             REG Sr value           <-- Set (Set Register r=value)
  28.  
  29.    where "r" may be 0-31 for one reg, E for error flag,
  30.    # for regs 0-9 or * for all regs.
  31.  
  32.    Add Q at end of command for quiet mode.
  33. :2
  34.  Notes - 1/2 
  35.  
  36.    a. Registers  are used  1) to  support looping  in  ZEX  command files  (do 
  37.       something N  times), and  2) to  pass parameter  values from one program
  38.       to another program which is executed later.
  39.  
  40.    b. REG  has a  counterpart command  in the  System Resident Command Package
  41.       provided in the ZCPR3 distribution.
  42.  
  43.    c. Vs. 1.1 adds type  3 format  with safety header.  Illegal set values get 
  44.       error message and Program Error Flag indication.  "+" & "-" are synonyms
  45.       for "P" and "M" for increment/decrement functions.
  46.  
  47.    d. Vs 1.2  adds support  for all 32 registers plus  error flag (denoted  by
  48.       "E").  "#" still  represents regs 0-9;  "*" is 0-31.   All references to 
  49.       the system quiet flag  are removed  in  favor  of  a  "Q"  option  which 
  50.       suppresses display on set,  decrement and increment functions.   Support 
  51.       added for type-4 environment.   Load address now shown in banner on help
  52.       message.
  53.  Notes - 2/2 
  54.  
  55.    e. Vs 1.3 makes quiet mode default patchable.  Q option toggles quiet mode.
  56.       Default quiet mode is displayed in help screen.
  57. :3
  58.  Error Messages 
  59.  
  60.    Invld Reg ID:  c              <-- REG (Transient)
  61.  
  62.       - the register indicated was not symbolized by '0' to '9' or '#'
  63. :4
  64.  Examples of Use 
  65.  
  66.    a. REG S0 4     <-- reg 0 = 4
  67.       
  68.    b. REG S5       <-- reg 5 = 0
  69.    
  70.    c. REG P        <-- reg 0 = reg 0 + 1
  71.  
  72.    d. REG P5       <-- reg 5 = reg 5 + 1
  73.  
  74.    e. REG M9       <-- reg 9 = reg 9 - 1
  75.  
  76.    f. REG D        <-- show values
  77.  
  78.    g. REG          <-- show values  
  79.