Display Auxiliary Storage in Structured Format

Debugging Programs › Inspect and Modify Auxiliary Storage › Display Auxiliary Storage in Structured Format

Display Auxiliary Storage in Structured Format

FILE can display file, transient data, and temporary storage records or DL/I segments field-by-field in structured format using the Assembler DSECT. To display a record or segment in structured format, you must identify the program containing the structure. Symbolic information for this program must be saved in the CA InterTest for CICS Symbolic File.

Follow these steps to display a record or segment in structured format:

If the FORMAT field does not contain S, press PF2 until FORMAT= S is appears. The USE=field now appears after the FORMAT field.
Identify the program and structure in the USE= field. Specify the command as follows:
```
USE=symbolic-name.structure-name
```
symbolic-name is the name of the program as defined in the CA InterTest for CICS Symbolic File.

structure-name is the Assembler DSECT.

Press Enter.

CA InterTest for CICS displays the record or segment in structured format. A sample VSAM record in structured format follows.

DATATYPE= FC FILEID= ORDERFIL MODE=      LOG=OFF TODEST=        PASSWORD=  
FUNC=      SUBFUNC=      RETMETH=        ARGTYP=    SRCHTYP= 
 MESSAGE= RECORD OBTAINED FOR VIEWING
  RETNRCID=F0F0F0F0F0F0F0F0F0F2                                   CHGELEN= 
     RCID= C'0000000002' 
     DATA=                                                        SIZE= 0320 
 FORMAT= S USE= ASMDEMO.DFHEISTG 
 LOC 00B8  Displacement               Hexadecimal                  Character 
 ------------------------------------------------------------------------------ 
 DFHEIUSR            B8 | 00                                  | . 
 TSQNAME             B8 | 00000000 00000000                   | ........ 
 TSQTRAN             B8 | 00000000                            | .... 
 TSQTERM             BC | 00000000                            | .... 
 TSAREA              C0 | 00C3D6D9 D7F6F0F5 F4F40000 000000C7 | .CORP60544.....G 
                        | D6D6C440 D7D9C9C3 C5000000 00000000 | OOD PRICE....... 
                        | 000000C2                            | ...B 
 TSSWITCH            C0 | 00                                  | . 
 TASKNUM             C1 | C3D6D9                              | COR 
 TSTEXT              C4 | D7F6F0F5 F4F40000 000000C7 D6D6C440 | P60544.....GOOD 
                        | D7D9C9C3 C5000000 00000000 000000C2 | PRICE..........B 
                        |                                     | 
 ------------------------------------------------------------------------------ 
 1 Help       2 Format D   3 End        4 BEGB       5 PREV      6 DataType DL 
 7 Page bwd   8 Page fwd   9 Caps Off  10 Top      11 Bottom    12

Structured format lists the contents of each data name in both hexadecimal and character format. To modify the record or segment, overtype either the hexadecimal or character data and press Enter. To rewrite the modified record, type PUT in the FUNC= field and press Enter.

When a program is stopped at a breakpoint, you can substitute an asterisk (*) for the symbolic-name. For example, if program PAYROLL is stopped at a breakpoint and you enter:

USE=*.payrec

CA InterTest for CICS uses the program named PAYROLL and the PAYREC structure.

To begin the structure with a specific data name, enter this command in the DATA field:

FIND=data-name

Where data-name is the data name to be displayed.