# SP Get TDULog Subcommand

access: Administrators, Managers

The Troubleshooting Dump Utility (TDU) captures, analyzes, and displays debug data.

When you execute this command, this data is gathered and analyzed. Analyzed data displays in the console window when the command completes. Raw data, the summary file, and the analyzed data can be saved in a tar file.

> sp get tdulog
> [{-f | --filename} FILENAME]
> [{-c | --cpuregs} CPU REGISTERS]
> [{-p | --pciregs} PCI REGISTERS]
> [{-r | --reset} RESET PLATFORM]

Argument | Description
--- | ---
{-f | --filename} | Use this option to specify the name of the output file to which the log files are copied (for example, tdulog.tar), or a fully qualified path name (for example, /logs/<hostname>/tdulog.tar, (where the <hostname> is the hostname of the Service Processor). Storing to a file is only available if you have configured an external file system. If you do not want to save the raw output, specify stdout, to view output as it is returned. (In this case, the analyzed data displays after the raw data.) Filenames cannot contain the backward relative path reference (..) or the less than symbol (<). The following log files are created by default: envLog: contains the environment variables vpdLog: contains raw VPD data Additional log files are created for CPU2 and CPU3 registers. You can use the tar command on UNIX machines or the WinZip program on Windows machines to extract the files.
{-c | --cpuregs} | Reads the K-8 registers (GPRs, MSRs, TCB and machine check) from up to four CPUs.
{-p | --pciregs} | Reads all PCI registers on the system.
{-r | --reset} | Resets the platform if unable to access HDT mode.

The register name, address, and data is logged to a file. For example:

> CPU0
> Reg Name.............................. Reg Addr Reg......Data
> MSR_MCG_CAP_MSR.......... 0xc0020179..........0x0000000000000105
> MSR_MCG_STAT_MSR........ 0xc002017a..........0x0000000000000000
> MSR_MCG_CTL_MSR.......... 0xc002017b..........0x000000000000001F
> MSR_MC0_CTL.................... 0xc0020400...........0x000000000000007F

Return Codes

Following are the return values for this command:

Code | Numeric Code | Description
--- | --- | ---
NWSE_Success | 0 | Command successfully completed.
NWSE_InvalidUsage | 1 | Invalid usage: bad parameter usage, conflicting options specified.
NWSE_NotFound | 5 | Specified path and directory was not found.
NWSE_NoPermission | 6 | Not authorized to perform this operation.
NWSE_MissingArgument | 7 | Missing argument(s).
NWSE_UnknownError | 15 | Miscellaneous error not captured by other errors.
NWSE_FileError | 18 | No space to create the log file.
NWSE_NotMounted | 21 | File system is not mounted.
NWSE_ServiceNotAvailable | 24 | Requested service is not available.

Related Topics

System Management Commands

SP Command