Show current main memory configuration
Component: | BS2000 |
Functional area: | System control and optimization |
Domain: | SYSTEM-MANAGEMENT |
Privileges: | STD-PROCESSING |
Routing code: | R |
Function
The SHOW-MEMORY-CONFIGURATION command provides information on the current configuration of the main memory. The information output is to SYSOUT and includes the sizes of the real main memory management such as total size, minimum size, size of the pageable part, size of the resident main memory currently available and the degree of main memory saturation. On SU x86 an additional block is output with the sizes for the big page memory management.
The command supports structured output in S variables (see "Output in S variable").
Format
SHOW-MEMORY-CONFIGURATION |
Return codes
(SC2) | SC1 | Maincode | Meaning/Guaranteed messages |
|---|---|---|---|
0 | CMD0001 | Command executed | |
1 | CMD2201 | Interface error between SDF and command server | |
3 | CMD2203 | SDF version not supported | |
32 | EMM2800 | Internal error; guaranteed message: EMM2828 | |
64 | CMD0216 | Privilege error | |
130 | EMM2807 | Operation cannot be executed due to lack of resources |
Output information
The output consists of the following two sections:
The sizes for the real memory management are output under the heading REAL MEMORY MANAGEMENT REPORT.
This section is only output on SU x86: The sizes for the big page management are output under the heading BIG PAGE MANAGEMENT REPORT.
Sample output
/show-memory-configuration
REAL MEMORY MANAGEMENT REPORT :
MEM-SIZE MIN-MEM-SIZE CSL
3948 MB 3948 MB 0
FREE-CORE-SIZE FREE-MEM-SIZE PAGE-MEM-SIZE SEMI-MEM-SIZE
1113.84 MB 2229.19 MB 2229.19 MB 20.79 MB
BIG PAGE MANAGEMENT REPORT :
QUOTA PLANNED #LM ACTUAL FREE SHR FREE-SHR
40 % 1588 MB 4 1584 MB 1324 MB 64 MB 0 MB
REDUCE EXTEND
CORE BIGP
Key
Info column | Meaning |
|---|---|
REAL MEMORY MANAGEMENT REPORT (sizes for the real memory management) | |
| Size of the real main memory in Mbytes |
| Minimum size of the real main memory in Mbytes (in a VM2000 guest system MIN-MEM-SIZE can be less than MEM-SIZE; in native mode the values are identical) |
| Current main memory saturation level; possible values: 0 (no saturation), 1, 2 or 3 (highest alarm level) |
| Proportion of free main memory which is still available for resident class 3 memory requests of the system (is decisive for the main memory saturation level) |
| Proportion of free main memory which is available for the remaining resident memory requests such as resident memory pools or data spaces (with a main memory <= 2 GB, FREE-CORE- and FREE-MEM-SIZE are identical) |
| Size of the main memory which is available for nonresident, pageable pages (in systems in which MEM-SIZE and MIN-MEM-SIZE are identical, FREE-MEM-SIZE and PAGE-MEM-SIZE are also identical) |
| Size of the main memory which is available for semi-resident pages. Is part of the main memory used on a nonresident basis, which corresponds to PAGE-MEM-SIZE. Semi-resident pages are used mainly by DAB caches with MEMORY=*ABOVE/*ANY. |
BIG PAGE MANAGEMENT REPORT (sizes for the BIG PAGE memory management) | |
| Percentage of the main memory which is to be used as big page memory (and which can be set using the BIG-PAGE-QUOTA parameter or MODIFY-MEMORY-PARAMETERS command) |
| Planned size of the big page memory in Mbytes which is calculated from the main memory size (MEM-SIZE) and the percentage (QUOTA) |
| Maximum possible number of logical machines (CPUs) in the system (the larger this value, the smaller the size of the big page memory) |
| Current size of the big page memory (actual size) in MB The value can deviate from the planned size (PLANNED) if, for example, the big page memory was reduced owing to a threat of main memory saturation |
| Size of the free (unused) big page memory in Mbytes |
| Size of the envisaged shared big page memory for CISCFW compiled codes in class-3 memory in Mbytes |
| Size of the free shared big page memory in Mbytes |
| Determines when the big page memory may be cleared; possible values:
|
EXTEND | Determines when the big page memory may be extended; possible values:
|
Notes
The following applies for the sizes of the real memory management:
MEM-SIZE >= MIN-MEM-SIZE > FREE-MEM-SIZE >= FREE-CORE-SIZE
MEM-SIZE > PAGE-MEM-SIZE >= FREE-MEM-SIZE >= FREE-CORE-SIZE
DAB buffer and CISCFW memory are created in the memory designated with FREE-MEM-SIZE. Nevertheless, main memory saturation can be eradicated by reducing DAB buffers or terminating programs if FREE-MEM-SIZE minus CORE-SIZE is less than the size of the DAB buffers. If this is not the case, measures for reducing the class 3 memory or address spaces (tasks, data spaces) are required.
The sizes QUOTA and REDUCE displayed in big page management can be modified using the MODIFY-MEMORY-PARAMETERS command.
For further details, please see “Main memory management” in the manual “Introduction to System Administration” [14].
Output in S variable
The S variables for the sizes of the big page memory management are only output on one SUx86 (see “SU x86” in the “Condition” column).
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Size of the real memory in Mbytes | var(*LIST).MEM-SIZE | I | <integer 1..4194304> | |
Minimum size of the real memory in Mbytes | var(*LIST).MIN-MEM-SIZE | I | <integer 1..4194304> | |
current main memory saturation level | var(*LIST).CORE-SATUR-LEV | I | <integer 0..3> | |
Free main memory available for the resident class 3 memory requests | var(*LIST).FREE-CORE-SIZE | I | <integer 0..2048> | |
Free main memory available for the remaining resident memory requests | var(*LIST).FREE-MEM-SIZE | I | <integer 1..4194304> | |
Size of the main memory for nonresident, pageable pages | var(*LIST).PAGE-MEM-SIZE | I | <integer 1..4194304> | |
Size of the main memory for semi-resident pages | var(*LIST).SEMI-MEM-SIZE | I | <integer 1..4194304> | |
Percentage of main memory which is to be used as big page memory | var(*LIST).BIG-PAGE-QUOTA | I | <integer 0..99> | SU x86 |
Planned size of the big page memory in Mbytes | var(*LIST).PLAN-BPSIZE | I | <integer 1..4194304> | SU x86 |
Number of the possible logical machines of the system (CPUs) | var(*LIST).NUM-OF-LM | I | <integer 1..32> | SU x86 |
Actual size of the big page memory in Mbytes | var(*LIST).ACTUAL-BPSIZE | I | <integer 1..4194304> | SU x86 |
Size of the free (unused) big page memory | var(*LIST).FREE-BPSIZE | I | <integer 1..4194304> | SU x86 |
Size of the shared big page memory in Mbytes | var(*LIST).SHARED-BPSIZE | I | <integer 0..256> | SU x86 |
Size of the free shared big page memory in Mbytes | var(*LIST).FREE-SHARED-BPSIZE | I | <integer 0..256> | SU x86 |
Specification whether, and if yes, when a reduction of the big page memory is allowed, except in case of memory reduction | var(*LIST).REDUCE-BIG-PAGES | S | QUOTA | SU x86 |
Specification whether, and if yes, when an extension of the big page memory is allowed, except in case of memory extension | var(*LIST).EXTEND-BIG-PAGES | S | QUOTA | SU x86 |