Aller au contenu

SAVPFRCOL

Sauvegarder collecte performances

Save Performance Collection

En bref

La commande Sauvegarder une collecte des performances (SAVPFRCOL) sauvegarde une copie d'une collecte des performances unique ou d'un groupe de collectes des performances situées dans la même bibliothèque. The Save Performance Collection (SAVPFRCOL) command saves a copy of a single performance collection or a group of performance collections located in the same library.

SAVPFRCOL se lit SAV (Sauvegarder) + PFRCOL. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

SAVPFRCOL

Paramètres

  • COL Collecte Collection
  • LIB Biblio
  • COLTYPE Type de collecte Collection type
  • SAVF Fichier sauvegarde
  • TGTRLS Edition cible
  • DTACPR Compression des données

Astuce : dans une session 5250, tapez SAVPFRCOL puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande Sauvegarder une collecte des performances (SAVPFRCOL) sauvegarde une copie d'une collecte des performances unique ou d'un groupe de collectes des performances situées dans la même bibliothèque. The Save Performance Collection (SAVPFRCOL) command saves a copy of a single performance collection or a group of performance collections located in the same library.

Restrictions:

  • Cette commande est livrée sans droit public (*EXCLUDE). This command is shipped with no public authority (*EXCLUDE).
  • You must either have save system (*SAVSYS) special authority or the following object authorities:
    • droit d'existence d'objet (*OBJEXIST) sur chaque objet à sauvegarder. object existence (*OBJEXIST) authority for each object to be saved.
    • droit d'exécution (*EXECUTE) sur chaque bibliothèque à partir de laquelle des objets sont sauvegardés. execute (*EXECUTE) authority to each library objects are saved from.
  • Si vous ne possédez pas le droit spécial *SAVSYS, seuls les objets pour lesquels vous avez des droits sont sauvegardés. If you do not have *SAVSYS special authority, only those objects that you have authority for are saved.
  • Vous devez posséder le droit *EXECUTE sur la bibliothèque où se trouve le fichier de sauvegarde. You must have *EXECUTE authority to the library where the save file is located.

Paramètres

