move - Move a cartridge to another slot

Purpose

Move a cartridge that is located in one slot to another slot. The target slot can be in a different library than the library of the current cartridge. The target slot cannot belong to a CMC slot group. The target slot can belong to any other slot group, including an I/O or internal slot group.

Syntax

move -pcl <cartridgePCL> [[[-lib <library_name>] -toslot <slot_name>] | -tosg <slot_group>]

Parameters

-pcl cartridgePCL: Specifies the cartridge to move.
-lib library_name: Specifies the target library to where you want to move the cartridge. The default value is the existing library of the cartridge to be moved. This optional parameter can be used only along with the -toslot parameter.
-toslot slot_name: Specifies the target slot to where you want to move the cartridge.
-tosg slot_group: Specifies the target slot group to where you want to move the cartridge.

Results

Beyond the general error code, the following command-specific error codes are returned:

EMM1825E - in this case, no active library manager is configured for the library, or the library manager is not present (for example, running).
EMM1806E - in this case, the specified library is not be found.

Examples

move -pcl 496AFQL3 -toslot 4111

move -pcl A00001L4 -tosg I/O

move -pcl A00002L4 -tosg internal

Moving a cartridge between libraries

When you implement the TSLM CLI move command to move a cartridge between libraries that are connected by a shuttle connection, error EMM2909E is generated when the destination slot is already occupied by another cartridge. The following example shows a move command where CART1, DEST_LIB, and DEST_SLOT are the actual names of the cartridge label, destination library, and destination slot:

      ermmtool> move -pcl CART1 -lib DEST_LIB -toslot DEST_SLOT

The resulting error message is shown in the following example:

      EMM2909E: Destination location DEST_SLOT is full. 3584 sense data:

To recover from this type of error situation, do the following these steps:

Use the following lsslot command to check where the cartridge is located:
```
      ermmtool> lsslot -pcl CART1
```
The following error message is expected as a result:
```
      EMM7009I: No matching records found.
```
Use the audit command for the source library, where SRC_LIB is the actual name of the source library.
```
      ermmtool> audit SRC_LIB
```
Use the audit for the destination library:
```
      ermmtool> audit DEST_LIB
```
Use the following lsslot command to check where the cartridge is located:
```
      ermmtool> lsslot -pcl CART1
```
The cartridge is now expected in a slot in the CMC slot group. CMC is the slot group for the slots that are assigned to the shuttle station. To avoid blocking the shuttle station use, you must move the cartridge to an available location. Use the following move command to move the cartridge to an internal slot:
```
      ermmtool> move -pcl CART1 -tosg internal
```
Use the following lsslot command to list the slot where the cartridge was moved:
```
      ermmtool> lsslot -pcl CART1
```