COMMENT command

The COMMENT command can be used to insert commentary in to the session log. The COMMENT keyword cannot be abbreviated.

commentary: Commentary text not including a semicolon. An embedded semicolon is not allowed; text after a semicolon is treated as another z/OS® Debugger command. DBCS characters can be used within the commentary.

Usage notes

You can use the COMMENT command in remote debug mode by entering it in the Debug Console or the Action field, which is in the Optional Parameters section of the Add a Breakpoint task.

Examples

Comment that varblxx seems to have the wrong value.

COMMENT At this point varblxx seems to have the wrong value;

Combine a commentary with valid z/OS Debugger commands.
```
COMMENT Entering subroutine testrun; LIST (x); GO;
```

The COMMENT command can be used as an executable command, but it is treated as a Null command and no output is produced. For example, there will be no output of the COMMENT command in the following cases:

When it is specified as a command to be executed as an action of another command. For example:
```
AT 10 COMMENT xxx;
```
When it is used inside of any command that allows one to specify a sequence of commands such as DO/END, BEGIN/END, or PERFORM/END-PERFORM.
When it is used inside of a PROCEDURE command.

To get output in these cases, use the LIST command instead of the COMMENT command. For example:

AT 10 LIST 'xxx';