IT22683: INTEGRATION NODE ABEND ON STARTUP DUE TO CORRUPT HA LOCK FILE

APAR status

• Closed as program error.

Error description

• An integration node configured for high availability may abend
  on startup if the HA lock file repository_ha_active.lock in
  directory
  <HASharedWorkPath>/components/<integrationNodeName>/repository
  has become corrupted.
  
  The system log reports the BIP2001I message for the IBM
  Integration Bus service process starting, but this is then
  followed by repeated BIP2228E error messages to indicate that
  the agent process has abended. The abend files contain no stack
  information.
  
  A service trace of the agent process starting shows the
  following entries immediately prior to the abend:
  
    ImbConfigStore::obtainHALock  'Obtained the HA repository lock
  and the file handle is '
    ImbConfigStore::obtainHALock  'The HA lock count now = ' , 1
  } ImbConfigStore::obtainHALock
  
  The lock file should only contain the host name of the
  integration node that holds the lock, but the file size is
  reported as being unusually large (greater than 1024 bytes).
  

Local fix

• Remove the lock file and restart the integration node.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of IBM Integration Bus V9.0 and V10.0 using
  integration nodes configured for high availability.
  
  
  Platforms affected:
  z/OS, MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  An integration node configured for high availability may abend
  on startup if the HA lock file repository_ha_active.lock in
  directory
  <HASharedWorkPath>/components/<integrationNodeName>/repository
  has become corrupted.
  
  The system log reports the BIP2001I message for the IBM
  Integration Bus service process starting, but this is then
  followed by repeated BIP2228E error messages to indicate that
  the agent process has abended. The abend files contain no stack
  information.
  
  A service trace of the agent process starting shows the
  following entries immediately prior to the abend:
  
    ImbConfigStore::obtainHALock  'Obtained the HA repository lock
  and the file handle is '
    ImbConfigStore::obtainHALock  'The HA lock count now = ' , 1
  } ImbConfigStore::obtainHALock
  
  The lock file should only contain the host name of the
  integration node that holds the lock, but the file size is
  reported as being unusually large (greater than 1024 bytes). The
  file still contains the correct host name information, but the
  file size returned is being used on a re-write operation. If the
  file size is greater than 1024 bytes, storage corruption occurs.
  

Problem conclusion

• The product no longer abends on startup if the HA lock file size
  is greater than 1024 bytes.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v10.0      10.0.0.11
  v9.0       9.0.0.10
  
  The latest available maintenance can be obtained from:
  http://www-01.ibm.com/support/docview.wss?rs=849&uid=swg27006041
  
  If the maintenance level is not yet available,information on
  its planned availability can be found on:
  http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006308
  ---------------------------------------------------------------
  

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

  INTEGRATION BUS

• Fixed component ID

  5724J0530

Applicable component levels

• R900 PSY

     UP