Space announcement This space provides the same content as before, but the organization of the home page has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Commands for generating tracing information


XBM includes tracing features to help with problem diagnosis and resolution.

BMC Customer Support might ask you to run these traces if you encounter an issue and need assistance.

These commands include:

  • PRINT DTRACE
  • PRINT ETRACE
  • SET PRINTTRACE
  • SET SHUTDOWNTRACE
  • SET ABENDTRACE
Warning

These commands can cause excessive output that can impact system performance. Use these commands only when directed by BMC Support to diagnose a problem.

The basic syntax for these options is as follows.

ssid commandName keyword

Message BMC73089I displays this diagnostic information. You can also send this information to the XBM SYSPRINT file.

Trace commands syntax

The following figure illustrates the syntax for the trace commands.

GUID-49A3A5D2-E50E-45E7-B4EC-A9A678087A0E-low.jpg

Trace commands descriptions

The following table describes the commands in more detail.

Commands for generating trace information

New tracing command

Description

Keywords

PRINT DTRACE

Prints diagnostic trace information

  • A blank (no keyword) prints the last 100 diagnostic trace items.
  • ALL prints the entire diagnostic trace table.
  • A number prints the specified number of diagnostic trace items.

PRINT ETRACE

Prints exception trace information

  • A blank value prints the last 50 exceptional trace items.
  • ALL prints the entire exceptional trace table.
  • A number prints the specified number of exceptional trace items

SET PRINTTRACE

Specifies that the DTRACE information should be printed as messages in the XBM SYSPRINT file as the messages are generated

Warning

The SET PRINTTRACE command can cause an excessive amount of messages to be generated when set to ON. Use this command only when you are trying to diagnosis a specific issue.

  • ON sends new messages issued by the PRINT DTRACE command to the XBM SYSPRINT file and the diagnostic trace table.
  • OFF disables the SET PRINTTRACE command.

SET SHUTDOWNTRACE

Specifies that trace information should be printed as messages in the XBM SYSPRINT file when the XBM subsystem shuts down

  • ON enables the SET SHUTDOWNTRACE command.
  • OFF disables the SET SHUTDOWNTRACE command.

SET ABENDTRACE

Specifies the number of lines of existing trace information that should be printed as messages to the XBM SYSPRINT file if the XBM subsystem abends

  • OFF disables the SET ABENDTRACE command. No trace information is printed.
  • A number specifies the number of trace entries to report.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*