Enabling a Space Management client trace

You can trace the space management client by adding trace options to the dsm.opt client options file.

Procedure

  1. Determine the trace classes that you want to enable for the space management client. See Client trace classes for the space management client for a list of trace classes.
  2. Add trace options to the dsm.opt client options file.
    1. Specify the trace classes that you want to enable or disable with the traceflags option. You can list one or more trace classes. Separate each trace class with a comma and no space. Use a minus sign (-) in front of a trace class to disable the trace. Put all disabled trace classes at the end of the list. For example, if you want to collect a SERVICE trace without the SESSION or SESSVERB classes, then specify the following option:
      traceflags service,-session,-sessverb
    2. Specify the location of the trace output file by using the tracefile option. The tracefile option must specify a complete file path. The following example specifies a complete file path:
      tracefile /home/spike/trace.out
    3. Optional: Set a maximum size for the trace output by using the tracemax option.

      If you specify the tracemax option, the trace information wraps and writes over the beginning of the data when the output reaches the specified size. The end of the trace information is indicated by "END OF DATA". When data wraps, the end of the output contains "Continued at beginning of file". Consider a maximum trace size if you are trying to capture an event that happens at the end of a long process.

      If you specify a tracemax value of 1001 or greater and the tracesegsize option is not specified, then the trace output is split into several files. Each file is the default segment size, 1000 MB.

      Specify the maximum size for the trace output in MB. Valid values are 1 - 4294967295.

      For example, to set a maximum output size of 4096 MB, use the following option: tracemax 4096
    4. Optional: Specify a trace segment size.

      Splitting the trace into segments allows easier management of large amounts of trace data. With small files, you do not have to compress or use a separate file splitter utility.

      Specify the value in MB. Valid values are 1 - 1000.

      Each trace file name contains the value of tracefile and appends a number, beginning with 1.

      For example, if you specify tracefile /home/spike/trace.out and tracesegsize 200, then the trace is segmented into separate files of no more than 200 MB each. The files are named /home/spike/trace.out.1, /home/spike/trace.out.2, and so on.
  3. Run the operation or restart the HSM daemons to enable the daemon tracing.

Results

The space management client creates trace output during the operation.

What to do next

You can also configure and start tracing from a command line. The following example specifies trace options in command format:

dsmmigrate -traceflags=service,-session,-sessverb -tracefile=/home/spike/trace.out -tracemax=4096 -tracesegsize=200