MOVE MEDIA (Déplacement du support de pool de stockage à accès séquentiel)

Classe de privilège

Paramètres

nom_volume (obligatoire)

Indique le nom du volume de pool de stockage à accès séquentiel principal ou secondaire (copie) à traiter. Vous pouvez remplacer le nom par un caractère générique. Tous les volumes correspondants seront impliqués dans le traitement.

STGpool (obligatoire)

Indique le nom du pool de stockage à accès séquentiel principal ou secondaire (copie) à utiliser pour sélectionner les volumes à traiter. Vous pouvez remplacer le nom par un caractère générique. Tous les pools de stockage correspondants seront traités. Si le pool de stockage désigné n'est pas géré par une bandothèque automatique, aucun volume ne sera traité.

Days

Indique le nombre de jours devant s'écouler après que le volume est écrit ou lu, avant que celui-ci puisse être traité par la commande. Ce paramètre est facultatif. Vous pouvez indiquer une valeur comprise entre 0 et 9999. La valeur par défaut est 0. La plus récente des dates de dernière écriture ou de dernière lecture des volumes est utilisée pour calculer le nombre de jours écoulés.

WHERESTate

Permet d'indiquer l'état en cours des volumes à traiter. Ce paramètre permet de limiter le traitement aux volumes ayant l'état indiqué. Ce paramètre est facultatif. La valeur par défaut est MOUNTABLEINLIB.

Les valeurs admises sont les suivantes :

MOUNTABLEInlib

Indique que les volumes de pool de stockage vont passer de l'état MOUNTABLEINLIB à l'état MOUNTABLENOTINLIB. Les volumes ayant l'état MOUNTABLEINLIB contiennent des données valides et se trouvent dans la bandothèque.

MOUNTABLENotinlib

Indique que les volumes de pools de stockage vont repasser de l'état MOUNTABLENOTINLIB à l'état MOUNTABLEINLIB. Les volumes ayant l'état MOUNTABLENOTINLIB peuvent contenir des données valides et se trouvent dans l'emplacement pour dépassement de capacité.

• Pour les volumes utilisables vides, la commande MOVE MEDIA supprime les enregistrements de volume afin qu'ils puissent être réutilisés.
• Pour les volumes privés, la commande MOVE MEDIA réinitialise l'emplacement des volumes, fait passer les volumes à l'état CHECKIN et remplace la date de dernière mise à jour par la date actuelle.
• Pour les volumes utilisables avec données, la commande MOVE MEDIA réinitialise l'emplacement des volumes, fait passer les volumes à l'état CHECKIN et remplace la date de dernière mise à jour par la date actuelle.

Attention: Les volumes avec l'état CHECKIN peuvent contenir des données valides et doivent être restitués dans la bandothèque.

WHERESTATUs

Permet d'indiquer que le processus de déplacement est limité par le statut des volumes. Ce paramètre est facultatif. Vous pouvez indiquer plusieurs états. Ils doivent être séparés par une virgule, sans espace intermédiaire. Si vous n'indiquez aucune valeur pour ce paramètre, les volumes dont l'état est passé de MOUNTABLEINLIB à MOUNTABLENOTINLIB sont limités aux volumes pleins (FULL) uniquement, et les volumes dont l'état est passé de MOUNTABLENOTINLIB à MOUNTABLEINLIB sont limités aux volumes vides (EMPTY) uniquement.

Les valeurs admises sont les suivantes :

FULl

Déplace les volumes dont le statut est FULL (saturé).

FILling

Déplace les volumes dont le statut est FILLING (en cours de remplissage).

EMPty

Déplace les volumes dont le statut est EMPTY (vide).

ACCess

Permet d'indiquer la façon dont les utilisateurs et les processus système accèdent aux fichiers du volume de pool de stockage déplacé d'une bandothèque automatique et stocké dans un emplacement de dépassement par la commande MOVE MEDIA. Ce paramètre est facultatif. Si vous n'indiquez aucune valeur pour ce paramètre, le déplacement des volumes de l'état MOUNTABLEINLIB vers le processus MOUNTABLENOTINLIB implique un mode d'accès au volume de type READONLY, tandis que le déplacement des volumes de l'état MOUNTABLENOTINLIB vers le processus MOUNTABLEINLIB implique un mode d'accès au volume de type READWRITE.

Les valeurs admises sont les suivantes :

READWrite

