chsession

Parameters

-dev storage_image_ID

(Optional) The ID of the storage image containing the logical subsystem. The storage image ID includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID or do not set the devid variable in your profile or with the setenv command. The storage image ID is also required if the HMC is associated with more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command.

-remotedev storage_image_ID

(Optional) The remote DS system that contains one or more target volume IDs that are defined by the source_volume_ID:target_volume_ID variable of the -volpair parameter. The remote storage ID includes the manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified target volume ID or if you specify the -dev parameter.

-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 - FE.

This parameter 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.

-action add | remove

(Required). Specify one of the following values.

add

Volumes to be added to the session.

remove

Volumes to be removed from the session.

-volpair source_volume_ID:target_volume_ID ... | -volume volume_ID ...

(Required) 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.

The ellipsis (...) indicates that, optionally, you can specify multiple values. 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.

Notes:

• Specify either the -volpair parameter or the -volume parameter.
• See the following information for the -volpair and -volume parameters.

-volpair source_volume_ID:target_volume_ID ...

A Remote Mirror and Copy pair ID consists of two volume IDs, one designated as the source and the other as the target for a Remote Mirror and Copy relationship. To specify two volume IDs, separate the volume IDs with a colon and no space. The first volume ID is the designated source volume and the second ID as the designated target volume. The secondary volume ID is required to identify a specific relationship in a Multi-Target Metro Mirror relationship.

To specify fully qualified volume IDs, include the storage image ID or a shortened version without storage image ID if you specify the -dev or -remotedev parameters.

The volume ID is a 32-bit number that can be represented as four hexadecimal digits in the form of 0xXYZZ, where:

X

The address group, 0 - F.

XY

The logical subsystem number, 00 - FE.

ZZ

The volume number, 00 - FF.

Example of multiple volume IDs and ranges: 0200-0204:0400-0404,0210:0410

-volume volume_ID ...

The volume ID is a 32-bit number that can be represented as four hexadecimal digits in the form of XYZZ, where:

XY

The logical subsystem number, 00 - FE.

ZZ

The volume number, 00 - FF.

X

The address group, 0 - F.

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

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

Session_ID | -

(Required) 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 use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.

Example of a session ID: 01