home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / z.lbr / Z3LOC.HZP / Z3LOC.HLP
Encoding:
Text File  |  1991-11-18  |  5.9 KB  |  146 lines

  1. ;
  2.                                   Z3LOC.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                2k (16)   6169  1.9        Bruce Morgen 2/91        Z3COM12
  6.  
  7.   1- Syntax/Options  2- Z-Option Information  3- Notes  4- Examples of Use    
  8.  
  9.  
  10.    Z3LOC locates  and  displays  the  addresses  of  the running ZCPR3 Command
  11. Processor Replacement, BDOS, and BIOS.  It may  also  be  run  under  CP/M  to 
  12. locate and  display  the  addresses  of  the  running CP/M 2.2 Console Command
  13. Processor, BDOS, and BIOS.   Only 2k in size  (for benefit  of ramdisk/floppy-
  14. only users).
  15.  
  16.    Vs 1.0 (5/18/84) by R. Conn, derived from CCPLOC 1.1 (6 Jan 83).
  17. :1
  18.    Syntax   Z3LOC o
  19.  
  20.    Option   Z     <-- display addresses and data on ZCPR3 
  21.                       system segments and data areas    
  22.  
  23.    The Z  option  will  also give 1) the address, if active, of the lowest RSX 
  24. and the DateStamper, 2) the  lengths  of  loadable  packages, the command line 
  25. buffer  and  path  and 3) the  DOS, CCP and microprocessor type.  The Z option 
  26. should not be used when running under CP/M 2.2.
  27. :2
  28.  Z3LOC Z Option Address Information 
  29.  
  30.    External Path                 Resident Command Package
  31.  
  32.    Input/Output Package          Flow Command Package
  33.  
  34.    Named Directory Buffer        Command Line Buffer
  35.  
  36.    Shell Stack                   Environment Descriptor
  37.  
  38.    External FCB                  ZCPR3 Message Buffer
  39.  
  40.    External Stack                Wheel Byte
  41.  
  42.    RSX (if one is active)
  43. :3 
  44.  Z3LOC Notes - 1/4 
  45.  
  46.    a. Version 1.9 updates (2/23/90, Bruce Morgen):
  47.       - Shrunk the thing back down a bit.  Just 'cuz  SYSLIB 3.6  has no  DSEG
  48.         doesn't mean we can't put our  stack there.  Used relative jumps where
  49.         we're SURE to have a Z80-compatible CPU,  Z80.LIB now required for M80
  50.         or RMAC (SLRMAC has it "built-in").
  51.       - A two-pass linker is now required to re-build  Z3LOC,  a one-pass tool
  52.         like PROLINK will add 50 bytes to the COMfile, pushing it over 2k.
  53.       - The program banner now shows the  "official" tool  name  (Z3LOC),  the
  54.         syntax help message still uses the  EFCB name when available.  This is
  55.         in accordance with standard practice in the toolset.   Otherwise  v1.9
  56.         is functionally and cosmetically identical to v1.8, but its COMfile is
  57.         2 records shorter (2K) when linked  with SYSLIB 3.6  (the last version
  58.         where the routines we reference are 8080-compatible).  
  59.       - An "RMAC" equate has been added since that  assembler  won't  accept a
  60.         "MACLIB" directive where there is a filetype, and M80 won't work with-
  61.         out that filetype (SLRMAC probably won't care).
  62.  Z3LOC Notes - 2/4 
  63.  
  64.    b. Version 1.8 updates (Joe Wright):
  65.       - Changed order around so that SHSTK is before Z3ENV.
  66.       - Changed RSX calculation for variable CCP and DOS sizes.
  67.  
  68.    c. Version 1.7 udpates (Joe Wright):
  69.       - Added intelligent 'help' so that re-naming of this file shows up in 
  70.         the banner and help messages.  
  71.       - Re-formatted help message.
  72.       - Renamed TOP-1 message to CBIOS and print it only if extended ENV.
  73.  
  74.    d. Version 1.6 updates (3/19/88, Cameron W. Cotrill):
  75.       - Changed DOS ID to use enhanced BDOS version function and report ZRDOS,
  76.         ZSDOS, Z80DOS, or ZOS properly.
  77.  
  78.    e. Version 1.5 updates (2/14/88):
  79.       - Report names of RSX and IOP.
  80.       
  81.    f. Version 1.4 updates (1/27/88, Joe Wright):
  82.       - Howard Goldstein released 1.3 earlier, hence the change.
  83.  Z3LOC Notes - 3/4 
  84.  
  85.    g. Version 1.3 updates (1/19/88, Howard Goldstein):
  86.       - Z3LIB no longer used, link with SYSLIB only.
  87.       - Added local stack.  CP/M CCP doesn't have enough stack for us.
  88.       - NZ-COM support added.
  89.       - Re-ordered the various reports in NZ-COM sequence.
  90.       - Added elements/size to Shell Stack report.
  91.       - Test for 'extended'  environment.   Report from there if so.  Extended
  92.         Z3ENV has bit 7 of byte 8 set to 1.
  93.       - Cleaned up some code.
  94.  
  95.    h. Version 1.2 updates (1/12/88, Bruce Morgen):
  96.       - To report addresses correctly, no longer relies on BDOS jump vector.
  97.       - Added RSX display line (if one is detected).
  98.       - Display lengths of FCP, RCP, NDR, command line, and path.
  99.       - Display DateStamper address if DS is running.  
  100.       - Display CPU type after BIOS address.  
  101.       - Display decent guess at CCP type  after its  address,  ditto  ZRDOS or
  102.         CP/M version number.
  103.       - Refuse "Z" option if Z3LOC is uninstalled or running in a non-Z3ENV.
  104.  Z3LOC Notes - 4/4 
  105.  
  106.       - Assembles with Kluger-modified RMAC, M80 or (probably) SLRMAC, any 
  107.         8080-compatible versions of Z3LIB and SYSLIB should link up just fine.
  108.  
  109.    i. Version 1.1 updates (Joe Wright):
  110.       - to report addresses correctly.
  111. :4
  112.  Examples of Use - 1/2 
  113.  
  114.    a. A0>Z3LOC
  115.  
  116. Z3LOC, Version 1.9  Z-System Address Locator
  117. System  Elements   Base  Addresses
  118. ----------------   ---------------
  119.     CCP            C700h (ZCPR 3.4)      (16 recs)
  120.     BDOS           CF06h (ZSDOS 1.0)     (28 recs)
  121.     BIOS           DD00h (Z80/NSC800)    (NZ-COM)
  122.     DateStamper    EE50h
  123.  
  124.    b. A0>:Z3LOC Z
  125.  Examples of Use: - 2/2  
  126.  
  127. Z3LOC, Version 1.9  Z-System Address Locator
  128. System  Elements   Base  Addresses
  129. ----------------   ---------------
  130.     (same as previous example, plus:)
  131.  
  132.     IOP            [Not implemented]
  133.     RCP            DE00h (16 recs)
  134.     FCP            E600h (4 recs)
  135.     NDR            E800h (14 names)
  136.     SHSTK          EA00h (4 32-byte entries)
  137.     Z3ENV          E900h (Type 80h)
  138.     Z3TCAP         E980h (A2E-PCPI)
  139.     Z3MSG          EA80h
  140.     EXTFCB         EAD0h
  141.     EXPATH         EAF4h (5 elements)
  142.     Z3WHL          EAFFh (On)
  143.     Z3CL           EB00h (203 chars)
  144.     EXTSTK         EBD0h
  145.     CBIOS          F100h
  146.