Mot-clé Description Valeurs possibles Remarques
COL CollecteCollection Valeurs uniques: *SELECT, *ALL
Autres valeurs (jusqu'à 300 répétitions): Nom générique, nom
Facultatif, positionnel 1
LIB Biblio Nom, QPFRDATA Facultatif
COLTYPE Type de collecteCollection type Valeurs uniques: *ALL
Autres valeurs (jusqu'à 10 répétitions): Valeur caractère, *CSFILE, *CSMGTCOL, *DWFILE, *JWFILE, *PEXFILE, *PEXMGTCOL
Facultatif
SAVF Fichier sauvegarde Nom d'objet qualifié Facultatif
Qualificatif 1 : Fichier sauvegardeQualificatif 1: Fichier sauvegarde Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
TGTRLS Edition cible Valeur caractère, *CURRENT, *PRV Facultatif
DTACPR Compression des données *NO, *YES, *LOW, *MEDIUM, *HIGH Facultatif

Collecte (COL)Collection (COL)

Indique les noms d'une ou plusieurs collectes des performances, ou le nom générique de chaque groupe de collectes des performances, à sauvegarder. Toutes les collectes des performances doivent se trouver dans la bibliothèque indiquée dans le paramètre Biblio (LIB). Si *ALL est indiqué ou pris par défaut pour le paramètre Type de collecte (COLTYPE), tous les types de collecte énumérés dans la description de ce paramètre sont sauvegardés, à condition qu'ils se trouvent dans la bibliothèque indiquée et portent les noms indiqués. Specifies the names of one or more performance collections or the generic name of each group of performance collections to be saved. All the performance collections must be in the library specified for the Biblio (LIB) parameter. If *ALL is specified or defaulted for the Collection type (COLTYPE) parameter, all the collection types listed in the description of that parameter are saved, provided they are in the specified library and have the specified names.

Valeurs uniques

*SELECT
Lists all performance collections available in the specified library so you can select them to save.

\nRemarque : Cette valeur n'est valide que dans un environnement interactif. Remarque :This value is valid only in an interactive environment.

*ALL
Toutes les collectes des performances de la bibliothèque indiquée sont sauvegardées, en fonction des valeurs indiquées pour le paramètre Type de collecte (COLTYPE). All the performance collections in the specified library are saved, depending on the values specified for the Collection type (COLTYPE) parameter.

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 à sauvegarder. 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 be saved. 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 à sauvegarder. 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 be saved. Both generic names and specific names can be specified in the same command.

Biblio (LIB)

Indique la bibliothèque qui contient les collectes des performances à sauvegarder. Specifies which library contains the performance collections to be saved.

QPFRDATA
Les collectes des performances à sauvegarder se trouvent dans la bibliothèque de performances fournie par IBM, QPFRDATA. The performance collections to be saved are located in the IBM-supplied performance library, QPFRDATA.
nom
Indiquez le nom de la bibliothèque dans laquelle se trouvent les collectes des performances. Specify the name of the library where the performance collections are located.

Type de collecte (COLTYPE)Collection type (COLTYPE)

Indique le type de collecte à sauvegarder. Specifies the type of collection to be saved.

Valeurs uniques

*ALL
Tous les types de collectes des performances indiquées par leur nom et situées dans la bibliothèque indiquée sont sauvegardés. Cela comprend les collectes basées sur des fichiers et les collectes basées sur des objets. Si *ALL est également indiqué pour le paramètre Collection (COL), toutes les collectes des performances de la bibliothèque dont le type peut être sauvegardé sont sauvegardées. All types of performance collections that are specified by name and are in the specified library are saved. This includes file-based collections and object-based collections. If *ALL is also specified for the Collection (COL) parameter, all the performance collections in the library that are of the types that can be saved are saved.

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 sauvegardées. Only the Collection Services file-based collections specified in the Collection (COL) parameter are to be saved.
*CSMGTCOL
Seules les collectes Collection Services basées sur des objets indiquées dans le paramètre Collection (COL) doivent être sauvegardées. Only the Collection Services object-based collections specified in the Collection (COL) parameter are to be saved.
*DWFILE
Seules les collectes Disk Watcher basées sur des fichiers indiquées dans le paramètre Collection (COL) doivent être sauvegardées. Only the Disk Watcher file-based collections specified in the Collection (COL) parameter are to be saved.
*JWFILE
Seules les collectes Job Watcher basées sur des fichiers indiquées dans le paramètre Collection (COL) doivent être sauvegardées. Only the Job Watcher file-based collections specified in the Collection (COL) parameter are to be saved.
*PEXFILE
Seules les collectes Performance Explorer basées sur des fichiers indiquées dans le paramètre Collection (COL) doivent être sauvegardées. Only the Performance Explorer file-based collections specified in the Collection (COL) parameter are to be saved.
*PEXMGTCOL
Seules les collectes Performance Explorer basées sur des objets indiquées dans le paramètre Collection (COL) doivent être sauvegardées. Only the Performance Explorer object-based collections specified in the Collection (COL) parameter are to be saved.
*BCHFILE
Seules les collectes Batch Model basées sur des fichiers indiquées dans le paramètre Collection (COL) doivent être sauvegardées. Only the Batch Model file-based collections specified in the Collection (COL) parameter are to be saved.
*HSTFILE
Seules les collectes historiques basées sur des fichiers indiquées dans le paramètre Collection (COL) doivent être sauvegardées. Only the Historical file-based collections specified in the Collection (COL) parameter are to be saved.
type
Specify the type of collections to be saved.

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 qui contiendra les données sauvegardées. Ce paramètre est obligatoire. Specifies the save file that is used to contain the saved data. 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.

Edition cible (TGTRLS)

Indique l'édition du système d'exploitation sur laquelle vous avez l'intention de restaurer et d'utiliser les collectes des performances. Specifies the release of the operating system on which you intend to restore and use the performance collections.

Lorsque vous indiquez la valeur d'édition cible, le format VxRxMx sert à indiquer l'édition, où Vx est la version, Rx l'édition et Mx le niveau de modification. Par exemple, V5R3M0 correspond à la version 5, édition 3, modification 0. When specifying the target-release value, the format VxRxMx is used to specify the release, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V5R3M0 is version 5, release 3, modification 0.

Les valeurs valides dépendent de la version, de l'édition et du niveau de modification actuels du système d'exploitation, et elles changent à chaque nouvelle édition. Vous pouvez appuyer sur F4 lors de l'invite de ce paramètre de commande pour afficher la liste des valeurs valides d'édition cible. Valid values depend on the current version, release, and modification level of the operating system, and they change with each new release. You can press F4 while prompting this command parameter to see a list of valid target release values.

*CURRENT
Les collectes des performances doivent être restaurées et utilisées sur l'édition du système d'exploitation actuellement en cours d'exécution sur votre système. Les collectes des performances peuvent également être restaurées sur un système sur lequel une édition ultérieure du système d'exploitation est installée. The performance collections are to be restored to, and used on, the release of the operating system currently running on your system. The performance collections can also be restored to a system with any subsequent release of the operating system installed.
*PRV
Les collectes des performances doivent être restaurées sur l'édition précédente du système d'exploitation, au niveau de modification 0. Les collectes des performances peuvent également être restaurées sur un système sur lequel une édition ultérieure du système d'exploitation est installée. The performance collections are to be restored to the previous release with modification level 0 of the operating system. The performance collections can also be restored to a system with any subsequent release of the operating system installed.
valeur-caractère
Indiquez l'édition au format VxRxMx. L'objet peut être restauré sur un système disposant de l'édition indiquée ou d'une édition ultérieure du système d'exploitation. Specify the release in the format VxRxMx. The object can be restored to a system with the specified release or with any subsequent release of the operating system installed.

Compression des données (DTACPR)

Indique si la compression de données est utilisée. Si la sauvegarde s'exécute alors que d'autres travaux sont actifs sur le système et que la compression logicielle est utilisée, les performances globales du système peuvent être affectées. Specifies whether data compression is used. If the save is running while other jobs on the system are active and software compression is used, the overall system performance may be affected.

*NO
Aucune compression de données n'est effectuée. No data compression is performed.
*YES
La compression logicielle est effectuée. Une compression logicielle faible est utilisée. Software compression is performed. Low software compression is used.
*LOW
La compression logicielle des données est effectuée avec l'algorithme SNA. La compression faible est généralement plus rapide et les données compressées sont généralement plus volumineuses qu'avec une compression moyenne ou élevée. Software data compression is performed with the SNA algorithm. Low compression is usually faster and the compressed data is usually larger than if medium or high compression is used.
*MEDIUM
La compression logicielle des données est effectuée avec l'algorithme TERSE. La compression moyenne est généralement plus lente que la compression faible mais plus rapide que la compression élevée. Les données compressées sont généralement plus petites qu'avec une compression faible et plus volumineuses qu'avec une compression élevée. Software data compression is performed with the TERSE algorithm. Medium compression is usually slower than low compression but faster than high compression. The compressed data is usually smaller than if low compression is used and larger than if high compression is used.
*HIGH
La compression logicielle des données est effectuée avec l'algorithme LZ1. La compression élevée est généralement plus lente et les données compressées sont généralement plus petites qu'avec une compression faible ou moyenne. Software data compression is performed with the LZ1 algorithm. High compression is usually slower and the compressed data is usually smaller than if low or medium compression is used.

Exemples

Exemple 1 : Sauvegarde de collectes des performances Example 1: Saving Performance Collections

SAVPFRCOL  COL(TEST1 TEST2)

Cette commande sauvegarde les collectes des performances TEST1 et TEST2 de la bibliothèque de performances fournie par IBM, QPFRDATA. Cette commande s'exécute en mode interactif pendant que l'utilisateur attend. This command save performance collections TEST1 and TEST2 from the IBM-supplied performance library QPFRDATA. This command runs interactively while the user waits.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPFC763
La collecte des performances &2 de type &3 dans la bibliothèque &1 n'existe pas. Performance collection &2 of type &3 in library &1 does not exist.
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.
CPF3735
Limite mémoire dépassée pour profil utilisateur &1.
CPF3781
Bibliothèque &1 non trouvée.
CPF3812
Fichier sauvegarde &1 de &2 en cours d'utilisation.
CPF9820
Non autorisé à utiliser la bibliothèque &1.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.