CU (Core Usage)

The CU (Core Usage) command displays information about the memory usage either of a particular task or of the entire system.

Only the CU and CU AVAIL forms of the command can be used in conjunction with the ADM command.

Memory disk, if used, is not included in the display; to display memory disk information, use the MM (Memory Module) command.

For detailed information about the buffer statistics refer to the SF (Set Factor) command and the File Attributes Programming Reference Manual. For detailed information about the overlay mechanism, refer to the Managing Memory section of the System Operations Guide.

Syntax

Explanation

<mix number list> CU

Displays memory usage statistics for the tasks in the specified mix number list. These statistics include total and save sizes of both the stack and the code. If the system schedules the specified task, the display shows the number of words required for the task.

CU

Displays information about memory usage, ASD usage, and logical I/O buffer usage for the entire system. The memory information includes the number of available words, the number of in-use words (both save and nonsave), and the number of words overlaid to the DL OVERLAY family (or families). The ASD information includes the percentage of in-use ASDs. The logical I/O buffer information is broken down by the source of the buffersize (buffergoal, buffersize, or blocksize).

CU AVAIL

Displays the Memory Summary section similar to the normal CU command, a modified ASD Information section, and replaces the Buffer Statistics section with the Avail Mem Totals section.

The Avail Mem Totals section provides a list of the number of words in nonsave available lists, save available lists, and not linked available areas. The number of words from the nonsave and save counts are not mutually exclusive because the same area of available words can be in both the lists, depending on their address and the relationship of the address to the amount of in-use nonsave and save memory. This means that the total of nonsave available, save available, and not linked available words might be greater than the available words listed in the memory summary.

The Available Areas value represents the number of linked areas in save and nonsave lists. This value represents the number of available areas that constitute the Save and Non Save Avail Mem Totals and provides an idea of the amount of checkerboarding present in memory. The higher the value, the greater the number of available areas interspersed among in-use areas.

The Not Linked Areas value represents the number of areas that are not linked in save or nonsave lists and corresponds to the word value of Not Linked Avail Mem Totals. These areas are too small to hold in-use memory due to link requirements and are reclaimed only when an adjacent in-use area is deallocated or moved.

CU AVAIL LISTS

Displays statistics about the four largest available lists of save available memory and the four largest available lists of overlayable available memory. Specifically, each set of lists is detailed with the maximum size area in the list, the minimum size area in the list, the total number of areas in the list, and the total number of words in the list. Note that an available memory area might appear in both a save and an overlayable available memory list. Overlayable memory is non save memory.

This statistical data is provided to indicate whether or not the initiation of applications such as a database transaction environment could possibly lead to excessive demand overlay because of the lack of sufficiently large available save memory areas for the application or database buffers. The administrator might choose to increase the system factors or delay the initiation of the application in order to avoid or minimize the possibility of high OTHERPBIT and false idle utilization times that could result from excessive demand overlay.

CU AVAIL OLAYLISTS

Displays memory usage data similar to the CU AVAIL LISTS command, but only includes detailed statistics about the largest available lists of available overlayable memory. This command shows the eight largest lists rather than the four shown by CU AVAIL LISTS.

CU AVAIL SAVELISTS

Displays memory usage data similar to the CU AVAIL LISTS command, but only includes detailed statistics about the largest available lists of available save memory. This command shows the eight largest lists rather than the four shown by CU AVAIL LISTS.

CU POOLS

Displays the statistics of the memory pool mechanism implemented to improve management of small memory size segments. There are no tuning mechanisms available to modify the general implementation. However, an increase in the value of the AVAILMIN (SF 2) system factor causes memory management to bias allocation of small objects away from memory pools for overlayable segments when available memory falls below this value. An increase in OVERLAYABLEMIN (SF 4) causes memory management to bias these allocations for save segments when available memory falls below the overlay memory minimum.

