PM73395: 'Server Reties', 'Server Wait Time' and 'Server Usage Connect Timeout' do not work when agent service got problem

Rational Build Forge Interim Fix 1 for Version 7.1.3.4

APAR status

• Closed as program error.

Error description

• 1. Problem Description
  
  'Server Reties', 'Server Wait Time' and 'Server Usage Connect
  Timeout' do not work when agent service got problem
  
     details:
      a. Build Forge honors 'Server Wait Time' and 'Server Usage
  Connect Timeout' when low-level networking problem(e.g.
  disconnect cable)
  
      b. But, Build Forge retries connection at every seconds when
  agent service got problem
         (stop agent service, or stop xinetd). And job fails
  before rearch to 'Server Usage Connect Timeout'
  
      c. In either case, Build Forge does not honor 'Server
  Retries = 0
  
  2. Environment
     Build Forge 7.1.3.2 on Windows 2008
  
  3. Reproduce steps
     a. start a job
     b. wait until a step is running
     c. stop agent service
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Server Retries: This sets the number of times the system
  attempts to allocate a step to a server before it gives up
  and fails. The server attempts to match all of the selected
  conditions.
  
  Server Wait Time: The Server Wait Time is no longer used.
  
  Server Usage Connect Timeout: This sets the maximum number
  of seconds after creating an agent connection that the
  Management Console waits for the connection to open before
  failing. If the connection receives a socket error, or fails
  the code before reaching this timeout, the connection still
  fails.
  
  Sets the timeout value for an existing connection to an
  agent: The agents are designed to contact the Management
  Console every 15 seconds. If no contact is made during a
  timeout period, the agent might have stopped or there might
  be network communication issues. The step fails if this
  value is exceeded.
  

Problem conclusion

• Server Retries: This sets the number of times the system
  attempts to allocate a step to a server before it gives up
  and fails. The server attempts to match all of the selected
  conditions.
  
  Server Wait Time: The Server Wait Time is no longer used.
  
  Server Usage Connect Timeout: This sets the maximum number
  of seconds after creating an agent connection that the
  Management Console waits for the connection to open before
  failing. If the connection receives a socket error, or fails
  the code before reaching this timeout, the connection still
  fails.
  
  Sets the timeout value for an existing connection to an
  agent: The agents are designed to contact the Management
  Console every 15 seconds. If no contact is made during a
  timeout period, the agent might have stopped or there might
  be network communication issues. The step fails if this
  value is exceeded.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  BUILD FORGE EE

• Fixed component ID

  5724S2701

Applicable component levels

• R713 PSN

     UP