;
                                  Z3LOC.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               2k (16)   6169  1.9        Bruce Morgen 2/91        Z3COM12

  1- Syntax/Options  2- Z-Option Information  3- Notes  4- Examples of Use    


   Z3LOC locates  and  displays  the  addresses  of  the running ZCPR3 Command
Processor Replacement, BDOS, and BIOS.  It may  also  be  run  under  CP/M  to 
locate and  display  the  addresses  of  the  running CP/M 2.2 Console Command
Processor, BDOS, and BIOS.   Only 2k in size  (for benefit  of ramdisk/floppy-
only users).

   Vs 1.0 (5/18/84) by R. Conn, derived from CCPLOC 1.1 (6 Jan 83).
:1
   Syntax   Z3LOC o

   Option   Z     <-- display addresses and data on ZCPR3 
                      system segments and data areas    

   The Z  option  will  also give 1) the address, if active, of the lowest RSX 
and the DateStamper, 2) the  lengths  of  loadable  packages, the command line 
buffer  and  path  and 3) the  DOS, CCP and microprocessor type.  The Z option 
should not be used when running under CP/M 2.2.
:2
 Z3LOC Z Option Address Information 

   External Path                 Resident Command Package

   Input/Output Package          Flow Command Package

   Named Directory Buffer        Command Line Buffer

   Shell Stack                   Environment Descriptor

   External FCB                  ZCPR3 Message Buffer

   External Stack                Wheel Byte

   RSX (if one is active)
:3 
 Z3LOC Notes - 1/4 

   a. Version 1.9 updates (2/23/90, Bruce Morgen):
      - Shrunk the thing back down a bit.  Just 'cuz  SYSLIB 3.6  has no  DSEG
        doesn't mean we can't put our  stack there.  Used relative jumps where
        we're SURE to have a Z80-compatible CPU,  Z80.LIB now required for M80
        or RMAC (SLRMAC has it "built-in").
      - A two-pass linker is now required to re-build  Z3LOC,  a one-pass tool
        like PROLINK will add 50 bytes to the COMfile, pushing it over 2k.
      - The program banner now shows the  "official" tool  name  (Z3LOC),  the
        syntax help message still uses the  EFCB name when available.  This is
        in accordance with standard practice in the toolset.   Otherwise  v1.9
        is functionally and cosmetically identical to v1.8, but its COMfile is
        2 records shorter (2K) when linked  with SYSLIB 3.6  (the last version
        where the routines we reference are 8080-compatible).  
      - An "RMAC" equate has been added since that  assembler  won't  accept a
        "MACLIB" directive where there is a filetype, and M80 won't work with-
        out that filetype (SLRMAC probably won't care).
 Z3LOC Notes - 2/4 

   b. Version 1.8 updates (Joe Wright):
      - Changed order around so that SHSTK is before Z3ENV.
      - Changed RSX calculation for variable CCP and DOS sizes.

   c. Version 1.7 udpates (Joe Wright):
      - Added intelligent 'help' so that re-naming of this file shows up in 
        the banner and help messages.  
      - Re-formatted help message.
      - Renamed TOP-1 message to CBIOS and print it only if extended ENV.

   d. Version 1.6 updates (3/19/88, Cameron W. Cotrill):
      - Changed DOS ID to use enhanced BDOS version function and report ZRDOS,
        ZSDOS, Z80DOS, or ZOS properly.

   e. Version 1.5 updates (2/14/88):
      - Report names of RSX and IOP.
      
   f. Version 1.4 updates (1/27/88, Joe Wright):
      - Howard Goldstein released 1.3 earlier, hence the change.
 Z3LOC Notes - 3/4 

   g. Version 1.3 updates (1/19/88, Howard Goldstein):
      - Z3LIB no longer used, link with SYSLIB only.
      - Added local stack.  CP/M CCP doesn't have enough stack for us.
      - NZ-COM support added.
      - Re-ordered the various reports in NZ-COM sequence.
      - Added elements/size to Shell Stack report.
      - Test for 'extended'  environment.   Report from there if so.  Extended
        Z3ENV has bit 7 of byte 8 set to 1.
      - Cleaned up some code.

   h. Version 1.2 updates (1/12/88, Bruce Morgen):
      - To report addresses correctly, no longer relies on BDOS jump vector.
      - Added RSX display line (if one is detected).
      - Display lengths of FCP, RCP, NDR, command line, and path.
      - Display DateStamper address if DS is running.  
      - Display CPU type after BIOS address.  
      - Display decent guess at CCP type  after its  address,  ditto  ZRDOS or
        CP/M version number.
      - Refuse "Z" option if Z3LOC is uninstalled or running in a non-Z3ENV.
 Z3LOC Notes - 4/4 

      - Assembles with Kluger-modified RMAC, M80 or (probably) SLRMAC, any 
        8080-compatible versions of Z3LIB and SYSLIB should link up just fine.

   i. Version 1.1 updates (Joe Wright):
      - to report addresses correctly.
:4
 Examples of Use - 1/2 

   a. A0>Z3LOC

Z3LOC, Version 1.9  Z-System Address Locator
System  Elements   Base  Addresses
----------------   ---------------
    CCP            C700h (ZCPR 3.4)      (16 recs)
    BDOS           CF06h (ZSDOS 1.0)     (28 recs)
    BIOS           DD00h (Z80/NSC800)    (NZ-COM)
    DateStamper    EE50h

   b. A0>:Z3LOC Z
 Examples of Use: - 2/2  

Z3LOC, Version 1.9  Z-System Address Locator
System  Elements   Base  Addresses
----------------   ---------------
    (same as previous example, plus:)

    IOP            [Not implemented]
    RCP            DE00h (16 recs)
    FCP            E600h (4 recs)
    NDR            E800h (14 names)
    SHSTK          EA00h (4 32-byte entries)
    Z3ENV          E900h (Type 80h)
    Z3TCAP         E980h (A2E-PCPI)
    Z3MSG          EA80h
    EXTFCB         EAD0h
    EXPATH         EAF4h (5 elements)
    Z3WHL          EAFFh (On)
    Z3CL           EB00h (203 chars)
    EXTSTK         EBD0h
    CBIOS          F100h
