RSTPFRCOL

La commande Restaurer une collecte des performances (RSTPFRCOL) restaure dans le système une collecte des performances, ou un groupe de collectes des performances d'une même bibliothèque, qui a été sauvegardée dans un fichier de sauvegarde avec la commande Sauvegarder une collecte des performances (SAVPFRCOL). The Restore Performance Collection (RSTPFRCOL) command restores to the system a performance collection or a group of performance collections in a single library that were saved in a save file with the Save Performance Collection (SAVPFRCOL) command.

Restrictions:

• Cette commande est livrée sans droit public (*EXCLUDE). This command is shipped with no public authority (*EXCLUDE).
• Vous devez posséder les droits d'ajout (*ADD) et d'exécution (*EXECUTE) sur la bibliothèque indiquée et sur la bibliothèque du fichier de sauvegarde. You must have add (*ADD) and execute (*EXECUTE) authorities for the specified library and save file library.

Paramètres

Collecte (COL)Collection (COL)

Indique les noms d'une ou plusieurs collectes des performances à restaurer. Specifies the names of one or more performance collections to restore.

Si le fichier de sauvegarde ne contient pas toutes les collectes des performances que vous indiquez, des messages de diagnostic sont émis pour les collectes des performances introuvables. Le message de fin contiendra le nombre de collectes des performances restaurées et de collectes des performances non restaurées. If the save file does not contain all of the performance collections you specify, diagnostic messages will be issued for the performance collections not found. The completion message will contain a count of performance collections restored and performance collections not restored.

Si le paramètre Type de collecte (COLTYPE) n'est pas indiqué lors de l'exécution de la commande, tous les types de collecte énumérés dans la description de ce paramètre sont restaurés, s'ils se trouvent dans la bibliothèque indiquée du fichier de sauvegarde et s'ils portent les noms indiqués. If the Collection type (COLTYPE) parameter is not specified when the command is run, all the collection types listed in the description of that parameter are restored, if they are in the specified library on the save file, and if they have the specified names.

Ce paramètre est obligatoire. This is a required parameter.

Valeurs uniques

*ALL

Toutes les collectes des performances sauvegardées à partir de la bibliothèque indiquée sont restaurées, en fonction des valeurs indiquées pour les paramètres Type de collecte (COLTYPE) et Option (OPTION). All the performance collections saved from the specified library are restored, depending on the values specified for the Collection type (COLTYPE) and Option (OPTION) parameters.

