Dump Main Memory Information (DMPMEMINF)

The Dump Main Memory Information (DMPMEMINF) command dumps information about pages of main memory to a file.

Note: 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:

This command is shipped with public *EXCLUDE authority.
You will need to be authorized to the output file and library. Refer to Appendix D of the iSeries Security Reference, SC41-5302 for detailed authority requirements.
To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service Dump function of the operating system through iSeries Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command with a function ID of QIBM_SERVICE_DUMP can also be used to change the list of users that are allowed to perform dump operations.

Parameters

Keyword	Description	Choices	Notes
OUTFILE	File to receive output	Qualified object name	Required, Positional 1
	Qualifier 1: File to receive output	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
OUTMBR	Output member options	Element list	Optional
	Element 1: Member to receive output	Name, *FIRST
	Element 2: Replace or add records	REPLACE, ADD
NBRPAGE	Number of pages	Unsigned integer, 10000, *ALL	Optional

Top

File to receive output (OUTFILE)

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.

This is a required parameter.

Qualifier 1: File to receive output

name: Specify the name of the database file to which the command output is directed.

Qualifier 2: Library

*LIBL: 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: 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.
name: Specify the name of the library used to locate the output file.

Output member options (OUTMBR)

Specifies the name of the database file member that receives the output of the command.

Element 1: Member to receive output

*FIRST: 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.

name: Specify the name of the file member that receives the output. If it does not exist, the system creates it.

Element 2: Replace or add records

*REPLACE: The system clears the existing member and adds the new records.

*ADD: The system adds the new records to the end of the existing records.

Number of pages (NBRPAGE)

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: Ten thousand main memory pages will have information written to the output file.
*ALL: 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.
Note: 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).

Examples

Example 1: Dump a Sample of Main Memory

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

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.

Example 2: Dump All Main Memory Page Information

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

This command dumps information about all available main memory pages to file DMPMEM in library MYLIB. The records will be written to member TEST2.