QUERY MEDIA (Analyse du support de pool de stockage à accès séquentiel)

Editer en ligne

Cette commande permet d'afficher les informations relatives aux volumes de pools de stockage principaux et de copie à accès séquentiel déplacés à l'aide de la commande MOVE MEDIA.

Classe de privilège

Tous les administrateurs disposant d'un privilège système ou opérateur peuvent exécuter cette commande, sauf si elle inclut le paramètre CMD. Si le paramètre CMD est spécifié et que l'option serveur REQSYSAUTHOUTFILE porte la valeur NO, l'administrateur doit disposer des privilèges opérateur, stockage illimité ou système. Si le paramètre CMD est défini et que l'option de serveur REQSYSAUTHOUTFILE porte la valeur YES (valeur par défaut), l'administrateur doit disposer des privilèges système.

La commande QUERY MEDIA affiche seulement les volumes dont la valeur d'ACCESS MODE est READONLY ou READWRITE.

Syntaxe

Paramètres

nom_volume

Indique le nom du volume de pool de stockage à accès séquentiel principal ou de copie à afficher. Ce paramètre est facultatif. Vous pouvez remplacer le nom par un caractère générique. Tous les volumes correspondants seront impliqués dans le traitement. Si vous ne renseignez pas ce paramètre, tous les volumes définis dans le pool de stockage spécifié par le paramètre STGPOOL seront affichés.

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 utiliser des caractères génériques pour indiquer un nom. Tous les pools de stockage correspondants seront traités. Si le pool de stockage désigné n'est pas géré par une bibliothèque automatique, aucun volume ne sera affiché.

Days

Spécifie le délai en jours devant s'écouler après l'écriture ou la lecture de ou vers le volume avant que l'on puisse traiter ce dernier. 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 du volume est utilisée pour calculer le nombre de jours écoulés.

WHERESTATUs

Permet d'indiquer que les résultats de la requête doivent être limités 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 aucune valeur n'est spécifiée pour ce paramètre, tous les volumes du pool de stockage spécifié (quel que soit leur état) sont affichés.

Les valeurs admises sont les suivantes :

FULl: Indique l'affichage des volumes dont l'état est FULL (plein).
FILling: Indique l'affichage des volumes dont l'état est FILLING (partiellement utilisé).
EMPty: Indique l'affichage des volumes dont l'état est EMPTY (vide).

WHEREACCess

Indique que les résultats doivent être limités au moyen du mode d'accès des volumes. Ce paramètre est facultatif. Si vous n'indiquez pas de valeur pour ce paramètre, la sortie est restreinte par le mode d'accès.

Les valeurs admises sont les suivantes :

READWrite: Indique l'affichage des volumes dont le mode d'accès est READWRITE.
READOnly: Indique l'affichage des volumes dont le mode d'accès est READONLY.

Format

Indique sous quelle forme les informations s'affichent. Ce paramètre est facultatif. La valeur par défaut est STANDARD. Les valeurs admises sont les suivantes :

Standard: Indique que les informations s'affichent partiellement pour les volumes de pool de stockage à accès séquentiel spécifiés.
Detailed: Indique que les informations s'affichent intégralement pour les volumes de pool de stockage à accès séquentiel spécifiés.
Cmd: Indique que les commandes exécutables sont élaborées pour les volumes de pool de stockage traités par la commande QUERY MEDIA. Ces commandes se trouvent dans le fichier spécifié par le paramètre CMDFILENAME, dans la commande QUERY MEDIA. Pour afficher les commandes uniquement sur la console, indiquez une chaîne vide ("") pour le paramètre CMDFILENAME. Si FORMAT=CMD est spécifié mais qu'aucune chaîne de commande n'est spécifiée dans le paramètre CMD, la commande QUERY MEDIA échoue.

WHEREState

Indique l'état des volumes à traiter. Ce paramètre permet de limiter le traitement aux volumes possédant l'état spécifié. Ce paramètre est facultatif. La valeur par défaut est Tous. Les valeurs admises sont les suivantes :

All: Indique que les volumes portant tous les états sont interrogés. Les états admis sont MOUNTABLEINLIB et MOUNTABLENOTINLIB.
MOUNTABLEInlib: Indique que les volumes portant actuellement l'état MOUNTABLEINLIB sont interrogés. Les volumes portant l'état MOUNTABLEINLIB se trouvent dans la bibliothèque et résident sur le site ; ils contiennent des données valides et peuvent être utilisés pour les traitements sur site.
MOUNTABLENotinlib: Indique que les volumes portant actuellement l'état MOUNTABLENOTINLIB sont interrogés. Les volumes portant l'état MOUNTABLENOTINLIB ne se trouvent pas dans la bibliothèque, ne contiennent pas de données valides et ne peuvent pas être utilisés pour les traitements sur site.

