home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / ENTERPRS / CPM / UTILS / S / ZCCPC128.ARK / zccpdoc.doc < prev    next >
Text File  |  1993-02-06  |  13KB  |  301 lines
  1. ZCCP Documentation, Version 1.0
  2. by Randy Winchester <randy@mit.edu>
  3.  
  4. ZCCP Features
  5.  
  6. This documentation is provided to assist the user in getting a 
  7. ZCCP system up and running.  It is not an exhaustive course on Z- 
  8. System or ZCPR.  The following list details which ZCPR features 
  9. are provided with ZCCP, and which ones aren't.
  10.  
  11. * ZCPR 3.3 compatibility.  ZCCP can run a wide range of utilities 
  12.   an applications created for ZCPR 3.3 and ZCPR 3.4.
  13.  
  14. * TCAP.  A Z3T termcap file describing terminal characteristics 
  15.   can be loaded into the system.  Z-System programs make use of the 
  16.   TCAP for output to the screen - a big improvement over the old 
  17.   method of patching individual programs with terminal control 
  18.   codes.  TCAP files are loaded by the ZCCP LOADSEG command.
  19.  
  20. * Named directories.  Up to 12 user areas can be assigned names.
  21.   Named Directory Registers (*.NDR files) are loaded by the ZCCP
  22.   LOADSEG command.
  23.  
  24. * Command Search Path.  ZCCP will search for commands along a 
  25.   user defined search path.  Up to six path elements 
  26.   (directories) can be defined.
  27.  
  28. * Environment block.  Contains TCAP, Named Directory, and Path 
  29.   information.  Also includes a map of active disk drives and 
  30.   other system information.  The environment block can be viewed 
  31.   with the Z-System SHOW utility.
  32.  
  33. * Flow control.  Conditional processing for batch files.  Relies 
  34.   on Z-System IF.COM for setting the flow state.  Other flow 
  35.   control commands (FI, ELSE, XIF, OR, AND) are resident.
  36.  
  37. * Multiple commands can be entered on the command line.  The 
  38.   command line buffer will hold up to 225 characters.  Commands 
  39.   should be separated by semicolons.
  40.  
  41. * Extended Command Processor.  If a command is not a built-in 
  42.   flow command, resident command, or located on disk along the 
  43.   search path, the command line is passed to an extended command 
  44.   processor.  A typical extended command processor is ARUNZ, a 
  45.   sophisticated batch file executor with alias features.  To use 
  46.   a program as an extended command processor, rename it to 
  47.   CMDRUN.COM and place it in the ROOT directory of your boot disk.
  48.  
  49. * Error handler.  In the event that the extended command 
  50.   processor can't handle a command, control is passed to an error 
  51.   handler.  Error handlers give information about the error 
  52.   (instead of the useless CP/M "?" message) and allow the command 
  53.   line to be edited and reused.
  54.  
  55. * Resident commands.  The following commands are built in:
  56.     CLS  - clears the screen
  57.     NOTE - text following the NOTE command is treated as a 
  58.            comment.
  59.     FI   - Flow control:  terminate the current IF level
  60.     ELSE - Flow control:  toggle the flow state
  61.     XIF  - Flow control:  exit all pending IF levels
  62.     OR   - Flow control:  OR IF tests to set flow state
  63.     AND  - Flow control:  AND IF tests to set flow state
  64.  
  65. * Shell stack.  Up to four shell levels can be defined.  Z-System
  66.   provides a choice of several different shells.  Applications such 
  67.   as terminal programs and word processors can also be assigned 
  68.   shell status.
  69.  
  70. * ZCCP uses the LOADSEG command for direct loading of RSX files 
  71.   that have not been GENCOMed.  Example: LOADSEG SAVE.RSX loads 
  72.   SAVE.RSX.
  73.  
  74. There are some things that Z3Plus will do that ZCCP won't do.  
  75.  
  76. - ZCCP does not support a Flow Command Package (FCP).  It relies 
  77.   on the transient IF command.  Other flow commands (FI, ELSE, XIF, 
  78.   OR, AND) are resident in ZCCP.
  79.  
  80. - A Resident Command Package (RCP) is not implemented.  CLS and 
  81.   NOTE are resident in ZCCP.  All other commands must be loaded 
  82.   from disk.  This isn't as much of a handicap as it might sound 
  83.   if you have a fast RAM drive to store frequently used commands.
  84.  
  85. - ZCCP can not load type 4 programs (used with ZCPR 3.4).  It 
  86.   loads standard COM files at 100H, and type 3 programs that load 
  87.   in high memory.  Most type 4 programs have type 3 or COM 
  88.   equivalents, so this should not be a problem.
  89.  
  90. - ZCCP can not reexecute loaded programs.  This trick is usually 
  91.   performed on Z-Systems with a GO command that jumps to 100H.  
  92.   Since ZCCP also loads at 100H, a GO command would only restart 
  93.   ZCCP.
  94.  
  95. ZCCP Files
  96.  
  97. Three files are included in ZCCP.ARK:
  98.  
  99.  File name      Size  Description
  100.  ============   ====  ==========================================
  101.  CCP     .COM   3k    ZCCP replacement for CCP.COM
  102.  LOADSEG .COM   3k    Loader for named directories and termcaps
  103.  ZINSTAL .ZPM   1k    Segment containing environment information
  104.  
  105. Getting Started - Preparing a Boot Disk
  106.  
  107. Format a system boot disk using the same proceedure that you normally
  108. would.
  109.  
  110. Copy the files from ZCCP.ARK to user area 0 of the newly 
  111. formatted disk.
  112.  
  113. Copy CPM+.SYS (some systems may use a slightly different name for this
  114. file) to user 0 of the boot disk.  The CPM+.SYS must include the BDOS
  115. segments from ZPM3.  Use the ZPM3 MAKEDOS utility to overlay your
  116. system file with ZPM3.  (Commodore 128 users must generate a new
  117. system using the ZPM3 BDOS segments.  The MAKEDOS utility does not
  118. work properly on a C128.)
  119.  
  120. Locate a copy of a Z-System alias utility.  A good one is 
  121. SALIAS16, although others should work also.  Copy it to user 0 of 
  122. the boot disk.
  123.  
  124. At this point, reboot the system with the new system disk.  After the
  125. system boots, you won't be able to do much with it.  The only resident
  126. commands are CLS and NOTE, and ZCCP can only locate commands if they
  127. are prefixed with the drive and user number.
  128.  
  129. The next step is to create a startup alias.  When ZCCP boots, it 
  130. looks for a file named STARTZPM.COM and executes commands from 
  131. it.  STARTZPM.COM is created with a ZCPR alias utility.  Here is 
  132. a listing of a STARTZPM.COM created with SALIAS:
  133.  
  134.      =============================================================
  135.  
  136.      A0>SALIAS STARTZPM
  137.  
  138.      15:                ; Logs the ROOT directory (A15) on the 
  139.                         ; current drive.
  140.  
  141.      LOADSEG NAMES.NDR TCAP.Z3T
  142.                         ; LOADSEG loads the Named Directory Register
  143.                         ; and TCAP.
  144.                         ; Directories can now be referred to by 
  145.                         ; name, as in the next command:
  146.  
  147.      SETPTH10 /C COMMANDS RAM2 WORK $$$$ $$0 ROOT
  148.                         ; SETPTH sets the command search path.  
  149.                         ; The /c option first clears any existing path.
  150.                         ; Directories are then listed in the 
  151.                         ; order searched.  In this case, COMMANDS 
  152.                         ; is a 64K ramdisk (drive/user F0) where
  153.                         ; frequently used commands are stored.  RAM2 is 
  154.                         ; an additional RAM disk. (drive/user M0).
  155.             ; WORK is a standard 3.5" floppy disk
  156.                         ; drive, (drive/user C15) where some 700K 
  157.                         ; of utilities and applications are 
  158.                         ; located.  $$$$ refers to the currently 
  159.                         ; logged drive and user area.  $$0 refers 
  160.                         ; to user area 0 of the current drive.  
  161.                         ; The ROOT directory is on drive A, user 
  162.                         ; 15, where startup utilities and system 
  163.                         ; files can be found.
  164.  
  165.      AUTOTOG ON         ; Turns on keyboard control of ZPM3 Auto 
  166.                         ; Command Prompting.  Auto Command 
  167.                         ; Prompting is toggled by entering CTRL-Q.
  168.  
  169.      COMMANDS:          ; Logs the commands directory.
  170.  
  171.      IF ~EXIST CP.*     ; Test to see if commands are loaded.  
  172.                         ; This line reads:  "If the CP command 
  173.                         ; does not exist . . ." and sets the flow 
  174.                         ; state to true if the file doesn't exist.
  175.         C1:CP C1:*.* F0:
  176.                         ; ". . . copy all of the commands in 
  177.                         ; drive/user C1 to the commands (F0) 
  178.                         ; directory . . ."
  179.      FI                 ; ". . . end if."
  180.  
  181.      ROOT:              ; Log the root directory (A15).
  182.  
  183.      CP C:ZF*.* M0:     ; Copy ZFILER.COM and ZFILER.CMD to the 
  184.                         ; REU2 directory (M0).
  185.  
  186.      VERROR             ; Install VERROR error handler.
  187.  
  188.      DATE S             ; Set the system time and date.
  189.  
  190.      ZF                 ; Invoke ZFILER as a shell.
  191.  
  192.      =============================================================
  193.  
  194. Of course, your STARTZPM alias will vary depending on the 
  195. hardware you need to support, your software preferences, and your 
  196. work habits.  This alias is close to the upward size limit that 
  197. ZCCP can handle based on the capacity of the multiple command 
  198. buffer.  At the very least, I recommend an alias that will set up 
  199. a search path and load a TCAP.
  200.  
  201. Actually, I put the cart before the horse in this example.  If 
  202. you try to reboot your system with the LOADSEG command as listed, 
  203. you'll notice that you don't have a NAMES.NDR file.  There isn't 
  204. one distributed with ZCCP either.  Z-System utilities won't let 
  205. you edit the NDR either, since the buffer for it hasn't been 
  206. created yet.  This turned out to be a nasty chicken/egg 
  207. situation, hopefully solved by the inclusion of a sample 
  208. NAMES.NDR file containing simply A0:SYSTEM and A15:ROOT.
  209.  
  210. At this point, you should have a mostly functioning ZCCP system disk.
  211. Reboot the system with the new disk.  You might want to correct any
  212. problems with it or tweak it to perfection before moving on.
  213.  
  214. List of Z-System Utilities for ZCCP
  215.  
  216. Some of the following utilities are essential, others are nice to
  217. have.  The version numbers listed are the latest known versions at the
  218. time that this documentation was written.  Utilities can be found on
  219. ZNode BBSs, and some of them are available on Internet anonymous ftp
  220. sites (Simtel20 or its mirror sites).
  221.  
  222. SALIAS16  - already mentioned in the example above.  SALIAS (or 
  223. one of the other ZCPR alias utilities) are essential.
  224.  
  225. SD138B    - excellent DIRectory utility.  SD offers many 
  226. different types of sorts, list formats, etc., displays date 
  227. stamps, and supports output to a file.
  228.  
  229. MKDIR32   - utility for manipulating directory names and Named 
  230. Directory Register (*.NDR) files. 
  231.  
  232. ERASE57   - erases files.
  233.  
  234. ZFILER10  - a file management shell that can launch applications.  
  235. It is programmable in that it can execute user defined macros 
  236. from a file.  Multiple files can be "tagged" and operated on by 
  237. other programs.  ZFILER is an excellent program, sort of a GUI 
  238. desktop without the slow graphics.
  239.  
  240. SETPTH10  - used to set the command search path.  Essential!
  241.  
  242. VERROR17  - error handler that displays the command line for 
  243. reediting.  VERROR17 is the only error handler that I found that 
  244. works with ZCCP.
  245.  
  246. ZEX50     - Z-System EXecutive is a powerful batch file processor 
  247. that replaces the CP/M SUBMIT command.
  248.  
  249. LBRHLP22  - Z-System Help utility displays help files.  Help 
  250. files can be crunched (*.HZP), and/or loaded from a HELP.LBR 
  251. library.
  252.  
  253. ARUNZ09   - runs an alias script from a text file.  ARUNZ is 
  254. frequently used as an extended command processor.  To use ARUNZ 
  255. (or any other executable utility) as an extended command 
  256. processor, rename it to CMDRUN.COM.
  257.  
  258. VLU102    - Video Library Utility views or extracts files from 
  259. libraries.  Versions of VLU above 1.02 do not work reliably with 
  260. ZPM3/ZCCP.
  261.  
  262. Z33IF16   - is the IF.COM discussed in the section on flow control.
  263.  
  264. SHOW14    - displays an immense amount of information about your 
  265. Z-System.  SHOW also includes a memory patching function.
  266.  
  267. ZCNFG24   - configures Z-System program options.  Most Z-System 
  268. programs are distributed with a configuration (*.CFG) file that 
  269. produces a menu of configuration options when run with ZCNFG.
  270.  
  271. ZP17      - Z-System Patch utility edits files, disk sectors, or 
  272. memory, and includes a built-in RPN calculator and number base 
  273. converter.
  274.  
  275. ZMAN-NEW  - This is a manual describing Z-System features in 
  276. depth.  It is based on earlier versions of Z-System, and is a 
  277. little dated, but otherwise contains information that you won't 
  278. find anywhere else.  Not everything in the manual applies to 
  279. operation of ZPM3/ZCCP, but with the documentation presented 
  280. here, you should be able to get a good idea of what works and 
  281. what doesn't.
  282.  
  283. A TCAP termcap file for your system - This file is essential if you
  284. want to use any ZCPR programs that need a TCAP.
  285.  
  286. ZCCP Technical Notes
  287.  
  288. ZCCP is a replacement CCP that implements ZCPR 3.3.  It loads at 
  289. 100H and is stored in the bank 0 CCP buffer for fast reloading as 
  290. does the standard CCP.  By contrast, Z3Plus loads into high 
  291. memory and can be overwritten by transient commands, requiring 
  292. reloading Z3Plus from disk.  Because ZCCP replaces the CCP, a 
  293. ZCCP system has more TPA (transient program area) than a Z3Plus 
  294. system.  A ZCCP system on the C128 has more than 57K of TPA, 
  295. almost the same amount as a standard C128 CP/M system.
  296.  
  297. This should be enough information to get started with ZPM3/ZCCP.  
  298. Set up a boot disk, experiment with some Z-System utilities, read 
  299. ZMAN-NEW, and get some applications running.  You'll agree that 
  300. ZPM3/ZCCP breaths new life into CP/M.
  301.