AUDIT LIBRARY (Inventarios de volúmenes de auditoría en una biblioteca automatizada)

Utilice este mandato para auditar y sincronizar inventarios de volúmenes en una biblioteca automatizada.

Cuando se emite el mandato AUDIT LIBRARY en un cliente de biblioteca, el cliente sincroniza su inventario con el inventario del gestor de bibliotecas. Si el cliente de biblioteca detecta incongruencias, las corrige por medio de un cambio en la propiedad del volumen en el gestor de biblioteca.

Cuando se emite el mandato AUDIT LIBRARY en un servidor en el que la biblioteca es SCSI, 349X o ACSLS (LIBTYPE=SCSI, LIBTYPE=349X o LIBTYPE=ACSLS), el servidor sincroniza su inventario con el inventario del dispositivo de bibliotecas. Si el servidor detecta incoherencias, elimina los volúmenes ausentes de su inventario.

En las bibliotecas SCSI, el servidor actualiza también las ubicaciones de los volúmenes de su inventario que han sido trasladados desde la última auditoría.
En las bibliotecas 349X, el servidor garantiza también que los volúmenes reutilizables se encuentran en la categoría reutilizable y los volúmenes privados en la categoría privada.

Cuando se emite el mandato AUDIT LIBRARY en un servidor que es un gestor de bibliotecas de la biblioteca (SHARED=YES), el servidor actualiza la propiedad de sus volúmenes si detecta incoherencias.

Con independencia del servidor o del tipo de biblioteca, la emisión del mandato AUDIT LIBRARY no agrega automáticamente nuevos volúmenes a una biblioteca. Para agregar nuevos volúmenes, debe utilizar el mandato CHECKIN LIBVOLUME.

Atención:

La ejecución del AUDIT LIBRARY comando en determinadas condiciones puede provocar que se sobrescriban los volúmenes de cinta, lo que puede dar lugar a la pérdida de datos. Ten cuidado al ejecutar el AUDIT LIBRARY comando en un cliente de biblioteca o en una biblioteca que utilice ese tipo SHARED de biblioteca.
- Si ejecutas el AUDIT LIBRARY comando en un servidor o en un cliente de biblioteca que utiliza una biblioteca compartida (LIBTYPE=SHARED), es posible que los volúmenes de cinta con estado privado se actualicen incorrectamente o se reasignen como espacio temporal. Este problema puede producirse cuando el cliente de la biblioteca tiene varios gestores de bibliotecas y anteriormente se utilizó el UPDATE DEVCLASS comando para cambiar el nombre de la biblioteca. Tras esta actualización de la biblioteca, es posible que los volúmenes de cinta que utilizan la misma clase de dispositivo ya no existan en la nueva biblioteca. Como consecuencia, es posible que estos archivos se conviertan involuntariamente a scratch.
- Si ejecutas el AUDIT LIBRARY comando en un gestor de bibliotecas en un entorno de bibliotecas compartidas, el comando realiza una auditoría de la biblioteca de cintas para sincronizar el inventario de la biblioteca entre esta y el servidor.
- Si ejecutas el AUDIT LIBRARY comando en un cliente de la biblioteca en un entorno de bibliotecas compartidas, el comando revisa los volúmenes de cinta del grupo de almacenamiento asociado a la biblioteca de cintas. La auditoría sincroniza los volúmenes de cinta entre el cliente de la biblioteca y el grupo de almacenamiento.
Las siguientes precauciones son aplicables sólo a las bibliotecas SCSI, 349X y ACSLS (LIBTYPE=SCSI, LIBTYPE=349X y LIBTYPE=ACSLS):
- La ejecución del mandato AUDIT LIBRARY impide que tenga lugar cualquier otra actividad de biblioteca hasta que se ha completado la auditoría. Por ejemplo, el servidor no procesará, restaurará ni recuperará peticiones que impliquen a la biblioteca cuando esté ejecutándose el mandato AUDIT LIBRARY.
- Si está realizándose cualquier otra actividad en la biblioteca, no emita el mandato AUDIT LIBRARY. La emisión del mandato AUDIT LIBRARY cuando una biblioteca está activa puede producir resultados imprevisibles (por ejemplo, una condición de bloqueo) si un proceso que actualmente accede a la biblioteca intenta adquirir un nuevo montaje de cinta.

