Start of change

DSNW300I csect-name DISPLAY OTEL REPORT FOLLOWS:

Explanation

This message displays output from the DISPLAY OTEL command. The format of the output depends on the value of the DETAIL option that was specified on the command.

Output heading for DISPLAY OTEL

DSNW300I  -DB2A csect-name DISPLAY OTEL REPORT FOLLOWS:        
     STATUS = otel-status
csect-name
The name of the control section that issued the message.
otel-status
STARTED
OTel is started.
STOPPED
OTel is stopped

OTel emit status

EMIT= emit-status

Indicates whether OTel emits extended SMF records.

YES
OTel emits extended SMF records.
NO
OTel does not emit extended SMF records.

OTel detail section

This section is present when the DETAIL keyword is specified and OTel is started.

TRACE PARENT: SAMPLING ON = sample-on-count
              VALID       = valid-tp-count
              INVALID     = invalid-tp-count
TRACE STATE:  VALID       = valid-ts-count
              TRUNCATED   = trunc-ts-count
              INVALID     = invalid-ts-count
valid-tp-count
Number of traceparent values received with sampling ON flag.
invalid-tp-count
Number of valid traceparent values received.
valid-ts-count
Number of valid tracestate values received.
trunc-ts-count
Number of tracestate values received that were greater than 512 characters and truncated to 512 characters.
invalid-ts-count
Number of invalid tracestate values received.

OTel start time

This line is displayed if OTel has ever been started after the Db2 subsystem was started.

LAST STARTED hh:mm:ss mmm ddd, yyyy

Explanation

OTel

This line is displayed if OTel has been stopped after first being started.

LAST STOPPED hh:mm:ss mmm ddd, yyyy

End of output for -DISPLAY OTEL

This line indicates the end of the report

DISPLAY OTEL REPORT COMPLETE.

System action

Processing continues.

User response

No action is required.

Examples

  • If OTel was never started in the Db2 subsystem, the output is similar to the following example.

    DSNW300I -DB2A DSNWVCM3 DISPLAY OTEL REPORT FOLLOWS:
STATUS = STOPPED
DISPLAY OTEL REPORT COMPLETE.

  • If OTel has been started, stopped, and restarted, the output is similar to the following example.

    DSNW300I -DB2A DSNWVCM3 DISPLAY OTEL REPORT FOLLOWS:
STATUS = STARTED
EMIT = YES
RECORDS EMITTED: SUCCESSFUL = 30
FAILED = 0
LAST STARTED 18:20:36 JUL 23, 2025
LAST STOPPED 18:14:32 JUL 23, 2025
DISPLAY OTEL REPORT COMPLETE.

  • If OTel was started with the EMIT(YES) option and the DETAIL keyword was specified in the DISPLAY OTEL command, the result is similar to the following example. In this example output, Db2 received 42 valid traceparent values, 35 of which had the sampled bit ON, and 5 also included tracestate. These input OTel trace context values resulted in Db2 emitting 35 span records.

    DSNW300I -DB2A DSNWVCM3 DISPLAY OTEL REPORT FOLLOWS:
STATUS = STARTED
EMIT = YES
RECORDS EMITTED: SUCCESSFUL = 35
FAILED = 0
TRACE PARENT: SAMPLING ON = 35
VALID = 42
INVALID = 0
TRACE STATE: VALID = 5
TRUNCATED = 0
INVALID = 0
LAST STARTED 18:20:36 JUL 23, 2025
LAST STOPPED 18:14:32 JUL 23, 2025
DISPLAY OTEL REPORT COMPLETE.
  • If OTel was started with the EMIT(NO) option and the DETAIL keyword was specified in the DISPLAY OTEL command, the result is similar to the following example. In this example output, Db2 received 20 valid traceparent values, all of which had the sampled bit ON, and 5 also included tracestate. Because OTel was started with EMIT(NO) option, no span records were emitted by Db2.
    DSNW300I -DB2A DSNWVCM3 DISPLAY OTEL REPORT FOLLOWS:
STATUS = STARTED
EMIT = NO
TRACE PARENT: SAMPLING ON = 20
VALID = 20
INVALID = 0
TRACE STATE: VALID = 5
TRUNCATED = 0
INVALID = 0
LAST STARTED 18:32:19 JUL 23, 2025
LAST STOPPED 18:25:08 JUL 23, 2025
DISPLAY OTEL REPORT COMPLETE.
End of change