Data Area Space Estimation Report (Device)

The DEVICE= keyword of the REPORT function provides, for a given device type, the option of an estimate of the logical records per block and the total space required to store a particular number of records in a ddb data area.
datacom151
The DEVICE= keyword of the REPORT function provides, for a given device type, the option of an estimate of the logical records per block and the total space required to store a particular number of records in a 
Datacom/DB
 data area.
The following topics are discussed on this page:
 
 
When to Use
Use the Data Area Space Estimation Report when planning the necessary allocation for a 
Datacom/DB
 data area.
You can request the REPORT DEVICE option at any time. 
How to Use
You can execute this command in either Single User or with the MUF active. To obtain a Data Area Space Estimation Report, execute the REPORT function with the following command format.
►►─ REPORT DEVICE=
nnnn
,RECSIZE=
n
─┬──────────────────────┬────────────────────► └─ ,COMPER= ─┬─ 0 ◄ ─┬─┘ └─
nn
──┘ ►─┬─────────────────────────┬─┬──────────────────────┬───────────────────────► └─ ,COMPRESS= ─┬─ NO ◄ ─┬─┘ └─ ,GROWTH= ─┬─ 0 ◄ ─┬─┘ └─ YES ──┘ └─
n
───┘ ►─┬──────────────────────────────┬─┬─────────────────────────┬───────────────► └─ ,RECORDS= ─┬─ 0 ◄ ────────┬─┘ └─ ,RECOVERY= ─┬─ NO ◄ ─┬─┘ └─
nnnnnnnnnn
─┘ └─ YES ──┘ ►─┬────────────────────────┬─────────────────────────────────────────────────►◄ └─ ,STARTAFT= ─┬─ 1 ◄ ─┬─┘ └─
nnn
─┘
 
Command
 
  •  
    REPORT
    Invokes the function to produce a report.
 
Required Keywords
 
  •  
    DEVICE=
    Specifies the device type for the report.
    •  
      Valid Entries:
      3380, 3390
    •  
      Default Value:
      (No default)
  •  
    ,RECSIZE=
    Specifies the 
    Datacom/DB
     table record size.
    This value should not include the 
    Datacom/DB
     Record Control Element (RCE).
    •  
      Valid Entries:
      1 to 32720
    •  
      Default Value:
      (No default)
 
Optional Keywords
 
  •  
    ,COMPER=
    Specifies the estimated compression percentage. COMPRESS=YES must also be specified.
    •  
      Valid Entries:
      0 to 99
    •  
      Default Value:
      0
  •  
    ,COMPRESS=
    Specifies whether compression is to be considered in estimating space.
    •  
      Valid Entries:
      NO or YES
    •  
      Default Value:
      NO
  •  
    ,GROWTH=
    Specifies a growth percentage. The report shows space that should be allocated for growth, if this value is provided.
    •  
      Valid Entries:
      0 to 999
    •  
      Default Value:
      0
  •  
    ,RECORDS=
    Specifies the estimated number of records to be stored in the table. If no value is supplied, the report only displays expected records per block and track.
    •  
      Valid Entries:
      0 to 2147483647 (2 billion minus 1)
    •  
      Default Value:
      0
  •  
    ,RECOVERY=
    Specifies whether extra data needed for RECOVERY on each record is to be considered.
    •  
      Valid Entries:
      NO or YES
    •  
      Default Value:
      NO
  •  
    ,STARTAFT=
    Specifies the first records-per-block value to be displayed on the space estimation chart.
    •  
      Valid Entries:
      1 to 999
    •  
      Default Value:
      1
Example JCL (3390)
The following shows the command to print the estimated space calculations for a 400-byte record stored on a 3380 device.
 Use the following as a guide to prepare your JCL. The JCL statements are for example only. Lowercase letters in a statement indicate a value you must supply. Code all statements to your site and installation standards.
//jobname See the previous note and
JCL Requirements
.
// EXEC PGM=DBUTLTY,REGION=2M //STEPLIB See the previous note and
JCL Requirements
.
//SYSIN DD * Command input REPORT DEVICE=3390,RECSIZE=400,COMPER=25,COMPRESS=YES, GROWTH=25,RECORDS=250000,RECOVERY=YES /*
Sample Report
Following is a sample report page. For an example report header, see Sample Report Headers.
Sample Report REPORT DEVICE (3390) 
CONTROL CARD(S) .........1.........2.........3.........4.........5.........6.........7.........8 REPORT DEVICE=3390,RECSIZE=400,COMPER=25,COMPRESS=YES, GROWTH=25,RECORDS=250000,RECOVERY=YES FUNCTION=REPORT COMPER=25 COMPRESS=YES DEVICE=3390 GROWTH=025 RECORDS=00250000 RECOVERY=YES RECSIZE=00400
This page of the report shows the following:
  • The command exactly as entered.
  • An analysis of keywords encountered and expected. Any errors found are flagged with a note in the left margin.
  • Any messages related to syntax processing.
