Debugger Commands › LIST

LIST

Purpose

Displays selected areas of storage and session attributes at your terminal.

Syntax

MEMORY Format

►►─┬─ List ────┬─┬──────────┬─ begin-debug-expression ────────────────────────►
   └─ Display ─┘ └─ Memory ─┘

 ►─┬──────────────────────────────────┬──┬──────┬─────────────────────────────►◄
   ├─ TO end-debug-expression ────────┤  ├─ C ──┤
   └─┬──────────┬─ byte-count-number ─┘  ├─ X ──┤
     └─ LENgth ─┘                        └─ XC ─┘

ATTRIBUTES Format

►►─┬─ List ────┬─ SESsion ATTributes ─────────────────────────────────────────►◄
   └─ Display ─┘

Parameters

begin-debug-expression

Specifies the beginning location of the display. Begin-debug-expression can include multiple debug expressions and it resolves 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.

For more information on the values used in a debug expression, see Expression Components in Chapter 2, "Command Considerations."

end-debug-expression

Specifies the ending location of the display. End-debug-expression can include the same debugger entities as those specified in begin-debug-expression. The expression must resolve to a valid address for which you have retrieval security.

byte-count-number

Indicates the number of bytes to be displayed.

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

C

Requests a display in character format.

X

Requests a display in hexadecimal format.

XC

Requests a display in both hexadecimal and character format.

Usage

Two formats

There are two formats for the LIST command. The MEMORY format requests a display of the contents of memory; the ATTRIBUTES format requests a display of session attributes.

Rules for default length

When neither end-debug-expression nor byte-count-number is specified, the default length is based on these rules:

• If the 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 default length of the symbol.
• If the expression does not have data characteristics, the default length is 16 bytes.

Format specified for this command

XC/X/C specifies the format for the requested information. This specification can override the type of display previously established as a session attribute; the override is only valid for the duration of this command. See the ATTRIBUTES format of the SET command to reestablish the session attributes more permanently.

Example 1

This command requests a list of the storage contents beginning at @BF002, for a length of 48 bytes:

list @bf002 48

The debugger responds with a display of the beginning address and the requested storage contents:

000BF002      47F0 C028....    *...0............*
000BF010  58509002 ........    *................*
000BF020  4780C12A ........    *..A.............*
000BF030  4770                 *..              *

The first line of the storage display is indented for a space of two bytes, reflecting the exact beginning address.

Example 2

This command instructs the debugger to display the physical terminal element (PTE) control block from the beginning to the end of the entity. The length of the data field is determined by the data characteristics of the PTE.

list :pte

Example 3

The next command instructs the debugger to display storage contents beginning at @BF020. Since this expression has no data characteristics, the display defaults to 16 bytes.

list @bf020

Example 4

In debugging CA ADS dialogs you can use a data field name:

list date

The debugger responds by displaying the requested information:

001C2C50  F8F4F0F3  F0F1                *840301          *

Important! You cannot refer to data fields of Assembler, COBOL, or PL/I programs by name.

Example 5

You can also use a line number:

list #100

Example 6

When field names or line numbers are not unique, you must qualify them. This example lists line 100 from a process other than the current dialog process:

list 'process-b'.#100

Example 7

This example qualifies a request by specifying the display of a field name USERID-1301 from a record EMPLOYEE-1301:

list 'userid-1301' in 'employee-1301'

Example 8

This is an example of the ATTRIBUTES format:

DEBUG >
list session attributes

LIST SESSION ATTRIBUTES
LIST > SESSION ATTRIBUTES
        LIST:         CHAR
        TEST VERSION: 2
DEBUG >

This display indicates that DCUF TEST 2 and SET CHAR were issued.