lschp - List channel paths

Red Hat Enterprise Linux 9.2 LPAR mode z/VM guest KVM guest

Use the lschp command to display information about channel paths.

lschp syntax

Read syntax diagramSkip visual syntax diagramlschp--help--version
Where:
-v or --version
displays the version number of lschp and exits.
-h or --help
displays a short help text, then exits.

Output column description:

CHPID
Channel-path identifier.
Vary
Logical channel-path state:
  • 0 = channel-path is not used for I/O.
  • 1 = channel-path is used for I/O.
Cfg.
Channel-path configure state:
  • 0 = stand-by
  • 1 = configured
  • 2 = reserved
  • 3 = not recognized
Type
Channel-path type identifier.
Cmg
Channel measurement group identifier.
Shared
Indicates whether a channel-path is shared between LPARs:
  • 0 = channel-path is not shared
  • 1 = channel-path is shared
PCHID
Physical channel path identifier, or, if enclosed in brackets, internal channel identifier. The mapping might not be available to Linux® when running as a z/VM® guest. If so, use the CP command:
QUERY CHPID <num> PCHID

A column value of '-' indicates that a facility associated with the corresponding channel-path attribute is not available.

Examples

  • To query the configuration status of channel path ID 0.40 issue:
    # lschp
    
    CHPID Vary Cfg. Type Cmg Shared  PCHID
    ======================================
    ...
    ...
    0.40  1    1    1b   2   1       0580
    ...
    ...
    The value under Cfg. shows that the channel path is configured (1).