MATRIX FOR DEVICE TYPE....."3390". ------------------------------------------------------------- # 32760* # 27998 # 18452 # 13682 # 10796 # * NOT DASD OPTIMAL, LARGEST DATACOM SUPPORTS #-----------#-----------#-----------#-----------#-----------# # 8906 # 7548 # 6518 # 5726 # 5064 # #-----------#-----------#-----------#-----------#-----------# # 4566 # 4136 # 3768 # 3440 # 3174 # #-----------#-----------#-----------#-----------#-----------# # 2942 # 2710 # 2546 # 2376 # 2212 # #-----------#-----------#-----------#-----------#-----------# # 2082 # 1946 # 1850 # 1748 # 1646 # #-----------#-----------#-----------#-----------#-----------# # 1550 # 1482 # 1386 # 1318 # 1250 # #-----------#-----------#-----------#-----------#-----------# # 1182 # 1154 # 1086 # 1018 # 984 # #-----------#-----------#-----------#-----------#-----------# # 950 # 888 # 854 # 820 # 786 # #-----------#-----------#-----------#-----------#-----------# # 752 # 718 # 690 # 646 # 622 # #-----------#-----------#-----------#-----------#-----------# # 588 # 554 # 520 # 0 # 0 # #-----------#-----------#-----------#-----------#-----------#
This page of the report shows a matrix of block sizes for different blocks per track. The first row shows block sizes for 1 to 5 blocks per track. The second row shows 6 to 10 blocks per track, and so forth.
--------------------------------------------------------------------------- # DEVICE # RECORD # RECOVERY # COMPRESSION # FIRST # RECORD # GROWTH # # TYPE # SIZE # Y/N # Y/N # PERCENT # R P B # QUANTITY # PERCENT # #--------#--------#----------#-----#---------#-------#----------#---------# # 3390 # 400 # Y # Y # 25 % # 0 # 25000 # 25 % # --------------------------------------------------------------------------- --------------------------------------------------------------------------------------- # RCD # MINM # DEVICE # LOGICAL # DATA SPACE REQUIRED # # PER # BLOCK # BLOCK # RECORDS PER # PRIMARY # GROWTH # TOTAL ## TOTAL # # BLK # SIZE # SIZE # TRACK # CYLIN # TRACKS # TRACKS # TRACKS ## CYLIN / TRK # #-----#-------#--------#-------#-------#---------#---------#---------##---------/-----# # 1 # 314 # 520 # 48 # 720 # 5209 # 1303 # 6512 ## 434 / 2 # # 2 # 626 # 656 # 88 # 1320 # 2841 # 711 # 3552 ## 236 / 12 # # 3 # 938 # 950 # 108 # 1620 # 2315 # 579 # 2894 ## 192 / 14 # # 4 # 1250 # 1250 # 120 # 1800 # 2084 # 521 # 2605 ## 173 / 10 # # 5 # 1562 # 1646 # 125 # 1875 # 2000 # 500 # 2500 ## 166 / 10 # # 6 # 1874 # 1946 # 132 # 1980 # 1894 # 474 # 2368 ## 157 / 13 # # 7 # 2186 # 2212 # 140 # 2100 # 1786 # 447 # 2233 ## 148 / 13 # # 8 # 2498 # 2546 # 144 # 2160 # 1737 # 435 # 2172 ## 144 / 12 # # 9 # 2810 # 2942 # 144 # 2160 # 1737 # 435 # 2172 ## 144 / 12 # # 10 # 3122 # 3174 # 150 # 2250 # 1667 # 417 # 2084 ## 138 / 14 # . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
This page of the report shows the parameters you coded with the REPORT DEVICE option. The report also displays the default values for parameters not coded.
This table provides you with the information you need to determine optimum device block size. Use TOTAL TRACKS under the DATA SPACE REQUIRED column, locate the lowest value or the least amount of space to allocate. Read across the report to determine the DEVICE BLOCK SIZE. Other information is provided on the report which may be useful in making space allocation decisions or in determining whether to rerun the report with different parameter values.