home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / cu / 7171.doc < prev    next >
Text File  |  2020-01-01  |  7KB  |  164 lines
  1. File 7171.DOC
  2.  
  3.  
  4.          AUTOMATIC LOGIN TO IBM MAINFRAMES FROM MS-DOS KERMIT
  5.  
  6.  
  7.                  Christine M. Gianone
  8.         Manager, Kermit Developement and Distribution
  9.                   CUCCA/AcIS
  10.                  October 1991
  11.  
  12.  
  13. This file describes two separate MS-DOS Kermit files for use with Columbia's
  14. IBM mainframe VM/CMS computers:
  15.  
  16.   7171.SCR: A login script.
  17.   7171.INI: A key settings file.
  18.  
  19.  
  20. THE 7171.SCR FILE
  21.  
  22. 7171.SCR is a script program for logging you in to a Columbia University
  23. VM/CMS system such as CUVMB, CUVMC, or CUVML, or to Columbia Library
  24. Information Online (CLIO) using MS-DOS Kermit from a campus Rolmphone, either
  25. a D-type data phone or a 244PC, through an IBM 7171 full-screen 3270 protocol
  26. converter.
  27.  
  28. Although you can run this script program from within Kermit by typing the
  29. command "TAKE 7171.SCR", it is intended to be run from DOS command level
  30. via DOS Batch programs that can feed it certain information to customize its
  31. actions.  Several of these Batch programs are provided:
  32.  
  33.   SIMB.BAT - Connects you to CUVMB.
  34.   SIMC.BAT - Connects you to CUVMC.
  35.   SIML.BAT - Connects you to CUVML.
  36.   CLIO.BAT - Connects you to CLIO (no user ID or password required).
  37.  
  38. To use these batch files, and 7171.SCR itself, you must be running MS-DOS
  39. Kermit 3.11 or later, and it must be installed as KERMIT.EXE in a directory
  40. that is part of your DOS PATH definition.  7171.SCR and the related Batch
  41. files should be in the same directory.  For hard disk systems, this would
  42. normally be the directory C:\KERMIT\.
  43.  
  44. For detailed instructions on installation and use of MS-DOS Kermit, see the
  45. Second Edition of "Using MS-DOS Kermit", available in the CUCCA/AcIS Business
  46. Office in 102 Philosophy and at local bookstores.
  47.  
  48. Run any of these Batch programs just by typing its name (the part before
  49. ".BAT"), for example:
  50.  
  51.   C:\>simb
  52.  
  53. (in this example, "C:\>" is the DOS prompt, and you type "simb" and then
  54. press the Enter key).
  55.  
  56. The Batch programs accept two optional words on the DOS command line, after
  57. their names.  The first is your mainframe user ID, for example XYZCU, and 
  58. the second is your password:
  59.  
  60.   C:\>sima xyzcu secret
  61.  
  62. If you leave out your password, 7171.SCR will prompt you for it.  If you
  63. leave out the user ID and password, 7171.SCR will prompt you for both of
  64. them.  If you run 7171.SCR from inside Kermit, it will prompt you for both
  65. of these, as well as which host to connect to, SIMB, SIMC, etc.
  66.  
  67. Passwords are ignored, and are not prompted for, in CLIO connections.
  68.  
  69. Once 7171.SCR knows your user ID and password, it tries to connect you to
  70. the desired mainframe system through your ROLMphone, using the default
  71. communication port and speed.  Normally this is COM1 and 9600 bps, but you
  72. can change them by putting SET commands in your MSKERMIT.INI file, for
  73. example:
  74.  
  75.   SET PORT 2
  76.   SET SPEED 19200
  77.  
  78. If 7171.SCR fails to communicate with your ROLMphone, it will give you an
  79. informative message.  Check your port and speed setting, make sure you 
  80. have a data cable connecting your PCs serial port and the ROLMphone, make
  81. sure Kermit is using the same port the cable is connected to, make sure your
  82. ROLMphone actually does have a working data option, etc.  For detailed
  83. troubleshooting instructions, see "Preparing for Data Communication with
  84. the CBX".
  85.  
  86. Once 7171.SCR is talking to your ROLMphone, it attempts to connect to the
  87. "simulator" (7171: simb, simc, etc) you have asked for, then it tries to
  88. connect to connect to the desired VM/CMS system, then it tries to log you in
  89. automatically, and finally it it gives you a terminal screen to the VM/CMS
  90. host.  Any of these steps can fail.  If they do, you'll get an informative
  91. error message.
  92.  
  93. Once you are successfully connected to the mainframe system, you will have a
  94. terminal screen.  The characters you type on the keyboard are sent to the
  95. mainframe, and the characters sent by the mainframe appear on your screen.
  96.  
  97. Two special Alt-key combinations are available for your use while the terminal
  98. screen is active.  An Alt-key combination is entered by holding down the Alt
  99. key and pressing the indicated letter while Alt is held down.
  100.  
  101.   Alt-q (hold down Alt, press q):
  102.      Hang up the data connection, exit Kermit, return to DOS.  You should use
  103.      Alt-Q only after you have logged out from the mainframe.
  104.  
  105.   Alt-x (hold down Alt, press x):
  106.      Return to Kermit's "MS-Kermit>" prompt without logging out from the
  107.      mainframe.  To get back to the mainframe, type CONNECT and then press
  108.      the Enter key.
  109.  
  110.  
  111. THE 7171.INI FILE
  112.  
  113. 7171.INI is an MS-DOS Kermit command file that may be used to set up function
  114. keys for use with the 7171 front ends, SIMB, CLIO, etc, for IBM 3270 terminal
  115. emulation with Columbia's IBM 7171 front ends.  MS-DOS Kermit is very
  116. flexible, and users may make whatever key assignments or other customizations
  117. they find desirable by editing the 7171.INI file.
  118.  
  119. Here's a quick reference to the key assignments made by 7171.INI:
  120.  
  121. PC key     IBM function   PC key    IBM func.       PC key      IBM function
  122.  
  123.       F1   PF1                 F2   PF2
  124. Shift F1   PF11          Shift F2   PF12
  125. Alt   F1   PF21          Alt   F2   PF22            tab  -->|   TAB
  126. Ctrl  F1   PA1           Ctrl  F2   PA2
  127.                                               shift tab  |<--   BACK TAB
  128.       F3   PF3                 F4   PF4
  129. Shift F3   PF13          Shift F4   PF14          Enter /___|   ENTER
  130. Alt   F3   PF23          Alt   F4   PF24                \
  131. Ctrl  F3   undefined     Ctrl  F4   undefined
  132.                                                     Ctrl  L     CLEAR
  133.       F5   PF5                 F6   PF6
  134. Shift F5   PF15          Shift F6   PF16                  Del   DELETE CHAR
  135. Alt   F5   PA1           Alt   F6   PA1
  136. Ctrl  F5   PA1           Ctrl  F6   PA2                   Ins   TOGGLE INSERT
  137.                                                        Gray +   PA2
  138.  
  139.       F7   PF7                 F8   PF8              Ctrl J     NEWLINE
  140. Shift F7   PF17          Shift F8   PF18
  141. Alt   F7   undefined     Alt   F8   NEWLINE        Ctrl Enter   NEWLINE
  142. Ctrl  F7   undefined     Ctrl  F8   NEWLINE
  143.  
  144.       F9   PF9                 F10  PF10
  145. Shift F9   PF19          Shift F10  PF20
  146. Alt   F9   undefined     Alt   F10  undefined
  147. Ctrl  F9   undefined     Ctrl  F10  undefined
  148.  
  149.  
  150. 7171 PC    7171   PC       7171   PC      7171               PC
  151.  
  152. PF1  F1    PF11 Shift F1   PF21 Alt F1    CLEAR           Ctrl L
  153. PF2  F2    PF12 Shift F2   PF22 Alt F2    DELETE CHAR     Del
  154. PF3  F3    PF13 Shift F3   PF23 Alt F3    ENTER           Enter
  155. PF4  F4    PF14 Shift F4   PF24 Alt F4    FIELD BACK TAB  |<-- (shift tab)
  156. PF5  F5    PF15 Shift F5                  FIELD TAB       -->|  (tab)
  157. PF6  F6    PF16 Shift F6                  HOME            undefined
  158. PF7  F7    PF17 Shift F7                  NEWLINE         Ctrl J
  159. PF8  F8    PF18 Shift F8                  TOGGLE INSERT   Ins
  160. PF9  F9    PF19 Shift F9   PA1 Ctrl C or Ctrl F1 or Alt F5 or Ctrl F5
  161. PF10 F10   PF20 Shift F10  PA2 Ctrl W or Ctrl F2 or Alt F6 or Ctrl F6
  162.  
  163. [End of 7171.DOC]
  164.