File 7171.DOC AUTOMATIC LOGIN TO IBM MAINFRAMES FROM MS-DOS KERMIT Christine M. Gianone Manager, Kermit Developement and Distribution CUCCA/AcIS October 1991 This file describes two separate MS-DOS Kermit files for use with Columbia's IBM mainframe VM/CMS computers: 7171.SCR: A login script. 7171.INI: A key settings file. THE 7171.SCR FILE 7171.SCR is a script program for logging you in to a Columbia University VM/CMS system such as CUVMB, CUVMC, or CUVML, or to Columbia Library Information Online (CLIO) using MS-DOS Kermit from a campus Rolmphone, either a D-type data phone or a 244PC, through an IBM 7171 full-screen 3270 protocol converter. Although you can run this script program from within Kermit by typing the command "TAKE 7171.SCR", it is intended to be run from DOS command level via DOS Batch programs that can feed it certain information to customize its actions. Several of these Batch programs are provided: SIMB.BAT - Connects you to CUVMB. SIMC.BAT - Connects you to CUVMC. SIML.BAT - Connects you to CUVML. CLIO.BAT - Connects you to CLIO (no user ID or password required). To use these batch files, and 7171.SCR itself, you must be running MS-DOS Kermit 3.11 or later, and it must be installed as KERMIT.EXE in a directory that is part of your DOS PATH definition. 7171.SCR and the related Batch files should be in the same directory. For hard disk systems, this would normally be the directory C:\KERMIT\. For detailed instructions on installation and use of MS-DOS Kermit, see the Second Edition of "Using MS-DOS Kermit", available in the CUCCA/AcIS Business Office in 102 Philosophy and at local bookstores. Run any of these Batch programs just by typing its name (the part before ".BAT"), for example: C:\>simb (in this example, "C:\>" is the DOS prompt, and you type "simb" and then press the Enter key). The Batch programs accept two optional words on the DOS command line, after their names. The first is your mainframe user ID, for example XYZCU, and the second is your password: C:\>sima xyzcu secret If you leave out your password, 7171.SCR will prompt you for it. If you leave out the user ID and password, 7171.SCR will prompt you for both of them. If you run 7171.SCR from inside Kermit, it will prompt you for both of these, as well as which host to connect to, SIMB, SIMC, etc. Passwords are ignored, and are not prompted for, in CLIO connections. Once 7171.SCR knows your user ID and password, it tries to connect you to the desired mainframe system through your ROLMphone, using the default communication port and speed. Normally this is COM1 and 9600 bps, but you can change them by putting SET commands in your MSKERMIT.INI file, for example: SET PORT 2 SET SPEED 19200 If 7171.SCR fails to communicate with your ROLMphone, it will give you an informative message. Check your port and speed setting, make sure you have a data cable connecting your PCs serial port and the ROLMphone, make sure Kermit is using the same port the cable is connected to, make sure your ROLMphone actually does have a working data option, etc. For detailed troubleshooting instructions, see "Preparing for Data Communication with the CBX". Once 7171.SCR is talking to your ROLMphone, it attempts to connect to the "simulator" (7171: simb, simc, etc) you have asked for, then it tries to connect to connect to the desired VM/CMS system, then it tries to log you in automatically, and finally it it gives you a terminal screen to the VM/CMS host. Any of these steps can fail. If they do, you'll get an informative error message. Once you are successfully connected to the mainframe system, you will have a terminal screen. The characters you type on the keyboard are sent to the mainframe, and the characters sent by the mainframe appear on your screen. Two special Alt-key combinations are available for your use while the terminal screen is active. An Alt-key combination is entered by holding down the Alt key and pressing the indicated letter while Alt is held down. Alt-q (hold down Alt, press q): Hang up the data connection, exit Kermit, return to DOS. You should use Alt-Q only after you have logged out from the mainframe. Alt-x (hold down Alt, press x): Return to Kermit's "MS-Kermit>" prompt without logging out from the mainframe. To get back to the mainframe, type CONNECT and then press the Enter key. THE 7171.INI FILE 7171.INI is an MS-DOS Kermit command file that may be used to set up function keys for use with the 7171 front ends, SIMB, CLIO, etc, for IBM 3270 terminal emulation with Columbia's IBM 7171 front ends. MS-DOS Kermit is very flexible, and users may make whatever key assignments or other customizations they find desirable by editing the 7171.INI file. Here's a quick reference to the key assignments made by 7171.INI: PC key IBM function PC key IBM func. PC key IBM function F1 PF1 F2 PF2 Shift F1 PF11 Shift F2 PF12 Alt F1 PF21 Alt F2 PF22 tab -->| TAB Ctrl F1 PA1 Ctrl F2 PA2 shift tab |<-- BACK TAB F3 PF3 F4 PF4 Shift F3 PF13 Shift F4 PF14 Enter /___| ENTER Alt F3 PF23 Alt F4 PF24 \ Ctrl F3 undefined Ctrl F4 undefined Ctrl L CLEAR F5 PF5 F6 PF6 Shift F5 PF15 Shift F6 PF16 Del DELETE CHAR Alt F5 PA1 Alt F6 PA1 Ctrl F5 PA1 Ctrl F6 PA2 Ins TOGGLE INSERT Gray + PA2 F7 PF7 F8 PF8 Ctrl J NEWLINE Shift F7 PF17 Shift F8 PF18 Alt F7 undefined Alt F8 NEWLINE Ctrl Enter NEWLINE Ctrl F7 undefined Ctrl F8 NEWLINE F9 PF9 F10 PF10 Shift F9 PF19 Shift F10 PF20 Alt F9 undefined Alt F10 undefined Ctrl F9 undefined Ctrl F10 undefined 7171 PC 7171 PC 7171 PC 7171 PC PF1 F1 PF11 Shift F1 PF21 Alt F1 CLEAR Ctrl L PF2 F2 PF12 Shift F2 PF22 Alt F2 DELETE CHAR Del PF3 F3 PF13 Shift F3 PF23 Alt F3 ENTER Enter PF4 F4 PF14 Shift F4 PF24 Alt F4 FIELD BACK TAB |<-- (shift tab) PF5 F5 PF15 Shift F5 FIELD TAB -->| (tab) PF6 F6 PF16 Shift F6 HOME undefined PF7 F7 PF17 Shift F7 NEWLINE Ctrl J PF8 F8 PF18 Shift F8 TOGGLE INSERT Ins PF9 F9 PF19 Shift F9 PA1 Ctrl C or Ctrl F1 or Alt F5 or Ctrl F5 PF10 F10 PF20 Shift F10 PA2 Ctrl W or Ctrl F2 or Alt F6 or Ctrl F6 [End of 7171.DOC]