IV32524: DOCUMENTATION FOR IMPACT INTERFACES NEEDS UPDATING

6.1.0-TIV-BSM-FP0004-zlinux
6.1.0-TIV-BSM-FP0004-windows
6.1.0-TIV-BSM-FP0004-solaris
6.1.0-TIV-BSM-FP0004-linux
6.1.0-TIV-BSM-FP0004-aix
6.1.0-TIV-NCI-FP0004-zlinux
6.1.0-TIV-NCI-FP0004-windows
6.1.0-TIV-NCI-FP0004-solaris
6.1.0-TIV-NCI-FP0004-aix
6.1.0-TIV-NCI-FP0004-linux
6.1.0-TIV-NCI-FP0003-zlinux
6.1.0-TIV-NCI-FP0003-windows
6.1.0-TIV-NCI-FP0003-solaris
6.1.0-TIV-NCI-FP0003-linux
6.1.0-TIV-NCI-FP0003-aix
6.1.0-TIV-BSM-FP0003-solaris
6.1.0-TIV-BSM-FP0003-aix
6.1.0-TIV-BSM-FP0003-zlinux
6.1.0-TIV-BSM-FP0003-windows
6.1.0-TIV-BSM-FP0003-linux
IBM Tivoli Business Service Manager V6.1.0 Fix Pack 2(6.1.0-TIV-BSM-FP0002)
IBM Tivoli Netcool/Impact V6.1.0 Fix Pack 2(6.1.0-TIV-NCI-FP0002)
IBM Tivoli Netcool/Impact V6.1.0 Fix Pack 4(6.1.0-TIV-NCI-FP0004)
IBM Tivoli Business Service Manager V6.1.0 Fix Pack 4(6.1.0-TIV-BSM-FP0004)
IBM Tivoli Netcool/Impact V6.1.0 Fix Pack 4(6.1.0-TIV-NCI-FP0004)

APAR status

• Closed as documentation error.

Error description

• Documentation for Impact interfaces needs updating.
  
  Impact provides several APIs that can be used in custom policies
  :
  
  http://publib.boulder.ibm.com/infocenter/tivihelp/v8r1/index.jsp
  ?topic=%2Fcom.ibm.netcoolimpact.doc6.1%2Fcommon%2Fdita%2Ffunctio
  ns_c.html
  
  When using these APIs, the parameters passed in as arguments
  need to always be variables, not arithmetic or derived.
  
  For example :
  
     AddDataItem("Ratemon_DT_Instance", NewInst- 4);
  
  
  fails, but :
  
     NewInst=NewInst-4;
     AddDataItem("Ratemon_DT_Instance", NewInst);
  
  is successful.
  
  Thsi restriction applies to all the Impact 5.1.1 and 6.1 APIs
  

Local fix

• Only pass variables nto Impact APIs
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All Impact Users                                             *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * When a variable is passed to a function, that variable will  *
  * be updated after the function is complete.  Because of this, *
  * you can't pass anything but variables to functions.          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Add information that functions should only be passed         *
  * variables otherwise an exception will be generated in the    *
  * logs                                                         *
  ****************************************************************
  

Problem conclusion

• Technote
  

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

Applicable component levels