File Section Display

Reporting › Abend Report › COBOL Reports › Data Division Displays › File Section Display

File Section Display

The File Section portion of the abend report lists information for each file defined to the COBOL program, such as allocation information, access method, and whether the file is open or closed. If the file is open, information from the data management control blocks, the current file status, and the contents of the current logical record are displayed. If the file was accessed sequentially, the contents of the previous record may also be displayed. Optional displays include catalog information for VSAM files and dumps of data management control blocks.

The following example shows the beginning of the File Section portion, including the first four lines of information for an open QSAM file:

**************** * FILE SECTION * **************** A DDNAME=PRINT DSORG=PS QSAM BUFNO=5 UNIT=3390,UCB VOL=SER=WRKD28 DSN=USER02.PRINT RECFM=FB B STATUS(OPEN) USAGE(OUTPUT) LRECL=120 BLKSIZE=120 C CURRENT FILE STATUS = 00 SUCCESSFUL

The File Section portion displays the following information:

A: Displays the data management control blocks. The data management blocks are interpreted and displayed in KEYWORD=value format. This information includes the ddname, data set organization, access method, number of buffers allocated, and data set name. For non-VSAM files, the unit type, volser and record format are also displayed.
B: Indicates the file's current status (OPEN, CLOSED), usage (INPUT, OUTPUT, etc.), and the record length. For non-VSAM files, the block size is also displayed, while the feedback code, function code, and return code are displayed for VSAM files.
C: Displays the hexadecimal value of the current file status along with a brief description of what it means.

For open VSAM files, the VSAM catalog information can be displayed using the VSAMCAT option. This option can be specified as an execution-time override, in the CAIOPTS DD. When the option value is set to ON, the VSAM catalog information is displayed following the Current File Status field, as shown in the following example:

DDNAME=INDEX1 DSORG=KSDS VSAM BUFNO=253 DSN=USER02.INDEX1 STATUS(OPEN) USAGE(OUTPUT) LRECL=240 FDBK=0,FTNCD=0,RC=0 CURRENT FILE STATUS = 00 SUCCESSFUL A CLUSTER NAME USER02.INDEX1 DATA COMPONENT USER02.INDEX1.DATA INDEX COMPONENT USER02.INDEX1.INDX B ACTIVITY DATES: CREATION DATE 2007.085 EXPIRATION DATE NEVER SCRATCH C DATASET DEFINITION: KEY POSITION 128 KEY LENGTH 29 AVERAGE RECORD SIZE 240 MAX RECORD SIZE 240 SHARE OPTIONS 2,3 BUFFER SPACE 4608 D ALLOCATION PARAMETERS: WRITE CHECK NO ERASE ON DELETE NO REUSE OPTION NO SPANNED RECORDS NO REPLICATED INDEX NO E DATA COMPONENT INFORMATION: F INDEX COMPONENT INFORMATION: VOLUME OSI006 OSI006 ALLOCATION UNIT TRACKS TRACKS PRIMARY ALLOCATION 4 1 SECONDARY ALLOCATION 1 1 EXTENTS USED 1 1 HIGH ALLOCATED RBA 147456 23552 HIGH USED RBA 0 0 CI SIZE 2048 512 G STATISTICS: RECORDS RETRIEVED 0 RECORDS DELETED 0 RECORDS INSERTED 0 RECORDS UPDATED 0 TOTAL RECORDS 250

The following information is displayed for open VSAM files:

A

Displays the data set names of the cluster and data components. For KSDS files, the data set name of the index component is also displayed.

B

Displays the date on which the file was created and the date on which it may be deleted. The dates are displayed in Julian format (YYYY.DDD). If the expiration date is displayed as Never Scratch, the PURGE parameter is always required to delete the file.

C

Displays the key position and length, the average and maximum lengths of the data records, the share options, and the minimum buffer space allocated when the file is accessed.

The key position and length are only displayed for KSDS files and
variable-length RRDS files. The key position value indicates the position of the key relative to the start of the record. For alternate index files, the key position and length refer to the alternate key within the base cluster. Otherwise, they refer to the prime key within the base cluster.

D

Indicates whether or not the file was allocated using the WRITECHECK, ERASE, REUSE, SPANNED, and REPLICATE parameters.

E

Displays information about the volume on which the file is allocated, the allocation unit (tracks or cylinders), the primary and secondary allocation amounts, the number of extents used, the highest allocated and highest used relative byte address, and the size of the control interval.

F

Displays information for the same fields described under E. This information is displayed only for KSDS files.

G

Displays the number of times data records are retrieved, deleted, inserted, or updated since the initial load of the file, as well as the total number of data records in the file.

The contents of the current logical record are displayed following the Current File Status field or, if the file is VSAM and the VSAMCAT option is ON, following the VSAM catalog information. The contents of the previous record may also be displayed for sequentially accessed files. For keyed VSAM files, the VSAM key value is displayed prior to the contents of the record. Symbolic information may be merged with the current record data (as shown in the following screen), if it is available.

