chsession

The chsession command allows you to modify a Global Mirror session.


>>-chsession--+-------------------------+-- -lss--ID------------>
              '- -dev--storage_image_ID-'              

>-- -action--+-add----+-- -volume--+-volume_ID-+---------------->
             '-remove-'            '-. . .-----'   

>--+-Session_ID-+----------------------------------------------><
   '-" - "------'

Parameters

-dev storage_image_ID

(Optional). Specifies the ID of the storage image containing the logical subsystem. The storage image ID includes manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified ID for the LSS ID and you do not specify a value for the devid variable in your profile file.

Example: IBM.1750-68FA120

-lss ID

(Required). The logical subsystem (LSS) ID for the Global Mirror session. The format of the LSS ID is a hexadecimal number in the range 00 - 1F (1750 only).

Accepts a fully qualified LSS ID, which includes either the storage image ID or a shortened version without the storage image ID if the -dev parameter is specified.

Example of a fully qualified LSS ID: IBM.1750-68FA120/10

-action add | remove

(Required).

add: Specifies that volumes be added to the session.
remove: Specifies that volumes be removed from the session.

-volume volume_ID . . .

(Required). Specifies an array of one or more volume IDs or volume ID ranges to be added or removed for the Global Mirror session. All volumes must share a common logical subsystem.

To specify a range of volume IDs, you must separate the volume IDs with a hyphen. To specify a combination of one or more volume IDs and a range of volume IDs, separate the volume IDs and ranges with commas.

Do not qualify the volume ID with the storage image 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).

Example of a volume ID: 0010

Example of a range of volume IDs: 0010-001F

Example of multiple volume IDs and ranges: 0100-010F,0180-018F,0120

Session_ID | -

(Required). Specifies the Global Mirror session that is modified for this session ID. A session ID is a hexadecimal number in the range 01 - FF.

If you specify the dash (-), this parameter information is automatically supplied.

Example of a session ID: 01

Example (1750)

Invoking the chsession command

dscli>chsession -dev IBM.1750-68FA120 -lss 10 -action add 
-volume 1000-1010 01

The resulting output

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

Global Mirror session 01 successfully modified.