WHEREOVFLOcation

Indique l'emplacement des volumes à afficher. Ce paramètre est facultatif. Ce paramètre permet de limiter le traitement aux volumes situés à l'emplacement spécifié. La longueur maximale de l'emplacement est de 255 caractères. Cet emplacement doit être placé entre des guillemets s'il contient des espaces.

CMd

Permet d'indiquer la création de commandes exécutables. La spécification de commandes doit être placée entre guillemets. La longueur maximale de la spécification est de 255 caractères. Ce paramètre est facultatif.

Pour chaque volume traité avec succès par la commande QUERY MEDIA, le serveur écrit les commandes associées dans un fichier. Indiquez le nom de fichier avec le paramètre CMDFILENAME.

Systèmes d'exploitation Linux Systèmes d'exploitation AIX Si vous n'indiquez pas de nom de fichier, la commande génère un nom de fichier par défaut en ajoutant la chaîne exec.cmds.media au répertoire du serveur.

Systèmes d'exploitation Windows Si vous ne spécifiez pas de nom de fichier, la commande génère un nom de fichier par défaut en ajoutant la chaîne exec.cmd.media au répertoire du serveur.

Rappel :

Si la commande créée dans le fichier dépasse 255 caractères, elle est décomposée en plusieurs lignes et un caractère de suite (+) est ajouté à la fin de chaque ligne à l'exception de la dernière. Vous pouvez avoir besoin de modifier le caractère de continuation selon les exigences du produit qui exécute les commandes.
Si une commande exécutable est spécifiée avec une valeur de FORMAT autre que CMD, la chaîne de commande est ignorée et la commande QUERY MEDIA n'écrit aucune ligne de commande.

Indiquez une chaîne de commande et l'une des variables de substitution ci-dessous :

chaîne

Indique la chaîne nécessaire pour créer une commande exécutable afin de traiter le nom de volume ou l'emplacement de volume, ou encore les deux. La chaîne peut être constituée de tout texte à format libre. La chaîne ne doit pas comporter de guillemets incorporés. Voici un exemple de spécification de commande exécutable correcte :

cmd="checkin libvolume &vol"

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

cmd="checkin libvolume "&vol""

substitution

Indique une variable pour laquelle vous souhaitez que la commande QUERY MEDIA remplace une valeur. 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 perluète et VOL, la commande QUERY 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 perluète et LOC, la commande QUERY 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. Un exemple de nom de fichier de volume de bande de pool de stockage de copies utilisant le préfixe défini IBM Storage Protect310 est IBM Storage Protect310.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 le caractère d'une nouvelle ligne. Lorsque & NL est spécifié, la commande QUERY MEDIA divise 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, si un tel caractère est nécessaire. 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 à l'exception de la dernière.

CMDFilename

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

Systèmes d'exploitation Linux Systèmes d'exploitation AIX Si vous spécifiez "" avec le paramètre CMDFILENAME, la commande QUERY MEDIA génère un nom de fichier en ajoutant "exec.cmds.media" au répertoire du serveur. Le répertoire du serveur est le répertoire de travail en cours du processus serveur.

Systèmes d'exploitation Windows Si vous spécifiez "" avec le paramètre CMDFILENAME, la commande QUERY MEDIA génère un nom de fichier en ajoutant "exec.cmd.media" au répertoire du serveur. Le répertoire du serveur est le répertoire de travail en cours du processus serveur.

Si vous entrez une chaîne vide ("") pour CMDFILENAME, les commandes générées s'affichent uniquement sur la console. Vous pouvez réacheminer les commandes affichées vers un fichier à l'aide des caractères de redirection du système d'exploitation (> ou >>).

Systèmes d'exploitation Linux Systèmes d'exploitation AIX Si le nom de fichier n'est pas spécifié, la commande génère un nom de fichier par défaut en ajoutant la chaîne "exec.cmds.media" au répertoire du serveur.

Systèmes d'exploitation Windows Si le nom de fichier n'est pas spécifié, la commande génère un nom de fichier par défaut en ajoutant la chaîne "exec.cmd.media" au répertoire du serveur.

