# Class CIM_VirtualTapeService
extends CIM_Service

This service allows the active management of a Virtual Tape Library System for the creation, modification, and deletion of Virtual Tapes.

### 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_VirtualTapeService

## Direct Known Subclasses

## Class Qualifiers

Name | Data Type | Value
--- | --- | ---
Description | string | This service allows the active management of a Virtual Tape Library System for the creation, modification, and deletion of Virtual Tapes.
Experimental | boolean | true
UMLPackagePath | string | CIM::Device::Tape
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

#### CreateTapeFromPool (uint32)

#### Method Qualifiers (CreateTapeFromPool)

Name | Data Type | Value
--- | --- | ---
Description | string | Create one or more Virtual Tapes. 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 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 TheTape will contain a Reference to the virtual PhysicalTape if this operation completed successfully. The desired settings for the Tape are specified by the TapeSetting reference parameter.
Experimental | boolean | true
ValueMap | string | 0, 1, 2, 3, 4, 5, 6, 7, 8, .., 4098..32767, 32768..65535
Values | string | No Error, No Space, No Library, No Slots, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, DMTF Reserved, Method Reserved, Vendor Specific

#### Method Parameters (CreateTapeFromPool)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
Count | uint32
Description | string | Number of virtual tapes to create.
StartingSlot | uint32
Description | string | The new tapes will be placed in empty slots that are equal to or higher than this given slot number. This number can be zero indicating that the new tapes can be placed in any emptry slots.
NewTape | CIM_PhysicalTape[]
Description | string | An array of newly created virtual PhysicalTape objects.
IN | boolean | false
OUT | boolean | true
Pool | REF CIM_StoragePool
Description | string | Storage pool form which space for the Tape media is to be allocated from.
TapeSetting | REF CIM_VirtualTapeSettingData
Description | string | The requirements for the VirtualTape element to maintain. This is a reference to a CIM_VirtualTapeSettingData or a derived class instance parameter; this allows the client to specify the properties desired for the virtual tape. When the Tape is created successfully, this setting object is attached to the PhysicalTape objects.
VirtualLibrary | REF CIM_ComputerSystem
Description | string | The owning Virtual TapeLibrary for the new virtual tapes.

#### DeleteTape (uint32)

#### Method Qualifiers (DeleteTape)

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

#### Method Parameters (DeleteTape)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
TheTape | REF CIM_PhysicalTape
Description | string | A reference to the virtual PhysicalTape to be deleted.

#### MoveMedia (uint32)

#### Method Qualifiers (MoveMedia)

Name | Data Type | Value
--- | --- | ---
Description | string | Move virtual PhysicalTape media from one slot to another. The destination can be a slot number of a vault where the tape is moved to a virtual vault with no access to a host. The destination can also be a Input/Output port of the virtual TapeLibrary in which case the virtual tape will be exported to a physical media.
Experimental | boolean | true
ValueMap | string | 0, 1, 2, 3, 4, 5, 6, 7, .., 4096..32767, 32768..
Values | string | Job Completed with No Error, No Such Tape, Not Supported, Unknown, Timeout, Failed, Unspecified Reasons, Invalid Parameter, Tape in use, Failed, DMTF Reserved, Method Reserved, Vendor Specific

#### Method Parameters (MoveMedia)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
Destination | REF CIM_StorageMediaLocation
Description | string | A reference to the destination slot.
Source | REF CIM_StorageMediaLocation
Description | string | A reference to the slot containing the media to be moved.

### Inherited Class Methods

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