home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / ckc190.zip / cklins.doc < prev    next >
Text File  |  1994-05-16  |  9KB  |  197 lines
  1. C-KERMIT 5A INSTALLATION INSTRUCTIONS FOR STRATUS VOS              -*-text-*-
  2.  
  3.   5A(190)
  4.   Thursday Jan 20, 1994
  5.  
  6.   David Lane <lane@watsun.cc.columbia.edu>
  7.   F. da Cruz, Columbia University <fdc@columbia.edu>
  8.  
  9.   Copyright (C) 1985, 1994, Trustees of Columbia University in the City of New
  10.   York.  The C-Kermit software may not be, in whole or in part, licensed or
  11.   sold for profit as a software product itself, nor may it be included in or
  12.   distributed with commercial products or otherwise distributed by commercial
  13.   concerns to their clients or customers without written permission of the
  14.   Office of Kermit Development and Distribution, Columbia University.  This
  15.   copyright notice must not be removed, altered, or obscured.
  16.  
  17. DISCLAIMER:
  18.  
  19.   The C-Kermit software is provided in source code form by Kermit Development
  20.   and Distribution, Columbia University.  The software is provided "as is;" no
  21.   other warranty is provided, express or implied, including without
  22.   limitations, any implied warranty of merchantability or implied warranty of
  23.   fitness for a particular purpose.
  24.  
  25.   Neither Columbia University nor any of the contributors to the C-Kermit
  26.   development effort, including, but not limited to, AT&T, Digital Equipment
  27.   Corporation, Data General Corporation, or International Business Machines
  28.   Corporation, warrant C-Kermit software or documentation in any way.  In
  29.   addition, neither the authors of any Kermit programs, publications or
  30.   documentation, nor Columbia University nor any contributing institutions or
  31.   individuals acknowledge any liability resulting from program or
  32.   documentation errors.
  33.  
  34. DOCUMENTATION
  35.  
  36. C-Kermit 5A is documented in the book "Using C-Kermit" by Frank da Cruz
  37. and Christine M. Gianone, Digital Press, Burlington, MA, USA.  Price: US
  38. $34.95.  Available at book and computer stores, or to order from Columbia
  39. University, call +1 212 854-3703.
  40.  
  41. OVERVIEW
  42.  
  43. This file contains VOS-specific information.  For a description of general
  44. (system-independent) configuration options for C-Kermit, please read the file
  45. CKCCFG.DOC.  For information about known limitations or bugs, and possible
  46. workarounds, see the files CKCKER.BWR and CKUKER.BWR.
  47.  
  48. Once you have built C-Kermit according to the instructions in this file,
  49. you should install it in a directory that is in the users' library paths,
  50. but that is not likely to be overwritten when you install a new version of
  51. the operating system.  A good candidate would be >system>application_library.
  52.  
  53. It might also be a good idea to make a "Kermit library" directory for sample
  54. files and non-man-page-style documentation.  (master_disk)>kermit might be
  55. a good place for this.  Some of the files that could go there are:
  56.  
  57. ckermit.ini
  58.   The standard initialization file.  Users should copy this to their home
  59.   directories.  (In C-Kermit 5A(190), you can designate a single copy as
  60.   the system-wide initialization file; details below).
  61.  
  62. ckermod.ini
  63.   A sample customization file.  Users should copy this file to
  64.   their home directories, and make any desired modifications (user- or
  65.   site-specific customizations).
  66.  
  67. ckermit.kdd
  68.   A sample dialing directory file.
  69.  
  70. ckermit.ksd
  71.   A sample services directory.
  72.  
  73. ckermit.env
  74.   A sample "environment variable" file
  75.  
  76. ckedemo.ini
  77.   Macro definitions from "Using C-Kermit".
  78.  
  79. ckevt.ini
  80.   Command file to demonstrate special screen effects from "Using C-Kermit"
  81.  
  82. ckcker.upd
  83.   A file listing the updates, changes, and corrections made to C-Kermit since
  84.   publication of "Using C-Kermit".
  85.  
  86. ckcker.bwr
  87.   The general C-Kermit beware file.
  88.  
  89. ckuker.bwr
  90.   The UNIX-specific C-Kermit beware file.
  91.  
  92.  
  93. READING A C-KERMIT DISTRIBUTION TAPE
  94.  
  95. If you have received C-Kermit on tape from Columbia University, it will
  96. most likely be written as ANSI labeled, and certainly is not VOS save
  97. format.  To read the files onto your system, do something like this,
  98. substituting your tape device name and supplying the density written on
  99. the tape.
  100.  
  101.      create_dir kermit_tape
  102.      change_current_dir kermit_tape
  103.      attach_port tape %s1#mt1.0
  104.      mount_tape tape -tape_format ansi -density 1600 -access_rights readonly
  105.  
  106. If your site is not running system_operator, the mount_tape command will ask
  107. if it has understood your command line and show you what it thinks you want;
  108. if the information looks good, say yes to mount the tape volume.  It will
  109. then show you the information on the ANSI tape label, and ask if that
  110. information is correct.  If it is, say yes, to proceed to use the loaded
  111. tape.
  112.  
  113.      read_tape tape -file_ids *
  114.      detach_port tape
  115.  
  116. You should at this point have all the files on the tape in your kermit_tape
  117. directory, and can procede to either build C-Kermit yourself, or use the
  118. pre-built version on the tape.
  119.  
  120.  
  121. BUILDING C-KERMIT FOR VOS
  122.  
  123. VOS C-Kermit is built with a command macro called cklmak.cm.  This macro
  124. recompiles and binds ALL the modules involved. It does allow you to build
  125. into a different directory than the one containing the sources, so you can
  126. build for different machines into different directories if you need to.
  127.  
  128. If you want to define a system-wide initialization file for C-Kermit, rather
  129. than making each user have her/his own copy, define the symbol CK_SYSINI to be
  130. the full pathname of the file, in the -kermit_options add:
  131.  
  132.   'CK_SYSINI %s1#m1_d01>kermit>ckermit.ini'
  133.  
  134. It is important that the string above get quoted properly, so if you are using
  135. a command line to do this it would come out something like:
  136.  
  137.   cklmak -kermit_options 'STRATUS DYNAMIC DCMDBUF CLSOPEN STRATUSX25 &+
  138.     ''CK_SYSINI %s1#m1_d01>kermit>ckermit.ini'''
  139.  
  140. Note: if you build Kermit to execute a system-wide initialization file, this
  141. file can (and probably should) (be modified to) "chain" to the user's own
  142. initialization file (if any) by ending (or starting, depending on the desired
  143. precedence) with a command like:
  144.  
  145.   if exist \v(home)ckermit.ini take \v(home)ckermit.ini
  146.  
  147. After you have built and tested the C-Kermit program successfully, you can
  148. discard the object (ck*.obj) files, which are no longer needed. Then you
  149. can copy the program modules to an application directory. 
  150.  
  151. There are several utility programs that come with C-Kermit you may or may
  152. not want. Most of them have documentation files (*.doc) that come along that
  153. explain what they are for. None of them are vital to using C-Kermit, though
  154. some are required to build it; these are built by cklmake.cm whether you ask
  155. for them or not. You can have cklmak delete the required files and not build
  156. the others by specifying -no_tools, but generally they are helpful programs
  157. to have. 
  158.  
  159. IF YOU DO NOT HAVE A C COMPILER
  160.  
  161. Some of the files that come with the C-Kermit distribution are hex-coded
  162. versions of the compiled and bound C-Kermit executables.  Versions are
  163. provided for both the 68k and i860 processors.  To bootstrap C-Kermit onto
  164. your system, you only need the command macro cklxtr.cm and the hex file
  165. for C-Kermit itself; the name of that file will vary depending on your
  166. processor type.  The basename will be cklker, and the suffix will be .h68
  167. for 68k machines, and .h86 for i860 machines.  Also included is hex version
  168. of a compiled extraction program, which runs much faster than the command
  169. macro version.  Use the command macro to convert the conversion program and
  170. the compiled program to extract the main C-Kermit program.  The extraction
  171. program is called cklxtr.pm, and is made from the appropriate hex file.
  172. Both the command macro and the program take two positional parameters,
  173. the input file, and the output file.  The input file is the hex coded version
  174. of the program and the output file is resulting program module.  The C
  175. source for the hex-ifying program is also included.
  176.  
  177. After unloading all the necessary files into a directory, presumably using
  178. read_tape, convert the compiled conversion program (use the appropriate
  179. suffix for your system type):
  180.  
  181.     cklxtr cklxtr.h86 extract.pm
  182.  
  183. Then extract C-Kermit:
  184.  
  185.     extract.pm cklker.h86 kermit.pm
  186.  
  187. If you get an error that says something like "This program contains
  188. instructions not available on this processor," the most likely cause is that
  189. you have extracted the 68k program on a i860 machine or vice versa.  Change
  190. the suffixes and try it again.  The file formats used by the command macro 
  191. and by the program are identical, so you can simply extract C-Kermit directly,
  192. but this two step process can save a great deal of time.
  193.  
  194. The C-Kermit versions that are included in hex format are built without
  195. symbol tables, with optimization, and include support for X.25 and TCP/IP
  196. networking.
  197.