mklcu

The mklcu command creates a logical control unit (LCU) in a storage image.


>>-mklcu--+-------------------------+-- -qty--quantity---------->
          '- -dev--storage_image_ID-'                    

>-- -id--lcu_ID-- -ss--ss_ID--+-------------------------+------->
                              '- -lcutype--+-3990-3---+-'   
                                           +-3990-tpf-+     
                                           +-3990-6---+     
                                           '-bs2000---'     

>--+------------+--+------------------+------------------------->
   '- -critmode-'  '- -pprcconsistgrp-'   

>--+------------------------+--+-------------------+-----------><
   '- -extlongbusy--timeout-'  '- -ccsess--timeout-'

Parameters

Notes:

A logical control unit is configured to represent a grouping of logical CKD volumes.
Multiple sequential LCU IDs can be created with a single request, but all logical control units must be of the same type and specify the same options.
The DS6000 has a 16 384 volume address space that is partitioned into 64 logical subsystem (LSS) units, where each LSS contains 256 logical volume numbers (1750 only). The 64 LSS units are assigned to one of 4 address groups, where each address group contains 16 LSSs, or 4096 volume addresses. All of the LSSs in one address group must be of the same type (CKD or fixed block).
LCUs are typically created in groups of 16, beginning at LSS address X’x0’.

-dev storage_image_ID

(Optional). Specifies the storage image ID, which includes manufacturer, type, and serial number.

Example: IBM.1750-68FA120

-qty quantity

(Required). Specifies the number of LCU IDs to be created. The valid range is 1 - 64 (1750 only).

This command is rejected if any of the LCU IDs which are based on the initial LCU ID and the quantity, are currently defined or are outside the range of supported LCU IDs. The valid LCU ID range is 00 - 1F (1750 only).

Example: 16

-id lcu_ID

(Required). Specifies the LCU ID to be created, or the first LCU ID in a sequence of LCU IDs to be created. A LCU ID is two hexadecimal characters 00 - 1F (1750 only).

Example: 00

-ss ss_ID

(Required). Specifies the subsystem ID that you have assigned. A subsystem ID is four hexadecimal characters 0x0001 - 0xFFFF. If multiple LCU IDs are being created, then the SSID value increments for each additional LCU ID that is created.

If 16 LCUs are created, starting with SSID 0x10, then the SSID values are 0x0010 – 0x001F.

Example: 0010

-lcutype 3990-3 | 3990-tpf | 3990-6 | bs2000

(Optional). Specifies that one of the following types of LCU be created:

3990-3: type 3990 model 3
3990-tp: type 3990 model 3 for tpf

3990-6: type 3990 model 6

bs2000: type bs 2000

-critmode

(Restricted). Specifies that critical heavy mode be enabled. Critical Heavy mode controls the behavior of the remote copy and mirror pairs that have a primary logical volume on this LCU. The default value is disable.

You must have administrator privileges to specify this option. See the mkpprc command for additional notes about the use of this parameter.

Note: If an attempt is made to create the LCU and enable the critical heavy mode but the user does not have the authority to enable the -critmode parameter, two messages are displayed when the command is processed:

One message states that the LCU has been successfully created
A second message states "Your user ID does not have the authority to perform this operation"

So, the LCU is created but the critical heavy mode is not enabled.

-pprcconsistgrp

(Optional). Specifies a remote mirror and copy consistency group state setting. Any volume that becomes suspended that is associated with the subsystem LSS passes into an extended Long Busy state unless the consistency group that was created previously has been received. Otherwise, the volume does not become long busy.

-extlongbusy timeout

(Optional). Specifies the time in seconds that an LCU consistency group volume stays long busy after reporting an error that causes a remote mirror and copy suspension if a consistency group has not been created. The default value is 120 seconds.

-ccsess timeout

(Optional). Specifies the concurrent copy cession timeout parameter as the time in seconds that any LCU volume in a concurrent copy session stays long busy before suspending a concurrent copy session. The valid timeout range is 1 - 9999 seconds. The default value is 300 seconds.

Example: 500

Example (1750)

Invoking the mklcu command

dscli>dscli>mklcu -dev IBM.1750-68FA120 -qty 16 -id 00 -ss FF00

The resulting output

Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.1750-68FA120  

LCU 00 successfully created.
LCU 01 successfully created.
…
LCU 0F successfully created.