DOCUMENT:Q315905  06-AUG-2002  [sna]
TITLE   :INF: Use the RetryConns Parameter to Retry Connection Attempts
PRODUCT :Microsoft SNA Server
PROD/VER::4.0,4.0 SP1,4.0 SP2,4.0 SP3,4.0 SP4
OPER/SYS:
KEYWORDS:

======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft SNA Server, versions 4.0, 4.0 SP1, 4.0 SP2, 4.0 SP3, 4.0 SP4 
 - Microsoft Host Integration Server 2000 
-------------------------------------------------------------------------------

SUMMARY
=======

The RetryConns parameter can be used to allow the 3270 applet or the 3270 client
(available in SNA Server 4.0 and Host Integration Server 2000 respectively) the
option to retry unsuccessful connection attempts when the failure is caused by
conditions defined as temporary. The temporary conditions (as defined in the SNA
Server 4.0 Resource Guide) include the following:

    - All Logical Units (LUs) in the requested pool are in use at that moment (code
   0x0057).
 - The requested LU pool is not found in the configuration, which may indicate
   that the server (through which the client is attempting to connect) is
   inactive (code 0x0A0E).
 - The requested connection is inactive at that moment (code 0x1002).
 - The host (or controller unit) has not yet responded with an Activate Physical
   Unit (ACTPU) command (code 0x1010).
 - The host (or controller unit) has not yet responded with an Activate Logical
   Unit (ACTLU) command (code 0x1011).

NOTE: The codes shown in the preceding bulleted items are from OPEN(SSCP) error
responses defined in the 3270 Emulator Interface Specifications (EIS) guide,
included in the SNA Server and Host Integration Server 2000 software developer
kits (SDKs).

The RetryConns parameter is set to No by default. In addition, note that there is
not a similar option for the 5250 applet and 5250 client.

MORE INFORMATION
================

Note the following when you attempt to implement the RetryConns parameter.

NOTE: With SNA 4.0 versions up to Service Pack 2, 3270 applet settings are stored
in the Win.ini file, found in the %WINDIR% directory (regardless of operating
system).

With SNA 4.0 versions Service Pack 3 and later, along with Host Integration
Server 2000, the 3270 applet and 3270 client settings are stored in the
Win3270.ini file, found in the user profile directories:

   Microsoft Windows 95, Microsoft Windows 98, and Microsoft Windows Millennium
   Edition (Me):

   <drive>:\WINDOWS\Application Data\Microsoft\SNA Server\win3270.ini

   Microsoft Windows NT 4.0:

   <drive>:\WINNT\Profiles\<user name>\Application Data\Sna
   Server\win3270.ini

   Microsoft Windows 2000 and later:

   <drive>:\Documents and Settings\<user name>\Application
   Data\Microsoft\Host Integration Server\win3270.ini

Edit the Win3270.ini file and add the RetryConns=yes parameter, as shown in the
following sample WIN3270.INI:

   [SnaServerWin3270]
   AutoConnect=1
   LUHostCountry=United States (037)
   LinkType=MS SNA Server
   LUOrPoolName=3270POOL
   TNHostAddr=
   TNHostPort=
   TNModel=
   TNDevice=
   FTSHostProgram=
   FTSParams=
   XFRParams=
   WindowLeft=143
   WindowTop=180
   WindowRight=1048
   WindowBottom=902
   ShowWindow=1
   WindowMaxX=-1
   WindowMaxY=-1
   ScriptName=Logon.lsc
   AutoLogonScript=
   Typeahead=
   "RetryConns=yes" (without the quotation marks)
   ConfigBufferSize=3688

When a temporary condition occurs the next time -- for example, "All LUs in the
requested pool are in use at that moment (code 0x0057)" -- the 3270 applet and
3270 client will display the following in the status line:

   No LU in LU group free. Retrying...

After an LU becomes available, the session will automatically reconnect.

REFERENCES
==========

For more information, browse to the following Microsoft Web site:

   http://www.microsoft.com/technet/prodtechnol/host/default.asp?frame=true

For additional information, click the article number below to view the article in
the Microsoft Knowledge Base:

   Q293780 Type-Ahead Disabled After Upgrade to SNA Server 4.0 SP3, SP4, or HIS
   2000

Additional query words:

======================================================================
Keywords          :  
Technology        : kbAudDeveloper kbSNAServSearch kbHostIntegServ2000 kbSNAServ400 kbSNAServ400SP1 kbSNAServ400SP2 kbSNAServ400SP3 kbSNAServ400SP4
Version           : :4.0,4.0 SP1,4.0 SP2,4.0 SP3,4.0 SP4
Issue type        : kbhowto kbinfo

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 2002.