Added support for tape link and virtual tape resource

docs/appendix.rst

@@ -539,14 +539,37 @@ 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 Libraries`.
 
+     Tape Link
+      A Tape Link represents a single tape link associated with a DPM-enabled
+      :term:`CPC`. Tape links define pathways to :term:`Tape Library` storage
+      that can be attached to :term:`Partitions <Partition>`.
+
+      When a tape link is attached to a partition, its fulfilled resources are
+      virtualized and the partition's view of them is represented by
+      :term:`Virtual Tape Resources <Virtual Tape Resource>`.
+
+      Tape Link resources are top-level resources whose conceptual parent is
+      the :term:`Console`; a linked tape library is identified by the
+      ``tape-library-uri`` property of the tape link.
+
+      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
      virtualized because they belong to a :term:`Partition`. Therefore, the

docs/resources.rst

@@ -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

tests/end2end/mocked_hmc_z16.yaml

@@ -355,7 +355,7 @@ hmc_definition:
                 adapter-port-uri: /api/adapters/fcp1
                 partition-uri: /api/partitions/part1
 
-      tape_library:
+      tape_libraries:
         - properties:
             # class : created automatically
             # parent : created automatically
@@ -365,6 +365,70 @@ hmc_definition:
             description : Tape Library resource 1
             cpc-uri : /api/cpcs/cpc_dpm
 
+      tape_links:
+        - properties:
+            # class: created automatically
+            # parent: created automatically
+            # object-uri: created automatically
+            object-id: tlink1
+            name: "Tape Link 1"
+            cpc-uri: /api/cpcs/cpc_dpm
+            description: "Tape link connecting Tape Library to 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
+            # object-uri: created automatically
+            object-id: tlink2
+            name: "Tape Link 2"
+            cpc-uri: /api/cpcs/cpc_dpm
+            description: "Tape link for testing"
+            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:
             # class: created automatically