Este mandato crea un proceso en segundo plano que puede cancelar con el mandato CANCEL PROCESS . Para visualizar información sobre procesos en segundo plano, utilice el mandato QUERY PROCESS .

Clase de privilegio

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

Sintaxis

Parámetros

nombre_biblioteca (Obligatorio)

Especifica el nombre de la biblioteca que se ha de auditar.

CHECKLabel

Especifica cómo se comprueba la etiqueta del volumen de almacenamiento durante el proceso de auditoría. Este parámetro sólo se aplica a las bibliotecas SCSI. Este parámetro se pasa por alto en otros tipos de bibliotecas. El valor predeterminado es YES. Los valores posibles son:

Yes: Especifica que el servidor comprueba cada etiqueta de volumen para verificar la identidad del volumen.
Barcode: Especifica que el servidor utiliza el lector de códigos de barra para leer la etiqueta de almacenamiento. Al utilizar códigos de barras, el tiempo de proceso de la auditoría disminuye. Este parámetro solo se aplica a las bibliotecas SCSI.
Atención: Si el escáner no puede leer la etiqueta de código de barras o falta la etiqueta de código de barras, el servidor carga esa cinta en una unidad para leer la etiqueta.

REFRESHstate

Especifica si la información del servidor sobre una biblioteca, que normalmente se obtiene durante la inicialización, se renueva para que se reflejen los cambios en la configuración. Si se establece el parámetro REFRESHSTATE en Yes, esta acción se realiza sin necesidad de reiniciar el servidor o redefinir la biblioteca. El valor predeterminado es No. Los valores posibles son:

No: Especifica que el servidor no actualiza el estado de la biblioteca al auditar esta.
Yes: Especifica que el servidor no actualiza el estado de la biblioteca cuando se emite el mandato AUDIT LIBRARY.

ALLOWLIBClient

Especifica si la biblioteca de auditoría puede ejecutarse en un cliente de biblioteca o en una biblioteca con un tipo SHARED de biblioteca. Este parámetro solo se aplica a las bibliotecas del tipo SHARED «biblioteca».

Cuando el ALLOWLIBClient parámetro se establece en «Sí», la biblioteca de auditoría puede ejecutarse en un cliente de biblioteca para sincronizar los inventarios de volúmenes entre el cliente de biblioteca y el gestor de la biblioteca. En este caso, la operación de auditoría se ejecuta sobre la biblioteca con un tipo SHARED de biblioteca definido en el cliente de la biblioteca. El valor predeterminado es NO. Los valores posibles son:

No: Especifica que el servidor no audita una biblioteca con un tipo SHARED de biblioteca.
Yes: Especifica que el servidor realice la operación AUDIT LIBRARY en una biblioteca de tipo SHARED.

Ejemplo: auditar una biblioteca automatizada

Auditar la biblioteca automatizada EZLIFE.

audit library ezlife

Mandatos relacionados

Tabla 1. Mandatos relacionados con AUDIT LIBRARY
Mandato	Descripción
CANCELAR PROCESO	Cancela un proceso de servidor subordinado.
DEFINIR BIBLIOTECA	Define una biblioteca automatizada o manual.
ELIMINAR BIBLIOTECA	Suprime una biblioteca.
DESMONTAR VOLUMEN	Desmonta un volumen secuencial extraíble según el nombre de volumen.
BIBLIOTECA DE CONSULTAS	Visualiza información sobre una o más bibliotecas.
CONSULTA LIBVOLUME	Visualiza información sobre un volumen de biblioteca.
PROCESO DE CONSULTA	Muestra información sobre procesos subordinados.
ACTUALIZAR BIBLIOTECA	Cambia los atributos de una biblioteca.