Adabas Device Types and Block Sizes

The standard characteristics of the device types supported by Adabas in environments under the z/OS, z/VSE, and BS2000 operating systems are summarized here.


Supported Adabas Device Types

The standard characteristics of the device types supported via the ADARUN DEVICE parameter in z/OS environments are summarized in the following table. Adabas block sizes and RABNs per track are provided for each Adabas component for each device type.

Device Trks/Cyl ASSO DATA WORK PLOG/RLOG CLOG TEMP/SORT/DSIM Notes
3330 19 1510:8 3140:4 4252:3 4252:3 3156:4 3140:4  
3340 12 1255:6 2678:3 3516:2 3516:2 3516:2 3500:2  
3350 30 1564:11 3008:6 4628:4 4628:4 3024:6 3008:6  
3375 12 2016:15 4092:8 4096:8 4096:8 4096:8 8608:4  
3380 15 2004:19 4820:9 5492:8 5492:8 4820:9 7476:6 2
3390 15 2544:18 5064:10 5724:9 5724:9 5064:10 8904:6 2
8345 15 4092:10 22780:2 22920:2 22920:2 22920:2 22920:2  
8350 30 3008:6 6232:3 9442:2 9442:2 9442:2 9442:2 1
8380 15 3476:12 6356:7 9076:5 9076:5 9076:5 9076:5 1
8381 15 3476:12 9076:5 11476:4 11476:4 9076:5 9076:5 1
8385 15 4092:10 23292:2 23468:2 23468:2 23468:2 23468:2 1
8390 15 3440:14 6518:8 10706:5 10706:5 8904:6 8904:6 1
8391 15 4136:12 10796:5 13682:4 13682:4 8904:6 18452:3 1
8392 15 4092:12 12796:4 18452:3 18452:3 18452:3 18452:3 1
8393 15 4092:12 27644:2 27990:2 27990:2 27990:2 27990:2 1
9345 15 4092:10 7164:6 11148:4 11148:4 22920:2 22920:2 2

Notes:

  1. The 8350, 838n, and 839n are pseudo-device types physically contained on a 3350, 3380, and 3390 device, respectively, but for which some or all of the standard block sizes are larger.
  2. The IBM RAMAC 9394 emulates devices 3390 Model 3, 3380 Model K, or 9345 Model 2.

Supported z/VSE Device Types

The standard characteristics of the device types supported by Adabas are summarized in the following table. The Adabas block sizes and RABNs per track are provided for each component for each device type.

Device Trks/Cyl ASSO DATA WORK PLOG/RLOG CLOG TEMP/SORT/DSIM Notes
1512 7 1536:37 18944:37 18944:37 18944:37 18944:37 18944:37  
3375 12 2016:15 4092:8 4096:8 4096:8 4096:8 8608:4  
3380 15 2004:19 4820:9 5492:8 5492:8 4820:9 7476:6 2
3390 15 2544:18 5064:10 5724:9 5724:9 5064:10 8904:6 2
5121 15 2048:16 4096:8 4096:8 4096:8 4096:8 4096:8  
5122 15 4096:8 8192:4 8192:4 8192:4 8192:4 8192:4  
5123 15 4096:8 16384:2 16384:2 16384:2 16384:2 16384:2  
8345 15 4092:10 22780:2 22920:2 22920:2 22920:2 22920:2  
8380 15 3476:12 6356:7 9076:5 9076:5 9076:5 9076:5 1
8381 15 3476:12 9076:5 11476:4 11476:4 9076:5 9076:5 1
8385 15 4092:10 23292:2 23468:2 23468:2 23468:2 23468:2 1
8390 15 3440:14 6518:8 10706:5 10706:5 8904:6 8904:6 1
8391 15 4136:12 10796:5 13682:4 13682:4 8904:6 18452:3 1
8392 15 4092:12 12796:4 18452:3 18452:3 18452:3 18452:3 1
8393 15 4092:12 27644:2 27990:2 27990:2 27990:2 27990:2 1
9345 15 4092:10 7164:6 11148:4 11148:4 22920:2 22920:2 2

Notes:

  1. The 8350, 838n, and 839n are pseudo-device types physically contained on a 3350, 3380, and 3390 device, respectively, but for which some or all of the standard block sizes are larger.
  2. The IBM RAMAC 9394 emulates devices 3390 Model 3, 3380 Model K, or 9345 Model 2.

BS2000 Device Types and Block Sizes

The primary access method for direct access data sets used by Adabas under BS2000 is PAM (primary access method). The device types defined by Adabas establish a logical structure on a PAM data set in order to process a fixed number of consecutive PAM blocks. For example, for device 2300, one ASSO RABN (Adabas block) consists of two PAM blocks and one logical track consisting of four RABNs.

These device types are “artificial”; there is no relation to the physical devices being used. A maximum of 16 PAM blocks per track can be combined into one I/O call. For more than 16 PAM blocks per track, parameter chaining is used.

The artificial device types defined by Software AG for BS2000 systems are summarized in the following table. The ASSO, DATA, WORK, PLOG, CLOG, and TEMP/SORT/DSIM block sizes are given with PAMs/RABN and RABNs per track.

