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