lspprc Command

Edit online

Purpose

Displays information about PPRC (Peer-to-Peer Remote Copy) disks.

Syntax

lspprc -A [-o ]

lspprc -c pprc_disk

lspprc [ -h ]

lspprc -p pprc_disk

lspprc -v pprc_disk

Description

The lspprc command displays information that is related to PPRC disk like vital product data (VPD) information of the individual LUNs that are part of the PPRC disk, path group information of a PPRC disk, replication path information of a PPRC disk, and a list of all PPRC disks available on the system.

Flags

Item Description
-A [ -o ] Displays the information of all PPRC disks in the system, such as PPRC state and path groups IDs. The optional -o flag briefly opens all potential PPRC disks before displaying the status, ensuring that the status is current. Use of the -o flag might increase the length of time that is required to run the command, depending on the number of disks that are attached to the system.
Example: 
hdisk#   PPRC      Primary        Secondary    Primary Storage   Secondary Storage
         state     path group     path group   WWNN              WWNN
                   ID             ID
hdisk4   Active    0(s)        	   1            500507630affc16b  500507630affc16b
hdisk5   Active    0(s)           1            500507630affc16b  500507630affc16b
hdisk6   Active    0(s)           1            500507630affc16b  500507630affc16b
Note: For explanation of the path group IDs and the selected path group that is identified as s, see the description of the -p flag.
-c Displays information about the replication path connection, which is related to a PPRC disk. The output displays information about the replication paths between the two storage subsystems that contain the LUNs in the PPRC pair. The output displays the worldwide node names, Subsystem IDs (SSID), Logical Subsystems (LSS), and ports for the endpoints of the paths and the current path state. The contents of the output depends on the current state of the PPRC disk.
  • If the disk is not part of a PPRC pair, the output shows all paths that originate from the LSS that the disk resides on, to any other LSS.
  • If the disk is part of a PPRC pair, but has only one path group, the output displays paths that originate from the LSS on which the disk resides and lead to the LSS on which the partner disk resides.
  • If the disk is part of a PPRC pair and has two path groups, the output displays all paths between the two LSSs on which the members of the PPRC pair reside.
Example output of the replication paths:
lspprc -c hdisk33

Displays all paths between LSS 01 and LSS 03

Source                         Target
WWNN             SSID LSS Port WWNN             SSID LSS Port State
===================================================================
500507630AFFC16B FF03 03  0301 500507630AFFC16B FF01 01  0302 Up
500507630AFFC16B FF03 03  0302 500507630AFFC16B FF01 01  0303 Up
500507630AFFC16B FF01 01  0300 500507630AFFC16B FF03 03  0302 Up
-p Displays path group information that is part of the specified PPRC disk.
Example output of path group information:
lspprc -p hdisk55
Path       WWNN               LSS   VOL    Path
group id                                   group status
=======================================================
0(s)       500507630affc16b   0xf  0x1c    PRIMARY                                         
1          5005076303ffd2ea  0xc1   0x0    SECONDARY

path      path  path       parent  connection
group id  id    status
=====================================================================
     0    0     Available  fscsi0  500507630a08016b,400f401c00000000
     0    1     Available  fscsi0  500507630a08416b,400f401c00000000
     1    2     Available  fscsi1  50050763030812ea,40c1400000000000
     1    3     Available  fscsi1  50050763030852ea,40c1400000000000

When you use PPRC, the paths are grouped based on which LUN is accessed by the path, in the PPRC pair. The path group ID indicates how the paths are grouped, with all paths that have the same path group ID accessing the same LUN in the PPRC pair. A path group ID of -1 indicates that there are no paths that are configured from this initiator to the indicated LUN in the PPRC pair.

At any time, only one of the two path groups is selected for I/O operations to the hdisk. The selected path group is identified in the output by "(s)".
-v Displays the VPD information of individual LUNs that are part of given PPRC disk.
Example output of VPD information: 
# lspprc -v hdisk0

Hyperswap lun unique identifier.............35203735544c3737313
037303000502a14ae07210790003IBMfcp

hdisk0  Primary         MPIO IBM 2107 FC Disk

        Manufacturer..................IBM
        Machine Type and Model........2107900
        ROS Level and ID..............2E313630
        Serial Number.................75TL7710
        Device Specific.(Z7)..........0700
        Device Specific.(Z0)..........000005329F101002
        Device Specific.(Z1)..........700
        Device Specific.(Z2)..........075
        Unique Device Identifier......200B75TL771070007210790003IBMfcp
        Logical Subsystem ID..........0x07
        Volume Identifier.............0x00
        Subsystem Identifier(SS ID)...0xFF07
        Control Unit Sequence Number..00000TL771
        Storage Subsystem WWNN........500507630affc16b
        Logical Unit Number ID........4007400000000000

hdisk0  Secondary       MPIO IBM 2107 FC Disk

        Manufacturer..................IBM
        Machine Type and Model........2107900
        ROS Level and ID..............2E313630
        Serial Number.................75TL7710
        Device Specific.(Z7)..........0900
        Device Specific.(Z0)..........000005329F101002
        Device Specific.(Z1)..........900
        Device Specific.(Z2)..........075
        Unique Device Identifier......200B75TL771090007210790003IBMfcp
        Logical Subsystem ID..........0x09
        Volume Identifier.............0x00
        Subsystem Identifier(SS ID)...0xFF09
        Control Unit Sequence Number..00000TL771
        Storage Subsystem WWNN........500507630affc16b
        Logical Unit Number ID........4009400000000000

Files

Item Description
/usr/bin/lspprc Contains the lspprc command.