home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / ibm370 / ikxker.bwr < prev    next >
Text File  |  2020-01-01  |  31KB  |  552 lines

  1. CICS Kermit 4.3.x "Beware File" - Known Bugs, Problems, Limitations.
  2.  
  3. As of: 14:25  Friday, 1997 Jun 13
  4.  
  5. This file contains (A) instructions for applying Kermit updates, (B) a
  6. list of unresolved problems, (C) a list of problems with work-arounds or
  7. optional fixes, and (D) a list of resolved problems.
  8.  
  9. NOTE: entries will sometimes be entered under (D) even though the needed
  10. updates have not been released in IKXKER.UPD.  Please check the date of
  11. the UPD and NUP files to see if they have been changed before requesting
  12. new copies.
  13.  
  14. Bug reports may be sent to John Chandler <JCHBN@CUVMB.CC.COLUMBIA.EDU>.
  15.  
  16. Kermit-370 carries an "edit" number in addition to the version and
  17. release numbers.  The three numbers together are printed out in the
  18. assembly listing and displayed by Kermit at startup time.  Be sure to
  19. include all three numbers (e.g., 4.3.0) along with any error reports.
  20.  
  21. A) Update instructions .................................................
  22.  
  23. Many updates have been received since Kermit-CICS 4.2 was released. All
  24. updates prior to 93/9/30 have been removed from IKXKER.UPD and applied
  25. to the sources in the process of creating 4.3.  If your source does not
  26. include the line defining &KVRSN to be 4.3, you should obtain an all-new
  27. source distribution from Columbia.  Any updates created later than your
  28. source should be applied before you make the executable module.  In
  29. general, updates received at Columbia will not be applied to the source
  30. files in the CICS Kermit distribution until and unless "major" bugs are
  31. uncovered, and then all accumulated updates will be applied at once.
  32. The description of each problem and a pointer to its solution will
  33. always be included in IKXKER.BWR (the present file), but the updates
  34. themselves are to be found in IKXKER.UPD.
  35.  
  36. The procedure for updating your copy of CICS Kermit is as described in
  37. IKXKER.INS.  When new updates become available, and you wish to apply
  38. them, the following hints may prove useful.
  39.  
  40. 1) Obtain the latest version of IKXKER.UPD, which contains all the
  41.    updates as a composite file punctuated by comment lines introducing
  42.    each update's name and briefly describing its purpose.  Please note
  43.    that some modes of file transport have a side effect of either
  44.    doubling or removing any periods in the first column -- if your copy
  45.    of IKXKER.UPD has records beginning with "/", then all instances of
  46.    "/" in column 1 should be changed to "./", and all records with "@"
  47.    in column 63 (introducing an update code normally found starting at
  48.    column 64) should be moved over to make room for a "." in column 1.
  49.    Similarly, any instances of ".." in columns 1-2 should be changed to
  50.    just ".".  A related problem can affect the sources by leaving a
  51.    blank in column 80.  That can happen via the loss of a "." in column
  52.    1 (in which case the sequence number will be shifted into columns
  53.    72-79) or via automated efforts to preserve the "." (in which case
  54.    the sequence number will be truncated).  The repair consists of
  55.    inserting the missing "." in column 1 or "0" in column 80.
  56.  
  57. 2) Determine the date of your sources.  If you obtained the source from
  58.    Columbia, the date is the value of the &KDATE variable symbol in the
  59.    source itself, i.e., the release date of the current base version.
  60.    If you received the source distribution from a secondary supplier,
  61.    you will need to examine the code to determine the most recent update
  62.    applied.  Just sort the combined source by columns 67-71; the last
  63.    line will be labelled with the last-applied update.  At present, the
  64.    generic and CICS-specific code have different effective dates (see
  65.    above).  The generic date is the one of interest.
  66.  
  67. 3) If your sources are "pure" Columbia 4.3, go on to step 4.  Otherwise,
  68.    you must take care to avoid applying updates that are already in the
  69.    source.  If it is inconvenient to obtain "pure" sources, you must go
  70.    through the list of updates at the beginning of IKXKER.UPD and remove
  71.    the entries for updates already included in (i.e., older than) your
  72.    sources.  Each line of the list begins with "./ *" plus an update
  73.    code in the form xxyyddd (the yyddd is just the date of the update --
  74.    the list is arranged chronologically).  Also, go through and discard
  75.    those updates from the file.  Each update begins with a second copy
  76.    of the line from the list and goes to the next such line.  The
  77.    updates are also in chronological order.  Note that individual update
  78.    control cards generally have time tags, but these are not necessarily
  79.    accurate and should not be taken seriously.
  80.  
  81. 4) Extract any desired optional updates from IKXKER.BWR (this file) and
  82.    group them together with any local modifications specific to your
  83.    site.  NOTE: all updates in this file are indented one column to
  84.    avoid all the transmission problems mentioned above in step 1.  Be
  85.    sure to shift everything over when you extract the updates.
  86.  
  87. 5) Apply the updates by following the instructions in IKXKER.INS.
  88.  
  89. ------------------------------------------------------------------------
  90. B) Unresolved problems .................................................
  91.  
  92. ---------------- 89/1/20 -----------------------------------------------
  93. Now that Kermit-370 supports multiple-filespec SEND, it is possible for
  94. a single SEND subcommand to specify overlapping wildcard filespecs.
  95. Only the CMS variant keeps track and makes sure that it doesn't send the
  96. same file twice within one send invocation.  The others, including CICS
  97. Kermit-370, may send the same file again, and it is left to the user to
  98. prevent filename-collision problems on the receiving end.
  99.  
  100. ---------------- 90/5/8 ------------------------------------------------
  101. With a few exceptions, CONTROLLER will be set automatically when Kermit
  102. is invoked.  See file IK0AAA.HLP in the Kermit distribution for a list
  103. of front ends that have been reported to allow Kermit file transfers
  104. and another list of reported failures.
  105.  
  106. ---------------- 91/6/11 -----------------------------------------------
  107. Kermit-CICS is a relatively new release, and some of the planned
  108. features have not yet been implemented.  Here is a brief list, ordered
  109. roughly by the importance and likelihood of implementation.  Some of
  110. these features are to be added through separate programs or exit
  111. routines, but others by modification of Kermit itself.  Some, such as
  112. #1 and #4, would be locally developed, but the Kermit distribution
  113. would include one or more samples.
  114.  
  115.  1. Algorithms for assigning a "userid" other than the OPID, TERMID, or
  116.     USERID.  See IKXKER.INS for details.
  117.  
  118.  2. I/O for spool files, to be supported by IKXDYNAL.  See IKXDYN.HLP
  119.     for details.
  120.  
  121.  3. I/O for MVS data sets, to be supported by IKXDYNAL.  ditto.
  122.  
  123.  4. Data security exits.  See IKXKER.INS for details.
  124.  
  125.  5. Local option for the action to take in response to BYE.
  126.  
  127.  6. Local option on limitations of use of TS space, starting with a
  128.     simple test of whether there is enough TS space of the desired type
  129.     for an inbound file.
  130.  
  131.  7. I/O for data objects on a remote CICS.
  132.  
  133.  8. Detection of the existence of data in output extra-partition TDQ's.
  134.  
  135.  9. Interception of terminal I/O from programs invoked by Kermit.
  136.  
  137. ---------------- 91/6/28 -----------------------------------------------
  138. Dynamically defined TD queues apparently do not reside in the DCT along
  139. with hard-coded queues.  Kermit-CICS may not be able to read or write
  140. them.
  141.  
  142. There may be limits on the size of TS queue records other than the
  143. general CICS maximum of 32767.  If such limits exist, you may need to
  144. reduce the &MAXLR global symbol in Kermit in order to force truncation
  145. or folding at a save level.  However, such a change would preclude
  146. writing such long records to Kermit directory members as well.
  147.  
  148. As with any multi-user environment, it is possible for a data object
  149. scheduled for downloading via a wildcard filespec to disappear from the
  150. system before its turn comes.  If that should happen, the transfer will
  151. halt with an "I/O error".  On the other hand, if a new object appears
  152. after the transfer has begun, it will not be sent, even if it matches
  153. the wildcard specification.  This problem applies mainly to TS queues.
  154.  
  155. There is no HOST RENAME function supported by Kermit.  There is also no
  156. APPEND option for the HOST COPY function.
  157.  
  158. There is a bug (or feature) in the handling of filespecs for the
  159. simulated system commands TYPE, COPY, DELETE, and DIRECTORY.  If the
  160. filetype is omitted, a filetype of TAKE, rather than TS, is assumed.
  161.  
  162. ---------------- 91/10/31 ----------------------------------------------
  163. Kermit-CICS has conditional assembly code for access to extra-partition
  164. TD's under CICS 1.6 and earlier, but it works only for CICS/OS/VS (MVS);
  165. there is no provision for DOS/VSE.
  166.  
  167. ------------------------------------------------------------------------
  168. C) Problems with workarounds or optional fixes .........................
  169.  
  170. ---------------- 89/2/27 -----------------------------------------------
  171. The code for detecting the difference between SERIES1- and GRAPHICS-type
  172. terminal controllers may cause peculiar error messages at session
  173. startup, particularly if you wish to run Kermit on an IBM 3270-type
  174. terminal.  Normally, Kermit can recover from these error conditions, but
  175. some configurations and/or versions of VTAM may hang the terminal
  176. session instead or have other undesirable side effects.  For example,
  177. there may be an error message IKT00405I SCREEN ERASURE CAUSED BY ERROR
  178. RECOVERY from VTAM that never goes away.  In that case, there are
  179. several possible cures.  First is the simple expedient of pressing PA1
  180. to clear the error condition.  If that doesn't help at your site, you
  181. may find that logging onto the host via Netview's TAF component makes
  182. the error message appear only once.  If you cannot start Kermit
  183. reliably, you might want to bypass the code (especially if you don't
  184. have any GRAPHICS-type terminals).  The code is governed by a set of
  185. switches which can be tailored to your needs:
  186.  
  187.  STCQBIT  EQU   X'01'         WSF Query is always allowed
  188.  STCQNS1  EQU   X'02'         WSF Q implies *not* SERIES1
  189.  STCS1    EQU   X'04'         Always assume SERIES1
  190.  STCNOS1  EQU   X'08'         Always assume *not* SERIES1
  191.  STCNORD  EQU   X'10'         Asynch READ MOD is forbidden
  192.  
  193. Because there is apparently no way to determine from within a program
  194. whether WSF Query is allowed for a particular terminal and because CICS
  195. does not provide for Read Modified commands without waiting for an
  196. Attention interrupt, the standard flag value on CICS is STCNORD+STCQBIT;
  197. if you wish to force the code to select SERIES1, you should change that
  198. to STCNORD+STCS1, as in the following:
  199.  
  200.  ./ * SC9131X - Customize controller type selection
  201.  ./ R 01205200          $ 1205200 100                  11/21/91 00:16:50
  202.  &CONOPTS SETC  'STCNORD+STCS1' SETCON options                  @SC9131X
  203.  
  204. Alternatively, if you have *only* GRAPHICS-type controllers, you could
  205. change it to STCNORD+STCNOS1 (or STCNORD+STCNOS1+STCQBIT if you have
  206. 3174 AEA controllers).
  207.  
  208. ---------------- 90/7/5 ------------------------------------------------
  209. Kermit-370 honors the file type specification (binary or text) given by
  210. a sending Kermit in an Attribute packet.  Issue the SET FILE TYPE to
  211. both sending and receiving Kermits (to be safe).
  212.  
  213. ---------------- 90/7/30------------------------------------------------
  214. When the file type is TEXT and the recfm is F, Kermit-370 strips off
  215. trailing blanks from each record before sending a file.  In order to
  216. keep trailing blanks in a downloaded file, you can convert it to RECFM
  217. V before sending it, e.g., by using HOST COPY to move it to a TS queue.
  218.  
  219. ---------------- 90/8/22 -----------------------------------------------
  220. If, for some reason, the other Kermit insists on pretending ASCII bytes
  221. all have the 8th bit set, Kermit-370 will not detect the intended CRLF
  222. separators between lines.  The result of uploading from such a Kermit is
  223. a (text) file with only one record.  If the other Kermit cannot be
  224. fixed, the following update will make Kermit-370 treat ASCII 8D and 8A
  225. the same as 0D and 0A, as long as the ATOE table does so.
  226.  
  227.  ./ * SC90151 - Forgive 7-bit ASCII files with 8th bit on
  228.  ./ I 02490500          $ 2490700 200                  08/03/90 16:06:46
  229.  ISW78    DC    X'7F'         Start with 7-bit ASCII            @SC90151
  230.  ./ I 02713500          $ 2713700 200                  08/03/90 16:06:46
  231.  SW78     DS    X'7F'         Switch for 7-bit/8-bit ASCII      @SC90151
  232.  ./ I 03347500          $ 3347700 200                  08/03/90 ->4.3<-
  233.           KCALL TBLCRLF       Note current treatment            @SC90151
  234.  ./ I 03350500          $ 3350700 200                  08/03/90 ->4.3<-
  235.           KCALL TBLCRLF       Note current treatment            @SC90151
  236.  ./ I 04016000          $ 4016200 200                  08/03/90 ->4.3<-
  237.           KCALL TBLCRLF       Reset 7-bit/8-bit mask for CRLF   @SC90151
  238.  ./ I 04063000          $ 4063040 40                   08/03/90 ->4.3<-
  239.  *
  240.  * Entry: nothing special                                       @SC90151
  241.  * Exit:  SW78 set up correctly                                 @SC90151
  242.  TBLCRLF  ENTER ALT                                             @SC90151
  243.           MVI   SW78,255      Assume 8-bit codes                @SC90151
  244.           CLC   ATOE+ALF(1),ATOE+ALF+128                        @SC90151
  245.           BNE   RTRN0                                           @SC90151
  246.           CLC   ATOE+CR(1),ATOE+CR+128                          @SC90151
  247.           BNE   RTRN0                                           @SC90151
  248.           MVI   SW78,127      No, 7-bit codes                   @SC90151
  249.           B     RTRN0                                           @SC90151
  250.  ./ I 08391000          $ 8391200 200                  08/03/90 ->4.3<-
  251.           NC    CUR,SW78      If 7-bit ASCII, ignore 8th bit    @SC90151
  252.  
  253. ---------------- 91/5/30 -----------------------------------------------
  254. The "factory" settings for several of the Kermit options may be unsuited
  255. to the operation at a given site.  Here are updates to change some of
  256. the most likely parameters to need changing.
  257.  
  258.  ./ R 01208000          $ 1208000 500
  259.  LIMDSK   EQU   65536         Reduce user directory space quota @SC91150
  260.  
  261.  ./ R 01209000          $ 1209000 500
  262.  CUTDSK   EQU   300000        Increase directory space cutoff   @SC91150
  263.  
  264.  ./ R 01226000          $ 1226000 500
  265.  &USER    SETC  'TERM'        Use TERMID for user id            @SC91150
  266.  
  267.  ./ R 01226000          $ 1226000 500
  268.  &USER    SETC  'UID'         Use USERID for user id            @SC91150
  269.  
  270.  ./ R 01226000          $ 1226000 500
  271.  &USER    SETC  'OTHER'       Use exit routine to get user id   @SC91150
  272.  
  273.  ./ R 01415800          $ 1415800 10                            ->4.3<-
  274.  &KTRACE  SETC  'YES'         Enable tracing                    @SC91150
  275.  
  276. ---------------- 91/11/21 ----------------------------------------------
  277. In order to change the default Kanji encoding from IBM-style to another,
  278. add one of the following updates.
  279.  
  280.  ./ * SC9132X - Change Kanji default
  281.  ./ R 01416000          $ 1416000 10                   11/21/91 ->4.3<-
  282.  &KNJDEF  SETC  'HITACHI' Default Kanji                         @SC9132X
  283.  
  284.  ./ * SC9132X - Change Kanji default
  285.  ./ R 01416000          $ 1416000 10                   11/21/91 ->4.3<-
  286.  &KNJDEF  SETC  'FUJITSU' Default Kanji                         @SC9132X
  287.  
  288. ---------------- 92/4/10 -----------------------------------------------
  289. The minimum size of strings to be subjected to run-length encoding may
  290. need to be changed to two to make the new FULLSCREEN mode work on
  291. certain protocol converters, such as the MICOM 7400, which convert three
  292. successive blanks into cursor motion commands (or even two!).  The
  293. following update accomplishes that.
  294.  
  295.  ./ * SC92101 - Encode multiple blanks
  296.  ./ I 08296500          $ 8296550 50                   04/10/92 ->4.3<-
  297.           CLI   0(8),ABL      Is it a blank?                    @SC92101
  298.           BNE   ENCRP1        No, use normal criterion          @SC92101
  299.           C     14,F2                                           @SC92101
  300.           BNL   ENCRP2        Always encode multiple blanks     @SC92101
  301.  ENCRP1   DS    0H                                              @SC92101
  302.  ./ I 08297500          $ 8297700 200                  04/10/92 ->4.3<-
  303.  ENCRP2   DS    0H                                              @SC92101
  304.  
  305. ---------------- 92/7/8 ------------------------------------------------
  306. Running Kermit under CICS in a BTAM environment with a Yale-type
  307. protocol converter may require the application of APAR PN00282 to avoid
  308. continually getting out of transparent mode during a file transfer.  The
  309. specific CICS component affected is DFHTCP.
  310.  
  311. ---------------- 92/7/13 -----------------------------------------------
  312. Under DOS/VSE, a small change can be made in the installation to avoid a
  313. harmless error message from the assembly of IKXTRN -- remove the END
  314. statement from the source file and insert a " PUNCH ' END'" into the JCL
  315. after the " PUNCH ' COPY IKXTRN'".
  316.  
  317. ---------------- 92/10/18 ----------------------------------------------
  318. When Kanji characters are first selected, the default for the single-
  319. byte character set is CP290 (hard-coded in Kermit-370).  That can be
  320. changed, however:
  321.  
  322.  ./ * SC92252 - Make CP281 the default SBCS with KANJI
  323.  ./ R 04118000          $ 4118000 100                  10/18/91 ->4.3<-
  324.  TBVJP    DC    CL(LALF)'CP281',CL(LALF)'CP500',CL(LALF)'CP290' @SC92252
  325.  
  326. ---------------- 93/1/21 -----------------------------------------------
  327. Kermit-370 in FULLSCREEN mode can be at the mercy of clever efforts
  328. toward screen "optimization" by the protocol converter.  One possible
  329. symptom is the suppression of the last outbound packet in a transfer if
  330. the screen is cleared just afterwards.  This may happen after an upload
  331. or upon leaving server mode.  To avoid this possibility, Kermit-370 can
  332. simply wait a few seconds to give the protocol converter less excuse for
  333. suppressing the last packet.  The following update uses four seconds,
  334. but the optimum time may be more or less, depending on the system.
  335.  
  336.  ./ * SC93021 - Try to prevent end effect in FULLSCREEN mode
  337.  ./ I 08780000          $ 8780000 80                   01/22/93 ->4.3<-
  338.           CLI   TRMTP,C'F'                                      @SC93021
  339.           BNE   INTINICN      Go if not FULLSCREEN              @SC93021
  340.           LA    0,4           Wait four seconds to synchronize  @SC93021
  341.           KCALL SUPFNC,9                                        @SC93021
  342.  INTINICN DS    0H                                              @SC93021
  343.  
  344. ---------------- 93/5/21 -----------------------------------------------
  345. Kermit-CICS sometimes has trouble synchronizing read and write commands
  346. on GRAPHICS-type protocol converters.  The symptom is a lost packet when
  347. the micro sends before the mainframe is ready.  There is a cure, but it
  348. can't be applied generally because it may kill transfers on terminals
  349. defined with the automatic up-casing option.  For some reason, the ASIS
  350. option is not permitted for the CICS CONVERSE command, which is the
  351. centerpiece of the update below.  Users are invited to experiment with
  352. this update by moving the comma from before to after the word "ASIS" on
  353. the line marked with "???" and/or to try the update with terminals set
  354. for automatic upcasing.  If results are favorable, this update may be
  355. added permanently to Kermit.
  356.  
  357.  ./ * SC93110 - Ensure line turnaround (CICS)
  358.  ./ I 01131000          $ 1132000 1000                 04/21/93 22:14:44
  359.  SCRCTLCH DS    X             WCC for next output op            @SC93110
  360.  ./ R 05540400          $ 5540400 40                   04/21/93 22:14:44
  361.           BE    SCRNEXWS      Expecting a reply - save ptrs     @SC93110
  362.  ./ R 05542500 05543500 $ 5542500 300                  05/20/93 17:36:43
  363.           CLI   WRRD,5                                          @SC93110
  364.           BNE   *+12          Not expecting a reply - just send @SC93110
  365.             CLI CONSOPR,6       Write message?                  @SC93110
  366.             BNE SCRNEXWS        No, save ptrs                   @SC93110
  367.  *        MVI   SCRCTLCH,X'C1'  Yes, lock it to prevent clash   @SC93110
  368.  ./ I 05545000          $ 5545200 200                  04/21/93 22:14:44
  369.           MVI   SCRLSTIO,0    Clear I/O code                    @SC93110
  370.  ./ I 05545500          $ 5545600 100                  04/21/93 22:14:44
  371.  SCRNEXWS MVC   SCRLSTIO,0(8) Save code of last I/O             @SC93110
  372.           B     SCRNEXZ                                         @SC93110
  373.  ./ I 05549000          $ 5549200 200                  04/21/93 22:14:44
  374.           L     3,SCRLSTIO                                      @SC93110
  375.  ./ D 05550150                                         04/21/93 22:14:44
  376.  ./ R 05550250          $ 5550250 10                   04/21/93 22:14:44
  377.                 FROM(0(,3)) FROMLENGTH(SCRLSTIO+6),             @SC93110+
  378.  ./ I 05551000          $ 5551060 60                   04/21/93 22:14:44
  379.           CLI   SCRLSTIO,0    Saved WRITE operation?            @SC93110
  380.           BE    SCRNEXRR      No, fine                          @SC93110
  381.           EXEC CICS CONVERSE CTLCHAR(SCRCTLCH),                 @SC93110+
  382.                 FROM(0(,3)) FROMLENGTH(SCRLSTIO+6),             @SC93110+
  383.                 INTO(0(,7)) TOLENGTH(GTMLEN), ASIS   ???        @SC93110
  384.           B     SCRNEXR2                                        @SC93110
  385.  SCRNEXRR DS    0H                                              @SC93110
  386.  ./ D 05559000                                         04/21/93 22:14:44
  387.  ./ D 05569000                                         04/21/93 22:14:44
  388.  
  389. ---------------- 93/9/20 -----------------------------------------------
  390. When issuing the STOP command to get out of Kermit protocol mode, it may
  391. be necessary to hit the CLEAR EOL (not the CLEAR) key so that Kermit-370
  392. will recognize the command.  In general, if the word "stop" is echoed to
  393. the screen as you type it, and if there is already stuff on that same
  394. line, that previous stuff will be sent to the host when you hit ENTER.
  395. To prevent that, you must clear it without causing an interrupt, i.e.,
  396. without using the CLEAR key.
  397.  
  398. ------------------------------------------------------------------------
  399. D) Resolved problems ...................................................
  400.  
  401. ---------------- 90/5/8 ------------------------------------------------
  402. A commonly reported "problem" is that Kermit-370 objects to a send
  403. packet size greater than 94, and users wonder how to turn on long-packet
  404. protocol for downloads.  The answer is that the the maximum packet size
  405. in Kermit protocol is always dictated by the receiving Kermit -- ALWAYS.
  406. NOTHING YOU CAN SAY TO A SENDING KERMIT WILL EVER MAKE IT SEND PACKETS
  407. LONGER THAN THE RECEIVING KERMIT ASKS FOR.  Conversely, Kermit-CICS will
  408. always use packets as long as possible unless frequent transmission
  409. errors indicate a noisy communication line.  The only purpose for the
  410. send packet-size parameter in Kermit-CICS is to set the default, in case
  411. the receiving Kermit is badly crippled (in which case, long packets are
  412. entirely out of the question anyway), or to control "raw" downloads
  413. (those without Kermit protocol and parameter negotiation).
  414.  
  415. ---------------- 90/6/22 -----------------------------------------------
  416. Kermit-370 supports file transfers through the IBM 3174 AEA with level 2
  417. microcode in configuration B.  The support is restricted to terminal
  418. types defined in the 3174 to have ASCII Graphics capability.  That
  419. capability is available by default only for VT241 and Tektronix 4205
  420. terminals, but user-defined terminal types are also possible.  Also, the
  421. Graphics capability is allowed only for lines defined without associated
  422. Host Addressible Printers.  Kermit-370 now automatically detects the B2
  423. AEA and sets CONTROLLER accordingly (to AEA if Graphics is allowed, to
  424. NONE if not).  However, if the 3174 is owned by VTAM, and the connection
  425. is made with a logmode that forbids the Read Partition Query (such as
  426. M2SDLCNQ), Kermit cannot detect the AEA and will default to CONTROLLER
  427. GRAPHICS (and, incidentally, cannot transfer files even with CONTROLLER
  428. set to AEA by hand).  M2SDLCQ is known to allow correct operation, but
  429. other logmodes have not been tested.  Since the 3174 supports full 8-bit
  430. communication, it may be useful to configure the ports for 8-bit data
  431. and to set both SEND and RECEIVE PARITY to NONE in Kermit-370.  The fix:
  432. SC90173.  Note: B2 microcode became available from IBM in May 1990.  B3
  433. followed soon afterward, and it supports file transfer the same way as
  434. B2.
  435.  
  436. ---------------- 94/3/15 -----------------------------------------------
  437. Kermit-370 now sends an explicit NAK packet when it receives a bad data
  438. packet, instead of resending the previous ACK (which is nominally the
  439. same thing in Kermit protocol).  This way, there are no needless
  440. timeouts when dealing with a zealous sliding-windows Kermit.  The fix:
  441. SC94074 in IKXKER.UPD.
  442.  
  443. ---------------- 94/6/23 -----------------------------------------------
  444. Kermit-370 honors a new protocol feature known as "WHATAMI".  Thus, when
  445. Kermit-370 is in server mode, the user can issue a SET FILE TYPE to the
  446. local Kermit and have it take effect in the server as well.  The local
  447. Kermit obviously must also support WHATAMI.  The fix: SC94174 in
  448. IKXKER.UPD.  See also the note in section (C) dated 90/7/5.
  449.  
  450. ---------------- 94/6/30 -----------------------------------------------
  451. Kermit-370 honors the new level-1 restart/recovery mode.  When a
  452. similarly equipped Kermit is at the other end, an interrupted binary
  453. transfer can be resumed where it left off by issuing a RESEND instead of
  454. a SEND (same syntax).  Attributes must be enabled at both ends of the
  455. transfer, and the sender must be set to binary (V-BINARY and D-BINARY
  456. are also acceptable).  If the file in question is already fully received
  457. at the other end, RESEND does nothing; if the file is not even partially
  458. received, RESEND behaves just like SEND.  In order to insure that the
  459. partial file is not erased when a transfer aborts, it is helpful to
  460. issue a SET INCOMPLETE KEEP to the receiving Kermit.  Kermit-370 now
  461. also supports the UPDATE option of FILE COLLISION.  With that option, a
  462. received file is rejected (on grounds of "date") if the transmitted time
  463. stamp is no later than that of an existing file of the same name.  The
  464. fix: SC94181 in IKXKER.UPD.
  465.  
  466. ---------------- 94/9/3 ------------------------------------------------
  467. Kermit-370 gives more accurate transfer statistics after uploads in
  468. server mode.  Formerly, the time used in figuring transfer rates
  469. included any waiting time after the transfer completed but before the
  470. next inter-Kermit communication (result: understimated efficiency).
  471. The fix: SC94245 in IKXKER.UPD.
  472.  
  473. ---------------- 94/12/10 ----------------------------------------------
  474. Kermit-CICS now runs under CICS version 3.3.  CICS has introduced new
  475. command-level facilities for obtaining the information in control blocks
  476. formerly available only through the CSA, and the CSA has been removed.
  477. The new facilities are automatically used by Kermit when installed with
  478. the appropriate "SYSPARM" (always set to the current CICS version).
  479. The fix: BM94344 in IKXKER.UPD.
  480.  
  481. ---------------- 95/1/23 -----------------------------------------------
  482. Kermit-370 misbehaved when doing a RESEND of a file that was already
  483. entirely received on the target system.  If the length matched exactly
  484. that of the file to be sent, the whole thing would be sent again and
  485. appended.  That is now corrected.  Also, Kermit-370 now has the APC
  486. subcommand for sending Kermit commands to the micro while in connect
  487. mode.  The fix: SC95023 in IKXKER.UPD.
  488.  
  489. ---------------- 95/2/1 ------------------------------------------------
  490. Kermit-370 objected to receiving a RESEND of a file too large to fit on
  491. disk without removing the portion already received.  It now takes into
  492. account the fact that that portion will not be duplicated.
  493. The fix: SC95032 in IKXKER.UPD.
  494.  
  495. ---------------- 95/2/2 ------------------------------------------------
  496. Kermit-370 is now at level 4.3.1.
  497.  
  498. ---------------- 95/2/10 -----------------------------------------------
  499. Kermit-CICS now avoids an error message during assembly under CICS 3.3
  500. and higher.  The "error" in question had no effect on the executable
  501. code, but should be avoided anyway.  The fix: SC95041 in IKXKER.UPD.
  502.  
  503. ---------------- 95/2/28 -----------------------------------------------
  504. Kermit-370 now uses the newly-transmitted time tag for a file that is
  505. resumed after an abortive transfer.  The fix: SC95059 in IKXKER.UPD.
  506.  
  507. ---------------- 95/4/18 -----------------------------------------------
  508. Kermit-370 no longer treats an error-free file transfer as an "error"
  509. for the purpose of deciding whether to halt execution of a TAKE file.
  510. The fix: SC95108 in IKXKER.UPD.
  511.  
  512. ---------------- 95/6/23 -----------------------------------------------
  513. Kermit-370 now supports the REGET subcommand, which works like GET, but
  514. makes the server do a RESEND of the requested file.  The fix: SC95174 in
  515. IKXKER.UPD.
  516.  
  517. ---------------- 96/5/1 ------------------------------------------------
  518. Kermit-370 now suppresses the "doubled" transmission of a file that can
  519. sometimes occur on a flaky connection.  (This was a problem introduced
  520. in the process of avoiding unnecessary time-outs on flaky lines.) The
  521. fix: SC96122 in IKXKER.UPD.
  522.  
  523. ---------------- 96/5/30 -----------------------------------------------
  524. Kermit-370 now announces its system type to the other Kermit before a
  525. transfer.  This meshes with new versions of the various micro Kermits
  526. that expect that information and will display it to the transfer screen.
  527. The fix: SC96151 in IKXKER.UPD.
  528.  
  529. ---------------- 96/6/6 ------------------------------------------------
  530. Kermit-370 has been modified to take advantage of another recent upgrade
  531. to micro Kermits -- it will be possible to issue a SEND or GET to the
  532. mainframe Kermit, and the micro will automatically pop from terminal
  533. emulation into transfer mode and then revert to emulation as soon as the
  534. transfer is done.  The fix: SC96158 in IKXKER.UPD.
  535.  
  536. ---------------- 96/6/13 -----------------------------------------------
  537. Kermit-CICS has been updated to comply with the conventions for time
  538. tags beyond 1999.  These are used only for files in the Kermit-managed
  539. user directories.  TD and TS queues do not have time tags associated
  540. with them.  The fix: SC96165 in IKXKER.UPD.
  541.  
  542. ---------------- 97/1/28 -----------------------------------------------
  543. Kermit-370 was failing to clear the "Kermit command error" status upon
  544. execution of the VERSION and ECHO subcommands.  It now clears that
  545. status condition to "No errors" after all subcommands, as described in
  546. the documentation.  The fix: SC97028 in IKXKER.UPD.
  547.  
  548. ---------------- 97/6/13 -----------------------------------------------
  549. Kermit-370 is now at level 4.3.2.
  550.  
  551. ------------------------------------------------------------------------
  552.