PESTPATH (PPRC establish path)

Use request type PESTPATH to establish PPRC paths. This invokes ANTRQST ILK=PPRC REQUEST=PESTPATH.

DEVN(devn)
Specifies the hexadecimal device number to be used for I/O. This device number must identify a CKD device defined to the host system making the request. It is required.
PLSS(plss)
Specifies the hexadecimal logical subsystem number (LSS) within the primary storage subsystem. PLSS is required for storage subsystems with logical subsystems and is invalid for 3990 and other 3990-compatible storage controls.
PSERIAL(pserial)
Specifies the EBCDIC serial number of the primary storage control. It is required. Specifying this parameter indicates that PPRC LINKs between the subsystems use ESCON communication protocols. PSERIAL requires SSERIAL and is mutually exclusive with PWWNN.
PWWNN(pwwnn)
Specifies the hexadecimal world wide node name (WWNN) of the primary storage control. It is required. Specifying this parameter indicates that PPRC LINKs between the subsystems use Fibre Channel Protocol (FCP) communication protocols. PWWNN requires the SWWNN parameter and is mutually exclusive with PSERIAL
PSSID(pssid)
Specifies the hexadecimal subsystem identifier (SSID) of the primary storage control. It is required.
SLSS(slss)
Specifies the hexadecimal logical subsystem number (LSS) within the secondary storage subsystem. SLSS is required for storage subsystems with logical subsystems and is invalid for 3990 and other 3990-compatible storage controls.
SSERIAL(sserial)
Specifies the EBCDIC serial number of the secondary storage control. It is required. Specifying this parameter indicates that PPRC LINKs between the subsystems use ESCON communication protocols. SSERIAL requires the PSERIAL parameter and is mutually exclusive with SWWNN
SWWNN(swwnn)
Specifies the hexadecimal world wide node name (WWNN) of the secondary storage control. It is required. Specifying this parameter indicates that PPRC LINKs between the subsystems use Fibre Channel Protocol (FCP) communication protocols. SWWNN requires the PWWNN parameter and is mutually exclusive with SSERIAL.
SSSID(sssid)
Specifies the hexadecimal subsystem identifier (SSID) of the secondary storage control. It is required.
LINKS(link1,link2,link3...)
Specifies the hexadecimal path address from the application site storage control to the recovery site storage control. You can specify up to 4 hexadecimal path addresses, separated by commas, with each LINKS keyword, and you can specify LINKS multiple times. For example, you could specify the following for up to 8 path addresses per PESTPATH command:
LINKS(11111111,22222222,33333333)
LINKS(44444444,55555555,66666666)
LINKS is mutually exclusive with LINK1. LINKS or LINK1 are required.
LINK1(link1)
Specifies the hexadecimal path address from the application site storage control to the recovery site storage control. LINK1 is mutually exclusive with LINKS. You must specify either LINKS or LINK1.
LINK2(link2)
Specifies the hexadecimal path address from the application site storage control to the recovery site storage control. LINK2 requires the LINK1 parameter.
LINK3(link3)
Specifies the hexadecimal path address from the application site storage control to the recovery site storage control. LINK3 requires the LINK2 parameter.
LINK4(link4)
Specifies the hexadecimal path address from the application site storage control to the recovery site storage control. LINK4 requires the LINK3 parameter.
CGROUP(NO | YES)
Indicates a logical control unit subsystem should emulate 3990 Critical Volume mode for CGROUP automation.
NO
3990 Critical Volume mode should not be emulated. This is the default.
YES
3990 Critical Volume mode should be emulated, permitting CGROUP automation processing of PPRC pair errors
RESETHP(NO | YES)
Specifies whether to reset host path connections to the primary subsystem before attempting to establish paths.
NO
Host path connections to the primary subsystem will not be reset. The request will return an error indicating some or all paths failed. This is the default
YES
Host paths to the primary subsystem on the specified link addresses should be reset to permit the request to use the link addresses for connections to the secondary subsystem.
OPENDVCS(NO | YES)
Indicates if the request is for Open System (fixed block) devices.
NO
The device specified with DEVN, as well as the primary and secondary devices, are CKD devices. This is the default.
YES
The values supplied for the primary and secondary devices (SSID, Serial, LSS and LUN) apply to Open Systems devices and not to the CKD DEVN device. The DEVN parameter identifies a CKD device used for receiving the request.
WAITTIME(waittime | 0)
Specifies the number of seconds that SDM must wait for a request to complete. A value of zero specifies that the request should not be timed. Valid values are 0 through 65535.

The default is 0.

SUBCHSET(subchset | 0)
Specifies the subchannel set in which the command is to be issued. The subchannel set where the I/O will be issued is the subchannel set as defined in the Hardware Configuration Dialog (HCD). The valid values are determined by what is supported by the host system's processor and configured for the device.

If you omit the parameter, the command is issued to the device that is logically in subchannel set 0. If a swap has occurred, this could be the device that was defined in an alternate subchannel set in the I/O configuration (IODF), with HCD.