Aller au contenu

ANZCMDPFR

Analyser performance commande

Analyze Command Performance

En bref

La commande Analyse des performances d'une commande (ANZCMDPFR) mesure les performances d'une seule commande CL ou d'un ensemble de commandes CL. The Analyze Command Performance (ANZCMDPFR) command measures the performance of a single CL command or a set of CL commands.

ANZCMDPFR se lit ANZ (Analyser) + CMDPFR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ANZCMDPFR

Paramètres

  • CMD Commande
  • CMDFILE Fichier de commandes Command file
  • CMDMBR Membre de commandes Command member
  • OUTPUT Sortie
  • OUTFILE Fichier recevant la sortie
  • OUTMBR Options pour membre de sortie

Astuce : dans une session 5250, tapez ANZCMDPFR 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 Analyse des performances d'une commande (ANZCMDPFR) mesure les performances d'une seule commande CL ou d'un ensemble de commandes CL. Pour une seule commande, les informations de performance sont collectées depuis le début de la commande jusqu'à sa fin. Pour un ensemble de commandes, les informations de performance sont collectées depuis le début de la première commande de l'ensemble jusqu'à la fin de la dernière. The Analyze Command Performance (ANZCMDPFR) command measures the performance of a single CL command or a set of CL commands. For a single command, performance information is collected from when the command starts until the command ends. For a set of commands, performance information is collected from the start of the first command in the set until the last command in the set ends.

Paramètres

Mot-clé Description Valeurs possibles Remarques
CMD Commande Chaîne de commandeCommand string Facultatif
CMDFILE Fichier de commandesCommand file Nom d'objet qualifié Facultatif
Qualificatif 1 : Fichier de commandesQualificatif 1: Command file Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
CMDMBR Membre de commandesCommand member Nom, *FIRST Facultatif
OUTPUT Sortie *MSG, *OUTFILE Facultatif
OUTFILE Fichier recevant la sortie Nom d'objet qualifié Facultatif
Qualificatif 1: Fichier recevant la sortie Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
OUTMBR Options pour membre de sortie Liste d'éléments Facultatif
Élément 1: Membre recevant la sortie Nom, *FIRST
Élément 2: Remplacement ou ajout enregs *REPLACE, *ADD

Commande (CMD)

Indique une commande CL dont les performances doivent être analysées. Specifies a CL command whose performance is to be analyzed.

Remarque :Une valeur doit être indiquée pour ce paramètre ou pour le paramètre Fichier de commandes (CMDFILE). Vous ne pouvez pas indiquer de valeur pour les deux paramètres CMD et CMDFILE. Remarque :A value must be specified for either this parameter or the Command file (CMDFILE) parameter. You cannot specify a value for both the CMD and CMDFILE parameters.

command-string
Indiquez une chaîne de commande CL syntaxiquement correcte. Specify a syntactically-correct CL command string.

Fichier de commandes (CMDFILE)Command file (CMDFILE)

Indique le fichier source de base de données qui contient le membre source comportant les commandes CL dont les performances doivent être analysées. Specifies the database source file that contains the source member that contains the CL commands whose performance is to be analyzed.

Remarque :Une valeur doit être indiquée pour ce paramètre ou pour le paramètre Commande (CMD). Vous ne pouvez pas indiquer de valeur pour les deux paramètres CMD et CMDFILE. Remarque :A value must be specified for either this parameter or the Commande (CMD) parameter. You cannot specify a value for both the CMD and CMDFILE parameters.

Qualificatif 1 : Fichier de commandes Qualificatif 1: Command file

nom
Indiquez le nom du fichier à utiliser. Specify the name of the 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. Si aucune entrée de bibliothèque en cours n'existe dans la liste de bibliothèques, la bibliothèque QGPL est utilisée. The current library for the thread is used to locate the file. If no current library entry exists in the library list, the QGPL library is used.
nom
Indiquez le nom de la bibliothèque où se trouve le fichier. Specify the name of the library where the file is located.

Membre de commandes (CMDMBR)Command member (CMDMBR)

Indique le membre du fichier source de base de données qui contient les commandes CL dont les performances doivent être analysées. Specifies the database source file member that contains the CL commands whose performance is to be analyzed.

*FIRST
Le premier membre du fichier source de base de données indiqué pour le paramètre Fichier de commandes (CMDFILE) contient les commandes CL à exécuter. The first member of the database source file specified for the Command file (CMDFILE) parameter contains the CL commands to be run.
nom
Indiquez le nom du membre de fichier. Specify the name of the file member.

Sortie (OUTPUT)

Indique où la sortie de la commande est envoyée. Specifies where the output from the command is sent.