Memory pool areas contain individual ASD segments referred to as pool objects. Each pool area is divided into a number of fixed size areas that allow allocation of a range of values. Pool areas are further subdivided into Save and Non Save Pool areas. The CU POOLS command displays the CU output followed by the memory statistics for all allocated memory pool areas under the heading Memory Pools Summary. Memory Pools Summary is further divided into the following headings:

  • Memory Summary

    The Memory Summary area of the display shows total values of the Available and In Use areas. The In Use values are further divided into Non Save and Save values as well as pool object Fragments and pool area Not Linked. Fragments represent the portion of the pool object that exceeds the segment requirement of the object. For example, if the pool area contains all objects from 8 to 15 words, and the actual segment requirement is 10 words, the fragment is incremented by five words. The Not Linked value represents the total overhead of pool area management regions.

  • Non Save and Save Pools

    The remainder of the display splits the memory statistics into Non Save and Save pool area summaries. The left column in the first three rows of the Non Save and Save pool area summaries shows the number of objects Available, Inuse, and the Total. The right column in the three rows shows the core value in words represented by the object counts and the corresponding total. For the Fragments row, the left column in the Non Save and Save pool area summaries shows the percentage of in-use pool object memory. The right column shows the value in words of pool object fragments. The Not Linked row shows the percentage value of pool area memory and the corresponding number of words in pool area not linked memory. The Areas row displays the number of Non Save and Save pool areas and their corresponding word requirements.

CU AVAIL POOLS

Displays the Memory Pools Summary as described for CU POOLS. The output is displayed below the CU AVAIL output instead of the CU display.

Examples

Example 1

The following example of a CU display shows all memory used by the process and main memory usage:

CU

  -------------------------SYSTEM MEMORY USAGE-----------------------------
 
  -- Memory Summary --   ---ASD Information----    ----Buffer Statistics---
  Available  5,309,139   Total ASDs      41,942   Size source Number Memory
  Non save   2,090,869   In use             25%   Buffergoal       0      0
  Save         988,600   Maximum in use     26%   Buffersize       0      0
  Total      8,388,608   Factor    50 Words/ASD   Blocksize        5  2,420
  Overlaid     158,712

Example 2

The following shows a <mix number> CU command and the resulting display:

9508 CU
  9508 Memory:    Total      Save
   Stack          8,592      4,782
   Code          23,075      2,949
   Total         31,667      7,731

Example 3

The following shows a CU AVAIL command and the resulting display that shows individual available memory totals:

CU AVAIL

  --------------------------SYSTEM MEMORY USAGE---------------------------
  --- Memory Summary ---  --- ASD Information ---  -- Avail Mem Totals ---
  Available  372,682,673  Available     2,337,304  Non Save    156,754,772
  Non save   121,433,589  In use          425,693  Save        166,913,864
  Save        55,337,562  Maximum         440,990  Not Linked      278,845
  Total      549,453,824  Total         2,762,997  Available Areas   4,227
  Overlaid             0  In use   15% : Max  16%  Not Linked Areas 99,587

Example 4

The following shows a CU AVAIL LISTS command and the resulting display that shows individual available memory totals as well as the statistics for the four largest sets of save and non save available memory lists.

-------------------------- SYSTEM MEMORY USAGE -------------------------
--- Memory Summary --- --- ASD Information ---  --- Avail Mem Totals ---
Available 323,947,481  Available     2,337,304  Non Save     156,754,772
Non save  162,473,238  In use          425,693  Save         166,913,864
Save       63,033,105  Maximum         440,990  Not Linked       278,845
Total     549,453,824  Total         2,762,997  Available Areas    4,227
Overlaid            0  In use   15% : Max  16%  Not Linked Areas  99,587

--------------  Largest Available Save Lists Statistics  --------------
-- Maximum Size --  - Minimum Size -  - Total Areas -  - Total Words -
       155,576,136         4,273,905                 2      159,850,041
           330,936           280,123                 2          611,059
           258,625           156,367                 4          756,817
            83,260            65,580                 2          148,840

