freezepprc

The freezepprc command creates a new remote mirror and copy consistency group. It places the source logical subsystem (LSS) in the long busy state so that no I/Os can be directed to it. It also removes remote mirror and copy paths between the source LSS and target LSS and sets the queue full condition for the primary volume. This causes the host to queue writes to the primary volume until the queue full condition is reset. During the queue full condition, the primary volume reports long busy status.


>>-freezepprc--+-------------------------+---------------------->
               '- -dev--storage_image_ID-'   

>--+-------------------------------+--+----------------+-------->
   '- -remotedev--storage_image_ID-'  '- -srcss--ss_ID-'   

>--+----------------+------------------------------------------->
   '- -tgtss--ss_ID-'   

>--+-Source_LSS_ID:Target_LSS_ID--+-------+-+------------------><
   |                              '-. . .-' |   
   '-" - "----------------------------------'

Parameters

Note: When specifying SSIDs, the command is limited to one LSS pair.

-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 LSS ID.; Example: IBM.1750-68FA120
-remotedev storage_image_ID: (Optional). Specifies the target storage image ID, which includes manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified target LSS ID or if the -dev parameter is used.; Example: IBM.1750-68FA150
-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
Source_LSS_ID:Target_LSS_ID . . . | -: (Required). Specifies that a consistency group for the source and target LSSs with the IDs specified be placed in a long busy state. Accepts fully qualified LSS IDs, which includes the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified.; A remote mirror and copy path LSS pair ID consists of two LSS IDs, one designated as the source LSS and the other as the target LSS for a remote mirror and copy path relationship. The two LSS IDs must be separated with a colon and no spaces. The first LSS ID is the source LSS. The second LSS ID is the target LSS.; The fully qualified LSS ID format is storage_image_ID/xx, where xx is a hexadecimal number in the range 00 - 1F (1750 only).; If you specify the dash (-), this parameter information is automatically supplied.; Example of a pair: 00:00; Example of multiple pairs: 00:00 01:01 02:02

Example (1750)

Invoking the freezepprc command

dscli>freezepprc -dev IBM.1750-68FA120 
-remotedev IBM.1750-68FA150 01:01

The resulting output

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

Remote Mirror and Copy consistency group 01:01 successfully created.