home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / zsys / znode-12 / s / z3help08.lbr / REG.HZP / REG.HLP
Encoding:
Text File  |  1993-06-12  |  2.6 KB  |  80 lines
  1. ;
  2.                                     REG.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. REG.COM        2k (11)   A302  1.2        Howard Goldstein 1/89    Z3COM5
  6. REG.3OM        2k (11)   BD20  1.2        Howard Goldstein 1/89    Z3COM5
  7. REG.4OM        2k (14)   80C1  1.2        Howard Goldstein 1/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.  
  35. REG Notes:
  36.  
  37.    a. Registers  are used  1) to  support looping  in  ZEX  command files  (do 
  38.       something N  times), and  2) to  pass parameter  values from one program
  39.       to another program which is executed later.
  40.  
  41.    b. REG  has a  counterpart command  in the  System Resident Command Package
  42.       provided in the ZCPR3 distribution.
  43.  
  44.    c. Vs. 1.1 adds type  3 format  with safety header.  Illegal set values get 
  45.       error message and Program Error Flag indication.  "+" & "-" are synonyms
  46.       for "P" and "M" for increment/decrement functions.
  47.  
  48.    d. Vs 1.2  adds support  for all 32 registers plus  error flag (denoted  by
  49.       "E").  "#" still  represents regs 0-9;  "*" is 0-31.   All references to 
  50.       the system quiet flag  are removed  in  favor  of  a  "Q"  option  which 
  51.       suppresses display on set,  decrement and increment functions.   Support 
  52.       added for type-4 environment.   Load address now shown in banner on help
  53.       message.
  54. :3
  55.  
  56.  
  57. Error Messages:
  58.  
  59.    Invld Reg ID:  c              <-- REG (Transient)
  60.  
  61.       - the register indicated was not symbolized by '0' to '9' or '#'
  62. :4
  63.  
  64.  
  65. Examples of Use:
  66.  
  67.    a. REG S0 4     <-- reg 0 = 4
  68.       
  69.    b. REG S5       <-- reg 5 = 0
  70.    
  71.    c. REG P        <-- reg 0 = reg 0 + 1
  72.  
  73.    d. REG P5       <-- reg 5 = reg 5 + 1
  74.  
  75.    e. REG M9       <-- reg 9 = reg 9 - 1
  76.  
  77.    f. REG D        <-- show values
  78.  
  79.    g. REG          <-- show values  
  80.