CURRENT LOGICAL KEY A LINE# LEVEL/FIELD NAME VALUE/LOCATION DEFINITION ------ ------------------------------ --------------------------------------- ------------------------------------------- 000158 20 IX-FS1-KEY * ABCDLKJXYZ000000250ZIF,.$-+CD* X(29) CONTENTS OF CURRENT LOGICAL RECORD B ---------------------------------- LINE# LEVEL/FIELD NAME VALUE/LOCATION DEFINITION ------ ----------------------------- ---------------------------------------- ------------------------------------------- 000094 01 IX-FS1R1-F-G-240 BLF=0002+000000 (0000F078) 000095 03 IX-FS1-WRK-120 *FILE=IX-FS1,RECORD=IX-F-G/0,RECN* X(120) (+000032) *O=000250,UPDT=00,ODO=0000,PGM=IX* (+000064) *101,LRECL=000240,BLKSIZRC=0001,L* (+000096) *FIL=000500,ORG=IX,LBLR=S* 000096 03 IX-FS1-GRP-120 BLF=0002+000078 (0000F0F0) 000097 05 FILLER *,RECKEY=* X(8) 000098 05 IX-FS1-KEY *ABCDLKJXYZ000000250ZIF,.$-+CD* X(29) 000099 05 FILLER *,ALTKEY1= * X(83) (+000032) * ,ALTKEY2= * (+000064) * * PREVIOUS KEY C ------------ LENGTH 0000001D (DECIMAL 29) OFFSET +000000 C1C2C3C4 D3D2D1E7 E8E9F0F0 F0F0F0F0 F2F4F9E9 C9C66B4B 5B604EC3 C4 *ABCDLKJXYZ000000249ZIF,.$-+CD* CONTENTS OF PREVIOUS RECORD --------------------------- LENGTH 000000F0 (DECIMAL 240) OFFSET +000000 C6C9D3C5 7EC9E760 C6E2F16B D9C5C3D6 D9C47EC9 E760C660 C761F06B D9C5C3D5 *FILE=IX-FS1,RECORD=IX-F-G/0,RECN* +000020 D67EF0F0 F0F2F4F9 6BE4D7C4 E37EF0F0 6BD6C4D6 7EF0F0F0 F06BD7C7 D47EC9E7 *O=000249,UPDT=00,ODO=0000,PGM=IX* +000040 F1F0F16B D3D9C5C3 D37EF0F0 F0F2F4F0 6BC2D3D2 E2C9E9D9 C37EF0F0 F0F16BD3 *101,LRECL=000240,BLKSIZRC=0001,L* +000060 C6C9D37E F0F0F0F5 F0F06BD6 D9C77EC9 E76BD3C2 D3D97EE2 6BD9C5C3 D2C5E87E *FIL=000500,ORG=IX,LBLR=S,RECKEY=* +000080 C1C2C3C4 D3D2D1E7 E8E9F0F0 F0F0F0F0 F2F4F9E9 C9C66B4B 5B604EC3 C46BC1D3 *ABCDLKJXYZ000000249ZIF,.$-+CD,AL* +0000A0 E3D2C5E8 F17E4040 40404040 40404040 40404040 40404040 40404040 40404040 *TKEY1= * +0000C0 4040406B C1D3E3D2 C5E8F27E 40404040 40404040 40404040 40404040 40404040 * ,ALTKEY2= * +0000E0 40404040 40404040 40404040 40404040 * *

The following information is displayed for the current logical record and the previous record:

A

Displays the current logical key data only for VSAM files with defined keys (i.e. KSDS and variable-length RRDS files). If the MRGFILES option is on, the data may be displayed in merged format. Otherwise, the data is displayed in dump format.

B

Displays the contents of the current logical record using the following options:

If the FIRST128 option is specified, only the first 128 bytes of the record are displayed.
If the MRGFILES option is specified, the data is displayed in merged format. Otherwise, the data is displayed in dump format.

C

Displays previous record data for sequentially accessed files (VSAM, QSAM, and BSAM), if it is available in an I/O buffer and:

The file is not a BSAM file using NOTE/POINT
The file is not a VSAM file using skip-sequential access
The file is not a JES managed data set, such as in-stream data or data written to a SYSOUT class
The file does not contain unformatted, spanned, compressed, or extended records

For keyed VSAM files, the previous record key is displayed prior to the contents of the previous record.

Use the Data Management Control Block options (DEB, DCB, UCB, and IOB) or VSAM Control Block options (ACB, AMBL, AMB, PLH, and RPL) to dump control blocks after the record data display. To dump all of the control blocks, specify the BLOCKS option. These options may be specified as execution-time overrides, in the CAIOPTS DD.

The following example shows the Data Management Control Blocks for a QSAM file displayed in hexadecimal format.

DATA MANAGEMENT CONTROL BLOCKS ------------------------------ DEB 007C2D84 LENGTH 00000088 (DECIMAL 136) OFFSET +000000 037C4E88 10000000 E8000000 0F001100 01000000 FF000000 8F00D038 047C2D60 +000020 187CED48 00000002 00030002 00030001 00010001 00000000 00000000 00000079 +000040 F3C2C1D9 C1C90000 00000000 00000000 00000000 00000000 00000000 00000000 +000060 00000000 00540002 007C7808 00001BE2 00000000 02002000 00000000 00000000 +000080 007AD998 C4E2C3C2 DCB 0000D038 LENGTH 00000060 (DECIMAL 96) OFFSET +000000 22A8CA50 00000000 00020003 13F53026 002FAB98 05018FE8 00004000 00006C08 +000020 C6000001 840138B4 00A40048 007C2D84 92D8C2C0 00D8BE70 0A01272A 02090079 +000040 30013030 00006DB8 22ABAFF9 22ABAFF9 00000079 00000000 00000000 00E6E470 UCB 007CED48 LENGTH 00000040 (DECIMAL 64) OFFSET +000000 01A8FF8C 2D050000 00000000 08E4C3C2 3030200F 00229D21 5DC00100 E6D9D2C4 +000020 F2F51001 00A00014 02229B48 02233188 05800101 00000000 40688072 20C69F40 IOB 00006C08 LENGTH 00000050 (DECIMAL 80) OFFSET +000000 7F000000 007C1BD0 00006C78 80006DB8 00006C78 04040004 00000000 00000000 +000020 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 +000040 00000000 00000000 00000000 00000000