Indique que les utilisateurs et les processus système peuvent accéder aux fichiers du volume stocké dans l'emplacement de dépassement en lecture et en écriture. Si cette valeur est spécifiée, IBM Storage Protect demande que le volume soit restitué dans la bibliothèque lorsque le volume est nécessaire pour une opération de lecture ou d'écriture.

READOnly

Indique que les utilisateurs et les processus système peuvent accéder aux fichiers du volume stocké dans l'emplacement de dépassement en lecture mais pas en écriture. Le serveur demande que le volume soit inséré dans la bandothèque uniquement lorsque celui-ci est nécessaire pour une opération de lecture.

OVFLOcation

Indique l'emplacement pour dépassement de capacité qui constitue la destination des volumes en cours de traitement. Le nom d'emplacement ne doit pas dépasser 255 caractères. Ce nom doit être placé entre des guillemets s'il contient des espaces. Si vous n'indiquez aucun emplacement de dépassement et que le pool de stockage n'en a identifié aucun, le serveur remplace l'emplacement du volume exclu par une chaîne vide ("").

REMove

Spécifie que le serveur tente d'extraire le volume de la bibliothèque et de le placer dans le guichet d'entrée-sortie en libre service ou les guichets d'entrée-sortie. Ce paramètre est facultatif. Les valeurs possibles sont YES, BULK et NO. La valeur par défaut est BULK. La réponse du serveur à chacune de ces options et les valeurs par défaut sont décrites dans les tables suivantes.

Bibliothèques 349X : La table suivante indique comment le serveur répond pour les bibliothèques 349X.

Tableau 1. Comment le serveur répond pour les bibliothèques 349X

REMOVE=YES	REMOVE=BULK	REMOVE=NO
Le gestionnaire de bibliothèque 3494 dirige la cartouche vers le guichet d'entrée-sortie en libre service.	Le gestionnaire de bibliothèque 3494 dirige la cartouche vers l'utilitaire d'extraction à haute capacité.	Le gestionnaire de bibliothèque 3494 n'éjecte pas le volume. Le serveur laisse la cartouche dans la catégorie INSERT de la bibliothèque, à l'usage des autres applications.

Bibliothèques SCSI : Le tableau suivant indique comment le serveur répond à YES, BULK et NO pour les bibliothèques SCSI.

Tableau 2. Comment le serveur répond pour les bibliothèques SCSI

Si une bibliothèque...	et REMOVE=YES...	et REMOVE=BULK...	et REMOVE=NO
Ne comporte pas de ports d'E-S	Le serveur laisse la cartouche dans l'emplacement actuel et spécifie l'adresse correspondante dans un message. Le serveur vous invite à retirer la cartouche d'une fente d'insertion et à exécuter la commande REPLY.	Le serveur laisse la cartouche dans l'emplacement actuel et spécifie l'adresse correspondante dans un message. Le serveur ne vous invite ni à retirer la cartouche ni à exécuter la commande REPLY.	Le serveur laisse la cartouche dans l'emplacement actuel et spécifie l'adresse correspondante dans un message. Le serveur ne vous invite ni à retirer la cartouche ni à exécuter la commande REPLY commande .
Comporte des ports d'E-S et l'un d'entre eux est disponible	Le serveur transfère la cartouche dans le guichet d'entrée-sortie disponible et spécifie l'adresse du guichet dans un message. Le serveur vous invite à retirer la cartouche d'une fente d'insertion et à exécuter la commande REPLY.	Le serveur transfère la cartouche dans le guichet d'entrée-sortie disponible et spécifie l'adresse du guichet dans un message. Le serveur ne vous invite ni à retirer la cartouche ni à exécuter la commande REPLY.	Le serveur laisse la cartouche dans l'emplacement actuel et spécifie l'adresse correspondante dans un message. Le serveur ne vous invite ni à retirer la cartouche ni à exécuter la commande REPLY.
Comporte des ports d'E-S, mais aucun port n'est disponible	Le serveur laisse la cartouche dans l'emplacement actuel et spécifie l'adresse correspondante dans un message. Le serveur vous invite à retirer la cartouche d'une fente d'insertion et à exécuter la commande REPLY.	Le serveur attend qu'un port d'entrée-sortie soit disponible.	Le serveur laisse la cartouche dans l'emplacement actuel et spécifie l'adresse correspondante dans un message. Le serveur ne vous invite ni à retirer la cartouche ni à exécuter la commande REPLY.

Bibliothèques ACSLS : le tableau suivant montre comment le serveur répond pour les bibliothèques ACSLS.

