IZ81303: ITM 622 FP2 UNIX AGENT CRASHES WHEN "AGENT MANAGEMENT SERVICES" WORKSPACE ACCESSED

IBM Tivoli Monitoring: Unix(R) OS Agent 6.2.2.2-TIV-ITM_UNIX-IF0007
IBM Tivoli Monitoring 6.2.2 Fix Pack 8 (6.2.2-TIV-ITM-FP0008)
IBM Tivoli Monitoring 6.2.2 Fix Pack 9 (6.2.2-TIV-ITM-FP0009)
IBM Tivoli Monitoring 6.2.2 Fix Pack 6 (6.2.2-TIV-ITM-FP0006)

APAR status

• Closed as program error.

Error description

• *************************** APAR Template
  *****************************
  
  Please open an apar with the following severity and information:
  Severity:         2
  Approver:         MK
  Reported Release: 622 FP1
  Compid:          5724C040U  Unix OS Agent
  Abstract:        Unix Agent crashes when "Agent Management
  Services"
                   workspace accessed
  Environment:     ITM 622 FP2
  
  Problem Description: Clicking on the "Agent Management Services"
  navigator item under UNIX OS in Physical view of Tivoli
  Enterprise
  Portal causes the Unix OS Agent to crash.
  
  The problem is due to a call to getutxid which returns a NULL
  value, but
  the code does not check for NULL.
  
  
  Local fix/workaround: Customer can temporarily disable
  the watchdog feature. To do this:
  
    Edit the ux.ini and comment out the line the starts
    with KCA_CAP_DIR.  (Note the value on the right might have
    a slightly different value based on the release).
      #  KCA_CAP_DIR=$CANDLEHOME$/config/CAP:/opt/IBM/CAP
    and add the line
       KCA_CAP_DIR=
  
     Stop and restart the OS Agent
  
  
  Related Files and Output:  The following messages are the last
  written
  to the
  log file when tracing is set to ALL.  The problem occurs in the
  "getUpTime"
  routine:
  
  (4C40ABB8.0038-1A:kcacmdsos.cpp,128,"GetPrUsage") Active RAS1
  Classes:
  EVERYT EVERYE EVERYU
  (4C40ABB8.0039-1A:kcacmdsos.cpp,128,"GetPrUsage") Entry
  (4C40ABB8.003A-1A:kcacmdsos.cpp,149,"GetPrUsage") Exit: 0x1
  (4C40ABB8.003B-1A:kcacmdsos.cpp,211,"collectRuntimeData") Exit
  (4C40ABB8.003C-1A:kcacmdsos.cpp,110,"getUpTime") Active RAS1
  Classes:
  EVERYT EVERYE EVERYU
  (4C40ABB8.003D-1A:kcacmdsos.cpp,110,"getUpTime") Entry
  
  ************************ End of APAR Template
  *************************
  

Local fix

• Local fix/workaround: Customer can temporarily disable
  
  the watchdog feature. To do this:
  
    Edit the ux.ini and comment out the line the starts
    with KCA_CAP_DIR.  (Note the value on the right might have
    a slightly different value based on the release).
      #  KCA_CAP_DIR=$CANDLEHOME$/config/CAP:/opt/IBM/CAP
    and add the line
       KCA_CAP_DIR=
  
     Stop and restart the OS Agent
  

Problem summary

• When the "Agent Mangement Services" workspace was selected in
  the Tivoli Enterprise Portal, the UNIX OS Agent would crash.
  

Problem conclusion

• The call to getutxid was returning a null value and the code was
  not checking for null before using the results.
  
  The fix for this APAR is included in the following maintenance
  vehicle:
      | interim fix | 6.2.2.2-TIV-ITM_UNIX-IF0003
      | fix pack | 6.2.2-TIV-ITM-FP0003
  

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

  ITM AGENT UNIX

• Fixed component ID

  5724C040U

Applicable component levels

• R622 PSY

     UP