zhmccli - A CLI for the IBM Z HMC, written in pure Python
Overview
The zhmccli package is a CLI written in pure Python that interacts with the Hardware Management Console (HMC) of IBM Z or LinuxONE machines. The goal of this package is to provide an easy-to-use command line interface for operators.
The zhmccli package uses the API provided by the zhmcclient package, which interacts with the Web Services API of the HMC. It supports management of the lifecycle and configuration of various platform resources, such as partitions, CPU, memory, virtual switches, I/O adapters, and more.
Installation
-
If not yet available, install the "pipx" command as described in https://pipx.pypa.io/stable/installation/.
-
Without having any virtual Python environment active, install the CLI as follows:
$ pipx install zhmccli
That makes the
zhmccommand available in the PATH, without having to activate any virtual Python environment.
For more details, see the Installation section in the documentation.
Quickstart
The following example lists the names of the machines (CPCs) managed by an HMC:
$ hmc_host="<IP address or hostname of the HMC>"
$ hmc_userid="<userid on that HMC>"
$ zhmc -h $hmc_host -u $hmc_userid cpc list --names-only
Enter password (for user ... at HMC ...): .......
+----------+
| name |
|----------+
| P000S67B |
+----------+
Documentation
Contributing
For information on how to contribute to this project, see the Development section in the documentation.
License
The zhmccli package is licensed under the Apache 2.0 License.
2 maintainers
Metadata
2 maintainers
Release files for zhmccli 1.15.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| zhmccli-1.15.0.tar.gz | 282.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| zhmccli-1.15.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 476.8 kB
Release files / zhmccli-1.15.0.tar.gz
| Download URL | zhmccli-1.15.0.tar.gz |
|---|---|
| Size | 282.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9187ac207942ee82a896f6af24298dddae98ea48074b2d28dc249c426e1a9372
|
|
BLAKE2b-256 checksum How to use checksums |
cb28545ac3424e1e72e06b67f521f4801e07d9c488530f12f288e8af982587d8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 26, 2026.
Transparency logRelease files / zhmccli-1.15.0-py3-none-any.whl
| Download URL | zhmccli-1.15.0-py3-none-any.whl |
|---|---|
| Size | 194.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
383584ceb9d3cf613e2eef2e272a5270658856f42cdc1a0044b3d4c1f2bb56a9
|
|
BLAKE2b-256 checksum How to use checksums |
e3b35343e59058c5128cb1ec5e1be5dcad1a199a96c283783ca0fdf97df6fffc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 26, 2026.
Transparency log
