LSCHP(8)

💅 lschp — list info about available channel-paths 💅

okay so bestie, this is the lschp page from section 8 — manual name LSCHP(8), System Manager's Manual energy — and we're about to get into channel-paths. Not me being obsessed with channel-path identifiers, but here we are. 💖

✨ NAME ✨

lschp — list information about available channel-paths. Periodt.

🌸 SYNOPSIS 🌸

lschp [-h|--help] [-v|--version] [--format FORMAT] [ CHPID ]

🦋 DESCRIPTION 🦋

The lschp command lists status and type information about available channel-paths. If you pass a CHPID argument, it returns the information for that specific channel-path identifier only — like a little spotlight, but for one channel-path. ✨

Channel-path identifiers are specified in hexadecimal notation, either simply as the CHPID-number (e.g. e0) or in the form:

<cssid>.<id>

where <cssid> is the channel-subsystem identifier and <id> is the CHPID-number (e.g. 0.7e). iykyk.

Column description — yes bestie, here's the tea on every column:

• 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-ID unless the 4-digit hexadecimal value is enclosed in parenthesis.

If the value is enclosed in parenthesis, no physical channel-ID is associated with the CHPID, and the value is an internal channel-ID.

For example, 0501 specifies a PCHID whereas (0502) specifies an internal channel-ID.

A column value of - indicates that a facility associated with the respective channel-path attribute is not available. So if you see a -, it's giving "not available, bestie" — not a typo. 💅

🎀 OPTIONS 🎀

• -h, --help — Print a short help text, then exit. The "help me help you" option. 🫶
• -v, --version — Print version number, then exit. Slay, version check. ✨
• --format FORMAT — Specify the output format. Supported formats include json, json-seq, jsonl, pairs and csv. See section "OUTPUT FORMAT" for more details. 👑

🌈 OUTPUT FORMAT 🌈

This section contains additional information for json output format.

🍓 json

JSON output consists of a top-level object with the following properties (key-value pairs):

• meta: Tool meta-data including API level, version, host name, and time of invocation
• channel-paths: Information about available Channel-path

Example JSON output for channel-path with all properties:

{
  "meta": {
    "api_level": 1,
    "version": "2.39.0-build-20260119",
    "host": "localhost",
    "time_epoch": 1769092556,
    "time": "2026-01-22 15:35:56+0100"
  },
  "channel_paths": [
    {
      "chpid": "0.32",
      "vary": 1,
      "cfg": 1,
      "type": 27,
      "cmg": 2,
      "shared": 1,
      "chid": 576,
      "chid_external": true
    },
    {
      "chpid": "0.34",
      "vary": 1,
      "cfg": 0,
      "type": 27,
      "cmg": null,
      "shared": null,
      "chid": 608,
      "chid_external": true
    },
    {
      "chpid": "0.f8",
      "vary": 1,
      "cfg": 1,
      "type": 36,
      "cmg": 3,
      "shared": 1,
      "chid": 2040,
      "chid_external": false
    }
  ]
}

💜 SEE ALSO 💜

• chchp(8)
• More information on the Channel-path type identifier can be found at https://www.ibm.com/docs/en/zos/3.1.0?topic=iee196i-iee174i-form-2-37

---

Signed, sealed, and slayed by s390-tools · Mar 2007 · LSCHP(8) 🫶💖