DMPMEMINF

La commande Vider informations de mémoire principale (DMPMEMINF) vide dans un fichier les informations sur les pages de la mémoire principale. The Dump Main Memory Information (DMPMEMINF) command dumps information about pages of main memory to a file.

\nRemarque : Il est recommandé d'exécuter cette commande dans son propre pool de mémoire afin de ne pas modifier les pages de mémoire principale résidentes dans les pools de mémoire vidés. Remarque :It is recommended that this command be run in its own storage pool to avoid changing which main memory pages are resident in the storage pools being dumped.

Restrictions:

• Cette commande est livrée avec le droit public *EXCLUDE. This command is shipped with public *EXCLUDE authority.
• Vous devez être autorisé sur le fichier et la bibliothèque de sortie. Pour connaître les droits requis en détail, consultez l'annexe D du IBM i Security Reference, SC41-5302. You will need to be authorized to the output file and library. Refer to Appendix D of the IBM i Security Reference, SC41-5302 for detailed authority requirements.
• Pour utiliser cette commande, vous devez posséder le droit spécial de service (*SERVICE), ou être autorisé à la fonction Service Dump du système d'exploitation. La commande Modifier utilisation de fonction (CHGFCNUSG) avec l'ID de fonction QIBM_SERVICE_DUMP permet de modifier la liste des utilisateurs autorisés à effectuer des opérations de vidage. To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service Dump function of the operating system. The Change Function Usage (CHGFCNUSG) command with a function ID of QIBM_SERVICE_DUMP can be used to change the list of users that are allowed to perform dump operations.

Paramètres

Fichier recevant la sortie (OUTFILE)

Indique la bibliothèque et le fichier de base de données vers lesquels 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, en prenant comme modèle le fichier QAPYDMPMEM de la bibliothèque QSYS. Si le fichier est créé, les droits publics sur le fichier sont identiques aux droits de création indiqués pour la bibliothèque dans laquelle le fichier est créé. Utilisez la commande Afficher description de bibliothèque (DSPLIBD) pour afficher les droits de création de la bibliothèque. Specifies the library and 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, using file QAPYDMPMEM in library QSYS as a model. If the file is created, the public authority for the file 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.

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

Qualificatif 1: Fichier recevant la sortie

nom

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

Qualificatif 2: Biblio

*LIBL

La liste de bibliothèques est utilisée pour localiser le fichier. Si le fichier est introuvable, un fichier est créé dans la bibliothèque en cours. S'il n'existe pas de bibliothèque en cours, le fichier est créé dans la bibliothèque QGPL. The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.

*CURLIB

La bibliothèque en cours de l'unité d'exécution est utilisée pour localiser le fichier. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours de l'unité d'exécution, la bibliothèque QGPL est utilisée. The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.

nom

Indiquez le nom de la bibliothèque utilisée pour localiser le fichier de sortie. Specify the name of the library used to locate the output 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.

Nombre de pages (NBRPAGE)Number of pages (NBRPAGE)

Indique le nombre de pages de mémoire principale pour lesquelles des enregistrements d'informations seront écrits dans le fichier de sortie. Une distribution uniforme de pages de mémoire principale sera traitée. Specifies the number of main memory pages for which information records will be written to the output file. A uniform distribution of main memory pages will be processed.

10000

Les informations de dix mille pages de mémoire principale seront écrites dans le fichier de sortie. Ten thousand main memory pages will have information written to the output file.

*ALL

Les informations de toutes les pages de mémoire principale seront écrites dans le fichier de sortie. All main memory pages will have information written to the output file.

unsigned-integer

Specify the number of main memory pages for which information is to be written to the output file.

\nRemarque : Le nombre réel de pages traitées peut être inférieur au nombre indiqué en raison de pages inaccessibles ou de modifications dynamiques de la taille de la mémoire principale dans une partition logique (LPAR). Remarque :The actual number of pages processed may be smaller than the number specified due to pages not being accessible or dynamic changes to main memory size in a logical partition (LPAR).

Exemples

Exemple 1 : Vidage d'un échantillon de la mémoire principale Example 1: Dump a Sample of Main Memory

DMPMEMINF   OUTFILE(MYLIB/DMPMEM)  OUTMBR(TEST1)
            NBRPAGE(20000)

Cette commande vide les informations d'un échantillon d'au plus vingt mille pages de mémoire principale dans le fichier DMPMEM de la bibliothèque MYLIB. Les enregistrements seront écrits dans le membre TEST1. This command dumps information about a sample of up to twenty thousand main memory pages to file DMPMEM in library MYLIB. The records will be written to member TEST1.

Exemple 2 : Vidage des informations de toutes les pages de mémoire principale Example 2: Dump All Main Memory Page Information

DMPMEMINF   OUTFILE(MYLIB/DMPMEM)  OUTMBR(TEST2)
            NBRPAGE(*ALL)

Cette commande vide les informations de toutes les pages de mémoire principale disponibles dans le fichier DMPMEM de la bibliothèque MYLIB. Les enregistrements seront écrits dans le membre TEST2. This command dumps information about all available main memory pages to file DMPMEM in library MYLIB. The records will be written to member TEST2.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF9860

Erreur lors du traitement du fichier de sortie.

CPF98A2

Vous n'avez pas les droits sur la commande ou l'API &1. Not authorized to &1 command or API.