home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / ckv196.zip / ckvaaa.txt < prev    next >
Text File  |  2000-01-01  |  8KB  |  231 lines
  1. CKVAAA.TXT                                                            Jan 2000
  2.  
  3.             C-KERMIT 7.0 FILES FOR VMS AND OPENVMS
  4.  
  5.  
  6. DOCUMENTATION
  7.  
  8.   Frank da Cruz and Christine M. Gianone, "Using C-Kermit", Second Edition,
  9.   Digital Press / Butterworth-Heinemann, Woburn, MA, ISBN 1-55558-164-1
  10.  
  11.   US single-copy price: $44.95; quantity discounts available.  Available in
  12.   computer bookstores or directly from Columbia University:
  13.  
  14.     The Kermit Project
  15.     Columbia University
  16.     612 West 115th Street
  17.     New York NY  10025-7799
  18.     USA
  19.     Telephone: +1 212 854-3703
  20.     Fax:       +2 212 663-8202
  21.  
  22. PLEASE PURCHASE THE MANUAL.  It will teach you how to use the C-Kermit
  23. software, it will answer your questions, and proceeds from the sales are a
  24. major source of funding for the Kermit effort.
  25.  
  26.  
  27. WEB ACCESS
  28.  
  29. http://www.columbia.edu/kermit/ckermit.html
  30.  
  31.  
  32. FTP ACCESS
  33.  
  34. Host: kermit.columbia.edu [128.59.39.2].  Directory:
  35.  
  36.                       Text files          Binary files
  37.                       ----------------    ---------------
  38. Current release:      kermit/f            kermit/bin, kermit/vmshex
  39.  
  40. Test version if any:  kermit/test/text    kermit/test/bin
  41.  
  42. All files for VMS C-Kermit have names beginning with CK.  Those particular to
  43. VMS begin with CKV.  Those that VMS C-Kermit share in common with other
  44. C-Kermit implementations begin with CKE, CKC or CKU.  When retrieving these
  45. files via ftp from kermit.columbia.edu, which is a UNIX system, use only
  46. lowercase letters in directory and filenames.  For example, to get the file
  47. CKVKER.COM, use the command "get ckvker.com".  Case matters.  (Exception:
  48. some of the Kermit directories might contain a file called READ.ME or NEWS;
  49. again, case matters.)
  50.  
  51.  
  52. VMS C-KERMIT TEXT FILES:
  53.  
  54. Using ftp, GET the files:
  55.  
  56.   cka*.* cke*.* ckv*.*
  57.  
  58. It is recommended that the following text files be placed in a KERMIT:
  59. directory on your (Open)VMS system, where all users can have read access to
  60. them for reference, except for CKVKER.HLP, which goes in the HELP library as
  61. KERMIT.HLP (or CKERMIT.HLP).  These are all ordinary plain-text ASCII files
  62. that can type typed, edited, printed, etc.
  63.  
  64. COPYING.TXT
  65.   Copyright and permissions notice.
  66.  
  67. CKAAAA.TXT
  68.   Overview of all C-Kermit files.
  69.  
  70. CKVAAA.TXT
  71.   This file, which explains what the other files are for.  Can be renamed
  72.   to READ.ME.
  73.  
  74. CKVINS.TXT
  75.   IMPORTANT: READ THIS!  VMS C-Kermit installation instructions.
  76.   This file is for the system administrator.
  77.  
  78. CKVKER.HLP
  79.   A short VMS-style help file for VMS C-Kermit, to be installed in the system
  80.   HELP library under the desired name ("KERMIT" or "CKERMIT").  See CKVINS.TXT
  81.   for instructions.  This is not a substitute for the manual.
  82.  
  83. CKERMIT.INI
  84.   Standard C-Kermit initialization file.  For users.  This file defines
  85.   the macros used by the services directory and other features.  A single
  86.   copy can be installed for system-wide use (see CKVINS.DOS for instructions).
  87.  
  88. CKERMOD.INI
  89.   Sample C-Kermit customization file.  Each user would copy this file to
  90.   her/his login directory and edit it to achieve the desired personal
  91.   customizations.
  92.  
  93. CKERMIT.KDD
  94.   Sample dialing directory
  95.  
  96. CKERMIT.KSD
  97.   Sample services directory
  98.  
  99. CKERMIT2.TXT
  100.   Updates to C-Kermit since "Using C-Kermit" 2nd Ed was published.  For users.
  101.   This is user-level documentation for features that were added to C-Kermit
  102.   since 6.0.192.
  103.  
  104. CKCBWR.TXT
  105.   General C-Kermit "Beware file".  Troubleshooting hints and tips for users,
  106.   pertaining to C-Kermit in general (C-Kermit runs on about ten major
  107.   operating systems, of which VMS is just one).
  108.  
  109. CKVBWR.TXT
  110.   VMS-specific C-Kermit "Beware File".  VMS-specific hints and tips for users.
  111.  
  112. CKEDEMO.KSC, CKEVT.KSC, CKEPAGE.KSC
  113.   Online copies of demonstration macros from "Using C-Kermit".
  114.  
  115.  
  116. BINARIES
  117.  
  118. VMS C-Kermit binaries are available for both VAX and Alpha, and for each
  119. processor in a variety of forms, depending on which, if any, TCP/IP networking
  120. product is available.  The binaries are distributed in binary format for those
  121. who receive VMS BACKUP-format media, or who can access them directly via FTP,
  122. and in a special "HEX" format, as text files.  These HEX files may be decoded
  123. back into their original binary format using the CKVDEH.MAR program, which you
  124. can assemble on your VAX or Alpha system.  Complete instructions for how
  125. to do this are included in the CKVDEH.TXT file.
  126.  
  127. Summary of binary executable names in the kermit/bin directory:
  128.  
  129.   CKVawww-VMSnn-tttvv.EXE
  130.  
  131. where:
  132.  
  133.   www = KER for KERMIT, CVT for the Labeled file convert program
  134.     a = architecture: A for Alpha, V for VAX.
  135.    nn = VMS version, e.g. 55 for VMS 5.5, 70 for VMS 7.0.
  136.   ttt = TCP/IP product, if any:
  137.     CMU = CMU-OpenVMS/IP ("CMU/Tek")
  138.     UCX = DEC TCP/IP
  139.     TGV = Cisco (TGV) MultiNet
  140.     WIN = Attachmate (Wollongong) WIN/TCP (PathWay)
  141.     PST = Process Software TCPware
  142.    vv = The version number of the TCP/IP product.
  143.   xxx = HEX (text-encoded binary) or EXE (true binary)
  144.  
  145. When there is no TCP/IP support built in, tttvv is "NONET".
  146.  
  147. Examples:
  148.  
  149.   CKVAKER-VMS61-TGV40A.EXE: C-Kermit, Alpha, VMS 6.1, Multinet 4.0A
  150.   CKVAKER-VMS62-NONET.EXE:  C-Kermit, Alpha, VMS 6.2, no TCP/IP
  151.   CKVACVT-VMS61.EXE:        Convert, Alpha, VMS 6.1
  152.   CKVVCVT-VMS44.EXE:        Convert, VAX, VMS 4.4
  153.   CKVVKER-VMS55-UCX20.EXE:  C-Kermit, VAX, VMS 5.5, DEC TCP/IP 2.0
  154.  
  155. If you need a binary that isn't there, let us know at kermit@columbia.edu.
  156. If you can supply a binary that isn't there, please also let us know.
  157.  
  158. HEX FILES
  159.  
  160. These are in the kermit/vmshex directory, and must be decoded on your VMS
  161. system using CKVDEH.MAR (see CKVDEH.TXT for instructions).  The names are
  162. shortened so they will fit into the dataset name field of the a standard
  163. ANSI tape file header:
  164.  
  165.   phnn-tttvv.HEX
  166.  
  167. where:
  168.  
  169.   p   = Program:  K for Kermit or C for CKVCVT (the labeled file converter)
  170.   h   = hardware: A for Alpha, V for VAX
  171.   nn  = VMS version, e.g. 62 for VMS 6.2
  172.   ttt = TCP/IP product (as above)
  173.   vv  = Version number of TCP/IP product
  174.  
  175. Examples:
  176.  
  177.   KV44-TWG32B.HEX = Kermit VAX VMS 4.4 Wollongong 3.2B
  178.   KA62-TGV40A.HEX = Kermit Alpha VMS 6.2 Multinet 4.0A
  179.   KA70-NONET.HEX  = Kermit Alpha VMS 6.2, no networks
  180.   CV55.HEX        = CKCVT VAX VMS 5.5
  181.  
  182.  
  183. FILES FOR BUILDING C-KERMIT FOR VMS FROM SOURCE CODE (also see CKVINS.TXT):
  184.  
  185. CKVKER.COM - A DCL procedure for building C-Kermit from the source files on
  186.   any VAX or Alpha.  Read the comments at the top of CKVKER.COM for
  187.   instructions.
  188.  
  189. CKVKER.MMS - Used by CKVKER.COM on systems that have MMS.  But CKVKER.COM
  190.   works fine without it, too.
  191.  
  192. CKVLCMU.HEX - Berkeley sockets library for CMU/Tek TCP/IP, as a BACKUP
  193.   saveset, hexified.  Dehexify with CKVDEH.
  194.  
  195. CKVOLD.COM - More or less identical in functionality to CKVKER.COM, but
  196.   written in VMS 4.0 DCL syntax, so it can run on VMS 4.x systems.
  197.  
  198. CKCPLM.TXT - Program Logic Manual.
  199.  
  200. CKCCFG.TXT - Documentation of compile-time configuration options.
  201.  
  202. Read CKVINS.TXT for detailed installation instructions.
  203.  
  204.  
  205. C-KERMIT SOURCE FILES:
  206.  
  207.   Quick start for ftp users:  mget ckvker.com ckvker.mms ck[cuvw]*.[cwh]
  208.  
  209. CKVCON.C   - The VMS C-Kermit CONNECT command.
  210. CKVFIO.C   - VMS system-specific file i/o module for C-Kermit.
  211. CKVTIO.C   - VMS system-specific communications i/o module for C-Kermit.
  212.  
  213. CKVIOC.H   - ioctl() simulation for VMS, needed with DEC TCP/IP product.
  214. CKVIOC.C
  215.  
  216. CKVVMS.H   - Header file used by VMS C-Kermit source files.
  217.  
  218. CKVCVT.C   - A standalone program for decoding VMS labeled files.
  219.  
  220. CKVCVT.COM - DCL procedure for building the CKVCVT program.
  221.  
  222. CKVVCVT.XXX - VAX binary for CKCVT (HEX or EXE)
  223. CKVACVT.XXX - Alpha binary for CKCVT (HEX or EXE)
  224.  
  225.  
  226. Of course, you also need the non-VMS-specific C-Kermit files too:
  227.  
  228. CKC*.C, CKC*.H, CKU*.C, CKU*.H, CKCPRO.W, CKWART.C.
  229.  
  230. (End of CKVAAA.TXT)
  231.