IVS-Kermit / MCS-Kermit USER GUIDE 1. INTRODUCTION 1 2. SYSTEM REQUIREMENTS 1 2.1. 9800 SYSTEM REQUIREMENTS 1 3. INSTALLING IVS-Kermit or MCS-Kermit 1 4. TRANSFERRING FILES 2 5. INITIALIZING MS-KERMIT AND IVS-KERMIT or MCS-Kermit 2 6. PERFORMING THE FILE TRANSFERS 5 6.1. Considering VE File Structures 5 6.1.1. V-Kermit File Structure Parameters 6 6.2. V-Kermit File Naming Conventions and Conversions 7 6.2.1. Wildcards in File Names 7 6.2.2. V-Kermit Reserved Name Extensions 8 6.3. Considering White Space 8 6.4. Check-off List to Consider Before Transferring Files 9 6.5. Transferring Multiple Files with One Command 11 6.6. Examples of File Transfers 11 6.6.1. Job Files 11 6.6.2. UPDATE patches and EBFs 11 6.7. Checking for Proper File Transfer Performance 11 6.7.1. Kermit Timeouts 11 6.7.1.1. MS-Kermit Timeouts 11 6.7.1.1.1. Send Timeout 12 6.7.1.1.2. Receive Timeout 12 6.7.1.2. V-Kermit Timeouts 12 6.7.1.2.1. Send Timeout 12 6.7.1.2.2. Receive Timeout 12 7. TERMINATING MS-KERMIT AND IVS-KERMIT or MCS-Kermit 12 8. IVS-Kermit or MCS-Kermit Error Messages 14 8.1. V-Kermit VE File Error Messages 15 9. MS-Kermit Error Messages 15 APPENDIX A CONTENTS OF KERMRC FILE 16 APPENDIX B Caveats 17 1. INTRODUCTION IVS-Kermit and MCS-Kermit have the same functionality which is to be in the Kermit 'server' mode on NCR 9800 systems and transfer files with MS-Kermit on a PC making the files compatible with the complex NCR file structures. IVS-Kermit works in the NCR IVS environment. MCS-Kermit works with PC-Console. To transfer files, you must use the IVS-Kermit or MCS-Kermit file transporter as explained in this chapter. 2. SYSTEM REQUIREMENTS Before you can use the IVS-Kermit or MCS-Kermit file trans- porter software, specific PC and 9800 system hardware and software requirements must be met, and IVS-Kermit or MCS- Kermit must be installed on the 9800 system. For information about the PC and 9800 system hardware and software requirements and information about installing IVS-Kermit or MCS-Kermit, refer to the "IVS-Kermit or MCS-Kermit Installation Guide". Specific hardware and software requirements must be met for the personal computer (PC) and for the 9800 system before files can be transferred. These requirements are explained in this sec- tion. You must have a PC with: A floppy disk containing MS-Kermit version 2.32/A (or later). At least 110 K of available memory, for MS-Kermit version 2.32/A. The MS-Kermit version 2.32/A consists of two files, named MSVIBM.EXE and MSKVKNIT. (Note: MS-Kermit is also known as Kermit-MS and MS-DOS Kermit.) An RS-232 communications capability (either through a modem or a dedicated line to the 9800 system). 2.1. 9800 SYSTEM REQUIREMENTS You must have a 9800-4 system with: VE4.0 operating system software. A dedicated TTY link available to which the PC can communicate (either dedicated or switched). The link can be established through a TTY line module, an ITTY line module (preferred over the TTY line module, a BMC line module, or a DSP communication port. The IVS-Kermit or MCS-Kermit soft- ware,installed as explained in the "IVS-Kermit or MCS-Kermit Installation Guide". A subcatalog available, if you wish to transfer files to/from the Catalog. A volume assigned to SUD DO2, if you wish to transfer files to/from disk. 3. INSTALLING IVS-Kermit or MCS-Kermit IVS-Kermit or MCS-Kermit needs to be installed on the 9800 system only once. Once installed, IVS-Kermit or MCS-Kermit will be available and ready for use with MS-Kermit or SuperVi- sion as explained in the "Transferring Files" section of this chapter. When your operating system software was installed, 3 IVS-Kermit or MCS-Kermit files were copied to the system CPL (volume 98004n, where "n" is a number in the range of 1-9). The names of the files are: KERM_MCS ( The MCS-Kermit load object file ) MCSKJ ( The job file that starts MCS-Kermit ) KERMRC ( An initialization file ) Appendix A of this chapter shows the contents of the MCSKJ and KERMRC files for your information. These 3 files make up the IVS-Kermit or MCS-Kermit software; it is through them that you control IVS-Kermit or MCS-Kermit. To install IVS-Kermit or MCS-Kermit, perform the following sequence of actions: Copy files KERM_MCS, MCSKJ, and KERMRC from the system CPL to a user CPL (volume 98003n, where "n" is a number in the range of 1-9). Check the contents of file MCSKJ. If the values specified in the file are not correct for your specific system, edit the files so that they specify values that are compatible with your system. If you wish to be able to transfer files to/from the Catalog (as opposed to, or in addition to, disk), copy file KERMRC from the system CPL to the desired subcatalog; then change the file name to kermrc. (Note: "kermrc" must be lowercase.) If you wish to be able to transfer files to/from disk (as opposed to, or in addition to, the Catalog), copy file KERMRC from the system CPL to SUD D02; then change the file name to kermrc. (Note: "kermrc" must be lowercase.) IVS-Kermit or MCS-Kermit is now installed. You are now ready to transfer files as explained in the "Transferring Files" sec- tion of this chapter. 4. TRANSFERRING FILES Once IVS-Kermit or MCS-Kermit has been installed on the 9800 system and the hardware and software requirements have been met, you can transfer files from the PC to/from disk or to/from the Catalog. The procedure for transferring files involves three major steps: Initializing MS-Kermit and IVS-Kermit or MCS-Kermit Performing the File Transfer Terminating MS-Kermit and IVS-Kermit or MCS-Kermit The remainder of this chapter explains each of the three steps in detail. Follow these steps, in the order presented, to ensure that your files are successfully transferred to/from disk or to/from the Catalog. 5. INITIALIZING MS-KERMIT AND IVS-Kermit or MCS-KERMIT To initialize MS-Kermit and IVS-Kermit or MCS-Kermit, perform the following sequence of actions: If you are using MS-Kermit version 2.32/A, enter: msvibm.exe -f mskvknit MS-Kermit will initialize itself, then execute the commands in the MSKVKNIT file. The following screen will be displayed: IBM-PC Kermit-MS: 2.32/A 21 Jan 1989 Copyright (C) Trustees of Columbia University 1982, 1989 updated 2-6-90 Parity := EVEN Local-echo := OFF for FULL DUPLEX line Send timeout := 2 At the Kermit-MS> prompt, enter stat to display the MS-Kermit parameters. Then check the parameters to make sure that they are correct for your PC. Specifically, check the "Baud rate", "Parity", "Local echo" (full duplex should be "off"; half duplex should be "on"), and "Send time- out" parameters. If you need to change a parameter value, at the Kermit-MS> prompt enter set Once the MS-Kermit parameters are correct, at the Kermit-MS> prompt, enter connect The screen will change so that the cursor is in the upper left corner and the following banner is at the bottom of the (blank) screen: Esc-chr:^]?help:^]?port:1speed:9600 parity:even echo:loc VT102... Use SuperVision to start the MCSKJ job using RUNC or RUNJ. For example: RUNC,$.NODE.KERMIT.MCSKJ [1] The MCSKJ job will ask for the LPN to be used for the communica- tion link and will ask questions about the source/destination for the files. That sequence looks like: 0027 1921: ACCEPT DEFAULTS OF LPN=0104,SOURCE/DEST=CAT,NODE=$,VAR RECS,SEQORG,SIZE=500/BLOCKS?[Y,N] > :AN 27,'N' RESPONSE TRANSMITTED 0030 1921: SPECIFY LPN FOR MCS-KERMIT COMMUNICATION LINK. DEFAULT LPN IS 0104. 'X' TO STOP ASKING.[NNNN,X] > :AN 30,'150' RESPONSE TRANSMITTED 0033 1921: SELECT MCS-KERMIT SOURCE/DESTINATION ENVIRONMENT. DEFAULT ENVIRONMENT IS CAT.[CAT,DISK,X] > :AN 33,'' RESPONSE TRANSMITTED 0036 1921: PLEASE ENTER SUBCATALOG NODE NAME. DEFAULT IS THE $ NODE.[NODE NAME,X] > :AN 36,'$.NODE.KERMIT' RESPONSE TRANSMITTED 0039 1921: DO YOU WANT DATAFILES TO HAVE FIXED OR VARIABLE LENGTH RECORDS? DEFAULT IS VARIABLE.[F,V,X] > :AN 39,'' RESPONSE TRANSMITTED 0042 1921: WILL YOU UPLOAD FONT/FORM FILES? IF YES,ALL DATA FILES HAVE 'REL'ORGANIZATION;DEFAULT IS SEQ.[Y,N] > :AN 42,'' RESPONSE TRANSMITTED When MCS-Kermit is initialized and ready to transfer files the following messages will be displayed by the job: 0043 1921:34 2054 EXECUTE: MCSKERM 00/000000/0000. 0044 1921:31 3000 TC PROGRAM INITIALIZED. 0045 1921:5D 1101 OPERATOR INPUT PERMITTED(PBS1921 ) At this point the PC connection to the 9800 needs to be shifted to the LPN specified to the MCSKJ job. If using MS-Kermit di- rectly, do '^]b' and select the MCSKj link ( if the MICOM switch is being used the address syntax is #nn/nnn ). With SuperVision, switch over to the virtual channel that represents the LPN se- lected for the MCSKJ job. Depending how fast the above switch is done, some of the follow- ing sequence may be seen: Kermit-VRX server starting. # N3 If you need to change a IVS-Kermit or MCS-Kermit parameter value, perform the following sequence of actions: At the # N3 prompt, hold the CONTROL key down while pressing the ']' (right bracket) key followed by the letter 'c' key. The Kermit-MS> prompt will be displayed. Enter 'finish' The Kermit-MS> prompt will be redisplayed. Enter 'connect' The IVS-Kermit or MCS-Kermit prompt ('IVS-Kermit or MCS-Kermit>' will be displayed. Press the 'RETURN' key, then enter 'set '. Repeat this step for each parameter that needs to be changed. At the IVS-Kermit or MCS-Kermit prompt, enter 'server '. Several informational messages will be displayed followed by the #N3 prompt. The # N3 prompt (towards the bottom of the screen) is known as the "server mode" prompt, and indicates that files can now be transferred. The cursor is displayed under the "#" character. Refer to the "Performing the File Transfer" section for infor- mation about how to transfer files. Doing the SHOW, SHOW VERSION, ?, and QUIT commands results in the following: MCS-Kermit> SHO MCS-Kermit, 4E(072) 06 June 90, NCR VRX/VE Communications Parameters: Bits: 7, Parity: even, Duplex: full, Flow: xon/xoff Bits: 7, Handshake: none Protocol & Transfer Parameters: Send Receive (* = override) Timeout: 4 30* Padding: 0 0 Pad Character: 31 0 Packet Start: 1 1 Packet End: 13 10 Packet Length: 1000* 1000 (94) Block Check Type: 1 File Parameters: File Names: converted Debugging Log: none File Type: text Packet Log: none File Byte Size: 7 Transaction Log: none Incomplete File Disposition: discard, Init file: kermrc MCS-Kermit> SHO VER Versions: MCS-Kermit, 4E(072) 06 June 90 MCS-Kermit Protocol Module 4E(032), 31 May 90 V-Kermit functions, 4E(054) 29 May 90 VRX/E cmd package V2(023), 06 June 90 User Interface 4E(060), 06 June 90 NCR-VRX tty I/O, 4E, 01 June 90 for NCR VRX/VE VRX/VE file support, 4E(038) 30 May 90 for NCR VRX/VE MCS-Kermit> ? Command, one of the following: close echo exit help log quit server set show statistics take Again> Q 5.2 INSTALLING AND STARTING IVS-Kermit. Move the initialization file 'kermrc' to SUD=D02 and the catalog node you wish to transfer files from/to. In an IVS session execute the Procedure file IVSKPM. Answer the questions concerning source/destination and the structure of data files. This question sequence may look something like: > IVSKPM; BEGINNING IVSKPM FOR IVS-KERMIT FILE TRANSFERS. FOR GENERIC FILE USE. UPDATED ON 6-20-90. IVS-KERMIT 2.01 NOW HANDLES: 1000 BYTE PACKETS. MOVE kermrc TO YOUR SOURCE/DESTINATION CATALOG NODE AND SUD=D02 BEFORE CONTINUING. REFER TO THE V-KERMIT FS FOR MS-DOS FILE NAME EXTENSIONS USED FOR VRX FILES. EXAMPLES ARE: FN.N3(JOB),FN.PRO(SCL PROC),FN.C(C), FN.CO(COBOL),FN.NCR(NCRL),FN.NC(NEAT/C), FN.BIN(BINARY DATA FILE). OBJECT FILES(USE FN.OBJ). WARNINGS: IF YOUR IVS SESSION USES A DSP COMM PORT, MAX PACKET SIZE IS 222. PLEASE WAIT. PLEASE WAIT. PLEASE SELECT THE IVS-KERMIT ENVIRONMENT. THE IVS-KERMIT ENVIRONMENT DEFAULTS ARE: DATA FILES WITH: - SEQUENTIAL ORGANIZATION. (THERE IS A CHOICE FOR RELATIVE(FONT/FORM) FILE STRUCTURE.) - FILESIZE OF 500/BLOCKS - VARIABLE LENGTH RECORDS FILE SOURCE/DESTINATION OF: - USER CURRENT NODE IN CATALOG. DO YOU WANT TO ACCEPT THESE DEFAULTS? [Y,N] DEFAULT IS YES. Enter value for DEFAULTS WILL YOU UPLOAD PRINTER FONT/FORM FILES? [Y,N] IF YES, ALL DATA FILES WILL HAVE THE RELATIVE ORGANIZATION. DEFAULT IS NO. Enter value for ORG_CHOICE DO YOU WANT DATAFILES TO HAVE FIXED OR VARIABLE LENGTH RECORDS? [F,V] DEFAULT IS VARIABLE. Enter value for REC_TYPE SELECT IVS-KERMIT SOURCE/DESTINATION ENVIRONMENT. DEFAULT ENVIRONMENT IS CATALOG. [CAT,DISK] Enter value for ENV D IVS-KERMIT USING NON-CATALOG ENVIRONMENT. PERIPHERALS FOR JOB# 3842 NAME TYPE VSN VOLID STATUS SHARE CPL LPN SUD 683 READER 0A UP NO NO FD00 P11 VIRTUAL VOL BA 525252 UP YES NO 0122 D01 VIRTUAL VOL BA 600001 UP YES NO 0141 D02 VIRTUAL VOL BA 500288 UP YES NO 013E D05 VIRTUAL VOL BA 500289 UP YES NO 013F D06 SYSTEM CPLS VIRTUAL VOL BA 980042 CPL-1 UP YES YES 012E D90 VIRTUAL VOL BA 570590 CPL-2 UP YES YES 0139 D91 VIRTUAL VOL BA 980041 CPL-3 UP YES YES 013A D92 PLEASE ENTER(IN QUOTES) VOLUME NUMBER AND DEVICE TYPE. FOR EXAMPLE ('525252/BA') OR [CONTINUE] TO USE CURRENT D02. Enter value for VSN C IVS-KERMIT USING CURRENT D02. ENSURE THAT ENOUGH SPACE EXISTS ON D02 FOR THE LARGEST UPLOADED FILE. ENSURE THAT THE D02 DATAFILE FILESIZE PARAMETER IS BIG ENOUGH TO HOLD THE LARGEST FILE. SPECIFY FILESIZE VALUE FOR D02 DATAFILE REFERENCE USED BY DATA FILES. DEFAULT FILESIZE IS 500/BLOCKS. Enter value for FILESIZ 33 TERMINAL DEFINITIONS SUCCESSFULLY INSTALLED EXECUTING LOAD MODULE WERMIT. UPDATED 6-20-90. Parity := EVEN Duplex := FULL File type := TEXT Extended-length packets requested Extended-length packets requested IVS-Kermit, 4E(072) 06 June 90, NCR VRX/VE Communications Parameters: Bits: 7, Parity: even, Duplex: full, Flow: xon/xoff, Handshake: none Protocol & Transfer Parameters: Send Receive (* = override) Timeout: 4 30* Padding: 0 0 Pad Character: 31 0 Packet Start: 1 1 Packet End: 13 10 Packet Length: 1000* 1000 (94) Block Check Type: 1 8th-Bit Prefix: '&' File Parameters: File Names: converted Debugging Log: none File Type: text Packet Log: none File Byte Size: 7 Transaction Log: none Incomplete File Disposition: discard, Init file: kermrc When IVS-Kermit is initialized and ready to transfer files the following messages will be displayed by the job: Kermit-VRX server starting. IVS-Kermit, 4E(072) 06 June 90 Type ? for help Doing the SHOW, SHOW VERSION, ?, and QUIT commands results in the following: IVS-Kermit> IVS-Kermit>SHO VER SHO VER Versions: IVS-Kermit, 4E(072) 06 June 90 IVS-Kermit Protocol Module 4E(032), 31 May 90 V-Kermit functions, 4E(054) 29 May 90 VRX/E cmd package V2(023), 06 June 90 User Interface 4E(060), 06 June 90 NCR-VRX tty I/O, 4E, 01 June 90 for NCR VRX/VE VRX/VE file support, 4E(038) 30 May 90 for NCR VRX/VE IVS-Kermit> IVS-Kermit>? ? Command, one of the following: close echo exit help log quit server set show statistics take Again>Q Q IVS-KERMIT TERMINATED. PRINTING IVS-KERMIT TRANSFER HISTORY LOG(STDERR). PLEASE WAIT. END OF PRINTING STDERR. Home catalog name is $.PBS END OF IVSKP. 6. PERFORMING THE FILE TRANSFERS Once MS-Kermit and IVS-Kermit or MCS-Kermit are initialized you can transfer files by performing the following sequence of actions: When the server prompt (# N3) is displayed, hold the 'CONTROL' key while pressing the ']' (right bracket) key. The banner of text at the bottom of the screen will disappear, and the cursor will be displayed at the bottom of the screen. At the cursor, enter the letter 'c' (for "connect"). The Kermit-MS> prompt will be displayed. At the Kermit-MS> prompt, enter 'send/get' followed by the name of the file you wish to transfer to/from the PC and to/from the 9800 system. The PC file name may have its path fully qualified and it may have a MS-DOS extension. The file transfer will begin, and the following screen will be displayed with information appropriate for the file being transferred. Kermit-MS: 2.32/A 21 Jan 1989 File name: RJECOMM.NC KBytes transferred: 317 Percent transferred: 63 Sending/Receiving: In progress Number of packets: 1777 Packet length: 94 Number of retries: 97 Last error: Last message: SRCFILE(NAME=RJECOMM) When the "Sending" ( or 'Receiving' ) value in this screen is "Completed", the file transfer has completed. If you wish to transfer another file to/from the same location, enter another 's' or 'get' command and another file name. Once you are finished transferring the desired file(s), you can terminate MS-Kermit and IVS-Kermit or MCS-Kermit as explained in the "Terminating MS-Kermit and IVS-Kermit or MCS-Kermit" section of this chapter. 6.1. Considering VE File Structures When uploading files some consideration should be given to the details to the file structure that will be created on the VE side. And on download, the ability of IVS-Kermit or MCS-Kermit to 'find' the file is based on the descriptors used. Files on the PC are only of 3 types: 'Ascii' text files ( a stream of 'Ascii' characters including CR and LF ), 'binary' files( a stream of all 256 possible characters ), and the special case of VE 'OBJECT' files that were created on a download from V-Kermit. Files on the VE side are varied and complex and 'record' orient- ed. V-Kermit must convert between the simple MS-DOS format and the complex VE format using the setup parameters and instructions given by the operator. Beyond this, is the added complexity that the VRX-C compiler produces code that allows for the creation of only 2 types of VE files: One creates records based upon examining each uploaded character for the LF ( 0A ), which is stripped and not written to disk. The other creates variable length records that are just a stream of the characters received. 'set file type text/binary' has nothing to do with the creation of either of the above 2 file types. This is an unfortunate misnomer. The feature should be called 'set end-of-line conver- sion on/off'. All 'set file type' does is add LFs on download and strip them on uploads. The means by which V-Kermit selects one of the 2 above file types is by the file name extension. fn.OBJ, fn.BIN, and fn.Bnn cause the second type to be used; all other extensions cause the first type to be used. It really does not matter whether the file contains 'binary' or 'Ascii' data. Both types can be written to both of the above file types. 6.1.1. V-Kermit File Structure Parameters Consider the following parameters and their effects when deciding how to transfer a file: File name extension. 'Set file type text/binary' Existence of and location of CR and LF characters in the PC file. FCL override parameters in the MCSKJ job. RECORDSIZE FILESIZE DATESCHEME RMS CATALOG NOCAMHEADER How 'whitespace' is treated on the PC, by V-Kermit, and by FMS. For example: the 'TAB' ( 09 ) character may be defined at various lengths by a PC wordprocessor but FMS always substitutes 8 spaces before writing to disk (if the file name extension specifies the 'text' file structure described above ). 6.2. V-Kermit File Naming Conventions and Conversions The 3 character MS-DOS extension is the method used by IVS-Kermit or MCS-Kermit to know what type of VE file to open. Care must be taken to select the correct extension to match the de- sired file. MS-Kermit 's' and 'get' commands allow for al- iases. So the name on the PC does not need to match the VE file name and extension. As examples: Kermit-MS>s fn fn.N3 will create a source file on the VE side. Kermit-MS>get Remote Source File: fn.PRO Local Destination File: fn will look for a SCL Procedure file on the VE side and download it creating fn on the PC. 6.2.1. Wildcards in File Names The 'wildcard' characters '?' and '*' can only be used by MS- Kermit on uploads to IVS-Kermit or MCS-Kermit. See the section on multiple file transfers for the result when a wildcard matches more than one file 6.2.2. V-Kermit Reserved Name Extensions The extensions must be checked against the following list to insure that they do not accidentally coincide with one that V- Kermit considers 'reserved';. File types are encoded as follows: Set VRX/E File Default Type NAME Record BIN/ on VRX/E File Type Size Name TEXT PC C source 1-82 FN_C TEXT fn.c VRX/E COBOL source(no ID) 1-83 FN TEXT fn.CO VRX/E COBOL source(6 char ID) 1-83 FN TEXT fn.CO6 VRX/E COBOL source(8 char ID) 1-83 FN TEXT fn.CO8 NCRL source 1-82 FN TEXT fn.NCR NEAT/VE source 1-82 FN TEXT fn.NVS NEAT/VS source 1-82 FN TEXT fn.NVS NEAT/C source 1-83 FN TEXT fn.NC NEAT/3 source 1-82 FN TEXT fn.N3 VRX/E BASIC source 1-82 FN TEXT fn.BAS FORTRAN/V source 1-82 FN TEXT fn.FV VRX/E CATJOB source 1-82 FN TEXT fn.N3 Control string 1-82 FN TEXT fn.CS SCL procedure w/num 1-82 FN TEXT fn.PRN SCL procedure w/o num 1-82 FN TEXT fn.PRO Data (variable length records) 1-160 FN or TEXT fn.DAT or (text(ASCII) data) fn or (CRs and CRLFs manipulated FN_XYZ fn.xyz (by V-Kermit) Data (variable length records) 1-160 FN/BIN fn.DAT (text(ASCII) data) fn or (CRs and CRLFs unaltered FN_XYZ fn.xyz(by V-Kermit) Data (fixed length records) 1-nn FN TEXT fn.Dnn (text(ASCII) data) (CRs and CRLFs manipulated by V-Kermit) Data (fixed length records) 1-nn FN BIN fn.Dnn (text(ASCII) data) (CRs and CRLFs unaltered by V-Kermit) Data (binary data) 1-485 FN BIN fn.BIN (variable length records) Data (binary data) 1-nn FN BIN fn.Bnn (fixed length records) Object 1-490 FN BIN fn.OBJ The suffixes may be lower case. 6.3. Considering White Space Files that are created on the PC and then uploaded to V-Kermit need to consider 'white space' and record length. 'TAB's may be defined differently on the PC wordprocessor than by the VRX-C compiler, which generates the code that converts 'TAB's to spaces before writing to the VE disk. This conversion is always 8 spaces for each 'TAB'. 6.4. Check-off List to Consider Before Transferring Files V-Kermit Parameters 6.4.1. Communications Parameters MS-Kermit has 'set parity'. MS-Kermit has 'set loc on/off' consistent with duplex of the link. If 'set loc on' for full duplex links, MS-Kermit will display 'failed' for file transfer attempts. MS-Kermit has 'set sen pause'. Excessive retries and very slow performance will occur if this value is not large enough to allow the other side to prepare itself for input after it has sent something to MS-Kermit. In the case of SuperVision and the DSP f/w comm port, this value should be at lease 5 ms. In heavily loaded systems this may need to be increased. Of course, setting it unnecessarily high will degrade performance. This needs to be set separately for each host system. MS-Kermit has 'set speed'. MS-Kermit has 'set block-check-type'. V-Kermit has 'set parity'. V-Kermit has 'set duplex'. V-Kermit has 'set block-check'. 6.4.2. Characteristics of the file to be transferred: VE load/object file? Name = fn.OBJ 'set fil typ bin' VE source file? Name selected by type(fn.c fn.CO fn.CO6 fn.CO8 fn.NCR fn.NVS fn.NC fn.N3 fn.BAS fn.FV). Not > 81 chars between CRLFs on PC. 'set fil typ tex' VE control string or SCL Procedure file? Name selected from:fn.CS fn.PRN fn.PRO. Not > 80 chars between CRLFs on PC. 'set fil typ tex' Data file with no record structure? Name = fn.BIN 'set fil typ BIN' Data file with variable length records on VE side? Name = fn.DAT or fn or fn.xxx 'set file type tex/bin' FCL for REF=DATAFILE has variable RECORDSIZE. Data file with fixed length records on VE side? Name = fn.DAT or fn or fn.xxx 'set file type tex/bin' FCL for REF=DATAFILE has fixed RECORDSIZE. 6.4.3. Source/destination on VE side? Size of file on upload FCL FILESIZE correct if not RMS. DATESCHEME for control strings and SCL Procedure files. FCL with AGE needed if version 00 already exists on disk. Is the file going to/coming from a catalog node or disk? Once V-Kermit starts all files must go to/come from the specified catalog node or disk. V-Kermit must be ended and restarted to change this. 6.4.4. Special V-Kermit Text Manipulation Required? set send/receive add-linenum on/off(restricted for this release) set send/receive id-fields discard/keep. set send/receive line-numbers discard/keep. set send/receive renumber on/off. 6.4.5. Special White Space considerations? Does the PC file have 'TAB' characters that are not to represent 8 spaces? There is no parameter to control this. 6.5. Transferring Multiple Files with One Command There are two ways to upload more than one file with a single command. One is to use wildcards that match more than one file on an upload. The other is to use 'take' files that specify more than one 'send' command. Entire subdirectories may be uploaded by the '*.*' syntax. 'Take' files can also be used to download files by using multiple instances of the 'get' command. 6.6. Examples of File Transfers 6.6.1. Job Files The most common use of V-Kermit is to download a job file, edit it on the PC, upload it, and execute it. Care must be taken on the PC not to have records ( delimited by CR ) > 82 characters. The fn.N3 extension is used in this case. 6.6.2. UPDATE patches and EBFs Download of UPDATE patch files or EBFs from the VE system re- quires some care to preserve the precise structure that the VE 'boot' code needs. Use FCL parameters like:REF=DATAFILE, RECORD- SIZE=80. And insure IVS-Kermit or MCS-Kermit has 'set fil typ tex'. Any modifications to the file on the PC must preserve the 80 byte record structure and the upload must use the above parameters. 6.7. Checking for Proper File Transfer Performance During the transfer notice the 'number of retries' that MS-Kermit is updating. There should be few. If the number is more that 1 per Kbyte of data transferred, there is probably something wrong with the setup or the system. Use the MS-Kermit 'show statistics command at the end to a file transfer or the end of a file transfer session to get a feeling for the number of NAKs that were exchanged and the overall throughput. 6.7.1. Kermit Timeouts There are four timeout parameters in the V-Kermit environment: 6.7.1.1. MS-Kermit Timeouts 6.7.1.1.1. Send Timeout MS-Kermit 'set sen tim' is valid on uploads and downloads. It is not affected by the 'send init' exchange. It should be set to as low a value as possible without causing significantly increased number of retries. It defaults to 8. The distributed initiali- zation file MSKVKNIT sets it to 2. A value of 1 is likely to cause excessive retries by MS-Kermit. If there are more than 1 retry per 1K bytes of data, increase this value. 6.7.1.1.2. Receive Timeout MS-Kermit 'set rec tim' is in effect on uploads and downloads. It should be set to as low a value as possible without causing significantly increased number of retries. It defaults to 13. The distributed initialization file MSKVKNIT sets it to 2. A value of 1 is likely to cause excessive retries by MS-Kermit. If there are more than 1 retry per 1K bytes of data, increase this value. It is temporarily overridden by the 'send init' exchange to the V-Kermit 'set sen tim' value on downloads. 6.7.1.2. V-Kermit Timeouts 6.7.1.2.1. Send Timeout V-Kermit does not time the results of its sends; it relies on the 'set rec tim' of MS-Kermit to do that. It forces MS-Kermit to temporarily change its 'set rec tim' value in the 'send init' exchange. It should be set to as low a value as possible without causing significantly increased number of retries. It defaults to 10. The distributed initialization file KERMRC_XXX sets it to 2. A value of 1 is likely to cause excessive retries by MS-Kermit. If there are more than 1 retry per 1K bytes of data, increase this value. 6.7.1.2.2. Receive Timeout This value is always overridden to 30 making it (in effect) not used. 7. TERMINATING MS-KERMIT AND IVS-Kermit or MCS-KERMIT Once you have successfully transferred the desired file(s) to/from the 9800 system, you can terminate MS-Kermit and IVS- Kermit or MCS-Kermit by performing the following sequence of actions: At the Kermit-MS> prompt, enter 'finish' to terminate IVS-Kermit or MCS-Kermit's "server" mode. The Kermit-MS> prompt will be next. Enter 'connect' to return control from MS-Kermit back to the terminal emulator mode. The IVS-Kermit or MCS-Kermit> prompt will be displayed next. Enter 'quit' to terminate IVS-Kermit or MCS-Kermit. At this point, MS-Kermit can be used for other work as a terminal emulator. If you wish to terminate MS-Kermit, hold the 'CONTROL' key down while pressing the ']' (right bracket) key followed by the 'c' key. Then, when the Kermit-MS> prompt is displayed, enter 'quit' to terminate MS-Kermit. 8. IVS-Kermit or MCS-Kermit Error Messages Text enclosed by parentheses is replaced by program-determined data. The numbers assigned are the universal Kermit numbers with the omissions being related to functions not implemented by V- Kermit. 2. File not found 3. No readable file to send 4. NONAME (for a file) 5. Can't open file 6. User canceled transaction 7. Unimplemented server function 15. Unimplemented generic server function 16. Can't close file 17. Can't execute command 18. Unknown packet type 23. Write permission denied - (file name) 26. Read permission denied - (file name) 27. File not readable - (file name) 28. File not found - (file name) 29. Please complete this field - (data field shown) 31. Ambiguous - (ambiguous Kermit command) 32. Invalid - (invalid Kermit command) 34. Buffer full 36. Your escape character is not ASCII - (number), escape 45. (Failure reason) failure while handling failure 48. Failed (component) 52. Disconnected 73. Use 'set send' or 'set receive' instead 74. ?Unexpected file parameter 79. Sorry, 94 is the maximum 80. Not in ASCII control range - (number) 82. ?File specification required 83. ?Invalid format for debug() - (debug entry) 84. ?Invalid format for tlog() - (transaction log entry) 97. Missing parity 98. Command too long for internal buffer 100. Kermit command error: take file terminated. 102. ?You must tell which log 103. ?Debugging log wasn't open 104. ?Packet log wasn't open 106. ?Transaction log wasn't open 107. ?Unexpected log designator - (log file name) 109. You must specify what is to be logged 111. ?A file specification is required 112. ?You must specify a parameter to set 113. ?Take files nested too deeply 114. ?Wildcards not allowed in command file name 116. Sorry, debug log not available 117. Sorry, transaction log not available 120. Bad input format 123. Can't open (file name) 124. Unreadable input file 125. Can't write to (file name) 126. Bad output file 8.1. IVS-Kermit or MCS-Kermit VE File Error Messages In addition to these Kermit error messages, IVS-Kermit or MCS-Kermit will report messages specific to VE file problems. These will be sent in an error message packet to MS-Kermit for display to the operator. They will also be written to the file STDERR. OBJECT FILE VLI EXCEEDS MAX reading line > 80 char reading line > 82 char zsoutl: Maximum record length error (line truncated) ?Unable to receive data 9. MS-Kermit Error Messages MS-Kermit will generally only display errors that IVS-Kermit or MCS-Kermit has detected. Some of the errors that MS-Kermit will detect are: Warning - Non Ascii Char ?No response from host ?Unable to find file ?Unable to receive initiate-packet ?Word "ddd" is not usable here ?Word "s" is ambiguous APPENDIX A CONTENTS OF KERMRC FILE SET FILE TYPE text SET PARITY EVEN SET DUPLEX HALF SET SEND TIMEOUT 10 SET RECEIVE TIMEOUT 30 SET DELAY 0 SET SEN PAC 94 SET REC PAC 94 SERVER APPENDIX B Caveats This section contains warnings that emphasize points made in the Functional Specification and temporary restrictions for the current release. 4. Remember that the last line of an 'Ascii' file upload may not be written to the VE destination if the 'CRLF' ( 0D0A ) is not at the end of the PC file. 24. The MS-Kermit '^E' feature to cancel an upload in progress will result in a file fragment on the VE side. This is the Kermit designed intent for this feature. Consider using the MS- Kermit '^X' instead. 36. V-Kermit expects that 'source' and 'control string' files uploaded will not have records ( delimited by CR ) > 82 or 83 characters depending on the extension. Refer to 6.2.2 for the exact cases. An error message will be sent to MS-Kermit and the file transfer will be stopped if these lengths are exceeded. 31. If uploading a corrupted MS-DOS file ( for example, one that the directory size and the end-of-file indicator do not match ), MS-Kermit 2.32/A may detect this error and send a packet to IVS-Kermit or MCS-Kermit that will result in the 'unimple- mented server function' being returned by IVS-Kermit or MCS- Kermit. 42. There may be needed information on the 'P' card of a NEAT/VE or NEAT/VS file that will be 'removed' by IVS-Kermit or MCS-Kermit on downloads. 43. fn.Dnn and fn.Bnn only accept fn of < 8 chars. 50. fn.Dnn and fn.Bnn display at PC 'rec size=n' if fn = 7 chars. This is a cosmetic problem only; the actual record size is correct. 52. The 'ADD-LINENUM' feature is removed. 59. Upload of fn.Dnn and fn.Bnn do not create fixed length files. The interaction of FCL overrides at file open time and the FCL in the job needs to be examined in more detail. This may end up as a permanent restriction. Use the work- around of job FCL in the interim. MCS-Kermit / IVS-Kermit "SALES BROCHURE" ADVANTAGES OF V-Kermit OVER OTHER FILE TRANSPORT SYSTEMS 1. Excellent data integrity: best reputation of all TTY file transfer protocols; Kermit is not known to have any data integrity problems; Kermit can be trusted. Reliable even on poor quality telephone links. 2. Industry standard: many users know of Kermit; they do not need to be trained; it is available on most Pc. When a file needs to be transported, Kermit will always be one of the choices. 3. Supportability: Columbia University supports it with a technical phone line. Updates are easy to get. The source code is available for cus- tomizing; many other protocols release only object or make source available only with some difficulty or have source that is not that friendly. 4. Cost; Kermit is cheap; essentially free. This is pertinent not only to us but also important in consider- ing the popularity of various file transfer systems. If we do not have a Kermit capability, it is going to look strange. 5. Documentation Documentation is both an advantage and disadvantage. The document that comes with MS-Kermit is lengthy but accurate and fairly complete. But it is intimidating. 6. Testability: Relatively convenient to test on PCs, UNIX, and VE systems. No special hardware needed. Fully compatible with MICOM switch and STAM. 7. Compatibility: Kermit can run at any line speed (tested @ 19200/9600 baud). 8. File Organization: Kermit can accommodate any file organization via a specific implementation. Kermit can transfer any type of data including all 256 characters(bytes). 9. Implementation: One of the Kermit implementations is called C-Kermit and it is written in the 'C' language. This is suitable for conversion(porting) to the VE operating system. The 'C' language is a good language and fits in nicely with NCRs corporate lan- guage strategy. The C-Kermit implementation has some nice user features: command files, interactive commands, abbreviated commands, good command parsing, time-outs, good statistics displays, logging, debug features, repeated character compression, 3 byte CRC option, batch file transfer via name wildcards or command files, link connection facilities, control of the key parameters, server mode availability where one Kermit can control another Kermit, file name flexibility, etc.