Autres valeurs (jusqu'à 300 répétitions)

nom-générique

Indiquez un ou plusieurs noms génériques de groupes de collectes des performances de la bibliothèque indiquée à restaurer. Un nom générique est une chaîne de caractères composée d'un ou plusieurs caractères suivis d'un astérisque (*). Si le nom ne comporte pas d'astérisque, le système le considère comme le nom complet d'une collecte des performances. Specify one or more generic names of groups of performance collections in the specified library to restore. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an asterisk is not specified with the name, the system assumes that the name is a complete performance collection name.

nom

Indiquez un ou plusieurs noms de collectes des performances précises à restaurer. Des noms génériques et des noms précis peuvent être indiqués dans la même commande. Specify one or more names of specific performance collections to restore. Both generic names and specific names can be specified in the same command.

Biblio des objets sauvegardés (SAVLIB)

Indique la bibliothèque qui contenait les collectes des performances sauvegardées. Si *SAVLIB est indiqué ou pris par défaut pour le paramètre Bibliothèque de restauration (RSTLIB), il s'agit également du nom de la bibliothèque dans laquelle les collectes des performances sont restaurées. Specifies the library that contained the saved performance collections. If *SAVLIB is specified or defaulted for the Bibliothèque de restauration (RSTLIB) parameter, this is also the name of the library to which the performance collections are restored.

QPFRDATA

Les collectes des performances sauvegardées se trouvaient dans la bibliothèque de performances fournie par IBM, QPFRDATA. The saved performance collections were located in the IBM-supplied performance library, QPFRDATA.

nom

Indiquez le nom de la bibliothèque à restaurer. Le nom de la bibliothèque restaurée doit être identique à celui utilisé lors de la sauvegarde de la bibliothèque. Specify the name of the library to restore. The name of the library being restored must be the same as the name that was used when the library was saved.

*ANY

Restaure les collectes des performances à partir de la bibliothèque sauvegardée. Restores performance collections from the saved library.

Type de collecte (COLTYPE)Collection type (COLTYPE)

Indique le type de collectes à restaurer. Specifies the type of collections to be restored.

Valeurs uniques

*ALL

Tous les types de collectes des performances portant le même nom que celui indiqué dans le paramètre Collection (COL) doivent être restaurés. Cela comprend les collectes basées sur des fichiers et les collectes basées sur des objets. All types of performance collections with the same name as the one located in the Collection (COL) parameter are to be restored. This includes file-based collections and object-based collections.

Autres valeurs (jusqu'à 10 répétitions)

*CSFILE

Seules les collectes Collection Services basées sur des fichiers indiquées dans le paramètre Collection (COL) doivent être restaurées. Only the Collection Services file-based collections specified in the Collection (COL) parameter are to be restored.

*CSMGTCOL

Seules les collectes Collection Services basées sur des objets indiquées dans le paramètre Collection (COL) doivent être restaurées. Only the Collection Services object-based collections specified in the Collection (COL) parameter are to be restored.

*DWFILE

Seules les collectes Disk Watcher basées sur des fichiers indiquées dans le paramètre Collection (COL) doivent être restaurées. Only the Disk Watcher file-based collections specified in the Collection (COL) parameter are to be restored.

*JWFILE

Seules les collectes Job Watcher basées sur des fichiers indiquées dans le paramètre Collection (COL) doivent être restaurées. Only the Job Watcher file-based collections specified in the Collection (COL) parameter are to be restored.

*PEXFILE

Seules les collectes Performance Explorer basées sur des fichiers indiquées dans le paramètre Collection (COL) doivent être restaurées. Only the Performance Explorer file-based collections specified in the Collection (COL) parameter are to be restored.

*PEXMGTCOL

Seules les collectes Performance Explorer basées sur des objets indiquées dans le paramètre Collection (COL) doivent être restaurées. Only the Performance Explorer object-based collections specified in the Collection (COL) parameter are to be restored.

*BCHFILE

Seules les collectes Batch Model basées sur des fichiers indiquées dans le paramètre Collection (COL) doivent être restaurées. Only the Batch Model file-based collections specified in the Collection (COL) parameter are to be restored.

*HSTFILE

Seules les collectes historiques basées sur des fichiers indiquées dans le paramètre Collection (COL) doivent être restaurées. Only the Historical file-based collections specified in the Collection (COL) parameter are to be restored.

type

Specify the type of collections to be restored.

Les valeurs valides dépendent des collectes des performances prises en charge par le système. Vous pouvez appuyer sur F4 lors de l'invite de ce paramètre de commande pour afficher une liste des valeurs de type de collecte valides. Valid values depend on the performance collections supported by the system. You can press F4 while prompting this command parameter to see a list of valid collection type values.

Fichier sauvegarde (SAVF)

Indique le fichier de sauvegarde utilisé pour restaurer les collectes des performances. Ce paramètre est obligatoire. Specifies the save file used to restore the performance collections. This is a required parameter.

Qualificatif 1 : Fichier sauvegarde Qualificatif 1: Fichier sauvegarde

nom

Indiquez le nom du fichier de sauvegarde à utiliser. Specify the name of save file to be used.

Qualificatif 2: Biblio

*LIBL

Toutes les bibliothèques de la liste de bibliothèques de l'unité d'exécution en cours sont recherchées jusqu'à ce que la première occurrence soit trouvée. All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB

La bibliothèque en cours de l'unité d'exécution est utilisée pour localiser le fichier de sauvegarde. Si la liste de bibliothèques ne comporte aucune entrée de bibliothèque en cours, la bibliothèque QGPL est utilisée. The current library for the thread is used to locate the save file. If no current library entry exists in the library list, the QGPL library is used.

nom

Indiquez le nom de la bibliothèque dans laquelle se trouve le fichier de sauvegarde. Specify the name of the library where the save file is located.

Bibliothèque de restauration (RSTLIB)

Indique si les collectes des performances sont restaurées dans une bibliothèque différente ou dans la bibliothèque où elles ont été sauvegardées. Specifies whether the performance collections are restored to a different library or to the same library where they were saved.

*SAVLIB

Les collectes des performances sont restaurées dans la bibliothèque à partir de laquelle elles ont été sauvegardées. The performance collections are restored to the same library from which they were saved.

nom

Indiquez le nom de la bibliothèque dans laquelle les collectes des performances sauvegardées sont restaurées. Specify the name of the library to which the saved performance collections are restored.

Unité ASP de restauration (RSTASPDEV)

Indique l'unité ASP (pool de mémoire secondaire) vers laquelle les données sont restaurées.

Remarque :Vous pouvez spécifier le paramètre RSTASPDEV ou RSTASP, mais pas les deux.

*SAVASPDEV

Les données sont restaurées vers le même ASP où elles ont été sauvegardées.

nom

Indiquez le nom de l'unité ASP à utiliser.

Numéro d'ASP de restauration (RSTASP)

Indique si les objets sont restaurés dans le pool de mémoire secondaire (ASP) à partir duquel ils ont été sauvegardés, dans l'ASP système (ASP 1) ou dans un ASP utilisateur de base (ASP 2 à 32).

Certains objets ne peuvent pas être restaurés dans des ASP utilisateur. Le manuel Reprise du système, SC41-5304, contient de plus amples informations sur les types d'objets pouvant être restaurés dans les ASP utilisateur. Si la bibliothèque existe dans l'ASP système ou y est restaurée, les journaux, les récepteurs de journal et les fichiers sauvegarde pourront être restaurés dans les ASP utilisateur de base. En revanche, tous les autres types d'objets seront restaurés dans l'ASP de la bibliothèque.

ATTENTION : Les bibliothèques système ou de logiciel (dont le nom commence par Q ou #) ne doivent pas être créées ni restaurées dans un ASP utilisateurs. Une telle opération pourrait générer des résultats imprévisibles.

*SAVASP

Les objets sont restaurés dans l'ASP à partir duquel ils ont été sauvegardés.

1-32

Indique le numéro de l'ASP. Lorsque l'ASP 1 est indiqué, les objets précisés sont restaurés dans l'ASP système. Lorsque les ASP 2 à 32 sont indiqués, les objets sont restaurés dans l'ASP utilisateur de base précisé.

Exemples

Exemple 1 : Restauration de tous les types de collectes des performances Example 1: Restoring all types of Performance Collections

RSTPFRCOL  COL(PFRCOL)     COLTYPE(*ALL)
           SAVF(QGPL/MYSAVF)

Cette commande restaure dans la bibliothèque de données de performances fournie par IBM, QPFRDATA, toutes les collectes des performances nommées PFRCOL. Le fichier de sauvegarde MYSAVF de la bibliothèque QGPL est utilisé pour restaurer la collecte des performances dans le système. This command restores to the IBM-supplied performance data library, QPFRDATA, all the performance collections with name PFRCOL. The save file MYSAVF in library QGPL is used to restore to the system the performance collection.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF3706

Objet &1 de type &2 non restauré dans la bibliothèque &3.

CPF3707

Le fichier sauvegarde &1 de &2 ne contient aucune donnée.

CPF3730

Non autorisé à sauvegarder ou restaurer &2 &1 dans &3.

CPF3731

Impossible d'utiliser &2 &1 de la bibliothèque &3.

CPF3733

&2 &1 de &3 endommagé précédemment.

CPF3739

Membre du fichier base de données &1 de &3 endommagé.

CPF3743

Restauration, affichage ou listage du fichier impossible.

CPF3748

Informations sur l'objet endommagées pour la bibliothèque &1.

CPF374C

Aucun objet restauré dans l'ASP &2.

CPF3770

Aucun objet de &1 n'a été sauvegardé ou restauré.

CPF3773

&1 objets restaurés. &2 non restauré(s) dans &4.

CPF3781

Bibliothèque &1 non trouvée.

CPF3782

Le fichier &1 de &2 n'est pas un fichier sauvegarde.

CPF3793

Limite mémoire atteinte sur la machine ou dans l'ASP.

CPF3794

La sauvegarde ou la restauration n'a pas abouti.

CPF3796

Limite mémoire dépassée pour profil utilisateur &4.

CPF37A5

RSTASP &1 n'est pas en ligne.

CPF37B8

Non autorisé à restaurer les droits privés.

CPF3805

Objets du fichier sauvegarde &1 de &2 non restaurés.

CPF3812

Fichier sauvegarde &1 de &2 en cours d'utilisation.

CPF384F

Objet &1 de type &2 non restauré dans la bibliothèque &3.

CPF38A2

Unité ASP &1 incorrecte.

CPF9810

Bibliothèque &1 non trouvée.

CPF9812

Fichier &1 non trouvé dans la bibliothèque &2.

CPF9814

Unité &1 non trouvée.

CPF9820

Non autorisé à utiliser la bibliothèque &1.

CPF9825

Accès non autorisé à l'unité &1.

CPF9829

Pool de mémoire secondaire &1 non trouvé.

CPFB8ED

La description d'unité &1 est incorrecte pour l'opération.

CPFC773

Collecte des performances indiquée introuvable pour la bibliothèque &1. Specified performance collection for library &1 not found.