home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / z.lbr / ZLUX.HZP / ZLUX.HLP
Encoding:
Text File  |  1991-11-18  |  8.9 KB  |  168 lines
  1. ;
  2.                                     ZLUX.COM                                  
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. ZLUXKMD.COM    5k (34)  AFEB   2.6        John Poplett 4/88        Z3COM13
  6. ZLUXINT.COM    6k (48)  D8BD   2.7        John Poplett 4/90        Z3COM14
  7. ZLUXINTV.COM   6k (48)  75CA   2.7        John Poplett 4/90        Z3COM14
  8.  
  9.   1- Syntax  2- Commands  3- Assembly  4- Notes                               
  10.  
  11.    ZLUX  is a ZCPR3 Shell for RCP/Ms which imitates the functions of  LUX  but 
  12. with less of the overhead required to run.   Rather than use special  LUX*.COM  
  13. support utilities,  it utilizes standard utilities that are commonly available 
  14. on an RCP/M, namely: TYPEL.COM and SD.COM.  
  15.  
  16.    Several versions exist:  ones supporting either KMD or XMODEM protocols and
  17. ones containing or not  containing  an  optional  internal directory function.
  18. ZLUXINT.COM is compiled with the internal directory option & no  TCAP support, 
  19. and ZLUXINTV.COM is compiled with the internal directory and TCAP support.  
  20. :1
  21.  
  22.  
  23.     Syntax    ZLUX [DIR: or DU:]ufn[.lbr/arc/ark/lzh/zip]
  24.  
  25.               (DIR: and DU: are system-dependent)
  26.  
  27.  
  28.    ZLUX's menu of functions include:   BYE,  CAT (display all libraries on all 
  29. drive/user areas),  CHAT,  DIR,  FILES,  HELP, LUX, SEND, SENDK, TYPE and PWD.
  30. The file  transfer program must support 1k packet transfers and TYPEL (renamed
  31. to TYPE) and SD (renamed to DIR) must be available on-line.   ZCPR3's  message
  32. buffer,  external command line,  shell stack and  external  fcb  must  also be 
  33. available.   ZLUX should  be installed  with  Z3INS,  renamed to  LUX.COM  and 
  34. installed on A0:.  
  35.  
  36.    ZLUX will "attach" itself to most of the modern archive types:  .LBR, .ARC,
  37. ARK, .LZH (created by the MS-DOS LHARC program), and  .ZIP (a VERY popular MS-
  38. DOS format).   Of course,  you will need to obtain directory and ASCII display  
  39. programs for these different types.   LHVW.COM  will take  care of  .LZH files 
  40. (both directory and ASCII typing), ZIPDIR will give a directory of .ZIP files.
  41. As of this writing, there is no program to display an  ASCII member of  a .ZIP 
  42. file.
  43. :2
  44.  Commands 
  45.  
  46.             BYE       logoff computer
  47.             CAT       display all lib/arc/lzh/zip files on system
  48.             CHAT      page system operator
  49.             DIR       display members of current lib/arc/lzh/zip file
  50.             FILES     display lib/arc/lzh/zip files on current DU
  51.             HELP      display this message
  52.             LUX       attach to another lib/arc/lzh/zip file
  53.                 ZLUX      same as the LUX command
  54.             SEND      send a lib/arc/ark member
  55.             SENDK     send a lbr/arc/ark member 1K packets
  56.             TYPE      type an ASCII lib/arc/ark/lzh member
  57.             PWD       list avail directories
  58.     
  59.                     Exit LUX with ^C
  60. :3
  61.  Assembly 
  62.  
  63.    ZLUX assembles with M80 and requires  R. Conn's SYSLIB.REL,  Z3LIB.REL, and 
  64. VLIB.REL to assemble.   You must link in  SLUDIR11.REL ahead of SYSLIB.REL  if 
  65. you want to  assemble ZLUX with  the internal directory option.   SLUDIR11.REL 
  66. has an important fix to  the LUDIR  module in  SYSLIB.   Linking  SLUDIR11.REL 
  67. ahead of SYSLIB will ensure  the  correct operation of the  internal directory 
  68. function.
  69.  
  70.    To compile with M80/L80  (make sure  SYSLIB.REL,  VLIB.REL,  Z3LIB.REL, and 
  71. SLUDIR11.REL are on the same drive/user as ZLUX.Z80):
  72.  
  73.      A>M80 =ZLUX27.Z80/Z
  74.      A>L80 /P:0100,ZLUX27,ZLUX27/N/E
  75.  
  76.    When finished, run it through Z3INS to install it for your system.
  77. :4
  78.  ZLUX Notes - 1/5 
  79.  
  80.    a. Vs. 2.7 updates (04/21/90, Mark Motley):
  81.       - Now ZLUX will attach itself to .LZH and .ZIP files (although,  at this
  82.         time one cannto type members of a .ZIP file)
  83.       - Added use of  VLIB  routines to  display  text  in  both  regular  and 
  84.         standout mode, as well as clear the screen between commands.   Unfort-
  85.         unately,  the program exceeds the  4k guidline  (weighing in at around 
  86.         5000 bytes,  without the internal directory).   If  you  want  to save 
  87.         code, disable the VLB equate.
  88.  
  89.    b. Vs. 2.6 updates (04/25/88, Larry Sonderling):
  90.       - Added code to allow renaming  program as  desired without re-assembly.
  91.       - Also now works with .ARK files in same way as .ARC files.
  92.  
  93.    c. Vs. 2.5 updates (12/4/86, J. Popplet)
  94.       - Fixed bug in inline routine that has  been plagueing ZLUX  since V2.2.
  95.         The  original inline routine expanded tabs with  spaces  but  placed a 
  96.         single tab character in the line buffer.   Attempts to backspace after 
  97.         a tab would hang the system.
  98.  ZLUX Notes - 2/5 
  99.  
  100.       - NEW optional internal directory function.  Although an internal direc-
  101.         tory runs slightly counter to the original intention of ZLUX,  i.e. to
  102.         make  maximum use of external utilities,  the internal directory is  a 
  103.         great deal faster than, say,  SDXX, and therefore, warranted.  Purists 
  104.         can of course stick to the original and used  an external program  for 
  105.         display of library directories.  
  106.       - Bruce Morgen's fix to the SYSLIB  SLUDIR module,  SLUDIR11.Z80  was/is 
  107.         used for assembling ZLUX25 w/the internal directory option.
  108.       - Joubert Berger contributed an improvement to the CTRL-E function.
  109.  
  110.    d. Vs. 2.4 updates (5/27/86, Norman Beeler):
  111.       - Incorporated .ARC file capability into ZLUX,  using  UNARC utility for
  112.         DIR and TYPE commands.   Fully automatic determination of LBR/ARC file
  113.         file presence.   No syntax differences in the commands.  No KMD/XMODEM
  114.         ARC file transfer at present time (although its being worked).
  115.         Shortened and  re-worded  internal  ascii statements to keep  pgm less 
  116.         than 4k...
  117.  ZLUX Notes - 3/5 
  118.  
  119.    e. Vs. 2.3 (Multi-user/RASVersion) updates (4/26/86, J. Popplet):
  120.       - Makes sure that the  FILE command and  LUX  command use the drive/user
  121.         area of the attached library file as the default.   Thus,  when a user
  122.         invokes the program from  a  DU different from the  DU  of the library 
  123.         file, the  FILES  command will give  the correct directory and the LUX
  124.         command will default to the correct DU.
  125.       - Control-R function,  which  emulates the BDOS  line  editing function,
  126.         added to the command line editor so that users can display the command
  127.         buffer.  Particularly useful in the event of line noise. 
  128.       - Line editor now recognizes  a semicolon  as  a comment delimiter  a la 
  129.         CP/M and ZCPR3.   To complement this function, the line editor altered
  130.         not to delete an entire line when a user types passed the buffer.  
  131.       - The size of command line buffer has been enlarged.
  132.       - Conditional assembly  equates  to  allow  ZLUX  to  pass  unrecognized 
  133.         commands to the CCP and have ZLUX use an external help menu instead of 
  134.         its internal one.  Please note that this option does not use the ZCPR3
  135.         HELP utility on purpose because TYPE will  return the user to the ZLUX 
  136.         command line.  HELP does not.  The file ZLUX.HLP is, however, compati-
  137.         ble with HELP.
  138.  ZLUX Notes - 4/5 
  139.  
  140.    f. Vs. 2.2 updates (03/31/86, Bruce Morgen):
  141.       - Now has full  ZCPR3 environment obedience, including acceptance of DU:
  142.         form, maximum drive and user, etc.  
  143.       - New features include support for traditional XMODEM and KMD file send-
  144.         ing syntax, a new PWD command  (a must for getting  around on  systems 
  145.         that don't accept DU: form), one-keystroke (?) help command, protected 
  146.         line editor buffer,  unsupported  control characters don't  get to the 
  147.         command line, etc., etc.
  148.       - Translated to Z80 (Zilog) mnemonics.
  149.       - Sections of code optimized to  take  advantage of  the new instruction
  150.         set.   Many sections whittled down.   Internal subroutines replaced by
  151.         SYSLIB and Z3LIB equivalents wherever possible AND desireable.e
  152.       - Added BDOS line editing capability (control R,U,X processing) and line
  153.         length limiter to ZLUX's command line editor.  Also, added recognition
  154.         of semicolon as a comment delimiter. 
  155.       - Added recognition of two-digit user areas by re-working the PARSE sub-
  156.         routine.  
  157.       - Added assembly time conditional option that  allows  non-ZLUX commands
  158.         to be passed to ZCPR3 for processing 
  159.  ZLUX Notes - 5/5 
  160.  
  161.    g. Vs. 2.1 updates (3/24/86, Bruce Morgen):
  162.       - Eliminated unnecessary and dangerous play with  user-defined  bytes in
  163.         Z3 message buffer - Z-Msg/METAL and some versions of the ZCPR3 CCP use
  164.         these bytes for security-related functions.   ZLUX no longer has to be
  165.         the only shell on the stack either.
  166.       - Reformatted to standard Z3 tool source file (use M80 or modified RMAC)
  167.         and deleted transcribed Z3LIB routines from this file.
  168.