*MSG
La sortie est affichée dans un message (si elle est demandée par un travail interactif) ou imprimée avec la sortie spoule du travail (si elle est demandée par un travail par lots). The output is displayed in a message (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
*OUTFILE
La sortie est dirigée vers le fichier de base de données indiqué pour le paramètre Fichier recevant la sortie (OUTFILE). The output is directed to the database file specified for the Fichier recevant la sortie (OUTFILE) parameter.

Fichier recevant la sortie (OUTFILE)

Indique le fichier de base de données vers lequel la sortie de la commande est dirigée. Si le fichier n'existe pas, cette commande crée un fichier de base de données dans la bibliothèque indiquée. Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library.

Remarque :Si un nouveau fichier est créé, le texte qui le décrit est "Output file for ANZCMDPFR" et le droit public est identique au droit de création indiqué pour la bibliothèque dans laquelle le fichier est créé. Utilisez la commande Affichage de la description de bibliothèque (DSPLIBD) pour afficher le droit de création de la bibliothèque. Le format de base de données (QAPYANZR) du fichier de sortie est le même que celui du fichier de base de données QAPYANZC fourni par IBM. Remarque :If a new file is created, the text describing that file is "Output file for ANZCMDPFR" and the public authority is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority. The database format (QAPYANZR) of the output file is the same as that used in the IBM-supplied database file QAPYANZC.

Qualificatif 1: Fichier recevant la sortie

nom
Indiquez le nom du fichier vers lequel la sortie de la commande est dirigée. Specify the name of the file to which the output of the command is directed.

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 du travail est parcourue pour trouver le fichier. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours du travail, la bibliothèque QGPL est utilisée. The current library for the job is searched to find the file. If no library is specified as the current library for the job, the QGPL library is used.
nom
Indiquez le nom de la bibliothèque à parcourir pour trouver le fichier. Specify the name of the library to be searched to find the file.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier de base de données qui reçoit la sortie de la commande. Specifies the name of the database file member that receives the output of the command.

Élément 1: Member to receive output

*FIRST
Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système crée un membre portant le nom du fichier indiqué pour le paramètre Fichier recevant la sortie (OUTFILE). Si le membre existe déjà, vous avez la possibilité d'ajouter les nouveaux enregistrements à la fin du membre existant ou d'effacer le membre avant d'ajouter les nouveaux enregistrements. The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the File to receive output (OUTFILE) parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
nom
Indiquez le nom du membre de fichier qui reçoit la sortie. S'il n'existe pas, le système le crée. Specify the name of the file member that receives the output. If it does not exist, the system creates it.

Élément 2: Replace or add records

*REPLACE
Le système efface le membre existant et ajoute les nouveaux enregistrements. The system clears the existing member and adds the new records.
*ADD
Le système ajoute les nouveaux enregistrements à la fin des enregistrements existants. The system adds the new records to the end of the existing records.

Exemples

Exemple 1 : Analyse des performances d'une seule commande Example 1: Analyzing Performance of a Single Command

ANZCMDPFR   CMD(CRTLIB LIB(TST))

Cette commande analyse les performances de la commande CRTLIB LIB(TST). Les résultats sont envoyés sous forme de messages. This command analyzes the performance of the CRTLIB LIB(TST) command. The results are sent as messages.

Exemple 2 : Analyse d'une commande avec écriture des résultats dans un fichier Example 2: Analyzing a Command and Writing Results to a File

ANZCMDPFR   CMD(DSPLIB LIB(QGPL))  OUTPUT(*OUTFILE)
            OUTFILE(MYLIB/MYFILE)

Cette commande analyse les performances de la commande DSPLIB LIB(QGPL). Les résultats sont écrits dans le premier membre du fichier de base de données MYFILE de la bibliothèque MYLIB. This command analyzes the performance of the DSPLIB LIB(QGPL) command. The results are written to the first member of database file MYFILE in library MYLIB.

Exemple 3 : Analyse des performances d'un ensemble de commandes CL Example 3: Analyzing Performance of a Set of CL Commands

ANZCMDPFR   CMDFILE(MYLIB/MYCMDFILE)
            CMDMBR(CMDS)

Cette commande analyse les performances de l'ensemble des commandes CL situées dans le membre source nommé CMDS du fichier MYCMDFILE de la bibliothèque MYLIB. Les résultats sont envoyés sous forme de messages. This command analyzes the performance of the set of CL commands located in the source member named CMDS in file MYCMDFILE in library MYLIB. The results are sent as messages.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF4104
Opération non autorisée sur fichier &2 de &3, membre, ou unité &4.
CPF4128
Impossible allouer objets requis pour fichier &2 de &3, membre ou unité programme &4.
CPF9810
Bibliothèque &1 non trouvée.
CPF9812
Fichier &1 non trouvé dans la bibliothèque &2.

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