home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / d / ncrker.doc < prev    next >
Text File  |  2020-01-01  |  42KB  |  1,235 lines
  1. IVS-Kermit / MCS-Kermit USER GUIDE
  2.  
  3.  
  4. 1. INTRODUCTION                                                1
  5.  
  6. 2. SYSTEM REQUIREMENTS                                         1
  7. 2.1. 9800 SYSTEM REQUIREMENTS                                  1
  8.  
  9. 3.    INSTALLING IVS-Kermit or MCS-Kermit                      1
  10.  
  11. 4.  TRANSFERRING FILES                                         2
  12.  
  13. 5.  INITIALIZING MS-KERMIT AND IVS-KERMIT or MCS-Kermit        2
  14.  
  15. 6.  PERFORMING THE FILE TRANSFERS                              5
  16. 6.1. Considering VE File Structures                            5
  17. 6.1.1.    V-Kermit File Structure Parameters                   6
  18. 6.2.    V-Kermit File Naming Conventions and Conversions       7
  19. 6.2.1.    Wildcards in File Names                              7
  20. 6.2.2.    V-Kermit Reserved Name Extensions                    8
  21. 6.3. Considering White Space                                   8
  22. 6.4.    Check-off List to Consider Before Transferring Files   9
  23. 6.5. Transferring Multiple Files with One Command              11
  24. 6.6. Examples of File Transfers                                11
  25. 6.6.1.    Job Files                                            11
  26. 6.6.2.    UPDATE patches and EBFs                              11
  27. 6.7. Checking for Proper File Transfer Performance             11
  28. 6.7.1.    Kermit Timeouts                                      11
  29. 6.7.1.1.  MS-Kermit Timeouts                                   11
  30. 6.7.1.1.1.    Send Timeout                                     12
  31. 6.7.1.1.2.    Receive Timeout                                  12
  32. 6.7.1.2.    V-Kermit Timeouts                                  12
  33. 6.7.1.2.1.    Send Timeout                                     12
  34. 6.7.1.2.2.    Receive Timeout                                  12
  35.  
  36. 7.  TERMINATING MS-KERMIT AND IVS-KERMIT or MCS-Kermit         12
  37.  
  38. 8.  IVS-Kermit or MCS-Kermit Error Messages                    14
  39. 8.1. V-Kermit VE File Error Messages                           15
  40.  
  41. 9.  MS-Kermit Error Messages                                   15
  42.  
  43. APPENDIX A  CONTENTS OF KERMRC FILE                            16
  44.  
  45. APPENDIX B  Caveats                                            17
  46. 1.    INTRODUCTION 
  47.  
  48. IVS-Kermit and MCS-Kermit have the same functionality which is to 
  49. be  in the Kermit 'server' mode on NCR 9800 systems and  transfer 
  50. files with MS-Kermit on a PC making the files compatible with the 
  51. complex  NCR  file structures.  IVS-Kermit works in the  NCR  IVS 
  52. environment.  MCS-Kermit works with PC-Console.
  53.  
  54. To   transfer  files, you must use the IVS-Kermit  or  MCS-Kermit 
  55. file transporter as explained in this chapter.  
  56.  
  57. 2.    SYSTEM REQUIREMENTS 
  58.  
  59. Before   you  can use the IVS-Kermit or MCS-Kermit   file  trans-
  60. porter   software,  specific   PC and 9800  system  hardware  and  
  61. software   requirements must  be  met,  and  IVS-Kermit  or  MCS-
  62. Kermit   must be installed on  the  9800 system. For  information 
  63. about  the PC and 9800 system hardware and software  requirements 
  64. and  information  about    installing IVS-Kermit  or  MCS-Kermit, 
  65. refer to the "IVS-Kermit or MCS-Kermit Installation Guide".     
  66.  
  67. Specific  hardware and software requirements must be met for  the   
  68. personal computer (PC) and for the 9800 system before files   can 
  69. be  transferred. These requirements are   explained in this  sec-
  70. tion.  
  71.  
  72. You  must  have a PC with:  A floppy  disk  containing  MS-Kermit 
  73. version  2.32/A (or later). At least 110 K of  available  memory, 
  74. for MS-Kermit version 2.32/A.  
  75.  
  76. The    MS-Kermit  version 2.32/A consists of two  files,    named 
  77. MSVIBM.EXE  and  MSKVKNIT.  (Note: MS-Kermit  is  also  known  as   
  78. Kermit-MS and MS-DOS Kermit.)  
  79.  
  80. An RS-232 communications capability (either through a modem or  a   
  81. dedicated line to the 9800 system).  
  82.  
  83. 2.1.     9800 SYSTEM REQUIREMENTS  
  84.  
  85. You  must  have  a 9800-4 system with:   VE4.0  operating  system 
  86. software.   A  dedicated TTY link available to which the  PC  can 
  87. communicate  (either    dedicated or switched). The link  can  be 
  88. established   through   a  TTY    line  module,  an   ITTY   line 
  89. module (preferred over the TTY line module, a BMC line module, or 
  90. a  DSP   communication port.  The IVS-Kermit or MCS-Kermit  soft-
  91. ware,installed  as  explained in the  "IVS-Kermit  or  MCS-Kermit 
  92. Installation  Guide".  A  subcatalog available, if  you  wish  to 
  93. transfer  files to/from the Catalog. A  volume  assigned  to  SUD 
  94. DO2, if you wish  to  transfer  files to/from   disk.   
  95.  
  96. 3.    INSTALLING IVS-Kermit or MCS-Kermit  
  97.  
  98. IVS-Kermit  or  MCS-Kermit   needs to be installed  on  the  9800 
  99. system  only   once. Once   installed, IVS-Kermit  or  MCS-Kermit 
  100. will be available and ready for  use with   MS-Kermit or SuperVi-
  101. sion  as explained in the "Transferring Files"  section  of  this   
  102. chapter.  When your  operating  system software  was installed, 3 
  103. IVS-Kermit or MCS-Kermit   files were copied to  the system   CPL 
  104. (volume  98004n, where "n" is a   number in the  range  of  1-9).  
  105. The names of the files are: KERM_MCS ( The MCS-Kermit load object 
  106. file )
  107.  
  108. MCSKJ    ( The job file that starts MCS-Kermit )
  109.  
  110. KERMRC   ( An initialization file )
  111.  
  112. Appendix  A of this chapter shows the contents of the  MCSKJ  and 
  113. KERMRC  files  for your information.  These 3 files make  up  the 
  114. IVS-Kermit or MCS-Kermit  software; it is through them   that you
  115. control  IVS-Kermit or MCS-Kermit.  
  116.  
  117. To  install   IVS-Kermit or MCS-Kermit, perform the following
  118. sequence  of  actions:  
  119.  
  120. Copy  files KERM_MCS, MCSKJ, and KERMRC from the system CPL to  a 
  121. user   CPL (volume 98003n, where "n" is a number in the range  of 
  122. 1-9). Check  the contents of file MCSKJ.  If the values specified    
  123. in  the file are not correct for your specific system,  edit  the 
  124. files  so that they specify values that are compatible with  your 
  125. system.  
  126.  
  127. If  you  wish to be able to transfer  files to/from  the  Catalog   
  128. (as  opposed to, or in addition to, disk), copy file KERMRC  from 
  129. the  system CPL to the desired subcatalog; then change  the  file 
  130. name to kermrc. (Note: "kermrc" must be lowercase.)  
  131.  
  132. If  you  wish  to be able to transfer   files  to/from  disk  (as   
  133. opposed  to,  or in addition to, the Catalog), copy  file  KERMRC 
  134. from  the  system CPL to SUD D02; then change the  file  name  to 
  135. kermrc. (Note: "kermrc" must be lowercase.)  
  136.  
  137. IVS-Kermit or MCS-Kermit is now installed. You are now ready to
  138. transfer   files as explained in the "Transferring Files"    sec-
  139. tion of this  chapter. 
  140.  
  141. 4.       TRANSFERRING FILES  
  142.  
  143. Once  IVS-Kermit or MCS-Kermit  has been installed on the 9800
  144. system  and  the   
  145. hardware  and  software  requirements  have  been  met,  you  can   
  146. transfer files from the PC to/from disk or to/from the   Catalog. 
  147.  
  148. The  procedure  for transferring  files    involves  three  major 
  149. steps:  
  150.  
  151. Initializing MS-Kermit and IVS-Kermit or MCS-Kermit  
  152.  
  153. Performing the File Transfer  
  154.  
  155. Terminating MS-Kermit and IVS-Kermit or MCS-Kermit  
  156.  
  157. The remainder of this chapter explains each of the three steps in   
  158. detail.  Follow  these steps, in the order presented,  to  ensure 
  159.  
  160. that   your  files are successfully transferred to/from   disk or 
  161. to/from the Catalog.  
  162.  
  163. 5.       INITIALIZING MS-KERMIT AND IVS-Kermit or MCS-KERMIT  
  164.  
  165. To   initialize  MS-Kermit and IVS-Kermit or MCS-Kermit,  perform  
  166. the following sequence of actions:  
  167.  
  168. If you are using MS-Kermit version 2.32/A, enter:  
  169.  
  170. msvibm.exe  -f  mskvknit <RETURN>
  171.  
  172. MS-Kermit  will initialize itself, then execute the  commands  in 
  173. the   MSKVKNIT file.  The following screen will be displayed:  
  174.  
  175. IBM-PC Kermit-MS: 2.32/A 21 Jan 1989  
  176. Copyright (C) Trustees of Columbia University 1982, 1989  
  177.  
  178. updated 2-6-90
  179.  
  180. Parity                 := EVEN 
  181.  
  182. Local-echo             := OFF
  183. for FULL DUPLEX line
  184.  
  185. Send timeout           := 2
  186.  
  187. At the Kermit-MS> prompt, enter 
  188.  
  189. stat<RETURN> 
  190.  
  191. to display the   MS-Kermit parameters. Then check the  parameters 
  192. to  make sure that   they are correct for your PC.  Specifically, 
  193. check  the  "Baud rate",   "Parity", "Local  echo"  (full  duplex 
  194. should  be "off"; half duplex   should be "on"), and "Send  time-
  195. out" parameters.  
  196.  
  197. If you need to change a parameter value, at the Kermit-MS> prompt   
  198. enter 
  199. set <parameter name> <new value> <RETURN> 
  200.  
  201. Once  the  MS-Kermit parameters are correct,  at  the  Kermit-MS>   
  202. prompt, enter 
  203.  
  204. connect<RETURN> 
  205.  
  206. The screen will change so   that the cursor is in the upper  left 
  207. corner and the following   banner is at the bottom of the (blank) 
  208. screen:  
  209.  
  210. Esc-chr:^]?help:^]?port:1speed:9600 parity:even echo:loc VT102...  
  211.  
  212.  
  213. Use  SuperVision to start the MCSKJ job using RUNC or RUNJ.   For 
  214.  
  215. example:
  216.  
  217. RUNC,$.NODE.KERMIT.MCSKJ [1]
  218.  
  219. The MCSKJ job will ask for the LPN to be used for the  communica-
  220. tion link and will ask questions about the source/destination for 
  221. the files. That sequence looks like:
  222.  
  223. 0027 1921: ACCEPT DEFAULTS OF LPN=0104,SOURCE/DEST=CAT,NODE=$,VAR
  224. RECS,SEQORG,SIZE=500/BLOCKS?[Y,N]
  225.  
  226.  
  227. > :AN 27,'N'
  228.  
  229. RESPONSE TRANSMITTED
  230. 0030 1921: SPECIFY LPN FOR MCS-KERMIT COMMUNICATION LINK. DEFAULT
  231. LPN IS 0104. 'X' TO STOP ASKING.[NNNN,X]
  232.  
  233.  
  234. > :AN 30,'150'
  235.  
  236. RESPONSE TRANSMITTED
  237. 0033 1921:   SELECT MCS-KERMIT SOURCE/DESTINATION ENVIRONMENT.
  238. DEFAULT
  239.            ENVIRONMENT IS CAT.[CAT,DISK,X]
  240.  
  241.  
  242. > :AN 33,''
  243.  
  244. RESPONSE TRANSMITTED
  245. 0036 1921:   PLEASE ENTER SUBCATALOG NODE NAME. DEFAULT IS THE $
  246. NODE.[NODE
  247.            NAME,X]
  248.  
  249.  
  250. > :AN 36,'$.NODE.KERMIT'
  251.  
  252. RESPONSE TRANSMITTED
  253. 0039 1921: DO YOU WANT DATAFILES TO HAVE FIXED OR VARIABLE LENGTH
  254. RECORDS? DEFAULT IS VARIABLE.[F,V,X]
  255. > :AN 39,''
  256.  
  257. RESPONSE TRANSMITTED
  258. 0042 1921: WILL YOU UPLOAD FONT/FORM FILES? IF YES,ALL DATA FILES
  259. HAVE 'REL'ORGANIZATION;DEFAULT IS SEQ.[Y,N]
  260.  
  261.  
  262. > :AN 42,''
  263.  
  264. RESPONSE TRANSMITTED
  265.  
  266. When  MCS-Kermit is initialized and ready to transfer  files  the 
  267. following messages will be displayed by the job:
  268.  
  269. 0043 1921:34 2054 EXECUTE: MCSKERM 00/000000/0000. 
  270.  
  271. 0044 1921:31 3000 TC PROGRAM INITIALIZED.
  272.  
  273. 0045 1921:5D 1101 OPERATOR INPUT PERMITTED(PBS1921 )  
  274.  
  275. At  this point the PC connection to the 9800 needs to be  shifted 
  276. to  the LPN specified to the MCSKJ job.  If using  MS-Kermit  di-
  277. rectly, do '^]b' and select the MCSKj link ( if the MICOM  switch 
  278. is being used the address syntax is #nn/nnn ).  With SuperVision, 
  279. switch  over to the virtual channel that represents the  LPN  se-
  280. lected for the MCSKJ job.
  281.  
  282. Depending how fast the above switch is done, some of the  follow-
  283. ing sequence may be seen:
  284.  
  285.  
  286.  Kermit-VRX server starting. 
  287. # N3
  288.  
  289. If   you  need  to change a IVS-Kermit  or  MCS-Kermit  parameter 
  290. value,
  291. perform  the following  sequence of actions:  
  292.  
  293. At the # N3 prompt, hold the CONTROL key down while pressing  the 
  294. ']' (right bracket) key followed by the letter 'c' key.  
  295.  
  296. The Kermit-MS> prompt will be displayed. 
  297.  
  298. Enter 'finish<RETURN>'
  299.  
  300. The Kermit-MS> prompt will be redisplayed. 
  301.  
  302. Enter 'connect<RETURN>' 
  303.  
  304. The IVS-Kermit or MCS-Kermit prompt ('IVS-Kermit or MCS-Kermit>'
  305. will be displayed. 
  306.  
  307. Press the 'RETURN' key, then   enter 'set <parameter name>  
  308. <new value> <RETURN>'. 
  309.  
  310. Repeat   this step for each parameter that needs to be changed.  
  311.  
  312. At the IVS-Kermit or MCS-Kermit prompt, enter 'server <RETURN>'.  
  313.  
  314. Several informational messages will be displayed followed by  
  315. the #N3 prompt.  
  316.  
  317. The  # N3 prompt (towards the bottom of the screen) is  known  as   
  318. the  "server  mode" prompt, and indicates that files can  now  be   
  319. transferred.  The  cursor is displayed under the  "#"  character.   
  320. Refer to the "Performing the File Transfer" section for    infor-
  321. mation about how to transfer files.  
  322.  
  323. Doing the SHOW, SHOW VERSION, ?, and QUIT commands results in the
  324. following:
  325.  
  326. MCS-Kermit>
  327. SHO
  328.  
  329. MCS-Kermit, 4E(072) 06 June 90,  NCR VRX/VE
  330. Communications Parameters:
  331.   Bits: 7, Parity: even, Duplex: full, Flow: xon/xoff  Bits: 7,
  332. Handshake: none
  333.  
  334. Protocol & Transfer Parameters:     Send      Receive    (* =
  335. override)
  336.   Timeout:                            4          30*
  337.   Padding:                            0           0
  338.   Pad Character:                     31           0
  339.   Packet Start:                       1           1
  340.   Packet End:                        13          10
  341.   Packet Length:                   1000*       1000 (94)
  342.   Block Check Type:     1
  343.  
  344. File Parameters:
  345.   File Names:     converted      Debugging Log:    none
  346.   File Type:      text           Packet Log:       none
  347.   File Byte Size: 7              Transaction Log:  none
  348.   Incomplete File Disposition: discard,  Init file: kermrc
  349.  
  350. MCS-Kermit>
  351. SHO VER
  352.  
  353. Versions:
  354.  MCS-Kermit, 4E(072) 06 June 90
  355.  MCS-Kermit Protocol Module 4E(032), 31 May 90
  356.  V-Kermit functions, 4E(054) 29 May 90
  357.  VRX/E cmd package V2(023), 06 June 90
  358.  User Interface 4E(060), 06 June 90
  359.  NCR-VRX tty I/O, 4E, 01 June 90 for NCR VRX/VE
  360.  VRX/VE file support, 4E(038) 30 May 90 for NCR VRX/VE
  361. MCS-Kermit>
  362. ? Command, one of the following:
  363.  close              echo               exit               help
  364.  log                quit               server             set
  365.  show               statistics         take               
  366. Again>
  367. Q
  368.  
  369. 5.2  INSTALLING AND STARTING IVS-Kermit.
  370.  
  371. Move the initialization file 'kermrc' to SUD=D02 and the catalog
  372. node you wish to transfer files from/to.
  373.  
  374. In  an IVS session execute the Procedure file IVSKPM. Answer  the 
  375. questions concerning source/destination and the structure of data 
  376. files. This question sequence may look something like:
  377.  
  378. > IVSKPM;
  379.   BEGINNING IVSKPM FOR IVS-KERMIT FILE TRANSFERS.
  380.     FOR GENERIC FILE USE.
  381.     UPDATED ON 6-20-90.
  382.  
  383.   IVS-KERMIT 2.01 NOW HANDLES:
  384.     1000 BYTE PACKETS.
  385.  
  386.   MOVE kermrc TO YOUR
  387.     SOURCE/DESTINATION CATALOG NODE
  388.     AND SUD=D02
  389.     BEFORE CONTINUING.
  390.  
  391.   REFER TO THE V-KERMIT FS FOR MS-DOS FILE NAME EXTENSIONS
  392.     USED FOR VRX FILES.
  393.  
  394.     EXAMPLES ARE: FN.N3(JOB),FN.PRO(SCL PROC),FN.C(C),
  395.       FN.CO(COBOL),FN.NCR(NCRL),FN.NC(NEAT/C),
  396.       FN.BIN(BINARY DATA FILE).
  397.     OBJECT FILES(USE FN.OBJ).
  398.  
  399.   WARNINGS:
  400.     IF YOUR IVS SESSION USES A DSP COMM PORT,
  401.     MAX PACKET SIZE IS 222.
  402.  
  403.  
  404.  
  405.   PLEASE WAIT.
  406.   PLEASE WAIT.
  407.  
  408.  
  409.   PLEASE SELECT THE IVS-KERMIT ENVIRONMENT.
  410.  
  411.     THE IVS-KERMIT ENVIRONMENT DEFAULTS ARE:
  412.  
  413.       DATA FILES WITH:
  414.       - SEQUENTIAL ORGANIZATION.
  415.         (THERE IS A CHOICE FOR RELATIVE(FONT/FORM) 
  416.          FILE STRUCTURE.)
  417.       - FILESIZE OF 500/BLOCKS  
  418.       - VARIABLE LENGTH RECORDS 
  419.   
  420.       FILE SOURCE/DESTINATION OF:
  421.       - USER CURRENT NODE IN CATALOG.
  422.  
  423.     DO YOU WANT TO ACCEPT THESE DEFAULTS? [Y,N]
  424.       DEFAULT IS YES.
  425. Enter value for DEFAULTS                       
  426.   WILL YOU UPLOAD PRINTER FONT/FORM FILES? [Y,N]
  427.     IF YES, ALL DATA FILES WILL HAVE
  428.       THE RELATIVE ORGANIZATION.
  429.     DEFAULT IS NO.
  430. Enter value for ORG_CHOICE                     
  431.   DO YOU WANT DATAFILES TO HAVE FIXED OR
  432.     VARIABLE LENGTH RECORDS? [F,V]
  433.  
  434.     DEFAULT IS VARIABLE.
  435. Enter value for REC_TYPE                       
  436.   SELECT IVS-KERMIT SOURCE/DESTINATION ENVIRONMENT. 
  437.     DEFAULT ENVIRONMENT IS CATALOG. [CAT,DISK]
  438. Enter value for ENV                            
  439. D 
  440.   IVS-KERMIT USING NON-CATALOG ENVIRONMENT.
  441.  
  442. PERIPHERALS FOR JOB# 3842
  443.  
  444.     NAME     TYPE  VSN    VOLID    STATUS  SHARE CPL  LPN  SUD
  445.  
  446. 683 READER    0A                   UP       NO   NO   FD00 P11     
  447. VIRTUAL VOL   BA  525252           UP       YES  NO   0122 D01     
  448. VIRTUAL VOL   BA  600001           UP       YES  NO   0141 D02     
  449. VIRTUAL VOL   BA  500288           UP       YES  NO   013E D05     
  450. VIRTUAL VOL   BA  500289           UP       YES  NO   013F D06     
  451.  
  452. SYSTEM CPLS
  453.  
  454. VIRTUAL VOL   BA  980042  CPL-1    UP       YES  YES  012E D90     
  455. VIRTUAL VOL   BA  570590  CPL-2    UP       YES  YES  0139 D91     
  456. VIRTUAL VOL   BA  980041  CPL-3    UP       YES  YES  013A D92     
  457.   PLEASE ENTER(IN QUOTES) VOLUME NUMBER AND DEVICE TYPE.
  458.     FOR EXAMPLE ('525252/BA')
  459.     OR [CONTINUE] TO USE CURRENT D02.
  460. Enter value for VSN                            
  461. C
  462.   IVS-KERMIT USING CURRENT D02.
  463.  
  464.   ENSURE THAT ENOUGH SPACE EXISTS ON D02
  465.     FOR THE LARGEST UPLOADED FILE.
  466.   ENSURE THAT THE D02 DATAFILE FILESIZE PARAMETER
  467.     IS BIG ENOUGH TO HOLD THE LARGEST FILE.
  468.  
  469.   SPECIFY FILESIZE VALUE FOR D02 DATAFILE REFERENCE
  470.     USED BY DATA FILES.
  471.     DEFAULT FILESIZE IS 500/BLOCKS.
  472. Enter value for FILESIZ                        
  473. 33
  474. TERMINAL DEFINITIONS SUCCESSFULLY INSTALLED
  475.  
  476.   EXECUTING LOAD MODULE WERMIT.
  477.             UPDATED 6-20-90.                                        
  478.            
  479.                
  480.           Parity           := EVEN                                  
  481.            
  482.              
  483.           Duplex           := FULL                                  
  484.            
  485.              
  486.           File type        := TEXT                                  
  487.            
  488. Extended-length packets requested
  489. Extended-length packets requested
  490.  
  491. IVS-Kermit, 4E(072) 06 June 90,  NCR VRX/VE
  492. Communications Parameters:
  493.   Bits: 7, Parity: even, Duplex: full, Flow: xon/xoff, Handshake:
  494. none
  495.  
  496. Protocol & Transfer Parameters:     Send      Receive    (* =
  497. override)
  498.   Timeout:                            4          30*
  499.   Padding:                            0           0
  500.   Pad Character:                     31           0
  501.   Packet Start:                       1           1
  502.   Packet End:                        13          10
  503.   Packet Length:                   1000*       1000 (94)
  504.   Block Check Type:     1
  505.   8th-Bit Prefix:      '&'
  506.  
  507. File Parameters:
  508.   File Names:     converted      Debugging Log:    none
  509.   File Type:      text           Packet Log:       none
  510.   File Byte Size: 7              Transaction Log:  none
  511.   Incomplete File Disposition: discard,  Init file: kermrc
  512.  
  513.  
  514. When  IVS-Kermit is initialized and ready to transfer  files  the 
  515. following messages will be displayed by the job:
  516.  
  517.  
  518.  Kermit-VRX server starting. 
  519. IVS-Kermit, 4E(072) 06 June 90
  520. Type ? for help
  521.  
  522. Doing the SHOW, SHOW VERSION, ?, and QUIT commands results in the
  523. following:
  524.  
  525. IVS-Kermit>
  526.  
  527. IVS-Kermit>SHO VER
  528. SHO VER
  529.  
  530. Versions:
  531.  IVS-Kermit, 4E(072) 06 June 90
  532.  IVS-Kermit Protocol Module 4E(032), 31 May 90
  533.  V-Kermit functions, 4E(054) 29 May 90
  534.  VRX/E cmd package V2(023), 06 June 90
  535.  User Interface 4E(060), 06 June 90
  536.  NCR-VRX tty I/O, 4E, 01 June 90 for NCR VRX/VE
  537.  VRX/VE file support, 4E(038) 30 May 90 for NCR VRX/VE
  538. IVS-Kermit>
  539. IVS-Kermit>?
  540. ? Command, one of the following:
  541.  close              echo               exit               help
  542.  log                quit               server             set
  543.  show               statistics         take
  544. Again>Q
  545. Q
  546.   IVS-KERMIT TERMINATED.
  547.   PRINTING IVS-KERMIT TRANSFER HISTORY LOG(STDERR).
  548.   PLEASE WAIT.
  549.  
  550.   END OF PRINTING STDERR.
  551. Home catalog name is $.PBS 
  552.   END OF IVSKP.
  553.  
  554.  
  555. 6. PERFORMING THE FILE TRANSFERS   
  556.  
  557. Once  MS-Kermit and IVS-Kermit or MCS-Kermit are initialized you 
  558. can  transfer 
  559. files by performing the following   sequence of actions:  
  560.  
  561. When  the server prompt (# N3) is displayed, hold  the  'CONTROL' 
  562. key   while pressing the ']' (right bracket) key.  The banner  of 
  563. text at the bottom of the screen will disappear, and   the cursor 
  564. will be displayed at the bottom of the screen.  
  565.  
  566. At the cursor, enter the letter 'c' (for "connect").  
  567.  
  568. The Kermit-MS> prompt will be displayed.  
  569.  
  570. At  the Kermit-MS> prompt, enter 'send/get' followed by the  name 
  571. of  the file you wish to transfer to/from the PC and to/from  the 
  572. 9800 system.  The PC file name may have its path fully  qualified 
  573. and  it may have a MS-DOS extension. 
  574.  
  575. The  file transfer will begin, and the following screen  will  be 
  576. displayed  with  information  appropriate  for  the  file   being   
  577. transferred.  
  578.  
  579. Kermit-MS: 2.32/A  21 Jan 1989
  580.  
  581. File name: RJECOMM.NC       
  582. KBytes transferred: 317      
  583. Percent transferred: 63 
  584.  
  585. Sending/Receiving: In progress 
  586.  
  587. Number of packets: 1777            
  588. Packet length: 94        
  589. Number of retries: 97               
  590. Last error:              
  591. Last message: SRCFILE(NAME=RJECOMM)
  592.  
  593. When  the  "Sending" ( or 'Receiving' ) value in this  screen  is 
  594. "Completed",  the file   transfer has completed. If you  wish  to 
  595. transfer another file to/from   the same location, enter  another 
  596. 's' or 'get' command and another   file name. 
  597.  
  598. Once  you are finished transferring the desired file(s), you  can 
  599. terminate MS-Kermit and IVS-Kermit or MCS-Kermit as explained  in 
  600. the "Terminating MS-Kermit and IVS-Kermit or MCS-Kermit"  section 
  601. of this chapter.  
  602.  
  603. 6.1.     Considering VE File Structures
  604.  
  605. When  uploading files some consideration should be given  to  the 
  606. details  to the file structure that will be created  on  the   VE 
  607. side.   And on download, the ability of IVS-Kermit or  MCS-Kermit 
  608. to 'find'  the file is based on the descriptors used.
  609.  
  610. Files  on  the  PC are only of 3 types: 'Ascii' text  files  (  a 
  611. stream  of  'Ascii' characters including CR and  LF  ),  'binary' 
  612. files( a stream of all 256 possible characters ), and the special 
  613. case  of VE 'OBJECT' files that were created on a  download  from 
  614. V-Kermit.
  615.  
  616. Files on the VE side are varied and complex and 'record'  orient-
  617. ed.   V-Kermit must convert between the simple MS-DOS format  and 
  618. the complex VE format using the setup parameters and instructions 
  619. given by the operator.
  620.  
  621. Beyond  this,  is the added complexity that  the  VRX-C  compiler 
  622. produces code that allows for the creation of only 2 types of  VE 
  623. files: 
  624.  
  625. One creates records based upon examining each uploaded  character 
  626. for the LF ( 0A ), which is stripped and not written to disk.
  627.  
  628. The other creates variable length records that are just a  stream 
  629. of the characters received.
  630.  
  631. 'set  file type text/binary' has nothing to do with the  creation 
  632. of  either  of the above 2 file types.  This  is  an  unfortunate 
  633. misnomer.  The feature should be called 'set end-of-line  conver-
  634. sion  on/off'.  All 'set file type' does is add LFs  on  download 
  635. and  strip them on uploads.  The means by which V-Kermit  selects 
  636. one  of  the 2 above file types is by the  file  name  extension.  
  637. fn.OBJ, fn.BIN, and fn.Bnn cause the second type to be used;  all 
  638. other extensions cause the first type to be used.  It really does 
  639.  
  640. not  matter whether the file contains 'binary' or  'Ascii'  data.  
  641. Both types can be written to both of the above file types.
  642.  
  643. 6.1.1.   V-Kermit File Structure Parameters
  644.  
  645. Consider the following parameters and their effects when deciding 
  646. how to transfer a file:
  647.  
  648. File name extension.
  649.  
  650. 'Set file type text/binary'
  651.  
  652. Existence of and location of CR and LF characters in the PC file.
  653.  
  654. FCL override parameters in the MCSKJ job.  
  655.  
  656. RECORDSIZE
  657.  
  658. FILESIZE
  659.  
  660. DATESCHEME
  661.  
  662. RMS
  663.  
  664. CATALOG
  665.  
  666. NOCAMHEADER
  667.  
  668. How  'whitespace' is treated on the PC, by V-Kermit, and by  FMS.  
  669. For example: the 'TAB' ( 09 ) character may be defined at various 
  670. lengths by a PC wordprocessor but FMS always substitutes 8 spaces 
  671. before writing to disk (if the file name extension specifies  the 
  672. 'text' file structure described above ).
  673.  
  674. 6.2.    V-Kermit File Naming Conventions and Conversions
  675.  
  676. The 3 character MS-DOS extension is the method used by IVS-Kermit 
  677. or MCS-Kermit to  know  what type of VE file to open.  Care  must  
  678. be   taken  to select  the  correct extension to match  the   de-
  679. sired   file.    MS-Kermit 's' and 'get' commands allow  for  al-
  680. iases.  So the name  on the PC does not need to match the VE file 
  681. name and extension.  As 
  682. examples:
  683.  
  684. Kermit-MS>s fn fn.N3
  685.  
  686. will create a source file on the VE side.
  687.  
  688. Kermit-MS>get
  689. Remote Source File: fn.PRO
  690. Local Destination File: fn
  691.  
  692. will look for a SCL Procedure file on the VE side and download it 
  693. creating fn on the PC.
  694.  
  695. 6.2.1.    Wildcards in File Names
  696.  
  697. The  'wildcard'  characters '?' and '*' can only be used  by  MS-
  698. Kermit  on  uploads to IVS-Kermit or MCS-Kermit.  See the section 
  699. on  multiple 
  700. file  transfers for the result when a wildcard matches more  than 
  701. one file
  702.  
  703. 6.2.2.    V-Kermit Reserved Name Extensions
  704.  
  705. The  extensions  must be checked against the  following  list  to 
  706. insure  that they do not accidentally coincide with one  that  V-
  707. Kermit considers 'reserved';.
  708.  
  709. File types are encoded as follows:
  710.  
  711. Set
  712. VRX/E           File
  713. Default         Type            NAME
  714. Record                                             
  715. BIN/            on
  716. VRX/E File Type                         Size    Name    TEXT        
  717.    PC      
  718.  
  719. C           source                      1-82    FN_C    TEXT        
  720.    fn.c
  721. VRX/E COBOL source(no ID)               1-83    FN      TEXT        
  722.    fn.CO
  723. VRX/E COBOL source(6 char ID)           1-83    FN      TEXT        
  724.    fn.CO6
  725. VRX/E COBOL source(8 char ID)           1-83    FN      TEXT        
  726.    fn.CO8
  727. NCRL      source                        1-82    FN      TEXT        
  728.    fn.NCR          
  729. NEAT/VE           source                1-82    FN      TEXT        
  730.    fn.NVS
  731. NEAT/VS           source                1-82    FN      TEXT        
  732.    fn.NVS          
  733. NEAT/C    source                        1-83    FN      TEXT        
  734.    fn.NC
  735. NEAT/3    source                        1-82    FN      TEXT        
  736.    fn.N3
  737. VRX/E BASIC source                      1-82            FN          
  738.    TEXT            fn.BAS
  739. FORTRAN/V   source                      1-82            FN          
  740.    TEXT            fn.FV
  741. VRX/E CATJOB source                     1-82            FN          
  742.    TEXT            fn.N3
  743. Control string                          1-82            FN          
  744.    TEXT            fn.CS
  745. SCL procedure w/num                     1-82            FN          
  746.    TEXT            fn.PRN
  747. SCL procedure w/o num                   1-82            FN          
  748.    TEXT            fn.PRO
  749. Data    (variable length records)      1-160            FN or 
  750. TEXT            fn.DAT or 
  751. (text(ASCII) data)                                                  
  752.                    fn        or                    (CRs and CRLFs
  753. manipulated                      FN_XYZ                  fn.xyz
  754. (by V-Kermit)           
  755.  
  756. Data    (variable length records)      1-160            FN/BIN      
  757.    fn.DAT 
  758.  
  759. (text(ASCII) data)                                                  
  760.                    fn        or                    (CRs and CRLFs
  761. unaltered                                FN_XYZ                 
  762. fn.xyz(by V-Kermit)           
  763.  
  764. Data    (fixed length records)          1-nn            FN          
  765.    TEXT            fn.Dnn
  766. (text(ASCII) data)                                                  
  767.                    
  768. (CRs and CRLFs manipulated                      
  769. by V-Kermit)           
  770. Data    (fixed length records)          1-nn            FN          
  771.    BIN             fn.Dnn
  772. (text(ASCII) data)                                      
  773. (CRs and CRLFs unaltered  
  774. by V-Kermit)           
  775.  
  776. Data    (binary data)                   1-485           FN          
  777.    BIN             fn.BIN
  778. (variable length records)
  779. Data    (binary data)                   1-nn            FN          
  780.    BIN             fn.Bnn
  781. (fixed length records)
  782. Object                                  1-490           FN          
  783.    BIN             fn.OBJ
  784.  
  785. The suffixes may be lower case.
  786.  
  787. 6.3.   Considering White Space
  788.  
  789. Files  that are created on the PC and then uploaded  to  V-Kermit 
  790. need to consider 'white space' and record length.  'TAB's may  be 
  791. defined  differently  on the PC wordprocessor than by  the  VRX-C 
  792. compiler, which generates the code that converts 'TAB's to spaces 
  793. before  writing  to  the VE disk.  This conversion  is  always  8 
  794. spaces for each 'TAB'.
  795.  
  796.  
  797. 6.4.    Check-off List to Consider Before Transferring Files
  798.  
  799. V-Kermit Parameters
  800.  
  801. 6.4.1. Communications Parameters
  802. MS-Kermit has 'set parity'.
  803.  
  804. MS-Kermit  has  'set loc on/off' consistent with  duplex  of  the 
  805. link.   If  'set loc on' for full duplex  links,  MS-Kermit  will 
  806. display 'failed' for file transfer attempts.
  807.  
  808. MS-Kermit  has 'set sen pause'.  Excessive retries and very  slow 
  809. performance will occur if this value is not large enough to allow 
  810. the  other  side to prepare itself for input after  it  has  sent 
  811. something  to MS-Kermit.  In the case of SuperVision and the  DSP 
  812. f/w  comm port, this value should be at lease 5 ms.   In  heavily 
  813. loaded systems this may need to be increased.  Of course, setting 
  814. it unnecessarily high will degrade performance.  This needs to be 
  815. set separately for each host system.
  816.  
  817. MS-Kermit has 'set speed'.
  818.  
  819. MS-Kermit has 'set block-check-type'.
  820.  
  821. V-Kermit has 'set parity'.
  822.  
  823. V-Kermit has 'set duplex'.
  824.  
  825. V-Kermit has 'set block-check'.
  826.  
  827. 6.4.2.    Characteristics of the file to be 
  828. transferred:
  829.  
  830. VE load/object file?
  831. Name = fn.OBJ
  832.  
  833. 'set fil typ bin'
  834.  
  835. VE source file?
  836. Name  selected  by type(fn.c fn.CO fn.CO6  fn.CO8  fn.NCR  fn.NVS 
  837. fn.NC fn.N3 fn.BAS fn.FV).
  838.  
  839. Not > 81 chars between CRLFs on PC.
  840.  
  841. 'set fil typ tex'
  842.  
  843. VE control string or SCL Procedure file?
  844. Name selected from:fn.CS fn.PRN fn.PRO.
  845.  
  846. Not > 80 chars between CRLFs on PC.
  847.  
  848. 'set fil typ tex'
  849.  
  850. Data file with no record structure?
  851. Name = fn.BIN
  852.  
  853. 'set fil typ BIN'
  854.  
  855. Data file with variable length records on VE side?
  856. Name = fn.DAT or fn or fn.xxx
  857.  
  858. 'set file type tex/bin'
  859.  
  860. FCL for REF=DATAFILE has variable RECORDSIZE.
  861.  
  862. Data file with fixed length records on VE side?
  863. Name = fn.DAT or fn or fn.xxx
  864.  
  865. 'set file type tex/bin'
  866.  
  867. FCL for REF=DATAFILE has fixed RECORDSIZE.
  868.  
  869. 6.4.3. Source/destination on VE side?
  870.  
  871.  
  872. Size of file on upload
  873.  
  874. FCL FILESIZE correct if not RMS.
  875.  
  876.  
  877. DATESCHEME for control strings and SCL Procedure files.
  878.  
  879. FCL with AGE needed if version 00 already exists on disk.
  880.  
  881. Is the file going to/coming from a catalog node or disk?
  882. Once V-Kermit starts all files must go to/come from the specified 
  883. catalog  node or disk.  V-Kermit must be ended and  restarted  to 
  884. change this.
  885.  
  886. 6.4.4. Special V-Kermit Text Manipulation Required?
  887. set send/receive add-linenum on/off(restricted for this release)
  888.  
  889. set send/receive id-fields discard/keep.
  890.  
  891. set send/receive line-numbers discard/keep.
  892.  
  893. set send/receive renumber on/off.
  894.  
  895.  
  896. 6.4.5. Special White Space considerations?
  897. Does the PC file have 'TAB' characters that are not to  represent 
  898. 8 spaces?  There is no parameter to control this.
  899.  
  900. 6.5.   Transferring Multiple Files with One Command
  901.  
  902. There  are  two ways to upload more than one file with  a  single 
  903. command.   One is to use wildcards that match more than one  file 
  904. on an upload.  The other is to use 'take' files that specify more 
  905. than  one 'send' command.  Entire subdirectories may be  uploaded 
  906. by the '*.*' syntax.
  907.  
  908. 'Take' files can also be used to download files by using multiple 
  909. instances of the 'get' command.
  910.  
  911. 6.6.   Examples of File Transfers
  912.  
  913. 6.6.1. Job Files
  914.  
  915. The  most common use of V-Kermit is to download a job file,  edit 
  916. it  on the PC, upload it, and execute it.  Care must be taken  on 
  917. the  PC not to have records ( delimited by CR ) > 82  characters.  
  918. The fn.N3 extension is used in this case.
  919.  
  920. 6.6.2. UPDATE patches and EBFs
  921.  
  922. Download  of  UPDATE patch files or EBFs from the VE  system  re-
  923. quires  some care to preserve the precise structure that  the  VE 
  924. 'boot' code needs.  Use FCL parameters like:REF=DATAFILE, RECORD-
  925. SIZE=80.   And  insure  IVS-Kermit or MCS-Kermit has 'set fil typ 
  926. tex'.    Any modifications  to  the file on the PC must  preserve 
  927. the  80  byte record structure and the upload must use the  above 
  928. parameters.
  929.  
  930. 6.7.   Checking for Proper File Transfer Performance
  931.  
  932. During the transfer notice the 'number of retries' that MS-Kermit 
  933. is updating.  There should be few.  If the number is more that  1 
  934. per Kbyte of data transferred, there is probably something  wrong 
  935. with the setup or the system.
  936.  
  937. Use  the MS-Kermit 'show statistics command at the end to a  file 
  938. transfer  or the end of a file transfer session to get a  feeling 
  939. for  the  number  of NAKs that were  exchanged  and  the  overall 
  940. throughput.
  941.  
  942. 6.7.1.    Kermit Timeouts
  943.  
  944. There are four timeout parameters in the V-Kermit environment:
  945.  
  946. 6.7.1.1.    MS-Kermit Timeouts
  947.  
  948. 6.7.1.1.1.    Send Timeout
  949.  
  950. MS-Kermit 'set sen tim' is valid on uploads and downloads.  It is 
  951. not affected by the 'send init' exchange.  It should be set to as 
  952. low  a value as possible without causing significantly  increased 
  953. number of retries.  It defaults to 8.  The distributed  initiali-
  954. zation  file  MSKVKNIT sets it to 2.  A value of 1 is  likely  to 
  955. cause  excessive retries by MS-Kermit.  If there are more than  1 
  956. retry per 1K bytes of data, increase this value.
  957.  
  958. 6.7.1.1.2.    Receive Timeout
  959.  
  960. MS-Kermit  'set rec tim' is in effect on uploads  and  downloads.  
  961. It  should be set to as low a value as possible  without  causing 
  962. significantly  increased number of retries.  It defaults  to  13.  
  963. The  distributed  initialization file MSKVKNIT sets it to  2.   A 
  964. value of 1 is likely to cause excessive retries by MS-Kermit.  If 
  965. there  are more than 1 retry per 1K bytes of data, increase  this 
  966. value.
  967.  
  968. It  is temporarily overridden by the 'send init' exchange to  the 
  969. V-Kermit 'set sen tim' value on downloads.
  970.  
  971. 6.7.1.2.    V-Kermit Timeouts
  972.  
  973. 6.7.1.2.1.    Send Timeout
  974.  
  975. V-Kermit does not time the results of its sends; it relies on the 
  976. 'set  rec tim' of MS-Kermit to do that.  It forces  MS-Kermit  to 
  977. temporarily  change  its 'set rec tim' value in the  'send  init' 
  978. exchange.         
  979.  
  980. It  should be set to as low a value as possible  without  causing 
  981. significantly  increased number of retries.  It defaults  to  10.  
  982. The  distributed initialization file KERMRC_XXX sets it to 2.   A 
  983. value of 1 is likely to cause excessive retries by MS-Kermit.  If 
  984. there  are more than 1 retry per 1K bytes of data, increase  this 
  985. value.
  986.  
  987. 6.7.1.2.2.    Receive Timeout
  988.  
  989. This  value is always overridden to 30 making it (in effect)  not 
  990. used.
  991.  
  992. 7.     TERMINATING MS-KERMIT AND IVS-Kermit or MCS-KERMIT  
  993.  
  994. Once  you  have  successfully  transferred  the  desired  file(s) 
  995. to/from  the 9800 system, you can terminate MS-Kermit   and  IVS-
  996. Kermit  or  MCS-Kermit by performing the  following  sequence  of 
  997. actions:  
  998.  
  999. At  the  Kermit-MS> prompt, enter 'finish<RETURN>'  to  terminate   
  1000. IVS-Kermit or MCS-Kermit's "server" mode.   
  1001.  
  1002. The Kermit-MS> prompt will be next. 
  1003.  
  1004. Enter 'connect<RETURN>' to return control from MS-Kermit back  to 
  1005. the terminal emulator   mode.   
  1006.  
  1007. The IVS-Kermit or MCS-Kermit> prompt will be displayed next. 
  1008.  
  1009. Enter 'quit<RETURN>' to terminate IVS-Kermit or MCS-Kermit.  
  1010.  
  1011. At this point, MS-Kermit can be used for other work as a terminal 
  1012. emulator.  If you wish to terminate MS-Kermit, hold the 'CONTROL' 
  1013. key  down while pressing the ']' (right bracket) key followed  by 
  1014. the 'c' key. Then, when the Kermit-MS> prompt is displayed, enter 
  1015. 'quit<RETURN>' to terminate MS-Kermit.  
  1016.  
  1017. 8.     IVS-Kermit or MCS-Kermit Error Messages
  1018.  
  1019. Text  enclosed by parentheses is replaced  by  program-determined 
  1020. data. The numbers assigned are the universal Kermit numbers  with 
  1021.  
  1022. the  omissions being related to functions not implemented  by  V-
  1023. Kermit.
  1024.  
  1025. 2.   File not found 
  1026. 3.   No readable file to send 
  1027. 4.   NONAME (for a file) 
  1028. 5.   Can't open file 
  1029. 6.   User canceled transaction 
  1030. 7.   Unimplemented server function 
  1031. 15.  Unimplemented generic server function 
  1032. 16.  Can't close file 
  1033. 17.  Can't execute command 
  1034. 18.  Unknown packet type 
  1035. 23.  Write permission denied - (file name) 
  1036. 26.  Read permission denied - (file name) 
  1037. 27.  File not readable - (file name) 
  1038. 28.  File not found - (file name) 
  1039. 29.  Please complete this field  -  (data field shown) 
  1040. 31.  Ambiguous - (ambiguous Kermit command) 
  1041. 32.  Invalid - (invalid Kermit command) 
  1042. 34.  Buffer full 
  1043. 36.  Your escape character is not ASCII - (number), escape 
  1044. 45.  (Failure reason) failure while handling failure 
  1045. 48.  Failed (component) 
  1046. 52.  Disconnected 
  1047. 73.  Use 'set send' or 'set receive' instead 
  1048. 74.  ?Unexpected file parameter 
  1049. 79.  Sorry, 94 is the maximum 
  1050. 80.  Not in ASCII control range - (number) 
  1051. 82.  ?File specification required 
  1052. 83.  ?Invalid format for debug() - (debug entry) 
  1053. 84.  ?Invalid format for tlog() - (transaction log entry) 
  1054. 97.  Missing parity 
  1055. 98.  Command too long for internal buffer 
  1056. 100. Kermit command error:  take file terminated. 
  1057. 102. ?You must tell which log 
  1058. 103. ?Debugging log wasn't open 
  1059. 104. ?Packet log wasn't open 
  1060. 106. ?Transaction log wasn't open 
  1061. 107. ?Unexpected log designator - (log file name) 
  1062. 109. You must specify what is to be logged 
  1063. 111. ?A file specification is required 
  1064. 112. ?You must specify a parameter to set 
  1065. 113. ?Take files nested too deeply 
  1066. 114. ?Wildcards not allowed in command file name 
  1067. 116. Sorry, debug log not available 
  1068. 117. Sorry, transaction log not available 
  1069. 120. Bad input format 
  1070. 123. Can't open (file name) 
  1071. 124. Unreadable input file 
  1072. 125. Can't write to (file name) 
  1073. 126. Bad output file 
  1074.  
  1075. 8.1.   IVS-Kermit or MCS-Kermit VE File Error Messages
  1076.  
  1077. In   addition  to  these Kermit error  messages,   IVS-Kermit  or 
  1078. MCS-Kermit   will report messages specific to VE  file  problems.  
  1079. These  will be sent in an error message packet to  MS-Kermit  for 
  1080. display  to the operator.  They will also be written to the  file 
  1081. STDERR.
  1082.  
  1083.  
  1084. OBJECT FILE VLI EXCEEDS MAX
  1085. reading line > 80 char
  1086. reading line > 82 char
  1087. zsoutl: Maximum record length error (line truncated)
  1088. ?Unable to receive data
  1089.  
  1090. 9.     MS-Kermit Error Messages
  1091.  
  1092. MS-Kermit  will generally only display errors that IVS-Kermit  or 
  1093. MCS-Kermit  has detected.  Some of the errors that MS-Kermit will 
  1094. detect are:
  1095.  
  1096. Warning - Non Ascii Char
  1097. ?No response from host
  1098. ?Unable to find file
  1099. ?Unable to receive initiate-packet
  1100. ?Word "ddd" is not usable here
  1101. ?Word "s" is ambiguous
  1102.  
  1103.  
  1104. APPENDIX A  CONTENTS OF KERMRC FILE  
  1105.  
  1106. SET FILE TYPE text
  1107. SET PARITY EVEN   
  1108. SET DUPLEX HALF   
  1109. SET SEND TIMEOUT 10    
  1110. SET RECEIVE TIMEOUT 30    
  1111. SET DELAY 0    
  1112. SET SEN PAC 94   
  1113. SET REC PAC 94    
  1114. SERVER  
  1115.  
  1116. APPENDIX B  Caveats
  1117.  
  1118. This section contains warnings that emphasize points made in  the 
  1119. Functional  Specification  and  temporary  restrictions  for  the 
  1120. current release.
  1121.  
  1122. 4.     Remember that the last line of an 'Ascii' file upload  may 
  1123. not  be written to the VE destination if the 'CRLF' ( 0D0A  )  is 
  1124. not at the end of the PC file.
  1125.  
  1126. 24.    The MS-Kermit '^E' feature to cancel an upload in progress 
  1127. will  result  in  a file fragment on the VE side.   This  is  the 
  1128. Kermit designed intent for this feature.  Consider using the  MS-
  1129. Kermit '^X' instead.
  1130.  
  1131. 36.    V-Kermit expects that 'source' and 'control string'  files 
  1132. uploaded  will  not have records ( delimited by CR ) > 82  or  83 
  1133. characters  depending on the extension.  Refer to 6.2.2  for  the 
  1134. exact cases.  An error message will be sent to MS-Kermit and  the 
  1135. file transfer will be stopped if these lengths are exceeded.
  1136.  
  1137. 31.     If uploading a corrupted MS-DOS file ( for  example,  one 
  1138. that  the  directory size and the end-of-file  indicator  do  not 
  1139. match ), MS-Kermit 2.32/A may detect this error and send a packet 
  1140. to  IVS-Kermit or MCS-Kermit  that  will result in  the 'unimple-
  1141. mented   server  function' being returned by IVS-Kermit  or  MCS-
  1142. Kermit.
  1143.  
  1144. 42.     There  may  be needed information on the 'P'  card  of  a 
  1145. NEAT/VE  or NEAT/VS file that will be 'removed' by IVS-Kermit or
  1146. MCS-Kermit  on downloads.
  1147.  
  1148. 43.    fn.Dnn and fn.Bnn only accept fn of < 8 chars.
  1149.  
  1150. 50.     fn.Dnn  and fn.Bnn display at PC 'rec size=n' if fn  =  7 
  1151. chars.   This is a cosmetic problem only; the actual record  size 
  1152. is correct.
  1153.  
  1154. 52.    The 'ADD-LINENUM' feature is removed.
  1155.  
  1156. 59.     Upload  of fn.Dnn and fn.Bnn do not create  fixed  length 
  1157. files.   The interaction of FCL overrides at file open  time  and 
  1158. the  FCL in     the job needs to be examined    in  more  detail.  
  1159. This  may  end    up as a permanent restriction.  Use  the  work-
  1160. around of job FCL in the interim.
  1161.  
  1162. MCS-Kermit / IVS-Kermit "SALES BROCHURE"
  1163.  
  1164. ADVANTAGES OF V-Kermit OVER OTHER FILE TRANSPORT SYSTEMS
  1165.  
  1166. 1.     Excellent data integrity: 
  1167.  
  1168. best reputation of all TTY file transfer protocols; Kermit is not 
  1169. known to have any data integrity problems; Kermit can be trusted.
  1170.  
  1171. Reliable even on poor quality telephone links.
  1172.  
  1173. 2.     Industry standard:
  1174.  
  1175. many users know of Kermit; they do not need to be trained; it is 
  1176. available  on  most  Pc.  When a file needs  to  be  transported, 
  1177. Kermit 
  1178. will always be one of the choices.
  1179.  
  1180. 3.     Supportability: 
  1181.  
  1182. Columbia  University  supports it with a  technical  phone  line. 
  1183. Updates  are easy to get.  The source code is available for  cus-
  1184. tomizing; many other protocols release only object or make source 
  1185. available  only with some difficulty or have source that  is  not 
  1186. that friendly.
  1187.  
  1188. 4.     Cost; Kermit is cheap; essentially free.  
  1189.  
  1190. This is pertinent not only to us but also important in  consider-
  1191. ing  the popularity of various file transfer systems.  If  we  do 
  1192. not have a Kermit capability, it is going to look strange.
  1193.  
  1194. 5.     Documentation
  1195.  
  1196. Documentation is both an advantage and disadvantage.
  1197.  
  1198. The  document that comes with MS-Kermit is lengthy  but  accurate 
  1199. and fairly complete.  But it is intimidating.
  1200.  
  1201. 6.     Testability:
  1202.  
  1203. Relatively convenient to test on PCs, UNIX, and VE systems.  No
  1204. special hardware needed.  Fully compatible with MICOM switch and
  1205. STAM.
  1206.  
  1207. 7.     Compatibility:
  1208.  
  1209. Kermit can run at any line speed (tested @ 19200/9600 baud).
  1210.  
  1211. 8.     File Organization:
  1212.  
  1213. Kermit can accommodate any file organization via a specific
  1214. implementation.
  1215.  
  1216. Kermit can transfer any type of data including all 256
  1217. characters(bytes).
  1218.  
  1219. 9.     Implementation:
  1220.  
  1221. One of the Kermit implementations is called C-Kermit and it is
  1222. written   in   the   'C'  language.    This   is   suitable   for 
  1223. conversion(porting) to the VE operating system.  The 'C' language 
  1224. is  a good language and fits in nicely with NCRs  corporate  lan-
  1225. guage strategy.
  1226.  
  1227. The C-Kermit implementation has some nice user features:  command 
  1228. files,  interactive commands, abbreviated commands, good  command 
  1229. parsing,  time-outs,  good statistics  displays,  logging,  debug 
  1230. features,  repeated  character compression, 3  byte  CRC  option, 
  1231. batch  file  transfer via name wildcards or command  files,  link 
  1232. connection facilities, control of the key parameters, server mode 
  1233. availability  where one Kermit can control another  Kermit,  file 
  1234. name flexibility, etc.
  1235.