home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 29 Fixes_o / 29-Fixes_o.zip / CM2AP111.PKG < prev    next >
Text File  |  1996-05-10  |  20KB  |  486 lines
  1. *******************************************************************
  2. *
  3. * Date: 03/12/96   (Repackaged on 3/28/96 into 3 zip files.)
  4. *
  5. * This package contains APAR fixtests to release level code.  This
  6. * package is distributable to any customer who has a CM/2 license.
  7. *
  8. *******************************************************************
  9. *
  10. * Applicable CM/2 version(s): 1.11 (WR06150)
  11. *
  12. *******************************************************************
  13. *
  14. * List of APARs included, Description of new function APARs
  15. * included in the package, and Installation instructions follow:
  16. *
  17. *******************************************************************
  18. *
  19. * LIST OF APARs INCLUDED:
  20. *
  21. *  The following SNA-APPC-APPN-SNAGATEWAY APAR fixtests are included in this package:
  22. *
  23. *   All APARs closed prior to July 1, 1994 and
  24. *   the APARs listed below:
  25. *
  26. *
  27. *     JR08524     JR08587          JR08345     JR08617   JR08852   JR08616
  28. *     JR08280     JR08611          JR08288     JR08610   JR08838   JR08806
  29. *     JR08205     JR08608          JR08346     JR08564   JR08812   JR08611
  30. *     JR08359     JR08580          JR08454     JR08568   JR08803   JR08647
  31. *     JR08473     JR08565          JR08373     JR08517   JR08768   JR08438
  32. *     JR08314     JR08535          JR08370     JR08528   JR08738   JR08558
  33. *     JR08381     JR08524          JR08395     JR08457   JR08722   JR08854
  34. *     JR08365     JR08509          JR08251     JR08500   JR08751   JR08601
  35. *     JR08255     JR08492          JR08497     JR08490   JR08737   JR08560
  36. *     JR08435     JR08484          JR08324     JR08453   JR08762   JR08624
  37. *     JR08339     JR08452          JR08402     JR08431   JR08693
  38. *     JR08403     JR08386          JR08262     JR08287   JR08695
  39. *     JR08299     JR08278          JR08260     JR08244   JR08714
  40. *     JR08176     JR08217          JR08236     JR08286   JR08646
  41. *     JR08229     JR08165          JR08124     JR08084   JR08652
  42. *     JR07971     JR08193          JR08189     JR08245   JR08651
  43. *     JR08196     JR08182          JR08160     JR07455   JR08665
  44. *     JR08250     JR08101          JR08121     JR08131   JR08591
  45. *     JR08106     JR08065          JR08130     JR08121   JR08606
  46. *     JR08058     JR08052          JR08527     JR08459   JR08615
  47. *
  48. *DESCRIPTION OF NEW FUNCTION APARS INCLUDED IN THE PACKAGE:
  49. *
  50. *
  51. * APAR= JR08665 FIXED PACING FOR INTERMEDIATE NODES. - NEW FUNCTION
  52. *
  53. *
  54. * Interactive traffic waits behind large file transfers.
  55. *
  56. * The problem is that too much data is queued to the DLC
  57. * queue. If interactive data comes afterwards, it has to
  58. * wait much longer. Now, if the fixed pacing is used,
  59. * the data may get collected at intermediate node in SNA
  60. * queue but the DLC queue will never have
  61. * more than "2n-1" frames for that particular session where
  62. * n is the fixed pacing window.
  63. *
  64. * The benefit of fixed pacing is:
  65. *
  66. * Fixed pacing when used at end workstation or intermediate node,
  67. * it limits to amount of frames that can be queued to the DLC to
  68. * 2n-1 for a given session. (n is fixed pacing value). This allows
  69. * other sessions to also queue data to the DLC queue before all
  70. * the data from an earlier file transfer is queued to the DLC."
  71. * This new function was added to Communications Manager/2 1.11.
  72. * See APAR JR08131 for defining fixed pacing and related
  73. * APAR JR08492.
  74. *
  75. *
  76. *
  77. * APAR= JR08431
  78. * NEW FUNCTION FOR SDLC DIAL-OUT TO ALLOW A BACKUP HOST TO
  79. * DIAL-IN.
  80. *
  81. * The new function required is ...  to have a primary host that is
  82. * dialed out and an incoming backup host (different fully
  83. * qualified name and node ID) that is received for SDLC.
  84. *
  85. * Communications Manager/2 was updated to match an incoming
  86. * request to a defined link if the defined link has no adjacent
  87. * CP name or adjacent node ID and the incoming request has
  88. * INIT_SELF supported (from a PU 2.0 host) on the received
  89. * XID3 for SDLC connections.
  90. *
  91. *
  92. * APAR= JR08452
  93. * NEW FUNCTION TO OPTIONALLY NOT REACTIVATE THE DLC.
  94. *
  95. * Communications Manager/2 1.11 ( WR06150 )
  96. *
  97. * Communications Manager/2 was updated to look at the
  98. * APPCPC.DAT file to determine if the DLC is to be reactivated
  99. * or not.
  100. *
  101. * The default for Communications Manager/2 is reactivate the DLC.
  102. *
  103. * To define Communications Manager/2 such that it will not
  104. * reactivate the DLC:
  105. * 1.  Edit the APPCPC.DAT file in  cmlib
  106. * 2.  A "D" begins each line of the DLC records in the APPCPC.DAT
  107. *     file.  Look for the "*", which is in column 37.
  108. * 3.  For the DLC that you do not want to reactive, place a
  109. *     "1" after the "*" , column 38.  The DLC name is in columns
  110. *     26-33.
  111. * 4.  Enter CMSETUP and change a value in the configuration of
  112. *     the  DLC that is not to be reactivated.  Any parameter can
  113. *     be changed. Exit the panel, then reenter the panel to
  114. *     change the parameter back to the original value.  This will
  115. *     cause Communications Manager/2 to read the APPCPC.DAT and
  116. *     update the Communications Manager/2 configuration to not
  117. *     reactivate the chosen DLCs.
  118. *
  119. *
  120. * APAR= JR08453
  121. * AUTOMATICALLY RESTORE CP-CP SESSION WHEN A LINK IS DROPPED.
  122. *
  123. * When CP - CP Sessions fail between Communications Manager/2
  124. * and its partner CP, the link had to be broken and brought
  125. * back up again to restore the CP - CP Sessions.
  126. * This in effect meant that all application sessions would have to
  127. * come down as well.
  128. *
  129. * This APAR provides the ability for Communications Manager/2 to
  130. * recover CP-CP sessions (reactivate) without having to deactivate
  131. * the link from CM/2 to NCP (3745).
  132. *
  133. *
  134. * APAR= JR08492
  135. * TWO WAY FIXED PACING
  136. *
  137. * 3270 sessions appear to hang or stop during transmission of
  138. * large amounts of data by APPC or LU6.2 programs.
  139. *
  140. * The problem is that the 3270 traffic is interspersed with the
  141. * APPC traffic as it is queued on the Data Link Control.  For
  142. * example a large APPC data transaction would be queued,
  143. * next a 3270 enter key.  The 3270 transaction would
  144. * wait until all previously queued data was transmitted, and
  145. * it would be sent.
  146. *
  147. * If the host is sending data then setting FIXED PACING
  148. * (see JR08131) may resolve the problem if the host is
  149. * also properly configured.  This APAR introduces TWO_WAY_FIXED
  150. * pacing as another alternative, if you have Communications
  151. * Manager/2 connected to an NCP and you do not want to change
  152. * the NCP definition.
  153. *
  154. * Communications Manager/2 via this APAR, implements a new
  155. * function called TWO_WAY_FIXED pacing.  This new function
  156. * will work over sessions flowing between and NCP and
  157. * Communications Manager/2, but not between two
  158. * Communications Manager/2 workstations.
  159. *
  160. * When Communications Manager/2 to Communications Manager/2
  161. * is attempted with TWO_WAY_FIXED pacing, Sense 08350008
  162. * is returned in the UNBIND.
  163. *
  164. * With TWO_WAY_FIXED pacing, Communications Manager/2
  165. * will set both the primary receive and secondary send pacing
  166. * window size in the bind response from the mode
  167. * RECEIVE_PACING_WINDOW.
  168. *
  169. * You will need to chose the window sizes that work
  170. * best in your environment.
  171. *
  172. * To configure two way fixed pacing, edit the *.ndf file, under
  173. * DEFINE_MODE, add or change the PACING_TYPE to
  174. * PACING_TYPE(TWO_WAY_FIXED).
  175. *
  176. *  Example: DEFINE_MODE     mode_name(mode1)
  177. *                           max_ru_size_upper_bound(4096)
  178. *                           cos_name(#connect)
  179. *                           default_ru_size(yes)
  180. *                           max_negotiable_session_limit(1)
  181. *                           min_conwinners_source(1)
  182. *                           plu_mode_session_limit(1)
  183. *                           receive_pacing_window(7)
  184. *                           compression_need(requested)
  185. *                           PACING_TYPE(TWO_WAY_FIXED).
  186. *                           plu_slu_compression(rle)
  187. *                           slu_plu_compression(lz9)
  188. *                           description(single session mode);
  189. *
  190. * After adding the keyword, run CMVERIFY on the
  191. * configuration file to verify the changes.  Communications
  192. * Manager/2 can then be started.
  193. *
  194. *
  195. * APAR= JR08500
  196. * HOST BACK UP LINK FOR A GIVEN PU - NEW FUNCTION.
  197. *
  198. * Communications Manager/2 1.11 does not support
  199. * Host backup link when the primary link to host
  200. * fails. APAR JR08500 adds host backup link support for
  201. * dependent LU's. It is not supported for independent LU 6.2
  202. * sessions.
  203. *
  204. * New Function: Adds support for backup host link for dependent
  205. * sessions. To setup the host backup link, you need to define
  206. * two links with the same (local) PU Name on DEFINE_LOGICAL_LINK
  207. * verb in .NDF file. Then, indicate the backup link with the
  208. * new backup link parameter. Same PU and LU definitions should
  209. * be used at Host.
  210. *
  211. * Dependent LU definitions can be only on the host link for a PU
  212. * that is defined as the primary host link.  However, both primary
  213. * and backup host links for a PU will use all LUs defined for that
  214. * PU. The backup host link will be automatically activated if
  215. * activation of the primary host link activation fails.
  216. *
  217. * NOTES:
  218. * 1. The backup link is a backup only for dependent LU
  219. *    (gateway, LUA, or 6.2 dependent LUs) traffic.
  220. * 2. The backup must be inactive except when automatically
  221. *    activated for use as the backup host link.
  222. * 3. There is no automatic switch back to the primary link.
  223. *
  224. * To define a back-up link for Communications Manager/2 1.11:
  225. *  1. Stop Communications Manager 1.11.
  226. *  2. Create another link through panel interface or adding
  227. *     DEFINE_LOGICAL_LINK for the new link in .NDF file. No
  228. *     Partner LU's should be defined to the backup link.
  229. *  3. Add "HOST_BACKUP_LINK(YES)" parameter in the
  230. *     DEFINE_LOGICAL_LINK for the backup link.
  231. *  4. Set "ACTIVATE_AT_STARTUP(NO)" parameter in
  232. *     DEFINE_LOGICAL_LINK for the backup link.
  233. *  5. Keep "PU_NAME" parameter in DEFINE_LOGICAL_LINK same as the
  234. *     primary link.
  235. *  6. Verify the configuration file by "CMVERIFY cfgname" where
  236. *     cfgname is the name of your configuration file. Use /I
  237. *     option for SNA Phone Connect.
  238. *  7. Start Communications Manager. If you also create a new DLC,
  239. *     you must reboot the workstation.
  240. *
  241. *
  242. *    JR08130: X.25 Dial Remote DTE and CP Names.
  243. *
  244. *  Previous to this APAR, Communications Manager did not
  245. *  allow dial-out and dial-in environments where the
  246. *  host has multiple X.25 links unless either the CPNAME or
  247. *  the adjacent node_id match between the link definition
  248. *  and the XID exchanged during activation.
  249. *
  250. *  Since the selected link can change, the remote DTE address
  251. *  is not guaranteed to be the same for each dial in connection.
  252. *  This change tests for an asterisk (*) X.25 remote DTE address
  253. *  and uses that definition even if the adjacent node id and
  254. *
  255. *  Communications Manager also required that the
  256. *  remote DTE address match if it is specified.  This change
  257. *  allows the remote DTE address to mismatch as long as the
  258. *  Partner CPNAME matched in the XID exchange.
  259. *
  260. *  Communications Manager was updated to
  261. *  test for an asterisk (*) X.25 remote DTE address, then
  262. *  uses that definition even if the adjacent node id and adjacent
  263. *  CPNAME do not match.
  264. *
  265. *  Now when remote DTE address changes, Communications Manager
  266. *  will check the FULLY QUALIFIED PARTNER CPNAME for the link.
  267. *  Further, the remote DTE address can mismatch as long as the
  268. *  Partner CPNAME matched in the XID exchange.
  269. *
  270. *
  271. *    JR08131: Fixed pacing in Communications Manager 1.11 (WR06150)
  272. *
  273. *  To configure fixed pacing for a particular mode, there are
  274. *  two approaches:
  275. *
  276. *    1. UPDATING THE .NDF FILE:
  277. *      A new keyword, PACING_TYPE, was added to the DEFINE_MODE
  278. *      verb in the  .NDF  file.  The valid values are
  279. *      ADAPTIVE and FIXED.  The default is ADAPTIVE.
  280. *
  281. *      Example: DEFINE_MODE     mode_name(mode1)
  282. *                               max_ru_size_upper_bound(4096)
  283. *                               cos_name(#connect)
  284. *                               default_ru_size(yes)
  285. *                               max_negotiable_session_limit(1)
  286. *                               min_conwinners_source(1)
  287. *                               plu_mode_session_limit(1)
  288. *                               receive_pacing_window(7)
  289. *                               compression_need(requested)
  290. *                               PACING_TYPE(FIXED)
  291. *                               plu_slu_compression(rle)
  292. *                               slu_plu_compression(lz9)
  293. *                               description(single session mode);
  294. *
  295. *      After adding the keyword, run CMVERIFY on the
  296. *      configuration file to verify the changes.  Communications
  297. *      Manager can then be started.
  298. *
  299. *    2. UPDATING VIA A RESPONSE FILE:
  300. *      A new keyword, PACING_TYPE, was added to the MODE record
  301. *      for CID response files.  This keyword has values of:
  302. *
  303. *        0 = Adaptive Pacing, 1 = Fixed Pacing
  304. *
  305. *      The default is 0.  The following example can be used
  306. *      in a CID response file to change an existing mode to
  307. *      use fixed pacing:
  308. *
  309. *      Example: MODE = (
  310. *                        NAME = mode1
  311. *                        PACING_TYPE = 1
  312. *                      )
  313. *
  314. *
  315. *
  316. *    JR08314: LU62 Sessions remain active even when not needed.
  317. *
  318. * Previous to this APAR, Communications Manager/2 did not free LU6.2
  319. * sessions even after they were no longer needed.This APAR fix allows one to
  320. * modify the Communications Mgr/2 configuration file with a new
  321. * parameter known as FREE_UNUSED_SESSIONS. You may invoke
  322. * this new function as follows:
  323. *
  324. * Determine the name of your Communications Manager/2 configuration
  325. * file. If you do not know the name, execute the command CMQUERY
  326. * at an OS/2 command prompt while Communications Manager/2 is running.
  327. * CMQUERY will return the name of the active configuration.
  328. * For this example, assume the name is CMBASE.
  329. *
  330. * From an OS/2 window edit the file CMBASE.NDF, found in the
  331. * CMLIB directory (where CMBASE is the name of YOUR Communications
  332. * Manager/2 configuration file).
  333. *
  334. * The CMBASE.NDF file is an ASCII file that is readable. The first
  335. * section in this file shows the DEFINE_LOCAL_CP verb and the
  336. * associated parameters. See example below:
  337. *
  338. *  DEFINE_LOCAL_CP  FQ_CP_NAME(USIBMNR.MYCPNAME  )
  339. *                   DESCRIPTION(Created on 01-15-93 at 02:31p)
  340. *                   CP_ALIAS(MYCPNAME )
  341. *                   NAU_ADDRESS(INDEPENDENT_LU)
  342. *                   NODE_TYPE(EN)
  343. *                   NODE_ID(X'05D512A0')
  344. *                   NW_FP_SUPPORT(NONE)
  345. *                   HOST_FP_SUPPORT(YES)
  346. *                   HOST_FP_LINK_NAME(HOST0001)
  347. *   add------------>FREE_UNUSED_SESSIONS(YES)
  348. *                   MAX_COMP_LEVEL(NONE)
  349. *                   MAX_COMP_TOKENS(0)
  350. *
  351. * Notice the 'add--------------->' indicator. This shows the new line
  352. * that must be added to invoke this new function. Only enter the
  353. * FREE_UNUSED_SESSIONS(YES) parameter (add---------------> is just to
  354. * show you where the parameter is inserted).
  355. *
  356. * After adding the new line parameter, SAVE the change and then
  357. * perform a C:\CMVERIFY CMBASE /e
  358. * This will verify the configuration file change. Upon successful
  359. * verification, STOP and RESTART Communications Manager/2 to invoke
  360. * the new function.
  361. *
  362. *
  363. *
  364. *    JR08473:  SNA Gateway feature reactivation of HOST link
  365. *
  366. * When a downstream workstation connects to the Communications Manager/2
  367. * SNA GATEWAY, and the link to the Host fails to activate,
  368. * and the maximum activate links is exceeded, Communications Manager/2
  369. * will retry the host link once every 30 minutes, rather than
  370. * retry as each downstream workstation connects in to the SNA
  371. * GATEWAY.
  372. *
  373. *******************************************************************
  374. *
  375. * Installation instructions:
  376. *
  377. *   1) Make a temporary directory, for example C:\cmtemp,
  378. *      the instructions will use c:\cmtemp as the example.
  379. *
  380. *   2) Download the files(s) in binary to your computer to C:\cmtemp
  381. *
  382. *   3) Execute the following command from c:\cmtemp:
  383. *        PKUNZIP2 cm2ap111.zip
  384. *      Three files will be unzipped into the C:\cmtemp directory,
  385. *      CM2ABASE.ZIP, CM2BBASE.ZIP and ANYNET.ZIP.
  386. *
  387. *      The reason for the three zip files is that CM2AP111.ZIP will
  388. *      not fit on a single diskette.  If you need to apply the
  389. *      APAR fixtest to another workstation via diskettes, you can
  390. *      copy CM2ABASE.ZIP, CM2BBASE.ZIP and ANYNET.ZIP onto diskettes.
  391. *      Next take the diskettes and copy the zip files
  392. *      into C:\cmtemp on the other workstation.  Then continue
  393. *      with the installation instructions on the other workstation.
  394. *
  395. *   4) Stop Communications Manager, Communications Manager's
  396. *      Subsystem Management, all transaction programs (programs using the Communications
  397. *      Manager application programming interfaces).
  398. *      Stop and Close the Communications Manager trace facility.
  399. *      and exit all FFST/2 displays.
  400. *
  401. *   5) At an OS/2 prompt enter: CMKFMSMI 0    (This stops the Communications Manager
  402. *      Frame manager that is started in config.sys)
  403. *
  404. *   6) Back up the following files in the following directories:
  405. *
  406. *       cmlib\acsapldr.exe
  407. *       cmlib\cmmh.msg
  408. *       cmlib\cmm.msg
  409. *       cmlib\lulist.exe
  410. *       cmlib\lutpm.exe
  411. *       cmlib\pluverb.h
  412. *       cmlib\lutpm.hlp
  413. *       cmlib\cmstart.exe
  414. *       cmlib\remmain.exe
  415. *       cmlib\cmverify.txt
  416. *       cmlib\cml2a.srv
  417. *       cmlib\cmpd.cmd
  418. *       cmlib\cmpd.pak
  419. *       cmlib\appnv.ctl
  420. *       cmlib\cmkfmsmi.exe
  421. *       cmlib\cmkfmde.sys
  422. *       cmlib\appnp.hlp
  423. *       cmlib\appnp.pml
  424. *       cmlib\appnp.pdl
  425. *       cmlib\dll\appc.dll
  426. *       cmlib\dll\cmkfmapi.dll
  427. *       cmlib\dll\appnutl.dll
  428. *       cmlib\dll\acsgwscp.dll
  429. *       cmlib\dll\appncfg4.dll
  430. *       cmlib\dll\acsrui.dll
  431. *       cmlib\dll\acssli.dll
  432. *       cmlib\dll\appncfg.dll
  433. *       cmlib\dll\ccdmain.dll
  434. *       cmlib\dll\acs3elue.dll
  435. *       cmlib\dll\acs3evs.dll
  436. *       cmlib\dll\acsipx.dll
  437. *       cmlib\dll\cpic.dll
  438. *       cmlib\dll\acsmptn.dll
  439. *       cmlib\dll\acssvc.dll
  440. *       cmlib\dll\lutab.dll
  441. *       cmlib\dll\acsrastd.dll
  442. *       cmlib\dll\cmfreedl.dll
  443. *       cmlib\dll\remapi.dll
  444. *
  445. *     It is possible that some of these files will not be present on
  446. *     your system, depending on your configuration.
  447. *
  448. *
  449. *   7) Execute the following command from the cmtemp subdirectory:
  450. *
  451. *        PKUNZIP2 -d -o cm2abase.zip C:\
  452. *
  453. *      where C: is the drive where Communications Manager/2 is installed. You
  454. *      should change this if Communications Manager/2 is installed on a
  455. *      different drive.  The zip file is created such that the files will be
  456. *      placed into cmlib and cmlib\dll in the specified drive.
  457. *
  458. *   8) Execute the following command from the cmtemp subdirectory:
  459. *
  460. *        PKUNZIP2 -d -o cm2bbase.zip C:\
  461. *
  462. *      where C: is the drive where Communications Manager/2 is installed. You
  463. *      should change this if Communications Manager/2 is installed on a
  464. *      different drive.  The zip file is created such that the files will be
  465. *      placed into cmlib and cmlib\dll in the specified drive.
  466. *
  467. *   9) If you are using ANYNET with Communications Manager/2 then
  468. *      execute the following command from the cmtemp subdirectory:
  469. *
  470. *        PKUNZIP2 -d -o anynet.zip C:\
  471. *
  472. *      where C: is the drive where Communications Manager/2 is installed. You
  473. *      should change this if Communications Manager/2 is installed on a
  474. *      different drive.  The zip file is created such that the files will be
  475. *      placed into cmlib and cmlib\dll in the specified drive.
  476. *
  477. *  10) Reboot the workstation.
  478. *
  479. *  11) Communications Manager/2, and the other stopped functions can now be
  480. *      restarted.
  481. *
  482. *******************************************************************
  483. *b010/p072
  484. *******************************************************************
  485. CM2AP111 ZIPBIN *
  486.