home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 29 Fixes_o / 29-Fixes_o.zip / ld8175b1.dsk / IP08175.INF (.txt) < prev    next >
OS/2 Help File  |  1995-12-13  |  65KB  |  1,811 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4.               IBM OS/2 LAN Distance 1.1 and 1.11 ServicePak IP08175
  5.                                  IBM PTF IP08175
  6.  
  7. This ServicePak applies to:
  8.  
  9. IBM LAN Distance Connection Server for OS/2, 8 port - Version 1.1 and 1.11
  10. For use with OS/2 2.0 or higher.
  11.  
  12. IBM LAN Distance Connection Server for OS/2 - Version 1.1 and 1.11
  13. For use with OS/2 2.0 or higher.
  14.  
  15. IBM LAN Distance Remote for OS/2 - Version 1.1 and 1.11
  16. For use with OS/2 2.0 or higher.
  17.  
  18. IBM LAN Distance Remote for Windows - Version 1.1 and 1.11
  19. For use with MicroSoft Windows 3.1 or higher.
  20.  
  21. Installation instructions for IBM LAN Distance Remote for Windows fixes and 
  22. enhancements can be found in the 8175WIN.RME file located on the first diskette 
  23. of this ServicePak.  Installation instructions for the OS/2 versions of LAN 
  24. Distance are in the next section of this document. 
  25.  
  26. Some of the new features/enhancements include LAN Distance related changes in 
  27. the LAN Adapter and Protocol Support directory tree (IBMCOM.) 
  28.  
  29. Warning:   - Please review the entire Installation section before proceeding. 
  30. Service to workstations with LAN Servers which use "Advanced Features" can be 
  31. complex. 
  32.  
  33.                                  Good Insurance!
  34.              Have appropriate Bootable Standalone Service Diskettes.
  35.  
  36.  
  37. ΓòÉΓòÉΓòÉ 1.1. Affected SYSLEVEL Files ΓòÉΓòÉΓòÉ
  38.  
  39. SYSLEVEL.LDA          IBM OS/2 LAN Distance Connection Server (Advanced) 
  40. SYSLEVEL.LDE          IBM OS/2 LAN Distance Connection Server, 8 port (Entry) 
  41. SYSLEVEL.LDR          IBM OS/2 LAN Distance Remote 
  42.  
  43.  
  44. ΓòÉΓòÉΓòÉ 1.2. Trademarks ΓòÉΓòÉΓòÉ
  45.  
  46. The following are trademarks of IBM Corporation: 
  47.  
  48. o IBM 
  49. o LAN Distance 
  50. o LAN Support Program 
  51. o LANStreamer 
  52. o Operating System/2 
  53. o OS/2 
  54. o PC LAN Program 
  55. o Presentation Manager 
  56. o Win-OS/2 
  57.  
  58. The following are trademarks of other Corporations: 
  59.  
  60. o AttachMate  (Attachmate Corporation) 
  61. o Chameleon  (NetManage) 
  62. o LAN Workplace for DOS  (Novell, Inc.) 
  63. o Microcom  (Microcom, Inc.) 
  64. o Microsoft  (Microsoft Corporation) 
  65. o MSNET  (Microsoft Corporation) 
  66. o NetWare  (Novell, Inc.) 
  67. o Pentium  (Intel Corporation) 
  68. o Ungermann-Bass  (Ungermann-Bass, Inc.) 
  69. o VINES  (Banyan Systems, Inc.) 
  70. o Windows  (Microsoft Corporation) 
  71.  
  72.  
  73. ΓòÉΓòÉΓòÉ 2. Installation ΓòÉΓòÉΓòÉ
  74.  
  75. This ServicePak uses Corrective Service Facility (CSF) Version 2-B (provided on 
  76. the tool diskette of this ServicePak) for installation. 
  77.  
  78. Complete instructions for the use of the updated SERVICE and FSERVICE commands 
  79. are provided with the CSF Version 2-B README.INF file on the ServicePak Tool 
  80. Diskette. Please read the CSF instructions for information on the use of CSF 
  81. Version 2-B backup and restore capabilities. 
  82.  
  83. Note:   - Archiving is not enabled for this ServicePak. 
  84.  
  85. Installing the ServicePak is essentially a three phase process: 
  86.  
  87. Phase 1 - Quiesce the Target System 
  88.             Stop all running applications so that LAN Server/Requester is not 
  89.             in use. (This includes doing a 'net stop server'). 
  90.  
  91. Phase 2 - Install the ServicePak 
  92.             Use one of the following methods to replace system files with those 
  93.             provided on this ServicePak: 
  94.             Selective Install 
  95.             Redirected (CID) Install 
  96.  
  97. Phase 3 - Return the Serviced System to Normal Operation 
  98.             Perform a normal system boot. 
  99.  
  100.  
  101. ΓòÉΓòÉΓòÉ 2.1. Selective Install ΓòÉΓòÉΓòÉ
  102.  
  103. This method will apply fixes to selected subsystems, partitions, and 
  104. directories: The Corrective Service Facility will handle Locked Files 
  105. automatically so boot diskettes are not required before applying service. 
  106.  
  107.  1. At an OS/2 command prompt, perform a 'net stop server'. 
  108.  2. Insert ServicePak Tool diskette in the A drive. 
  109.  3. At an OS/2 command prompt, type "A:ARCHOFF" to execute this pre-install 
  110.     program (if you haven't already done so). 
  111.  4. At an OS/2 command prompt, type "A:SERVICE" and press Enter. 
  112.  5. Insert ServicePak diskette 1 when prompted. 
  113.  6. Follow the prompts to the CSF SERVICEABLE PRODUCTS panel. Review the 
  114.     serviceable products selected on the panel and deselect any products that 
  115.     you do not want to service at this time.  Then choose the SERVICE push 
  116.     button. 
  117.  7. Enter (optional) backup path then choose the OK push button. 
  118.  8. If the APPLICATION IN USE locked files panel is presented, choose CONTINUE. 
  119.  9. Follow prompts to complete the process. 
  120. 10. Remove the diskette from drive A:, then perform the system Shutdown 
  121.     procedure. 
  122. 11. Reboot the system normally. 
  123.  
  124. If the system to be serviced is a multiboot system with LAN Advanced Server 
  125. using IBM386FS on a drive other than the "C" drive, use the Special Situation 
  126. Install method to complete the installation on each bootdrive. 
  127.  
  128. When problems such as insufficient disk space are encountered when performing 
  129. the Selective Install, use the Special Situation Install method to perform 
  130. service. 
  131.  
  132.  
  133. ΓòÉΓòÉΓòÉ 2.2. Redirected Installation (CID) Method ΓòÉΓòÉΓòÉ
  134.  
  135. This method is useful for those who are using the CID (Configuration, 
  136. Installation, and Distribution) Services as provided by IBM MPTS. The Selective 
  137. Install method is recommended for Servers exploiting 386 HPFS function, Fault 
  138. Tolerance, and/or Local Security. 
  139.  
  140. CAUTION:
  141. Before using FSERVICE to apply corrective service, review the sample response 
  142. file (RESPONSE.FIL) located on the Service Tool diskette. Edit the 
  143. RESPONSE.FIL, if necessary, to ensure the service logfile is created in the 
  144. correct location on the target workstation. 
  145.  
  146.    :LOGFILE d:\os2\install\SERVICE.LOG
  147.    where d:\os2\install is the drive and location for the service logfile.
  148.  
  149. While setting up a CID server is beyond the scope of this document, we have 
  150. provided a sample LAN CID Utility REXX Command file segment (IP_8175.CID) that 
  151. may prove useful in setting up a CID server for this ServicePak. 
  152.  
  153. The sample IP_8175.CID assumes the following: 
  154.  
  155. o The ServicePak Tool diskette files are placed on the code server using "XCOPY 
  156.   A:\*.* /S" (or equivalent) in 'x:\img\csd\landist\ip_8175' where 'x:' is the 
  157.   drive seen by the client. 
  158.  
  159. o The ServicePak files are placed on the code server using "XCOPY A:\*.* /S" 
  160.   (or equivalent) in 'x:\img\csd\landist\ip_8175.' 
  161.  
  162. o The sample RESPONSE.FIL (or equivalent) is placed on the code server in 
  163.   x:\rsp\csd\landist\ip_8175. 
  164.  
  165. o The following CID server directory structure contains the contents of the 
  166.   ServicePak and the tool diskette. 
  167.  
  168.    img\csd\landist\ip_8175            * Root directory of ServicePak diskette 1 
  169.    img\csd\landist\ip_8175            * ServicePak Tool diskette files 
  170.    img\csd\landist\ip_8175\FIX        * No files 
  171.    img\csd\landist\ip_8175\FIX\LDA    * 32 Port Server Fixes 
  172.    img\csd\landist\ip_8175\FIX\LDE    * 8 Port Server Fixes 
  173.    img\csd\landist\ip_8175\FIX\LDR    * Remote Workstation Fixes 
  174.  
  175. o A log directory exists at 'x:\log\csd\landist\ip_8175' for the log files. 
  176.  
  177.  
  178. ΓòÉΓòÉΓòÉ 2.3. Bootable Standalone Service Diskettes ΓòÉΓòÉΓòÉ
  179.  
  180. Sometimes it becomes necessary to boot from diskette in order to perform 
  181. certain operations on fixed-disk, like installing this ServicePak or running 
  182. CHKDSK /f. 
  183.  
  184. All necessary files must be contained on diskette.  Files from the fixed-disk 
  185. should not be referenced in A:\CONFIG.SYS or A:STARTUP.CMD. Otherwise Locked 
  186. Files can still exist on the fixed-disk. 
  187.  
  188. Should the need arise to boot from diskette for any reason, you may: 
  189.  
  190. o Use the Install diskette and Diskette 1 of OS/2 2.x or OS/2 3.x. Escape to A: 
  191.  
  192. o Create custom Bootable Standalone Service Diskettes from your licensed 
  193.   materials.  The makeup of these is dependent on the system to be serviced. 
  194.   Instruction is available for: 
  195.  
  196.    Requesters and Entry Version Servers. 
  197.    Advanced Version Servers. 
  198.  
  199. CAUTION:
  200. LAN Servers that utilize the Advanced features such as Local Security and Fault 
  201. Tolerance must use custom Bootable Standalone Service Diskettes.  Regular HPFS 
  202. boot diskettes, such as the OS/2 Installation diskettes, CANNOT mirror changes 
  203. to Fault Tolerance partitions or access files/directories which are controlled 
  204. by local security. 
  205.  
  206.  
  207. ΓòÉΓòÉΓòÉ 2.3.1. Making OS/2 Bootable Diskettes ΓòÉΓòÉΓòÉ
  208.  
  209. Instructions for creating OS/2 bootable diskettes for Requesters and Entry 
  210. Version Servers are dependent on the OS/2 version. 
  211.  
  212. o For OS/2 2.x versions: 
  213.  
  214.     1. Make a copy of the OS/2 2.x Installation Diskette and Diskette 1. Call 
  215.        them SA1 and SA2 respectively. 
  216.  
  217.     2. Delete SYSINST2.EXE from Diskette SA2. 
  218.  
  219.     3. Delete BUNDLE from Diskette SA2 (this will be on OS/2 versions 2.1 or 
  220.        greater). 
  221.  
  222.     4. Modify CONFIG.SYS on SA2 as follows: 
  223.  
  224.               buffers=50
  225.               memman=noswap
  226.               protshell=a:\cmd.exe
  227.               protectonly=yes
  228.               libpath=a:\;
  229.               ifs=hpfs.ifs /c:64
  230.               set path=a:\;
  231.               set dpath=a:\;
  232.  
  233.     5. Copy UHPFS.DLL from OS/2 Diskette 2 or C:\OS2\DLL to SA2. 
  234.  
  235. o For OS/2 3.x versions: 
  236.  
  237.   Use the Install diskette and Diskette 1 of OS/2 3.x.  Escape to A: 
  238.  
  239.  
  240. ΓòÉΓòÉΓòÉ 2.3.2. Making Advanced Server Bootable Diskettes ΓòÉΓòÉΓòÉ
  241.  
  242. MAKEDISK is an Advanced Server utility designed to make the necessary Bootable 
  243. Standalone Service Diskettes used in periodic maintenance of 386 HPFS systems. 
  244.  
  245.  1. Make a copy of the OS/2 2.x or 3.x Installation Diskette and Diskette 1. 
  246.     Call them SA1 and SA2 respectively. 
  247.  
  248.  2. Delete SYSINST2.EXE from Diskette SA2. 
  249.  
  250.  3. Delete BUNDLE from Diskette SA2 (this will be on OS/2 versions 2.1 or 
  251.     greater). 
  252.  
  253.  4. With Boot Diskette SA2 in drive a: or b: run MAKEDISK from an OS/2 prompt. 
  254.  
  255.     Note:   Syntax is MAKEDISK /BOOTDRIVE:d where d  is the OS/2 boot drive. 
  256.  
  257.     For additional Information see the Network Administrators Reference: 
  258.     Creating a 386 HPFS Boot Diskette, or LAN Server Utilities. 
  259.  
  260.  5. If using Fault Tolerance, add the Fault Tolerance files to the Bootable 
  261.     Diskette SA2. 
  262.  
  263.  6. Ensure the country code, codepage, and the keyboard information in the 
  264.     config.sys file on the boot diskette matches the corresponding information 
  265.     on the target workstation's config.sys. Verify that the 386 HPFS Bootable 
  266.     Standalone Service Diskettes work properly and that, after rebooting, Local 
  267.     Security and Fault Tolerance are working as expected. 
  268.  
  269.  
  270. ΓòÉΓòÉΓòÉ 2.3.3. Adding Fault Tolerance to 386 HPFS Bootable Standalone Service Diskettes ΓòÉΓòÉΓòÉ
  271.  
  272. 386 HPFS Bootable Standalone Service diskettes require additional customizing 
  273. in order to properly update files on partitions which are mirrored. 
  274.  
  275. The following steps may have to be done for each LAN Server with Fault 
  276. Tolerance since the configuration information transferred in step 3 can be 
  277. unique for each such system. 
  278.  
  279.  1. Copy the following four Fault Tolerance files from the first diskette of 
  280.     the LAN Server 4.0 ServicePak to your Bootable Standalone Service Diskette 
  281.     SA2. 
  282.  
  283.               1) DISKFT.SYS  2) FTD.MSG  3) FTATTRIB.EXE  4) FTCOPY.CMD
  284.  
  285.  2. Add the following line to the CONFIG.SYS on the Bootable Standalone Service 
  286.     Diskette SA2. 
  287.  
  288.                                   DEVICE=DISKFT.SYS
  289.  
  290.  3. At an OS/2 command prompt, make the current drive A:, and have the 386 HPFS 
  291.     Bootable Standalone Service Diskette SA2 in drive A. Type "FTCOPY" to copy 
  292.     the customized Fault Tolerance configuration information to the 386 HPFS 
  293.     Bootable Standalone Service Diskette SA2. 
  294.  
  295. Warning:  Ensure the country code, codepage, and the keyboard information in 
  296. the config.sys file on the boot diskette matches the corresponding information 
  297. on the target workstation's config.sys. Test your 386 HPFS Bootable Standalone 
  298. Service Diskette before you make any alterations to your system.  This Diskette 
  299. is the Master Key should your system ever fail to boot from its hard drive. 
  300.  
  301.  
  302. ΓòÉΓòÉΓòÉ 2.4. Special Situation Install ΓòÉΓòÉΓòÉ
  303.  
  304. This method will apply all fixes to all partitions and directories: 
  305.  
  306. FSERVICE is used for CID installation of this ServicePak, for multiboot systems 
  307. with IBM386FS on a drive other than the 'C' drive, or when problems, such as 
  308. insufficient memory for the locked file device driver or corrupted disk drives, 
  309. are encountered using the Selective Install method. It does require booting 
  310. from diskette to insure that there are no Locked Files during the install 
  311. phase. 
  312.  
  313. Warning:   - Ensure that all drives to be updated are clean by performing a 
  314. CHKDSK /F on each drive before FSERVICE is invoked.  There will be no 
  315. opportunity to clean up the drives after FSERVICE is invoked. 
  316.  
  317.  1. Review the FSERVICE Response File (RESPONSE.FIL on the ServicePak tool 
  318.     diskette) and modify as needed to reflect the configuration of the system 
  319.     to be serviced. Ensure the service logfile is created in the correct 
  320.     location on the target workstation. 
  321.  
  322.            :LOGFILE d:\os2\install\SERVICE.LOG
  323.            where d:\os2\install is the drive and location for the service logfile.
  324.  
  325.  2. Boot from the Bootable Standalone Service Diskettes. 
  326.  3. Establish A: as the Current Directory. 
  327.  4. Replace the Boot Diskette with the ServicePak Tool Diskette. 
  328.  5. From the A: prompt, type "ARCHOFF" and press enter to execute a pre-install 
  329.     program (if you haven't already done so). 
  330.  6. From the A: prompt, type "FSERVICE" and press Enter.  Click here for 
  331.     additional steps needed for multi-boot systems. 
  332.  7. At the panel titled "Installing this Service Pak" press Enter (Option 1). 
  333.  8. Follow the prompts provided by the Corrective Service Facility. 
  334.  9. Reboot the system normally. 
  335.  
  336.  
  337. ΓòÉΓòÉΓòÉ 2.4.1. Updating IBM386FS Directory on a Multiboot System ΓòÉΓòÉΓòÉ
  338.  
  339. A new parameter has been added to the FSERVICE command to enable servicing the 
  340. IBM386FS directory when it resides on a bootdrive other than C:.  Specify the 
  341. bootdrive containing the IBM386FS directory to be serviced as the /b parameter 
  342. on the FSERVICE command: 
  343.  
  344.             FSERVICE /b:d
  345.               (where d is the drive letter assigned to bootdrive)
  346.  
  347. Note:   There is NO colon after the bootdrive 'd'. 
  348.  
  349. Two methods are available for servicing the IBM386FS directories on multiple 
  350. bootable drives: 
  351.  
  352.  1. Run FSERVICE iteratively. That is, run FSERVICE /b: for each bootable drive 
  353.     containing an IBM386FS directory. 
  354.  
  355.  2. Edit the RESPONSE.FIL (on the Tool diskette of this ServicePak) to add the 
  356.     following parameter set after the :SYSLEVEL label: 
  357.  
  358.         :DIRLIST
  359.         d1:\IBM386FS   where d1 = a bootable drive requiring IBM386FS service,
  360.         d2:\IBM386FS   and  d2 = another bootable drive requiring IBM386FS service.
  361.         :ENDDIRLIST
  362.  
  363.  
  364. ΓòÉΓòÉΓòÉ <hidden> Locked Files ΓòÉΓòÉΓòÉ
  365.  
  366. Sometimes it is essential that programs own (become the master of) system 
  367. resources such as Memory Blocks, Communication Ports, and Files. When a program 
  368. stakes claim to a file, that file is said to be Locked; no other program is 
  369. allowed to alter (replace or write to) it until the owning program explicitly 
  370. removes the lock. 
  371.  
  372. .DLL Files  can become Locked by residing in a directory that is included in 
  373. the LIBPATH string of CONFIG.SYS. 
  374.  
  375. For example, NETAPI.DLL can be locked when \MUGLIB\DLL exists in the LIBPATH of 
  376. CONFIG.SYS. 
  377.  
  378.  
  379. ΓòÉΓòÉΓòÉ <hidden> Escape to A: from OS/2 Install Diskettes ΓòÉΓòÉΓòÉ
  380.  
  381. To obtain the A:  prompt when using the OS/2 Product installation diskettes as 
  382. Bootable Standalone Service Diskettes: 
  383.  
  384. o Boot the system with Install Diskette in drive A. 
  385.  
  386. o At the IBM Logo Screen - Insert Diskette 1, press Enter. 
  387.  
  388. o At the Welcome Screen - Press Esc to Exit. (F3 for OS/2 3.x) 
  389.  
  390. The A: prompt should appear.  OS/2 Programs, including FSERVICE.EXE, can be run 
  391. from here. 
  392.  
  393.  
  394. ΓòÉΓòÉΓòÉ <hidden> Creating a 386 HPFS Boot Diskette Refer to ΓòÉΓòÉΓòÉ
  395.  
  396. Appendix H in: 
  397.  
  398.                                     Operating System/2 Local Area Network Server
  399.  
  400.                          Network Administrator Reference Volume 1:  Planning and
  401.                                                                     Installation
  402.  
  403.                                                                      Version 4.0
  404.  
  405.  
  406. ΓòÉΓòÉΓòÉ <hidden> LAN Server Utilities ΓòÉΓòÉΓòÉ
  407.  
  408. Refer to Appendix B, Miscellaneous Utilities MAKEDISK in:
  409.  
  410.                                     Operating System/2 Local Area Network Server
  411.  
  412.                 Network Administrator Reference Volume 3:  Network Administrator
  413.                                                                            Tasks
  414.  
  415.                                                                      Version 4.0
  416.  
  417.  
  418. ΓòÉΓòÉΓòÉ 3. Known Problems and Restrictions ΓòÉΓòÉΓòÉ
  419.  
  420. This section discusses restrictions known about the LAN Distance product at the 
  421. time this ServicePak was shipped. 
  422.  
  423.  
  424. ΓòÉΓòÉΓòÉ 3.1. MPTS ΓòÉΓòÉΓòÉ
  425.  
  426. To use MPTS with the LAN Distance product, you must have MPTS Version 2.60.2 or 
  427. later. 
  428.  
  429. NOTE:  LAN Server 4.0 is shipped with MPTS Version 2.60.2. 
  430.  
  431. NetBIOS 3.0 interface (provided with MPTS) supports only four adapters. If four 
  432. NetBIOS logical adapters are configured before LAN Distance installation or 
  433. configuration, LAN Distance will assign VLAN MAC (PDFH.NIF) the fifth NetBIOS 
  434. logical adapter number.  Since this fifth adapter is not supported by MPTS, you 
  435. must delete one of the previous NetBIOS logical adapter configurations, then 
  436. configure VLAN MAC through MPTS configuration. 
  437.  
  438. The VLAN MAC must also be configured through MPTS configuration if NetBIOS is 
  439. not configured before LAN Distance installation or during LAN Distance 
  440. configuration. 
  441.  
  442.  
  443. ΓòÉΓòÉΓòÉ 3.2. LAN Server 4.0 with LAN Distance Advanced Server ΓòÉΓòÉΓòÉ
  444.  
  445. When running IBM LAN Server/Requester 4.0 with IBM LAN Distance Advanced Server 
  446. you may experience problems with insufficient NETBIOS resources.  Two possible 
  447. symptoms indicate this problem: 
  448.  
  449. o When starting LAN Distance, error message WCL554 appears stating that the LAN 
  450.   Distance product requires more NETBIOS resources than are available. 
  451.  
  452. o The NETBIOS protocol does not load at system startup. 
  453.  
  454. If either of these symptoms occur, the following steps are recommended: 
  455.  
  456. NOTE:  Restart your workstation after each step to see if the problem is 
  457. solved. If the problem remains, try the next step. 
  458.  
  459.  1. Remove any unnecessary NETBIOS applications. 
  460.  
  461.  2. Edit the \IBMLAN\IBMLAN.INI file. 
  462.  
  463.     In the [Network] section, reduce the number of NCBs.  See example below: 
  464.  
  465.                                           |
  466.                                           V
  467.            NETx=NETBEUI$, 0, LM10, yyy , 175, zzz
  468.  
  469.            to
  470.                                           |
  471.                                           V
  472.            NETx=NETBEUI$, 0, LM10, yyy , 125, zzz
  473.  
  474.            where x   = 1,2....
  475.                  yyy = Number of Netbios Sessions
  476.                  zzz = Number of Netbios Names
  477.  
  478.  3. Determine the maximum number of calls that are expected to dial into the 
  479.     LAN Distance server at any one time. 
  480.  
  481.    o Edit the \WAL\WCLLOCAL.INI file with any ASCII editor. 
  482.  
  483.    o Under [SRDDEFS] reduce the SESSIONS = parameter from 32 to the maximum 
  484.      number of calls. 
  485.  
  486.      For example, if you expect a maximum of 16 calls at any one time, set 
  487.      SESSIONS = 16. 
  488.  
  489.    o Change COMMANDS = 90 to the new SESSIONS value times 3. 
  490.  
  491.      For example, if the new SESSIONS value is 16, then set COMMANDS to 48. 
  492.      This reduces the number of NETBIOS resources that the LAN Distance product 
  493.      will attempt to take when it is started. 
  494.  
  495.            [SRDDEFS]                         [SRDDEFS]
  496.               maxconversations = 10             maxconversations = 10
  497.               adapter  = 2                      adapter  = 2
  498.               sessions = 32            to       sessions = 16
  499.               commands = 90                     commands = 48
  500.               datagram = 6                      datagram = 6
  501.  
  502.  
  503. ΓòÉΓòÉΓòÉ 3.3. Microcom Modem ΓòÉΓòÉΓòÉ
  504.  
  505. The following problems occasionally occur when using the Microcom modem with 
  506. the LAN Distance product: 
  507.  
  508. o After having successfully connected with the Microcom modem, attempts to 
  509.   reconnect with the modem or to connect with another modem have failed. 
  510.  
  511. o The Microcom modem will not initially connect with certain modems. 
  512.  
  513. The following are symptoms of the above problems: 
  514.  
  515. o The modem appears "deaf" to dialing strings. 
  516. o The modem fails to go off hook. 
  517. o The modem DTR signal fails to turn on. 
  518.  
  519. Using other PIF files, specifically MICROPRT.PIF, will alleviate the problems 
  520. in a few cases. 
  521.  
  522. For assistance in using the Microcom modem, please contact your Microcom 
  523. dealer. 
  524.  
  525.  
  526. ΓòÉΓòÉΓòÉ 3.4. Deselecting Manual Bridge Filter ΓòÉΓòÉΓòÉ
  527.  
  528. If you have defined bridge filter on page 2 of the bridge tab in the settings 
  529. notebook on a Connection Server and want to disable the selected filter 
  530. criteria, press the space bar on the keyboard to deselect the active filter. 
  531.  
  532.  
  533. ΓòÉΓòÉΓòÉ 3.5. Communications Manager/2 V1.11 ΓòÉΓòÉΓòÉ
  534.  
  535. If you are installing or upgrading to Communications Manager/2 V1.11 please 
  536. note the following: 
  537.  
  538. o To use the "SNA Phone Connections" feature of CM/2 V1.11 on the same machine 
  539.   with "LAN Distance using PSTN", you must get a CM/2 fix through IBM Service 
  540.   and Support by referencing APAR JR08194. 
  541.  
  542. o To use "LAN Distance using ISDN", follow these steps: 
  543.  
  544.     1. Backup NETWORK.INI by renaming \CMLIB\NETWORK.INI to \CMLIB\NETWORK.BAK. 
  545.        This prevents you from using the "SNA Phone Connections" feature of CM/2 
  546.        V1.11. 
  547.  
  548.     2. Reinstall the ISDN Coprocessor Support Program Version V1.2 software. 
  549.  
  550.     3. Reconfigure LAN Distance using ISDN. 
  551.  
  552.  
  553. ΓòÉΓòÉΓòÉ 3.6. ES 1.0 Communications Manager ΓòÉΓòÉΓòÉ
  554.  
  555. If ES Communciations Manager is on a machine with LAN Distance, the following 
  556. messages may be received after installing LAN Distance and rebooting: 
  557.  
  558. o MaxFrameSize is too small 
  559.  
  560. o General Failure when program tried to bind BRIDGE$ to vector 
  561.  
  562. This problem can be corrected by changing the IBMTOK_nif section of 
  563. PROTOCOL.INI to remove the XMITBUFSIZE= statement. 
  564.  
  565.  
  566. ΓòÉΓòÉΓòÉ 4. Things that Changed ΓòÉΓòÉΓòÉ
  567.  
  568. The following sections describe changes that have been made to the product's 
  569. executables, and messages/helps. 
  570.  
  571.  
  572. ΓòÉΓòÉΓòÉ 4.1. Publication Addendum ΓòÉΓòÉΓòÉ
  573.  
  574. This section discusses corrections/additions to the publications. 
  575.  
  576.  
  577. ΓòÉΓòÉΓòÉ 4.1.1. Redirected Install of LAN Distance Remote Workstations ΓòÉΓòÉΓòÉ
  578.  
  579. The LAN Distance Advanced Guide, Installing the Product (Chapter 4) section 
  580. "Steps to Install from a Redirected Drive Using a Response File" states for LAN 
  581. Distance Remotes, after you restart the workstation, the workstation is 
  582. automatically set up to operate as a stand-alone LAN Distance Remote.  This is 
  583. incorrect. 
  584.  
  585. When installing a LAN Distance Remote workstation from a redirected drive using 
  586. a response file, after restarting, the workstation will continue to be 
  587. configured as a LAN workstation.  To use the workstation as a stand-alone LAN 
  588. Distance Remote workstation, use the shuttle feature to switch from a LAN 
  589. workstation to a Remote workstation configuration. 
  590.  
  591.  
  592. ΓòÉΓòÉΓòÉ 4.1.2. IBM7855.EXE Tool ΓòÉΓòÉΓòÉ
  593.  
  594. The IBM7855.EXE tool used to externally configure the IBM 7855 Modem is 
  595. available from these sources: 
  596.  
  597. o CompuServ users can access the PSPAPROD forum and access this file in the LAN 
  598.   Distance product's library section. 
  599.  
  600. o Users with access to IBMLink through OS2BBS can access this file in the 
  601.   REMOTE section of the OS/2 Software Library (3). 
  602.  
  603.  
  604. ΓòÉΓòÉΓòÉ 4.1.3. Configuring a LAN Distance Remote Workstation ΓòÉΓòÉΓòÉ
  605.  
  606. When configuring a LAN Distance Remote Workstation through the Settings 
  607. notebook, the workstation must be shuttled to a Remote Workstation, not a LAN 
  608. workstation. 
  609.  
  610.  
  611. ΓòÉΓòÉΓòÉ 4.2. Fixed APARs ΓòÉΓòÉΓòÉ
  612.  
  613. The following APARs were fixed in this ServicePak for LAN Distance Advanced 
  614. Connection Server. 
  615.  
  616. o APAR= IC07742 LAN DISTANCE SECURITY USER EXIT ENABLEMENT (Fixed in ip07050) 
  617.  
  618.   LAN Distance 1.1 will support any security user exit package developed in 
  619.   conformance with the LAN Distance Generalized Security User Exit API. A LAN 
  620.   Distance Security User Exit development toolkit for OS/2 and Windows will be 
  621.   provided. The toolkit contains: 
  622.  
  623.    - A specification for the LAN Distance Generalized Security User Exit API. 
  624.    - A description of how to install or register a LAN Distance security user 
  625.      exit on LAN Distance workstations. 
  626.    - Sample source code to develop your own LAN Distance security user exit 
  627.      package. A LAN Distance security user exit package consists of a client 
  628.   user exit module and a server user exit module. These modules work together 
  629.   to implement a customer defined user authentication protocol that can 
  630.   restrict access to the LAN and its resources. 
  631.  
  632. o APAR= IC07431 WCLNET.INI FILE INCORRECT FOR CREATED MODEM TYPES (Fixed in 
  633.   ip07050) 
  634.  
  635.   Customer tried to define one modem type per modem. By starting a single modem 
  636.   instead of all modems of the same type, connected users would not be 
  637.   affected. The following steps recreate the problem: 
  638.  
  639.     1. Create a port and assign a modem. Specify you want to create a new type. 
  640.        Change the title to be unique. 
  641.     2. Close settings and stop LAN Distance. Start the system again. 
  642.     3. Create another port. Go to the modem panel. Notice COM1 is listed in the 
  643.        Assignments for modem types box. 
  644.     4. Assign a modem to COM2 using the same modem type as a model. 
  645.     5. Select the Create new modem type box and change the type so that it is 
  646.        unique. 
  647.     6. Close the windows and return to the Assignments for modem types list. 
  648.        Only COM2 is listed. COM1 is deleted and the WCLNET.INI file is 
  649.        incorrect. Note, this does not occur without the reboot in the middle. 
  650.   The WCLNET.INI file is correct if you define COM1, COM2, COM3, assign each 
  651.   COM port a modem in the Create a new definition box, and change the title. 
  652.   The broken WCLNET.INI file follows: 
  653.  
  654.      DONOTREMOVE
  655.       KEYWORD = VALUE
  656.      REMOTELAN01
  657.       DLL = WCLVPCM
  658.       ENTRY = StartVPCM
  659.       AUTOSTART = YES
  660.       PIF = USRSPO01.PIF
  661.       TITLE = USRobotics Sportster 14400 Modem 02
  662.       PCMNAME = USRSPO01
  663.      USRSPO01
  664.       DialogType = "ATCMD.DDF"
  665.       PortName = "COM2"
  666.       PermConnection = "NO"
  667.       PhoneNumber = "Unspecified"
  668.       Synchronicity = "Asynchronous"
  669.       ModemClass = "V.32bis"
  670.       AutoBaudDetect = "Off"
  671.       SerialPortSpeed = 38400
  672.       FlowControl = "RTS/CTS"
  673.       Initialization1 = "ATB0E1F1M3Q0V1X4&A3&B1&C1&D2\CR"
  674.       Initialization2 = "AT&H1&I0&K1&M4&N0&R2&S1S0=2\CR"
  675.       DialPrefix = "ATDT"
  676.       DialSuffix = "\CR"
  677.       Success = "OK\CR\LF"
  678.       Failure = "ERROR\CR\LF"
  679.       ConnectPrefix = "CONNECT"
  680.       ConnectSuffix = "\CR\LF"
  681.       Escape = "+++"
  682.       Hangup = "ATH\CR"
  683.       RingBack = "RING\CR\LF"
  684.       Busy = "BUSY\CR\LF"
  685.       NoCarrier = "NO CARRIER\CR\LF"
  686.       NoDialtone = "NO DIALTONE\CR\LF"
  687.       NoAnswer = "NO ANSWER\CR\LF"
  688.       Voice = "VOICE\CR\LF"
  689.       Ring = "RING\CR\LF"
  690.      REMOTELAN02
  691.       DLL = WCLVPCM
  692.       ENTRY = StartVPCM
  693.       AUTOSTART = YES
  694.       PIF = USRSPO01.PIF
  695.       TITLE = USRobotics Sportster 14400 Modem 02
  696.       PCMNAME = USRSPO01
  697.  
  698. o APAR= IC08134 THE LAN DISTANCE WINDOW WILL NOT DISPLAY ALL THE CONNECTION 
  699.   SERVERS ON THE RING WHEN THERE ARE 15+ ON THE SAME RING 
  700.  
  701.   Starting the LAN Distance Connection Server ICON brings up the LAN Distance 
  702.   Workstation Window.  The Workstation Window is designed to display all 
  703.   Connection Servers found on the network.  However, it only displays 8 to 12 
  704.   Connection Servers at a time. Refresh shows a different set of Connection 
  705.   Servers. 
  706.  
  707.   For example, a customer has 30 LAN Distance 1.1 Connection Servers on the 
  708.   same physical ring.  Not one is set to connect to a Non-LAN Distance 
  709.   Workstation; all are using NETBIOS.  However, from any one of them, the 
  710.   customer only sees 8 to 12 of the 30 Connection Servers on the ring. 
  711.  
  712. o APAR= IC08683 MULTIPLE ATTEMPTS TO LOGON THE LAN DISTANCE CONNECTION SERVER 
  713.   WITH INCORRECT PASSPHRASE RESULT IN MISLEADING ERROR MESSAGE 
  714.  
  715.   The maximum logon attempts is 4. When the maximum is met, the "MSG001: Access 
  716.   Denied" error appears.  The expected error is: "MSG002:  Your account is not 
  717.   active". 
  718.  
  719.   The "MSG002" error does not appear until the 8th attempt to logon with an 
  720.   incorrect PASSPHRASE.  The first attempt to re-activate the user is 
  721.   unsuccessful after receiving "MSG002".  Instead, "MSG005: Access denied" 
  722.   displays when you first logon with a valid passphrase.  Once again the 
  723.   account is inactive.  The second attempt to reactivate the user is 
  724.   successful. 
  725.  
  726. o APAR= IC08864 INCORRECT VALUES FOR NCB, TI, T1, T2 PARAMETERS ON MPTS (LAPS) 
  727.   PAGE OF LAN DISTANCE SETTINGS NOTEBOOK 
  728.  
  729.   The environment is a LAN Distance Connection Server or OS/2 Remote 
  730.   workstation running on LS 4.0 (MPTS). 
  731.  
  732.   If you change and save the values for the NCB, TI, T1, and T2 parameters they 
  733.   do not appear in the NETBIOS section on the MPTS (LAPS) page of the LAN 
  734.   Distance Settings notebook.  Instead you see the default values. MPTS from 
  735.   the command line correctly displays the values. The following steps recreate 
  736.   the problem: 
  737.  
  738.    - Open the LAN Distance Settings notebook and select the LAPS tab. 
  739.    - Edit NETBIOS and change the parameters listed above to non-default values. 
  740.      Save and exit. 
  741.    - Reopen LAPS from the Settings notebook. 
  742.  
  743. o APAR= IC08988 PROBLEMS USING AUTOFILTERING WITH ASYNCH LEASED LINES 
  744.  
  745.   The customer experiences problems using autofiltering with leased lines. 
  746.   Symptoms are slow response times, failure to logon to the domain controller, 
  747.   and problems using OS2ping to reach another machine on the ring. 
  748.  
  749. o APAR= IC09167 CONFIGURING LD 1.11 ON AN ETHERNET WORKSTATION WITH MPTS FOR 
  750.   TRANSPARENT BRIDGING RESULTS IN A LT00093 ERROR AFTER REBOOT 
  751.  
  752.   The following binding statements are in the PROTOCOL.INI file after you 
  753.   install LAN Distance 1.11 on a Ethernet workstation with MPTS. 
  754.  
  755.               NETBIOS
  756.                DriverName = netbios$
  757.                ADAPTER0 = netbeui$,0
  758.                ADAPTER1 = netbeui$,1
  759.               NETBEUI_nif
  760.                DriverName = netbeui$
  761.                Bindings = MACETH_nif,PDFH_nif
  762.  
  763.   If you now open the LAN Distance 1.11 Connection Server settings, the 
  764.   bindings statements for the NETBEUI_NIF section changes to Bindings = 
  765.   PDFH_nif.  The NETBIOS section remains the same. If the system is rebooted, 
  766.   it receives a LT00093 error, as NETBEUI is no longer binding to two adapter 
  767.   drivers. 
  768.  
  769. o APAR= IC09226 LAN DISTANCE CONNECTION SERVER DOES NOT CLEAN UP WCLLOCAL.INI 
  770.   AFTER DELETING A PORT 
  771.  
  772.   Running a LAN Distance, v1.11, 32 port server,  When adding a port and modem 
  773.   the PROTOCOL.INI, WCLNET.INI, AND WCLLOCAL.INI are updated.  Then delete the 
  774.   port (COM1).  The PROTOCOL.INI and WCLNET.INI change appropriately, but the 
  775.   WCLLOCAL.INI still refers to the COM1 port. 
  776.  
  777. o APAR= IC09297 LDREMOVE DOES NOT WORK IF EXECUTED FROM DISKETTE OR IF THE 
  778.   WCLINIRC.DLL FILE CANNOT BE FOUND 
  779.  
  780.   The LDREMOVE.EXE module found in LAN Distance 1.11 does not update the 
  781.   IBMLVL.INI file to reflect the removal of LD 1.11 when executed from the LAN 
  782.   Distance v1.11 diskettes.  This worked correctly in LAN Distance v1.1. 
  783.  
  784. o APAR= IC09590 LAN DISTANCE SECURITY DATABASE BECOMES CORRUPTED AND PREVENTS 
  785.   ACCESS BY THE SECURITY ADMINISTRATORS 
  786.  
  787.   The User Account Management database file, WCBUSRF.ISF, becomes corrupted. 
  788.   The Security Administrator is able to logon as Secadmin but cannot access the 
  789.   User Accounts file.  LAN Distance terminates and returns the user to the 
  790.   desktop.  The user receives the normal message that the User Account database 
  791.   is being accessed and then LAN Distance terminates. Early symptoms of 
  792.   database corruption are: 
  793.  
  794.    - Double entries of users 
  795.    - Failures in deleting users 
  796.    - Failures in adding new users The problem occurs with LAN Distance versions 
  797.   1.10 and 1.10 with IP07050. 
  798.  
  799. o APAR= IC09975 LAN DISTANCE DOCUMENTATION DOES NOT STATE SUPPORTED BAUD RATES 
  800.  
  801.   LAN Distance documentation does not indicate speeds below 9600 baud are not 
  802.   supported. 
  803.  
  804. o APAR= IC10184 LAN DISTANCE 1.1 WITH ARTIC CARDS DOES NOT ALLOW CONNECTIONS ( 
  805.   WCL0336) 
  806.  
  807.   After the Connection Server operates for some time, (hours to days), it stops 
  808.   answering remote connections. The established connections may or may not 
  809.   remain live, depending on the activity on ARTIC. 
  810.  
  811.   Remote work stations are able to call, the modems answer and connect, but the 
  812.   LAN Distance connection is never made.  The Connecting status never changes 
  813.   to the Connected status. 
  814.  
  815.   Call and Port Management does not cycle through normal states.  The status 
  816.   stays at Disconnecting on the ARTIC ports. The Transmit light on the remote 
  817.   modem blinks but never gets data back. The Receive light on the remote never 
  818.   blinks. Then the WCL errors are displayed.  When using OS/2, the WCL0336 
  819.   message appears.  The only fix is to reboot the Connection Server when the 
  820.   problem occurs.  Below are the environments in which this problem occurs: 
  821.  
  822.    Environment         Ethernet LAN; Novel is the LAN application 
  823.    CPU                 Various machines.  (Site uses IBM MOD 77's and 90's as 
  824.                        Connection Servers) 
  825.    Multiport card      ARTIC 
  826.    Modem               Tested various supported modems; also used Null-modem 
  827.    CS software         LAN Distance 1.1 with ip07050, LD 1.11, OS/2 2.11 
  828.    Remote software     LAN Distance 1.1 with ip07050 and OS/2 
  829.    ARTIC               53f2607 (supported card and EIB) (96 ports total) 
  830.  
  831. o APAR= IC10650 ISDN MC PRIMARY RATE DRIVER CONFLICTS WITH STARGATE MC DRIVER 
  832.   AND STARGATE PORTS ARE NO LONGER RECOGNIZED BY LAN DISTANCE 
  833.  
  834.   If you autostart both the ISDN microchannel and Stargate microchannel ports 
  835.   in LAN Distance, the modems on the Stargate panel do not initialize.  Errors 
  836.   WCL0326, WCL0323 and WCl0222 occur. If neither is autostarted, the same 
  837.   problem occurs when you manually start Stargate first and then manually start 
  838.   the ISDN port in Call and Port Management. 
  839.  
  840. The following APARs were fixed in this ServicePak for LAN Distance Entry 
  841. Connection Server. 
  842.  
  843. o APAR= IC07390 TRACE AUDITING FEATURE DOES NOT DISPLAY BYTES TRANSMITTED OVER 
  844.   ASYNC CONNECTIONS 
  845.  
  846.   The Number of Bytes Transmitted field always shows the value of zero when 
  847.   using async connections.  If a device driver does not support this field, LAN 
  848.   Distance should display a -1.  ISDN connections set the value correctly. 
  849.  
  850. o APAR= IC07598 SUPPORT FOR X.25 NATIVE ADAPTERS (Fixed in ip07050) 
  851.  
  852.   If an X.25 native adapter is used in the Connection Server or OS/2 Remote 
  853.   workstation, this fix must be used. 
  854.  
  855. o APAR= IC07599 SUPPORT FOR THE IBM ISDN PRIMARY RATE ADAPTER (Fixed in 
  856.   ip07050) 
  857.  
  858.   If an IBM ISDN Primary Rate Adapter is used on the Connection Server or the 
  859.   OS/2 Remote workstation, this fix must be used. 
  860.  
  861. o APAR= IC07600 CALLBACK FROM CONNECTION SERVER TO REMOTE FAILS WITH AUTOMATIC 
  862.   FILTERING ENABLED AT THE CONNECTION SERVER (Fixed in ip07050) 
  863.  
  864.   Callback from the Connection Server to the Remote workstation fails when 
  865.   automatic filtering is enabled at the Connection Server. Note this is a 
  866.   problem in LD 1.1 and NOT in LD 1.0. 
  867.  
  868. o APAR= IC07974 WCL0349 BY LD REMOTE IF THE LD CONNECTION SERVER HAS SAME 
  869.   ADAPTER ADDRESS FOR THE REAL AND LD LOGICAL ADAPTER 
  870.  
  871.   The LAN Distance Remote workstation receives a WCL0349 error while connecting 
  872.   or shortly after connecting to the Connection Server.  This occurs if the LAN 
  873.   Distance logical adapter (PDFH_NIF section of protocol.ini) address and the 
  874.   real adapter (IBMTOK_NIF, or other adapter, section of the protocol.ini) 
  875.   address are the same on the LD Connection Server. The WCL0349 error does not 
  876.   indicate this as the problem. 
  877.  
  878. o APAR= IC07982 LAN DISTANCE SETTINGS INCORRECTLY CHANGES NRZI TO NRZ, CAUSING 
  879.   LEASED LINE CONNECTIONS TO FAIL (Fixed in ip07050) 
  880.  
  881.   To successfully complete a synchronous leased line, the encoding scheme must 
  882.   match everywhere in the configuration. You can specify the LAN Distance 
  883.   answer criteria encoding scheme as NRZ or NRZI. If you select NRZI and save 
  884.   the settings, NRZI is in the entry for the answer criteria in the WCLDIAL.CXD 
  885.   file.  However, if you open Settings again, select the Answer tab and save 
  886.   settings, LAN Distance saves NRZ instead of NRZI.  The unexpected change in 
  887.   the encoding scheme causes connections to fail. 
  888.  
  889. o APAR= IC08043 UNABLE TO INITIALIZE MODEM WITH SUPRAFAX V32BIS PIF FILE 
  890.  
  891.   Use the following to initialize the modem and establish a 14400 connection: 
  892.   INITIALIZATION1 = "AT&F2\CR"    INITIALIZATION2 = "ATS0=2\CR" 
  893.  
  894. o APAR= IC08102 RETURN CODES FOR LINK STATISTICS IN THE LAN DISTANCE AUDIT FILE 
  895.   ARE NOT DOCUMENTED 
  896.  
  897.   The return codes in the Link Statistics section of the audit file are not 
  898.   documented in the LAN Distance Advanced Guide. Some common return codes: 
  899.  
  900.    - 3410  - Normal Call Clearing 
  901.    - 332D  - Timeout on Call 
  902.    - 3396  - Modem Not Responding 
  903.  
  904. o APAR= IC08124 SOME MODEMS RESPOND SLOWLY TO AT COMMANDS AND DO NOT INITIALIZE 
  905.   FOR LAN DISTANCE 
  906.  
  907.   The problem appears two different ways: 
  908.  
  909.     1. The modem initializes intermittently 
  910.     2. The modem never initializes.  However, when LAN Distance tracing is on 
  911.        for modem specific trace points, the modem initializes. The solution is 
  912.   a new ATCMD.DDF file to add a delay between issuing the first and second 
  913.   initialization string. 
  914.  
  915. o APAR= IC08251 LARGE FILE TRANSFERS FAIL USING BANYAN OVER LAN DISTANCE (Fixed 
  916.   in ip07050) 
  917.  
  918.   With automatic filtering enabled, copying of large files (or lots of smaller 
  919.   files) fails and the redirected driver is lost. The problem occurs on DOS and 
  920.   OS/2 Banyan clients in ethernet and token ring environments.  The problem 
  921.   does not occur if automatic filtering is disabled. 
  922.  
  923. o APAR= IC08269 "A PROCESSING ERROR OCCURRED" MESSAGE APPEARS WHEN OPENING LAN 
  924.   DISTANCE SETTINGS NOTEBOOK 
  925.  
  926.   Customer tried to open the Settings notebook at the LAN Distance Connection 
  927.   Server and received the message "a processing error occurred". When this 
  928.   message appears you cannot open the notebook. 
  929.  
  930. o APAR= IC08292 PROBLEMS COMMUNICATING TO/FROM A MICROCOM QX/4232BIS MODEM 
  931.   USING LAN DISTANCE (AND MICROCOM.PIF) 
  932.  
  933.   Various problems occur when using the Microcom QX/4232bis modem and LAN 
  934.   Distance.  Problems include modem failure to answer and callback. 
  935.  
  936. o APAR= IC08434 ARTIC 8 PORT NEVER ANSWERS CALL FROM WAC ON SYNCHRONOUS LINE 
  937.  
  938.   The answering LAN Distance Server has OS/2 2.1, LD 1.1, and an Artic 8 port 
  939.   adapter.  The dialing LD Server has OS/2 2.1, LD 1.1, a WAC adapter and dials 
  940.   over a leased line. The servers run a LAN to LAN bridge via WAC port to Artic 
  941.   port.  The dialing server with the WAC receives the WCL0336 message and the 
  942.   connection is not made. 
  943.  
  944.   To make the connection, activate Autoanswer on the LD Server with the Artic 
  945.   adapter as the LD Server with the WAC adapter is dialing in. 
  946.  
  947. o APAR= IC08536 SYS3170 ERROR SHUTTING DOWN LAN DISTANCE USING IP07050 
  948.  
  949.   SYS3170 error with CS:EIP ae77:0000bd9f occurs when shutting down LAN 
  950.   Distance on IP07050. 
  951.  
  952. o APAR= IC08555 TOKENRING ADAPTERS NOT LISTED IN THE TOKENRINGMACS SECTION OF 
  953.   THE WCLLOCAL FILE ARE REPLACED WITH PDFH IN PROTOCOL.INI FILE 
  954.  
  955.   After the installation of IP07050 on a LAN Distance v1.1 Connection Server, a 
  956.   new section called TOKENRINGMACS is added. If a customer wants to add a Token 
  957.   Ring NIF file to the list and configure that driver, LAN Distance replaces 
  958.   the driver name with PDFH information in the PROTOCOL.INI file.  For example, 
  959.   LAN Distance substitutes PDFH_NIF for OLITOK16_NIF. 
  960.  
  961. o APAR= IC08630 LAN DISTANCE REMOTE WINDOWS CLIENT ON ASYNC LEASED LINE NOT 
  962.   WORKING 
  963.  
  964.   LAN Distance 1.1 Remote Windows Client on Async leased line does not work. 
  965.  
  966. o APAR= IC08720 THE README FILE FOR LAN DISTANCE CSD IP07050 LISTS SUPPORT FOR 
  967.   AN UNAVAILABLE ADAPTER 
  968.  
  969.   IP07050.INF on Disk #1 of the LAN Distance CSD IP07050 lists support for an 
  970.   IBM Auto LANStreamer ISA Adapter.  This adapter is unavailable and should not 
  971.   be listed. 
  972.  
  973. o APAR= IC08729 LACK OF RETURN CODE AND ERROR CODE DOCUMENTATION IN ALL LAN 
  974.   DISTANCE PACKAGES 
  975.  
  976.   Return code information is not readily available.  Available error code 
  977.   documentation is limited and not helpful to support and application 
  978.   development personnel. 
  979.  
  980. o APAR= IC08871 VALUES FOR BINDINGS= ARE NOT SET CORRECTLY IN ALL THE PROTOCOLS 
  981.  
  982.   The configuration is 2 LAN adapters, one Autostreamer and one Ethernet. When 
  983.   LAN Distance is installed, the bindings= values in the protocol.ini file are 
  984.   not set correctly in all the protocols.  After the LD install, some of the 
  985.   bindings had bindings= pdfh_nif.  Some had bindings enet,pdfh_nif. LD did not 
  986.   keep the positions of the token ring adapter 0.  Instead it set PDFH adapter 
  987.   0 for some protocols, and adapter 1 for others.  The same happens with 
  988.   ethernet adapters. 
  989.  
  990. o APAR= IC08956 LAN DISTANCE LAPS TAB FROM SETTINGS DOES NOT WORK ON WARP 
  991.  
  992.   If you select the LAPS tab in the LAN Distance Settings notebook when running 
  993.   on WARP, you cannot select any fields. All fields appear protected. LAPS 
  994.   works fine from the command line. 
  995.  
  996. o APAR= IC09737 ADDRESSES STARTING WITH 00 DO NOT WORK WITH LAN DISTANCE 
  997.   (WCL0567) 
  998.  
  999.   Any LAN adapter starting with an address of 00 will not work with LAN 
  1000.   Distance.  LAN Distance returns a WCL0567 error. 
  1001.  
  1002. o APAR= IC09738 THE CID ADDRESS RANGE FOR LAN DISTANCE DOES NOT ALLOW FOR 
  1003.   ADDRESSES LESS THAN 4000 
  1004.  
  1005.   An address range from 0000000000001 to 400000000000 is not allowed in CID 
  1006.   installs of LAN Distance.  The address during a CID install has to be from 
  1007.   40000000000 to 7FFFFFFFFFFF.  LAN Distance 1.1 allows an address range of 
  1008.   00000000001 to 7FFFFFFFFFF. 
  1009.  
  1010. o APAR= IC10334 THE LAN DISTANCE CONNECTION SERVER ICON INTERMITTENTLY DISPLAYS 
  1011.   GREEK SYMBOLS 
  1012.  
  1013.   Customer intermittently sees his LAN Distance Connection Server Icons with 
  1014.   Greek lettering.  He is unable to recreate at will. 
  1015.  
  1016. o APAR= IC10808 CALLBACK FAILURE HANGS CONNECTION SERVER IF REMOTE IS RUNNING 
  1017.   WARP 
  1018.  
  1019.   The LAN Distance Connection Server hangs after an OS/2 Remote LAN Distance 
  1020.   workstation dials in requiring callback.  The Remote LD workstation runs the 
  1021.   MPTS version shipped with WARP Connect (2.60.5).  The failure may not occur 
  1022.   on the first dial in, but it does occur after two or three attempts. At that 
  1023.   point, the CS does not accept any new calls and the Remote fails to go into a 
  1024.   connected state.  After a few more users attempt to logon, the Connection 
  1025.   Server hangs.  The LAN Distance code cannot be closed. 
  1026.  
  1027. The following APARs were fixed in this ServicePak for LAN Distance Remote 
  1028. Workstation. 
  1029.  
  1030. o APAR= IC07973 UNCLEAR WCL0535 ERROR ISSUED WHEN THE LAN DISTANCE LOGICAL 
  1031.   ADAPTER HAS NO ADDRESS (Fixed in ip07050) 
  1032.  
  1033.   WCL0535 appears when there is no adapter address for the LAN Distance Logical 
  1034.   Adapter. This occurs when you delete the LAN Distance logical adapter in LAPS 
  1035.   and then add it again without setting the address. WCL0535 indicates a 
  1036.   processing error in dial services. This provides no information about the 
  1037.   real problem. 
  1038.  
  1039. o APAR= IC07601 BANYAN REQUESTER CANNOT LOGON TO BANYAN SERVER OVER LAN 
  1040.   DISTANCE WHEN THE LAN IS A TOKEN RING (Fixed in ip07050) 
  1041.  
  1042.   The Banyan protocol stack does not fill in the source address in the token 
  1043.   ring frame. Therefore, a Banyan requester running over LAN Distance cannot 
  1044.   logon to the Banyan server. The problem only occurs in a token ring 
  1045.   environment. A fix is provided for LD 1.1 and not LD 1.0. 
  1046.  
  1047. o APAR= IC08716 WCL0321 WHEN DIALING FROM THE LAN DISTANCE PHONEBOOK 
  1048.  
  1049.   If you select Dial from the Phonebook on a LAN Distance Remote workstation 
  1050.   with LD, V.1.1 and CSD IP07050 or 1.11, a WCL0321 message appears.  The same 
  1051.   message appears if you start the LAN Distance Connection Server. The message 
  1052.   says "A processing error occurred.  The LAN Distance product cannot read 
  1053.   configuration data for '***'". 
  1054.  
  1055. o APAR= IC08717 PROBLEMS OPENING THE LAN DISTANCE SETTINGS NOTEBOOK 
  1056.  
  1057.   The following problems occur on LAN Distance 1.1 (with or without CSD 
  1058.   IP07050) when you open the Settings notebook. 
  1059.  
  1060.    - The message box indicates Settings will open. 
  1061.    - After awhile the message box disappears. 
  1062.    - The notebook DOES NOT open. 
  1063.    - A processing error appears and the notebook does open. 
  1064.  
  1065. o APAR= IC09046 LAN DISTANCE CONNECTION FAILS IF SECOND CALL HITS THE PORT 
  1066.   DURING CALLBACK FOR FIRST CALL 
  1067.  
  1068.   A customer wants to install LAN Distance for a community of about 400 people. 
  1069.   The customer configuration: 
  1070.  
  1071.    - 2 LD Servers IBM 9585, 54 MB HD, 80486DX2, 24 MB RAM each 
  1072.    - 3 RIC Portmaster Adapters peer server (2MB) 
  1073.    - Each Portmaster adapter attached to 8 modems (Motorola 3265) The error 
  1074.   description is below: 
  1075.  
  1076.    - User "A" calls in with a variable callback id on CS port 0000 
  1077.    - User "A" logs on with userid TEST01 & password & callback # 
  1078.    - Logon is successful 
  1079.    - CS disconnects the session 
  1080.    - User "A" waits for callback (callback on CS is set to ANY port) 
  1081.    - The modem on port 0000 initializes successfully 
  1082.    - CS initiates a callback on port 0000 and sends the dial string to the 
  1083.      modem 
  1084.    - The modem switches in dial wait mode (for 2 seconds) 
  1085.    - In the meantime, user "B" has started a call to CS port 0000 
  1086.    - The first ring of user "B"s call hits the port 0000 modem while the modem 
  1087.      is in dial wait mode for the callback 
  1088.    - The CS gets a RING RING & CONNECT .... message fom the modem on port 0000 
  1089.    - The CS assumes a successful callback to user "A" and wants to verify user 
  1090.      "A" 
  1091.    - User "B" gets a CONNECT message in his phone book, but no 'logon in 
  1092.      process" message. 
  1093.    - The trace on the CS looks like the server cannot handle this situation. 
  1094.      The user information for user "A" and "B" get mixed up. 
  1095.    - The Remote of user "B" cannot handle this either. 
  1096.    - User "B" gets a 'no port available - waiting for redial' message on the 
  1097.      phone book status line 
  1098.    - As Remote of user "B" hangs up, the CS assumes a successful callback and 
  1099.      that the callback party disconnected upon request of user "A".  We guess 
  1100.      this is why user A never gets a callback. 
  1101.    - For the CS everything seems to be OK.  The modem on port 0000 
  1102.      reinitializes and prepares for the next call without an error message. 
  1103.   Additional information is in the attached PMR. Lisa Goetze and Annah Lewis 
  1104.   have traces. 
  1105.  
  1106. o APAR= IC09059 CANNOT EXIT CFMODEM BUILD STRING NOTEBOOK ON WARP 
  1107.  
  1108.   Selecting the build string option of CFMODEM on WARP causes a problem.  You 
  1109.   cannot exit the notebook and the task list does not come up. You must reboot 
  1110.   the machine to recover. 
  1111.  
  1112. o APAR= IC09338 LAN DISTANCE DOES NOT HONOR SPECIFIC PORTS WHEN LD 1.1, OR LD 
  1113.   1.11 IS USED 
  1114.  
  1115.   With LAN Distance 1.10 plus 7050, the customer wants to configure a 
  1116.   Waverunner (ISDN) on COM2, and a Hayes Optima 14.4 on COM1. When he tries to 
  1117.   dial out, it always dials from COM1, regardless of the selected Phonebook 
  1118.   entry. Level 2.5 has recreated this using modems on Com Ports. 
  1119.  
  1120. o APAR= IC09437 755CE WITH DSP MWAVE SUPPORT REQUIRES COMX SECTION OF THE 
  1121.   PROTOCOL.INI FILE TO HAVE PCMCIA = YES 
  1122.  
  1123.   To setup LAN Distance on a 755CE/CD with DSP MWave support you must set 
  1124.   PCMCIA = "YES" in the COMx port section of the PROTOCOL.INI.  If it is set to 
  1125.   NO, the following errors OCCUR at boot time: 
  1126.  
  1127.    - CPM0008 Adapter specified for MAC COMx does not exist. 
  1128.    - SYS1201 .... WCLCPMAC.OS2 did not load. DSP Mwave modem is not a PCMCIA 
  1129.   modem. 
  1130.  
  1131. o APAR= IC10166 WCL0012 MESSAGE POPS UP WHEN CLOSING LAN DISTANCE WITH SHUTTLE 
  1132.  
  1133.   The following setup was done with the Advanced path on a Pentium machine: 
  1134.  
  1135.    - WARP 
  1136.    - OS/2 PEER with NetBIOS 
  1137.    - TCPIP 
  1138.    - NETWARE 
  1139.    - LAN Distance The following is a description of the problem: 
  1140.  
  1141.    - After installation, start LAN Distance, open the Phonebook, close the 
  1142.      Phonebook, and close the LAN Distance container. WCL0012 appears.  The 
  1143.      Shuttle panel appears after WCL0012 is dismissed, but the Help button is 
  1144.      inactive. 
  1145.    - Start LAN Distance, open the Phonebook, close the Phonebook, and close the 
  1146.      LAN Distance container. 
  1147.    - Display the Help for the close confirmation prompt.  The Shuttle panel is 
  1148.      not displayed after the close confirmation prompt is dismissed. 
  1149.  
  1150. o APAR= IC10348 BASEDEV= BECOMES DEVICE= WHEN SHUTTLING LAN DISTANCE REMOTE TO 
  1151.   LAN ATTACHED WITH OS/2 WARP SOCKET SERVICES DRIVERS LOADED 
  1152.  
  1153.   You use the Shuttle feature of LAN Distance Remote to switch from Remote PC 
  1154.   to LAN attached.  The Shuttle function places the WARP Socket Services 
  1155.   drivers in the config.sys file as DEVICE= statements instead of the BASEDEV= 
  1156.   statements required by Socket Services.  The drivers will not load at boot 
  1157.   time. 
  1158.  
  1159. o APAR= IC10905 STARTING LAN DISTANCE FROM THE CLI WITH LDIST DIAL /D:ENTRY 
  1160.   CAUSES THAT OS/2 SESSION TO HANG 
  1161.  
  1162.   LAN Distance starts successfully from the command line with LDSTART.  Next 
  1163.   you enter LDIST DIAL /D:entry to dial and establish a connection.  LAN 
  1164.   Distance is supposed to display the returned modem strings as the connection 
  1165.   is made.  Instead, the OS/2 window session hangs in the middle of displaying 
  1166.   the modem strings.  However, the connection is there and you can work over 
  1167.   the connection in another window session. 
  1168.  
  1169.   System setup includes Thinkpad Models 345-c and 345-cs, a Hayes Optima 14400 
  1170.   modem, OS/2 WARP with Communications Manager, DCAF, and a started System 
  1171.   Perform Monitor. 
  1172.  
  1173. o APAR= IC11000 INCORRECT PARAMETER SYNTAX FOR THE LD_REM.RSP FILE IN THE LAN 
  1174.   DISTANCE, V.1.1 ADVANCED GUIDE 
  1175.  
  1176.   Page 4-9 of the LAN Distance Advanced Guide, v.1.1 indicates the address 
  1177.   syntax should be in double quotes.  On page 4-8 the sample is without double 
  1178.   quotes. If the LD_REM.RSP file is set up as described on page 4-9, then the 
  1179.   workstation receives WAL0113 and WAL0074 errors. 
  1180.  
  1181.   Also, the LANtype is defined to be Token-Ring for 802.5 token-ring networks. 
  1182.   Token-ring is incorrect.  The correct term is TOKENRING. 
  1183.  
  1184.  
  1185. ΓòÉΓòÉΓòÉ 4.3. New Features ΓòÉΓòÉΓòÉ
  1186.  
  1187. The following sections discuss new and enhanced LAN Distance features. 
  1188.  
  1189.  
  1190. ΓòÉΓòÉΓòÉ 4.3.1. Inactivity Timeout for Connection Servers ΓòÉΓòÉΓòÉ
  1191.  
  1192. The administration of a Connection Server will be able to specify conditions 
  1193. for detecting a lack of activity over the various established connections, and 
  1194. force a disconnection of the link when that inactivity condition is present. 
  1195.  
  1196. How Inactivity Timeout Works 
  1197.  
  1198. Every connection established by a machine on which the inactivity timer is 
  1199. installed and operating will be subjected to a "usage" test every minute. The 
  1200. test is somewhat like asking the question, "Over the past minute, have enough 
  1201. LAN frames passed across this link?" If the link fails the test enough times in 
  1202. succession without ever passing it, the link is broken. 
  1203.  
  1204. LAN Distance must be told two pieces of information by the Connection Server 
  1205. administrator. The first piece of information determines how many minutes to 
  1206. tolerate inactivity on the link before forcing a disconnection, and the second 
  1207. piece of information specifies the minimum number of LAN frames that must 
  1208. across the link (in either direction) within a one minute period for the link 
  1209. to be considered active. 
  1210.  
  1211. This information is provided to the Connection Server through values assinged 
  1212. to two new fields on the Timers Page of the Settings notebook. The two fields 
  1213. are "Inactivity Timeout", which specifies the number of minutes of inactivity 
  1214. to tolerate before causing a line disconnect, and "Inactivity Threshold", which 
  1215. states the minimun number of frames that must cross an active link in a minute. 
  1216.  
  1217. The value of Inactivity threshold can be anywhere from 0 to 99999, although the 
  1218. test for sufficient usage of the link is skipped if the value is 0. Similarly, 
  1219. Inactivity timeout can have a value between 0 and 999, with 0 disabling the 
  1220. inactivity timeout feature. Each field is initially set to zero when the 
  1221. Connection Server is first installed. 
  1222.  
  1223. Additional Information 
  1224.  
  1225. When disconnected, the remote workstation will display a WCL0310 message. In 
  1226. this version, no other indication will be given to a user, and there will be no 
  1227. warning that a disconnection is imminent. 
  1228.  
  1229. The values specified for Inactivity timeout and Inactivity threshold apply to 
  1230. all connections made to that Connection Server. They may not be customized or 
  1231. disabled for individual connections or ports. 
  1232.  
  1233. The value chosen for Inactivity threshold should be selected very carefully. 
  1234. The number of frames that cross the link during a passive connection where no 
  1235. real work is being performed can vary considerably from installation to 
  1236. installation, and will depend upon the type and configuration of the attached 
  1237. LAN as well as the application being used on the remote workstation. The value 
  1238. chosen must be high enough so that a connection across an idle link really will 
  1239. be broken, but also set low enough so that low-intensity applications doing 
  1240. real work are not accidentally disconnected. 
  1241.  
  1242. Experimentation will be required for each LAN environment on which this feature 
  1243. is installed. A simple LAN Distance link, with the LAN parameters configured as 
  1244. recommended in the LAN Distances guides, should see 4-5 frames cross each 
  1245. minute when no work is being done. This can be modified by the presence of LAN 
  1246. Requestor or Communications Manager. It will be necessary to experiment with 
  1247. the value of Inactivity threshold in the environment being used to determine an 
  1248. acceptable value. 
  1249.  
  1250.  
  1251. ΓòÉΓòÉΓòÉ 4.3.2. Security Shared Database ΓòÉΓòÉΓòÉ
  1252.  
  1253. Steps for Setting Up Security on a LAN Distance Workstation 
  1254.  
  1255. Follow these general steps to set up LAN Distance security at a LAN Distance 
  1256. Connection Server or OS/2 LAN Distance Remote. Each step is described in detail 
  1257. in sections that follow. 
  1258.  
  1259.  1. Enable security at the LAN Distance workstation. 
  1260.  
  1261.  2. Log on to your LAN Distance workstation using the default user account for 
  1262.     the security administrator. 
  1263.  
  1264.  3. Set up a user account that contains required information (user ID and user 
  1265.     type) for each user that needs to log on to your secure LAN Distance 
  1266.     workstation. 
  1267.  
  1268.  4. Define any optional security features for user accounts. 
  1269.  
  1270.  5. Define security policy options for passphrases and user IDs that apply to 
  1271.     all user accounts. 
  1272.  
  1273. Enabling LAN Distance Security 
  1274.  
  1275. LAN Distance security must be enabled on a LAN Distance Connection Server or 
  1276. LAN Distance Remote before you can set up user accounts. 
  1277.  
  1278. To enable LAN Distance security, 
  1279.  
  1280.  1. Select Settings from the Open as pull down menu. 
  1281.  
  1282.  2. From the Settings notebook select the Security tab. 
  1283.  
  1284.  3. From the Security tab page, select the Enable LAN Distance Security 
  1285.     checkbox. If the Enable LAN Distance Security checkbox is not checked, LAN 
  1286.     Distance security is disabled. 
  1287.  
  1288.  4. To activate security on your LAN Distance workstation, close the Settings 
  1289.     notebook. Then stop and restart the LAN Distance product. 
  1290.  
  1291. Enabling Third Party Authentication Protocol 
  1292.  
  1293. Third party authentication is used for remote dial-in only. 
  1294.  
  1295. The fields related to this checkbox are grayed out if LAN Distance security is 
  1296. disabled. 
  1297.  
  1298. To enable third party authentication, you must first enable LAN Distance 
  1299. security. 
  1300.  
  1301.  1. Select the Enable Third Party Authentication Protocol checkbox to turn on 
  1302.     third party authentication for the LAN Distance connectin server only. 
  1303.  
  1304.  2. In the User Exit Name field, type the user exit DLL name. The maximun 
  1305.     length for this field is 8 characters. Do not enter the DLL extension. 
  1306.  
  1307.  3. Select Disable Remote LAN Distance Authentication if you want to use only 
  1308.     the third party authentication. Not selecting this checkbox allows you to 
  1309.     use both the LAN Distance and the third party authentication. 
  1310.  
  1311. Enabling Share Security Database 
  1312.  
  1313. To share a secured database with others on the LAN. 
  1314.  
  1315.  1. Select the Enable Share Security Database checkbox. 
  1316.  
  1317.  2. Type the drive and path of the database in Location. 
  1318.  
  1319. The shared security database information, the user exit name, and remote 
  1320. authentication options are added automatically to the WCLLOCAL.INI file. 
  1321.  
  1322. Note:   After security is enabled on your workstation, security at the local 
  1323. workstation    must be disabled by a security administrator. 
  1324.  
  1325. Security Database Tools 
  1326.  
  1327. This appendix discusses the security database tools available in LAN Distance 
  1328. 1.12. 
  1329.  
  1330. The LAN Distance Security  Database Tools allow the LAN Distance security 
  1331. administrator to manage the security database and perform the following tasks: 
  1332.  
  1333. o Add users with using the User Account Management window 
  1334.  
  1335. o Print a report of the security database 
  1336.  
  1337. o Back up the security database with out shutting down LAN Distance 
  1338.  
  1339. The security database tools are comprised of these tools: 
  1340.  
  1341. o BACKUP: - provides a command line interface that allows the user to back up 
  1342.   the database while LAN Distance is running. The database can be backed up to 
  1343.   a specific file. This tool accepts an input file name as a parameter and 
  1344.   copies the security database using this file name. 
  1345.  
  1346.         SYNTAX:
  1347.  
  1348.            CMBACKUP <output_file>
  1349.  
  1350.         where:
  1351.            <output_file> is the name of the backup file the user
  1352.            wants to save the security database to.
  1353.  
  1354.            If this option is ignored, the default backup file is
  1355.            WCBUSRF.BAK.
  1356.  
  1357. o PRINT: - provides a command line interface that the user can use to print a 
  1358.   list of the users in the security database. 
  1359.  
  1360.   All of the userIDs and user comments in the LAN Distance security database 
  1361.   are printed in to a specified file. 
  1362.  
  1363.         SYNTAX:
  1364.  
  1365.            CMPRINT </FI:input_file> </FO:output_file>
  1366.  
  1367.         where:
  1368.            /FI:input_file specifies the name of the input LAN
  1369.            Distance Security Database file. The default is
  1370.            WCBUSRF.ISF.
  1371.  
  1372.            /FO:output_file specifies the name of the output
  1373.            file. The default is CMPRINT.REP.
  1374.  
  1375. CMPROCES 
  1376.  
  1377. The CMPROCES tool provides a batch processing capability for LAN Distance. This 
  1378. tool reads user information from a Script file and adds user data to the 
  1379. security database. 
  1380.  
  1381.     SYNTAX:
  1382.  
  1383.        CMPROCES </CT:control> </FI:infile> </FO:outfile>
  1384.  
  1385.     where:
  1386.  
  1387.        /CT: Control parameter
  1388.  
  1389.           AD for add user to database
  1390.  
  1391.           ME for merge the database
  1392.  
  1393.        /FO: output file name
  1394.  
  1395.           The output filename is the name of the report file. This report file
  1396.           contains the userIDs and the return code of the requested action.
  1397.           The default output file for ADD user is CMADD.REP.
  1398.  
  1399.        /FI: input file name
  1400.  
  1401.           If the control parameter is ad, the input file is a Script file
  1402.           containing user information to be added. If the control parameter
  1403.           is ME, the input file is the security database to be merged.
  1404.           The default file name of the input file is WCBUSRF.INI.
  1405.  
  1406.           The format of the Script file for adding a user is one line of user
  1407.           information per user. The user information line contains the control
  1408.           key and user information in the following format:
  1409.  
  1410.             /ID: userID /PS: passphrase /CM: user comment /UT: user type
  1411.  
  1412.           where:
  1413.  
  1414.           /ID: The maximun length of the userID is 10 characters. This control
  1415.              key is reqired. The userID is not case-sensitive.
  1416.  
  1417.           /PW: The maximum length of the passphrase is 32 characters. This
  1418.              control key is ignored when the passphrase of user account is set
  1419.              to "not required." The passphrase is case-sensitive.
  1420.  
  1421.           /CM: The user comment is optional. The maximum length of user
  1422.              comment is 40 characters and it is not case-sensitive.
  1423.  
  1424.           /UT: The user type is optional and the default is user. There are three
  1425.              types of user available:
  1426.  
  1427.              U = USER
  1428.  
  1429.              A = ADMINISTRATOR
  1430.  
  1431.              S = SECURITY ADMINISTRATOR
  1432.  
  1433.  
  1434. ΓòÉΓòÉΓòÉ 4.3.3. Developing User Exits ΓòÉΓòÉΓòÉ
  1435.  
  1436. This appendix discussed the user exits available in LAN Distance 1.12. 
  1437.  
  1438. Security User Exit Enablement 
  1439.  
  1440. LAN Distance now supports two optional levels of security for restricted access 
  1441. to the LAN and its resources. One level is the existing LAN Distance security 
  1442. (User Account Management), included in the LAN Distance product. The second 
  1443. level is a security user exit package that is distributed separately from the 
  1444. LAN Distance product. LAN Distance supports any OEM-provided security user exit 
  1445. package that is developed in conformance with the LAN Distance Generalized 
  1446. Security User Exit API. 
  1447.  
  1448. What Is a Security User Exit Package? 
  1449.  
  1450. A security user exit package consists of two user exit modules: one for the 
  1451. client and one for the server. The client and server user exit modules work 
  1452. together to implement the user authentication protocol defined by the security 
  1453. user exit package. A user authentication protocol is a series of user exit 
  1454. messages/tokens exchanged between the client and server user exit modules when 
  1455. validating the user of a LAN Distance client workstation that is calling a LAN 
  1456. Distance connection server. 
  1457.  
  1458. Using Multiple Security User Exit Packages 
  1459.  
  1460. One LAN Distance client workstation can use a different security user exit 
  1461. package to access each different LAN Distance server workstation it calls. A 
  1462. LAN Distance server workstation must use only one security user exit package to 
  1463. allow access from all LAN Distance client workstations that call it. 
  1464.  
  1465. Using Security User Exit Packages with LAN Distance Security 
  1466.  
  1467. Security user exit packages can be used with or wityout LAN Distance security 
  1468. (User Account Management). If LAN Distance security is used with the security 
  1469. user exit package, the authentication will take place first through the user 
  1470. exit and second through LAN Distance security. 
  1471.  
  1472. Enabling Security User Exit 
  1473.  
  1474. To enable the user-supplied security exit, apply version 1.11 of the LAN 
  1475. Distance product to the connection server and remote workstations that will use 
  1476. the user exit. 
  1477.  
  1478. LAN Distance Security User Exit Development Toolkit 
  1479.  
  1480. A development toolkit for the LAN Distance Security User Exit for OS/2 and 
  1481. Windows is available. The toolkit contains: 
  1482.  
  1483. o specification of the LAN Distance Generalized Security User Exit API 
  1484.  
  1485. o description of how a LAN Distance security user exit can be 
  1486.   installed/registered at LAN Distance workstations 
  1487.  
  1488. o sample source code for developing your own LAN Distance security user exit 
  1489.   package 
  1490.  
  1491. The toolkit is available through IBM Service and Support by referencing APAR 
  1492. IC07742. 
  1493.  
  1494.  
  1495. ΓòÉΓòÉΓòÉ 4.3.4. X.25 Native Adapters Support ΓòÉΓòÉΓòÉ
  1496.  
  1497. Changes were made to LAN Distance to support adapters that are enabled for 
  1498. native X.25 under LAN Distance.  If this support is required, then this 
  1499. ServicePak must be applied to the connection server and the OS/2 remote 
  1500. workstations using the X.25 native adapter. 
  1501.  
  1502. APAR IC07598 was created to add this support to the LAN Distance product. 
  1503.  
  1504.  
  1505. ΓòÉΓòÉΓòÉ 4.3.5. IBM ISDN Primary Rate Adapter Enablement ΓòÉΓòÉΓòÉ
  1506.  
  1507. Support has been added to LAN Distance to allow the use of the IBM ISDN Primary 
  1508. Rate Adapter. This ServicePak must be applied to all connection servers and 
  1509. remote workstations using this adapter. 
  1510.  
  1511. APAR IC07599 was created to add this support to the LAN Distance product. 
  1512.  
  1513.  
  1514. ΓòÉΓòÉΓòÉ 4.3.6. IBM Auto/Dual LANStreamer Adapters (Token Ring Promiscuous Mode) Support ΓòÉΓòÉΓòÉ
  1515.  
  1516. The LAN Distance product supports the following IBM Auto or Dual LANStreamer 
  1517. Adapters: 
  1518.  
  1519. o IBM Auto LANStreamer MC 32 Adapter 
  1520. o IBM Dual LANStreamer MC 32 Adapter 
  1521. o IBM Auto LANStreamer ISA Adapter 
  1522.  
  1523. NOTE:  Before using these adapters contact IBM Support and Service to obtain 
  1524. the device drivers:  IBMMPC.NIF and IBMMPC.OS2. 
  1525.  
  1526. To use the above IBM Auto or Dual LANStreamer Adapters for bridging on a LAN 
  1527. Distance Connection Server, do the following: 
  1528.  
  1529.  1. Install the LANStreamer adapter according to the adapter installation 
  1530.     instructions. 
  1531.  
  1532.  2. If using the ISA version of the adapter, configure the adapter with the 
  1533.     adapter installation diskette. 
  1534.  
  1535.  3. If using the MC Adapter, configure the adapter with the reference diskette. 
  1536.  
  1537.  4. Use LAPS or MPTS to install the adapter device driver and configure the 
  1538.     adapter for LAPS. 
  1539.  
  1540.  5. Start LAN Distance 
  1541.  
  1542.  6. Open the Settings Notebook 
  1543.  
  1544.  7. Select the Address/LAN tab 
  1545.  
  1546.  8. After the Settings Notebook has finished initializing, you will see a list 
  1547.     of adapters available for bridging in the "Adapter for Bridging" listbox. 
  1548.     Find the "IBM Streamer Family adapter (IBMMPC.OS2)" entry and select it. 
  1549.  
  1550.  9. When you close the Settings Notebook, your LAN Distance Connection Server 
  1551.     will be set up for bridging with the IBM Auto or Dual LANStreamer adapter. 
  1552.     Shutdown and restart the workstation. 
  1553.  
  1554.  
  1555. ΓòÉΓòÉΓòÉ 5. LAN Applications and Hardware Considerations ΓòÉΓòÉΓòÉ
  1556.  
  1557. The following sections discuss additional considerations for using specific LAN 
  1558. Applications and hardware with the LAN Distance product. 
  1559.  
  1560.  
  1561. ΓòÉΓòÉΓòÉ 5.1. NetWare ΓòÉΓòÉΓòÉ
  1562.  
  1563. This section discusses additional considerations for using NetWare with the LAN 
  1564. Distance product. 
  1565.  
  1566. NetWare Server 
  1567.  
  1568. o For a NetWare server to support clients using packet burst in a WAN 
  1569.   environment, the NetWare server must have PBURST.EXE or later fix. 
  1570.  
  1571.   PBURST.EXE has packet burst files with a new packet burst algorithm for WAN 
  1572.   links to fix problems where: 
  1573.  
  1574.    - Burst retries could saturate WAN links due to low retry timeout values. 
  1575.  
  1576.    - Workstations hang when duplicate packets from a previous burst are 
  1577.      received in the middle of the current burst. 
  1578.  
  1579.   PBURST.NLM is for use on NetWare 3.11 file servers.  PBWANFIX.NLM (which 
  1580.   requires Patchman) is for use on NetWare 3.12 and 4.01 file servers. 
  1581.  
  1582.   This NetWare fix is available through IBM Support and Service by referencing 
  1583.   APAR IC07834. 
  1584.  
  1585. o In a token ring environment, make sure that ROUTE.NLM is loaded on the 
  1586.   NetWare server.  Since the LAN Distance connection server is a token ring 
  1587.   bridge, source level routing information must be in frames to be delivered to 
  1588.   the WAN by the connection server. 
  1589.  
  1590. OS/2 NetWare Requester 
  1591.  
  1592. The following recommendations are for running OS/2 NetWare Requester.  Note 
  1593. that a few of the steps only apply to a token ring environment. 
  1594.  
  1595. o To improve performance, copy frequently used NetWare utilities to the OS/2 
  1596.   NetWare requester. For example: LOGON.EXE, LOGOUT.EXE, MAP.EXE and SLIST.EXE. 
  1597.  
  1598. o The following is a sample NET.CFG.  Use this configuration when first 
  1599.   attempting to use the OS/2 NetWare requester over LAN Distance.  Do not use 
  1600.   the normal buffer size of 4202 for a token ring environment, use 1514. 
  1601.  
  1602.        NetWare Requester
  1603.         Default Login Drive L
  1604.         cache buffers 30
  1605.         directory services off
  1606.  
  1607.        Link Support
  1608.         Buffers xx 1514
  1609.  
  1610. o For a token ring environment, LAN Distance requires that all frames have 
  1611.   source routing information.  This means that ROUTE.NLM must be loaded on the 
  1612.   NetWare server and ROUTE.SYS must be loaded for the OS/2 NetWare requester. 
  1613.  
  1614. o The OS/2 NetWare requester must have a fix for NWREQ.SYS. 
  1615.  
  1616.   The OS/2 NetWare requester has a fixed timeout value for resending frames 
  1617.   when there has been no response from the server.  Over a slow link this can 
  1618.   cause frames to be retransmitted several times causing slow performance and 
  1619.   REQ1040 and REQ1039 error messages from NETWARE. 
  1620.  
  1621.   The NWREQ.SYS fix increases the timeout value. There is a side effect of this 
  1622.   fix.  When the LAN Distance connection is dropped, it will take several 
  1623.   minutes for NetWare to destroy the default drive due to the longer timeout 
  1624.   value.  You may notice this when you are trying to shutdown OS/2. 
  1625.  
  1626.   This NetWare fix is available through IBM Support and Service by referencing 
  1627.   APAR IC07834. 
  1628.  
  1629. o Make sure the OS/2 NetWare requester is version 2.1. Otherwise NWDAEMON must 
  1630.   be executed after the LAN Distance connection has been established by issuing 
  1631.   DETACH C:\NETWARE\NWDAEMON. 
  1632.  
  1633.  
  1634. ΓòÉΓòÉΓòÉ 5.2. WAC Adapter Setup ΓòÉΓòÉΓòÉ
  1635.  
  1636. NOTE: The WAC Adapter must be configured through LAPS in LAN Distance. DO NOT 
  1637. configure this adapter through LAPS outside of LAN Distance. 
  1638.  
  1639. After installing the WAC Adapter, the ROM address will be displayed on your 
  1640. screen while your workstation is restarting.  Write this ROM address down and 
  1641. enter it during LAPS configuration. 
  1642.  
  1643. To configure the WAC Adapter: 
  1644.  
  1645.  1. Open the Settings notebook 
  1646.  
  1647.  2. Select the LAPS tab 
  1648.  
  1649.  3. Select LAPS 
  1650.  
  1651.  4. Edit or add the WAC adapter to the list of already-installed adapters. 
  1652.  
  1653.  5. On the WAC Adapter configuration panel, note the following items: 
  1654.  
  1655.    o Enter the ROM address of the WAC Adapter recorded above. 
  1656.  
  1657.    o For "Line Mode" enter 0 for Constant RTS. 
  1658.  
  1659.    o For "MAC Type Description" enter HDLC. 
  1660.  
  1661.    o When selecting NRZ vs NRZI, be consistent with the way you configured your 
  1662.      modem in LAN Distance.  If you used V.35 connection, select NRZ by 
  1663.      entering 0 for No. If you used generic synchronous switched or synchronous 
  1664.      leased line, select NRZI by entering 1 for Yes. 
  1665.  
  1666.      NOTE:  You may also use NRZ for generic synchronous switched or 
  1667.      synchronous leased line. However, you must carefully configure LAN 
  1668.      Distance to use it: 
  1669.  
  1670.       - Edit WCLNET.INI after all other installations to change the encoding 
  1671.         scheme from NRZI to NRZ. 
  1672.  
  1673.       - Make changes in Settings notebook to Phonebook and Answer Criteria 
  1674.  
  1675.         For synchronous switched: 
  1676.  
  1677.          -- In the Settings notebook Phonebook tab, select Add. 
  1678.          -- Select the Modem tab 
  1679.          -- Change the Encoding Scheme to NRZ. 
  1680.  
  1681.         For synchronous leased line: 
  1682.  
  1683.          -- In the Settings notebook Phonebook tab, select Add. 
  1684.          -- Select the Connect tab 
  1685.          -- Change the Encoding Scheme to NRZ. 
  1686.          -- In the Settings notebook Answer Criteria tab, select Add. 
  1687.          -- Select the Connect tab 
  1688.          -- Change the Encoding Scheme to NRZ. 
  1689.  
  1690.    o For "ANDIS PCM Support" enter 1 for YES. 
  1691.  
  1692.    o For "Slot Number" enter the slot number in which the adapter is inserted. 
  1693.  
  1694.    o For "Port Number" enter the port for which the adapter is configured. The 
  1695.      upper port is the one farthest from the system board; the lower port is 
  1696.      the one closest to the system board. 
  1697.  
  1698.    o For "Link Connection type" enter 1 for switched or 0 for non-switched 
  1699.      (leased line) connections. 
  1700.  
  1701.    o For "Portname displayed in the PPAT table" enter a name to identify the 
  1702.      adapter to the port connection manager. 
  1703.  
  1704.    o Typically, you can use default values for the rest of the parameters. 
  1705.  
  1706.  
  1707. ΓòÉΓòÉΓòÉ 5.3. Banyan VINES ΓòÉΓòÉΓòÉ
  1708.  
  1709. This section discusses Banyan VINES fixes and setup information to run Banyan 
  1710. VINES with the LAN Distance product. 
  1711.  
  1712. Banyan Fixes 
  1713.  
  1714. The following Banyan fix is in the Banyan Maintenance release 5.54(5). If this 
  1715. release is not available, then contact your Banyan SE. 
  1716.  
  1717. o You must modify the Banyan VINES protocol drivers for Banyan VINES and LAN 
  1718.   Distance to work together correctly: 
  1719.  
  1720.   Adjustable metrics were added for the NDIS protocol.  This required 
  1721.   modification to the server and client side drivers.  The server side is 
  1722.   adjusted dynamically; therefore, no configuration is required.  On the client 
  1723.   side an additional parameter was added for the NDIS configuration: 
  1724.  
  1725.       METRIC=xx
  1726.        - where xx is the configured metric for the client interface
  1727.  
  1728.   If the metric parameter is not used, NDIS will default to 2 for Ethernet and 
  1729.   16meg token ring, 4 for 4 meg token ring. This metric is a timeout value for 
  1730.   determining when to retransmit a frame. 
  1731.  
  1732.   The following summarizes metric parameters values: 
  1733.  
  1734.    Serial Port Speeds                 Metric values 
  1735.    9600, 19,200                       90 
  1736.    38,400                             80 
  1737.    57,600 and higher                  45 
  1738.  
  1739.   This parameter goes in the PROTOCOL.INI [VINES_XIF] section: 
  1740.  
  1741.       [VINES_XIF]
  1742.        DRIVERNAME=NDISBAN$
  1743.        BINDINGS="SOCKDD_MOD"
  1744.        LANABASE=0
  1745.        METRIC=90
  1746.  
  1747. Banyan OS/2 Workstation Setup 
  1748.  
  1749. See the LAN Distance Advanced Guide, Chapter 10, section "Configuring the LAN 
  1750. Distance Remote for Banyan VINES" for setting up a Banyan OS/2 workstation with 
  1751. LAN Distance. The following are 2 additional steps that are required for a 
  1752. token ring environment: 
  1753.  
  1754.  1. In a token ring environment, run PCCONFIG and make sure End Node Source 
  1755.     Routing is enabled. 
  1756.  
  1757.  2. Optionally, the Banyan Server can be configured to use Source Level Routing 
  1758.     (SLR). This is done under the Manage Communications option. However, the 
  1759.     server will use SLR in all responses to clients that are using SLR. 
  1760.  
  1761.  
  1762. ΓòÉΓòÉΓòÉ 6. Support and Feedback ΓòÉΓòÉΓòÉ
  1763.  
  1764. Refer to the License Information booklet in the LAN Distance package for 
  1765. problem reporting and assistance with the LAN Distance product. 
  1766.  
  1767. While not support mechanisms, the following two fora contain feedback, updates, 
  1768. and information on the LAN Distance product: 
  1769.  
  1770.      - OS2BBS, REMOTE section 
  1771.  
  1772.      - CompuServe, GO PSPAPROD, LAN DISTANCE section 
  1773.  
  1774.  
  1775. ΓòÉΓòÉΓòÉ 7. Appendix ΓòÉΓòÉΓòÉ
  1776.  
  1777. Appendix of other interesting topics. 
  1778.  
  1779.  
  1780. ΓòÉΓòÉΓòÉ 7.1. Printing Information from this On-line Document ΓòÉΓòÉΓòÉ
  1781.  
  1782. The OS/2 view function provides a print capability to the printer defined as 
  1783. the "default" printer for your system. From the "Services" popup, selecting 
  1784. print provides several options; Print All, Marked, or This Section(s), 
  1785. Contents, or Index. 
  1786.  
  1787. All but the Print Marked Sections are fairly self explanatory. To Print 
  1788. "Marked" sections one must first know how to "Mark". It is best to do this with 
  1789. the contents window fully expanded, ie. every section shows up in the content 
  1790. panel. Then simply press the space bar when the section you chose is 
  1791. highlighted or point and click the left mouse button while also holding the 
  1792. ctrl key to "mark" a section for print. 
  1793.  
  1794. The highlighting for "marked sections" is slightly larger than normal 
  1795. highlighting. To notice the difference, select an item in the contents and 
  1796. repeatedly press the space bar. 
  1797.  
  1798.  
  1799. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1800.  
  1801. The item in the title line is a trademark of IBM Corporation 
  1802.  
  1803.  
  1804. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1805.  
  1806. The item in the title line is a trademark of Microsoft Corporation 
  1807.  
  1808.  
  1809. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1810.  
  1811. The item in the title line is a trademark of Ungermann-Bass, Inc.