Added support for tape link and virtual tape resource

Signed-off-by: Vonteddu Chaithra <Vonteddu.Chaithra1@ibm.com>

Author: Vonteddu Chaithra

docs/appendix.rst

@@ -539,14 +539,28 @@ 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 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
      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

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