home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / ckl196.zip / cklins.txt < prev    next >
Text File  |  2000-01-02  |  10KB  |  266 lines
  1. C-KERMIT 7.0 INSTALLATION INSTRUCTIONS FOR STRATUS VOS
  2.  
  3. Applies to:  C-Kermit 7.0
  4. Last update: Sat Apr 17 10:57:27 1999
  5.  
  6. Author:   Kernie Brashier, Stratosphere, Ltd
  7.  
  8.   Copyright (C) 1985, 1999,
  9.     Trustees of Columbia University in the City of New York.
  10.     All rights reserved.  See the C-Kermit COPYING.TXT file or the
  11.     copyright text in the ckcmai.c module for disclaimer and permissions.
  12.  
  13. Report problems, suggestions, fixes, etc, to:
  14.  
  15.   The Kermit Project
  16.   Columbia University
  17.   612 West 115th Street
  18.   New York NY 10025-7799
  19.   USA
  20.   Email: kermit-support@columbia.edu
  21.   Web:   http://www.columbia.edu/kermit/
  22.   News:  comp.protocols.kermit.misc
  23.  
  24.  
  25. DOCUMENTATION
  26.  
  27. Frank da Cruz and Christine M. Gianone, "Using C-Kermit", Second Edition,
  28. 1997, Digital Press / Butterworth-Heinemann, Woburn, MA, ISBN 1-55558-164-1
  29. US single-copy price: $44.95; quantity discounts available.  Available in
  30. computer bookstores or directly from Columbia University:
  31.  
  32.   http://www.columbia.edu/kermit/manuals.html
  33.  
  34. Features added after version 6.0 was released are documented in the text file,
  35. ckermit2.txt.
  36.  
  37.  
  38. OVERVIEW
  39.  
  40. This file contains VOS-specific information.  For a description of general
  41. (system-independent) configuration options for C-Kermit, please read the file
  42. CKCCFG.TXT.  For information about known limitations or bugs, and possible
  43. workarounds, see the files CKCBWR.TXT and CKLBWR.TXT.
  44.  
  45. Once you have built C-Kermit according to the instructions in this file,
  46. you should install it in a directory that is in the users' library paths,
  47. but that is not likely to be overwritten when you install a new version of
  48. the operating system.  A good candidate would be >system>application_library.
  49.  
  50. It might also be a good idea to make a "Kermit library" directory for sample
  51. files and non-man-page-style documentation.  (master_disk)>kermit might be
  52. a good place for this.  Some of the files that could go there are:
  53.  
  54.   ckermit.ini
  55.     The standard initialization file.  Users should copy this to their home
  56.     directories.  (In C-Kermit 6A(190) and later, you can designate a single
  57.     copy as the system-wide initialization file; details below).
  58.  
  59.   ckermod.ini
  60.     A sample customization file.  Users should copy this file to
  61.     their home directories, and make any desired modifications (user- or
  62.     site-specific customizations).
  63.  
  64.   ckermit.kdd
  65.     A sample dialing directory file.
  66.  
  67.   ckermit.knd
  68.     A sample network directory.
  69.  
  70.   ckermit.ksd
  71.     A sample services directory.
  72.  
  73.   ckermit.env
  74.     A sample "environment variable" file
  75.  
  76.   ckedemo.ksc
  77.     Macro definitions from "Using C-Kermit".
  78.  
  79.   ckevt.ksc
  80.     Command file to demonstrate special screen effects from "Using C-Kermit".
  81.  
  82.   ckepage.ksc
  83.     A sample script for sending alphanumeric pages.
  84.  
  85.   ckermit2.txt
  86.     A file listing the updates, changes, and corrections made to C-Kermit
  87.     since publication of the 2nd edition of "Using C-Kermit".
  88.  
  89.   ckcbwr.txt
  90.     The general C-Kermit "beware" file.
  91.  
  92.   cklbwr.txt
  93.     The VOS-specific C-Kermit beware file.
  94.  
  95.  
  96. READING A C-KERMIT DISTRIBUTION TAPE
  97.  
  98. If you have received C-Kermit on tape from Columbia University, it will
  99. most likely be written as ANSI labeled, and certainly is not VOS save
  100. format.  To read the files onto your system, do something like this,
  101. substituting your tape device name and supplying the density written on
  102. the tape.
  103.  
  104.      create_dir kermit_tape
  105.      change_current_dir kermit_tape
  106.      attach_port tape %s1#mt1.0
  107.      mount_tape tape -tape_format ansi -density 1600 -access_rights readonly
  108.      read_tape tape *
  109.      detach_port tape
  110.  
  111. You should at this point have all the files on the tape in your kermit_tape
  112. directory, and can procede to either build C-Kermit yourself, or use the
  113. pre-built version on the tape.
  114.  
  115.  
  116. BUILDING C-KERMIT FOR VOS
  117.  
  118. VOS C-Kermit is built with a command macro called cklmak.cm.  This macro
  119. recompiles and binds ALL the modules involved. It does allow you to build
  120. into a different directory than the one containing the sources, so you can
  121. build for different machines into different directories if you need to.
  122.  
  123. If you want to define a system-wide initialization file for C-Kermit, rather
  124. than making each user have her/his own copy, define the symbol CK_SYSINI to be
  125. the full pathname of the file, in the -kermit_options add:
  126.  
  127.   'CK_SYSINI %s1#m1_d01>kermit>ckermit.ini'
  128.  
  129. It is important that the string above get quoted properly, so if you are using
  130. a command line to do this it would come out something like:
  131.  
  132.   cklmak -kermit_options 'STRATUS DYNAMIC DCMDBUF CLSOPEN STRATUSX25 &+
  133.     ''CK_SYSINI %s1#m1_d01>kermit>ckermit.ini'''
  134.  
  135. Note: if you build Kermit to execute a system-wide initialization file, this
  136. file can (and probably should) (be modified to) "chain" to the user's own
  137. initialization file (if any) by ending (or starting, depending on the desired
  138. precedence) with a command like:
  139.  
  140.   if exist \v(home)ckermit.ini take \v(home)ckermit.ini
  141.  
  142. After you have built and tested the C-Kermit program successfully, you can
  143. discard the object (ck*.obj) files, which are no longer needed. Then you
  144. can copy the program modules to an application directory.
  145.  
  146. There are several utility programs that come with C-Kermit you may or may
  147. not want. Most of them have documentation files (*.txt) that come along that
  148. explain what they are for. None of them are vital to using C-Kermit, though
  149. some are required to build it; these are built by cklmake.cm whether you ask
  150. for them or not. You can have cklmak delete the required files and not build
  151. the others by specifying -no_tools, but generally they are helpful programs
  152. to have.
  153.  
  154.  
  155. IF YOU DO NOT HAVE A C COMPILER
  156.  
  157. Some of the files that come with the C-Kermit distribution are hex-coded
  158. versions of the compiled and bound C-Kermit executables.  Versions are
  159. provided for the 68k, i860, and continuum processors.  To bootstrap C-Kermit
  160. onto your system, you only need the command macro cklxtr.cm and the hex file
  161. for C-Kermit itself; the name of that file will vary depending on your
  162. processor type.  The basename will be cklker, and the suffix will be .h68 for
  163. 68k machines, .h86 for i860 machines and .h71 for continuum processors.  Also
  164. included is a hex version of a compiled extraction program, which runs much
  165. faster than the command macro version.  Use the command macro to convert the
  166. conversion program and the compiled program to extract the main C-Kermit
  167. program.  The extraction program is called cklxtr.pm, and is made from the
  168. appropriate hex file.  Both the command macro and the program take two
  169. positional parameters, the input file, and the output file.  The input file is
  170. the hex coded version of the program and the output file is resulting program
  171. module.  The C source for the hexifying program is also included.
  172.  
  173. After unloading all the necessary files into a directory, presumably using
  174. read_tape, convert the compiled conversion program (use the appropriate
  175. suffix for your system type):
  176.  
  177.     cklxtr cklxtr.h86 extract.pm
  178.  
  179. Then extract C-Kermit:
  180.  
  181.     extract.pm cklker.h86 kermit.pm
  182.  
  183. If you get an error that says something like "This program contains
  184. instructions not available on this processor," the most likely cause is that
  185. you have extracted the 68k program on a i860 machine or vice versa.  Change
  186. the suffixes and try it again.  The file formats used by the command macro
  187. and by the program are identical, so you can simply extract C-Kermit directly,
  188. but this two step process can save a great deal of time.
  189.  
  190. The C-Kermit versions that are included in hex format are built without symbol
  191. tables, with optimization, and include support for X.25 and TCP/IP networking.
  192.  
  193.  
  194. APPENDIX: "Packing Slip" for C-Kermit 6.0 for VOS:
  195.  
  196.   (Some file names have been changed for C-Kermit 7.0)
  197.  
  198. Organization: Stratosphere, Ltd
  199. Date: Fri, 7 Mar 1997 15:22:31 +0000
  200. Subject: Kermit 6 deliverables
  201. To: "Richard S. Shuford" <shuford@cs.utk.edu>, <fdc@watsun.cc.columbia.edu>
  202. From: "Kernie Brashier" <kernie@stratosphere.com>
  203.  
  204. Gentlemen:
  205.  
  206. Das source is good and has been delivered to kermit.columbia.edu
  207. in the directory /kermit/incoming.
  208.  
  209. I only included the files I changed to save time and space. Here is
  210. the list with the changes made:
  211.  
  212. cklins.txt   Updated documentation to reference release 7
  213.                    instead of 6
  214.  
  215. cklker.71    Continuum 7100 kermit executable (jetta)
  216. cklker.h68  Motorola 68000 kermit executable (fresco)
  217. cklker.h86  Intel i860 XA/R kermit executable (atlantic)
  218. cklker.txt    Updated references of kermit from 6 to 7 (release)
  219.  
  220. cklmak.cm  Modified command macro that builds kermit
  221.                    release. Added new source, deleted source
  222.         references no longer required, modified script
  223.         to not execute ckwart. Instead compile
  224.         cklpro.c
  225.  
  226. cklpro.c    This is ckcpro.c with the few changes necessary
  227.                    for Stratus to compile. Apparently,
  228.         our Stratus compilers do not like the way the
  229.          wart program continues lines with the '\'. To
  230.          ease confusion and prevent ckcpro.c from
  231.         being overwritten, I copied and modified it
  232.                   and renamed it cklpro.c.  With this release
  233.                   of kermit, I had to modify the build macro
  234.         to NOT execute ckwart to extract ckcpro.c
  235.         from ckcpro.w
  236.  
  237. cklvos.txt    rename cklaaa.hlp to cklvos.txt. Added
  238.          documentation for VOS developers. Had
  239.         I had this, it would have made my job
  240.         a lot easier. Figured I would modify it
  241.         so that next time, this would be a piece
  242.         of cake....
  243.  
  244. cklxtr.71    Continuum 7100 extract utility (jetta)
  245. cklxtr.h68    Motorola 68000 extract utility (fresco)
  246. cklxtr.h86   Intel i860 XA/4 extract utility (atlantic)
  247.  
  248. ckusig.c    Added #ifdef for STRATUS to include
  249.         defines for alarm and such.
  250.  
  251. ckusig.c is the only "original" kermit code that had
  252. to change. I copied the #define references from
  253. ckuscr.c.  It appears this should have been included
  254. in ckusig.c. Most have been an oversight.
  255.  
  256. Once again thank you for the opportunity to
  257. participate in this update. Feel free to contact
  258. me if I can be of further assistance in the
  259. future.
  260.  
  261. Best regards
  262. -kernie brashier
  263. Stratosphere, Ltd
  264.  
  265. (End)
  266.