Device PAM Pages per Cyl1 PAM Pages per Track PAMs per Block/Block size:Blocks per Track NK4 Compati- ble2 4K Rounded3
ASSO DATA WORK PLOG CLOG TEMP/SORT/DSIM
2000 80 8 1/2048:4 2/4080:2 2/4096:2 2/4096:2 2/4096:2 2/4080:2 No No
2002 152 8 2/4092:4 4/8188:2 4/8192:2 4/8192:2 8/16384:1 8/16384:1 Yes No
2005 220 20 1/2044:20 2/4092:10 4/8192:5 4/8192:5 5/10240:4 5/10240:4 No No
2006 220 20 2/4092:10 4/8188:5 5/10240:4 5/10240:4 5/10240:4 5/10240:4 No No
2008 272 16 2/4092:8 16/32656:1 16/32760:1 16/32760:1 16/32760:1 16/32760:1 Yes No
2010 240 16 2/4092:8 4/8188:4 8/16380:2 8/16380:2 8/16380:2 8/16380:2 Yes No
2200 240 16 2/4092:8 4/8088:4 8/16380:2 8/16380:2 8/16380:2 8/16380:2 Yes No
2201 180 12 2/4092:6 6/12184:2 6/12288:2 6/12288:2 6/12288:2 6/12288:2 Yes No
2202 240 16 2/4092:8 8/16280:2 8/16380:2 8/16380:2 8/16380:2 8/16380:2 Yes No
2300 152 8 2/4096:4 4/8192:2 4/8192:2 4/8192:2 8/16384:1 8/16384:1 Yes Yes
2301 240 16 2/4096:8 8/16384:2 8/16384:2 8/16384:2 8/16384:2 8/16384:2 Yes Yes
2302 272 16 2/4096:8 16/32768:1 16/32768:1 16/32768:1 16/32768:1 16/32768:1 Yes Yes
2303 224 14 2/4096:7 14/28672:1 14/28672:1 14/28672:1 14/28672:1 14/28672:1 Yes Yes

Notes:

  1. The PAM Pages per Cyl (PAM pages per cylinder) column shows how many PAM pages are allocated per cylinder (for example, in an ADAFRM utility where the size does not have the suffix "B").
  2. Generally, NK4-compatible containers should have an even number in the RABN STD block size.
  3. 4K-rounded devices need RABN block sizes to be an exact multiple of 4K bytes. These are usually used with D3475-8F devices. When such devices are shared with UNIX machines, this is the case. Otherwise, you can specify the ADARUN parameter ALLOW8F=YES to avoid the ADAI6Y error message.
  4. Effective with Adabas 8.2 SP 5, support for BS2000 2001, 2003, 2004, 2007 and 2009 devices has been removed. Please contact Software AG if there is a problem with this.

If the current database device is not of a compatible type for NK4 disks and it is necessary to migrate it to those disks, you must use the ADAORD RESTRUCTUREDB utility as described in Adabas Utilities.

Container Size Calculation

To calculate the size of a container in PAM pages, take the number of RABNs for the container and multiply it by the RABN STD block size.

To check your container file, multiply the highest RABN from the ADAREP utility by the RABN STD block size, and compare it with the HIGH-US-PA field of the SHOW-FILE-ATTRIBUTES file-name,ALL command output. If the HIGH-US-PA field is less than the highest PAM page calculated from the ADAREP, you will receive a DMS0922 error from the operating system when accessing this.

Splitting Data Sets Across Volumes

In Adabas 8.2 and later versions, I/O is performed, wherever possible, in track units (see the "PAM Pages per Track" column in the device table earlier in this section). This unit is only a logical unit on this platform and is not associated with the number of PAM pages that the system allocates. If the container is to be increased onto another volume, the number of blocks allocated will be rounded automatically to the "PAM Pages per Track" value.

For private volumes, splitting is possible under every LOGON user ID:

In ISP format:

/FILE data-set,DEVICE=D3480,VOLUME=PRIV01,SPACE=60000
/FILE data-set,DEVICE=D3480,VOLUME=PRIV02,SPACE=60000

In SDF format:

/CREATE-FILE data-set,PRIV-DISK(SPACE=(60000),VOLUME=PRIV01)
/MOD-FILE-ATTR data-set,PROT=(USER-ACC=*ALL)
/MOD-FILE-ATTR data-set,SUP=PRIV-DISK(SPACE=(60000),VOLUME=PRIV02)

For public volumes, the splitting is possible under every LOGON user ID if the master catalog entry of the pubset has the attribute:

PHYSICAL-ALLOCATION=USER-ALLOWED

This attribute is set by issuing the following command under TSOS:

/MOD-MASTER-CAT CAT-ID=ABC,PHYSICAL-ALLOCATION=USER-ALLOWED

Once this attribute is set, it is possible to split a data set across two or more public volumes under any LOGON user ID that has the right of space allocation on that particular pubset.

In ISP format:

/FILE data-set,VOLUME=ABC.00,DEVICE=D3480,SPACE=60000
/FILE data-set,VOLUME=ABC.01,DEVICE=D3480,SPACE=60000

In SDF format:

/CREATE-FILE data-set,PUB(SPACE=(60000),VOLUME=ABC.00)
/MOD-FILE-ATTR data-set,PROT=(USER-ACC=*ALL)
/MOD-FILE-ATTR data-set,SUP=PUB(SPACE=(60000),VOLUME=ABC.01)

At this point, even a particular physical allocation can be made.

In ISP format:

/FILE data-set,VOLUME=ABC.02,DEVICE=D3480,SPACE=(20002,60000,ABS)

In SDF format (following the CREATE-FILE and MOD-FILE_ATTR...PROT specifications listed earlier):

/MOD-FILE-ATTR data-set,SUP=PUB(SPACE=ABSOLUTE(20002,60000),VOLUME=ABC.02)

The example extent covers physical PAM pages 20002 through 80001 on volume ABC.02. The required disk space must, of course, be available. If you are unsure of the available disk space, consult your system administrator.