mkfbvol

Parameters

-dev storage_image_ID

(Optional) Specifies the storage image ID, which includes a value for the manufacturer, machine type, and serial number. The -dev parameter temporarily overrides any defined value for devid for the current command. The storage image ID is required for the following situations:

• If you do not specify a fully qualified extent pool ID
• If you do not set the devid variable in your profile or through the setenv command
• If the HMC is aware of more than one storage image

-extpool extentpool_ID

(Required) Creates the base or alias volumes from data extents that are contained in this extent pool. The extent pool storage type defines the volume storage type. An extent pool ID is a four-digit decimal number with no leading zeros, prefixed with the letter P.

-os400 A01 | A81 | A02 | A82 | A04 | A84 | A05 | A85 | A06 | A86 | A07 | A87 | 050 | 099

(Optional) The OS/400 volume options. If this parameter is not specified, the default standard 2107/1750 volume is created.

This parameter, with a specified Axx value, is required if the -cap parameter is not specified because the Axx values also indicate a specific capacity. However, because the 0xx values do not indicate any capacity, the -cap parameter is required with the 0xx values to specify the capacity of the IBM® i volume.

The storage sizes and the data types for this volume are listed in the following table:

Volume	Volume Size	Volume	Volume Size
A01 protected	8.59 GB	A81 unprotected	8.59 GB
A81 unprotected	8.59 GB	A01 protected	8.59 GB
A02 protected	17.55 GB	A82 unprotected	17.55 GB
A82 unprotected	17.55 GB	A02 protected	17.55 GB
A05 protected	35.17 GB	A85 unprotected	35.17 GB
A85 unprotected	35.17 GB	A05 protected	35.17 GB
A04 protected	70.56 GB	A84 unprotected	70.56 GB
A84 unprotected	70.56 GB	A04 protected	70.56 GB
A06 protected	141.12 GB	A86 unprotected	141.12 GB
A86 unprotected	141.12 GB	A06 protected	141.12 GB
A07 protected	282.35 GB	A87 unprotected	282.35 GB
A87 unprotected	282.35 GB	A07 protected	282.35 GB
050 unprotected	variable	099 protected	variable

Decimal gigabyte (GB) is 10^9 bytes.

Note: You must ensure that the volume data type is compatible with the host systems that can access this volume.

-type ess | ds | blocks

(Optional) Specifies the unit type of capacity that is specified by the -cap parameter.

ess

Specifies that the unit is decimal gigabytes (GB) 10^9 bytes.

ds

Specifies that the unit is gibibytes (GiB) 2^30 bytes.

blocks

Specifies that the unit is 512 blocks.

TiB

Specifies that the unit is tebibytes (TiB) 2^40 bytes. This value is an alias of ds.

GiB

Specifies that the unit is gibibytes (GiB) 2^30 bytes.

MiB

Specifies that the unit is mebibytes (MiB) 2^20 bytes.

Notes:

1. If the -type parameter is not specified, the lun is created as type ds.
2. The -type parameter is ignored when the -os400 parameter is specified.

-cap capacity

(Optional) Specifies the storage size that is allocated to this volume object. The maximum volume size varies and depends on model and type.

Note: This parameter is required if the -os400 parameter is not specified.

• If the -type parameter is omitted or the -type ds parameter is specified, the capacity value is the volume size in gibibytes (GiB), where one gibibyte (GiB) = 1 073 741 824 (2^30 bytes).
• If the -type ess parameter is specified, the capacity value is the volume size in gigabytes (GB), to the nearest 1/10 GB (format xxxx.x), where 1 GB = 1 000 000 000 (10^9 bytes).
• If the -type blocks parameter is specified, the capacity value is the volume size in 512-byte blocks.

-name volume_name

(Optional) Your nickname for this volume. The nickname can be 16 characters in length and can contain one of the following wildcard characters:

• #d decimal volume ID
• #h hexadecimal volume ID

-volgrp volume_group_ID

(Optional) Specifies to which volume group the volumes are assigned. A volume group ID is a four-digit decimal number with no leading zeros, prefixed with the letter V.

-wait

(Optional) Delays the command response until the volume configuration processes complete.

Note: If you specify this parameter, you must wait until your original command processes completely before you can enter a new command.

-sam standard | tse | ese

(Optional) Specifies the storage allocation method as follows:

standard

Designates that you want the system to fully allocate the volume with real extents when it creates the volumes. This value is the default.

tse

Designates that you want the system to create track space-efficient volumes. After creation, these space-efficient volumes contain a set of virtual extents that are associated with the space-efficient storage in the same extent pool. The physical space for a given logical track on a track space-efficient logical volume is dynamically allocated and deallocated from the repository in the space-efficient storage.

To use this subparameter, you must have previously created space-efficient storage (by using the mksestg command) for the extent pool.

ese

Designates that an extent space efficient (ESE) logical volume is provisioned with a set of virtual extents that are associated with the space efficient storage in the same extent pool. Physical space for an extent space efficient logical volume is dynamically allocated and de-allocated from the extent pool. ESE volumes are used for IBM DS8000® thin provisioning.

Note: To use this subparameter, you must have previously created space-efficient storage (by using the mksestg command) for the extentpool.

-eam rotateexts | rotatevols

(Optional) Specifies the extent allocation method as follows:

rotateexts

Specifies that the extents for each new logical volume are allocated across all available ranks, and is also known as storage-pool striping. This value is the default.

rotatevols

Specifies that the extents for each new logical volume are allocated from each successive rank. This means that the extents for a particular volume will be allocated from one rank, while the extents for the next volume will be allocated from the next successive rank, and so on.

-perfgrp performance_group_ID

(Optional) Specifies the performance group ID that the volumes are assigned to. The performance group ID begins with the letters PG. The default is PG0.

-resgrp resource_group_ID

(Optional) Specifies the resource group that the volumes are assigned to. The resource group ID begins with the letters RG and ends with a decimal number. The default is RG0.

Note: If you create any fixed block LSSs with this command, the LSSs are assigned to the same resource group as the logical volumes.

-t10dif

(Optional) Specifies that the CRC-16-T10-DIF algorithm is being used to store data.

Note: The -t10dif and -os400 parameters cannot be used together.

volume_ID ... | -

(Required) An array of one or more fixed block volume IDs to be created. The volumes must share a common logical subsystem ID.

The volume ID format is four hexadecimal characters XYZZ that represents the following values.

X

Specifies the address group, 0–F.

XY

Specifies the logical subsystem number, 00 - FE.

ZZ

Specifies the volume number, 00 - FF.

To specify a range of volume IDs, separate the volume IDs with a dash (-).

You must separate multiple volume IDs or ranges of volume IDs with a blank space between each ID or range of IDs.

Example: 0100-010F 0180-018F 0120

The ellipsis (...) indicates that, optionally, you can specify multiple values. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) while you are in the DS CLI interactive command mode.