home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / c-kermit / ckvins.txt < prev    next >
Text File  |  2020-01-01  |  75KB  |  1,732 lines
  1.  
  2.    [1]The Columbia Crown The Kermit Project | Columbia University
  3.    612 West 115th Street, New York NY 10025 USA o [2]kermit@columbia.edu
  4.    ...since 1981
  5.    [3]Home [4]Kermit 95 [5]C-Kermit [6]Scripts [7]Current [8]New [9]FAQ
  6.    [10]Support
  7.  
  8. C-Kermit 8.0 Installation Instructions for VMS
  9.  
  10.    [ [11]Contents ] [ [12]C-Kermit ] [ [13]Kermit Home ]
  11.  
  12.       As of C-Kermit version: 9.0.300, 30 June 2011
  13.       This file last updated: Sun Aug 21 12:16:39 2011 (New York City
  14.    time)
  15.       Note: Edits 301 and 302 are identical to 300 for VMS.
  16.  
  17.      IF YOU ARE READING A PLAIN-TEXT version of this document, note that
  18.      this file is a plain-text dump of a Web page. You can visit the
  19.      original (and possibly more up-to-date) Web page here:
  20.  
  21.   [14]http://www.columbia.edu/kermit/ckvins.html
  22.  
  23.    Authors:
  24.           F. da Cruz, C. Gianone, M. Evarts, Columbia University, New
  25.           York, NY.
  26.           Terry Kennedy, Saint Peters College, Jersey City, NJ.
  27.           And: Peter Mossel, James Sturdevant, Richard Gilbert, Sebastian
  28.           Bazley.
  29.  
  30. CONTENTS
  31.  
  32.   1. [15]QUICKSTART GUIDE
  33.   2. [16]BOOTSTRAPPING
  34.   3. [17]CONFIGURING VMS FOR BEST RESULTS WITH KERMIT
  35.      3.1. [18]TERMINAL BUFFER SIZE
  36.      3.2. [19]USER QUOTAS AND PRIVILEGES
  37.      3.3. [20]CONFIGURING SERIAL COMMUNICATION PORTS
  38.      3.4. [21]CONFIGURING LAT DEVICES
  39.      3.5. [22]THE VIRTUAL TERMINAL DRIVER
  40.      3.6. [23]CAPTIVE ACCOUNTS AND RESTRICTED ACCESS
  41.   4. [24]DECODING VMS C-KERMIT HEX FILES
  42.   5. [25]INSTALLING VMS C-KERMIT
  43.   6. [26]USING MODEMS
  44.   7. [27]BUILDING VMS C-KERMIT FROM THE SOURCE CODE
  45.      7.1. [28]PROGRAMMING TIPS
  46.      7.2. [29]VMS TCP/IP NETWORKING SUPPORT FOR C-KERMIT
  47.   8. [30]CASE STUDY: ALPHA SETUP AND TEST RESULTS
  48.   9. [31]MAKING AND USING VMSINSTAL KITS)
  49.  
  50. 1. QUICKSTART GUIDE
  51.  
  52.    To install VMS C-Kermit on VAX/(Open)VMS 5.0 or later, and Alpha
  53.    OpenVMS (all versions), please follow the instructions in the next
  54.    three major sections of this file. VMS C-Kermit will also be available
  55.    for the IA64 (Itanium) as soon as the IA64 version of VMS is released.
  56.    Section 3, [32]Configuring VMS for Best Results with Kermit, contains
  57.    important information needed to achieve solid performance from
  58.    C-Kermit. Please read it and follow the suggestions or give it to your
  59.    system manager. Section 4, [33]Decoding VMS C-Kermit Hex Files,
  60.    explains the process required to create an executable image from the
  61.    "text-only" HEX files. These HEX files are distributed on the ANSI
  62.    tapes from Columbia University and are decoded using an
  63.    assembly-language program which is also provided. If you have received
  64.    VMS C-Kermit on TK50 tape in BACKUP format, then you already have
  65.    binary executable files included on the tape. Section 5, [34]Installing
  66.    VMS C-Kermit, gives step-by-step instructions for making C-Kermit
  67.    available and fully configured for your users.
  68.  
  69.    If you are running a version of VMS *prior* to 5.0, or need to
  70.    customize the C-Kermit sources, please refer to [35]Section 5.
  71.  
  72.    [ [36]Contents ] [ [37]C-Kermit ] [ [38]Kermit Home ]
  73.  
  74. 2. BOOTSTRAPPING
  75.  
  76.    In many cases, you can get C-Kermit onto your VMS system using FTP, an
  77.    old version of Kermit that is already there, or some other existing
  78.    file transfer method, or by copying it from magnetic tape, diskette, or
  79.    CDROM.
  80.  
  81.    In case none of those methods are available to you, here is a method to
  82.    "bootstrap" C-Kermit onto a VAX system from another computer. It uses
  83.    the older and smaller "Kermit-32" program (which runs only on VAXes,
  84.    not Alphas) to load the newer and larger C-Kermit program.
  85.  
  86.    Suppose, for example, you have a PC with DOS, Windows, or some form of
  87.    UNIX such as Linux, which has FTP capability, and the PC is connected
  88.    to your VAX through its serial port (directly, with a [39]null modem
  89.    cable, or else through a modem), and the PC already has its own Kermit
  90.    program installed (MS-DOS Kermit, Kermit 95, or C-Kermit, depending on
  91.    the OS). Here are specific instructions you can try; this example
  92.    assumes the PC has Linux and C-Kermit:
  93.  
  94.     1. Get the files vmsmit.hex and vmsdeh.mar with anonymous ftp in text
  95.        mode onto your PC from:
  96.   [40]ftp://kermit.columbia.edu/kermit/b
  97.  
  98.        Also get the appropriate version of VMS C-Kermit on your PC from
  99.        the C-Kermit website:
  100.   [41]http://www.columbia.edu/kermit/ckermit.html
  101.  
  102.     2. Use C-Kermit on Linux to log in to VMS:
  103.   set line /dev/ttyS0 ; or whatever
  104.   set speed 19200
  105.   set flow xon/xoff
  106.   set transmit eof \26
  107.   connect
  108.  
  109.     3. Log in to VMS, SET DEFAULT to the desired directory, and then give
  110.        the following commands at the VMS prompt:
  111.   set terminal /ttsync /hostsync
  112.  
  113.     4. Give the following command at the VMS prompt:
  114.   create vmsmit.hex
  115.  
  116.     5. Escape back to C-Kermit on Linux with Ctrl-\ C.
  117.     6. Tell C-Kermit to:
  118.   transmit vmsmit.hex
  119.  
  120.     7. Repeat steps 4-6 for VMSDEH.MAR.
  121.     8. Now you should have VMSMIT.HEX and VMSDEH.MAR in your VMS
  122.        directory. Give the following commands to VMS:
  123.   macro vmsdeh
  124.   link vmsdeh
  125.   run vmsdeh
  126.  
  127.     9. When VMSDEH prompts for a filename, type "vmsmit.hex".
  128.    10. When VMSDEH is finished, it prompts you for another filename. Just
  129.        press the Enter (Return) key.
  130.    11. Now VMSMIT.EXE should be in your directory. To run it, type:
  131.   run vmsmit
  132.  
  133.        at the VMS prompt.
  134.    12. Use this program to transfer the appropriate version of C-Kermit to
  135.        VMS, and then you will have a modern, fast, up-to-date version of
  136.        Kermit.
  137.  
  138.    WARNING: You can't use Kermit-32 ("Bliss Kermit") to receive a VMS
  139.    binary program. If you have to use Kermit-32 to get C-Kermit onto your
  140.    VAX, you'll need to transfer a hex-encoded version of the binary,
  141.    rather than the straight binary, and then "dehexify" the result as
  142.    shown above. This is because Kermit-32 stores incoming binary files in
  143.    a format that is not appropriate for VMS executables (variable 510
  144.    instead of fixed 512).
  145.  
  146.    [ [42]Contents ] [ [43]C-Kermit ] [ [44]Kermit Home ]
  147.  
  148. 3. CONFIGURING VMS FOR BEST RESULTS WITH KERMIT
  149.  
  150. 3.1. Terminal Buffer Size
  151.  
  152.    VMS is shipped with default installation parameters designed to
  153.    function on all possible configurations. Some of these parameters have
  154.    not been changed since the "average" VMS system was a VAX-11/780 with
  155.    1Mb of memory.
  156.  
  157.    The main parameter that affects Kermit is the terminal type-ahead
  158.    buffer size, which applies to serial terminal devices (with the TT or
  159.    TX prefix). There are two possible values in VMS - the "normal" size
  160.    and the "alternate" size. The defaults for these are 78 and 200 bytes,
  161.    respectively. If more data arrives at the terminal driver than these
  162.    buffers can hold (which is a likely occurrence during file transfer),
  163.    it will be discarded and file transfers will be slowed down or
  164.    terminated by errors.
  165.  
  166.    This is most frequently seen when receiving files on a slow VAX,
  167.    particularly when using long packets and/or sliding windows. File
  168.    reception requires larger system buffers (to hold arriving packets),
  169.    and the speed of the VAX controls how quickly Kermit can empty them.
  170.  
  171.    The recommended minimum size for each of these buffers is the number
  172.    shown as "Buffer size" by the C-Kermit SHOW PROTOCOL command, which is
  173.    the total amount of memory allocated by C-Kermit for packet buffers
  174.    (window slots times packet length). VMS C-Kermit is shipped with a
  175.    buffer size of 9065, which can be altered by the user with a SET
  176.    BUFFERS command.
  177.  
  178.    To change the values of the VMS typeahead buffer sizes, you should edit
  179.    the file SYS$SYSTEM:MODPARAMS.DAT. Determine the new values you want to
  180.    use and add lines like the following to the end of the MODPARAMS.DAT
  181.    file:
  182.  
  183.   MIN_TTY_TYPAHDSZ = new_value_for_regular      ! For VMS C-Kermit
  184.   MIN_TTY_ALTYPAHD = new_value_for_alternate    ! For VMS C-Kermit
  185.  
  186.    for example:
  187.  
  188.   MIN_TTY_TYPAHDSZ = 2064
  189.   MIN_TTY_ALTYPAHD = 2064
  190.  
  191.    The TTY_ALTYPAHD size should be at least as great as the TTY_TYPAHDSZ.
  192.    Digital recommends a value of 2064 or greater for TTY_ALTYPAHD if you
  193.    are running VMS V5.5 or higher, or if you are running the optional
  194.    LATmaster code under VMS V5.4-1, -2, or -3.
  195.  
  196.    You should also examine this file to be sure there aren't any other
  197.    definitions for TTY_TYPAHDSZ or TTY_ALTYPAHD. If there are, you'll get
  198.    warning messages in the next step.
  199.  
  200.      You may wish to simply set TTY_TYPAHDSZ=TTY_ALTYPAHD=2064, since
  201.      most common VMS "TTY ports" these days are actually LAT or TCP/IP
  202.      devices, which cannot easily be configured to use the alternate
  203.      buffer. Also, it takes a privileged user or program to set a port to
  204.      use the alternate buffer, and since we do not recommend installing
  205.      Kermit with privileges, this would restrict Kermit access to
  206.      privileged users.
  207.  
  208.      Let's consider a medium-sized VAX with perhaps 64 "ports" (either
  209.      serial ports or LAT or TCP/IP network ports). This system probably
  210.      has at least 16 megabytes of memory. Configuring TTY_TYPAHDSZ to
  211.      2064 will take up 64 * 2064 bytes of memory, or 132096 bytes. This
  212.      is less than 1 per cent of available memory. Most systems would have
  213.      more than 16Mb of memory for 64 simultaneous users, lowering the
  214.      percentage even further.
  215.  
  216.    In some cases, it might also be necessary to increase your system's
  217.    MAXBUF parameter. It should be somewhat longer than the longest packet
  218.    you want Kermit to be able to send or receive, to allow for SYS$QIO
  219.    overhead (the bigger the value, the more overhead). DEC currently
  220.    recommends 2300, which should be sufficient for 2K (2048-byte) packets.
  221.    If you want to use C-Kermit's maximum packet length, 9024, then your
  222.    MAXBUF should be set to about 12000. Do this in the
  223.    SYS$SYSTEM:MODPARAMS.DAT file:
  224.  
  225.   MIN_MAXBUF=xxxx
  226.  
  227.    You should also ensure that PQL_MBYTLM is at least MAXBUF + 2300;
  228.    otherwise, at least on early 5.x VMS releases (reportedly), the system
  229.    can crash.
  230.  
  231.    To have these changes take effect, run the "AUTOGEN" procedure:
  232.  
  233.   @SYS$UPDATE:AUTOGEN GETDATA SETPARAMS
  234.  
  235.    or:
  236.  
  237.   @SYS$UPDATE:AUTOGEN SAVPARAMS SETPARAMS
  238.  
  239.    or:
  240.  
  241.   @SYS$UPDATE:AUTOGEN SAVPARAMS GENPARAMS FEEDBACK
  242.   DIFFERENCE/OUTPUT=DIFF.DAT/PARALLEL SETPARAMS.DAT
  243.   EDIT/TPU DIFF.DAT ! Check out what Autogen is going to do to me.
  244.   @SYS$UPDATE:AUTOGEN SETPARAMS REBOOT
  245.  
  246.    (Read about AUTOGEN in the VMS Guide to System Management)
  247.  
  248.    This incorporates the new buffer sizes into the system configuration,
  249.    and they will take effect the next time the system is reloaded.
  250.  
  251.    To examine your system parameters:
  252.  
  253.   run sys$system:sysgen
  254.   SYSGEN> use current
  255.   SYSGEN> show maxbuf                (should be at least 2064)
  256.   SYSGEN> show virtualpagecnt        (should be at least 50000)
  257.   SYSGEN> show /tty                  (TTY_ALTYPAHD should be at least 2064)
  258.  
  259.    In an emergency, or for testing purposes, you can also change your
  260.    MIN_MAXBUF value "on the fly":
  261.  
  262.   $ run sys$system:sysgen
  263.   SYSGEN> set maxbuf 2300
  264.   SYSGEN> write active
  265.   SYSGEN> exit
  266.  
  267.    This operation should be used with caution, and should probably NOT be
  268.    used with values greater than about 3000. The AUTOGEN procedure is
  269.    safer because it understands the relationships among the major
  270.    parameters.
  271.  
  272.    NOTE: Although it is still recommended that you make your MAXBUF
  273.    setting large enough for Kermit packets, it is (as of C-Kermit edit
  274.    190) no longer strictly necessary. C-Kermit's packet writer now
  275.    recovers from MAXBUF and quota-exceeded errors automatically by backing
  276.    off and retransmitting the packet in appropriate-size chunks (size
  277.    determined by trial and error). But this involves a small amount of
  278.    additional overhead, so it's still best to have adequate MAXBUF and
  279.    quotas.
  280.  
  281. 3.2. User Quotas and Privileges
  282.  
  283.    C-Kermit communications are also affected by the user's BYTLM quota and
  284.    possibly also the process page quota (PGFLQUO). Also the BIOLM quota
  285.    (should be at least 10 or 20).
  286.  
  287.    In modern versions of VMS, the default BYTLM quota is 8192, which
  288.    should normally be adequate. If C-Kermit users experience error
  289.    messages informing them that a quota was exceeded during terminal
  290.    emulation or file transfer, the system manager should increase the
  291.    user's BYTLM and/or process page quota. To find out the user's quotas,
  292.    the system manager should:
  293.  
  294.   set default sys$system
  295.   run authorize
  296.   UAF> show <username>
  297.  
  298.    Then look for the relevant quotas and adjust them as required. The
  299.    BYTLM quota should be somewhat greater than the product of Kermit's
  300.    window size and packet size, for example, 8192 for 4 window slots and
  301.    2000-byte-packets. PGFLQUO should be 20,000 or higher.
  302.  
  303.    If users will be using C-Kermit's PUSH command or issuing REMOTE
  304.    commands (such as REMOTE DIR) to the VMS C-Kermit server, the user will
  305.    need to have the ability to create subprocesses (AUTHORIZE parameter
  306.    PRCLM). If Kermit will itself be invoked as a subprocess (for example,
  307.    from within a menu system) this should be considered as well. Kermit
  308.    uses local mailboxes for remote command execution, so users will also
  309.    need the TMPMBX privilege if these commands are to be used.
  310.  
  311. 3.3. Configuring Serial Communication Ports
  312.  
  313.    If your system has a port that is frequently used for file transfers
  314.    (for example, with a modem), you should have your system manager enable
  315.    the alternate type-ahead buffer, and direct memory access, by placing
  316.    the command:
  317.  
  318.   $ SET TERMINAL ddcu:/PERMANENT/ALTYPEAHD/DMA
  319.  
  320.    in the system-wide startup command file, where ddcu: is the name of the
  321.    device, for each such device. If DMA is not enabled, Kermit will run
  322.    more slowly and use a lot more CPU time. (Note: DMA is only available
  323.    on certain types of devices; e.g. TX but not TT or LTA).
  324.  
  325.    If the device is connected to a modem, and is to be used for dialing
  326.    out, also include the /MODEM qualifier:
  327.  
  328.   $ SET TERMINAL ddcu:/PERMANENT/ALTYPEAHD/DMA/MODEM
  329.  
  330.    The modem must also be configured to make DSR follow CD. In modems that
  331.    use the Hayes AT command set, the command is AT&S1. If you can't
  332.    configure your modem this way, then VMS will hang up on it during the
  333.    dialing process, preventing you from completing calls (C-Kermit's DIAL
  334.    command will make this setting in the modem for you on a per-call
  335.    basis, but only if this information is in its internal modems database;
  336.    tell C-Kermit to SET MODEM TYPE xxx and then SHOW MODEM to find out). A
  337.    less desirable workaround is to configure the modem to ignore DTR
  338.    (AT&D0), but this can block normal hangup methods even when you want to
  339.    use them, thus opening security loopholes. A third possibility is to
  340.    jumper the [45]CD and DSR wires in your modem cable.
  341.  
  342.    If the VMS port is not connected to a modem or other data
  343.    communications device that follows the RS-232 (V.24) signaling
  344.    conventions, or if the VMS port does not have a full complement of
  345.    RS-232 wires (which are lacking in modular MMJ ports, for example), you
  346.    might have to set the /NOMODEM qualifier instead:
  347.  
  348.   $ SET TERMINAL ddcu:/PERMANENT/ALTYPEAHD/DMA/NOMODEM
  349.  
  350.    Even with these settings you might experience what UNIX users know
  351.    fondly as "getty babble", which occurs when logins are enabled on the
  352.    device. This occurs with Kermit, SET HOST/DTE, or any other method of
  353.    communication; for example, AT<CR> is sent to the modem, the modem
  354.    echoes AT<CRLF> and then says OK<CRLF>. VMS thinks a user named AT is
  355.    trying to log in with a password of OK, and says "User authorization
  356.    failure", but the modem echoes this too, and so on, back and forth,
  357.    many times, maybe forever. Reportedly, this can be prevented by giving
  358.    the SECURE attribute to the port in question, e.g.:
  359.  
  360.   $ SET TERMINAL ddcu:/PERMANENT/SECURE
  361.  
  362.    which disables logins on the port until a BREAK signal is received.
  363.  
  364.    Additionally, for non-privileged users to access a terminal device,
  365.    they need to be granted access to it. The default for terminals is
  366.    access only by users with SYSTEM privileges (UIC group less than or
  367.    equal to MAXSYSGROUP, or with SYSPRV privilege). See the VMS
  368.    documentation for the SET PROTECTION command for more information. Note
  369.    that if you grant everyone access to the port, anyone can make phone
  370.    calls via the modem, so you might want to limit this to particular
  371.    users, possibly by using a device ACL (VMS V5.0 and later only).
  372.  
  373. 3.4. Configuring LAT Devices
  374.  
  375.    In this discussion, we are using a DECserver 700-16 (the kind with
  376.    MMJ/RJ45 connectors that lack a full complement of modem signals). (For
  377.    examples of configuring the DECserver 200, also see [46]Section 5.)
  378.  
  379. 3.4.1. Connecting a LAT Port to a PC
  380.  
  381.    We'll begin by connecting a PC's serial port to DECserver Port 2.
  382.    Commands are given at the DECserver's console, normally Port 1. In case
  383.    it is a new DECserver and you haven't yet given it a name:
  384.  
  385.   Local> set privilege
  386.   Local> define server name latbox
  387.   Local> initialize delay 0
  388.  
  389.    We'll be using the server name "latbox" in the examples. Now set up
  390.    port minimally for a test:
  391.  
  392.   Local> define port 2 autobaud disable
  393.   Local> define port 2 speed 19200
  394.   Local> define port 2 signal check disable
  395.   Local> logout port 2
  396.  
  397.    Then:
  398.  
  399.     1. Plug a BN25G-04 cable into LAT port 2.
  400.     2. Plug the appropriate adapter (H8585-something) into the other end
  401.        and connect it to the PC's serial port. In this case, the PC has a
  402.        DB-9, so we use the H8585-AA.
  403.     3. Start Kermit on the PC and tell it to:
  404.   SET PORT COM1 (or whatever)
  405.   SET SPEED 19200
  406.   SET FLOW NONE
  407.   SET CARRIER OFF
  408.   CONNECT
  409.  
  410.     4. Press the Enter key. You should see the Local> prompt, and you
  411.        should be able to type commands, e.g. to connect to your VMS
  412.        system.
  413.  
  414.    OK, so it works in local mode. If not, check your cabling. Now to set
  415.    it up for remote mode, i.e. to allow VMS to make a connection to the PC
  416.    through the DECserver port:
  417.  
  418.   Local> change port 2 access remote
  419.   Local> show port 2
  420.  
  421.    Take note of the port's name; by default it is PORT_2, but you can
  422.    change it to anything you like with:
  423.  
  424.   Local> change port 2 name blah
  425.  
  426.    We'll stick with PORT_2 in this discussion.
  427.  
  428.    With Kermit on the PC is still in CONNECT mode, do:
  429.  
  430.   Local> test port 2
  431.  
  432.    This should put a test pattern on PC screen.
  433.  
  434.    Now to set up the port for use from VMS. First enable SYSPRV, CMKRNL,
  435.    LOG_IO, and SYSNAM privileges, then:
  436.  
  437.   $ run sys$system:latcp
  438.   LATCP> create port lta600:
  439.   LATCP> set port lta600: /application /node=latbox /port=port_2 /noqueue
  440.   LATCP> exit
  441.  
  442.    The /NODE switch gives the nodename of the DECserver; the /PORT switch
  443.    gives the port *name* (not number) of the port on the DECserver. The
  444.    /NOQUEUE switch is important; otherwise if somebody does "set port
  445.    lta600" when it is in use, they will sit there and wait until it
  446.    becomes free.
  447.  
  448.    Then in VMS:
  449.  
  450.   $ set terminal LTA600: /permanent /fullduplex /altypeahd /speed=19200
  451.  
  452.    This sets the typeahead buffer and makes the speeds match. You can use
  453.    LATCP again to verify the setup:
  454.  
  455.   $ run sys$system:latcp
  456.   LATCP> show port lta600:
  457.  
  458.   Target Port Name: PORT_2       Actual Port Name:
  459.   Target Node Name: LATBOX       Actual Node Name:
  460.   Target Service Name:           Actual Service Name:
  461.  
  462.    (Use "show port" without any port number to look at all defined LAT
  463.    ports.)
  464.  
  465.    That's it. Now start kermit and assign the port:
  466.  
  467.   $ kermit
  468.   C-Kermit> set line lta600:
  469.   C-Kermit> show communications
  470.  
  471.    This should display the name and speed of the LAT device, as configured
  472.    above. Then to make the connection:
  473.  
  474.   C-Kermit> connect
  475.  
  476.    Type some characters to VMS C-Kermit -- you should see them come out on
  477.    the PC's screen. Type some characters on the PC keyboard and they
  478.    should come out on VMS C-Kermit's screen.
  479.  
  480.    On the PC, escape back to the Kermit prompt and type "show comm" or
  481.    "show modem" to see what modem signals are being presented by the
  482.    connection. DECservers that have 25-pin serial connectors, such as the
  483.    200 and the 700-8, can do full modem control, but those with mini
  484.    connectors, such as the 700-16, make you choose between limited sets of
  485.    modem signals; the DECserver can be configured for either hardware flow
  486.    control (recommended for high-speed connections) or DTR/CD (allowing
  487.    each end of the connection to tell when the other end has hung up), but
  488.    you can't have both. On the DECserver, use:
  489.  
  490.   Local> define port 2 signal select xxx
  491.  
  492.    where xxx is CTS-DSR-RTS-DTR or RI-DCD-DSR-DTR, to select the desired
  493.    complement of modem signals; the first one for hardware flow control,
  494.    the second one for ring/hangup control.
  495.  
  496.   Local> define port 2 signal control enable
  497.   Local> logo port 2
  498.  
  499.    On the PC, use "show comm" to make sure the PC sees the CTS signal. If
  500.    so, tell Kermit to:
  501.  
  502.   set flow rts/cts
  503.  
  504.    Then put the PC Kermit in server mode and, using VMS C-Kermit as
  505.    client, transfer some files. Experiment with window size, packet
  506.    length, and unprefixing to achieve the highest transfer rate. Then
  507.    experiment with higher serial speeds -- this will require a LATCP
  508.    command on VMS, "change port" and "logout port" commands on the
  509.    DECserver, and a "set speed" command in PC Kermit.
  510.  
  511. 3.4.2. Setting Up a Dialout Port
  512.  
  513.    Now let's connect a modem to DECserver Port 3 for high-speed data
  514.    transfer (RTS/CTS, but no RI/CD). In this example the modem is a USR
  515.    Courier.
  516.  
  517.    Connect port 3 (in this case with BN25G-04 cable with an H8585-AC
  518.    adapter) to the modem. Then at the DECserver:
  519.  
  520.   Local> set privilege
  521.   Local> define port 3 autobaud disable
  522.   Local> define port 3 speed 38400
  523.   Local> define port 3 signal select cts
  524.   Local> define port 3 signal check enable
  525.   Local> define port 3 access remote
  526.   Local> define port 3 name dialout
  527.   Local> logout port 3
  528.   Local> show port 3
  529.  
  530.    Back at VMS:
  531.  
  532.   $ run sys$system:latcp
  533.   LATCP> create port lta601:
  534.   LATCP> set port lta601: /application /node=latbox /port=dialout /noqueue
  535.   LATCP> exit
  536.   $ set terminal LTA601: /permanent /fullduplex /altypeahd /speed=38400
  537.  
  538.    Now start C-Kermit and assign the port:
  539.  
  540.   $ kermit
  541.   C-Kermit> set modem type usr
  542.   C-Kermit> set line lta601:
  543.   C-Kermit> show comm           ; Speed should be 38400
  544.   C-Kermit> set dial display on ; To verify modem dialog
  545.   C-Kermit> dial 7654321
  546.  
  547.    And off you go.
  548.  
  549.    For other configurations, refer to your DECserver and LATCP
  550.    documentation. You can set up port "hunt groups", you can assign
  551.    logical names to the VMS ports, which can refer to single LAT ports or
  552.    entire hunt groups, and so on. You can even define "bidirectional"
  553.    ports for both calling in and calling out, but these are difficult to
  554.    troubleshoot when there are problems.
  555.  
  556. 3.4.3. DECservers and Telnet
  557.  
  558.    DECservers that support TCP/IP connections can be used by C-Kermit for
  559.    shared dialout modem access. The DECserver can be configured for this
  560.    using a command like:
  561.  
  562.   CHANGE TELNET LISTENER 2001 PORT 1 ENABLE
  563.  
  564.    This associates TCP socket 2001 with serial port 1 on the DECserver.
  565.    Then you can use Kermit to Telnet to port 2001 on the DECserver and
  566.    dial the modem that is on the DECserver's serial port 1.
  567.  
  568.    If you cannot get reverse LAT working, but LAT is working, it is still
  569.    possible to use Kermit via LAT so long as your system (and Kermit)
  570.    support TCP. Start Kermit, tell it to "set host localhost" (the TCP
  571.    loopback name). In connect mode you can log back on to the same system
  572.    (see the cautions in [47]Using C-Kermit about "C-Kermit in the
  573.    Middle").
  574.  
  575.    Then you can use SET HOST/LAT from the CONNECT session to dial out,
  576.    login to the remote system and start the remote Kermit. Now go back to
  577.    the original Kermit session to transfer the files. You should try it
  578.    first with SET PREFIXING ALL in C-Kermit, and probably also SET PARITY
  579.    SPACE, and relatively short packets. If that works, you can try
  580.    settings that give higher performance at your own risk.
  581.  
  582. 3.5. The Virtual Terminal Driver
  583.  
  584.    For incoming modem connections, it can be very useful if the VMS system
  585.    is set up to support Virtual Terminals. Once these have been set up,
  586.    then if an incoming connection fails because of line problems, it
  587.    should be possible to reconnect to the original session by redialling
  588.    and logging in again. You should then get a prompt asking if you wish
  589.    to connect to your disconnected session, allowing you to resume where
  590.    you left off. You should see something like this:
  591.  
  592.       You have the following disconnected process:
  593.   Terminal   Process name    Image name
  594.   VTA456:    ABCDEF          (none)
  595.   Connect to above listed process [YES]: Y
  596.   Connecting to terminal _VTA456:
  597.   ABCDEF>
  598.  
  599.    There is a timeout of something like an hour, after which the
  600.    disconnected session is deleted entirely.
  601.  
  602.    [If on re-dialing the host you find you are reconnected to the original
  603.    session without needing to login, then that host has a security
  604.    problem, as well as a misconfigured DECserver and/or modem or lead...]
  605.  
  606.    The virtual terminal driver is loaded at startup (or later) using
  607.    SYSGEN or SYSMAN as appropriate. The definition for TTY_DEFCHAR2 in
  608.    MODPARAMS.DAT also needs to be changed to set the appropriate bit to
  609.    enable the disconnect processing by default on all terminals. [This
  610.    change needs a reboot.]
  611.  
  612.    Something like the following should work (check the VMS manuals):
  613.  
  614.    VAX:
  615.           $ MCR SYSGEN VTA0/NOADAPTER/DRIVER=TTDRIVER
  616.  
  617.    Alpha:
  618.           $ MCR SYSMAN IO CONNECT VTA0/NOADAPTER -
  619.           /DRIVER=SYS$LOADABLE_IMAGES:SYS$TTDRIVER.EXE
  620.  
  621.    MODPARAMS.DAT:
  622.           TTY_DEFCHAR2 = 135170 ! = %x21002. Check the manual!
  623.           (%x20000 = Disconnect, %x1000 = Line Edit, %x2 = Autobaud)
  624.  
  625. 3.6. Captive Accounts and Restricted Access
  626.  
  627.    Some VMS sites restrict users from getting at the DCL prompt and
  628.    services by setting their accounts to be "captive". This should
  629.    automatically prevent C-Kermit's DCL-access commands (such as PUSH)
  630.    from working. Any attempt to execute such a command should result in
  631.    C-Kermit issuing an error message. Should a user circumvent this, VMS
  632.    will automatically terminate the user's process. In addition to
  633.    CAPTIVE, accounts can also be set to RESTRICTED, to disable all types
  634.    of spawning. Note that DEC says that RESTRICTED is only used "to ensure
  635.    users complete login processing without interruption". DEC further
  636.    states that they intend to modify VMS utilities to no longer prohibit
  637.    spawning in a future release.
  638.  
  639.    Further, you should be aware that preventing users from getting to DCL
  640.    only provides an illusion of security. There are many ways of getting
  641.    to DCL which are non-obvious. For cases where absolute security is
  642.    required, you should in- vestigate the AUTHORIZE flags CAPTIVE and
  643.    DISIMAGE. Consult the VMS Security Manual for more information.
  644.  
  645.    C-Kermit itself can be configured to prevent system access, by
  646.    compiling it with the NOPUSH option (for this you would have to edit
  647.    CKVKER.COM file and add a definition for the symbol NOPUSH to the
  648.    CFLAGS). This disables not only the PUSH command and its synonyms (RUN,
  649.    @, SPAWN), but also OPEN !READ, OPEN !WRITE, as well as the server's
  650.    execution of REMOTE HOST commands. See CKCCFG.DOC for further
  651.    information.
  652.  
  653.    There is also a runtime approach for this: put the (invisible) command
  654.    NOPUSH someplace where it will always be executed; for example, the
  655.    system-wide CKERMIT.INI file, or in the "kermit" command definition:
  656.  
  657.   $ KERMIT :== "$SYS$TOOLS:KERMIT ""-C"" ""NOPUSH"""
  658.  
  659.    You can also define the logical name (environment variable) CK_NOPUSH
  660.    to achieve the same effect.
  661.  
  662.    The NOPUSH command does at runtime exactly what defining the NOPUSH
  663.    symbol at compile time does.
  664.  
  665.    [ [48]Contents ] [ [49]C-Kermit ] [ [50]Kermit Home ]
  666.  
  667. 4. DECODING VMS C-KERMIT HEX FILES
  668.  
  669.      VMS C-Kermit hex files are not kept up to date. In fact, we only
  670.      have a few of them -- nonet versions for old versions of VMS on VAX
  671.      and Alpha. Once you have it on your VMS system and decode it, you
  672.      can use it to download a more current and appropriate version.
  673.  
  674.    If you have obtained the executable VMS C-Kermit program encoded in
  675.    printable "hex" format on magnetic tape or over a network, you can
  676.    decode it back into a runnable .EXE program image using the CKVDEH.MAR
  677.    program. This is an assembly-language program for the VAX or Alpha,
  678.    which you should assemble, link, and run as follows:
  679.  
  680.   $ macro ckvdeh  (on the Alpha, substitute "macro/migrate ckvdeh")
  681.   $ link ckvdeh
  682.   $ run ckvdeh
  683.  
  684.    CKVDEH prompts you for the input file name and then creates a .EXE file
  685.    with the same root name. For example, if you enter CKVKER.HEX as the
  686.    source file, the resulting executable will be CKVKER.EXE. This
  687.    procedure works on both the VAX and the Alpha -- the same program,
  688.    CKVDEH.MAR, compiles and runs on both platforms.
  689.  
  690.    The C-Kermit .EXE files were built under VAX/(Open)VMS 5.x and Alpha
  691.    OpenVMS 1.x (whenever possible; otherwise under 6.1). The VAX versions
  692.    will not run under pre-5.0 VMS releases. If you have a VMS 4.x system
  693.    with C compiler, however, you should be able to build C-Kermit using
  694.    the CKVOLD.COM procedure.
  695.  
  696.    Since VMS C-Kermit can be built with no TCP/IP support or with support
  697.    for several different TCP/IP packages, and it can be built on both the
  698.    VAX and Alpha platforms, you should pick the right .HEX file for your
  699.    environment.
  700.  
  701.    The naming conventions are as follows:
  702.  
  703.   CKVaKER-VMSnn-tttvv.xxx
  704.  
  705.    where:
  706.  
  707.   CKV = "C-Kermit for VMS".
  708.     a = architecture: A for Alpha, V for VAX.
  709.   KER = Kermit
  710.    nn = VMS version, e.g. 55 for VMS 5.5, 70 for VMS 7.0.
  711.   ttt = TCP/IP product, if any:
  712.         CMU = CMU-OpenVMS/IP ("CMU/Tek")
  713.         UCX = Compaq (DEC) TCP/IP(*)
  714.         PST = Process Software TCPware
  715.         TGV = Process Software (Cisco (TGV)) MultiNet(*)
  716.         WIN = Attachmate (Wollongong) WIN/TCP (PathWay)(*)
  717.    vv = The version number of the TCP/IP product (may be 2 or more characters)
  718.   xxx = HEX (text-encoded binary) or EXE (true binary)
  719.  
  720.    When there is no TCP/IP support built in, tttvv is "NONET".
  721.  
  722.      * It's a bit of a task to keep up with all the buyouts and renaming.
  723.        Any of these companies or products can be snapped up and/or renamed
  724.        at any time, and most of them have been, including DEC itself.
  725.  
  726.    Examples:
  727.  
  728.   CKVVKER-VMS55-NONET.HEX:   VAX, VMS 5.5, no TCP/IP, hex format.
  729.   CKVAKER-VMS62-TGV40.EXE: Alpha, VMS 6.2, Multinet 4.0, binary format.
  730.  
  731.    Not every combination is necessarily available. In general, an .EXE
  732.    built under a certain version of VMS will also run under later VMS
  733.    versions, but the opposite is usually not true. Also, if a version was
  734.    built under the same VMS version that you have, but with a higher ECO
  735.    level (OS or library patches), it might not run.
  736.  
  737.    So try to pick one that was built under a VMS version less than or
  738.    equal to yours, and with the same TCP/IP product you have having with a
  739.    version number less than or equal to yours. If that doesn't work, try
  740.    the next earlier one, etc. If you can't find one for your TCP/IP
  741.    product, try the lowest-numbered UCX (DEC TCP/IP) version; most
  742.    third-party TCP/IP products also support UCX applications. In any case,
  743.    after getting the appropriate executable onto your VMS disk, rename it
  744.    to KERMIT.EXE, e.g.:
  745.  
  746.   $ RENAME CKVAKER-VMS62-TGV40.EXE KERMIT.EXE
  747.  
  748.    The "labeled file converter" is simple; it comes in a VAX version,
  749.    CKVVCVT-VMSnn.{HEX,EXE}, and an Alpha version, CKVACVT-VMSnn.{HEX,EXE}.
  750.    Rename it to CKVCVT.EXE so VAX and Alpha users don't have to use
  751.    different names for the same program.
  752.  
  753.    [ [51]Contents ] [ [52]C-Kermit ] [ [53]Kermit Home ]
  754.  
  755. 5. INSTALLING VMS C-KERMIT
  756.  
  757.    VMS C-Kermit must be installed on your VMS system by hand. There is no
  758.    VMSINSTAL kit because it would have to include many megabytes of
  759.    differently- configured executables to choose from, and many of
  760.    system-configuration items discussed above are best done by the system
  761.    manager manually, in privileged mode, after some thought and
  762.    consideration.
  763.  
  764.      IMPORTANT: DO NOT INSTALL VMS C-KERMIT AS A PRIVILEGED PROGRAM!
  765.      Instead, install it as a foreign command.
  766.  
  767.    To install C-Kermit, follow this procedure:
  768.  
  769.     1. If you have the old Bliss Kermit-32 on your system, rename it to
  770.        KERMIT32.EXE. If you have a symbol KERMIT defined to run Kermit-32,
  771.        change the symbol name to KERMIT32.
  772.     2. Identify the directory where you want to install the C-Kermit
  773.        program. Normally this would be a directory that is unaffected by
  774.        installation of DEC software, such as SYS$TOOLS =
  775.        SYS$SYSDEVICE[SYSTOOLS]. From now on, we will assume you are using
  776.        SYS$TOOLS:.
  777.     3. Copy the desired .EXE file (VAX or Alpha, with the appropriate
  778.        networking support) to that directory, rename it to KERMIT.EXE, and
  779.        give users permission to run it, for example:
  780.   $ COPY CKVVKER-VMS55-UCX20.EXE SYS$TOOLS:KERMIT.EXE
  781.   $ SET PROTECTION=(S:RWED,O:RWED,G:RE,W:RE) SYS$TOOLS:KERMIT.EXE
  782.  
  783.        If Kermit is going to be used a lot, you can have it preloaded and
  784.        its pure memory segments shared:
  785.   $ INSTALL ADD SYS$TOOLS:KERMIT.EXE/OPEN/HEADER/SHARE
  786.  
  787.     4. Copy the standard CKERMIT.INI file to the same directory:
  788.   $ COPY CKERMIT.INI SYS$TOOLS:
  789.   $ SET PROTECTION=(S:RWED,O:RWED,G:RE,W:RE) SYS$TOOLS:CKERMIT.INI
  790.  
  791.     5. Add the following line to SYS$COMMON:[SYSMGR]SYSTARTUP_V5.COM (or
  792.        whatever your system startup file is):
  793.   $ DEFINE/SYSTEM CKERMIT_INI SYS$TOOLS:CKERMIT.INI
  794.  
  795.     6. Find your system-wide login DCL command procedure:
  796.   $ SHOW LOGICAL SYS$SYLOGIN
  797.   "SYS$SYLOGIN" = "SYS$TOOLS:SYLOGIN.COM" (LNM$SYSTEM_TABLE)
  798.  
  799.        and then add the following line to it:
  800.   $ KERMIT :== $SYS$TOOLS:KERMIT
  801.  
  802.        This defines SYS$TOOLS:KERMIT.EXE as a "foreign command".
  803.        NOTE: VMS 6.2 and later support automatic creation of foreign
  804.        commands by placing the corresponding .EXE (or .COM) files in any
  805.        directory that is included in the DCL$PATH logical name; e.g.:
  806.   $ DEFINE DCL$PATH SYS$DISK:[],DISK1:[TOOLS],SYS$SYSTEM:
  807.  
  808.     7. Install the C-Kermit HELP file in your VMS HELP library. First
  809.        delete any earlier KERMIT help entry, then install the new one:
  810.   $ LIBRARY/HELP/DELETE=KERMIT SYS$HELP:HELPLIB.HLB
  811.   $ LIBRARY/INSERT/HELP SYS$HELP:HELPLIB.HLB CKVKER.HLP
  812.  
  813.     8. Create a publicly accessible directory, such as [KERMIT], in which
  814.        to make other C-Kermit files available to your users:
  815.  
  816.         CKERMIT.KDD
  817.                 Sample dialing directory file.
  818.  
  819.         CKERMIT.KSD
  820.                 Sample services directory.
  821.  
  822.         CKERMIT.KND
  823.                 Sample network directory.
  824.  
  825.         CKEDEMO.KSC
  826.                 Macro definitions from "Using C-Kermit".
  827.  
  828.         CKEVT.INI
  829.                 Command file to demonstrate special screen effects from
  830.                 "Using C-Kermit".
  831.  
  832.         CKCKER.UPD
  833.                 A supplement to the book, "Using C-Kermit", describing
  834.                 features added since the book was published.
  835.  
  836.         CKCKER.BWR
  837.                 The general C-Kermit beware file.
  838.  
  839.         CKVKER.BWR
  840.                 The VMS-specific C-Kermit beware file.
  841.  
  842.        If the Kermit program is not installed as a "foreign command" as in
  843.        (6) above, you can still RUN it, but you can't pass command-line
  844.        arguments to it this way. However, you can pass command-line
  845.        arguments if you invoke it with the MCR command:
  846.   $ mcr kermit -s oofa.txt ; (assumes "kermit.exe" in sys$system)
  847.  
  848.        or:
  849.   $ mcr disk1:[olga]kermit -s oofa.txt ; (explicit path given)
  850.  
  851.    [ [54]Contents ] [ [55]C-Kermit ] [ [56]Kermit Home ]
  852.  
  853. 6. USING MODEMS
  854.  
  855.    If you have a VAX or Alpha with a real serial port (DB-9 or DB-25), you
  856.    can use it with a modem. If your machine has MMJ (asymmetrical RJ-45)
  857.    modular jack sockets (like a VAXstation 3100), you won't be able to
  858.    make very good use of modems since these ports do not support modem
  859.    signals.
  860.  
  861.    Before attempting to use a modem on port (say) TTA0, you (or the system
  862.    manager) will need to configure the port as a modem port:
  863.  
  864.  $ SET TERMINAL TTA0 /MODEM /ALTYP /PERM
  865.  
  866.    From section 5.2.3.1 of the I/O User's Reference Manual:
  867.  
  868.      Remote terminal connections have a timeout feature for the security
  869.      of dial-up lines. If no channel is assigned to the port within 30
  870.      seconds, or a port with an assigned channel is not allocated, the
  871.      DTR signal is dropped. Such action prevents an unused terminal from
  872.      tying up a line. However, there are configurations (such as a
  873.      printer connected to a remote line) in which the line should not be
  874.      dropped even though it is not being used interactively. To bypass
  875.      the 30-second timeout, set the system generation parameter
  876.      TTY_DIALTYPE to 4. (Note that if TTY_DIALTYPE is equal to 4, all
  877.      dial-up lines will skip the timeout waiting for a channel to be
  878.      assigned.)
  879.  
  880.    The following is reprinted by permission; references to Kermit-32 are
  881.    obsolete.
  882.  
  883.                    How to Use a MODEM With Your VMS System
  884.                              Richard B. Gilbert
  885.                          Computer Systems Consultant
  886.                76702.1567@CompuServe.Com Revised July 30, 1996
  887.  
  888.    Most MODEMs come with factory defaults intended for dialout use with
  889.    PCs. The MODEM is typically set to ignore DTR; e.g., assume that it is
  890.    always asserted and to assert CD at all times regardless of the actual
  891.    state of the received carrier. The user is not required to do much, if
  892.    anything, to get it to work. Such a MODEM requires some configuration
  893.    before it will work properly, or at all, with a VMS System.
  894.  
  895.    Be sure that the serial port you are using supports MODEM control
  896.    signals. On the DMF32, for example, only ports 0 and 1 can be used with
  897.    MODEMS. These ports on the DMF32 must have DIP switches set to enable
  898.    MODEM control signals. The VAXStation 3100 does NOT support MODEM
  899.    control! (It is possible to use a MODEM but the VAXstation cannot
  900.    detect the loss of the connection; the next person to dial in could
  901.    find himself logged in to your account!) The MicroVAX 3100 does support
  902.    MODEM control. As a general rule, anything with a DEC Modified Modular
  903.    Jack (MMJ) connector does not support full MODEM control; the MMJ has
  904.    only six pins and nine are required. Eight pin RJ45 connectors are
  905.    sometimes used; e.g. on some models of the DECserver 700, where a
  906.    choice is offered as to the signals supported.
  907.  
  908.    Connect the MODEM with a cable that supports MODEM control signals,
  909.    such as Digital's BC22E. The BC22F, connecting all twenty-five pins, is
  910.    overkill but will work quite well. A twenty-five conductor ribbon cable
  911.    will also work but a shielded cable is highly recommended in order to
  912.    comply with Radio Frequency Interference (RFI) requirements.
  913.  
  914.    Note that while it was possible to "fake it" with VMS V4.x and earlier,
  915.    VMS V5 requires that all of the MODEM control signals be connected.
  916.    (Pins 2-8, 20 and 22 should be connected straight through; i.e., 2-2,
  917.    3-3, 4-4, ...). If you are forced to sacrifice one signal, try RI (Ring
  918.    Indicator) first. For reference, here is the standard pinout for the
  919.    RS-232-C DB-25 connector.
  920.  
  921.    Pin Description
  922.    1   Protective ground (may be connected to shield at ONE end only)
  923.    2*  Transmitted data (TxD)
  924.    3*  Received data (RxD)
  925.    4*  Request to send (RTS)
  926.    5*  Clear to send (CTS)
  927.    6*  Data set ready (DSR)
  928.    7*  Signal ground
  929.    8*  Carrier detect (CD)
  930.    12  Speed Mode Indicate (or secondary CD)
  931.    15  Synchronous transmit clock
  932.    17  Synchronous receive clock
  933.    19  Speed select (or secondary RTS)
  934.    20* Data terminal ready (DTR)
  935.    22* Ring indicator (RI)
  936.    23  Data Signal Rate Select (DSRS)
  937.  
  938.    It should be noted that not all devices connect or support all these
  939.    pins and not all those listed are necessary for "full MODEM control".
  940.    The pins marked with an asterisk are generally essential to
  941.    satisfactory and secure operation of your modem.
  942.  
  943.    You will need to make some switch settings on your MODEM. The following
  944.    settings are for a U.S. Robotics Courier V32bis FAX Modem. Other U.S.
  945.    Robotics MODEMs use quite similar switch numbers and settings. Other
  946.    manufacturers may use different switch numbers but the functions
  947.    available are typical. See your MODEM's instruction manual for the
  948.    sordid details. The settings marked with an asterisk are critical to
  949.    the successful use of your MODEM. Some settings can also be made from
  950.    the CPU via the MODEM's AT command set, in which case the hardware
  951.    switch settings determine the MODEM's power on defaults. The AT
  952.    commands in parentheses, following the switch settings, are the
  953.    commands for a U.S. Robotics Courier HST Dual Standard MODEM. Check
  954.    your manual for the proper commands for your MODEM.
  955.  
  956.     1. (*) DTR Normal (controlled by CPU) (AT&D2&W)
  957.     2. Verbal result codes (Useful during dialout) (ATV1)
  958.     3. (*) Do not display result codes (Quiet mode) (ATQ1)
  959.     4. Echo off line commands (Useful during dialout) (ATE1)
  960.     5. (*) Auto answer (MODEM will answer the phone if DTR is asserted)
  961.        (ATS0=1)
  962.     6. (*) Normal Carrier detect (controlled by MODEM) (AT&C1&W)
  963.     7. Display originate result codes only.
  964.     8. Normal At command set (Must be enabled for auto dial.)
  965.     9. Online after +++
  966.    10. Load NVRAM defaults on power up.
  967.  
  968.    Many users have observed a VMS System dropping DTR (Data Terminal
  969.    Ready) while a user is trying to dial in, causing the MODEM to hang up
  970.    the phone. The terminal driver will drop DTR if it sees DSR (Data Set
  971.    Ready) for more than thirty seconds, without also seeing CD (Carrier
  972.    Detect). If it is possible to configure the MODEM so that it does not
  973.    assert DSR until it asserts CD (AT &S1&W), do so. Otherwise it will be
  974.    necessary to use a modified cable. At the VAX end of the cable, cut the
  975.    wire leading to pin 6 (DSR) and jumper pin 6 to pin 8 (CD). Commands
  976.    similar to the following should be placed in your
  977.    SYS$MANAGER:SYSTARTUP_VMS.COM (SYSTARTUP_V5.COM for VMS V5.X) file to
  978.    set up an asynchronous port for use with a MODEM. You may want to add
  979.    some more qualifiers but this will get you going.
  980.  
  981. $       SET TERMINAL -
  982.         /PERMANENT -    ! Make settings permanent
  983.         /MODEM -        ! Use MODEM control signals
  984.         /DIALUP -       ! Gives the DIALUP identifier to user.
  985.         /HANGUP -       ! Hang up the phone when user logs off
  986.         /AUTOBAUD -     ! Detect the user's baud rate and set it.*
  987.         /ALTYPEAHD -    ! Use the alternate typeahead buffer.  The
  988.                         ! alternate typeahead buffer can be made larger
  989.                         ! than the regular one.  This is helpful if you
  990.                         ! are doing file transfers.  See SYSGEN parameter
  991.                         ! TTY_ALTYPAHD.
  992.         /HOSTSYNC -     ! VMS System will send XOFF when its buffer is
  993.                         ! nearly full and XON when it is ready for more
  994.                         ! input.  See SYSGEN parameter TTY_ALTALARM.
  995.         _TXA0:
  996.  
  997. $       SET SECURITY /CLASS=DEVICE /PROTECTION=W:R      ! VMS V6
  998.                         ! Sets device protection to allow non-privileged
  999.                         ! users to allocate the device for dialing out.
  1000.                         ! Otherwise user must own device or hold SYSPRV.
  1001. or
  1002. $       SET PROTECTION=W:R /DEVICE                      ! VMS V5
  1003.  
  1004.      * Many modern MODEMs are capable of using a fixed DTE rate to talk to
  1005.        the computer; e.g. if they are set to 19200, they will talk to the
  1006.        computer at 19200 regardless of what speed they are using to talk
  1007.        to the remote MODEM. This feature has performance implications for
  1008.        MODEMs that do data compression using either CCITT V.41 or MNP. For
  1009.        such MODEMs, set a speed that is at least four times the rated DCE
  1010.        speed of the MODEM or the highest available speed using
  1011.        /SPEED=xxxxx rather than using /AUTOBAUD. The MODEM must be set to
  1012.        use the corresponding speed. The U.S. Robotics Courier series are
  1013.        set to a particular DTE rate by the most recent AT&W command; the
  1014.        rate set is the current speed of the port. See your MODEM's
  1015.        instructions for details.
  1016.  
  1017.    The following commands should probably go in SYS$SYLOGIN, your
  1018.    system-wide login command file:
  1019.  
  1020.  
  1021. $! Test for interactive or batch mode
  1022. $!
  1023. $       IF F$MODE() .NES. "INTERACTIVE" THEN GOTO 10$
  1024. $!   Set up device dependent terminal characteristics.  This only works
  1025. $! if the terminal responds to ANSI Device Attributes (DA) control string.
  1026. $! Most DEC terminals (VT1xx, VT2xx, VT3xx, VT4xx, VT5xx, LAxxx) and
  1027. $! compatibles will do so.
  1028. $       IF F$GETDVI("TT", "TT_MODEM") THEN $ SET TERMINAL /INQUIRE
  1029. $ 10$:
  1030. **************************************************************************
  1031.  
  1032.    To set the terminal for temporary dialout use, execute the following
  1033.    commands:
  1034.  
  1035. $       ALLOCATE TXA0:  KER$COMM        ! Logical is useful for Kermit-32.
  1036. $       SPEED="''P1'"
  1037. $! Default to 1200 baud.                ! Pick a suitable default value.
  1038. $       IF SPEED .EQ. "" THEN SPEED=1200
  1039. $       SET TERMINAL /NOAUTOBAUD /SPEED='SPEED' KER$COMM:
  1040.  
  1041.    You may need to add a /NOECHO qualifier if your terminal program is too
  1042.    stupid to read with no echo. It is not necessary with SET HOST/DTE,
  1043.    KERMIT, XMODEM, or HOST32.
  1044.  
  1045.    To support a MODEM on a DECServer 200:
  1046.  
  1047.     1. Set up the terminal server as follows: (assuming port 8)
  1048.   Local> DEFINE PORT 8 ACCESS DYNAMIC AUTOBAUD DISABLED
  1049.   Local> DEFINE PORT 8 DSRLOGOUT DISABLED FLOWCONTROL XON
  1050.   Local> DEFINE PORT 8 INACTIVITY ENABLED MODEM ENABLED
  1051.   Local> DEFINE PORT 8 SIGNAL CHECK ENABLED
  1052.   Local> DEFINE PORT 8 SPEED 2400 ALTERNATE SPEED 1200
  1053.   Local> DEFINE PORT 8 DIALUP ENABLED
  1054.   Local> LOGOUT PORT 8
  1055.   Local> DEFINE SERVICE service_name PORT 8 IDENT "string"
  1056.   Local> SET SERVICE service_name PORT 8 IDENT "string"
  1057.  
  1058.        Other port characteristics may be defined "to taste".
  1059.     2. Insert the following statements in SYS$STARTUP:LAT$SYSTARTUP.COM
  1060.        (SYS$MANAGER:LTLOAD.COM for VMS V5.4 and below):
  1061.   CREATE PORT LTA100: /NOLOG
  1062.   SET PORT LTA100: /APPLICATION /NODE=server_name /SERVICE=service_name -
  1063.         /NOQUEUE /NOLOG
  1064.  
  1065.        The LTA number is more or less arbitrary but must take into account
  1066.        the fact that LAT startup creates a few ports temporarily (starting
  1067.        at LTA1) and the number you choose must not conflict.
  1068.        The server_name and service_name must correspond exactly to the
  1069.        names used in the DECserver DEFINE SERVER server_name and DEFINE
  1070.        SERVICE service_name commands!
  1071.     3. Insert the following statements in SYS$MANAGER:SYSTARTUP_VMS.COM
  1072.        (SYS$MANAGER:SYSTARTUP_V5.COM for VMS V5.X):
  1073. $!
  1074. $       @SYS$STARTUP:LAT$STARTUP.COM    ! Start LAT.
  1075. $! Note that SYS$STARTUP:LAT$STARTUP.COM starts LAT and then invokes
  1076. $! LAT$SYSTARTUP.COM to complete the system specific part of the startup.
  1077. $! VMS V5.4 and below would use @SYS$MANAGER:LTLOAD.COM.
  1078. $!
  1079. $! Set up MODEM port on terminal server.  The SET TERMINAL may not
  1080. $! be necessary at all since the DECserver DEFINE commands include equivalents
  1081. $! for everything except /ALTYPEAHD.
  1082. $       SET TERMINAL /PERMANENT /DIALUP /ALTYPEAHD /HOSTSYNC    LTA100:
  1083. $       SET SECURITY /CLASS=DEVICE /PROTECTION=W:R              LTA100:
  1084.  
  1085.     4. Reboot or execute the commands in steps 2 and 3.
  1086.  
  1087.    [ [57]Contents ] [ [58]C-Kermit ] [ [59]Kermit Home ]
  1088.  
  1089. 7. BUILDING VMS C-KERMIT FROM THE SOURCE CODE
  1090.  
  1091.    If you have the VMS C-Kermit source files in a ZIP archive, unpack the
  1092.    archive with:
  1093.  
  1094. unzip -aa ckv211.zip
  1095.  
  1096.    C-Kermit is written in the C programming language. To build C-Kermit on
  1097.    the VAX, you must have VAX C, DEC C, or GNU GCC. At some sites, the C
  1098.    header files are archived in a VMS library and then VMS C-Kermit might
  1099.    not be compilable. If the C compiler (preprocessor) complains about not
  1100.    being able to find header files, you'll have to extract them from the
  1101.    library. A sample DCL procedure for this can be found at the end of
  1102.    this file.
  1103.  
  1104.    WARNING: When building with GCC on a VMS system that has Multinet
  1105.    installed, you must ensure that the GCC TIME.H file is used instead of
  1106.    the Multinet TIME.H; otherwise there will be a fatal error in CKVTIO.C
  1107.    at the declaration of "tcount", around line 450. Other warnings appear
  1108.    to be harmless.
  1109.  
  1110.    WARNING: DEC C 4.0 has a bug in which the XABALL struct member
  1111.    xab$b_bkz (used in CKVFIO.C) is not defined. DEC gives a simple example
  1112.    -- compiling the following code with DEC C using either /DECC and
  1113.    /VAXC:
  1114.  
  1115.   #include <rms.h>
  1116.   struct XABALL xabDATAall;
  1117.   int f() {
  1118.       xabDATAall.xab$b_bkz = 63;
  1119.       return 1;
  1120.   }
  1121.  
  1122.    Results in:
  1123.  
  1124.   %CC-E-NEEDMEMBER, In this statement, "xab$b_bkz" is not a member of "xabDATAal
  1125. l"
  1126.  
  1127.    If you find that the above code produces the same problem on your
  1128.    system, define BUGFILL7, e.g.:
  1129.  
  1130.   @ckvker.com "" "" "BUGFILL7"
  1131.  
  1132.    BEWARE: Certain versions of VAX C can generate incorrect code when a
  1133.    function is used before it is declared, and it generates a return value
  1134.    (via a return statement) that is not used; other functions might have
  1135.    their entry masks (argument lists) corrupted. If you experience bizarre
  1136.    behavior from a version of C-Kermit built with VAX C, try recompiling
  1137.    with /OPT=NOINLINE and /NOOPT, or some other reduced optimization
  1138.    level.
  1139.  
  1140.    Both VAX C and DEC C are moving targets. A version of C-Kermit that was
  1141.    built successfully with version x.y of the compiler almost always fails
  1142.    to build under version x.y+1. Thus you will find increasing numbers of
  1143.    #ifdefs in the code (mostly CKCNET.C and .H and the CKV*.* modules)
  1144.    keyed on explicit C compiler version numbers. Note the form of these
  1145.    carefully -- they have to be just right). Also note that you can't use
  1146.    constructions like:
  1147.  
  1148.   #if __DECC_VER >= 500000000
  1149.  
  1150.    ANYWHERE in a portable module because neither "#if" nor relational
  1151.    operators in preprocessor statements are portable.
  1152.  
  1153.    The number of possible VMS C-Kermit configurations is large, perhaps
  1154.    not even countable: VAX vs Alpha, VAXC vs DECC vs GCC, no network
  1155.    support vs Multinet vs TCPware vs Wollongong vs UCX vs CMU/Tek, and
  1156.    this release of VMS versus all the others. The kicker is in the
  1157.    releases; for example DEC C 4.0 vs 4.1 vs 5.0 vs 5.3 (etc) versus the
  1158.    TCP/IP product's header files, which themselves go through all sorts of
  1159.    releases and patches. We can't guarantee that C-Kermit can be
  1160.    successfully built on every combination, but in version 6.0 we are much
  1161.    closer to that goal than ever before.
  1162.  
  1163.    Before leaving this topic, let's look at how to find out the relevant
  1164.    version numbers. SHOW SYSTEM (among other commands) tells you the VMS
  1165.    version number. To find the C version number, try:
  1166.  
  1167.   $ CC /VER
  1168.  
  1169.    which works for recent DECC versions, or:
  1170.  
  1171.   $ CC NLA0: /NOOBJ /VERSION
  1172.  
  1173.    or (when the above doesn't work):
  1174.  
  1175.   $ CC/LIST=FOO SYS$INPUT
  1176.   ^Z
  1177.  
  1178.    and then look at the first line of FOO.LIS.
  1179.  
  1180.    The method for finding out the TCP/IP product version number depends on
  1181.    the product. For Multinet:
  1182.  
  1183.   $ MU SHOW /VERSION
  1184.  
  1185.    For DEC TCP/IP (UCX) versions 3.0 and later:
  1186.  
  1187.   $ UCX SHOW VERSION
  1188.  
  1189.    For earlier releases, or ones where the above command doesn't work,
  1190.    try:
  1191.  
  1192.   $ RUN SYS$SYSTEM:UCX$VERSIONS
  1193.  
  1194.    or:
  1195.  
  1196.   $ ANALYZE/IMAGE SYS$SYSTEM:*BGDRIVER
  1197.  
  1198.    or:
  1199.  
  1200.   $ ANALYZE/IMAGE SYS$LOADABLE_IMAGES:*BGDRIVER
  1201.  
  1202.    For others: (somebody please fill this in)
  1203.  
  1204.    Before trying to compile, make sure you've got the disk space and
  1205.    quotas, etc, that are needed. In version 6.0 and later, you'll probably
  1206.    need as much as 8 or 10 megabytes for all the sources, objects, and
  1207.    binaries.
  1208.  
  1209.    The User Authorization File (UAF) parameters of the account in which
  1210.    C-Kermit will be built must be set to accommodate the large size of
  1211.    some source modules. Recommended values are:
  1212.  
  1213.   PAGE FILE QUOTA:  at least 60000
  1214.   Working set extent:  at least 5012
  1215.  
  1216.    To modify: Suppose a user KERMIT is the VMS account from which Kermit
  1217.    is maintained. To set these values, the system manager must do the
  1218.    following:
  1219.  
  1220.   $ set default sys$system
  1221.   $ mcr authorize
  1222.   UAF> modify kermit/pgflquo=60000/wsextent=5012
  1223.   UAF> exit
  1224.  
  1225.    If errors such as:
  1226.  
  1227.   %cc-f-text Virtual Memory limits exceeded
  1228.  
  1229.    occur during the build procedure, these parameters may need adjustment
  1230.    (upwards).
  1231.  
  1232.    To build C-Kermit, create a new directory and make it your current
  1233.    directory:
  1234.  
  1235.   $ CREATE/DIR [.KERMIT]
  1236.   $ SET DEFAULT [.KERMIT]
  1237.  
  1238.    and put the C-Kermit source files and build procedures there, for
  1239.    example by copying them from the distribution tape or cartridge.
  1240.  
  1241.    Two build procedures are provided for C-Kermit 6.0 and later; one
  1242.    (CKVOLD.COM) for VMS 4.x, the other (CKVKER.COM) for VMS 5.0 and later.
  1243.    The two are equivalent except for syntax, and should work everywhere.
  1244.    No extra products (MAKE, MMS, MMK, etc) are required (but MMS or MMK
  1245.    will be used if present). The auxiliary file CKVKER.MMS is used if MMS
  1246.    or MMK are present. To build C-Kermit:
  1247.  
  1248.    $ @CKVKER  (or @CKVOLD)
  1249.  
  1250.    Please read the comments at the top of CKVKER.COM itself for further
  1251.    instructions and information.
  1252.  
  1253.    NOTE: if you get messages like this in the link step:
  1254.  
  1255.   %LINK-I-OPENIN, Error opening SYS$COMMON:[SYSLIB]VAXCRTLG.OLB; as input,
  1256.   %RMS-E-FNF, file not found
  1257.   %LINK-I-OPENIN, Error opening SYS$COMMON:[SYSLIB]VAXCRTL.OLB; as input,
  1258.   %RMS-E-FNF, file not found
  1259.  
  1260.    it probably means you have a LNK$LIBRARY symbol defined in your job (or
  1261.    system-wide) and the definition is inappropriate. DEASSIGN it if
  1262.    possible. If not, and if the LINK step produced no other error
  1263.    messages, and the WERMIT.EXE binary seems to run OK, then you can
  1264.    ignore the error messages.
  1265.  
  1266.    If you get huge amounts of warnings like:
  1267.  
  1268.               getsockname(sock,(struct sockaddr *)&l_sa,&slen);
  1269.   ............^
  1270.   %CC-W-PTRMISMATCH, In this statement, the referenced type of the pointer
  1271.   value "&slen" is "int", which is not compatible with "unsigned int".
  1272.   at line number 5870 in file DISK$USRG:[FDC.KERMIT]CKCNET.C;20
  1273.  
  1274.    this indicates that some essential header file is not being executed,
  1275.    which can happen for all sorts of reasons (usually some symbol was
  1276.    defined by some other header file that interferes with a subsequent
  1277.    one). The trick here is to get an include-file listing, which is
  1278.    possible with DECC (maybe VAXC too):
  1279.  
  1280.   @ckvker.com "" "" "" /LIST/SHOW=INCLUDE
  1281.  
  1282.    and then look through the CK????.LIS file of the offending module.
  1283.  
  1284. 7.1. Programming Tips
  1285.  
  1286.    For testing the DEC C version number:
  1287.  
  1288.   #ifdef __DECC_VER
  1289.   #if (__DEC_VER >= 050100000)
  1290.   blah
  1291.   #endif
  1292.   #endif
  1293.  
  1294.    Note: the version number is vvuuteeee; vv is the major version (like
  1295.    5), uu is the update number (like the "3" in 5.3), t is a code for
  1296.    field test, real release, etc, and eeee is the edit suffix. This is
  1297.    available only in DECC 5.0 and later. It also has a __VMS_VER... Note
  1298.    #2: Remember not to add a leading zero because that changes it to
  1299.    octal.
  1300.  
  1301. 7.2. VMS TCP/IP Networking Support for C-Kermit
  1302.  
  1303.    VMS C-Kermit is capable of establishing TCP/IP TELNET connections and
  1304.    acting as a TELNET program with built-in file transfer, script
  1305.    programming, character-set translation, etc, if it is built
  1306.    appropriately. If you have one of the following products installed on
  1307.    your system, complete with libraries and header files:
  1308.  
  1309.     1. DEC TCP/IP (UCX)
  1310.     2. TGV MultiNet TCP/IP
  1311.     3. Wollongong WIN/TCP or PathWay
  1312.     4. Process Software TCPware
  1313.     5. CMU-OpenVMS/IP with Mike O'Malley's sockets library
  1314.  
  1315.    then you can include TCP/IP capability in your version of VMS C-Kermit.
  1316.  
  1317.    The TCP/IP product is selected automatically by the build procedure
  1318.    based on the presence or absence of certain files on your system. To
  1319.    override the automatic selection, define the symbol NET_OPTION in one
  1320.    of the following ways before running the build procedure:
  1321.  
  1322.   $ NET_OPTION = "NONET"      ! Build with no TCP/IP networking support
  1323.   $ NET_OPTION = "CMU_TCPIP"  ! Build with CMU/Tek TCP/IP networking support
  1324.   $ NET_OPTION = "DEC_TCPIP"  ! Build with DEC TCP/IP (UCX) support
  1325.   $ NET_OPTION = "MULTINET"   ! Build with TGV MultiNet TCP/IP support
  1326.   $ NET_OPTION = "TCPWARE"    ! Build with Process Software TCPware support
  1327.   $ NET_OPTION = "WINTCP"     ! Build with WIN/TCP or PathWay support
  1328.  
  1329.    That is, type one of the commands listed above at the DCL prompt (shown
  1330.    above as "$") before running the build procedure. You can also force a
  1331.    "NONET" build with the CKVKER.COM "N" command-line option.
  1332.  
  1333.    Note: If you are building a version with TCP/IP support, and you have
  1334.    the required TCP/IP libraries and header files, but the #include files
  1335.    can't be found at compile time, then maybe they were put into a text
  1336.    library, in which case you need to unpack the include-file library into
  1337.    separate files using the VMS LIBRARY command.
  1338.  
  1339. 7.2.1. DEC TCP/IP (UCX) If the C-Kermit build procedure does not notice that
  1340. you have DEC TCP/IP installed when you really do, it is likely because the
  1341. file SYS$STARTUP:UCX$STARTUP.COM is read-protected (e.g. because your site
  1342. runs DECinspect). Turn on READONLY privilege.
  1343.  
  1344. If the DEC TCP/IP version of KERMIT.EXE crashes immediately upon startup with
  1345. a message like:
  1346.  
  1347.   %LIB-E-ACTIMAGE, error activating image
  1348.    R4GRIE$DIA0:[SYS0.SYSCOMMON.][SYSLIB]UCX$IPC_SHR.EXE;1
  1349.   -SYSTEM-F-PRIVINSTALL
  1350.  
  1351.    it means the system manager has to install the UCX sharable library:
  1352.  
  1353.   INSTALL ADD SYS$SHARE:UCX$IPC_SHR.EXE
  1354.  
  1355. 7.2.2. Wollongong / Attachmate TCP/IP Wollongong (now Attachmate (now
  1356. defunct)) support should work for both new (PathWay) and older (WIN/TCP)
  1357. versions, and C-Kermit versions linked under older Wollongong versions should
  1358. still run under the newer version. But note that the pieces of the Wollongong
  1359. package are now unbundled -- you have to buy the runtime, access, API, etc,
  1360. pieces separately, and (of course) you need the API to compile C-Kermit with
  1361. Wollongong TCP/IP support.
  1362.  
  1363. C-Kermit 7.0 has been verified to build on VMS ... with Pathway 3.1 with a
  1364. few harmless warning messages, but the following change is required to the
  1365. Attachmate-supplied file TWG$TCP:[NETDIST.MISC]DEF.COM to remove the
  1366. definition of DECC$SYSTEM_INCLUDE:
  1367.  
  1368.   $ diff twg$tcp:[netdist.misc]def.com
  1369.   ************
  1370.   File TWG$COMMON:[NETDIST.MISC]DEF.COM;2
  1371.      37   $! define decc$system_include   twg$tcp:[netdist.include],      -
  1372.      38   $!                              twg$tcp:[netdist.include.sys]
  1373.      39   $!
  1374.   ******
  1375.   File TWG$COMMON:[NETDIST.MISC]DEF.COM;1
  1376.      37   $ define decc$system_include    twg$tcp:[netdist.include],      -
  1377.      38                                   twg$tcp:[netdist.include.sys]
  1378.      39   $!
  1379.  
  1380.    You can't build VMS C-Kermit with Wollongong TCP/IP support using GCC
  1381.    due to the use of "noshare" in the Wollongong header files.
  1382.  
  1383.    Reportedly, when building C-Kermit with WIN/TCP support with older
  1384.    versions (5.1 and earlier?) of WIN/TCP, the symbol WIN$PERROR is
  1385.    undefined at link time and the build fails. Workaround: change the one
  1386.    reference to win$perror(), which occurs in the contti() function in
  1387.    CKVTIO.C, to be simply perror().
  1388.  
  1389. 7.2.3. TGV / Cisco / Process MultiNet If your VAX has the TGV MultiNet TCP/IP
  1390. networking product, CKVKER.COM automatically builds C-Kermit with MultiNet
  1391. TCP/IP support included. However:
  1392.  
  1393.      * In older (pre-V3.1) MultiNet installations, the header files might
  1394.        not be installed. Without these, C-Kermit will not build correctly.
  1395.        The system manager can add Multinet 3.1 programming support by
  1396.        installing MNETLIB031 from the Multinet distribution, if licensed
  1397.        to do so.
  1398.      * Anyone building the VMS version with certain versions of TGV
  1399.        MultiNet support under VAX C 3.1 might get an error message about
  1400.        conflicting definitions of "time_t". This is because of a conflict
  1401.        between DEC's <types.h> and MultiNet's <types.h> caused because DEC
  1402.        changed the definition between VAX C 3.0 and 3.1. Kermit can't do
  1403.        anything about this because CKVTIO.C #includes <time.h>, which
  1404.        itself includes <types.h>. The warning is not fatal.
  1405.  
  1406. 7.2.4. CMU-OpenVMS/IP CMU-OpenVMS/IP (CMUIP), originally CMU/Tek-TCP/IP, is a
  1407. public domain TCP/IP package originally developed at Carnegie-Mellon
  1408. University (CMU) by Tektronix (Tek). CMUIP was released to the public trust
  1409. in December 1992 as CMU-OpenVMS/IP and is now maintained by a diligent group
  1410. from around the Internet. Support is provided through the usenet group:
  1411.  
  1412.   vmsnet.networks.tcp-ip.cmu-tek
  1413.  
  1414.    BSD socket support for C-Kermit is supported thanks to a new
  1415.    CMU-OpenVMS/IP socket library written by Mike O'Malley of Digital
  1416.    Equipment Corporation. If you have this library installed on your VMS
  1417.    system, the build procedure will find the file
  1418.    CMUIP_ROOT:[SYSLIB]LIBCMU.OLB and C-Kermit will be built automatically
  1419.    with CMU-OpenVMS/IP support unless you define NET_OPTION to say
  1420.    otherwise. The LIBCMU socket library can be found on the
  1421.    kermit.columbia.edu anonymous ftp server.
  1422.  
  1423. 7.3. Adding SSL/TLS Security
  1424.  
  1425.    As of C-Kermit 8.0.208 it is possible to build VMS C-Kermit binaries
  1426.    with SSL/TLS security, allowing securely authenticated and encrypted
  1427.    SSL/TLS or SSL-TELNET connections to be made (but not FTP, since as yet
  1428.    Kermit's FTP client has not been ported to VMS). To build a secure
  1429.    version of VMS C-Kermit, include CK_SSL in P3 and define logicals
  1430.    OPENSSL and SSLLIB to point to OpenSSL and libs, or install Compaq SSL
  1431.    V1.0A. Note that SSL-enabled binaries are restricted by USA export law,
  1432.    and therefore can not be put on publicly accessible FTP or Web sites.
  1433.  
  1434.    [ [60]Contents ] [ [61]C-Kermit ] [ [62]Kermit Home ]
  1435.  
  1436. 8. CASE STUDY: ALPHA SETUP AND TEST RESULTS
  1437.  
  1438.    Written by Peter Mossel.
  1439.  
  1440.    Model number: DEC3000/400, a workstation with 64MB of memory.
  1441.    Ports used: OPA1: (a MMJ connector for the alternate operator console)
  1442.    TTA1: (a 25-pin male D-connector on the back)
  1443.    Operating System: OpenVMS V1.0
  1444.    Firmware: V1.1
  1445.  
  1446.    Upon power-up, the console displays something like:
  1447.  
  1448.   ...
  1449.   CPU   OK  KN15-BA V1.1-S11A IO20 sV1.0 DECchip 21064 P2.1
  1450.   ...
  1451.  
  1452.    Testing setup 1: OPA1:
  1453.  
  1454.   +-------+
  1455.   |     MMJ--- DECconnect cable ---MMJ H8571-A--- modem cable to PC
  1456.   +-------+                            (passive adapter)
  1457.  
  1458.    In words, plug a DECconnect cable with MMJ plugs on both ends in the
  1459.    alternate console port on the back of the DEC3000/400. Make sure S3 is
  1460.    in the "up" position. The workstation screen is now the console (OPA0:)
  1461.    and the extra port, OPA1:, is available for connecting a terminal or
  1462.    printer. This MMJ plug is the only MMJ plug on the back of this
  1463.    machine.
  1464.  
  1465.    My other host for the test is a DECpc 466, a 66MHz i486 with DOS 5.0
  1466.    and MS-DOS Kermit 3.12. The 466 has 2 serial ports, both 9-pin. I
  1467.    attached a standard 9-pin to 25-pin modem cable (the ones that came
  1468.    into existence with the IBM PC/AT which originally had only a 9-pin
  1469.    serial port) to the serial port on the 466.
  1470.  
  1471.    Now we must join a 25-pin connector and a MMJ connector. This is done
  1472.    with a passive adapter (H8571-A) which converts the RS423 signalling
  1473.    standard (balanced TX+ TX- RX+ RX-, DTR, DSR) to RS-232. All this is
  1474.    fairly standard for DEC sites. Note that when connecting a modem to an
  1475.    MMJ connector, we have only a subset of the required modem signals, so
  1476.    this is not supported via MMJ. The other port (TTA1) has full modem
  1477.    control. Note that the DECconnect cable always reverses TX and RX, so
  1478.    it effectively functions as a NULL-modem cable.
  1479.  
  1480.    Testing setup 2: TTA1
  1481.  
  1482.   +-------+
  1483.   |     25-pin D connector --- NULL modem cable to PC
  1484.   +-------+
  1485.  
  1486.    Use the (only) 25-pin D-connector on the back. Now we need a null modem
  1487.    cable (see the Kermit book), and, because my PC has a 9-pin serial
  1488.    port, I also need a 9-pin to 25-pin modem cable.
  1489.  
  1490.    Testing setup 3: LAT
  1491.  
  1492.    Connect the PC with a standard cable to the terminal server, which
  1493.    speaks LAT to my DEC3000/400. The speed can be set up to 19200 baud
  1494.    with the terminal server in use.
  1495.  
  1496.    Test script for setup 1 and 2:
  1497.  
  1498.    On DEC3000:
  1499.  
  1500. $ kermit
  1501. C-Kermit>set line xxx
  1502.    (where xxx is OPA1 or TTA1)
  1503. C-Kermit>set speed 19200
  1504.  
  1505.    On the PC:
  1506.  
  1507. C:\kermit
  1508. MS-Kermit>set port 1
  1509. MS-Kermit>set speed 19200
  1510. MS-Kermit>server
  1511.  
  1512.    On the DEC3000:
  1513.  
  1514. C-Kermit>get test.fil
  1515. C-Kermit>finish
  1516.  
  1517.    On the PC
  1518.  
  1519. MS-Kermit>quit
  1520.  
  1521.    Test script for setup 3 (LAT):
  1522.  
  1523.    On the PC
  1524.  
  1525. C:\kermit
  1526. MS-Kermit>set port 1
  1527. MS-Kermit>set speed 19200
  1528. MS-Kermit>connect
  1529.  
  1530.           ( Now log into DEC3000 as host )
  1531.  
  1532. $ kermit -x
  1533.  
  1534.           ( back to the PC )
  1535.  
  1536. MS-Kermit>get test.fil
  1537. MS-Kermit>bye
  1538.  
  1539.    Results:
  1540.  
  1541.    In all three cases, the data transfer speed is excellent. Over 80% of
  1542.    the bandwidth of the communication channel is used for the file
  1543.    transfer, sometimes even more. The DEC3000 is loaded with processes
  1544.    (MOTIF, Sybase DBMS, NFS clients and servers,...) and heavy network
  1545.    activity (DECnet, LAT, TCP/IP but no characters have ever been lost,
  1546.    even when the DBMS fires up. No special SYSGEN parameters, just
  1547.    configured for a normal workstation with MOTIF.
  1548.  
  1549.    Notes:
  1550.  
  1551.     1. Device protection
  1552.        In a system like this out of the box, the device protection on TTA1
  1553.        and OPA1 does not allow an unprivileged user to use these lines for
  1554.        DIAL-OUT from Kermit. Thus, the system manager must set every time
  1555.        the system is rebooted:
  1556.   $ set protection=w:rwlp/device OPA1:
  1557.   $ set protection=w:rwlp/device TTA1:
  1558.  
  1559.        Without these special protections, a terminal connected to these
  1560.        ports will still be able to login and get the "Username:" prompt.
  1561.     2. Console device speed
  1562.        The Alpha VMS V1.0 cover letter mentions that the command
  1563.   $ set terminal/speed=nnnn/perm/opa1:
  1564.  
  1565.        will have no effect on the speed of OPA1. In practice, there is no
  1566.        problem with Kermit file transfers. The data just get thru fine and
  1567.        file transfers are OK. The release notes also mention that setting
  1568.        the speed of OPA1 can be accomplished by setting the console
  1569.        environment variable "tta1_baud" to the desired speed. See the
  1570.        hardware guide on how to do this. The problem will be fixed in a
  1571.        future release.
  1572.  
  1573.    [ [63]Contents ] [ [64]C-Kermit ] [ [65]Kermit Home ]
  1574.  
  1575. 9. MAKING AND USING VMSINSTAL KITS
  1576.  
  1577.    (NOTE: This section is only for future reference, in case it becomes
  1578.    practical to distribute VMSINSTAL kits for C-Kermit. For now, please
  1579.    ignore.)
  1580.  
  1581.    (The reason it isn't practical to build VMSINSTAL kits is that they
  1582.    would be HUGE -- we have five networking options times two processors
  1583.    (VAX and Alpha) times two choices of whether you want to build from the
  1584.    source code or accept the included binary, and the resulting kit still
  1585.    would not solve the many VMS configuration problems discussed above.)
  1586.  
  1587.    After building C-Kermit using one of the procedures outlined above,
  1588.    execute the DCL procedure CKVMSI.COM to create a VMSINSTAL kit. This
  1589.    kit can be created either with or without the source code. In any case,
  1590.    it includes the C-Kermit executable program, the C-Kermit help file
  1591.    (for installation in your HELP library), plus a sample CKERMIT.INI
  1592.    (C-Kermit initialization) file, and release notes. You may now install
  1593.    C-Kermit using the command:
  1594.  
  1595.   @sys$update:vmsinstal kermit
  1596.  
  1597.    It will prompt you for which components you want installed, and where
  1598.    to put them. CKVMSI and CKVKIT were written by Terry Kennedy of Saint
  1599.    Peters College.
  1600.  
  1601. 9.1. Sample Header-File Extraction Procedure
  1602.  
  1603.    This one is for VAX C, and probably needs a few more files extracted
  1604.    from it than are shown below.
  1605.  
  1606. $!
  1607. $! XTRACTHD.COM
  1608. $! By Robert Weiner, Programming PLUS, rweiner@watsun.cc.columbia.edu
  1609. $! FEB-1992
  1610. $! Use this Extract Header command script to extract the VAXC header files
  1611. $! from sys$library:vaxcdef into the current directory inorder to compile
  1612. $! ckermit if you don't have the include files already in sys$library:
  1613. $! You must also modify the CKVKER.COM procedure to include
  1614. $! "CCFLAGS = /INC=([])" for this to work, ie. search current directory too.
  1615. $!
  1616. $ write sys$output "Extracting CKERMIT Include Files into Local Directory..."
  1617. $!
  1618. $lib /log /extract=CTYPE        /output=CTYPE.h         sys$library:vaxcdef.tlb
  1619. $lib /log /extract=DCDEF        /output=DCDEF.h         sys$library:vaxcdef.tlb
  1620. $lib /log /extract=DESCRIP      /output=DESCRIP.h       sys$library:vaxcdef.tlb
  1621. $lib /log /extract=DEVDEF       /output=DEVDEF.h        sys$library:vaxcdef.tlb
  1622. $lib /log /extract=DVIDEF       /output=DVIDEF.h        sys$library:vaxcdef.tlb
  1623. $lib /log /extract=ERRNO        /output=ERRNO.h         sys$library:vaxcdef.tlb
  1624. $lib /log /extract=FILE         /output=FILE.h          sys$library:vaxcdef.tlb
  1625. $lib /log /extract=IN           /output=IN.h            sys$library:vaxcdef.tlb
  1626. $lib /log /extract=INET         /output=INET.h          sys$library:vaxcdef.tlb
  1627. $lib /log /extract=IODEF        /output=IODEF.h         sys$library:vaxcdef.tlb
  1628. $lib /log /extract=JPIDEF       /output=JPIDEF.h        sys$library:vaxcdef.tlb
  1629. $lib /log /extract=LIMITS       /output=LIMITS.h        sys$library:vaxcdef.tlb
  1630. $lib /log /extract=NETDB        /output=NETDB.h         sys$library:vaxcdef.tlb
  1631. $lib /log /extract=RMS          /output=RMS.h           sys$library:vaxcdef.tlb
  1632. $lib /log /extract=SETJMP       /output=SETJMP.h        sys$library:vaxcdef.tlb
  1633. $lib /log /extract=SIGNAL       /output=SIGNAL.h        sys$library:vaxcdef.tlb
  1634. $lib /log /extract=SOCKET       /output=SOCKET.h        sys$library:vaxcdef.tlb
  1635. $lib /log /extract=SSDEF        /output=SSDEF.h         sys$library:vaxcdef.tlb
  1636. $lib /log /extract=STARLET      /output=STARLET.h       sys$library:vaxcdef.tlb
  1637. $lib /log /extract=STAT         /output=STAT.h          sys$library:vaxcdef.tlb
  1638. $lib /log /extract=STDIO        /output=STDIO.h         sys$library:vaxcdef.tlb
  1639. $lib /log /extract=STDLIB       /output=STDLIB.h        sys$library:vaxcdef.tlb
  1640. $lib /log /extract=STRING       /output=STRING.h        sys$library:vaxcdef.tlb
  1641. $lib /log /extract=STSDEF       /output=STSDEF.h        sys$library:vaxcdef.tlb
  1642. $lib /log /extract=SYIDEF       /output=SYIDEF.h        sys$library:vaxcdef.tlb
  1643. $lib /log /extract=TIME         /output=TIME.h          sys$library:vaxcdef.tlb
  1644. $lib /log /extract=TIMEB        /output=TIMEB.h         sys$library:vaxcdef.tlb
  1645. $lib /log /extract=TT2DEF       /output=TT2DEF.h        sys$library:vaxcdef.tlb
  1646. $lib /log /extract=TTDEF        /output=TTDEF.h         sys$library:vaxcdef.tlb
  1647. $lib /log /extract=TYPES        /output=TYPES.h         sys$library:vaxcdef.tlb
  1648. $lib /log /extract=UAIDEF       /output=UAIDEF.h        sys$library:vaxcdef.tlb
  1649. $!
  1650. $! The end
  1651. $!
  1652.  
  1653.    [ [66]Top ] [ [67]Contents ] [ [68]C-Kermit Home ] [ [69]C-Kermit 8.0
  1654.    Overview ] [ [70]Kermit Home ]
  1655.      __________________________________________________________________
  1656.  
  1657.    C-Kermit 8.0 VMS Installation Instructions / The Kermit Project /
  1658.    Columbia University / 30 June 2011
  1659.  
  1660. References
  1661.  
  1662.    1. http://www.columbia.edu/
  1663.    2. mailto:kermit@columbia.edu
  1664.    3. http://www.columbia.edu/kermit/index.html
  1665.    4. http://www.columbia.edu/kermit/k95.html
  1666.    5. http://www.columbia.edu/kermit/ckermit.html
  1667.    6. http://www.columbia.edu/kermit/ckscripts.html
  1668.    7. http://www.columbia.edu/kermit/current.html
  1669.    8. http://www.columbia.edu/kermit/whatsnew.html
  1670.    9. http://www.columbia.edu/kermit/faq.html
  1671.   10. http://www.columbia.edu/kermit/support.html
  1672.   11. http://www.columbia.edu/kermit/ckvins.html#contents
  1673.   12. http://www.columbia.edu/kermit/ckermit.html
  1674.   13. http://www.columbia.edu/kermit/index.html
  1675.   14. http://www.columbia.edu/kermit/ckvins.html
  1676.   15. http://www.columbia.edu/kermit/ckvins.html#x1
  1677.   16. http://www.columbia.edu/kermit/ckvins.html#x2
  1678.   17. http://www.columbia.edu/kermit/ckvins.html#x3
  1679.   18. http://www.columbia.edu/kermit/ckvins.html#x3.1
  1680.   19. http://www.columbia.edu/kermit/ckvins.html#x3.2
  1681.   20. http://www.columbia.edu/kermit/ckvins.html#x3.3
  1682.   21. http://www.columbia.edu/kermit/ckvins.html#x3.4
  1683.   22. http://www.columbia.edu/kermit/ckvins.html#x3.5
  1684.   23. http://www.columbia.edu/kermit/ckvins.html#x3.6
  1685.   24. http://www.columbia.edu/kermit/ckvins.html#x4
  1686.   25. http://www.columbia.edu/kermit/ckvins.html#x5
  1687.   26. http://www.columbia.edu/kermit/ckvins.html#x6
  1688.   27. http://www.columbia.edu/kermit/ckvins.html#x7
  1689.   28. http://www.columbia.edu/kermit/ckvins.html#x7.1
  1690.   29. http://www.columbia.edu/kermit/ckvins.html#x7.2
  1691.   30. http://www.columbia.edu/kermit/ckvins.html#x8
  1692.   31. http://www.columbia.edu/kermit/ckvins.html#x9
  1693.   32. http://www.columbia.edu/kermit/ckvins.html#x3
  1694.   33. http://www.columbia.edu/kermit/ckvins.html#x4
  1695.   34. http://www.columbia.edu/kermit/ckvins.html#x5
  1696.   35. http://www.columbia.edu/kermit/ckvins.html#x5
  1697.   36. http://www.columbia.edu/kermit/ckvins.html#contents
  1698.   37. http://www.columbia.edu/kermit/ckermit.html
  1699.   38. http://www.columbia.edu/kermit/index.html
  1700.   39. http://www.columbia.edu/kermit/cable.html
  1701.   40. ftp://kermit.columbia.edu/kermit/b
  1702.   41. http://www.columbia.edu/kermit/ckermit.html
  1703.   42. http://www.columbia.edu/kermit/ckvins.html#contents
  1704.   43. http://www.columbia.edu/kermit/ckermit.html
  1705.   44. http://www.columbia.edu/kermit/index.html
  1706.   45. http://www.columbia.edu/kermit/cable.html
  1707.   46. http://www.columbia.edu/kermit/ckvins.html#x5
  1708.   47. http://www.columbia.edu/kermit/ck60manual.html
  1709.   48. http://www.columbia.edu/kermit/ckvins.html#contents
  1710.   49. http://www.columbia.edu/kermit/ckermit.html
  1711.   50. http://www.columbia.edu/kermit/index.html
  1712.   51. http://www.columbia.edu/kermit/ckvins.html#contents
  1713.   52. http://www.columbia.edu/kermit/ckermit.html
  1714.   53. http://www.columbia.edu/kermit/index.html
  1715.   54. http://www.columbia.edu/kermit/ckvins.html#contents
  1716.   55. http://www.columbia.edu/kermit/ckermit.html
  1717.   56. http://www.columbia.edu/kermit/index.html
  1718.   57. http://www.columbia.edu/kermit/ckvins.html#contents
  1719.   58. http://www.columbia.edu/kermit/ckermit.html
  1720.   59. http://www.columbia.edu/kermit/index.html
  1721.   60. http://www.columbia.edu/kermit/ckvins.html#contents
  1722.   61. http://www.columbia.edu/kermit/ckermit.html
  1723.   62. http://www.columbia.edu/kermit/index.html
  1724.   63. http://www.columbia.edu/kermit/ckvins.html#contents
  1725.   64. http://www.columbia.edu/kermit/ckermit.html
  1726.   65. http://www.columbia.edu/kermit/index.html
  1727.   66. http://www.columbia.edu/kermit/ckvins.html#top
  1728.   67. http://www.columbia.edu/kermit/ckvins.html#contents
  1729.   68. http://www.columbia.edu/kermit/ckermit.html
  1730.   69. http://www.columbia.edu/kermit/ck80.html
  1731.   70. http://www.columbia.edu/kermit/index.html
  1732.