Previous Topic: PPRCCMD SETUP VOLUME—Setup new PPRC volume pairsNext Topic: ADDRESS SOF Examples


PPRCCMD DELETE VOLUME—Delete selected PPRC volume pair

The PPRCCMD DELETE VOLUME command deletes a volume pair.

This command has the following format:

PRCCMD DELETE VOLUME DEVNUM(devid)
PSERIAL(serial) PCCA(cca) PSSID(ssid) [PLSS(lss)] 
SSERIAL(serial) SCCA(cca) SSSID(ssid) [SLSS(lss)]
[SUBCHSET(0|1)]
DEVNUM(devid)

Specifies the device number of the primary volume for the volume pair to be deleted. The device number is the four-digit hexadecimal address of the device to which the I/O operation is directed.

PSERIAL(serial)

Specifies the primary storage control serial number, which can include up to 12 digits, depending on the type of storage control.

PCCA(cca)

Specifies the primary a two-digit channel connection address.

PSSID(ssid)

Specifies the primary site storage subsystem ID and it is a four-digit hexadecimal number.

PLSS(lss)

(Optional) Specifies the primary site logical subsystem number and it is a two-digit hexadecimal number.

SSERIAL(serial)

Specifies the secondary storage control serial number, which can include up to 12 digits, depending on the type of storage control.

SCCA(cca)

Specifies the secondary a two-digit channel connection address.

SSSID(ssid)

Specifies the secondary site storage subsystem ID and it is a two-digit hexadecimal number.

SLSS(lss)

(Optional) Specifies the secondary site logical subsystem number and it is a four-digit hexadecimal number.

SUBCHSET(0/1)

(Optional) Specifies the subchannel set where the command is issued. The subchannel set where the I/O is issued is the subchannel set as defined in the Hardware Configuration Dialog (HCD). The values are:

0

(Default) Subchannel set 0.

1

Subchannel set 1.

Created stem variables:

The output stem variable record contains the following delimited fields:

PPRCCMD FREEZE—Stop Updates to the Secondary Subsystem

You can use PPRCCMD FREEZE when your automation application detects a failure while mirroring data from the primary to the secondary. The FREEEZE command lets you preserve data consistency.

Important! You must be intimately familiar with PPRC before coding applications that issue the FREEZE command.

The PPRCCMD FREEZE command stops all updates to secondary subsystems for pairs that have primary and secondary volumes on the corresponding logical subsystems that this command specified. The system suspends these pairs and removes all paths between the specified primary and secondary subsystems.

All host application I/O to the primary holds off with a long busy condition for 2 minutes, or until a PPRCCMD RUN command is issued. To use the FREEZE command, establish the path with CGROUP(YES) as the PPRCCMD SETUP PATH command specifies.

If you fail to specify CGROUP(YES) in the PPRCCMD SETUP PATH command, the host I/O is not held off with a long busy condition. To resume operations, you reestablish the paths between the primary and secondary subsystems. Then, you reestablish the pairs using the MODE(RESYNC) parameter, through the PPRCCMD SETUP VOLUME command.

This command has the following format:

PRCCMD FREEZE DEVNUM(devid)
PSERIAL(serial) PSSID(ssid) [PLSS(lss)] 
SSERIAL(serial) SSSID(ssid) [SLSS(lss)]
[SUBCHSET(0|1)]
DEVNUM(devid)

Specifies the device number of any disk volume that is attached to the primary site storage control, without directing any operation to the volume. The device number is the four-digit hexadecimal address of any disk volume behind the primary site storage control.

PSERIAL(serial)

Specifies the primary storage control serial number, which can include up to 12 digits, depending on the type of storage control.

PSSID(ssid)

Specifies the primary site storage subsystem ID as a four-digit hexadecimal number.

PLSS(lss)

(Optional) Specifies the primary site logical subsystem number as a two-digit hexadecimal number.

SSERIAL(serial)

Specifies the secondary storage control serial number, which can include up to 12 digits, depending on the type of storage control.

SSSID(ssid)

Specifies the secondary site storage subsystem ID as a two-digit hexadecimal number.

SLSS(lss)

(Optional) Specifies the secondary site logical subsystem number as a four-digit hexadecimal number.

SUBCHSET(0/1)

(Optional) Specifies the subchannel set that issued the command. The subchannel set that issued the I/O is the subchannel set as defined in the Hardware Configuration Dialog (HCD).

This set has the following values:

0

(Default) Subchannel set to 0.

1

Subchannel set to 1.

Created stem variables:

The output stem variable record contains the following delimited fields:

PPRCCMD RUN—Resumes I/O on Primary Volumes

The PPRCCMD RUN command specifies that host application I/O can resume on primary volumes for pairs that have primary and secondary volumes on the corresponding logical subsystems that this command specified, which have been suspended due to an earlier PPRCCMD FREEZE command.

This command has the following format:

PRCCMD RUN DEVNUM(devid)
PSERIAL(serial) PSSID(ssid) [PLSS(lss)] 
SSERIAL(serial) SSSID(ssid) [SLSS(lss)]
[SUBCHSET(0|1)]
DEVNUM(devid)

Specifies the device number of any disk volume that is attached to the primary site storage control without directing any operation to the volume. The device number is the four-digit hexadecimal address of any disk volume behind the primary site storage control.

PSERIAL(serial)

Specifies the primary storage control serial number, which can include up to 12 digits, depending on the type of storage control.

PSSID(ssid)

Specifies the primary site storage subsystem ID as a four-digit hexadecimal number.

PLSS(lss)

(Optional) Specifies the primary site logical subsystem number as a two-digit hexadecimal number.

SSERIAL(serial)

Specifies the secondary storage control serial number, which can include up to 12 digits, depending on the type of storage control.

SSSID(ssid)

Specifies the secondary site storage subsystem ID as a two-digit hexadecimal number.

SLSS(lss)

(Optional) Specifies the secondary site logical subsystem number as a four-digit hexadecimal number.

SUBCHSET(0/1)

(Optional) Specifies the subchannel set where the command is issued. The subchannel set where the I/O is issued is the subchannel set as defined in the Hardware Configuration Dialog (HCD).

This set has the following values:

0

(Default) Subchannel set to 0.

1

Subchannel set to 1.

Created stem variables:

The output stem variable record contains the following delimited fields: