pausepprc

Parameters

-dev storage_image_ID

(Optional). Specifies the source storage image ID, which includes manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified source volume ID or you do not specify a value for the devid variable in your profile file.

Example: IBM.1750-68FA120

-remotedev storage_image_ID

(Optional most times, however required as noted). Specifies the target storage image ID, which includes manufacturer, type, and serial number.

Note: The -remotedev parameter is required when volume pairs are specified and the -dev parameter is specified as well.

Example: IBM.1750-68FA120

-at src | tgt

(Optional).

src

Select the -at source parameter option to initiate a suspend action from the source volume. After the task successfully runs, the source and target volumes are in the suspend state.

The -at source parameter option can also be used with single volumes. When you specify a single volume using this option, the volume is treated as a source and the target is treated as a null.

tgt

Select the -at target parameter option to initiate a suspend action from the target volume. After the command successfully runs, the target volume is in the suspend state, but there is no guarantee that the source volume is suspended as well. For a suspend action that is issued to the target, the source can remain in the active state.

The -at target parameter option can also be used with single volumes. When you specify a single volume using this parameter option, the volume is treated as a target and the source is treated as a null.

-unconditional

(Optional). Use this parameter to indicate that a source or target volume has been selected individually, and not as a pair. The -unconditional parameter is valid only if the -at parameter is selected. When you specify the -unconditional parameter, you can specify only the source volume ID if the -at source parameter option is selected, or specify only the target volume ID if the -at target parameter option is selected. Do not use volume pair IDs.

-srcss ss_ID

(Optional). Specifies the subsystem ID of the primary logical subsystem in the format '0x0001 - 0xFFFF'.

This value is required for the IBM System Storage™ Enterprise Storage Server versions 2.4.0 and 2.4.1.

Example: 0010

-tgtss ss_ID

(Optional). Specifies the subsystem ID of the secondary logical subsystem in the format 0x0001 - '0xFFFF'.

This value is required for the IBM System Storage Enterprise Storage Server versions 2.4.0 and 2.4.1.

Example: 0010

SourceVolumeID:TargetVolumeID . . . | –

(Required). Specifies that a remote mirror and copy volume relationship for the source and target volume pairs with the IDs specified be paused.

Note: Provide a single volume ID instead of a volume pair if you use the -unconditional parameter. Specifying pairs results in a format error.

This parameter accepts fully qualified volume IDs, which includes storage image IDs, or a shortened version without storage image IDs if the -dev parameter is specified. You must separate multiple remote mirror and copy pair IDs with spaces.

A remote mirror and copy pair ID consists of two volume IDs, one designated as the source and the other as the target volume for a remote mirror and copy relationship. You must separate the two volume IDs of a remote mirror and copy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume.

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

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

Note: Requests directed to target volumes are sent to the Storage Image identified by the -dev parameter or embedded in the fully qualified single volume IDs.

Example of a fully qualified pair: IBM.1750-68FA120/0100:IBM.1750-68FA150/0100

Example of a shortened version: 0100:0100

Example of multiple pairs: 0101:0101 0102:0102 0103:0103