CHECKOUT LIBVOLUME (Dar de baja un volumen de almacenamiento de una biblioteca)

Clase de privilegio

Para emitir este mandato, debe tener privilegio de sistema o privilegio de almacenamiento sin restricciones.

Parámetros

nombre_biblioteca (Obligatorio)

Especifica el nombre de la biblioteca.

nombre_volumen

Especifica el nombre del volumen.

VOLRange

Especifica dos nombres de volúmenes separados por una coma. Este parámetro es un rango de volúmenes que deben darse de baja. Si no hay volúmenes en la biblioteca dentro del rango especificado, el mandato finalizará sin errores.

Especifique solamente los nombres de volúmenes que se puedan incrementar numéricamente. Además del área incremental, un nombre de volumen puede contener un prefijo alfanumérico, un sufijo alfanumérico o ambos.

Parámetro	Descripción
volrange=bar110,bar130	Se dan de baja los 21 volúmenes: bar110, bar111, bar112,...bar129, bar130.
volrange=bar11a,bar13a	Se dan de baja 3 los volúmenes: bar11a, bar12a, bar13a.
volrange=123400,123410	Se dan de baja los 11 volúmenes: 123400, 123401, ...123409, 123410.

VOLList

Especifica una lista de los volúmenes que han de extraerse. Si no hay volúmenes en la biblioteca que se encuentren en la lista, el mandato finaliza sin errores.

Los valores posibles son:

nombre_volumen

Especifica los nombres de uno o varios volúmenes que se utilizan para el mandato. Ejemplo: VOLLIST=TAPE01,TAPE02.

FILE:nombre_archivo

Especifica el nombre de un archivo que contiene una lista de los volúmenes para el mandato. En el archivo, cada nombre de volumen debe estar en una línea diferente. Se hace caso omiso de las líneas en blanco y de las líneas de comentarios que comienzan por un asterisco. Por ejemplo, para utilizar los volúmenes TAPE01, TAPE02 y TAPE03, debe crear un archivo, TAPEVOL, que contenga las siguientes líneas:

TAPE01
TAPE02
TAPE03

Puede especificar los volúmenes para el mandato según se indica a continuación: VOLLIST=FILE:TAPEVOL.

Atención: el nombre de archivo distingue entre mayúsculas y minúsculas.

REMove

Especifica que el servidor intenta trasladar el volumen fuera de la biblioteca en la estación o los puertos de E/S que convenga. Este parámetro es opcional. Los valores posibles, en función del tipo de biblioteca, son YES, BULK y NO. La respuesta del servidor a cada una de estas opciones y los valores predeterminados se describen en las siguientes secciones.

Bibliotecas 349X: El valor predeterminado es BULK. La tabla siguiente muestra cómo responde el servidor en las bibliotecas 349X.

Tabla 1. Cómo responde el servidor en las bibliotecas 349X

REMOVE=YES	REMOVE=BULK	REMOVE=NO
El gestor de biblioteca 3494 expulsa el cartucho en la estación de E/S que convenga.	El gestor de biblioteca 3494 expulsa el cartucho en el recurso de salida de alta capacidad.	El gestor de bibliotecas 3494 no expulsa el volumen. El servidor deja el cartucho en la biblioteca en la categoría INSERT para que lo utilicen otras aplicaciones.

Bibliotecas SCSI: El valor predeterminado es BULK. La tabla siguiente muestra cómo responde el servidor en las bibliotecas SCSI.

Tabla 2. Cómo responde el servidor en las bibliotecas SCSI

