Link Pack Area Report


The Link Pack Area report provides information about the use of the modified, fixed, and pageable link pack areas. This report can be used as a guide for determining where a link pack area module should reside and for packing the PLPA and MLPA to reduce page faults.

The Link Pack Area Report is produced by using the LINKPACK Analyzer control statement. The data for this report is obtained by using the LINKMAP Extractor control statement and defining GBLS=YES to the REPORT Extractor control statement.

The Link Pack Area Report is divided into four sections with an optional fifth section:

  • Performance Statistics

    This section lists module counts for the MLPA, FLPA, and PLPA, in both the lower and extended areas. It also shows the user-supplied threshold rank for the run.

  • Link Pack Area Module Mapping

    This section lists LPA modules sorted by page address. The action flag included in this section marks LPA pages, which contain modules with different levels of activity. Such modules are often candidates for inclusion in the packlist.

  • Portion of the Link Pack Areas Selected for Potential Substitution into the Packlist

    This section lists all modules with a busy rank greater than the threshold rank, sorted in descending order by busy rank.

  • Time in Use

    This section lists all modules with a busy rank greater than zero (one section each for the MLPA, FLPA, and PLPA). You can use these reports to make decisions regarding packlist inclusion and FLPA module placement.

  • Map Error Log

    This report is generated only when errors occur. Any of the following errors might be reported:

    • module name mismatch: More than one entry was found for the same location, but the module names were not the same.
    • module length mismatch: More than one entry was found for the same location, but the module length was not the same.
    • address mismatch: More than one entry was found for the same location, but the entry points were not the same.
    • lower flag mismatch: More than one entry was found for the same location, but the characteristics of the entry were not the same. (State indicators.)
    • extended flag mismatch:More than one entry was found for the same location, but the extended characteristics of the entry were not the same. (Location and type indicators.)
    • unknown: A mismatch between at least two entries was found, but it could not be resolved into one of the previous categories.

If the LPA configuration was changed during the interval covered by the input data, two or more Link Pack Area reports are produced.

Note

This report requires the -16 records written at CMF MONITOR Extractor initialization, where xxx is the SMF ID for the CMF MONITOR user records (the default is 240). To obtain the desired report, ensure that the input data includes the records written when extraction began. It is not necessary to include the reporting period of these records in the DATETIME or SHIFT ranges.

An example of the Link Pack Area Report is shown in the following figure.

