ADSM provides trace routines which can provide you with diagnostic information if you incur a processing problem at your workstation. This information can be extremely useful in resolving the problem.
In order for ADSM to capture diagnostic information, you must activate trace settings or flags. You can use the QUERY TRACESTATUS command to display whether tracing is active for a specific trace flag or all flags. For example, to show a list of all trace flags that are currently active, use:
dsmc Query Tracestatus -ON
Other options are also available for the QUERY TRACESTATUS command. See QUERY TRACESTATUS--Display Trace Status for more information.
The client trace facility provides these options: TRACEMAX, TRACEFILE, TRACEFLAGS, and NOTRACE. You can use these options with most ADSM commands. You can also use these options to override settings in the options file.
If you are in an interactive command session when you enter the options, they remain in effect until you end the session.
The TRACEMAX option enables you to specify the maximum size for the tracefile.
When you enter trace options from the command line or in the options file, we recommend the following sequence:
Following this order will ensure that all trace entries from the start of the trace will go into the file that you specify.
The TRACEFILE option enables you to save your trace output to a file instead of displaying it on the client console. For example, to archive the files in your /u/user/prog directory and save the trace output to a file, you can enter:
dsmc Archive -TRACEFIle=trace.out -TRACEFLags=all "/u/user/prog/*"
To save your trace output while you are using the graphical user interface, use the TRACEFILE option when you start the GUI:
dsm -TRACEFIle=trace.out -TRACEFLags=all
You can send the trace data to dsmerror.log so that you can see the relevant ANS error messages and how they relate to the trace data.
If you do not use the TRACEFILE option, the output is sent to your client console display.
The TRACEFLAGS option enables you to set specific trace flags. For example, if you are having a problem with the INCREMENTAL command, you might want to turn on the ERROR trace flag when you execute the command. The ERROR trace flag captures all severe error messages. You can turn it on by entering:
dsmc Incremental -TRACEFLags="error"
You can turn on all of the trace flags by using the ALL parameter. You can also use the ALL parameter with exceptions. For example, to back up a specific file and turn on all of the trace flags except COMMFULL and NLS (both of which generate a large amount of data), enter the following command:
dsmc Selective -TRACEFLags=all,-commfull,-nls /home/spot/myfile
To turn on particular trace flags while you are using the graphical user interface, specify the TRACEFLAGS option when you start the GUI:
dsm -TRACEFLags=general,session
You can turn off all tracing by using the NOTRACE option. For example, to turn off the tracing when using the INCREMENTAL command, you can enter:
dsmc Incremental -NOTrace
To turn off tracing while you are using the graphical user interface, specify the NOTRACE option when you start the GUI:
dsm -NOTrace