home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / c-kermit / ckdins.txt < prev    next >
Text File  |  2020-01-01  |  35KB  |  893 lines

  1.                              Software Pass Notice
  2.  
  3.                         C-Kermit for AOS/VS, Rev. 7.195
  4.                                  December, 1998
  5.  
  6.     This release notice provides information specific to the AOS/VS
  7.     implementation of C-Kermit -- information which might not be supplied in
  8.     the Kermit documentation written by Frank da Cruz and Christine Gianone
  9.     of Columbia University and published by Digital Press.  Please read
  10.     all sections carefully.
  11.  
  12.     1  Product Description   .  .  .  .  .  .  .  .  .  .  2
  13.     2  Prerequisites   .  .  .  .  .  .  .  .  .  .  .  .  3
  14.     3  Enhancements .  .  .  .  .  .  .  .  .  .  .  .  .  4
  15.     4  Notes and Warnings .  .  .  .  .  .  .  .  .  .  .  5
  16.       4.1  Known Problems .  .  .  .  .  .  .  .  .  .  .  5
  17.       4.2  Restrictions.  .  .  .  .  .  .  .  .  .  .  .  5
  18.       4.3  Notes .  .  .  .  .  .  .  .  .  .  .  .  .  .  6
  19.     5  Documentation   .  .  .  .  .  .  .  .  .  .  .  .  7
  20.     6  Product Organization  .  .  .  .  .  .  .  .  .  .  8
  21.       6.1  File Listing   .  .  .  .  .  .  .  .  .  .  .  8
  22.       6.2  Obtaining the Software from Columbia University 8
  23.       6.3  Obtaining the Software from a PC Diskette .  . 10
  24.     7  Installation Instructions   .  .  .  .  .  .  .  . 12
  25.       7.1  Establishing a Communications Line  .  .  .  . 12
  26.           7.1.1 Serial Connections .  .  .  .  .  .  .  . 12
  27.           7.1.2 TCP/IP Connections .  .  .  .  .  .  .  . 19
  28.       7.2  Installing the Release Software  .  .  .  .  . 20
  29.     8  User Notes.  .  .  .  .  .  .  .  .  .  .  .  .  . 21
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.     DESKTOP GENERATION, ECLIPSE, and DASHER are registered trademarks
  47.     of Data General Corporation.
  48.  
  49.     Kermit is a registered trademark of the Henson Associates.
  50.     Hayes is a registered trademark of Hayes Microcomputer Products, Inc.
  51.     UNIX is a registered trademark of AT&T Bell Laboratories.
  52.  
  53.  
  54.                                                                      2
  55.  
  56.  
  57.     1 Product Description
  58.  
  59.  
  60.     Kermit is a file transfer and terminal emulation program that was
  61.     developed by Columbia University in 1981.  It runs on a wide variety of
  62.     operating systems and is available to the public free of charge.
  63.  
  64.     Kermit's major features include advanced and efficient Kermit file
  65.     transfer, terminal connection, support for asynchronous connections
  66.     (either direct or via modems) and TCP/IP connections, a built-in DIAL
  67.     command supporting a wide variety of modems, extensive support for
  68.     national and international Roman, Cyrillic, Hebrew, Greek, and Japanese
  69.     character sets, and a powerful, easy-to-use script programming language
  70.     for automated operation.
  71.  
  72.     C-Kermit is the name used to describe the version of Kermit software
  73.     (written in the "C" programming language) that runs on most UNIX
  74.     implementations, DEC VAXes running VMS, NEXT workstations, OS/2, the
  75.     Commodore Amiga, the Atari ST, OS-9, and now Data General AOS/VS.
  76.  
  77.     Revision 7.195 of C-Kermit for AOS/VS is based on release 7.0.195 of
  78.     C-Kermit.
  79.  
  80.     DISCLAIMER
  81.  
  82.     The C-Kermit software is provided in source code form by the Kermit
  83.     Distribution Center at Columbia University.  The software is provided
  84.     "as is;" no other warranty is provided, express or implied, including
  85.     without limitations, any implied warranty of merchantability or implied
  86.     warranty of fitness for a particular purpose.
  87.  
  88.     Neither Data General nor Columbia University warrant C-Kermit for
  89.     AOS/VS software or documentation in any way.  In addition, neither the
  90.     authors of any Kermit programs, publications or documentation, nor
  91.     Columbia University nor any contributing institutions or individuals
  92.     acknowledge any liability resulting from program or documentation
  93.     errors.
  94.  
  95.  
  96.                                                                      3
  97.  
  98.  
  99.     2 Prerequisites
  100.  
  101.  
  102.     To run C-Kermit for AOS/VS Rev 5.188 or later, you need a Data General
  103.     MV-series computer running AOS/VS revision 7.69 or later (DGC Model 3900
  104.     or 31133), or AOS/VS II revision 2.20 or later (DGC Model 31585).
  105.     (Earlier revisions may work, but have not been tested with C-Kermit for
  106.     AOS/VS.)
  107.  
  108.     To run C-Kermit for AOS/VS over a serial connection, you also need a
  109.     line into a port on an intelligent asynchronous controller (DGC IAC or
  110.     equivalent) on the MV.  This line may be directly connected to another
  111.     computer (e.g, a PC) via a null modem cable/adaptor, or it may be
  112.     connected to a telephone line via a modem or a modem eliminator.
  113.  
  114.     To use C-Kermit for AOS/VS over an INCOMING TCP/IP connection, a
  115.     working TCP/IP connection is required.  This connection may be provided
  116.     either by AOS/VS TCP/IP (DGC Model 30997) or by AOS/VS II TCP/IP (DGC
  117.     Model 31758).  Refer to the release notices for those products for
  118.     specific requirements.
  119.  
  120.     To use C-Kermit for AOS/VS over an OUTGOING TCP/IP connection, a
  121.     working implementation of AOS/VS II TCP/IP, revision 1.10 or later, is
  122.     required.
  123.  
  124.     For specific information about the software and hardware requirements
  125.     for TCP/IP connections, refer to the AOS/VS TCP/IP or AOS/VS II TCP/IP
  126.     release notices.
  127.  
  128.  
  129.                                                                      4
  130.  
  131.  
  132.     3 Enhancements
  133.  
  134.  
  135.     The previous version of Kermit for AOS/VS, whose revision number (as
  136.     obtained via the CLI REVISION command) corresponded to the revision of
  137.     the "C" compiler with which it was linked, was based on Columbia
  138.     University's C-Kermit version 4D(61), ported to AOS/VS in 1986.
  139.  
  140.     Since that time, there have been a number of enhancements to C-Kermit
  141.     which are now included in C-Kermit for AOS/VS, including:
  142.  
  143.          *    support for Kermit connections over TCP/IP connections
  144.  
  145.          *    character set translations
  146.  
  147.          *    an extensive script programming language
  148.  
  149.          *    ability to specify what action Kermit should take when a
  150.               filename collision occurs during file transfer
  151.  
  152.          *    support for sliding windows and variable packet sizes
  153.  
  154.          *    support for additional file attributes (e.g., "creation" date
  155.               and time)
  156.  
  157.  
  158.  
  159.                                                                      5
  160.  
  161.  
  162.     4 Notes and Warnings
  163.  
  164.  
  165.       4.1 Known Problems
  166.  
  167.          1.   Abnormal terminations may occasionally occur on expiration of
  168.               certain timers (when, for instance, the local Kermit gets no
  169.               response from the remote Kermit).
  170.  
  171.  
  172.       4.2 Restrictions
  173.  
  174.          1.   The MAIL command has not been implemented
  175.  
  176.          2.   The BYE command has not been implemented.
  177.  
  178.          3.   It is not possible to SUSPEND C-Kermit for AOS/VS sessions.
  179.  
  180.          4.   The WHO command does not accept arguments.
  181.  
  182.          5.   When C-Kermit for AOS/VS is receiving a file, and the file
  183.               collision action is set to "update" (meaning that the
  184.               incoming file should overwrite the existing file only if its
  185.               "creation" date is more recent) and the incoming file is in
  186.               fact newer, the modification date on the resulting file will
  187.               actually be the date/time of the transfer (the real last
  188.               modification date/time).  This can cause succeeding "update"
  189.               operations to fail.
  190.  
  191.          6.   Local Kermit commands that are implemented through CLI calls
  192.               (WHO, DIR, etc.) cannot be interrupted except by entering BRK
  193.               (CMD-BRK on a DG terminal) followed by ^C^A or, as a last
  194.               resort, ^C^B.  (The remote versions can be interrupted with
  195.               ^C.)
  196.  
  197.          7.   C-Kermit for AOS/VS cannot determine the status of modem
  198.               signals on a line.
  199.  
  200.          8.   C-Kermit for AOS/VS makes no attempt to determine, at
  201.               runtime, whether AOS/VS II TCP/IP is running.  Thus, if you
  202.               attempt to make a connection over a TCP/IP stack when AOS/VS
  203.               II TCP/IP is NOT running, there will be a wait until the
  204.               request times out.
  205.  
  206.          9.   The user must ensure that the XLT characteristic on his
  207.               terminal device is turned OFF, prior to starting C-Kermit for
  208.               AOS/VS:
  209.  
  210.                    ) CHAR/OFF/XLT
  211.  
  212.         10.   In some environments, it may be necessary to turn the 8BT
  213.               characteristic ON, prior to starting C-Kermit for AOS/VS,
  214.               in order to transfer binary files:
  215.  
  216.                    ) CHAR/ON/8BT
  217.  
  218.  
  219.                                                                      6
  220.  
  221.  
  222.       4.3 Notes
  223.  
  224.          1.   When C-Kermit for AOS/VS is receiving a file whose name is
  225.               the same as an existing file, and the file collision action
  226.               is "backup" or "rename", the file that is renamed will have a
  227.               .<number> extension, rather than a ~<number>~ extension.
  228.  
  229.          2.   When C-Kermit for AOS/VS is sending a file, question marks
  230.               (?) and dollar signs ($) in the filename will be converted to
  231.               upper-case X's.
  232.  
  233.          3.   When C-Kermit for AOS/VS is receiving a file, hyphens (-)
  234.               will be converted to underscores (_).
  235.  
  236.          4.   C-Kermit for AOS/VS uses the last modification date/time
  237.               rather than the creation date/time in all file transfer
  238.               operations.
  239.  
  240.      5.   C-Kermit for AOS/VS mandates that source files (for file
  241.               transfers) reside in the current working directory, unless
  242.               a pathname is specified.
  243.  
  244.  
  245.  
  246.                                                                      7
  247.  
  248.     5 Documentation
  249.  
  250.  
  251.     Kermit in its generic form has been extensively documented.  In
  252.     particular, the following publications from Digital Press are available
  253.     at bookstores, or by mail order from Digital Press / Butterworth-Heinemann
  254.     in Woburn, Massachusetts, USA:
  255.  
  256.          *    Using C-Kermit Communications Software for UNIX, VAX/VMS,
  257.               OS/2, AOS/VS, Commodore Amiga, Atari ST, and OS-9 -- by Frank
  258.               da Cruz and Christine M. Gianone, Digital Press, 1993.
  259.  
  260.  
  261.          *    Using MS-DOS Kermit -- by Christine M. Gianone (1992)
  262.  
  263.          *    Kermit, a File Transfer Protocol -- by Frank da Cruz (1987)
  264.  
  265.     Digital Press may be contacted directly at:
  266.  
  267.     Digital Press / Butterworth-Heinemann
  268.     225 Wildwood Street
  269.     Woburn, MA  01801  USA
  270.     Phone +1 800 366-2665
  271.     Fax   +1 617 933-6333
  272.  
  273.     Additional documentation about specific implementations of C-Kermit is
  274.     available directly from Columbia University via "anonymous ftp" access
  275.     to the following host:
  276.  
  277.               kermit.columbia.edu        128.59.39.2
  278.  
  279.     All source code is also available from this host, in kermit/test (test
  280.     versions of C-Kermit sources) or kermit/b (current release
  281.     versions).  The AOS/VS-specific modules have filenames that begin with
  282.     the prefix "ckd".
  283.  
  284.     Finally, you can receive an up-to-date Kermit software catalog, listing
  285.     the hundreds of other Kermit software programs available, together with
  286.     ordering instructions, and be placed on the mailing list to receive the
  287.     free journal, "Kermit News", by writing to:
  288.  
  289.          Kermit Distribution, Dept CI
  290.          Columbia University, Academic Information Systems
  291.          612 West 115th Street
  292.          New York, New York  10025
  293.          USA
  294.  
  295.     Phone:  212-854-3703
  296.     E-mail: kermit@columbia.edu (Internet), kermit@cuvma (BITNET)
  297.  
  298.  
  299.                                                                      8
  300.  
  301.  
  302.     6 Product Organization
  303.  
  304.  
  305.     This section describes the C-Kermit for AOS/VS software release
  306.     organization.
  307.  
  308.  
  309.     6.1 File Listing
  310.  
  311.     The media distribution format for C-Kermit for AOS/VS is a disk file in
  312.     AOS/VS DUMP format.  The files that are included with the dumpfile are:
  313.  
  314.          CKERMIT.INI         - the standard C-Kermit initialization file
  315.      CKERMOD.INI.PROTO   - the tailorable initialization file
  316.          KERMIT.CLI.PROTO    - a sample macro for starting Kermit
  317.                              - (a.k.a. "ckdker.cli")
  318.          KERMIT.RN           - the Kermit release notice (this file)
  319.                              - (a.k.a. "ckdins.doc")
  320.          KERMIT.PR           - the Kermit executable image
  321.          KERMIT.ST           - the Kermit symbol table file
  322.  
  323.  
  324.     6.2 Obtaining the Software from Columbia University
  325.  
  326.     The C-Kermit for AOS/VS software is available over the Internet from
  327.     Columbia University, via "anonymous FTP" access to the following
  328.     system:
  329.  
  330.          kermit.columbia.edu        128.59.39.2
  331.  
  332.     There are two versions of the software available on watsun.  The first
  333.     is the AOS/VS dumpfile itself, which must be transferred to your system
  334.     using binary mode.  Its path on watsun is:
  335.  
  336.          kermit/bin/ckdker.df
  337.  
  338.  
  339.                                                                      9
  340.  
  341.  
  342.     Alternatively, you may retrieve the dumpfile in uuencode format, which
  343.     may be transferred over 7-bit connections where binary mode is not
  344.     available.  In this case you must also retrieve the source code for the
  345.     uuencode program (called ckdecod.c).  The pathname on watsun for these
  346.     files is:
  347.  
  348.          kermit/b/ckdker.uue
  349.          kermit/b/ckdecod.c
  350.  
  351.     Once you have compiled and linked ckdecod on your system, you must use
  352.     the resulting executable (ckdecod.pr) to transform ckdker.uue into
  353.     ckdker.df:
  354.  
  355.          ) XEQ CKDECOD CKDKER.UUE
  356.  
  357.     You should move the resulting file, CKDKER.DF to :UTIL, then follow the
  358.     installation instructions later in this notice.
  359.  
  360.  
  361.                                                                      10
  362.  
  363.  
  364.     6.3 Obtaining the Software from a PC Diskette
  365.  
  366.     C-Kermit for AOS/VS is available, in dump file format, with the
  367.     diskette that comes with the "Using C-Kermit..." book described in the
  368.     documentation section of this release notice.  The diskette includes
  369.     both CKDKER.DF and CKDKER.RN (this file).
  370.  
  371.     There are a variety of methods available for transferring the software
  372.     from the diskette to the target MV.  All of them involve a PC.  Those
  373.     methods that are Data General-specific are described briefly here.
  374.  
  375.     Note that in all of these descriptions, the C-Kermit diskette is
  376.     assumed to be in drive A of the PC.
  377.  
  378.     If CEO Connection is running on both your PC and the target MV, follow
  379.     these instructions:
  380.  
  381.             1. Establish a session with the MV system, which can
  382.                be accomplished by choosing #6 (Utilities) from the
  383.                CEO Connection main menu on the PC, then #1 (Log on)
  384.                from the utilities menu.
  385.             2. Choose #4 (Send a file) from the main menu.
  386.             3. When prompted for the MS-DOS pathname, enter
  387.                  a:\ckdker.df
  388.             4. Then specify where the file should be stored
  389.                on the MV.  If you have the proper access privileges,
  390.                store it in :UTIL.  Otherwise, store it in your
  391.                home directory (:UDD:<your username>:CKDKER.DF),
  392.                and then have the MV system manager install it for you.
  393.  
  394.     If your PC is active in a PC*I network (which consists of WTS and the
  395.     Microsoft MS-NET Redirector software on the PC, and the MV Server for
  396.     MS-NET software on the MV), follow these instructions (which assume
  397.     that drive E on your PC is redirected to the MV disk):
  398.  
  399.             1. Establish your redirected drive by issuing the
  400.                appropriate "net use" command.
  401.             2. Change your working directory to a:
  402.                  C:\> a:
  403.             3. Copy the C-Kermit for AOS/VS dumpfile from drive A
  404.                to drive E:
  405.                  A:\> copy ckdker.df e:
  406.             4. Where ckdker.df ends up on the MV will depend on
  407.                the PC*I configuration there.  Contact the MV
  408.                system manager to locate it and install it.
  409.  
  410.  
  411.                                                                      11
  412.  
  413.  
  414.     Finally, if your PC and the MV participate in a Novell Netware network,
  415.     follow these instructions (which assume that drive F on the PC is
  416.     redirected to the MV):
  417.  
  418.             1. Establish your redirected drive by issuing the
  419.                appropriate map command.
  420.             2. Change your working directory to a:
  421.                  C:\> a:
  422.             3. Copy the C-Kermit for AOS/VS dumpfile from drive A
  423.                to drive F:
  424.                  A:\> copy ckdker.df f:
  425.             4. Where ckdker.df ends up on the MV will depend on the
  426.                Netware configuration there.  Contact the MV system
  427.                manager to locate it and install it.
  428.  
  429.     Once the dumpfile has been transferred to the MV, follow the
  430.     installation instructions in Section 7.2 ("Installing the Software").
  431.  
  432.  
  433.                                                                      12
  434.  
  435.  
  436.     7 Installation Instructions
  437.  
  438.  
  439.     This section describes procedures for establishing a communications
  440.     line to use with C-Kermit for AOS/VS and for installing the Kermit
  441.     software.
  442.  
  443.  
  444.     7.1 Establishing a Communications Line
  445.  
  446.  
  447.     7.1.1 Serial Connections
  448.  
  449.     If you have not already established a communications line, you must
  450.     connect your modem or direct connect line to a port on your intelligent
  451.     asynchronous controller, and then describe the line to AOS/VS.  This
  452.     involves a physical line connection as well as running the appropriate
  453.     software (VSGEN) to define the line for use by AOS/VS.  These
  454.     instructions assume that the line has already been defined via VSGEN.
  455.  
  456.     There are two ways to establish an asynch connection:
  457.  
  458.          *    modem connect -- a line connecting a computer to a modem
  459.               which in turn connects to another modem and computer via a
  460.               phone line
  461.  
  462.          *    direct connect -- a line connecting one computer to
  463.               another
  464.  
  465.     For modem connections, an RS-232 modem cable (with pin 2 on one end
  466.     wired to pin 2 on the other end, pin 3 to pin 3, etc.) should be used
  467.     to connect the modem to the port on the asynch controller.  The modem
  468.     configuration itself is beyond the scope of this release notice, but an
  469.     example configuration using a Hayes Smartmodem 1200 is given below.
  470.     (Note that even if your modem is Hayes-compatible, you may still need
  471.     to adjust these settings for your configuration.)  See your modem
  472.     manual for details about your modem.
  473.  
  474.  
  475.                                                                      13
  476.  
  477.  
  478.     Switch  Position  Effect
  479.     ------  --------  ------
  480.       1      DOWN     Normal DTR operation
  481.       2       UP      Result codes are in English
  482.       3      DOWN     Result codes are sent
  483.       4       UP      Modem echoes commands
  484.       5       UP      Enable auto-answer
  485.       6       UP      Force Carrier Detect true (outgoing lines only)
  486.       7       UP      Single-line RJ11 installation
  487.       8      DOWN     Enables command recognition
  488.  
  489.     In particular, certain controllers that support modem signals (older
  490.     IAC/8's, for example) require the presence of Carrier Detect in order
  491.     to receive data from the modem, and Clear to Send in order to send data
  492.     to the modem.  On these lines, Carrier Detect must be strapped high on
  493.     the modem itself.  (Clear to Send will normally be supplied by the
  494.     modem by default.)
  495.  
  496.     On newer controllers, it is possible to override the requirement for
  497.     CTS with the /MDUA characteristics option, and the requirement for CD
  498.     with the /SMCD characteristics option.  Consult your hardware reference
  499.     manuals, or contact your Data General service representative, for
  500.     particulars on your controller.
  501.  
  502.     Some other points to remember include:
  503.  
  504.          *    In general, AOS/VS support for a particular modem line is
  505.               restricted to either incoming access or outgoing access, but
  506.               not both.
  507.  
  508.          *    In general, a given modem can only talk to another modem that
  509.               supports the same communications parameters.  For example, a
  510.               1200 bps modem can only communicate with anther modem that
  511.               supports the same 1200 bps protocol.
  512.  
  513.  
  514.  
  515.                                                                      14
  516.  
  517.  
  518.     As an alternative to using two modems, if the two computers you wish to
  519.     connect are not more than 50 feet (or thereabouts) from one another,
  520.     you can use an RS-232 null modem cable with the following pin-outs:
  521.  
  522.     Host      Target     Signal
  523.     ----      ------     ------
  524.  
  525.        1------1          FG--frame ground
  526.  
  527.        2 \  / 2          TD--transmit data
  528.           \/
  529.           /\
  530.        3 /  \ 3          RD--receive data
  531.  
  532.     |--4      4--|       RTS--request to send
  533.     |            |
  534.     |--5      5--|       CTS--clear to send
  535.  
  536.     |--6      6--|       DSR--data set ready
  537.     |            |
  538.     |  7------7  |       Ground
  539.     |            |
  540.     |--8      8--|       CD---carrier detect
  541.     |            |
  542.     |-20      20-|       DTR--data terminal ready
  543.     |            |
  544.     |-22      22-|       RI--ring indicator
  545.  
  546.  
  547.     Under AOS/VS, most communications parameters must be specified with the
  548.     VSGEN program or the CLI CHARACTERISTICS command.  These parameters
  549.     include the baud rate, the number of data bits, and the parity.
  550.  
  551.     Certain parameters are limited by the hardware.  For example, if you
  552.     have a 1200 bps modem, you should not specify a 2400 baud line through
  553.     the CLI CHARACTERISTICS command (or the Kermit SET SPEED command).
  554.     Under AOS/VS, a modem line must be either originate or answer.
  555.     Incoming modem lines must be under EXEC control; outgoing modem lines
  556.     must not.
  557.  
  558.  
  559.                                                                      15
  560.  
  561.  
  562.     The following characteristics settings are recommended for modem lines
  563.     being used with C-Kermit for AOS/VS:
  564.  
  565.     Signal              VSGEN     CHARACTERISTICS     Setting
  566.     ------              -----     ---------------     -------
  567.     Flow Control        ?MIFC     IFC                 OFF
  568.                         ?MOFC     OFC                 OFF
  569.     Modem               ?MMOD     MOD                 ON for incoming line
  570.                                                       OFF for outgoing line
  571.     Parity              ?PAR0     PARITY              NONE
  572.     Data Bits           ?COD3     CHARLEN             8
  573.     Stop Bits           ?STP0     STOPBITS            1
  574.  
  575.     Normally, the characteristics on a typical Data General console line
  576.     are set to something like this:
  577.  
  578.          ) CHAR
  579.          /605X/LPP=24/CPL=80/BREAK=BMOB/TCC=40000/TCD=5000/TDW=1000/
  580.          THC=2000/TLT=2000/CONTYPE=DIRECT
  581.          /ON/ST/EB0/ULC/WRP
  582.          /OFF/SFF/EPI/8BT/SPO/RAF/RAT/RAC/NAS/OTT/EOL/UCO/MRI/FF/EB1/PM/
  583.          NRM/MOD/TO//ESC/FKT/HOFC/SHR/OFC/IFC/16B/ACC/SRDS/XLT/AUTOBAUD/
  584.          CALLOUT/MDUA/HDPX/SMCD/RTSCD/HIFC/G1G0/DKHW/NLX
  585.  
  586.     The CHARACTERISTICS command can be used to modify the characteristics
  587.     settings so that they are suitable for use with a modem line.
  588.  
  589.     If you will be using a modem to dial OUT from an AOS/VS or AOS/VS II
  590.     system, the console line to which the modem is attached must first be
  591.     disabled from EXEC.  This should be accomplished by the system manager,
  592.     using the following command:
  593.  
  594.          ) CONTROL @EXEC DISABLE @CONnnn
  595.  
  596.     where nnn is a decimal number with one, two, or three digits (e.g.,
  597.     @CON2).
  598.  
  599.     The system manager may also need to modify the default characteristics
  600.     on the modem line.  In general, the characteristics should be set as
  601.     follows (assuming a full-duplex modem):
  602.  
  603.          ) CHAR/DEF/PARITY=NONE/CHARLEN=8/STOPBITS=1/BAUD=xxxx/ON/
  604.          ST/EB0/ULC/WRP/OFF/OFC/IFC/HOFC/HIFC @CONnnn
  605.  
  606.  
  607.                                                                      16
  608.  
  609.  
  610.     Some of these characteristics are described below.  For information on
  611.     all the options available with the CLI CHARACTERISTICS command, issue a
  612.     "HELP/V CHARACTERISTICS" command at the CLI prompt.
  613.  
  614.     CALLOUT        If on, allows host-initiated calls, if they are allowed
  615.                    by the controller.
  616.  
  617.     CHARLEN=x      Specifies the number of bits per character, including
  618.                    stop bits.
  619.  
  620.     HIFC           If off, disables the use of hardware (RTS/CTS) input
  621.                    flow control between the modem and the operating system.
  622.  
  623.     HOFC           If off, disables the use of hardware (RTS/CTS) output
  624.                    flow control between the modem and the operating system.
  625.  
  626.     IFC            If off, disables the use of software (XON/XOFF) input
  627.                    flow control between the modem and the operating system.
  628.  
  629.     OFC            If off, disables the use of software (XON/XOFF) output
  630.                    flow control between the modem and the operating system.
  631.  
  632.     MDUA           If on, allows ?WRITE system calls to be issued on the
  633.                    line, prior to establishment of a connection with a
  634.                    remote modem.  Has no effect unless MOD is also on.
  635.  
  636.     MOD            If on, specifies that a modem interface is in use on
  637.                    this line.  Use of MOD may only be specified on lines
  638.                    that support modem signals (e.g., lines on IAC/8's).
  639.                    When specified, the system will 1) disconnect the line
  640.                    when loss of carrier is detected, 2) limit the amount of
  641.                    time a user has to log in, 3) require that users logging
  642.                    in over this line have modem privileges (as specified
  643.                    through PREDITOR), 4) require that the modem assert
  644.                    Clear to Send (CTS) before allowing writes to be issued
  645.                    on the line, and 5) require the presence of Carrier
  646.                    Detect before allowing writes to be issued on the line
  647.                    (unless /SMCD is also on).
  648.  
  649.     PARITY=xxxx    Sets the parity for the line to the specified value,
  650.                    which may be ODD, EVEN, or NONE.
  651.  
  652.     STOPBITS=x     Specifies the number of stop bits.
  653.  
  654.  
  655.                                                                      17
  656.  
  657.  
  658.     If you will be using a modem to dial IN to an AOS/VS or AOS/VS II
  659.     system, the console line to which the modem is attached must be enabled
  660.     by EXEC.  The system manager should enable the line with the following
  661.     command:
  662.  
  663.          ) CONTROL @EXEC ENABLE @CONnnn
  664.  
  665.     where nnn is a decimal number with one, two, or three digits (e.g.,
  666.     @CON2).
  667.  
  668.     The system manager may also need to modify the default characteristics
  669.     for the line.  The default characteristics will take effect the next
  670.     time the line is opened.  In general, the characteristics should be
  671.     modified as follows (for use with a full-duplex modem):
  672.  
  673.          ) CHAR/DEF/PARITY=NONE/CHARLEN=8/STOPBITS=1/BAUD=xxxx/ON/MOD/
  674.          ST/EB0/WRP/ULC/OFF/IFC/OFC/HIFC/HOFC @CONnnn
  675.  
  676.     Descriptions of other characteristics options that you may find useful
  677.     for modem lines are listed below.  For a full listing, issue a "HELP/V
  678.     CHARACTERISTICS" command at the CLI prompt.
  679.  
  680.     AUTOBAUD       If on, specifies that the system should automatically
  681.                    determine the speed associated with the incoming call
  682.                    (in which case the remote user must press the NEW LINE
  683.                    or ENTER key three times, once the modems have
  684.                    connected, so that the system may determine the speed of
  685.                    the terminal).
  686.  
  687.     SMCD           If on, directs the system to ignore Carrier Detect on
  688.                    modem-controlled lines.  This characteristic is only
  689.                    valid on lines where MOD is set to on.
  690.  
  691.  
  692.                                                                      18
  693.  
  694.  
  695.     TCC=xxxx       On a modem line, the number of milliseconds the system
  696.                    will wait for a carrier detect (CD) signal.
  697.  
  698.     TCD=xxxx       On a modem line, the number of milliseconds the system
  699.                    will tolerate loss of carrier detect.
  700.  
  701.     TDW=xxxx       On a modem line, the number of milliseconds after a
  702.                    modem connection that the system will wait before
  703.                    attempting I/O to the line.
  704.  
  705.     THC=xxxx       On a modem line, the number of milliseconds after a
  706.                    modem disconnect that the system will wait for the modem
  707.                    to settle.
  708.  
  709.  
  710.                                                                      19
  711.  
  712.  
  713.     7.1.2 TCP/IP Connections
  714.  
  715.     C-Kermit for AOS/VS may be used to establish connections over existing
  716.     TCP/IP networks.  Installing TCP/IP is beyond the scope of this release
  717.     notice, so see the relevant TCP/IP documentation for more information.
  718.  
  719.     Once TCP/IP is installed and running, there are no particular
  720.     Kermit-specific installation requirements.  An outgoing Kermit
  721.     connection can be established by using the Kermit "telnet <host>"
  722.     command, where <host> may be either a hostname found in the :etc:hosts
  723.     file, or an Internet address in standard "dot" notation.  This method
  724.     of establishing a TCP/IP connection with Kermit causes the Telnet port
  725.     (23) to be used on the connection.
  726.  
  727.     Alternatively, other ports may be specified using the format "telnet
  728.     <host>:<port number>".
  729.  
  730.     Note that outgoing TCP/IP connections can only be initiated with AOS/VS
  731.     II TCP/IP.
  732.  
  733.  
  734.                                                                      20
  735.  
  736.  
  737.     7.2 Installing the Software
  738.  
  739.     Once you've retrieved the software, follow these instructions (which
  740.     assume that the Kermit dump file is located in :UTIL) to load it onto
  741.     your AOS/VS system:
  742.  
  743.          ) SUPERUSER ON
  744.  
  745.          ) DIR :UTIL
  746.  
  747.          ) CREATE/DIR KERMIT
  748.  
  749.          ) DIR KERMIT
  750.  
  751.          ) LOAD/V :UTIL:CKDKER.DF
  752.  
  753.     If you are installing C-Kermit for AOS/VS for public access, it is
  754.     recommended that you copy the following files into :UTIL:
  755.  
  756.          ) COPY/V :UTIL:CKERMIT.INI CKERMIT.INI
  757.  
  758.      ) COPY/V :UTIL:CKERMOD.INI CKERMOD.INI.PROTO
  759.  
  760.          ) COPY/V :UTIL:KERMIT.CLI KERMIT.CLI.PROTO
  761.  
  762.     CKERMIT.INI is the standardized C-Kermit initialization file.  It should
  763.     not be edited.  Instead, individual users should copy CKERMOD.INI into
  764.     their home directories, then use an editor such as SED to make any
  765.     changes they desire.
  766.  
  767.     KERMIT.CLI may be modified to suit your site's requirements.
  768.  
  769.     Now create the following link in :UTIL:
  770.  
  771.          ) CREATE/LINK KERMIT.PR :UTIL:KERMIT:KERMIT.PR
  772.  
  773.     The installation of C-Kermit for AOS/VS is now complete.
  774.  
  775.  
  776.                                                                      21
  777.  
  778.  
  779.     8 User Notes
  780.  
  781.     If you are accessing the Data General AOS/VS system via an incoming
  782.     connection, some changes via the CHARACTERISTICS command may be
  783.     required, depending on your terminal type.
  784.  
  785.     If you are accessing the Data General system using Kermit on a PC, you
  786.     should use the d463 terminal emulator, which will allow you to emulate
  787.     a native Data General terminal.  The default characteristics for the
  788.     line should be adequate in that event.
  789.  
  790.     If, on the other hand, you are not using a Data General terminal or
  791.     terminal emulator, then your next best bet is to use a VT220 or VT320
  792.     emulator.  When you log in with a VTxxx emulator, you may notice that
  793.     certain keys don't operate as expected -- for example, the backspace
  794.     and ENTER keys.  In this case, you should issue the following command
  795.     once you have logged in:
  796.  
  797.          ) CHAR/ON/NAS/XLT
  798.  
  799.     Here are brief descriptions of the NAS and XLT characteristics:
  800.  
  801.     NAS            If on, specifies a non-ANSI standard terminal.  On
  802.                    input, this causes a carriage return to be converted to
  803.                    a carriage return and a line feed, and a line feed to be
  804.                    converted to a carriage return.  On output, it causes a
  805.                    line feed to be converted to a carriage return and a
  806.                    line feed.
  807.  
  808.     XLT            If on, enables support for the VT100-compatible family
  809.                    of terminals.  (Support for VT100-compatible terminals
  810.                    must have been specified by the system manager in
  811.                    advance during system generation.  If you turn XLT on,
  812.                    but still have problems with the backspace key, check
  813.                    this with the system manager.)
  814.  
  815.     NOTE:  The XLT characteristic must be OFF before C-Kermit for AOS/VS is
  816.     used to perform file transfers.
  817.  
  818.     In order to use international character sets, you must issue the
  819.     following command:
  820.  
  821.          ) CHAR/ON/8BT
  822.  
  823.     where 8BT impacts the line as follows:
  824.  
  825.     8BT            If on, causes all 8 bits of a character to be treated as
  826.                    data.
  827.  
  828.  
  829.                                                                      22
  830.  
  831.  
  832.     These changes to your console's characteristics via the CHARACTERISTICS
  833.     command will only be in effect for the current session.  To have them
  834.     take effect in all of your terminal sessions, you can include the
  835.     CHARACTERISTICS command that sets them to the desired values in your
  836.     LOGON.CLI macro (or equivalent).  Check with your system manager for
  837.     more information.
  838.  
  839.     The name of the Kermit executable image is KERMIT.PR.  To see if it
  840.     exists on your system, issue the following command:
  841.  
  842.          ) PATHNAME KERMIT.PR
  843.  
  844.     If the system returns an indication that it found KERMIT.PR, then you
  845.     should check the revision number on it by issuing a REVISION command:
  846.  
  847.          ) REV/V KERMIT.PR
  848.  
  849.     The revision should be 00.05.188.00, or greater.  If it is not, it is
  850.     an older revision of AOS/VS Kermit, and may not have the capabilities
  851.     associated with other implementations of C-Kermit.
  852.  
  853.     If Kermit does not appear to exist on your system, or has an earlier
  854.     revision number than 00.05.188.00, check with the system manager.
  855.     Otherwise, check to see if the KERMIT.CLI macro exists:
  856.  
  857.          ) PATHNAME KERMIT.CLI
  858.  
  859.     You can use this macro to start AOS/VS Kermit:
  860.  
  861.          ) KERMIT
  862.  
  863.     If your system does not have a KERMIT.CLI macro, you can start
  864.     KERMIT.PR directly by typing:
  865.  
  866.          ) X KERMIT
  867.  
  868.  
  869.  
  870.                                                                      23
  871.  
  872.  
  873.     AOS/VS Kermit uses an initialization file called CKERMIT.INI.  There
  874.     should be a copy on your system in :UTIL.  If there is, you can simply
  875.     use that rather than creating a copy in your :UDD directory.  (The
  876.     KERMIT.CLI macro will check to see if there is a CKERMIT.INI in your
  877.     :UDD directory.  If there is, it will use that as your initialization
  878.     file; otherwise, it will look in :UTIL.)
  879.  
  880.     CKERMIT.INI causes various initialization steps to be performed when
  881.     Kermit starts up.  Normally, CKERMIT.INI should not be modified.
  882.     Instead, if there are changes you wish to make in the initialization
  883.     procedure, you can create your own CKERMOD.INI in your home directory,
  884.     using SED or another text editor.  There should be a sample version
  885.     of CKERMOD.INI in :UTIL that you can use as a template.  (For
  886.     information on using SED, enter X SED <filename> to start it up;
  887.     once you are in, you can issue the HELP command for instructions
  888.     on how to use it.)
  889.  
  890.  
  891.                          --- End of release notice ---
  892.  
  893.