PRODUCED BY CMF ANALYZER (v.r.mm  RSL yymm )                        LINKPACK AREA REPORT                          RPTSEQ    22 PAGE    164
BMC SOFTWARE, INC.                                            XYZ COMPANY                              REPORT DATE: DD MMM YY 13.40
 ACTL 10 JUN YY 09.00.00  10 JUN YY 15.59.59             WORLDWIDE HEADQUARTERS                         SYSTEM ID: SJSE     Z v.rr.n


 BASED ON REC TYPE/# RECS/# SAMPLES/REC HOURS:  240-11/224/24.9K/6.99  240-16/5/0/0
 -----------------------------------------------------  PERFORMANCE STATISTICS  ----------------------------------------------------
  MODULE COUNT:     PLPA    FLPA      MLPA       CSA                              THRESHOLD RANK
     BELOW 16M     (339)     (0)       (1)      (24)                                          (0)
     ABOVE 16M     (873)     (2)       (6)      (36)

 ---------------------------------------------  LINKPACK AREA MODULE MAPPING SECTION  ---------------------------------------------
     ACTION  BUSY  MODULE  MODULE    PAGE      ACTION  BUSY  MODULE  MODULE    PAGE      ACTION  BUSY  MODULE  MODULE    PAGE
      FLAG   RANK   NAME   LENGTH   ADDRESS     FLAG   RANK   NAME   LENGTH   ADDRESS     FLAG   RANK   NAME   LENGTH   ADDRESS
                0 ISPKEY     1C68   54FE000               0 FLMXI     731C0   54D5000               0 FLMXI     731C0   54A6000
                0 IKJIFR00    C90   54FD000               0 FLMXI     731C0   54D4000               0 FLMXI     731C0   54A5000
                0 ISPISM     2358   54FD000               0 FLMXI     731C0   54D3000               0 FLMXI     731C0   54A4000
                0 ISPISM     2358   54FC000               0 FLMXI     731C0   54D2000               0 FLMXI     731C0   54A3000
                0 ISPISM     2358   54FB000               0 FLMXI     731C0   54D1000               0 FLMXI     731C0   54A2000
                0 IEAETEQ     428   54FA000               0 FLMXI     731C0   54D0000               0 FLMXI     731C0   54A1000
                0 ISPDTWIN   4BD8   54FA000               0 FLMXI     731C0   54CF000               0 FLMXI     731C0   54A0000
                0 ISPDTWIN   4BD8   54F9000               0 FLMXI     731C0   54CE000               0 FLMXI     731C0   549F000
                0 ISPDTWIN   4BD8   54F8000               0 FLMXI     731C0   54CD000               0 FLMXI     731C0   549E000
                0 ISPDTWIN   4BD8   54F7000               0 FLMXI     731C0   54CC000               0 FLMXI     731C0   549D000
                0 ISPDTWIN   4BD8   54F6000               0 FLMXI     731C0   54CB000               0 FLMXI     731C0   549C000
                0 IGWAMCS3    9D8   54F5000               0 FLMXI     731C0   54CA000               0 FLMXI     731C0   549B000

 -----------------------  PORTION OF LINKPACK AREAS SELECTED FOR POTENTIAL SUBSTITUTION INTO THE PACKLIST  -----------------------
                                           (MODULES WHOSE RANK EXCEED THE THRESHOLD RANK)
     MODULE    MODULE     BUSY         MODULE    MODULE     BUSY         MODULE    MODULE     BUSY         MODULE    MODULE     BUSY
      NAME     LENGTH     RANK          NAME     LENGTH     RANK          NAME     LENGTH     RANK          NAME     LENGTH     RANK
    ECNDLL     462C48       34        ACYAPCNP     7260        3        IKJEFT04     AFA8        2        IGC0002F     4120        1
    CSVEXPR      73F0       20        BPXINLPA    8E338        3        IKTLTERM     17D0        2        IGC00020     F510        1
    EUVPDLL    8CA658       18        EUVFDLL     F1638        3        IRRMNGR     26FA0        2        IGC00030     1008        1
    IEFW21SD    965D0       17        IGC0003E     B518        3        ISGLRELS     11D8        2        IGC0005E    135C8        1
    PSCLBSXP    1CF80       17        IGFDI0       A150        3        ISRPLEX      E748        2        IGC0009C     77E8        1
    ISPSUBS     DC8B0       14        IGG019BO      3A0        3        ISRPX        A0F8        2        IGG019BB      740        1
    IEFJRASP     1830       13        IGWBBMF1    641D0        3        IWMI2LPA    19750        2        IGG019FL      370        1
 -----------------------------------------  MLPA MODULES BY TIME IN USE  -------------------------------------------------------
  % MLPA   MODULE    MODULE     LOAD     PAGE    FRAME  % MLPA      % MLPA   MODULE    MODULE     LOAD     PAGE    FRAME   % MLPA
 ACTIVITY   NAME     LENGTH    ADDRESS  FIXED    USAGE   PAGE       ACTIVITY  NAME     LENGTH    ADDRESS  FIXED    USAGE    PAGE
                                         PCT            FAULTS                                             PCT             FAULTS
 100.00   XDC31      48B60    5BEEB18    0.0      4.0    0.0
 -----------------------------------------  PLPA MODULES BY TIME IN USE  -------------------------------------------------------
  % PLPA   MODULE    MODULE     LOAD     PAGE    FRAME  % PLPA      % PLPA   MODULE    MODULE     LOAD     PAGE    FRAME   % PLPA
 ACTIVITY   NAME     LENGTH    ADDRESS  FIXED    USAGE   PAGE       ACTIVITY  NAME     LENGTH    ADDRESS  FIXED    USAGE    PAGE
                                         PCT            FAULTS                                             PCT             FAULTS
   8.21   ECNDLL    462C48    2B5C000    0.0      7.0   16.7         0.72   IXGINLPA   E66E0    4CDA000    0.0      3.0    1.5
   4.83   CSVEXPR     73F0    2AE7000    0.0      1.0    0.0         0.48   EAGRTLIB   42508    5AF9000    0.0      1.0    0.0
   4.35   EUVPDLL   8CA658    30CE000    0.0     15.0    8.8         0.48   GDEIGCS    28980    3D5E000    0.0      2.0    1.0
   4.11   IEFW21SD   965D0    4141000    0.0     13.0    1.5         0.48   ICEMAN     11200     C7B000    0.0      2.0    1.0
   4.11   PSCLBSXP   1CF80     C4B000    0.0      1.0    8.3         0.48   IDA0192A   6F070    3F5D000    0.0      1.0    1.0
   3.38   ISPSUBS    DC8B0    564B000    0.0     12.0    1.5         0.48   IEEMB887    1C70    4081000    0.0      1.0    1.0
   3.14   IEFJRASP    1830    410C000    0.0      1.0    0.0         0.48   IEWLDR00   1F7D8    436B000    0.0      2.0    0.0

If an action flag (shown as ****) is displayed in this report, it might not require action. Sometimes the system automatically assigns smaller modules to whatever space is available in the PLPA page. In such situations, it might not be possible or desirable to make changes.

In the PLPA Modules by Time in Use section, the PAGE FIXED PCT value is calculated as

# of times at least one page was fixed for a module / # of times the module was active

In this same section, the PERCENT PAGE FAULTS value is calculated as

page fault observations for the module in LPA / page fault observations for all modules in LPA

Link Pack Area Report field descriptions

The table below describes each field in Link Pack Area Report.

Field

Description

MODULE COUNT

number of modules in PLPA, FLPA, MLPA, or CSA

PAGE FIXED PCT

this field is blank

THRESHOLD RANK

user-supplied value with two functions:

  • to determine the level of activity a module must reach before being included in the substitution section
  • to describe the allowable tolerance of differences in the busy ranks of modules in the same page

ACTION FLAG

four asterisks (****) are printed whenever a busy rank for a module sharing a page with another module has a difference greater than the user-supplied threshold value

BUSY RANK

number of references to a module

MODULE NAME

name of the link pack area module

MODULE LENGTH

length of the link pack area module in bytes

PAGE ADDRESS

hexadecimal address of the page that this module occupies in the link pack area

% MLPA ACTIVITY

percentage of MLPA activity that was caused by this module

LOAD ADDRESS

load address of this module

PAGE FIXED PCT

percentage of times (frequency) that this module was observed in fixed pages

FRAME USAGE

number of pages in the module where BUSY RANK was greater than zero

% MLPA PAGE FAULTS

percentage of MLPA page faults caused by this module

% PLPA ACTIVITY

percentage of PLPA activity that was caused by this module

% PLPA PAGE FAULTS

percentage of PLPA page faults that were caused by this module

% FLPA ACTIVITY

percentage of FLPA activity that was caused by this module

% FLPA PAGE FAULTS

percentage of FLPA page faults that were caused by this module



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*