mkfbvol

The mkfbvol command creates open systems fixed block (FB) volumes in a storage image.

Read syntax diagramSkip visual syntax diagram
>>-mkfbvol--+-------------------------+-- -extpool--extentpool_ID-->
            '- -dev--storage_image_ID-'                             

>--+------------------+--+--------------------+----------------->
   '- -os400--+-A01-+-'  '- -type--+--------+-'   
              +-A81-+              +-ess----+     
              +-A02-+              +-ds-----+     
              +-A82-+              '-blocks-'     
              +-A04-+                             
              +-A84-+                             
              +-A05-+                             
              +-A85-+                             
              +-A06-+                             
              +-A86-+                             
              +-A07-+                             
              '-A87-'                             

>--+-----------------+--+---------------------+----------------->
   '- -cap--capacity-'  '- -name--volume_name-'   

>--+---------------------------+--+--------+-------------------->
   '- -volgrp--volume_group_ID-'  '- -wait-'   

>--+-volume_ID--+-------+-+------------------------------------><
   |            '-. . .-' |   
   '-" - "----------------'   

Parameters

Notes:
  1. You can create multiple volumes with one command; however, all volumes must have the same capacity, extent pool, and data type.
  2. If host attachment volume groups have not yet been created, create temporary volume groups and assign new fixed block volumes to the temporary volume groups according to the volume type and capacity characteristics.
-dev storage_image_ID
(Optional) Specifies the storage image ID, which includes manufacturer, type, and serial number.
-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 zeroes, prefixed with the letter P.
-os400 A01 | A81 | A02 | A82 | A04 | A84 | A05 | A85 | A06 | A86 | A07 | A87
(Optional) The OS 400 volume options.
This parameter is required if capacity is not specified.
The storage sizes and the data types for this volume:
  • A01 - 8.6 GB, protected
  • A81 - 8.6 GB, unprotected
  • A02 - 17.5 GB, protected
  • A82 - 17.5 GB, unprotected
  • A04 - 70.5 GB, protected
  • A84 - 70.5 GB, unprotected
  • A05 - 35.1 GB, protected
  • A85 - 35.1 GB, unprotected
  • A06 - 141.12 GB, protected
  • A86 - 141.12 GB, unprotected
  • A07 - 282.25 GB, protected
  • A87 - 282.25 GB, unprotected
GB is 10^9 Byte.
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 10^9 Bytes.
ds: Specifies that the unit is 2^30 Bytes.
blocks: Specifies that the unit is 512 blocks.
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.
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:
  • 1GB = 1,073,741,824 (2^30 Bytes)
  • Supported storage sizes range from 1 to 2048.
If the -type ess parameter is specified:
  • capacity = X.Y or X
    • where X is whole gigabytes, with 1 GB=1,000,000,000 (10^9 Bytes).
    • where Y represents a fraction of 1 GB. Y is limited to a single digit (0…9) to the right of the decimal.
  • Supported storage sizes range from 0.1 to 982.2 (0.1 increment).
If the -type blocks parameter is specified, capacity is the number of 512 blocks. Supported storage sizes are from 1 to 4294967296 (4x2^30 Bytes).
-name volume_name
(Optional) Your nickname for this volume. The nickname can be 16 characters long, and it 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 zeroes, 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 issue a new command.
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 is a 32 bit number that can be represented as 4 hexadecimal digits in the form of XYZZ where X is the address group (0 - 1), XY together is the logical subsystem number 00 - 1E (for 1750) , and ZZ is 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
If you specify a dash (-), this parameter information is automatically supplied.

Example (1750)

Invoking the mkfbvol command
dscli>mkfbvol -dev IBM.1750-68FA120
 -extpool P1 -name my_vol_#d -type ess
	-cap 8.6 0100 0101 0102 0103 
The resulting output
Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Device: IBM.1750-68FA120  

FB volume 0100 successfully created.
FB volume 0101 successfully created.
FB volume 0102 successfully created.
FB volume 0103 successfully created.
Related tasks
Creating fixed block volumes using the DS CLI
Configuring new fixed block storage
Creating fixed block volume groups using the DS CLI
Related reference
chlss
lslss
showlss
chfbvol
rmfbvol
lsfbvol
showfbvol
mkvolgrp
chvolgrp
rmvolgrp
lsvolgrp
showvolgrp
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.