Tableau 3. Comment le serveur répond pour les bibliothèques ACSLS

REMOVE=YES ou REMOVE=BULK	REMOVE=NO
Le serveur dirige la cartouche vers le guichet d'entrée-sortie en libre service. Le serveur supprime ensuite le volume de l'inventaire de la bibliothèque. Lorsque vous supprimez l'état MOUNTABLE affecté aux volumes en spécifiant REMOVE=YES, la commande MOVE MEDIA utilise plusieurs emplacements dans le CAP (port d'accès aux cartouches) d'une bibliothèque ACSLS de type StorageTek.	Le serveur n'éjecte pas la cartouche. Le serveur supprime l'entrée de volume de l'inventaire de bibliothèque et laisse le volume dans la bibliothèque.

Bibliothèques externes : le tableau suivant montre comment le serveur répond pour les bibliothèques externes.

Tableau 4. Comment le serveur répond pour les bibliothèques externes

REMOVE=YES ou REMOVE=BULK	REMOVE=NO
Le serveur dirige la cartouche vers le guichet d'entrée-sortie en libre service. Le serveur supprime ensuite le volume de l'inventaire de la bibliothèque.	Le serveur n'éjecte pas la cartouche. Le serveur supprime l'entrée de volume de l'inventaire de bibliothèque et laisse le volume dans la bibliothèque.

CMd

Permet d'indiquer la création de commandes exécutables. Ce paramètre est facultatif. La spécification de commandes doit être placée entre guillemets. La longueur maximale de la spécification est de 255 caractères. Pour chaque volume traité avec succès par la commande MOVE MEDIA, le serveur écrit les commandes associées dans un fichier. Indiquez le nom de fichier avec le paramètre CMDFILENAME.

Si vous ne spécifiez pas le nom de fichier, la commande MOVE MEDIA génère un nom de fichier par défaut en ajoutant la chaîne exec.cmds.media au répertoire du serveur IBM Storage Protect .

Si vous ne spécifiez pas le nom de fichier, la commande MOVE MEDIA génère un nom de fichier par défaut en ajoutant la chaîne exec.cmd.media au répertoire du serveur IBM Storage Protect .

Si la longueur de la commande écrite dans le fichier dépasse 255 caractères, elle est décomposée en plusieurs lignes et un caractère de continuation, +, est ajouté à chaque ligne de commande à l'exception de la dernière. Vous devez modifier le caractère de continuation selon les exigences du produit qui exécute les commandes.

Si vous ne spécifiez pas CMD, la commande MOVE MEDIA risque de ne pas générer de commandes exécutables.

chaîne

Indique la chaîne nécessaire pour créer une commande exécutable. La chaîne peut être constituée de tout texte à format libre. L'intégralité de la chaîne doit être placée entre guillemets. Voici un exemple de spécification de commande exécutable correcte :

        CMD="UPDATE VOLUME &VOL"

Voici un exemple de spécification de commande exécutable incorrecte :

        CMD=""UPDATE VOLUME" &VOL"

substitution

Indique une variable à laquelle une valeur sera substituée par la commande. Les valeurs de substitution admises sont les suivantes :

&VOL

Remplace &VOL par le nom du volume. Vous pouvez spécifier des caractères minuscules, &vol. Aucun espace ou blanc n'est autorisé entre la perluète, &, et VOL. Si des espaces ou des blancs sont présents entre les symboles perluette et VOL, la commande MOVE MEDIA les traite comme des chaînes et aucune substitution n'est effectuée. Si &VOL n'est pas spécifié, aucun nom de volume n'est défini dans la commande exécutable.

&LOC

Remplace &LOC par l'emplacement du volume. Vous pouvez spécifier des caractères minuscules, &loc. Aucun espace ou caractère blanc n'est admis entre le symbole perluète, &, et LOC. Si des espaces ou des blancs sont présents entre les symboles perluette et LOC, la commande MOVE MEDIA les traite comme des chaînes et aucune substitution n'est effectuée. Si &LOC n'est pas spécifié, aucun nom d'emplacement n'est défini dans la commande exécutable.

&VOLDSN

Remplace &VOLDSN par le nom du volume. Exemple de nom de fichier pour un volume de bande de pool de stockage, utilisant le préfixe par défaut ADSM : ADSM.BFS. Si &VOLDSN n'est pas spécifié, aucun nom de fichier de volume n'est défini dans la commande exécutable.

&NL