Si una biblioteca...	Y REMOVE=YES, ...	Y REMOVE=BULK, ...	Y REMOVE=NO, ...
No tiene puertos de entrada/salida	El servidor deja el cartucho en su ranura actual en la biblioteca y especifica la dirección de la ranura en un mensaje. A continuación, el servidor le solicita que retire el cartucho de la ranura y que emita un mandato REPLY.	El servidor deja el cartucho en su ranura actual en la biblioteca y especifica la dirección de la ranura en un mensaje. El servidor no le solicita que retire el cartucho y no necesita un mandato REPLY.	El servidor deja el cartucho en su ranura actual en la biblioteca y especifica la dirección de la ranura en un mensaje. El servidor no le solicita que retire el cartucho y no necesita un mandato REPLY.
Tiene puertos de entrada/salida y un puerto de entrada/salida está disponible	El servidor mueve el cartucho al puerto de entrada/salida disponible y especifica la dirección del puerto en un mensaje. A continuación, el servidor le solicita que retire el cartucho de la ranura y que emita un mandato REPLY.	El servidor mueve el cartucho al puerto de entrada/salida disponible y especifica la dirección del puerto en un mensaje. El servidor no le solicita que retire el cartucho y no solicita un mandato REPLY.	El servidor deja el cartucho en su ranura actual en la biblioteca y especifica la dirección de la ranura en un mensaje. El servidor no le solicita que retire el cartucho y no necesita un mandato REPLY.
Tiene puertos de entrada/salida, pero no hay puertos disponibles.	El servidor deja el cartucho en su ranura actual en la biblioteca y especifica la dirección de la ranura en un mensaje. A continuación, el servidor le solicita que retire el cartucho de la ranura y que emita un mandato REPLY.	El servidor espera que un puerto de entrada/salida se haga disponible.	El servidor deja el cartucho en su ranura actual en la biblioteca y especifica la dirección de la ranura en un mensaje. El servidor no le solicita que retire el cartucho y no necesita un mandato REPLY.

Bibliotecas ACSLS: El valor predeterminado es YES. Si el parámetro se establece en YES, y el CAP tiene un valor de prioridad de selección automática de 0, se debe especificar un ID de CAP. La tabla siguiente muestra cómo responde el servidor en las bibliotecas ACSLS.

Tabla 3. Cómo responde el servidor en las bibliotecas ACSLS

REMOVE=YES o REMOVE=BULK	REMOVE=NO
El servidor expulsa el cartucho a la estación de E/S que convenga y elimina la entrada de volumen del inventario de bibliotecas del servidor.	El servidor no expulsa el cartucho. El servidor suprime del inventario de la biblioteca del servidor la entrada del volumen y deja el volumen en la biblioteca.

CHECKLabel

Especifica si el servidor lee las etiquetas de medios secuenciales de los volúmenes o cómo debe hacerlo.

Atención: Este parámetro no se aplica a las bibliotecas IBM® 349X o ACSLS.

Este parámetro es opcional. El valor predeterminado es YES. Los valores posibles son:

Yes

Especifica que el servidor intenta leer la etiqueta del medio para verificar que se está dando de baja el volumen correcto.

No

Especifica que durante la operación de dar de baja no se lee la etiqueta del medio. De este modo se mejora el rendimiento ya que no se produce el proceso de lectura.

FORCE

Especifica si el servidor extrae un volumen si se produce un error de entrada/salida (E/S) al leer la etiqueta.

Atención: Este parámetro no se aplica a las bibliotecas IBM 349X o ACSLS.

Este parámetro es opcional. El valor predeterminado es NO. Los valores posibles son:

No

El servidor no extrae un volumen de almacenamiento si se produce un error de E/S al leer la etiqueta.

Yes

El servidor extrae el volumen de almacenamiento, aunque haya un error de E/S.

CAP

Especifica qué puerto de acceso al cartucho (CAP) se debe utilizar para expulsar volúmenes si se especifica REMOVE=YES. Este parámetro solo se aplica a los volúmenes de las bibliotecas ACSLS. Si no existe en la biblioteca un valor de prioridad CAP superior a cero, este parámetro es obligatorio. Si existe en la biblioteca un valor de prioridad CAP superior a cero, este parámetro es opcional. De forma predeterminada, todos los CAP tienen inicialmente un valor de prioridad de 0, lo que significa que ACSLS no selecciona automáticamente el CAP.

Para que se visualicen identificadores CAP válidos (x,y,z), emita el mandato QUERY CAP especificando ALL desde la consola ACSSA (Automated Cartridge System System Administrator) del host del servidor ACSLS. Los identificadores son los siguientes:

x

El identificador de ACS (Automated Cartridge System). Este identificador puede ser un número dentro del rango de 0 a 126.

y

El identificador de LSM (Library Storage Module). Este identificador puede ser un número dentro del rango de 0 a 23.

z

El ID del CAP. Este identificador puede ser un número dentro del rango de 0 a 11.

Para obtener más información, consulte la documentación de StorageTek.

Mandatos relacionados