Data stream capture

The probe can capture the stream of data from the socket endpoint and store it in a file. The data can be used for debugging purposes, to develop new features for the probe, or to pass onto other management systems that require the same data.

To capture the data stream in log files, use the following procedure:

  1. Set the value of the StreamCapture property to 1.
  2. Set the value of the StreamCaptureFile property to the full path of a directory to hold the data file.
    Notes:
    • Specify the full path to the file. For example:

      /opt/IBM/tivoli/netcool/omnibus/var/socket_java.stream

    • You cannot include variables such as $OMNIHOME in the directory path.
    • The directory must exist. The probe does not create the directory if it does not exist.
  3. If the probe is running, restart it.

The probe now writes stream data to the specified file. If the path specified is invalid or an empty path, the probe will automatically reset the path to $OMNIHOME/probes.

Note: Capturing the data stream to a log file generates a lot of data, consuming a lot of disk space and other system resources. So use this feature with caution. As soon as you no longer require the capture of data, set the value of the StreamCapture property to 0 and restart the probe.