IBM TS2340 User Guide - Page 66
Atape System Trace (ATRC) Utility, Component Tracing, Tape Drive Service Aids
UPC - 883436006873
View all IBM TS2340 manuals
Add to My Manuals
Save this manual to your list of manuals |
Page 66 highlights
AIX Device Driver (Atape) This command stops the trace after the tape operations are performed. Enter the following AIX command to view the trace: trcrpt > trace.out This command formats the trace output into a readable form and places it into a file for viewing. Atape System Trace (ATRC) Utility The atrc trace utility is also installed with the device driver to start, stop, and format a device driver trace. To start the trace, enter the atrc command. To stop and format the trace, enter the atrc command again. The trace is formatted to an atrc.out AIX file in the current directory. Component Tracing Later releases of AIX 5.3 and above support component tracing. Unlike system tracing that needs to be started and stopped, component tracing by default is on all the time and runs continually. To determine if component tracing is available run the command ctctrl -q to display a list of supported components with their default settings. You must have root authority to run this command. Refer to the AIX ctctrl man page for a complete description of the ctctrl command and parameters. To dump and format the current component trace to a file (for example, actrc.out) into the current directory, run the following commands: ctctrl -D -c Atape trcrpt -l Atape -o actrc.out The Atape component trace can also be retrieved from a system dump. This eliminates the need to start the Atape system trace prior to a system dump or to recreate an AIX system dump when a system trace is not running. The AIX system dump is normally stored in the /var/adm/ras directory as a vmcore.x.BZ file, where x is a dump number 1, 2, and so on. To retrieve and format the Atape component trace from a dump file (for example, vmcore.1.BZ) to a file (for example, actrc.dump) into the current directory, run the following commands: dmpuncompress /var/adm/ras/vmcore.1.BZ trcdead -c /var/adm/ras/vmcore.1 trcrpt -l Atape -o actrc.dump Atape Component Trace (ACTRC) Utility The actrc component trace utility is also installed with the device driver to dump and format the current Atape component trace. To dump and format the component trace, run the command actrc. The trace is formatted to an actrc.out file in the current directory. Tape Drive Service Aids The service aids provided with the device driver can be called using the interactive interface of the tape utility program and selecting Tape Drive Service Aids under General Commands or using the Service Aid Subcommands in the command-line interface of the tape utility program. 48 IBM Tape Device Drivers Installation and User's Guide