home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / q.lbr / QLUX.HZP / QLUX.HLP
Encoding:
Text File  |  1991-11-18  |  8.5 KB  |  199 lines

  1. ;
  2.                                    QLUX.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. QLUX.COM      19k (145)  755E  1.21       Sean Sullivan 4/90       Z3COM10
  6. QLUXKMD.COM   18k (140)  EE21  1.21       Sean Sullivan 4/90       Z3COM10
  7. QLUXZMD.COM   18k (140)  0E9A  1.21       Sean Sullivan 4/90       Z3COM10
  8.  
  9.   1- Configuration  2- Notes  3- Examples of Use                              
  10.  
  11.    QLUX is a replacement for the standard LUX program.  It is written in Basic
  12. and is easily modified to use  programs  of your choice.   It  uses the multi-
  13. command line feature of ZCPR (ZCMD) and will easily adapt to most RCP/M setups
  14. including NZCOM.
  15.  
  16.    QLUX.COM is for local use,  QLUXKMD and QLUXZMD for BBS use.   Vs 1.21 adds 
  17. CR, UNCR,  LT,  READ,  VIEW, and VDE commands for the local version and a ZCMD 
  18. command for Z-System commands  not  found  in the  local  version.
  19. :1
  20.  Configuration - 1/4 
  21.  
  22.    Comment out any commands in the BASIC source you do not want to use and any
  23. parts of the help menu you do not want to be shown.   Vs. 1.21 has the command 
  24. line buffer (aka MCL) located at F500.   Change that address  and put together 
  25. with BASCOM and L80 (or whatever linker you may have - SLRNK, DLINKLOC, etc.).
  26.  
  27.  
  28. OPTIONS TO EDIT:
  29.  
  30. The following are the options that may be changed to suit your setup:
  31.  
  32. MCL=&HFC00
  33. MCL is the address of the multi-command buffer that accepts the QLUX commands.
  34. This address may  be  found on ZCPR3 (NZCOM) systems by running Z3LOC with the 
  35. 'Z' option.  If you are using ZCMD you must check the source code.
  36.  Configuration - 2/4 
  37.  
  38. DEBUG=FALSE
  39. The Debug  option sends  the  command  line to  the screen.   To  be used when
  40. commands do not work as you expect.
  41.  
  42. PASSCMD=FALSE
  43. The Passcmd option sends  all commands to the  MCL  regardless of whether they 
  44. are QLUX resident (It is up to the operating system to deal  with  the  passed 
  45. command).
  46.  
  47. LBRDIR$="DIR"
  48. Any version of the SD program will do.
  49.  
  50. ZIPDIR$="UNZIP"
  51. UNZIP099 is the latest ZIP directory program.
  52.  
  53. ARCDIR$="UNARC"
  54. UNARC16 is typically used although the later  SD  versions can display an ARC/
  55. ARK directory too.
  56.  Configuration - 3/4 
  57.  
  58. LZHDIR$="LHRD"
  59. LHRD11 is the latest version as of this date.  Also used as a LZH file typer.
  60.  
  61. MODEM$="ZMD"
  62. ZMD, KMD, NUKMD, XMODEM may be used.   It  is expected  that  the program will
  63. have the capability of sending an ARC/ARK member as well as an LBR member.
  64.  
  65. ZMODEM$="RZMP"
  66. RZMP16 is the only one available.
  67.  
  68. TYPE$="TYPE"
  69. Name your typer program to TYPE
  70.  
  71. LBRTYP$=LBRDIR$
  72. Use your standard TYPE program unless your prefer something else.
  73.  
  74. ARCTYP$=ARCDIR$
  75. UNARC16 handles both directory and file listing.
  76. Configuration - 4/4 
  77.  
  78. LZHTYP$=LZHDIR$
  79. LHRD11 handles both directory and file listing.
  80.  
  81. ZIPTYP$=""
  82. A ZIP typer program is not yet available (but is expected soon)
  83.  
  84. MENU$="MENU"
  85. Whatever name you use for your Menu program.
  86.  
  87.  
  88.  
  89. Compile:  BASCOM =QLUX110/O/E/Z/C
  90.    Link:  L80 QLUX110,QREL/S,OBSLIB/S,LUX/N/E
  91.    or     SLRNK LUX/N,QLUX110,QREL/S,/E
  92.  
  93. creates the COMfile LUX.COM.
  94. :2
  95.  QLUX Notes - 1/4 
  96.  
  97.    a. QLUX presently does not support  DU: specifications.   The  ARUNZ  alias 
  98.       "LUX  $td1$tu1:;qlux $*;$hb:",  however,  will  allow you  to  access  a 
  99.       LBR/ARC/ARK/ZIP/LZH file in  any DU:  from the ZCPR3 command A0> prompt.  
  100.       However, you will not be able to successfully access a  LBR/ARC/ARK/ZIP/
  101.       LZH file in a specific DU:  from  the QLUX command prompt.   If  you use 
  102.       this ARUNZ LUX alias approach,  it will be assumed that the program will 
  103.       be named QLUX.COM.
  104.  
  105.    b. QLUX121.COM requires the following files to be online:   DIR,  LDIR,  LT
  106.       (ZLT), NULU, LBREXT (renamed to LGET),  LPUT,  SETD,  UNARC,  ARK,  ADS,
  107.       UNZIP  (UNZIP099),  EXPLODE.OVR  (UNZIP099),  UNREDUCE.OVR   (UNZIP099),
  108.       UNSHRINK.OVR (UNZIP099),  LHRD (LH-CPM12),  LHVW (LH-CPM12), CR (CRLZH),
  109.       UNCR (UNCRLZH), and VDE (ZDE13).   UNZIP, EXPLODE.OVR, UNREDUCE.OVR, and
  110.       UNSHRINK.OVR may all have to be on  the same DU:  as the ZIP file or you
  111.       may want to rename UNZIP.COM to UNZIP099.COM and use  SETDRU to  make  a
  112.       UNZIP.COM file that makes UNZIP099.COM look for its OVR files elsewhere.
  113.  QLUX Notes - 2/4 
  114.  
  115.    c. QLUXKMD.COM and  QLUXZMD.COM requires the following files to  be online:  
  116.       DIR, LDIR, LT (ZLT), UNARC, UNZIP (ZIPDIR), LHVW (LH-CPM12), KMD or ZMD, 
  117.       RZMP, CHAT, COMMENT,  MENU, FOR, and NEW.   These  files  are assumed to 
  118.       have been made "safe" for BBS use.
  119.  
  120.    d. Vs 1.21 updates (4/12/90, Sean Sullivan):
  121.       - TYPE command for .LBR files now calls on LT.COM (or ZLT.COM renamed as 
  122.         LT.COM).   TYPE command  for .ZIP files now displays error message "++ 
  123.         Cannot type ZIPped files ++".  TYEP (sic) is  added  as  equivalent to 
  124.         TYPE (a frequent misspelling).
  125.       - CR,  UNCR,  LT,  READ,  VIEW,  and  VDE commands  added  for crunching 
  126.         uncrunching, typing, and editing files found outside archive. 
  127.       - NULU command also added to supplement  PUT command for LBR files.  PUT 
  128.         command for LBR files now uses LPUT instead of NULU.  
  129.       - GET command for  LBR  files  now  requires  LBREXT  (renamed to  LGET) 
  130.         instead of LT.  
  131.  QLUX Notes - 3/4 
  132.  
  133.       - ZCMD added for  using  Z-System  commands not found in QLUX.  ZCMD can 
  134.         only do one single command at a time, i.e., no multiple commands.  The
  135.         only restriction of using ZCMD is that  the  command line  buffer must
  136.         be external.  If the internal command line is used, it will  get wiped
  137.         out at the first occurence of a warm boot.
  138.       - SEND command fixed.   Changed  SEND ALL command to SENDALL.   SEND ALL 
  139.         was being interpreted as downloading  a single  LBR  member file named 
  140.         "ALL".   Added  alternate  code for KMD if you don't use ZMD.  Changed 
  141.         ZSEND ALL command to ZSENDALL for RZMP download of entire LBR/ZIP/ARC/
  142.         ARK/LZH file.
  143.       - NEW command was added since there was a FOR command.
  144.       - Adjustments to  help  menu and syntax display.  The syntax display now 
  145.         follows ZCPR3-style syntax displays and now shows the  current version 
  146.         number.
  147.  
  148.    e. Vs. 1.20 updates (9/22/89, Sean Sullivan):
  149.       - Now assumes a combination of the  following files  being online:  DIR,
  150.         LDIR, TYPE (LT29),  NULU,  SETD,  UNARC, ARK,  ADS, UNZIP, LHRD, LHVW, 
  151.         ZMD, and RZMP.
  152.  QLUX Notes - 4/4 
  153.  
  154.       - GET command added to extract  member files  and  PUT command to insert 
  155.         new files into archive -- only for LBR, using NULU, and ARC/ARK, using 
  156.         ARK.   Also  a  DATE command  for  date/time-stamping LBR  and ARC/ARK 
  157.         files.   GET,  PUT,  and  DATE command assumes same respective command 
  158.         line formats as if you're using  LT,  UNARC,  UNZIP,  LHRD, NULU, ARK, 
  159.         SETD,  or ADS at the QLUX command line  prompt  but without specifying 
  160.         the archive file.  
  161.       - Another new directory command is SD where you can see ALL the files in 
  162.         the current DU:  (as opposed to FILES  allowing  you  to  see only the 
  163.         files with the same .EXT as the file QLUX is currently attached to).
  164.       - Provided additional ways to exit program (Q, E, X, CPM), put help menu 
  165.         in program, plus a few other minor changes.
  166.  
  167.    f. Vs 1.10 updates (9/17/89, Lawrence Davis):
  168.       - Configured for QBBS usage.   MCL  routines  courtesy  of  Chris Mcewen
  169.         (Socrates QBBS 201/754-9067).
  170. :3
  171.  Examples of Use - 1/2 
  172.  
  173.    a. Example of ZCMD syntax:   QLUX:LIBRARY.LBR (?=HELP)>>zcmd vlu           
  174.  
  175.    b. A0:ROOT>lt library.lbr a:file.dyc
  176.       QLUX:LIBRARY.LBR (?=HELP)>>get a:file.dyc
  177.  
  178.    c. A0:ROOT>unarc archive.ark a:filename.typ
  179.       QLUX:ARCHIVE.ARK (?=HELP)>>get a:filename.typ
  180.  
  181.    d. A0:ROOT>unzip zipped.zip member.fil
  182.       QLUX:ZIPPED.ZIP (?=HELP)>>get member.fil
  183.  
  184.    e. A0:ROOT>lhrd lewzhuff.lzh member.doc
  185.       QLUX:LEWZHUFF.LZH (?=HELP)>>get member.doc
  186.  
  187.    f. A0:ROOT>nulu -o library.lbr -a file -x
  188.       QLUX:LIBRARY.LBR (?=HELP)>>put -a file -x
  189.  
  190.    g. A0:ROOT>ark archive.ark newfile.fil
  191.       QLUX:ARCHIVE.ARK (?=HELP)>>put newfile.fil
  192.  Examples of Use - 2/2 
  193.  
  194.    h. A0:ROOT>setd library.lbr 09/22/89 existing.fil /o
  195.       QLUX:LIBRARY.LBR (?=HELP)>>date 09/22/89 existing.fil /o
  196.  
  197.    i. A0:ROOT>ads archive.ark 09/22/89 13:54 specific.fil
  198.       QLUX: ARCHIVE.ARK (?=HELP)>>date 09/22/89 13:54 specific.fil
  199.