IV03687: ALLOW USER TO OVERRIDE LOCATION FOR KCAWD.PID FILE GENERATION

IBM Tivoli Monitoring: Linux(R) OS Agent 6.2.2.4-TIV-ITM_LINUX-IF0004
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)

APAR status

• Closed as program error.

Error description

• PROBLEM DESCRIPTION:
  
  Provide a KCA environment variable to allow for over-riding the
  location where the kcawd.pid file is written and searched for.
  This will allow the file which is a read-write file to be placed
  in a separate directory for customers wanting to separate
  read-only and read-write files.
  
  The change requires an update to several scripts to modify the
  kcawd.pid file location.
  
  RECREATE INSTRUCTIONS:
  

Local fix

Problem summary

• Provide an environment variable to allow for overriding
  location where kcawd.pid and .kcawd_disable_stop files are
  written.  These files are currently written to
  $CANDLEHOME/$BINARCH/<pc>/bin directory. Customers who want
  to have these files written to a different location, in order
  to allow just 'Read-Only' files in the bin directory, can use
  the new environment variable KCAWD_WRITE_DIR.
  
  The new enviroment variable KCAWD_WRITE_DIR can be set in ux.ini
  or lz.ini file and must be set to an existing directory with
  read-write permissions.  For example:
     KCAWD_WRITE_DIR=$CANDLEHOME$/tmp
  
  NOTE: This new feature is supported by UNIX and Linux OS Agents
  using Watchdog.
  

Problem conclusion

• Code has been updated to check for the existence of
  KCAWD_WRITE_DIR and if set to a valid directory, the files are
  written to that location.  If the environment variable is not
  set or the directory specified does not exist, the current,
  default directory of $CANDLEHOME/$BINARCH/<pc>/bin will be used.
  
  The fix for this APAR is contained in the following maintenance
  packages:
  
    | interim fix | 6.2.2.4-TIV-ITM_UNIX-IF0004
    | interim fix | 6.2.2.4-TIV-ITM_LINUX-IF0002
    | fix pack | 6.2.2-TIV-ITM-FP0007
    | fix pack | 6.2.3-TIV-ITM-FP0001
  

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