Added Support For Storage Control Unit API

docs/appendix.rst

@@ -268,7 +268,7 @@ This documentation uses a few special terms:
 
    fulfillment
       The act of satisfying requests for creation, modification, or deletion of
-      storage volumes in a storage subsystem (i.e. of the actual storage
+      storage volumes in a :term:`Storage Subsystem` (i.e. of the actual storage
       backing a :term:`storage volume` object).
 
       Storage volume objects have a fulfillment state indicating whether the
@@ -527,6 +527,58 @@ Resources scoped to CPCs in DPM mode
   Storage Port
      Short term for a :term:`Port` of a :term:`Storage Adapter`.
 
+  Storage Site
+     A location that houses a set of storage switches and storage subsystems
+     within the FICON storage configuration of a DPM-enabled :term:`CPC`.
+     A Storage Site object with `type="primary"` always exists for the primary
+     site and cannot be deleted. Additional Storage Site objects can be created
+     and deleted.
+
+     For details, see section :ref:`Storage Sites`.
+
+  Storage Fabric
+     A collection of interconnected storage switches in the FICON storage
+     configuration of a DPM-enabled :term:`CPC`. A storage fabric can span
+     multiple :term:`Storage Sites <Storage Site>` and is the logical grouping
+     to which :term:`Storage Switches <Storage Switch>` belong.
+
+     For details, see section :ref:`Storage Fabrics`.
+
+  Storage Control Unit
+     A logical entity within a :term:`Storage Subsystem` that manages a set
+     of storage volumes. A storage control unit is identified within its
+     parent subsystem by a two-character hexadecimal ``logical-address``. It
+     can have up to 8 :term:`storage paths <Storage Path>` and a set of
+     volume ranges that describe the volumes it manages.
+
+     For details, see section :ref:`Storage Control Units`.
+
+  Storage Path
+     An element object nested inside a :term:`Storage Control Unit` that
+     defines a communication path from the control unit to a storage adapter,
+     optionally through one or two storage switches.
+
+     For details, see section :ref:`Storage Paths`.
+
+  Storage Subsystem
+     A physical storage device (e.g. an IBM DS8000 series system) in the FICON
+     storage configuration of a DPM-enabled :term:`CPC`. A storage subsystem
+     belongs to exactly one :term:`Storage Site` and can be moved between sites
+     within the same FICON configuration. Connection endpoints (storage switches
+     or adapters) can be added and removed from a storage subsystem to describe
+     how it is physically connected to the storage network.
+
+     For details, see section :ref:`Storage Subsystems`.
+
+  Storage Switch
+     A physical storage switch in the FICON storage configuration of a
+     DPM-enabled :term:`CPC`. A storage switch belongs to exactly one
+     :term:`Storage Site` and one :term:`Storage Fabric`, and can be moved
+     between sites and fabrics. Storage switches can be defined and undefined
+     via the :term:`Console`.
+
+     For details, see section :ref:`Storage Switches`.
+
   Storage Volume
      An FCP or ECKD (=FICON) storage volume defined in context of a
      :term:`storage group`. The life cycle of a storage volume includes being
@@ -539,13 +591,34 @@ 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

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
@@ -418,6 +458,126 @@ Storage Volume Templates
    :special-members: __str__
 
 
+.. _`Storage Fabrics`:
+
+Storage Fabrics
+---------------
+
+.. automodule:: zhmcclient._storage_fabric
+
+.. autoclass:: zhmcclient.StorageFabricManager
+   :members:
+   :autosummary:
+   :autosummary-inherited-members:
+   :special-members: __str__
+
+.. autoclass:: zhmcclient.StorageFabric
+   :members:
+   :autosummary:
+   :autosummary-inherited-members:
+   :special-members: __str__
+
+
+.. _`Storage Sites`:
+
+Storage Sites
+-------------
+
+.. automodule:: zhmcclient._storage_site
+
+.. autoclass:: zhmcclient.StorageSiteManager
+   :members:
+   :autosummary:
+   :autosummary-inherited-members:
+   :special-members: __str__
+
+.. autoclass:: zhmcclient.StorageSite
+   :members:
+   :autosummary:
+   :autosummary-inherited-members:
+   :special-members: __str__
+
+
+.. _`Storage Switches`:
+
+Storage Switches
+----------------
+
+.. automodule:: zhmcclient._storage_switch
+
+.. autoclass:: zhmcclient.StorageSwitchManager
+   :members:
+   :autosummary:
+   :autosummary-inherited-members:
+   :special-members: __str__
+
+.. autoclass:: zhmcclient.StorageSwitch
+   :members:
+   :autosummary:
+   :autosummary-inherited-members:
+   :special-members: __str__
+
+
+.. _`Storage Control Units`:
+
+Storage Control Units
+---------------------
+
+.. automodule:: zhmcclient._storage_control_unit
+
+.. autoclass:: zhmcclient.StorageControlUnitManager
+   :members:
+   :autosummary:
+   :autosummary-inherited-members:
+   :special-members: __str__
+
+.. autoclass:: zhmcclient.StorageControlUnit
+   :members:
+   :autosummary:
+   :autosummary-inherited-members:
+   :special-members: __str__
+
+
+.. _`Storage Paths`:
+
+Storage Paths
+-------------
+
+.. automodule:: zhmcclient._storage_path
+
+.. autoclass:: zhmcclient.StoragePathManager
+   :members:
+   :autosummary:
+   :autosummary-inherited-members:
+   :special-members: __str__
+
+.. autoclass:: zhmcclient.StoragePath
+   :members:
+   :autosummary:
+   :autosummary-inherited-members:
+   :special-members: __str__
+
+
+.. _`Storage Subsystems`:
+
+Storage Subsystems
+------------------
+
+.. automodule:: zhmcclient._storage_subsystem
+
+.. autoclass:: zhmcclient.StorageSubsystemManager
+   :members:
+   :autosummary:
+   :autosummary-inherited-members:
+   :special-members: __str__
+
+.. autoclass:: zhmcclient.StorageSubsystem
+   :members:
+   :autosummary:
+   :autosummary-inherited-members:
+   :special-members: __str__
+
+
 .. _`Partition Links`:
 
 Partition Links