CHECKIN LIBVOLUME (Insertion d'un volume de stockage dans une bibliothèque)

Classe de privilège

Pour exécuter cette commande, vous devez disposer du privilège système ou du privilège de stockage illimité.

Paramètres

nom_bibliothèque (obligatoire)

Désigne le nom de la bibliothèque.

nom_volume

Indique le nom du volume de stockage en cours d'insertion. Ce paramètre est obligatoire si SEARCH a la valeur NO. N'entrez pas ce paramètre si le paramètre SEARCH a la valeur YES, BULK ou ALL. Si vous insérez un volume dans une bibliothèque SCSI comportant plusieurs ports d'entrée-sortie, choisissez le volume qui se trouve à l'emplacement ayant le plus petit numéro.

STATus (obligatoire)

Indique le statut du volume. Les valeurs admises sont les suivantes :

PRIvate

Indique qu'il s'agit d'un volume privé, monté uniquement lorsqu'il est nommément désigné.

SCRatch

Indique qu'il s'agit d'un nouveau volume utilisable. Celui-ci peut être monté pour répondre aux demandes de montage de volumes utilisables, au cours des opérations de stockage de données ou d'exportation.

Si un volume a une entrée dans l'historique des volumes, vous ne pouvez pas l'insérer en tant que volume utilisable.

CLEaner

Indique que le volume est une cartouche de nettoyage et non pas une cartouche de données. Le paramètre CLEANINGS est requis pour une cartouche de nettoyage et doit être défini sur le nombre d'utilisations de la cartouche de nettoyage.

CHECKLABEL=YES n'est pas valide pour l'insertion d'une cartouche de nettoyage. Utilisez STATUS=CLEANER pour insérer une cartouche de nettoyage séparément d'une cartouche de données.

OWNer

Indique le client de bibliothèque détenant un volume privé dans une bibliothèque partagée via un réseau SAN. Le volume pour lequel vous spécifiez les droits de propriété doit être un volume privé. Il est impossible de définir des droits de propriété pour un volume utilisable. En outre, vous ne pouvez pas spécifier de propriétaire lorsque vous utilisez SEARCH=YES ou SEARCH=BULK.

Lorsque vous lancez la commande CHECKIN LIBVOLUME, le serveur valide le propriétaire. Si vous n'aviez pas spécifié ce paramètre, le serveur utilise la valeur par défaut et délègue les droits de propriété du volume au client de bibliothèque correspondant, comme l'indique le fichier historique des volumes sur le gestionnaire de bibliothèque. Si le volume n'appartient à aucun client de bibliothèque, le serveur délègue les droits de propriété au gestionnaire de bibliothèque.

SEARCH

Indique si le serveur doit rechercher les volumes qui n'ont pas été insérés dans la bibliothèque. Ce paramètre est facultatif. La valeur par défaut est NO.

Restrictions :

• Pour les bibliothèques SCSI, ne spécifiez pas à la fois CHECKLABEL=NO et l'un des paramètres suivants dans la même commande :
  • SEARCH=YES
  • SEARCH=BULK
  • SEARCH=ALL
• Si vous spécifiez SEARCH=NO, la bande doit être insérée dans le premier emplacement des ports d'entrée/sortie d'une bibliothèque SCSI. S'il n'y a pas de port d'entrée/exportation dans la bibliothèque, la bande doit être insérée dans le premier emplacement de stockage de la bibliothèque.
• Si vous spécifiez SEARCH=YES et que VOLRange est spécifié, tous les volumes doivent être de la même génération. VOLRange ne prend pas en charge les supports mixtes.

Les valeurs admises sont les suivantes :

No

Indique que seul le volume désigné est inséré dans la bibliothèque.

• Pour les bibliothèques SCSI, le serveur émet une demande d'insertion du volume dans un emplacement de cartouche de la bibliothèque ou, le cas échéant, dans un port d'entrée. Le port d’entrée ou l'emplacement de la cartouche est identifié par son adresse d'élément.
• Pour les bibliothèques 349X, il se peut que le volume se trouve déjà dans la bibliothèque, ou bien vous pouvez le placer dans le guichet d'entrée-sortie lorsque vous y êtes invité.

Yes

Indique que le serveur recherche les volumes à insérer dans la bibliothèque.

Conseils :

• Le paramètre VOLRANGE ou VOLLIST permet de limiter la recherche.
• Si la bibliothèque est partagée entre des applications, il se peut que le serveur examine un volume requis par une autre application. Dans le cas d'une bibliothèque 349X, le serveur interroge le gestionnaire de bibliothèque pour identifier tous les volumes attribués à la catégorie SCRATCH ou PRIVATE et à la catégorie INSERT.

Bulk

Indique que le serveur recherche sur les ports d'entrée-sortie de la bibliothèque les volumes pouvant être insérés automatiquement. Cette option concerne les bibliothèques SCSI uniquement.

Astuce: Vous pouvez utiliser le paramètre VOLRANGE ou VOLLIST pour limiter la recherche.

All

Indique que le serveur consulte tant les emplacements de stockage de la bibliothèque que les ports d'entrée-sortie de la bibliothèque à la recherche des volumes pouvant être insérés automatiquement. Cette option concerne les bibliothèques SCSI uniquement.

Conseils :

• Le paramètre VOLRANGE ou VOLLIST permet de limiter la recherche.
• Si la bibliothèque est partagée entre des applications, il se peut que le serveur examine un volume requis par une autre application. Dans le cas d'une bibliothèque 349X, le serveur interroge le gestionnaire de bibliothèque pour identifier tous les volumes attribués à la catégorie SCRATCH ou PRIVATE et à la catégorie INSERT.

VOLRange

Indique un ensemble de noms de volumes séparés par des virgules. Vous pouvez utiliser ce paramètre pour limiter la recherche des volumes à insérer lorsque vous spécifiez SEARCH=YES (bibliothèques 349X, ACSLS et SCSI), SEARCH=BULK (bibliothèques SCSI uniquement) ou SEARCH=ALL (bibliothèques SCSI uniquement). Si la bibliothèque ne contient aucun volume correspondant à la fourchette indiquée, la commande s'exécute sans problème.

Restriction : Si vous spécifiez SEARCH=YES et que VOLRange est spécifié, tous les volumes doivent être de la même génération. VOLRange ne prend pas en charge les supports mixtes.

Vous pouvez indiquer uniquement des noms de volume pouvant être incrémentés numériquement. Outre cette zone d'incrémentation, un nom peut se composer d'un préfixe et d'un suffixe alphanumériques, tels que :

Paramètre	Description
volrange=bar110,bar130	21 volumes sont insérés : bar110, bar111, bar112,...bar129, bar130.
volrange=bar11a,bar13a	3 volumes sont insérés : bar11a, bar12a, bar13a.
volrange=123400,123410	11 volumes sont insérés : 123400, 123401, ...123409, 123410.

VOLList

Désigne la liste de volumes. Vous pouvez utiliser ce paramètre pour limiter la recherche des volumes à insérer lorsque vous spécifiez SEARCH=YES (bibliothèques 349X, ACSLS et SCSI), SEARCH=BULK (bibliothèques SCSI uniquement) ou SEARCH=All (bibliothèques SCSI uniquement). Si la bibliothèque ne contient aucun volume figurant dans la liste, la commande s'exécute sans erreur.

Les valeurs admises sont les suivantes :

nom_volume

Indique un ou plusieurs noms de volumes qui sont séparés par des virgules et ne contiennent pas d'espaces. Par exemple : VOLLIST=TAPE01,TAPE02.

FILE: nom_fichier

Indique le nom du fichier contenant la liste des volumes devant être traités par la commande. Chaque nom de volume doit figurer sur une ligne séparée dans le fichier. Les lignes vides et les lignes de commentaire commençant par un astérisque sont ignorées. Par exemple, pour utiliser les volumes TAPE01, TAPE02 et TAPE03, créez un fichier nommé TAPEVOL contenant les lignes suivantes :

TAPE01
TAPE02
TAPE03

Vous pouvez spécifier les volumes pour la commande comme suit: VOLLIST=FILE:TAPEVOL.

Attention: le nom de fichier est sensible à la casse.

CHECKLabel

Indique si le serveur doit lire les labels de support séquentiel des volumes, et comment il doit effectuer cette opération. Ce paramètre est facultatif. La valeur par défaut est YES.

Les valeurs admises sont les suivantes :

Yes

Indique qu'une tentative de lecture du label est effectuée lors de l'insertion.

Attention :

1. Pour les bibliothèques SCSI, vous ne pouvez pas spécifier CHECKLABEL=NO, sauf si SEARCH a la valeur NO.
2. Pour les supports non réinscriptibles autres que 3592, vous devez indiquer YES.

No

Indique que le label de support n'est pas lu au cours de l'insertion. Toutefois, l'annulation de la vérification des labels peut entraîner des problèmes ultérieurs. Par exemple, un label incorrect ou un volume mal étiqueté peut générer une erreur. Pour les bibliothèques 349X et ACSLS, indiquez la valeur NO pour éviter de charger les cartouches dans une unité afin de lire le label du support. Ces bibliothèques renvoient toujours les informations d'étiquette externe sur les cartouches et IBM Storage Protect utilise ces informations.

Barcode

Indique que le serveur lit le label du code à barres si la bibliothèque dispose d'un lecteur et que les volumes ont reçu des labels de codes à barres externes. Les codes à barres permettent de réduire le délai d'insertion. Ce paramètre s'applique uniquement aux bibliothèques SCSI.

Si le lecteur de codes à barres ne parvient pas à lire un label ou si aucun label de code à barres n'a été attribué à une bande, le serveur monte la bande pour lire le label interne.

DEVType

Indique le type d'unité correspondant au volume en cours d'insertion. Ce paramètre est obligatoire si aucune des unités de la bibliothèque n'a de chemin défini.

3590

Indique que le type d'unité correspondant au volume en cours d'insertion est 3590.

3592

Indique que le type d'unité correspondant au volume en cours d'inserion est 3592.

SWAP

Indique si le serveur doit permuter les volumes lorsqu'aucun emplacement de bibliothèque n'est disponible. Le volume sélectionné pour l'opération de permutation (volume de permutation cible) est éjecté de la bibliothèque et remplacé par le volume en cours d'insertion. Le serveur identifie le volume de permutation cible en recherchant un volume utilisable disponible. S'il n'y en a aucun, il sélectionne le volume le moins fréquemment monté.

Ce paramètre est facultatif. La valeur par défaut est NO. Ce paramètre s'applique uniquement si un nom de volume est indiqué dans la commande. Les valeurs admises sont les suivantes :

No

Indique que le serveur doit insérer le volume uniquement si un emplacement vide est disponible.

Yes

Indique que le serveur doit permuter les cartouches pour insérer le volume si aucun emplacement vide n'est disponible.

WAITTime

Nombre de minutes pendant lequel le serveur attend votre réponse à une requête. Spécifiez une valeur dans la fourchette 0-9999. Si vous voulez que le serveur sollicite votre réponse, indiquez un délai supérieur à zéro. La valeur par défaut est fixée à 60 minutes. Par exemple, supposons que le serveur vous invite à insérer une bande dans le port d'entrée-sortie d'une bibliothèque. Si vous avez spécifié un délai d'attente de 60 minutes, le serveur lance une requête et vous laisse 60 minutes pour y répondre. Supposons, d'autre part, que vous spécifiez un temps d'attente de 0. Si vous avez inséré une bande, un délai d'attente de zéro entraîne la poursuite de l'opération sans invite. Si vous n'avez pas déjà inséré de bande, un délai d'attente de zéro entraîne l'échec de l'opération.

CLEanings

Entrez la valeur recommandée (généralement indiquée sur la cartouche) pour la cartouche de nettoyage. Ce paramètre ne s'applique qu'aux bibliothèques SCSI. Il est obligatoire si l'option STATUS=CLEANER est définie.

Lorsque plusieurs dispositifs de nettoyage sont insérés dans la bibliothèque, seul l'un d'entre eux est utilisé, jusqu'à ce que la valeur CLEANINGS qui lui est associée soit revenue à zéro. Un autre dispositif de nettoyage est alors sélectionné, tandis que le premier est retiré et supprimé.

Commandes associées