# Class CIM_VirtualTapeLibraryConfigurationService
extends CIM_Service

CIM_VirtualTapeLibraryConfigurationService allows the active management of a Virtual Tape Library System for the creation, modification, and deletion of Virtual Tape Libraries.

### Table of Contents
Hierarchy
Direct Known Subclasses
Class Qualifiers
Class Properties
Class Methods

## Class Hierarchy

CIM_ManagedElement
|
+--CIM_ManagedSystemElement
|
+--CIM_LogicalElement
|
+--CIM_EnabledLogicalElement
|
+--CIM_Service
|
+--CIM_VirtualTapeLibraryConfigurationService

## Direct Known Subclasses

## Class Qualifiers

Name | Data Type | Value
--- | --- | ---
Description | string | CIM_VirtualTapeLibraryConfigurationService allows the active management of a Virtual Tape Library System for the creation, modification, and deletion of Virtual Tape Libraries.
Experimental | boolean | true
UMLPackagePath | string | CIM::Device::Tap
Version | string | 2.42.0

## Class Properties

### Inherited Properties

Name | Data Type | Class Origin
--- | --- | ---
Caption | string | CIM_ManagedElement
CommunicationStatus | uint16 | CIM_ManagedSystemElement
CreationClassName | string | CIM_Service
Description | string | CIM_ManagedElement
DetailedStatus | uint16 | CIM_ManagedSystemElement
ElementName | string | CIM_ManagedElement
EnabledDefault | uint16 | CIM_EnabledLogicalElement
EnabledState | uint16 | CIM_EnabledLogicalElement
Generation | uint64 | CIM_ManagedElement
HealthState | uint16 | CIM_ManagedSystemElement
InstallDate | datetime | CIM_ManagedSystemElement
InstanceID | string | CIM_ManagedElement
LoSID | string | CIM_Service
LoSOrgID | string | CIM_Service
Name | string | CIM_Service
OperatingStatus | uint16 | CIM_ManagedSystemElement
OtherEnabledState | string | CIM_EnabledLogicalElement
PrimaryOwnerContact | string | CIM_Service
PrimaryOwnerName | string | CIM_Service
PrimaryStatus | uint16 | CIM_ManagedSystemElement
RequestedState | uint16 | CIM_EnabledLogicalElement
Started | boolean | CIM_Service
StartMode | string | CIM_Service
Status | string | CIM_ManagedSystemElement
SystemCreationClassName | string | CIM_Service
SystemName | string | CIM_Service
TimeOfLastStateChange | datetime | CIM_EnabledLogicalElement
TransitioningToState | uint16 | CIM_EnabledLogicalElement
AvailableRequestedStates | uint16[] | CIM_EnabledLogicalElement
OperationalStatus | uint16[] | CIM_ManagedSystemElement
StatusDescriptions | string[] | CIM_ManagedSystemElement

## Class Methods

### Local Class Methods

#### CreateVTL (uint32)

#### Method Qualifiers (CreateVTL)

Name | Data Type | Value
--- | --- | ---
Description | string | Create a Virtual Tape Library. If the operation completes successfully, it will return 0. This method shall return a CIM_Error representing that a single named property of a setting reference parameter has an invalid value or that an invalid combination of named properties of a setting (or other) parameter (either reference or embedded object) has been requested. The parameter TheVTL will contain a Reference to the VirtualTapeLibrary CIM_ComputerSystem if this operation completed successfully. The desired settings for the VTL are specified by the VTLSetting reference parameter.
Experimental | boolean | true
ValueMap | string | 0, 1, 2, 3, 4, 5, .., 4098..32767, 32768..65535
Values | string | No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, DMTF Reserved, Method Reserved, Vendor Specific

#### Method Parameters (CreateVTL)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
TheVTL | REF CIM_ComputerSystem
Description | string | The newly created VTL CIM_CompuyerSystem object.
IN | boolean | false
OUT | boolean | true
VTLSetting | REF CIM_VirtualTapeLibrarySetting
Description | string | The requirements for the VirtualTapeLibrary element to maintain. This is a reference to a CIM_VirtualTapeLibrarySetting or a derived class instance parameter; this allows the client to specify the properties desired for the virtual tape library. When the VTL is created successfully, this setting object is attached to the VTL CIM_ComputerSystem object.
IN | boolean | true

#### ModifyVTL (uint32)

#### Method Qualifiers (ModifyVTL)

Name | Data Type | Value
--- | --- | ---
Description | string | Modify a previously created VTL. If the operation completes successfully, it will return 0. This method MUST return a CIM_Error representing that a single named property of a setting (or other) parameter (either reference or embedded object) has an invalid value or that an invalid combination of named properties of a setting (or other) parameter (either reference or embedded object) has been requested. The parameter VTLSetting specifies the setting to be modified. This element MUST be associated via ElementSettingData with a VTL CIM_ComputerSystem.
Experimental | boolean | true
ValueMap | string | 0, 1, 2, 3, 4, 5, 6, 7, .., 4098..32767, 32768..65535
Values | string | No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, VTL In Use, cannot Modify, Cannot satisfy new Goal., DMTF Reserved, Method Reserved, Vendor Specific

#### Method Parameters (ModifyVTL)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
VTLSetting | REF CIM_VirtualTapeLibrarySetting
Description | string | A reference to the VTL setting object that contains the Modify property parameter populated with a list of properties to be modified.
IN | boolean | true

#### DeleteVTL (uint32)

#### Method Qualifiers (DeleteVTL)

Name | Data Type | Value
--- | --- | ---
Description | string | Delete a VTL. If the method completed successfully it will return 0.
Experimental | boolean | true
ValueMap | string | 0, 1, 2, 3, 4, 5, 6, .., 4096..32767, 32768..
Values | string | Job Completed with No Error, Not Supported, Unknown, Timeout, Failed, Unspecified Reasons, Invalid Parameter, VTL in use, Failed, DMTF Reserved, Method Reserved, Vendor Specific

#### Method Parameters (DeleteVTL)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
SaveTapes | boolean
Description | string | A Boolean to indicate if the virtual tapes in the library are to be deleted or not.
IN | boolean | true
TheVTL | REF CIM_ComputerSystem
Description | string | An element or association that uniquely identifies the VTL to be deleted.
IN | boolean | true

### Inherited Class Methods

Name | Return Type | Class Origin
--- | --- | ---
ChangeAffectedElementsAssignedSequence | uint32 | CIM_Service
RequestStateChange | uint32 | CIM_EnabledLogicalElement
StartService | uint32 | CIM_Service
StopService | uint32 | CIM_Service