QUERY RETSETCONTENTS (interroger le contenu d'un ensemble de conservation)

Utilisez cette commande pour afficher des informations sur les objets inclus dans un ou plusieurs ensembles de conservation. Des informations concernant les noeuds et les espaces fichiers sont affichés pour chaque objet contenu dans un ensemble de conservation. Vous pouvez filtrer la liste des objets affichés en spécifiant un ID d'ensemble de conservation ou des valeurs de filtrage portant sur des attributs des ensembles de conservation.

Classe de privilège

Tout administrateur peut émettre cette commande.

Syntaxe

Lire le diagramme de syntaxeIgnorer le diagramme de syntaxe graphiqueQuery RETSETContentsID_ensemble_test1NOdename=*NOdename=node_name FIlespace=,nom_espace_fichier2NAMEType=SERVERNAMEType=SERVERUNIcodeFSIDCODEType=BOTHCODEType=UNIcodeNONUNIcodeBOTH RETRulename=*RETRulename=nom_retraitCOUnt=number Format=StandardFormat=StandardDetailed
Remarques :
  • 1 Vous devez spécifier un ID d'ensemble de conservation, un nom de noeud ou un nom de règle de conservation.
  • 2 Le nom_espace_fichier doit correspondre à une machine virtuelle IBM Storage Protect for Virtual Environments . Si vous spécifiez un nom d'espace fichiers, vous ne pouvez indiquer qu'un seul nom de noeud entièrement qualifié. Au lieu de spécifier un nom d'espace fichiers, vous pouvez indiquer le nom de la machine virtuelle.

Paramètres

ID_ens_cons
Spécifie l'ID d'un ensemble de conservation dont on souhaite interroger le contenu. Il s'agit d'une valeur numérique unique. Ce paramètre est facultatif. Si vous spécifiez un ID d'ensemble de conservation, vous ne pouvez pas spécifier également l'option NODENAME ou RETRULENAME.
NOdename
Spécifie le noeud ou le groupe de noeuds auquel l'ensemble de conservation s'applique. Ce paramètre est facultatif. Vous pouvez utiliser des caractères génériques pour indiquer ce nom.
FIlespace
Spécifie le nom d'un ou de plusieurs espace fichier sur une machine virtuelle à interroger. Ce paramètre est facultatif. Le nom d'espace fichiers peut inclure des caractères génériques, à condition que les paramètres NAMETYPE et CODETYPE ne soient pas spécifiés. Pour spécifier un espace fichier contenant une virgule dans son nom, vous devez spécifier l'ID numérique de l'espace fichier, puis spécifier NAMETYPE=FSID. Par exemple, si le nom de l'espace fichiers est 71256,4, spécifiez 71256,4 nametype=fsid.
Astuce: Exécutez la commande QUERY FILESPACE pour déterminer quels espaces fichier et ID d'espace fichier sont définis pour un poste sur le serveur.
NAMEType
Spécifie comment le serveur doit interpréter les noms d'espace fichier que vous indiquez.

La valeur par défaut est SERVER. Si un nom de mappage d'espace fichier virtuel est indiqué, vous devez utiliser SERVER. Vous pouvez spécifier l'une des valeurs suivantes :

SERVER
Le serveur utilise sa page de codes pour interpréter le nom de l'espace fichier.
UNIcode
Le serveur convertit le nom d'espace fichiers entré depuis sa page de codes vers la page de codes UTF-8. La réussite de la conversion dépend des caractères figurant dans le nom et de la page de codes du serveur. La conversion peut échouer si la chaîne inclut des caractères qui ne sont pas disponibles dans cette page de codes ou si le serveur ne parvient pas à accéder aux routines de conversion du système.
FSID
Le serveur interprète le nom de l'espace fichier comme l'ID de l'espace fichier (FSID).
CODEType
Indique comment le serveur doit interpréter les noms d'espace fichier que vous spécifiez. La valeur par défaut est BOTH, qui signifie que les espaces fichier sont inclus quel que soit le type de page de codes. Utilisez ce paramètre uniquement si vous souhaitez entrer un caractère générique pour le nom d'espace fichiers. Vous pouvez spécifier l'une des valeurs suivantes :
UNIcode
Indique uniquement les espaces fichier au format Unicode.
NONUNIcode
Indique uniquement les espaces fichier non Unicode.
BOTH
Indique les espaces fichier, quel que soit le type de page de codes.
RETRulename
Spécifie le nom de la règle de conservation qui a déclenché la création de l'ensemble de conservation. Ce paramètre est facultatif. Si vous ne le spécifiez pas, le résultat de la requête inclura toutes les règles de conservation.
COUnt
Spécifie le nombre de fichiers à afficher dans les résultats de la requête. Ce paramètre est facultatif.
Format
Spécifie le mode d'affichage des informations. Ce paramètre est facultatif. La valeur par défaut est STANDARD. Vous pouvez spécifier l'une des valeurs suivantes :
Standard
Spécifie que des informations partielles s'affichent.
Detailed
Spécifie que les informations complètes s'affichent.

Exemple : afficher des informations sur le contenu d'un ensemble de conservation

Afficher des informations détaillées sur le contenu de l'ensemble de conservation 35. Pour obtenir une description des zones, voir Description des zones .
query retsetcontents 35

Retention     Node Name              Filespace      Client's Name for File  
Set ID                               Name
---------     ------------------     ----------     ------------------------------------------
35            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\CLIENT
35            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\EXCHANGE
35            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\SQL
35            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\E3SP1ENG\SETUP\I386\EX-
                                                     CHANGE\ADDRESS\GWISE\I386
35            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\E3SP1ENG\SETUP\I386\EX-
                                                     CHANGE\EXCHWEB\HELP\SPA\IE3\BASICS
35            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\E3SP1ENG\SETUP\I386\EX-
                                                     CHANGE\EXCHWEB\HELP\SPA\IE3\GIF
35            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\CLIENT\TSM533C.0-
                                                     216FA_EXPRESS_CLIENT_CD\DISK1\_JRE\BIN
35            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\CLIENT\TSM533C.0-
                                                     216FA_EXPRESS_CLIENT_CD\DISK1\_JRE\LIB
35            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\E3SP1ENG\SETUP\I386\EX-
                                                     CHANGE\EXCHWEB\HELP\SPA\IE5\BASICS
35            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\EXCHANGE\TSM533C-
                                                     .0213FA_EXPRESS_EXCHANGE_CD\TDPEXCHANGE\-
                                                     WIN32\CLIENT
35            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\EXCHANGE\TSM533C-
                                                     .0213FA_EXPRESS_EXCHANGE_CD\TDPEXCHANGE\-
                                                     WIN32\LANGUAGES
35            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\E3SP1ENG\SETUP\I386\EX-
                                                     CHANGE\EXCHWEB\HELP\ARA

Exemple : afficher des informations sur le contenu de tous les ensembles de conservation créés par une règle de conservation particulière

Afficher des informations détaillées sur le contenu de tous les ensembles de conservation qui ont été créés par la règle de conservation nommée MONTHLY. Pour obtenir une description des zones, voir Description des zones .
query retsetcontents retrulename=monthly


Retention     Node Name              Filespace      Client's Name for File
Set ID                               Name
---------     ------------------     ----------     ------------------------------------------
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\CLIENT
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\EXCHANGE
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\SQL
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\E3SP1ENG\SETUP\I386\EX-
                                                     CHANGE\ADDRESS\GWISE\I386
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\E3SP1ENG\SETUP\I386\EX-
                                                     CHANGE\EXCHWEB\HELP\SPA\IE3\BASICS
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\E3SP1ENG\SETUP\I386\EX-
                                                     CHANGE\EXCHWEB\HELP\SPA\IE3\GIF
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\CLIENT\TSM533C.0-
                                                     216FA_EXPRESS_CLIENT_CD\DISK1\_JRE\BIN
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\CLIENT\TSM533C.0-
                                                     216FA_EXPRESS_CLIENT_CD\DISK1\_JRE\LIB
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\E3SP1ENG\SETUP\I386\EX-
                                                     CHANGE\EXCHWEB\HELP\SPA\IE5\BASICS
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\EXCHANGE\TSM533C-
                                                     .0213FA_EXPRESS_EXCHANGE_CD\TDPEXCHANGE\-
                                                     WIN32\CLIENT
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\EXCHANGE\TSM533C-
                                                     .0213FA_EXPRESS_EXCHANGE_CD\TDPEXCHANGE\-
                                                     WIN32\LANGUAGES


Retention     Node Name              Filespace      Client's Name for File
Set ID                               Name
---------     ------------------     ----------     ------------------------------------------
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\CLIENT
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\EXCHANGE
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\SQL
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\E3SP1ENG\SETUP\I386\EX-
                                                     CHANGE\ADDRESS\GWISE\I386
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\E3SP1ENG\SETUP\I386\EX-
                                                     CHANGE\EXCHWEB\HELP\SPA\IE3\BASICS
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\E3SP1ENG\SETUP\I386\EX-
                                                     CHANGE\EXCHWEB\HELP\SPA\IE3\GIF
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\CLIENT\TSM533C.0-
                                                     216FA_EXPRESS_CLIENT_CD\DISK1\_JRE\BIN
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\CLIENT\TSM533C.0-
                                                     216FA_EXPRESS_CLIENT_CD\DISK1\_JRE\LIB
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\E3SP1ENG\SETUP\I386\EX-
                                                     CHANGE\EXCHWEB\HELP\SPA\IE5\BASICS
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.3.7\EXCHANGE\TSM533C-
                                                     .0213FA_EXPRESS_EXCHANGE_CD\TDPEXCHANGE\-
                                                     WIN32\CLIENT
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\5.
37            FILEMAN                \\lambo\k$     \TESTFILES\EXPRESS\E3SP1ENG\SETUP\I386\EX-
                                                     CHANGE\EXCHWEB\HELP\ARA

Description des champs

ID de l'ensemble de conservation
Numéro associé à l'ensemble de conservation.
Nom du noeud
Le nom du noeud associé à l'ensemble de conservation.
Nom d'espace fichier
Le nom de l'espace fichiers associé à l'ensemble de conservation.
Nom du client pour le fichier
Nom sous lequel les objets d'un ensemble de conservation sont connus du client.

Commandes associées

Tableau 1. Commandes associées à QUERY RETSETCONTENTS
Commande Description
SUPPRIMER RETSET Suppression d'un ensemble de conservation.
RETSET DE REQUETE Affichage d'informations sur les ensembles de conservation.
MISE A JOUR Change les attributs d'un ensemble de conservation.