mkgmir

Parameters

-dev storage_image_ID

(Optional). Specifies the storage image ID, which includes manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified LSS ID, which includes a storage image ID.

Example: IBM.1750-68FA120

-lss LSS_ID

(Required). Specifies the master logical subsystem (LSS) that receives the mkgmir command. This parameter accepts a fully qualified master 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

-cginterval seconds

(Optional). Specifies the consistency group interval time, in seconds. This number specifies how long to wait between the formation of consistency groups. If this number is not specified or is set to zero, consistency groups are formed continuously. The consistency group interval setting is required for a start action. If not specified, the default interval is zero. The consistency group interval setting can be modified for a resume action; otherwise, the interval that is specified for the start action is maintained.

The maximum value is 65 535 seconds.

-coordinate milliseconds

(Optional). Specifies the maximum coordination interval, in milliseconds. This value indicates the maximum time that Global Mirror processing queues Primary/Host/IO to start forming a consistency group. The coordination interval setting is required for a start action. If this value is not specified, the default interval is 50 milliseconds.

The coordination interval setting can be modified for a resume action: otherwise, the interval that is specified for the start action is maintained. The maximum value is 65 535 milliseconds.

-drain seconds

(Optional). Specifies the maximum consistency group drain time in seconds and the maximum amount of time that the consistent set of data is allowed to drain to the remote site before failing the current consistency group. The drain time setting is required for a start action. If the drain time is not specified, the default drain time is 30 seconds.

The drain time setting can be modified for a resume action; otherwise, the time that is specified for the start action is maintained.

-session session_ID

(Required). Specifies that Global Mirror for the specified session be started or resumed. A session ID is a Global Mirror session number that you assign in the 01 - FF hexadecimal range.

Example: 01

Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID . . . | -

(Optional). Specifies one or more Global Mirror associations. A Global Mirror association consists of two fully qualified LSS IDs. The first is designated as the master resource and the second is the subordinate resource between which a PPRC path has been established. An LSS ID is two characters in the 00 - 1F (1750 only) hexadecimal range. You must separate the fully qualified LSS IDs of a Global Mirror association with a colon and no spaces. The master resource must be identical for all relationships.

If you specify the dash (-), this parameter information is automatically supplied. However, you cannot use the dash (-) if you are using the DS CLI interactive mode.

Example of one Global Mirror association with a single subordinate in the configuration: IBM.1750-68FA120/00: IBM.1750-68FA150/00

Example of multiple Global Mirror associations with two subordinates in the configuration: IBM.1750-68FA120/00: IBM.1750-68FA150/00 IBM.1750-68FA120/00: IBM.1750-68FA150/01