Source listing database DIRX report
A sample DIRX report for a Source Listing Database is shown in the following figure:
Sample DIRX Report for a Source Listing Database (Part 1 of 2)
DIRX FOR DATABASE: CX.DOC.SRCEDIR.DB1
VOLSER: PRD905
DATABASE IS CONNECTED
CATALOG DSN: CX.DOC.SRCEDIR
VOLSER: PRD924
DSN ............................. CX.DOC.SRCEDIR.DB1
VOLSER .......................... PRD905
AM(ACCESS METHOD) ............... VSAM
BLKSIZE ......................... 18425
TYPE ............................ SOURCE DATABASE
REPTCOUNT ....................... 50
GROUPCOUNT ...................... 3
AUTODELETE ...................... DUPS
INDEX ........................... NON-EXTENDED
EXTENTS ......................... 460
OTHER INFORMATION
BLOCKS IN FILE ................ 90
ALLOCATION GROUPS ............. 28
USED ALLOCATION GROUPS ........ 20(71%)
FILE FORMATTED BY DDIO RELEASE. 9.0.0
REQUIRES MINIMUM DDIO RELEASE . 7.0.0
DIRECTORY ENTRIES/BLOCK ....... 18
DIRECTORY BLOCKS .............. 3
FILE FORMAT ................... EXTENDED
PROGRAM LIST NUMBER COMP DATE TIME RC LANGUAGE SIZE(K) GROUPS
ASMTEST9 (L) 4 23 APR 2014 13.19 04 HLASM R6 108 6 7
TOTAL GROUPS 2
PL1000 (L) 3 06 SEP 2013 10:54:12 04 PL1EN V4R3 54 5
TOTAL GROUPS 1
AVeryLar (L) 7 00 C/ESA V3R2 864 234891011
AVeryLargeNameofatLeast30Characters_20 13 14 15 16 17 18 19
TOTAL GROUPS 16
HELLO (L) 602 SEP 199910:03:2200COB/Z V3R2541
TOTAL GROUPS 1
VOLSER: PRD905
DATABASE IS CONNECTED
CATALOG DSN: CX.DOC.SRCEDIR
VOLSER: PRD924
DSN ............................. CX.DOC.SRCEDIR.DB1
VOLSER .......................... PRD905
AM(ACCESS METHOD) ............... VSAM
BLKSIZE ......................... 18425
TYPE ............................ SOURCE DATABASE
REPTCOUNT ....................... 50
GROUPCOUNT ...................... 3
AUTODELETE ...................... DUPS
INDEX ........................... NON-EXTENDED
EXTENTS ......................... 460
OTHER INFORMATION
BLOCKS IN FILE ................ 90
ALLOCATION GROUPS ............. 28
USED ALLOCATION GROUPS ........ 20(71%)
FILE FORMATTED BY DDIO RELEASE. 9.0.0
REQUIRES MINIMUM DDIO RELEASE . 7.0.0
DIRECTORY ENTRIES/BLOCK ....... 18
DIRECTORY BLOCKS .............. 3
FILE FORMAT ................... EXTENDED
PROGRAM LIST NUMBER COMP DATE TIME RC LANGUAGE SIZE(K) GROUPS
ASMTEST9 (L) 4 23 APR 2014 13.19 04 HLASM R6 108 6 7
TOTAL GROUPS 2
PL1000 (L) 3 06 SEP 2013 10:54:12 04 PL1EN V4R3 54 5
TOTAL GROUPS 1
AVeryLar (L) 7 00 C/ESA V3R2 864 234891011
AVeryLargeNameofatLeast30Characters_20 13 14 15 16 17 18 19
TOTAL GROUPS 16
HELLO (L) 602 SEP 199910:03:2200COB/Z V3R2541
TOTAL GROUPS 1
Sample DIRX Report for a Source Listing Database (Part 2 of 2)
MEMBER SUMMARY OF CX.DOC.SRCEDIR.DB1
NO OF MEMBERS................................. 4
NO OF LOCKED MEMBERS.......................... 4
NO OF MANUALLY LOCKED MEMBERS................. 0
NO OF UNLOCKED MEMBERS........................ 0
NO OF INCOMPLETE MEMBERS...................... 0
LARGEST MEMBER SIZE (IN GROUPS)............... 16
SMALLEST MEMBER SIZE (IN GROUPS).............. 1
AVERAGE MEMBER SIZE (IN GROUPS)............... 5.0
SPACE SUMMARY BASED ON AUTODELETE=DUPS
MAXIMUM ALLOCATION GROUPS..................... 28
AVAILABLE ALLOCATION GROUPS................... 8(29%)
UNUSED...................................... 8(29%)
BELONGING TO UNLOCKED MEMBERS............... 0(0%)
NUMBER OF GROUPS FROM MANUALLY LOCKED MEMBERS. 0
MAXIMUM NO OF DIRECTORY ENTRIES (REPTCOUNT)... 50
AVAILABLE NO OF DIRECTORY ENTRIES............. 46
ESTIMATED NUMBER OF ENTRIES AVAILABLE..........1
NO OF MEMBERS................................. 4
NO OF LOCKED MEMBERS.......................... 4
NO OF MANUALLY LOCKED MEMBERS................. 0
NO OF UNLOCKED MEMBERS........................ 0
NO OF INCOMPLETE MEMBERS...................... 0
LARGEST MEMBER SIZE (IN GROUPS)............... 16
SMALLEST MEMBER SIZE (IN GROUPS).............. 1
AVERAGE MEMBER SIZE (IN GROUPS)............... 5.0
SPACE SUMMARY BASED ON AUTODELETE=DUPS
MAXIMUM ALLOCATION GROUPS..................... 28
AVAILABLE ALLOCATION GROUPS................... 8(29%)
UNUSED...................................... 8(29%)
BELONGING TO UNLOCKED MEMBERS............... 0(0%)
NUMBER OF GROUPS FROM MANUALLY LOCKED MEMBERS. 0
MAXIMUM NO OF DIRECTORY ENTRIES (REPTCOUNT)... 50
AVAILABLE NO OF DIRECTORY ENTRIES............. 46
ESTIMATED NUMBER OF ENTRIES AVAILABLE..........1
Source Listing Database DIRX Report Fields
The following is a description of the Source Listing Database DIRX report fields.
- DIRX FOR DATABASE: The data set name of the Source Listing Database.
- VOLSER: The volume serial number of the Source Listing Database.
- DATABASE IS CONNECTED: Indicates the Source Listing Database is attached to a shared directory.
- CATALOG DSN: The data set name of the shared directory to which the Source Listing Database is attached.
- VOLSER: The volume serial number of the shared directory to which the Source Listing Database is attached.
- DSN: The data set name of the Source Listing Database
- VOLSER: The volume serial number of the Source Listing Database.
- AM (ACCESS METHOD): The means by which the Source Listing Database is accessed — either VSAM or BSAM (sequential).
- BLKSIZE: The size of a block available to store the source listing. For VSAM files, this number is seven bytes less than the CISIZE of the file. This will be the value in the MAXRECLN and AVGRECLN parameters on the cluster definition.
- TYPE: Indicates the type of file format. In this instance the file was formatted for source database.
- REPTCOUNT: The maximum number of members (source listings) that the Source Listing Database can contain. This value was specified when the file was formatted.
- GROUPCOUNT: The number of blocks of data that can be contained in each group (extent). This value was specified when the file was formatted.
- AUTODELETE: The AUTODELETE option that was specified when the file was formatted.
- INDEX: Indicates whether the file was formatted to allow indexes to occupy more than one block. EXTENDED should appear in this field.
- EXTENTS: The largest number of groups (extents) that can be used by a single member.
Other Information
This section of the report lists additional characteristics about the file.
- BLOCKS IN FILE: The number of blocks allocated for the file.
- ALLOCATION GROUPS: The number of groups available in which a listing can be stored. This number is derived by subtracting the number of blocks required by the directory and header record from the total number of blocks in the file and then dividing the result by the GROUPCOUNT value.
- USED ALLOCATION GROUPS: The number, and percentage of allocation groups that contain data.
- BLOCKS/TRACK: For sequential files only, the number of blocks that exist in each track.
- FILE FORMATTED BY DDIO RELEASE: The release level of CWDDLPUT or CWDDALLU that was used to format the file.
- REQUIRED MINIMUM DDIO RELEASE: The minimum release level of CWDDLPUT or CWDDALLU that can be used to manage the file.
- CURRENT REPORT NUMBER: The highest source listing number on this database, plus 1.
- DIRECTORY ENTRIES/BLOCK: The number of directory entries that will fit per block on the file. This number is dependent on the EXTENTS and BLKSIZE values. As EXTENTS increase, the number of directory entries per block decrease (provided the BLKSIZE does not change).
- DIRECTORY BLOCKS: A value derived by dividing the REPTCOUNT used to format the file by the number of directory entries per block.
- FILE FORMAT: Indicates whether additional bytes are in the directory.
Column Headings
The header line for the body of the DIRX report includes the following columns:
- PROGRAM: The name of the program. If followed by (L), the member is automatically locked. If followed by (M), the member is manually locked. If the name is a LONGNAME (greater than eight characters), an asterisk will be placed in the last position and the full long name will be contained on the next lines.
- LIST NUMBER: The number assigned to this member.
- COMP DATE: The date the program was compiled.
- TIME: The time of day the program was compiled.
- RC: The return code from the step that created the member.
- LANGUAGE: The program language compiler and version.
- SIZE(K): The number of KBs this member occupies on the Source Listing Database.
- GROUPS: The allocation group numbers occupied by the source listing.
- TOTAL GROUPS: The total number of allocation groups occupied by the source listing.
Member Summary
The following information appears at the end of the report.
- NO OF MEMBERS: The total number of members in the Source Listing Database.
- NO OF LOCKED MEMBERS: The total number of locked members in the Source Listing Database.
- NO OF UNLOCKED MEMBERS: The total number of unlocked members in the Source Listing Database.
- NO OF INCOMPLETE MEMBERS: The total number of members in the Source Listing Database that are missing data and therefore cannot be viewed. Incomplete members can result when a file full condition exists while the member is being written to the file (and dynamic database creation is not in effect), or when certain system failures occur.
- LARGEST MEMBER SIZE (IN GROUPS): The size of the largest member in the Source Listing Database, expressed in groups.
- SMALLEST MEMBER SIZE (IN GROUPS): The size of the smallest member in the Source Listing Database, expressed in groups.
- AVERAGE MEMBER SIZE (IN GROUPS): The size of the average member in the Source Listing Database, expressed in groups.
Space Summary Based on AUTODELETE
The following fields describe the characteristics of the Source Listing Database using the specified AUTODELETE option.
- MAXIMUM ALLOCATION GROUPS: The number of allocation groups that can exist in the Source Listing Database.
- AVAILABLE ALLOCATION GROUPS: The number of allocation groups occupied by unlocked members plus the number of unused allocation groups, and the percentage of available groups.
- If AUTODELETE is YES, DUPS or STAGED this will be shown:
UNUSED: The number of unused allocation groups and its percentage.
- BELONGING TO UNLOCKED MEMBERS: The number of allocation groups belonging to unlocked members and its percentage.
- If AUTODELETE = NO this will be shown:
AUTODELETE OFF; USUSED ONLY ARE AVAILABLE
- MAXIMUM NO OF DIRECTORY ENTRIES (REPTCOUNT): The maximum number of members (source listings) the Source Listing Database can contain.
- AVAILABLE NO OF DIRECTORY ENTRIES: The difference between the maximum number of members the file can contain and the number of locked (manually locked when AUTODELETE=STAGED) members.
- ESTIMATED NUMBER OF ENTRIES AVAILABLE: The estimated number of available directory entries based on the average member size (in groups).
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*