Endevor BC1PNLIB utility error USED PAGES OUT-OF-BALANCE
Article ID: 266272
Updated On:
Products
Issue/Introduction
Endevor utility BC1PNLIB provides function INQUIRE which, apart from other results, always produces a page of information about the ELIB library being processed.
This page may show a warning message about "used pages out of balance" as in the example below:
ENDEVOR-LIB INIT/EXPAND/REORG/INQUIRE UTILITY
0ENDEVOR-LIB INQUIRY: DDNAME=ELIB1
DDNAME: ELIB1
DSNAME: ELIB.DATASET.NAME
LIBRARY TYPE: VLB
PAGE SIZE: 1016
LAST PAGE: 831105
FILE PAGE SIZE: 1016
INITIALIZED: 06/05/2016 17:33:31.33
(RE)ALLOC STAMP: 770599
LAST REORG/EXPAND: 05/16/2023 06:51:11.04
FILE SIZE (PAGES) 831104
FIRST ALLOCATION: 341054
EXPAND ALLOCATION: 4950
RESERVE LIMIT: 2880
BIT MAP PAGES: 106 STARTING AT 826120
DIRECTORY TARGET PAGES: 51161 STARTING AT 46
ALLOC MAP BYTES: 103893
PAGES USED: 825954
PAGES FREE: 5150
LAST UPDATE STAMP: 774980
LAST UPDATE: 05/16/2023 15:28:23.33
LATEST MEMBER: MEMBER1
AVG PAGES/MEMBER: 1
# DATA PAGES: 743976
# REPLACES: 232
# ADDS: 683619
# DELETES: 60319
# MEMBERS: 623300
# DIRECTORY PAGES: 16335
# DIR OVERFLOWS: 30485
LONGEST DIR OVFL: 2
# LIBRARY EXTENDS: 99
# DIRECTORY REORG: 0
*** WARNING - USED PAGES OUT-OF-BALANCE COMPUTED PAGES = 000760418 TALLY = 000825954
What does it mean?
Environment
Release : 19.0
Cause
This message means that the sum of:
- # DATA PAGES (743976)
- # DIRECTORY PAGES (16335)
- BIT MAP PAGES (106)
- Library header page (1)
Does NOT match the number of pages used in the library (825954)
In this example, it is meaningful that the reported difference is exactly 65536 (hex 10000)
Resolution
When the difference between the values divides exactly into 65536, this message arises because the ELIB directory has grown over 65536 pages but the field that stores the total of directory pages has only 2 bytes so the leftmost bits in the counter are lost.
This is only a cosmetic problem. That short field is used only for reporting purposes. The library is in good condition despite the message.
What can be done in this case is to rebuild the library with a larger page size. This way, each directory page will have room for more entries so the library will have less directory pages.
When the difference does NOT divide exactly into 65536, something abnormal has happened to any of the fields that are used in the computation. What can be done is to reorganize the library (that is, initialize a new one and copy the old one to the new one using BC1PNCPY utility)
Feedback
