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
, orPERFORM/END-PERFORM
. - When it is used inside of a
PROCEDURE
command.
LIST
command instead of the
COMMENT
command. For example:AT 10 LIST 'xxx';