Modules

The Modules page displays the activity of each load module that is located in the target address space.

From the Modules page, you can display the details of the module and CSECTs, or open a page that suggests a linkage order for reducing the system paging. Only load module entries and CSECTs with detected activity are listed.

Menu commands available in this view include:

Contents:

Module Columns

The Module pages contains the following columns:

  • Module
    The name of the load module. The load module is a collection of Csects that were linked together.

  • Csect
    The names of the Csects within each load module. A Csect is a unique object created by a compiler or linked from a subroutine library. If Csect name is blank, this is the entry for the load module.
    This name may be the name of a pseudo Csect created by the linkage editor and compiler. Other than the Csect name, several different values maybe displayed:

    Symbol

    Description

    $$BLANKC

    A common section

    $ENTAB

    An entry table

    $PVTnnnn

    A section of private code

    $SEGTAB

    A segment table

  • Offset
    This field displays one of two values:

    • Csect
      Displays the hexadecimal offset from the beginning of the Csect

    • Module
      Displays the load address of the module

  • Length
    Depending on the type of entry, this field displays one of two values:

    • Csect
      Displays the hexadecimal length of the Csect

    • Module
      Displays the hexadecimal length of the load module

  • Csect Description
    A description of the function performed by the selected Csect. CA MAT provides an Associations table with the descriptions for many Csects. If this field is blank, a description for this Csect is not currently available.

  • L
    Location of the module in virtual memory.
    The B symbol indicates the module resides below the 16 MB line.
    The A symbol indicates the module resides above the 16 MB line.

  • Pct
    The percentage of the monitored period that CA MAT detected this Csect was in use.

  • Entry Type
    The type of name presented in the Module/Csect columns.
    This name may be the name of a pseudo Csect created by the linkage editor and compiler. This entry may be one of several types:

    Symbol

    Description

    CM

    A common code section

    ER

    A strong external reference

    LL

    A load module entry versus an esd entry

    LR

    A label reference

    NU

    A null entry

    PC

    Private code section

    PR

    Pseudo Register

    SD

    A code section

    WX

    Weak external reference

  • Date Stamp
    Depending on the type of entry,this field displays one of two values:

    • Csect
      The date that the translator (compiler) created this object

    • Module
      The data that the linker/binder created this load module

  • Processor ID
    Depending on the type of entry this field displays one of two values:

    • Csect
      The component identifier of the translator (compiler) that created this object

    • Module
      The component identifier of the linkage editor that assembled the load module

  • Processor Version
    Depending on the type of entry, this field displays one of two values:

    • Csect
      The component release of the translator (compiler) that created this object

    • Module
      Blank

  • AMODE
    References the address length a program is prepared to handle upon entry. The valid addressing modes are the following:

    • 24-Indicates 24-bit addressing is in effect

    • 31-Indicates 31-bit addressing is in effect

    • ANY-Indicates either 24-bit or 31-bit addressing may be in effect

    The loader determines the addressing mode for the entry point as follows:

    • The default AMODE of 24 is assumed. If AMODE is specified in the ESD data for the entry point, that specification replaces the default, AMODE. (This AMODE value was specified as an assembler statement.) The loader assigns the AMODE value from the control section or private code that contributes to the loaded module, ignoring identically named control sections and private code, which are replaced.

    • If AMODE is specified as a parameter in the PARM field of the EXEC statement, that specification replaces the previously determined AMODE.

  • RMODE
    Specifies where the module is to be loaded in virtual storage. The valid residence modes are as follows:

    • 24-Indicates the module must be loaded within 24-bit addressable virtual storage (below the 16-megabyte virtual storage line).

    • Any-Indicates the module may be loaded anywhere in virtual storage (either above or below the 16-megabyte virtual storage line).

    The loader determines the residence mode for the loaded program as follows:

    • The default RMODE of 24 is assumed.

    • If the RMODE is specified in the ESD data for the first control section or private code which contributes to the loaded module, that specification replaces the default RMODE. (This RMODE value was specified by you as an assembler statement.)

    • If the RMODE is specified as a parameter in the PARM field of the EXEC statement, that specification replaces the previously determined RMODE.

    • If the RMODE is specified as a parameter in the PARM field of the EXEC statement, that specification replaces the previously determined RMODE.

    • If the ESD data for any subsequent control section or private code which contributes to the loaded module specifies an RMODE of 24, the RMODE for the entire module is reset to 24. If loading begins above the 16-megabyte virtual storage line on the basis of an early determination of RMODE=ANY, and the RMODE is later reset to 24, an error message is issued and loading is restarted below the 16-megabyte virtual storage line.

  • R N
    Rent. Displays whether the module is link-edited with the reentrant option. If a module is reentrant, it may be loaded into memory once and used by multiple routines.

  • R U
    Reus. Displays whether the module is link-edited with the reusable option. If a module is reusable, it may be loaded into memory once and serially used more than one time.

  • O V
    Overlay. Displays whether the module is link-edited in overlay format.

  • L D
    Loadable Only. Displays if the module is loadable only.

  • E X
    Executable. Displays whether the module is executable.

  • Data Set
    Displays the data set from which the module was loaded.

Listing

The Listing subpage shows the compile listing of a CSECT that has been registered in CA Mainframe Application Tuner.

When you invoke the Listing subpage from a particular statement, that statement is highlighted in the listing.

Module/CSECT Information

The Module/CSECT Info subpage displays information such as size, location, and link date for a load module selected in the one of the other pages.