La commande QUERY MEDIA alloue automatiquement le nom de fichier spécifié ou généré. Si ce nom de fichier existe déjà, la commande QUERY MEDIA tente de l'utiliser et de remplacer les éventuelles données du fichier. Vous pouvez ajouter APPEND=YES pour empêcher que les données existantes soient remplacées. Si la commande QUERY MEDIA échoue après attribution du fichier de commandes, le fichier n'est pas supprimé.

APPend

Indique l'emplacement de l'opération d'écriture : au début ou à la fin des données du fichier de commandes. Ce paramètre est facultatif. 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.

Exemple : Affichage des informations relatives à un pool de stockage à accès séquentiel spécifique

Affichez tous les volumes pleins et partiellement pleins se trouvant dans le pool de stockage à accès séquentiel principal ARCHIVE. Pour obtenir une description des zones, voir Description des zones .

query media * stgpool=archive wherestatus=full, filling

 
Volume Name State                 Location              Automated
                                                        LibName
----------- -------------------   --------------------  -----------
TAPE01      Mountable in Library                        LIB3494
TAPE03      Mountable not in Lib. Room1234/Bldg31
TAPE07      Mountable in Library                        LIB3494
TAPE09      Mountable not in Lib. Room1234/Bldg31

Exemple : Affichage des informations relatives à un pool de stockage à accès séquentiel avec un préfixe spécifique

Affichez en détails tous les volumes pleins dont l'état est MOUNTABLENOTINLIB pour les pools de stockage à accès séquentiel dont le préfixe est ONSITE (sur site). Pour obtenir une description des zones, voir Description des zones .

query media wherestate=mountablenotinlib stgpool=onsite* 
wherestatus=full format=detailed

      Volume Name: TAPE21
                  State: Mountable not in library
          Volume Status: Full
                 Access: ReadOnly
    Last Reference Date: 01/30/98
  Last Update Date/Time: 08/20/1996 13:29:02
               Location: Rm569/bldg31
      Storage Pool Name: ONSITE.ARCHIVE
      Automated Libname:
 
            Volume Name: TAPE22
                  State: Mountable not in library
          Volume Status: Full
                 Access: ReadOnly
    Last Reference Date: 01/30/98
  Last Update Date/Time: 08/20/1996 15:29:02
               Location: Rm569/bldg31
      Storage Pool Name: ONSITE.ARCHIVEPOOL
      Automated Libname:

Exemple : Génération de commande CHECKIN

Générez les commandes CHECKIN LIBVOLUME pour les volumes pleins et partiellement pleins se trouvant dans le pool de stockage principal ONSITE.ARCHIVE et stockés dans l'emplacement de dépassement, Salle 2948/Bât31.

query media * stgpool=onsite.archive format=cmd
wherestatus=full,filling wherestate=mountablenotinlib
whereovflocation=room2948/bldg31 
cmd="checkin libvol lib3494 &vol status=private" 
cmdfilename=/tsm/move/media/checkin.vols

La commande QUERY MEDIA a créé les commandes exécutables CHECKIN LIBVOLUME dans /tsm/move/media/checkin.vols, qui peuvent être exécutées en émettant la commande MACRO avec /tsm/move/media/checkin.vols comme nom de macro.

checkin libvol lib3494 TAPE04 status=private
checkin libvol lib3494 TAPE13 status=private
checkin libvol lib3494 TAPE14 status=private

Description des champs

Nom de volume: Indique le nom du volume de pool de stockage à accès séquentiel principal.
Etat: Indique l'état du volume.
Statut du volume: Spécifie le statut du volume.
Accès: Indique le mode d'accès du volume.
Dernière date de référence: Indique la dernière date d'écriture ou de lecture sur le volume, selon la date la plus récente.
Date/heure de la dernière mise à jour: Indique la date et l'heure de la mise à jour du volume la plus récente.
Emplacement: Indique l'emplacement de stockage du volume. Si le volume est éjecté de la bibliothèque et que son emplacement n'est pas spécifié ou défini, un point d'interrogation (?) s'affiche pour l'emplacement.
Nom du pool de stockage: Indique le nom du pool de stockage à accès séquentiel dans lequel le volume est défini.
Nom de bibliothèque automatique: Indique le nom de bibliothèque automatique si le volume se trouve dans une bibliothèque.

Commandes associées

Tableau 1. Commandes associées à QUERY MEDIA
Commande	Description
MEDIA MOVE	Déplace les volumes de pool de stockage gérés par une bibliothèque automatisée.