Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 18 additions & 4 deletions docs/appendix.rst
Original file line number Diff line number Diff line change
Expand Up @@ -540,12 +540,26 @@ Resources scoped to CPCs in DPM mode
Storage Volume Template
A template for :term:`Storage Volumes <Storage Volume>`.

Tape library
Tape Library
A Tape Library represents one physical tape storage unit connected to
a CPC.Tape libraries are automatically discovered,but discovery requires
preprocessing,A single Worldwide Port Name (WWPN) must be zoned so the CPC
a CPC. Tape libraries are automatically discovered, but discovery requires
preprocessing. A single Worldwide Port Name (WWPN) must be zoned so the CPC
can see the tape library.
For details, see section :ref:`Tape Library`.
For details, see section :ref:`Tape Libraries`.

Tape Link
A Tape Link connects a :term:`Tape Library` to one or more :term:`Partitions <Partition>`,
enabling the partitions to access tape drives in the tape library. A tape link
defines the connectivity and resource allocation for tape access.
For details, see section :ref:`Tape Links`.

Virtual Tape Resource
A representation of a tape-related z/Architecture device in a :term:`Partition`.
A Virtual Tape Resource object represents access to a tape drive through a
:term:`Tape Link`. Each virtual tape resource is associated with a specific
adapter port and provides the partition with a device number for accessing
the tape drive.
For details, see section :ref:`Virtual Tape Resources`.

vHBA
Synonym for :term:`HBA`. In this resource model, HBAs are always
Expand Down
40 changes: 40 additions & 0 deletions docs/resources.rst
Original file line number Diff line number Diff line change
Expand Up @@ -358,6 +358,46 @@ Tape Libraries
:special-members: __str__


.. _`Tape Links`:

Tape Links
----------

.. automodule:: zhmcclient._tape_link

.. autoclass:: zhmcclient.TapeLinkManager
:members:
:autosummary:
:autosummary-inherited-members:
:special-members: __str__

.. autoclass:: zhmcclient.TapeLink
:members:
:autosummary:
:autosummary-inherited-members:
:special-members: __str__


.. _`Virtual Tape Resources`:

Virtual Tape Resources
----------------------

.. automodule:: zhmcclient._virtual_tape_resource

.. autoclass:: zhmcclient.VirtualTapeResourceManager
:members:
:autosummary:
:autosummary-inherited-members:
:special-members: __str__

.. autoclass:: zhmcclient.VirtualTapeResource
:members:
:autosummary:
:autosummary-inherited-members:
:special-members: __str__


.. _`Virtual Storage Resources`:

Virtual Storage Resources
Expand Down
63 changes: 63 additions & 0 deletions tests/end2end/mocked_hmc_z16.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -364,6 +364,69 @@ hmc_definition:
name : Tape Library
description : Tape Library resource 1
cpc-uri : /api/cpcs/cpc_dpm
tape_links:
- properties:
# class: created automatically
# parent: created automatically
# element-uri: created automatically
element-id: tlink1
name: "Tape Link 1"
description: "Tape link connecting Tape Library to PART1"
partition-uri: /api/partitions/part1
tape-library-uri: /api/tape-libraries/tl1
virtual_tape_resources:
- properties:
# class: created automatically
# parent: created automatically
# element-uri: created automatically
element-id: vtr1
name: "Virtual Tape Resource 1"
description: "Virtual tape resource 1"
device-number: "0001"
adapter-port-uri: /api/adapters/fcp1/storage-ports/0
partition-uri: /api/partitions/part1
world-wide-port-name-info:
status: validated
world-wide-port-name: "c05076ffe8000001"
degraded-reasons: []
- properties:
# class: created automatically
# parent: created automatically
# element-uri: created automatically
element-id: vtr2
name: "Virtual Tape Resource 2"
description: "Virtual tape resource 2"
device-number: "0002"
adapter-port-uri: /api/adapters/fcp1/storage-ports/1
partition-uri: /api/partitions/part1
world-wide-port-name-info:
status: validated
world-wide-port-name: "c05076ffe8000002"
degraded-reasons: []
- properties:
# class: created automatically
# parent: created automatically
# element-uri: created automatically
element-id: tlink2
name: "Tape Link 2"
description: "Tape link for testing"
partition-uri: /api/partitions/part1
tape-library-uri: /api/tape-libraries/tl1
virtual_tape_resources:
- properties:
# class: created automatically
# parent: created automatically
# element-uri: created automatically
element-id: vtr3
name: "Virtual Tape Resource 3"
description: "Virtual tape resource 3"
device-number: "0003"
adapter-port-uri: /api/adapters/fcp1/storage-ports/0
partition-uri: /api/partitions/part1
world-wide-port-name-info:
status: not-validated
world-wide-port-name: "c05076ffe8000003"
degraded-reasons: []

hw_messages:
- properties:
Expand Down
Loading
Loading