IJ02490: SCRIPTING FEATURE DOES NOT ALLOW .REF LOCATION TO BE CHANGED.

IBM Tivoli Monitoring: Unix(R) OS Agent 6.3.0.7-TIV-ITM_UNIX-IF0002
IBM Tivoli Monitoring 6.3.0 Fix Pack 7 Service Pack 1 (6.3.0.7-TIV-ITM-SP0001)
IBM Tivoli Monitoring: Unix(R) OS Agent 6.3.0.7-TIV-ITM_UNIX-IF0003
IBM Tivoli Monitoring: Unix(R) OS Agent 6.3.0.7-TIV-ITM_UNIX-IF0004
IBM Tivoli Monitoring: Linux(R) OS Agent 6.3.0.7-TIV-ITM_LINUX-IF0002
IBM Tivoli Monitoring: Linux(R) OS Agent 6.3.0.7-TIV-ITM_LINUX-IF0003

APAR status

• Closed as program error.

Error description

• Environment:      630 FP5 through 630 FP7
  The scripting feature automatically generates a .ref file which
  contains information for the script to run.   Currently the OS
  Agent defaults the location for this file to the
  $CANDLEHOME/<interp>/<pc>/bin directory.   If this directory is
  read-only then the file cannot be generated and the script
  cannot be run.  The agent does not allow the location to be
  changed.
  Approver:         MK
  Submitted as part of Case: TS000049921
  

Local fix

• NA
  

Problem summary

• Scripting feature does not allow .ref location to be changed
  
  
  The scripting feature automatically generates a .ref file which
  contains information for the script to run.  Currently the OS
  Agent defaults the location for this file to the
  $CANDLEHOME/<interp>/<pc>/bin directory.   If this directory is
  read-only then the file cannot be generated and the script
  cannot be run.
  
  In order for this APAR to be properly implemented in your
  environment, a new environment variable has been added.  See the
  "Install Actions" section of the APAR conclusion for more
  details.
  

Problem conclusion

• A new environment variable has been added for this fix.
  
  Install Actions
  
  In order for this APAR to be properly implemented in your
  environment, a new environment variables has been added:
  FCP_REF_FILE_PATH.  To specify a different location for the .ref
  file, set value to a valid path that has read-write authority,
  for example:
     K<XX>_FCP_REF_FILE_PATH=/opt/IBM/ITM/logs
  
  where <XX> is:
     LZ = Linux OS Agent
     UX = UNIX OS Agent
     NT = Windows OS Agetn
  
  The default if the environment variable is not set, is to
  continue to use the location $CANDLEHOME/<interp>/<pc>/bin.
  
  
  The fix for this APAR is contained in the following maintenance
  packages:
  
    | interim fix | 6.3.0.7-TIV-ITM_LINUX-IF0001
    | interim fix | 6.3.0.7-TIV-ITM-UNIX-IF0002
    | service pack | 6.3.0.7-TIV-ITM-SP0001
  

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 LINUX

• Fixed component ID

  5724C04LN

Applicable component levels