Previous Topic: The Structured FormatNext Topic: The Assembler and CICS Areas Structured Display


The COBOL and PL/I Structured Display

You obtain a structured display by default when accessing main storage from:

To obtain a structured display when using CORE commands at the bottom of a current storage display, enter the command and press PF12 Structure.

Note: If you request a storage display and a structured format is not available, the dump format and a message are displayed.

The following diagram shows the structured format for a COBOL data structure:

      CA InterTest for CICS V9.1    - MAIN STORAGE UTILITY - Termid = U056                                                 Starting at Address =2370A140  Œ            Hexadecimal            Character    01 TASK-STRUCTURE                   |            Ž               |             02 TASK-CNTL                      | C3D5E3D3                   | CNTL           02 TASK-PROTCPF                    | D7D9D6E3 C3D7C640          | PROTCPF        02 TASK-PROTHLF                    | D7D9D6E3 C8D3C640          | PROTHLF        02 TASK-SWITCH                     | 40                         |                02 TASK-SWITCH2                    | F0F0                       | 00             02 TASK-SWITCH3                    | 40                         |                02 TASKNUM                         | 000000                     | ...            02 TASKNUM-CHAR                    | 000000                     | ...            02 TASK-TEXT                       |                            |                 03 TASK-ID-NO                     | 000F                       | ...            03 FILLER                         | 40                         |                03 TASK-MESG                      | E3C8C9E2 40C9E240 C140D4C5 | THIS IS A ME                                     | E2E2C1C7 C5404040          | SSAGE           03 FILLER                         | 40                         |                 03 TASK-DATE                      |                            |                ------------------------------------------------------------------------------  PF1 Help       2            3 End        4 Return     5            6 Dump        PF7 Backward   8 Forward    9 Caps Off  10           11 Redisplay 12 SDF       CORE='TASK-STRUCTURE'       CAIN0467 AT LAST ENTRY IN STRUCTURE 

The structured format displays COBOL data in DMAP sequence. The structure of a PL/I variable is presented similarly. Each field is discussed next.

Œ

Starting Address of the first item displayed. This is calculated from the contents of the BL and BLL cell and displacement for the requested data name.



DMAP or SYM MAP data levels and names for the requested structure.
A 77‑level item is displayed individually; other structured displays begin with the requested data item and include any items below it in the same 01 level.

Ž

Hexadecimal display area gives the storage contents of each field named on the left. Each byte is displayed as two hexadecimal digits, with spaces inserted after every four bytes. Up to 12 bytes are displayed per line. Fields longer than 12 bytes have multiple lines of hexadecimal display. This area is unprotected and you can overtype it to dynamically modify the data values displayed.

Note: Data areas defined in the DMAP or SYM MAP with a length of zero (for example, 0F or 0C13) will not display.



Character display area gives the character representation of each displayable byte for the field on the left. Hexadecimal 40s display as spaces; non‑displayable bytes are indicated by periods. This area is unprotected and you can overtype it to dynamically modify the data values displayed.



PF keys are listed below the storage display. Each is defined in Structured Displays later in this chapter.

CORE command line displays the CORE command entered or generated from a Source Listing Breakpoint storage request or a CORE menu. To request another structured display, modify the CORE command and press PF12. To request a dump format of a CORE display or to enter a CNTL command, modify the command and press Enter.

Message line. Always check the message line on a CORE display. This message states that the end of the requested data structure has been reached. (Page backward to display the beginning of a data structure or page forward when you are not at the end of the structure.) However, this message line also tells you if the requested area could not be found (the display shows the last area pointed to by CORE or the CSA), or if a COBOL field or PL/I variable displayed from a breakpoint contains valid data. An error message indicates when a field is invalid.