Skip to Content
Information
Space announcement This documentation space provides the same content as before, but the organization of the content 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.

MONITOR


COBOL




Description

The MONITOR and REVERSE commands are used to activate review mode. Review mode enables you to record and then review the execution path by reversing the direction of program execution. When review mode is active, the direction in which the current review is processing, Forward or Reverse, will be displayed on the execution status line.

Use the MONITOR command before executing your program to record execution. Then use the REVERSE command to review the execution history by tracing through the recorded history in the reverse direction. You can see the execution path and the changing data values as you review program execution.

MONITOR records the program’s execution in a buffer. The default buffer size is 1M. Code Debug TSO wraps and overwrites the existing data when the buffer is filled. Use the SET REVSIZE command to increase or decrease the buffer size.

Review mode is not valid in an unattended batch test.

Input

image2021-2-16_11-34-51.png

The following are the parameter descriptions for the MONITOR command:

module-name

The name of the module where execution is located.

module-list

A list of module names.

ALL

A keyword used to review the execution of all COBOL modules with a source listing member.

RESET

A keyword used to reset the monitor mode.

Usage Notes

  1. MONITOR without a module name records history for the current module, which is not necessarily the active module where execution is located, but the module indicated by the PROGRAM field on the third header line.
  2. Use a list of module names to monitor the execution path that spans multiple called COBOL modules.
  3. Use the DELETE command to stop recording the execution history.
  4. The REVERSE and RESUME commands are valid only if MONITOR has first been turned on.
  5. Issuing a MONITOR ALL command in an initial script or at the beginning of the test session allows you to review the execution of all COBOL statements.
  6. If MONITOR is turned on, MNTR will be displayed in the first header line. You can also use the SHOW SETS command to view the status of the MONITOR function.

 

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

BMC AMI DevX Code Debug for TSO and IMS 17.02