lschp - List channel paths

Edit online

Use the lschp command to display information about channel paths.

lschp syntax


1  lschp
1 --help
1 --version

Where:

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 it is 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.

-v or --version
displays the version number of lschp and exits.
-h or --help
displays a short help text, then exits. To view the man page enter man lschp.

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).