home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / s.lbr / SNAP.HZP / SNAP.HLP
Encoding:
Text File  |  1991-11-18  |  4.9 KB  |  93 lines
  1. ;
  2.                                    SNAP.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. SNAP.COM       1k (8)    5BD2  1.2        Rob Friefeld 4/90        Z3COM8
  6. SNAP.CIM       1k (8)    BB78  1.2        Rob Friefeld 4/90        Z3COM8
  7. SNAPRCP.COM    1k (4)    600A  1.1        Rob Friefeld 5/89        Z3COM8
  8. SNAPRCP.CIM    1k (4)    67C8  1.1        Rob Friefeld 5/89        Z3COM8
  9.  
  10.   1- Usage  2- Notes  3- SNAPRCP                                              
  11.  
  12.    SNAP is  based on  Bob Andersson's LAP.COM.   It saves an image of the ENV,
  13. TCAP, RCP, FCP,  IOP,  NDR, and PATH, together with a small loader to the file
  14. named on the command line.   When the output file is run,  it  puts the images 
  15. back where they came from, then calls the IOP initialization if present.   The
  16. overhead for the loader  is less  than  2 records.   For  further flexibility, 
  17. command line options permit saving only the segments wanted.   
  18. :1
  19.  
  20.  
  21.   Syntax   SNAP file[.typ] /oo...
  22.            o = (T)cap, (R)cp, (F)cp, (I)op, (N)dr, or (P)ath
  23.  
  24.    Usage   SNAP SYS         <- Save current packages to file SYS.COM
  25.            LDR OTHER.ENV,OTHER.RCP,OTHER.NDR,OTHER.FCP
  26.            SNAP OTHER       <- Save this version to OTHER.COM
  27.            SYS              <- Reload all original packages at once.
  28.            OTHER            <- Run the other configuration.
  29.            SNAP OTHERNDR /N <- Save only NDR
  30. :2
  31.  SNAP Notes - 1/3 
  32.  
  33.    a. SNAP is  not  a package relocator.   It just plugs  a  package setup back 
  34.       into memory.   If you load  snap into  an incompatible  system configura-
  35.       tion, you will crash.   (w/ NZCOM,  use  NZBLITZ or JETLDR.)   Note  that 
  36.       SNAPRCP is now obsolete.
  37.  
  38.    b. Although the space allocated  to each package may vary,  you cannot load
  39.       one size system over another with SNAP.
  40.  
  41.    c. The  same  scheme  is  followed  as  that  in  LAP.COM  -  disabling  of 
  42.       interrupts, loading the image, calling the IOP initialization routine at
  43.       IOPBASE+9, and enabling interrupts.
  44.  SNAP Notes - 2/3 
  45.  
  46.    d. Vs. 1.2 updates:
  47.       - As distributed,  SNAP will ask  whether or not to  erase  an  existing 
  48.         file.   The default list of  segments to be automatically saved can be 
  49.         configured.  (Use SNAP12.CFG with ZCNFG.COM by A. Hawley.)
  50.       - Uses internal stack (lack of one caused a crash with Kaypro TurboROM).
  51.       - New command line options.
  52.       - The package loader does some mininal error checking before overwriting
  53.         memory.   It makes sure that the current ENV descriptor is at the same 
  54.         location as the one about to be loaded.   If  an  extended environment 
  55.         has been installed, the loader then checks to see that the CCP,  BDOS, 
  56.         and BIOS have not moved.   Finally,  if only  a few segments have been 
  57.         saved, the loader insists that all of the  ENV  addresses  be the same 
  58.         currently as when the snap was taken.  If all segments were saved, the
  59.         user is allowed to load  a differently configured system.   This makes 
  60.         sense only if the large system packages (RCP,  FCP,  IOP,  NDR) occupy 
  61.         contiguous memory and are of constant total size.
  62.  SNAP Notes - 3/3 
  63.  
  64.    e. Vs. 1.1 updates:
  65.       - A patch byte at 10Dh (800Dh for CIM files) may  be set to  00 to cause
  66.         SNAP to erase  an existing file without warning.  Any character on the
  67.         command line at "o" reverses the sense of the default setting.  
  68.       - The loader does  more error checking.   In addition to making sure the
  69.         ENV descriptor is at the same address as when the image file was made,
  70.         it adds up the total  memory allotted to the  RCP,  FCP,  IOP and  NDR
  71.         packages to  make sure there's  enough room to overwrite them with the
  72.         stored image (RCP, FCP, IOP and NDR must be contiguous in memory). The
  73.         PATH size is checked separately. If a Z34 ENV is loaded, the addresses
  74.         of the CCP, DOS, and BIOS are compared.   
  75.       - The type3 version runs at 8000h and so does its output file.
  76. :3
  77.  
  78.  SNAPRCP 
  79.  
  80.    SNAPRCP saves an image of the RCP segment to  an executable COM file.   The
  81. output file will reload the RCP as long  as the system running at the time has
  82. an RCP of the same or larger size at the same address.
  83.  
  84.    Usage   SNAPRCP RCP/SYS    - Save current RCP to file RCP/SYS.COM
  85.            LDR CALC.RCP       - Load some other RCP
  86.            SNAPRCP RCP/CALC   - Save this one
  87.            RCP/SYS            - Origial RCP is back
  88.  
  89.    The advantage of using SNAPRCP is that the RCP loads very quickly.   Unless
  90. you use  a huge RCP,  it is handy to  have several packages  to load - e.g., a 
  91. file oriented  package (CP PROT  ERA REN  TYPE  LIST ...),  a  system-oriented
  92. package (P POKE REG WHL Q MOVM FILL FIND ...), etc.
  93.