Remplace &NL par un caractère de nouvelle ligne. Lorsque & NL est spécifié, la commande MOVE MEDIA fractionne la commande à l'emplacement où se trouve & NL et n'ajoute aucun caractère de continuation. C'est à l'utilisateur d'indiquer le caractère de suite approprié avant &NL, le cas échéant. L'utilisateur est également responsable de la longueur de la ligne écrite. Si &NL n'est pas spécifié et que la longueur de la ligne de commande dépasse 255 caractères, celle-ci est décomposée en plusieurs lignes et un caractère de suite (+) est ajouté à la fin de chaque ligne de commande sauf pour la dernière ligne.

CMDFilename

Permet d'indiquer le nom de chemin absolu d'un fichier contenant les commandes spécifiées avec le paramètre CMD. Ce paramètre est facultatif. La longueur maximale du nom de fichier est de 1279 caractères.

Si vous ne spécifiez pas de nom de fichier, la commande MOVE MEDIA génère un nom de fichier par défaut en ajoutant la chaîne exec.cmds.media au répertoire du serveur IBM Storage Protect . Le répertoire du serveur est le répertoire de travail en cours du processus serveur IBM Storage Protect .

Si vous n'indiquez pas de nom de fichier, la commande MOVE MEDIA génère un nom de fichier par défaut en ajoutant la chaîne exec.cmd.media au répertoire du serveur IBM Storage Protect . Le répertoire du serveur est le répertoire de travail en cours du processus serveur IBM Storage Protect .

La commande MOVE MEDIA attribue automatiquement le nom de fichier spécifié ou généré. Si le nom de fichier existe, vous pouvez utiliser le paramètre APPEND=YES pour effectuer un ajout au fichier. Sinon, le fichier est écrasé. Si un fichier contenant des commandes que vous devez exécuter est écrasé par erreur, exécutez la commande QUERY MEDIA pour régénérer les commandes exécutables pour les volumes souhaités. Si la commande MOVE MEDIA échoue après l'allocation du fichier de commandes, le fichier n'est pas supprimé.

APPend

Permet d'indiquer l'emplacement de l'opération d'écriture : au début ou à la fin des données du fichier de commandes. La valeur par défaut est NO. Les valeurs admises sont les suivantes :

No

Indique d'écrire les données au début du fichier de commandes. Si le fichier de commandes indiqué existe, son contenu est écrasé.

Yes

Indique de faire un ajout au fichier de commandes en écrivant les données à la fin du fichier.

CHECKLabel

Permet d'indiquer si le serveur doit lire les labels de volume pour les supports séquentiels. Pour les unités SCSI, vous pouvez supprimer la vérification du label en définissant CHECKLabel sur NO. Ce paramètre n'est pas applicable aux bibliothèques 349X. Ce paramètre est facultatif. La valeur par défaut est YES. Les valeurs admises sont les suivantes :

Yes

Indique que le serveur tente de lire le label du support. La lecture du label de support permet de s'assurer que le volume concerné par l'opération est bien celui souhaité.

No

Indique que le serveur ne tente pas de lire le label du support. Cette option permet d'accroître les performance car le processus de lecture n'a pas lieu.

CAP

Indique le port d'accès aux cartouches (CAP) vers lequel les volumes doivent être dirigés si vous avez choisi REMOVE=YES. Ce paramètre ne s'applique qu'aux volumes de bibliothèques ACSLS. Si la valeur de priorité du point d'accès à la cartouche est 0 dans la bibliothèque, ce paramètre est obligatoire. Si une valeur de priorité du point d'accès à la cartouche supérieure à 0 est définie dans la bibliothèque, ce paramètre est facultatif. Par défaut, tous les points d'accès à la cartouche possèdent initialement la valeur de priorité 0, ce qui signifie que le serveur ACSLS ne sélectionne pas automatiquement le point d'accès à la cartouche.

Pour afficher des identificateurs de ports d'accès aux cartouches (CAP ou Cartridge Access Port) autorisés (x,y,z), exécutez la commande QUERY CAP avec ALL à partir de la console ACSSA (Automated Cartridge System System Administrator), sur l'hôte du serveur ACSLS. Les identificateurs possibles sont les suivants :

x

ID ACS (Automated Cartridge System). Cet identificateur peut être un nombre entre 0 et 126.

o

ID LSM (Library Storage Module). Cet identificateur peut être un nombre entre 0 et 23.

z

ID CAP. Cet identificateur peut être un nombre entre 0 et 11.

Pour plus d'informations, voir la documentation StorageTek.

Commandes associées