-------------- Largest Available Non Save Lists Statistics --------------
- Maximum Size -  -- Minimum Size --  - Total Areas -  -- Total Words --
     139,460,604             574,691                15        153,335,648
           8,198               8,195               370          3,033,060
           8,182               7,973                 7             56,927
           6,994               6,994                 1              6,994

Example 5

The following shows a CU AVAIL OLAYLISTS command and the resulting display that shows individual available memory totals as well as the statistics for the largest eight sets of avail overlayable memory; that is, the statistics for the largest non save available memory areas and their associated lists.

-------------------------- SYSTEM MEMORY USAGE ---------------------------
----- Memory Summary ----  -- ASD Information --  --- Avail Mem Totals ---
Available     329,040,480  Available   2,337,304  Non Save     156,754,772
Non save      157,801,347  In use        425,693  Save         166,913,864
Save           62,611,997  Maximum       440,990  Not Linked       278,845
Total         549,453,824  Total       2,762,997  Available Areas    4,227
Overlaid                0  In use 15% : Max  16%  Not Linked Areas  99,587

------------- Largest Available Non Save Lists Statistics -------------
- Maximum Size -  - Minimum Size -  - Total Areas -  -- Total Words --
     139,460,604           574,691                15        153,471,384
         403,252           312,397                 2            715,649
         253,144           131,157                 8          1,502,222
         124,157            66,088                12          1,143,896
          64,672            32,791                21            942,207
          32,741            25,025                 5            139,251
          19,489            16,394                 4             69,797
          14,357            14,357                 1             14,357

Example 6

The following shows a CU AVAIL SAVELISTS command and the resulting display that shows individual available memory totals as well as the statistics for the largest eight sets of avail overlayable memory; that is, the statistics for the largest non save available memory s and their associated lists.

-------------------------- SYSTEM MEMORY USAGE ----------------------------
----- Memory Summary ----  --- ASD Information --  --- Avail Mem Totals ---
Available     329,171,666  Available    2,337,304  Non Save     156,754,772
Non save      157,594,776  In use         425,693  Save         166,913,864
Save           62,687,382  Maximum        440,990  Not Linked       278,845
Total         549,453,824  Total        2,762,997  Available Areas    4,227
Overlaid                0  In use  15% : Max  16%  Not Linked Areas  99,587

---------------- Largest Available Save Lists Statistics ----------------
-- Maximum Size --  -- Minimum Size --  - Total Areas -  - Total Words -
       155,576,136           4,273,905                 2      159,850,041
           280,123             280,123                 1          280,123
           228,028             131,088                 4          698,960
           127,530              65,580                 5          465,459
            63,567              32,835                15          675,041
            32,249              24,591                16          432,859
            24,255              16,389                15          301,373
            15,128              15,128                 1           15,128

Example 7

The following shows a CU AVAIL POOLS command and the resulting display.

-------------------------- SYSTEM MEMORY USAGE -------------------------
--- Memory Summary --- --- ASD Information ---  --- Avail Mem Totals ---
Available 440,930,713  Available     2,343,478  Non Save     421,388,917
Non save   47,204,160  In use          398,548  Save         317,350,749
Save       57,124,647  Maximum         408,283  Not Linked        23,847
Total     545,259,520  Total         2,742,026  Available Areas    8,479
Overlaid            0  In use   15% : Max  15%  Not Linked Areas   9,414

------------------------  Memory Pools Summary  ------------------------
-- Memory Summary --  ------- Non Save Pools ------  --- Save Pools --- 
Available    520,720  Avail      1,270      211,632   3,507      309,088
Non save  18,970,444  In use   224,594   18,970,444  65,290    4,565,468
Save       4,565,468  Total    225,864   19,182,076  68,797    4,874,556
Fragments    931,608  Fragments  3.25%      637,828   6.05%      293,780
Notlinked    451,560  Notlinked  1.86%      376,516   1.43%       75,044
Total     25,439,800  Areas      2,469   20,196,420     641    5,462,116