home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / kermit23.zip / CECA.DOC next >
Text File  |  1990-09-07  |  22KB  |  505 lines

  1.  
  2. Note: The instructions below cover use of PC KERMIT 3.0 on an IBM PC or
  3.       PS/2 with an extended keyboard.  (On the extended keyboard, the
  4.       function keys are across the top of the keyboard rather than on
  5.       the left hand side).  If you are using a version of Kermit earlier
  6.       than 3.0 or if you have an old PC keyboard with the PF keys down
  7.       the left hand side, some of the instructions below may not work on
  8.       your equipment.
  9.  
  10.       CECA's implementation of PC Kermit 3.0 includes the following
  11.       files --
  12.  
  13.                       KERMIT.EXE          MSKERMIT.INI
  14.                       MSKERM.DOC          HPKEYS.SET
  15.                       MSKERM.HLP          IBMKEYS.SET
  16.                       IBM.DOC             VAXKEYS.SET
  17.  
  18.  
  19. I.  USING PC KERMIT AS A TERMINAL EMULATION PROGRAM
  20.  
  21.     On the PC or PS/2 --
  22.  
  23.     1.  Set up modem and line connections if necessary.
  24.  
  25.     2.  Turn on all equipment and boot PC-DOS.
  26.  
  27.     3.  If in Grote 216, choose the KERM option from the menu and go to
  28.         step 4.  Otherwise, access the disk and directory in which
  29.         PC Kermit is stored and enter     KERMIT     to run the PC
  30.         Kermit program.
  31.  
  32.     4.  When you receive the "Kermit-MS>" prompt, enter one of the
  33.         following commands to set up your keyboard.  Enter
  34.  
  35.              IBM -- if logging onto CMS or MUSIC/SP on the IBM 4381,
  36.              VAX -- if logging onto the VAX 11/785,
  37.              HP  -- if logging onto the HP 950 or library computer.
  38.  
  39.         If you do not receive an error message, go to step 5.
  40.  
  41.              If you do receive an error message, you may not have all of
  42.              the necessary files and so will have to set up your
  43.              terminal configuration manually.  Enter the following
  44.              Kermit commands to set up the configuration:
  45.  
  46.                   SET PARITY EVEN
  47.                   SET FLOW-CONTROL XON/XOFF
  48.                   SET LOCAL-ECHO OFF
  49.                   SET TERMINAL VT102
  50.                   SET BAUD nnnn             -- where "nnnn" is the baud
  51.                                                rate of your equipment
  52.                   SET PORT n                -- where "n" is the number
  53.                                                of your COM port
  54.  
  55.         If you want to check your configuration, enter the Kermit
  56.         command     STATUS     .
  57.  
  58.     5.  Access the Gandalf network at UTC.
  59.  
  60.         THE METHOD YOU USE TO ACCESS GANDALF DEPENDS UPON WHETHER YOU
  61.         ARE DIALING IN FROM HOME OR ARE USING A MICRO IN ONE OF THE
  62.         MICRO COMPUTER LABS ON THE UTC CAMPUS.
  63.  
  64.         * If you are using one of the micro computers in the lab in
  65.           Hunter or Grote, follow the instructions in section A below.
  66.  
  67.         * If you are dialing in from home using a Hayes compatible
  68.           modem, go to section B below.
  69.  
  70.         * If you are dialing in from home on a modem which is not Hayes
  71.           compatible, consult the manufacturer's documentation.
  72.  
  73.       A.  Using a micro in Hunter or Grote Hall --
  74.  
  75.           -- Enter a     C     to connect to Gandalf.
  76.  
  77.           -- Press Alt-B (hold down the "Alt" key and the "B" key at the
  78.              same time).  Then press ENTER.  Continue pressing Alt-B and
  79.              ENTER until you get the Gandalf prompt:
  80.  
  81.                          PLEASE ENTER SERVICE (CLASS) OR HELP
  82.  
  83.              Go to step 6.
  84.  
  85.       B.  Dialing in from home using a Hayes compatible modem --
  86.  
  87.           -- Enter     SET BAUD nnnn    where nnnn is the baud rate of
  88.              your modem.
  89.  
  90.           -- Enter a     C     to connect to your modem.
  91.  
  92.           -- Enter       AT    .  You should get an OK message.
  93.  
  94.           -- For touch tone phones, enter     ATDTphone#     .
  95.              For rotary dial phones, enter    ATPTphone#     .
  96.              Do not include any blanks or dashes within this command.
  97.              Example:     ATDT7554452     .
  98.  
  99.              The phone numbers are --
  100.  
  101.                              755-4452 or 755-4472
  102.  
  103.           -- When you get a carrier, press ENTER one or more times.
  104.              You should get the Gandalf prompt "PLEASE ENTER SERVICE
  105.              (CLASS) OR HELP".
  106.  
  107.     6.  Once you have gotten the Gandalf prompt, enter one of the
  108.         following
  109.  
  110.                     IBM -- to log onto MUSIC or CMS.
  111.                     VAX -- to log onto the VAX 11/785.
  112.                     HP  -- to log onto the Academic Computing HP 950.
  113.                     LIB -- to log onto the library computer.
  114.  
  115.     7.  If you are logging onto the IBM, you will be prompted to
  116.         "ENTER TERMINAL TYPE:", enter     VT100     .
  117.  
  118.     8.  When you receive a prompt from the mainframe computer you have
  119.         chosen, proceed as usual.
  120.  
  121.  
  122. II.  FINDING THE FUNCTION KEYS AND OTHER SPECIAL KEYS ON THE IBM
  123.      EXTENDED KEYBOARD
  124.  
  125.      If you have all of the PC Kermit files listed at the beginning of
  126.      this handout and have executed step 4 correctly, your keyboard will
  127.      be set up as follows.
  128.  
  129.    A.  IBM 4381 (MUSIC and CMS) --
  130.  
  131.    IBM Extended Keyboard                     3270-type Terminal Keyboard
  132.  
  133.     F1 through F12                 ==         PF01 - PF12
  134.     Shift-F1 through Shift-F12     ==         PF13 - PF24
  135.     Tab                            ==         field tab
  136.     Shift-Tab                      ==         field backtab
  137.     Backspace                      ==         newline
  138.     Insert                         ==         toggle insert mode
  139.     Delete                         ==         delete
  140.     Home                           ==         clear screen
  141.     End                            ==         erase EOF
  142.     Page Up                        ==         PA1
  143.     Page Down                      ==         PA2
  144.     keypad Home                    ==         scroll to top of memory
  145.     keypad End                     ==         scroll to end of memory
  146.     keypad PgUp                    ==         scroll up page
  147.     keypad PgDn                    ==         scroll down page
  148.     keypad Ctrl-End                ==         save screen to KERMIT.SCN
  149.                                               file on PC.
  150.  
  151.      If you are using a different keyboard, some of the IBM keys can be
  152.      emulated as follows --
  153.  
  154.      PF keys -- on most PC keyboards, you can use ESC and the top two
  155.                 rows of alphanumeric keys, i.e.:
  156.  
  157.                 ESC,1 == PF01    ESC,2 == PF02  ...  ESC,= == PF12
  158.                 ESC,q == PF13    ESC,w == PF14  ...  ESC,\ == PF24
  159.                 ESC,comma-key == PA1     ESC,period-key == PA2
  160.                 left-arrow key == Backspace
  161.  
  162.  
  163.    B.  VAX keys (EVE Editor) --
  164.  
  165.    IBM Extended Keyboard                     VT 100 Keyboard
  166.  
  167.     Page Up                        ==         PF1 -- editor FIND
  168.     keypad /                       ==         PF2           HELP
  169.     keypad *                       ==         PF3           FORWARD/BACK
  170.     keypad -                       ==         PF4           DO
  171.     keypad 7                       ==         7             SELECT
  172.     keypad 8                       ==         8             REMOVE
  173.     keypad 9                       ==         9             INSERT HERE
  174.     keypad +                       ==         - (hyphen)    MOVE BY LINE
  175.     keypad Shift-+ (shift-plus)    ==         , (comma)     ERASE WORD
  176.     keypad 4                       ==         4             undefined
  177.     keypad 5 or up-arrow key       ==         5             UP
  178.     keypad 6                       ==         6             undefined
  179.     keypad 1 or back-arrow key     ==         1             LEFT
  180.     keypad 2 or down-arrow key     ==         2             DOWN
  181.     keypad 3 or right-arrow key    ==         3             RIGHT
  182.     keypad Enter                   ==         Enter         INSERT/OVERSTRIKE
  183.     keypad 0                       ==         0             NEXT SCREEN
  184.     keypad .                       ==         . (period)    PREVIOUS SCREEN
  185.     Backspace                      ==         delete
  186.     Shift-Backspace                ==         backspace
  187.     Delete                         ==         delete
  188.     F12                            ==         linefeed
  189.     Home                           ==         scroll to top of memory
  190.     Ctrl-Home                      ==         scroll up one page
  191.     End                            ==         scroll to bottom of memory
  192.     Ctrl-End                       ==         scroll down one page
  193.  
  194.  
  195.    C.  HP and LIB keys
  196.  
  197.    IBM Extended Keyboard                      HP Terminal
  198.  
  199.     Backspace                       ==         backspace
  200.  
  201.  
  202. III. USING KERMIT TO TRANSFER FILES BETWEEN A MAINFRAME AND A PC OR PS/2
  203.  
  204.  Use PC Kermit to log onto your account on the IBM 4381, VAX 11/785, or
  205.  HP 950 and proceed as follows --
  206.  
  207.     1.  When you have received the mainframe's system prompt, enter
  208.         KERMIT     to run the mainframe Kermit program.  (On the HP, you
  209.         may have to enter "RUN KERMIT.PUB.KERMIT").
  210.  
  211.     2.  When you receive the mainframe Kermit ">" prompt, enter
  212.         SHOW ALL     ("SHOW ?" on CMS) to display the settings of the
  213.         mainframe Kermit.  Reset any options which are incorrectly set
  214.         by entering the command     SET option value     where "option"
  215.         is the option to be reset and "value" is the new value of the
  216.         option.
  217.  
  218.         For example, on the VAX you must enter      SET PARITY EVEN
  219.         to configure VAX Kermit correctly BEFORE transferring any files.
  220.  
  221.     3.  Enter a mainframe Kermit file transfer command.  For example --
  222.  
  223.              RECEIVE                 (Receive a file from the PC)
  224.              RECEIVE <filename>      (Receive a file and store it
  225.                                       under the filename given)
  226.              SEND <filename>          (Send file to the PC)
  227.  
  228.         The message  "Please escape to local Kermit to RECEIVE/SEND the
  229.         file(s)" will be displayed on most systems.  (On the VAX, no
  230.         message is displayed unless an error occurs.  Enter one of the
  231.         commands above and then go on to step 4 if no error message is
  232.         displayed.)
  233.  
  234.     4.  Press Alt-x to escape back to PC Kermit.
  235.  
  236.     5.  Enter a PC Kermit file transfer command.  For example --
  237.  
  238.              RECEIVE                 (Receive a file from the mainframe)
  239.              RECEIVE <filename.ext>  (Receive under the filename given)
  240.              SEND <filename.ext>     (Send the PC file to the mainframe)
  241.  
  242.     6.  A screen such as this will be displayed:
  243.  
  244.                              File name:
  245.                     KBytes transferred:
  246.                    Percent transferred:
  247.                                Sending:  (or  Receiving:)
  248.  
  249.                      Number of packets:
  250.                          Packet length:
  251.                      Number of retries:
  252.                             Last error:
  253.                           Last message:
  254.  
  255.         When the transaction has been completed, "Completed" will be
  256.         displayed in the "Sending:" or "Receiving:" field.  Wait for
  257.         the "completed" message before preceding to step 7.
  258.  
  259.     7.  Enter a     C     to connect to the mainframe.  Then press
  260.         ENTER, if necessary, to get a Kermit prompt from the mainframe
  261.         Kermit.
  262.  
  263.     8.  Repeat steps 3 through 7 to transfer other files or enter the
  264.         EXIT     command to exit from the mainframe Kermit program.
  265.  
  266.  
  267. IV.  TO LOG OFF AND DISCONNECT
  268.  
  269.     1.  Log off of the mainframe.
  270.  
  271.     2.  Press  Esc  then, ` (left accent), then . (period) to return to
  272.         the Gandalf prompt.  Then enter     BYE    .
  273.  
  274.     3.  If connected through a modem, hang up.
  275.  
  276.     4.  Escape back to PC Kermit, by pressing Alt-x.
  277.  
  278.     5.  Enter     EXIT     to exit from PC Kermit.
  279.  
  280.  
  281. V.  PC KERMIT COMMANDS
  282.  
  283.      PC Kermit implements a large subset of the commands of "ideal"
  284.      Kermit.  The ones you are most likely to find useful are:
  285.  
  286.      CONNECT  as terminal to remote system.
  287.       DEFINE  macros of PC Kermit commands.
  288.       DELETE  local files.
  289.    DIRECTORY  listing of local files.
  290.           DO  a macro expansion.
  291.         EXIT  from PC Kermit.
  292.         HELP  about PC Kermit.
  293.         PUSH  to MS-DOS command level (enter DOS "EXIT" command to return).
  294.         QUIT  from PC Kermit
  295.      RECEIVE  files from remote Kermit.
  296.          RUN  an MS-DOS program.
  297.         SEND  files to remote Kermit.
  298.          SET  various parameters.
  299.         SHOW  various parameters.
  300.        SPACE  inquiry (about disk space).
  301.       STATUS  inquiry (about settings).
  302.         TAKE  commands from file.
  303.         TYPE  display a local file.
  304.      VERSION  display PC Kermit program version number.
  305.  
  306. The following SET commands are available in PC Kermit:
  307.  
  308.                BAUD  Communications port line speed (synonym for SPEED)
  309.                BELL  Whether to beep at the end of a transaction
  310.    BLOCK-CHECK-TYPE  Level of error checking for file transfer
  311.               DEBUG  Display packet contents during file transfer
  312.        DEFAULT-DISK  Default disk drive for file i/o
  313.         DESTINATION  Default destination device for incoming files
  314.             DISPLAY  For selecting the type of file transfer display
  315.                DUMP  Screen dump file (or device) name
  316.         END-OF-LINE  Packet termination character
  317.                 EOF  Method for determining or marking end of file
  318.              ESCAPE  Escape character for CONNECT
  319.        FLOW-CONTROL  Enable or disable XON/XOFF
  320.           HANDSHAKE  Half-duplex line turnaround option
  321.          INCOMPLETE  What to do with an incompletely received file
  322.                 KEY  Specify key redefinitions, or "keystroke macros"
  323.          LOCAL-ECHO  Specify which computer does the echoing during
  324.                         CONNECT
  325.           MODE-LINE  Whether to display a mode line during terminal
  326.                         emulation
  327.              PARITY  Character parity to use
  328.                PORT  Select a communications port
  329.              PROMPT  Change the "PC Kermit>" prompt to something else
  330.             RECEIVE  Request remote Kermit to use specified parameters
  331.              REMOTE  For running PC Kermit interactively from back port
  332.               RETRY  Packet retransmission threshold
  333.                SEND  Use the specified parameters during file transfer
  334.               SPEED  Communications port line speed (synonym for BAUD)
  335.           TAKE-ECHO  Control echoing of commands from TAKE files
  336.            TERMINAL  Emulation and parameters
  337.               TIMER  Enable/disable timeouts during file transfer
  338.             WARNING  Specify how to handle filename collisions
  339.  
  340.  
  341. VI.  CUSTOMIZING PC KERMIT
  342.  
  343. The commands in the file MSKERMIT.INI are executed automatically each
  344. time you run PC Kermit.  If you are dialing in from home, you may want
  345. to edit the MSKERMIT.INI file and change the "SET BAUD 9600" statement
  346. to match the baud rate of your modem.  Then you would not have to
  347. reset the baud rate each time you logged on.
  348.  
  349. When at UTC using a PC connected directly to the Gandalf network, you
  350. can use a baud rate of 9600 or 19200.  However, if PC Kermit has too
  351. many retries when you are trying to transfer a file, you should set the
  352. baud rate down to 2400.
  353.  
  354. The MSKERMIT.INI file contains three macros -- "IBM", "VAX", and "HP".
  355. You may alter these macros or create others if you wish.  To execute a
  356. macro stored in MSKERMIT.INI, enter the macro name as a command or enter
  357.  
  358.                            DO macro-name
  359.  
  360. If you wish to execute a large group of Kermit commands, store them into
  361. a file other than MSKERMIT.INI and then use the "TAKE" command within
  362. a macro to execute the commands in the other file.
  363.  
  364. For examples of the use of macros and of the "TAKE" command, look at
  365. the MSKERMIT.INI file and at the files IBMKEYS.SET, VAXKEYS.SET, and
  366. HPKEYS.SET.  Copies of these are appended to the end of the handout.
  367.  
  368.  
  369. VII.  SPECIAL NOTE FOR THOSE RUNNING PLOTS
  370.  
  371. Unlike PCPLOT, PC KERMIT doesn't switch between text and graphics mode
  372. automatically when a plot command is issued.  To toggle between VT100
  373. and TEK 4010 modes, press  ALT,-  (minus on main keyboard) or  Alt-w  .
  374. PC Kermit 3.0 supports four terminal types, so you must press  Alt,-
  375. or  ALT,w  three times to go from VT100 to TEK 4010 mode.
  376.  
  377. MSKERMIT.INI --
  378.  
  379.     ;  General settings for IBM 4381, VAX 785, and HP 950
  380.     ;
  381.     SET TERMINAL VT102
  382.     SET PORT 1
  383.     SET BAUD 9600
  384.     SET LOCAL-ECHO OFF
  385.     SET PARITY EVEN
  386.     ;
  387.     ;  Macros --
  388.     ;
  389.     DEFINE VAX    TAKE VAXKEYS.SET,
  390.     ;
  391.     DEFINE IBM    TAKE IBMKEYS.SET,
  392.     ;
  393.     DEFINE HP     TAKE HPKEYS.SET,
  394.     ;
  395.     DEFINE UTK    SET PARITY NONE,SET BAUD 2400,
  396.     ;
  397.  
  398. ========================================================================
  399.  
  400.  
  401.     ;                               IBMKEYS.SET
  402.     ;
  403.     ;  Sets IBM extended keyboard for use with IBM 4381.
  404.     ;
  405.     SET KEY  \315   \27\49                  ;  Set F1-F12 to PF01-PF12
  406.     SET KEY  \316   \27\50
  407.     SET KEY  \317   \27\51
  408.     SET KEY  \318   \27\52
  409.     SET KEY  \319   \27\53
  410.     SET KEY  \320   \27\54
  411.     SET KEY  \321   \27\55
  412.     SET KEY  \322   \27\56
  413.     SET KEY  \323   \27\57
  414.     SET KEY  \324   \27\48
  415.     SET KEY  \389   \27\45
  416.     SET KEY  \390   \27\61
  417.     ;
  418.     SET KEY  \852    \27q                   ;  Set Shift-F1-F12 to PF13-PF24
  419.     SET KEY  \853    \27w
  420.     SET KEY  \854    \27e
  421.     SET KEY  \855    \27r
  422.     SET KEY  \856    \27t
  423.     SET KEY  \857    \27y
  424.     SET KEY  \858    \27u
  425.     SET KEY  \859    \27i
  426.     SET KEY  \860    \27o
  427.     SET KEY  \861    \27p
  428.     SET KEY  \903    \27\
  429.     SET KEY  \904    \27|
  430.     ;
  431.     SET KEY  \4425   \27\44                 ;  Set gray Page Up key to PA1
  432.     SET KEY  \4433   \27\62                 ;  Set gray Page Down key to PA2
  433.     SET KEY  \4431   \27\127                ;  Set gray End key to ERASE EOF
  434.     SET KEY  \4423   \27OM                  ;  Set gray Home key to CLEAR
  435.     SET KEY  \270    \10                    ;  Set Backspace to NEWLINE
  436.     SET KEY  \4434   \27On                  ;  Set Insert to INSERT
  437.     SET KEY  \783    \27\27OD               ;  Set left tab to FIELD BACKTAB
  438.     ;
  439.     SET KEY  \2321   \Ktermtype             ;  Set Alt,w to toggle termtype
  440.     ;
  441.  
  442.     ====================================================================
  443.  
  444.     ;                              VAXKEYS.SET
  445.     ;
  446.     ;  Set keypad on IBM *EXTENDED* keyboard as VT100 keypad.  The Page Up
  447.     ;  key has been used as the "Gold" key because Num Lock can't be set.
  448.     ;
  449.     ;                                       IBM PC key          VT100 key
  450.     ;                                       --- -- ---          ---------
  451.     SET KEY  \4425  \27OP                 ; Page Up              PF1 (Gold)
  452.     SET KEY  \4937  \27OP                 ; Page Up upshifted    PF1 (Gold)
  453.     SET KEY  \4399  \27OQ                 ; /                    PF2
  454.     SET KEY  \311   \27OR                 ; *                    PF3
  455.     SET KEY  \330   \27OS                 ; -                    PF4
  456.     SET KEY  \327   \27Ow                 ; 7                    7
  457.     SET KEY  \839   \27Ow                 ; 7 num locked         7
  458.     SET KEY  \328   \27Ox                 ; 8                    8
  459.     SET KEY  \840   \27Ox                 ; 8 num locked         8
  460.     SET KEY  \329   \27Oy                 ; 9                    9
  461.     SET KEY  \841   \27Oy                 ; 9 num locked         9
  462.     SET KEY  \334   \27Om                 ; +                    -
  463.     SET KEY  \846   \27Ol                 ; + upshifted          comma (,)
  464.     SET KEY  \331   \27Ot                 ; 4                    4
  465.     SET KEY  \843   \27Ot                 ; 4 num locked         4
  466.     SET KEY  \332   \27Ou                 ; 5                    5
  467.     SET KEY  \844   \27Ou                 ; 5 num locked         5
  468.     SET KEY  \333   \27Ov                 ; 6                    6
  469.     SET KEY  \845   \27Ov                 ; 6 num locked         6
  470.     SET KEY  \335   \27Oq                 ; 1                    1
  471.     SET KEY  \847   \27Oq                 ; 1 num locked         1
  472.     SET KEY  \336   \27Or                 ; 2                    2
  473.     SET KEY  \848   \27Or                 ; 2 num locked         2
  474.     SET KEY  \337   \27Os                 ; 3                    3
  475.     SET KEY  \849   \27Os                 ; 3 num locked         3
  476.     SET KEY  \4365  \27OM                 ; Enter                Enter
  477.     SET KEY  \338   \27Op                 ; 0                    0
  478.     SET KEY  \850   \27Op                 ; 0 num locked         0
  479.     SET KEY  \339   \27On                 ; period (.)           period
  480.     SET KEY  \851   \27On                 ; period num locked    period
  481.     ;
  482.     ;  Other VT100 keyboard settings.
  483.     ;
  484.     SET KEY  \390   \10                   ; F12                  linefeed
  485.     SET KEY  \782   \08                   ; Backspace upshifted  backspace
  486.     SET KEY  \5495  \Kupscn               ; Ctrl Home            up page
  487.     SET KEY  \5493  \Kdnscn               ; Ctrl End             up page
  488.     ;
  489.     ;  Backspace, Delete, Home, End, Page Down, and the arrow keys work as
  490.     ;  expected and have not been altered.
  491.     ;
  492.     ;  Set Alt,w to \Ktermtype (toggle TEK 4010) to conform to PCPLOT
  493.     ;
  494.     SET KEY  \2321  \Ktermtype
  495.     ;
  496.  
  497. ========================================================================
  498.  
  499.     ;                                 HPKEYS.SET
  500.     ;
  501.     SET KEY  \270   \08                         ; set Backspace to backspace
  502.     ;
  503.  
  504. ========================================================================
  505.