Previous Topic: PPRCCMD DISPLAY VOLUME—Query all established PPRC volume pairsNext Topic: PPRCCMD DELETE PATH—Delete selected PPRC path


PPRCCMD SETUP PATH—Setup new PPRC path

The PPRCCMD SETUP PATH command establishes an FCP (fibre channel protocol) path between a primary site logical subsystem and a recovery (secondary) site logical subsystem.

When the primary site logical subsystem supports eight paths, each SETUP PATH command can establish up to eight paths from one primary site logical subsystem to a single recovery site logical subsystem. You can link up to four recovery site logical subsystems to one primary site logical subsystem. These links require that you issue a separate SETUP PATH command for each logical subsystem.

Note: To replace paths use the SETUP PATH command. The paths on the command are treated as a path set. Any subsequent SETUP PATH command removes paths that were previously established and replaces them with the new set of paths. To ensure that you do not remove paths that you want to keep, use caution when using this command.

This command has the following format:

PPRCCMD SETUP PATH DEVNUM(devid) LINK(up to 8 path addresses)
PWWNN(wwnn) PSSID(ssid) [PLSS(lss)]
SWWNN(wwnn) SSSID(ssid) [SLSS(lss)]
[CGROUP(YES|NO) SUBCHSET(0|1)]
DEVNUM(devid)

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

LINK(X’aaaabbbb’[ X’ccccdddd’ X’ xxxxyyyy’ …])

Specifies the addressing paths from the primary site logical subsystem to the recovery site logical subsystem.

You can specify up to eight Fibre Channel path addresses (if the primary site logical subsystem supports it), separated with a blank.

Note: Duplicate link addresses are not allowed.

Each path address is an 8-digit hexadecimal address. The format of each Fibre Channel path address has the hex digit form aaaabbbb where:

aaaa

Specifies the Fibre Channel adapter that is used for the path in the primary subsystem.

bbbb

Specifies the Fibre Channel adapter that is used for the path in the secondary subsystem.

PWNN(wwnn)

Specifies the World Wide Node Name of the primary storage controller and it is exactly 16-digit hexadecimal number.

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.

SWNN(wwnn)

Specifies the World Wide Node Name of the secondary storage controller and it is exactly 16-digit hexadecimal number.

SSSID(ssid)

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

SLSS(lss)

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

CGROUP(yes/no)

(Optional) Specifies whether a PPRC volume pair in a consistency group remains in a long-busy condition for a specified period following an error that is related to the associated volume pair. When an error occurs, and one of the volumes in that consistency group is suspended. The volumes in that consistency group are suspended when the next write occurs to a volume.

One of the following values must be specified with the CGROUP parameter:

NO

(Default) Specifies when an error occurs to a PPRC volume pair in a consistency group, the long-busy condition is not enabled for the associated volume pair.

YES

Specifies when an error occurs to a PPRC volume pair in a consistency group, the long-busy condition is enabled for the associated volume pair.

Note: Automation products can detect PPRC volume pair outages on these devices and can take the appropriate action.

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 records contain the following delimited fields: