Debugging in Menu Mode › Activity Screens › List Screen

List Screen

Purpose

You can use the List screen to display storage areas, session attributes, and debugger symbols at your terminal. The List screen can be used during setup and at runtime.

The specification area of the List screen looks like:

  LIST: M (M-MEMORY/A-ATTRIBUTES)
  MEMORY ONLY:
         BEGIN LIST AT:

         LENGTH.......:         - OR -    END LIST AT:

         LIST FORMAT..: B (C-CHARACTER/X-HEX/B-BOTH)

Field Options

These are the field options for this area:

LIST: M (M-MEMORY/A-ATTRIBUTES)

• M(the default) requests a list of an area of memory specified in the Memory Only section of the screen
• A requests a list of current session attributes; no other options need to be specified on the screen in this case

BEGIN LIST AT:

Specifies the beginning location for the display. The beginning location can include one or more debug expressions resolving to an address for which you have retrieval security.

For information on the security methods used by the debugger, see CA IDMS Security Administration Guide. This field is required if a memory display is selected.

LENGTH........:

Specifies the number of bytes to be displayed.

END LIST AT:

Specifies the ending location for the display. The ending location can include the same debugger entities as those specified for the beginning location.

Important! If a resource is listed and the length or ending location exceeds the resource boundary, the list is truncated at the boundary and the debugger issues a warning message.

When neither Length nor End List At is specified, the length of the display is based on two rules:

• If the debug expression is composed of a single symbol, the data characteristics of the symbol determine the default length. The number of bytes displayed is equal to the length attribute of the symbol.
• If the expression does not have data characteristics, the default length is 16 bytes.

LIST FORMAT..: B (C-CHARACTER/X-HEX/B-BOTH)

• C requests a display in character format
• X requests a display in hexadecimal format
• B (the default) requests a display in both character and hexadecimal format