IT14489: ERROR DB21018 LOGGED IN AIX SYSLOG FILE WHEN SERVICE SCRIPT IS EXECUTED

IBM Spectrum Control V5.2.10 (May 2016)
IBM Spectrum Control V5.2.10.1 (July 2016)
IBM Spectrum Control V5.2.11 (August 2016)
IBM Spectrum Control V5.2.12 (November 2016)
IBM Spectrum Control V5.2.13 (March 2017)
IBM Spectrum Control V5.2.14 (May 2017)
IBM Spectrum Control V5.2.15 (August 2017)
IBM Spectrum Control V5.2.15.2 (November 2017)
IBM Spectrum Control V5.2.16 (March 2018)
IBM Spectrum Control V5.2.17 (May 2018)

APAR status

• Closed as program error.

Error description

• On AIX, when the service script (e.g. service.sh or service.sh
  -db) is executed, the following error is logged in the AIX
  syslog file:
  "DB21018 - CLP system error : sqlogpid returns ppid -1"
  
  Root cause of this problem is piping the output to /dev/null (vs
  running db2support in the background).
  If the output from the runCmdStats script is sent to a file
  instead of /dev/null, the error is not written to the syslog
  file.
  
  This line:
  su - <instance_name> -c "db2support /opt/IBM/TPC/service/data/db
  -d TPCDB -s" &> /dev/null
  
  Changed to this:
  su - <instance_name> -c "db2support /opt/IBM/TPC/service/data/db
  -d TPCDB -s"  | tee /opt/IBM/TPC/service/data/db/db2support.out
  
  This change needs to happen in the code because the
  runStatsCmd.sh file is dynamically generated at runtime.
  That is, when service.sh is execuded code is invoked to writes
  the runStatsCmd.sh file to the disk at that time.
  

Local fix

• 01. Execute the service script -- "service.sh" or "service.sh
  -db"  (no quotes)
  02. After the database service files are collected, check the
  AIX syslog for "DB21018".
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * TPC and IBM Spectrum Control 5.2.x users on AIX              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * During the collection of DB2 support/service data on AIX, an *
  * error message is written to the syslog file.                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * The error message does not interfere with DB2                *
  * support/service data being collected.  Apply fix maintenance *
  * when available to alleviate the error condition.             *
  ****************************************************************
  

Problem conclusion

• The fix for this APAR is targeted for the following maintenance
  package:
  
  | refresh pack | 5.2-TIV-TPC-RP0010 - target 2Q16
  
  Fixed in IBM Spectrum Control 5.2.10.
  
  http://www.ibm.com/support/docview.wss?&uid=swg21320822
  
  The target dates for future refresh 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:

Modules/Macros

• SERVICE
  

Fix information

• Fixed component name

  TPC

• Fixed component ID

  5608TPC00

Applicable component levels

• R522 PSY

     UP

• R526 PSY

     UP

• R527 PSY

     UP

• R528 PSY

     UP

• R529 PSY

     UP