chlcu

The chlcu command modifies a logical control unit.

Read syntax diagramSkip visual syntax diagram
>>-chlcu--+-------------------------+--+-----------------+------>
          '- -dev--storage_image_ID-'  '- -ss--new_ss_ID-'   

>--+-------------------------+--+-------------------------+----->
   '- -lcutype--+-3990-3---+-'  '- -critmode--+-enable--+-'   
                +-3990-tpf-+                  '-disable-'     
                +-3990-6---+                                  
                '-bs2000---'                                  

>--+-------------------------------+---------------------------->
   '- -pprcconsistgrp--+-enable--+-'   
                       '-disable-'     

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

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

Parameters

-dev storage_image_ID
(Optional). Specifies the storage image ID, which consists of manufacturer, type, and serial number.
Example: IBM.1750-68FA120
-ss new_ss_ID
(Optional). Specifies your new LCU subsystem ID value (valid range is hexadecimal 0x0001 - 0xFFFF). If this parameter is specified, multiple LCUs are not allowed. The new SSID that you specify replaces the existing SSID value in the initial target LCU ID.
Example: F010
-lcutype 3990-3 | 3990-tpf | 3990-6 | bs2000
(Optional). Changes the target LCUs to the new LCU type:
3990-3
TYPE_3990_MODEL_3
3990-tpf
TYPE_3990_MODEL_3_for_TPF
3990-6
TYPE_3990_MODEL_6
BS2000
TYPE_BS_2000
-critmode enable | disable
(Restricted). Specifies that the critical heavy mode setting in the target LCUs be enabled or disabled. Critical heavy mode controls the behavior of the remote mirror and copy (formerly PPRC) pairs that have a primary logical volume on this LCU and are in an LCU consistency group. See the mkpprc command for additional information.

You must have administrator privileges to specify this option.

-pprcconsistgrp enable | disable
(Optional). Specifies that the remote mirror and copy consistency group state setting be enabled or disabled. Any volume that becomes suspended that is associated with the subsystem LSS passes into an extended Long Busy state unless a created consistency group 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 (formerly PPRC) suspension if a consistency group has not been created.
-ccsess timeout
(Optional). Specifies the concurrent copy session timeout in seconds setting. This value indicates how long (in seconds) any LCU volume in a concurrent copy session stays long busy before the concurrent copy session is suspended.
Example: 500
LCU_ID . . . | -
(Required). Specifies one or more LCUs that are to be modified by this command. An LCU ID is two hexadecimal characters 00 - 1F. You must separate multiple IDs and multiple ID ranges with a space. Accepts a fully qualified LCU ID or a shortened version, if the -dev parameter is specified.
To specify a range of LCU IDs, separate the IDs with a hyphen (-).
If you have specified a new subsystem ID value with the -ss parameter, only one LCU ID can be specified.
If you specify the dash (-), this parameter information is automatically supplied.
Example: 00-03 08

Example (1750)

Invoking the chlcu command
dscli>chlcu -dev IBM.1750-68FA120 -critmode enable 00-0F 
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 modified.
LCU 01 successfully modified.
...
LCU 0F successfully modified.
Related reference
lsaddressgrp
mklcu
rmlcu
lslcu
showlcu
mkckdvol
chckdvol
rmckdvol
lsckdvol
showckdvol
mkflash
rmflash
lsflash
setflashrevertible
resyncflash
reverseflash
commitflash
revertflash
unfreezeflash
mkgmir
pausegmir
resumegmir
rmgmir
showgmir
lssession
mksession
chsession
rmsession
chlss
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.