Map CSECTS in Address order (A)

The Map CSECTS in address order function (option A) displays the component CSECTs of a load module. The information is displayed in sequence by address within the module. The display also indicates any segment overlays within the module.

On the Library Utility screen, enter an A in the OPTION field, and a valid load library and load module member name. When you press Enter, File-AID displays a Map screen of the load module in address sequence as shown in the following figure.

When File-AID detects long program names in a PDSE load object, it uses a two-line display per SD (Section Definition) or LD (external Label Definition) entry. For readability, SD entries contain the SD name followed by hyphens.

Library Utility Address-Sequence Link Map Screen

On the Link Map screen, the utility option and file information are displayed in lines 1 and 3 of the screen. For a PDSE, File-AID identifies the BINDER version. The map information is organized into columns below the file information. If more lines of information are available than will fit on one screen, scroll down to display additional lines.

Segment overlays are indicated with a horizontal line of asterisks ( *** ) in the CSECT information. The asterisks are displayed at the point that a new segment overlays the address area of the previous segment.

When appropriate, two additional lines, IDENT and ZAP, are displayed within the data area under the ADDR column. They are not associated with other columns of information.

Use the FIND command to locate the line containing any string you specify. You can specify the full or partial CSECT name, compile name, or zap ID. Use the RFIND command to repeat a FIND command and scroll to the next occurrence of the string.

As an option, print the link map using the P (Print) command.

Use the END command (PF3) to terminate the link map display.

Field Descriptions

Line 1

Library utility option and library name. On the right is the number of the first row being displayed and the number of rows in the member.

Line 3

Member name, the date the member was linked, and the utility that processed the link.

Map Columns

Symbol

Name of the CSECT or entry point.

Type

Indicates either a section or label name with one of two codes:

SD

Section definition (CSECT).

LD

Label definition (external label; entry point).

ADDR

Address of this symbol within the load module.

Length

Total length of the CSECT, displayed as a hexadecimal value. This value is only displayed for CSECTs.

Tname 1

Name of the compiler or assembler used to create the object code for the CSECT. Not shown for labels.

Tdate 1

Date that the object module was compiled or assembled.

Tname 2

Name of the precompiler or translator used before compiling/assembling the object code for this CSECT. Not shown for labels.

If the module was processed for DDIO or ESS, Tname2 displays:

• 
  
  • *DDIO* when a DDIO member was generated in a DDIO data set and ESS records were not generated.
  • *DDIO+ESS* when both DDIO member and ESS records were generated.
  • *ESS* when ESS records were generated into the load module and no DDIO member was saved.

For more information on DDIO and ESS, see BMC Compuware Shared Services User/Reference Guide.

Tdate 2

Date of the precompile or translation.

If the module was processed for DDIO or ESS, Tdate2 displays the time (hh:mm:ss) that the DDIO member and/or ESS records were produced.

A/R mode

Addressing and residency modes of this CSECT.

Additional ADDR Column Information

IDENT

Identification record created at link-edit time. If the record is used, it is flagged here as created with the word IDENT, along with a date and identification value.

ZAP

Lists any zaps (module modifications) applied to this CSECT. The word ZAP is displayed as a flag along with the date. If the IDR identification was supplied, it is also displayed.

Line Commands

S (Select) or /

Enter the Select line command (S or /) to display the compiler options used for a CSECT. The S line command (see the following figure) is only valid for a CSECT entry with Type SD and any IBM COBOL compiler (excluding OS/VS COBOL) or any IBM Enterprise PL/I for z/OS and OS/390 compiler starting with Release 3.1.

Sample S Line Command for Compiler Option

Compiler Options

When selecting a CSECT entry with Type SD and any IBM COBOL compiler (excluding OS/VS COBOL) or any IBM Enterprise PL/I for z/OS and OS/390 compiler starting with Release 3.1, File-AID displays the compiler options used as shown in the following figure. Use the compiler options listing as reference when re-compiling COBOL or PL/I modules.

Sample COBOL Compiler Options

Field Descriptions

Module Name

Library utility option and library name. On the right is the number of the first row being displayed and the number of rows in the member.

Link Date

Library utility option and library name. On the right is the number of the first row being displayed and the number of rows in the member.

CSECT NAME

Member name, the date the member was linked, and the utility that processed the link.

Compiler

Member name, the date the member was linked, and the utility that processed the link.

AMODE/RMODE

Member name, the date the member was linked, and the utility that processed the link.

Compiler Options

List of compiler options used when the module was last compiled.