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.

AT



COBOL

PL/I

Assembler

C Language

Description

The AT command sets a before breakpoint in a sourceless program. This command lets you test and debug programs that do not have a source listing available, such as old modules and third party packages.

The AT command can be entered from the Source, Log, Memory, and Show screens. The AT command is not valid in an unattended batch test.

Input

image2021-2-15_14-28-19.png

The following are the parameter descriptions for the AT command:

address

A 24- or 31-bit address.

CSECT-name

The name of a CSECT. If the CSECT exists in the current load module, enter the CSECT-name followed by a single colon (:). If the CSECT is not in the current load module, the CSECT-name must be preceded by the load module name and double colons (::) and be followed by a single colon (:).

offset

Identifies an area in storage relative to the beginning of the area. It must include a plus sign (+) followed by a valid hexadecimal number.

Usage Notes

ALL Languages

  1. When the AT breakpoint is reached, the AT Display screen shows your program in dump format. Reissue the AT command to set additional breakpoints.
    1. Use the DELETE command to remove specific breakpoints.
    2. You can enter the AT command in an initial or post test script.

COBOL

  1. You cannot use the REVERSE command when stopped at an AT breakpoint.

Examples

ALL Languages

  1. To set a breakpoint at CSECT SAMPLE, enter the following:
       AT SAMPLE:
  2. To remove a breakpoint at offset +3e in CSECT SAMPLE, enter the following:
       DELETE AT SAMPLE:+3e
  3. To set a breakpoint at offset +60 in the subprogram TRITSTA, enter the following:
      AT TRITSTA:+60
  4. To remove a breakpoint at address 45a09e8, enter the following:
      DELETE AT 45a09e8

 

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