IC86883: DATA SERVER FAILS TO START: OS RETURN CODE 1053 DUE TO MISSING INSTANCE1.DAT FILE

Fix Pack 5.1.1.2 (September 2013) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.5 (July 2014) for Tivoli Storage Productivity Center
4.2.2 Fix Pack 7 (July 2014) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.6 (March 2015) for Tivoli Storage Productivity Center
4.2.2 Fix Pack 8 (March 2015) for Tivoli Storage Productivity Center
4.2.2 Fix Pack 9 (May 2015) for Tivoli Storage Productivity Center
4.2.2 Fix Pack 10 (August 2015) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.9 (October 2015) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.12 (October 2016) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.13 (February 2017) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.14 (June 2017) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.15 (Sept 2017) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.8 (July 2015) for Tivoli Storage Productivity Center

APAR status

• Closed as program error.

Error description

• TPC Data server fails to start, OS return code 1053 presented
  instantly upon trying to start the service as a result of the
  instance1.dat file missing from <TPC_install_dir>/data
  directory.
  Instance1.dat is a file that contains the path to the JRE
  installed by TPC.  The TPC data server process needs to be able
  to
  locate its own JRE installation in the event this file is
  deleted or becomes corrupt.
  RECREATE STEPS:
  Attempt to start the TPC Data server process on a server where
  the <TPC_install_dir>/data/instance1.dat file is missing.
  Observe OS return code 1053.
  ________________________________________________________________
  DB2 Version used for Server:    N/A
  The defect is against component:   5608TPCS0
  Server/Manager build/release (TPC):   4.2.2
  Agent build/release (TPC):    N/A
  Server/Manager (OS):     All supported server platforms
  Agent (OS):       N/A
  ________________________________________________________________
  Problem as described by customer:    TPC Data server fails to
  start
  Initial customer impact (low/med/high):   high
  

Local fix

• Manually re-create instance1.dat file in <TPC_install_dir>/data.
  Within this file add the path to TPC's JRE.
  Windows example (default) path:  C:\Program
  Files\IBM\TPC\jre\java15\bin\java.exe.
  AIX/Linux example (default) path:
  /opt/IBM/TPC/jre/java15/bin/java
  Confirm path to java is correct, save the new instance1.dat file
  in the identified directory and restart the TPC Data server
  process.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All TPC users where instance1.dat (number    *
  *                 may vary) may have been removed.             *
  ****************************************************************
  * PROBLEM DESCRIPTION: See ERROR DESCRIPTION.                  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  -
  

Problem conclusion

• This APAR addresses the start up issue by attempting to use
  the java.exe installed with the TPC product, should the
  "instance*.bat" file be missing.
  
  The fix for this APAR is targeted for the following
  maintenance package:
  
  | fix pack | 4.2.2-TIV-TPC-FP0004 - target June 2013
  | fix pack | 5.1.1-TIV-TPC-FP0001 - target March 2013
  
  http://www-01.ibm.com/support/docview.wss?&uid=swg21320822
  
  The target dates for future fix packs do not represent a formal
  commitment by IBM. The dates are subject to change without
  notice.
  

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

  TPC STANDARD ED

• Fixed component ID

  5608TPCS0

Applicable component levels

• R422 PSY

     UP