Library Utility panel

Field Descriptions

OPTION

Enter one of the following option codes in the OPTION field on the Library Utility screen and a library name.

A

Map CSECTs in address order. Displays a map of load module control sections (CSECTs) in address order.

N

Map CSECTs in name order. Displays a map of load module CSECTs in name order.

I

Display directory entry of member. Displays the directory entry and link-edit attributes of a specified member.

BLANK

Display member list. Displays a list of the specified library members. Use the Library option codes (A, N, S, B, D, R) as line commands on this Member List screen to execute the Library utility options.

B

Browse member. Use to browse a specified member. This option can be used to browse a member instead of going to the Browse function.

D

Delete member. Used to delete a specified member.

R

Rename member. Used to rename a specified member.

C

Display CLASS list. Valid only for PDSE Program Objects. Displays a list of the heading information for the selected load module followed by a list of all PDSE Binder Classes. The list contains details of the main characteristics for each class. The following characteristics are displayed for each class:

• 
  
  • Name
  • Segment ID
  • Offset
  • Length
  • Load Attributes
  • Binding Method
  • Alignment
  • RMODE

The address-sequence and name-sequence mapping options (A and N) show all linked components of a load module along with compiler name, compile dates, and applied zaps. Optionally, you can list the compiler options for load modules that have CSECTs compiled with 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. The displayed information is identical except for the sequence of the listing. Option A displays CSECTs in sequence by address. This format indicates any segment overlays that are present in the module.

Option N displays information in sequence by symbol name (the CSECT or entry point name). A particular symbol can be quickly found with this format. The screen format for options A and N is identical.

All Library options except A, N and C process any type of library. Both options A and N only display information about the linked components of a load module. Option C is valid only for PDSE Program Objects.

Dataset name

Specify the dataset or path name. Use the naming conventions described in Specifying a dataset name and Specifying a zFS Pathname.

You can enter a pattern dataset or path name in this field to display a list of data sets from which you can make a selection. A pattern dataset name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern data set names for a complete description.

Enter the FILELIST primary command or blank out the Dataset name field to display the Last Referenced File List. For more information, see Last Referenced File List.

Member name

Specify the member name.

You can leave this field blank to display a member list from which you can make a selection. On the member list, Library options A, N, C, I, D, R, and B can be entered as line commands.

A pattern member name is not a valid entry in this field.

New name

Specify the member’s new name for option R - Rename member.

Volume serial

Specify the volume serial of the direct access device that contains the data set. Specify a volume if the data set is not cataloged.

Disposition

Specify a value in this field to update link-edit attributes. Use a disposition value of SHR to have File-AID display the link-edit attributes on the directory entry screen. A value of OLD allows some of the link-edit attribute values to be modified on the directory entry display screen (option I).

Process Option

Specify whether to process your Library utility request O (Online) or B (Batch). Batch processing is valid only for load library processing Options A, N, I, or C.

Printing member lists

When option blank is used to display a member list, use the P or PRINT (Print) primary command to print the member lists. The P command calls the File-AID print facility to write the list to SYSOUT. SYSOUT is then released for printing. The print facility displays a prompt screen of print values that you can modify, as shown in Print Parameters Screen.

PDS Processing Options

When you specify a PDS or PDSE without specifying a member name, File-AID displays a PDS Processing Options screen for non-load libraries and a Load Library Processing Options screen for load libraries. See PDS Processing Options and Load Library Processing Options in the next section.

Load Library Processing Options

File-AID displays the Load Library Processing Options Screen, shown in the following figure, to enable you to tailor the member list.

Load Library Processing Options Screen

Field Descriptions

See PDS Processing Options for a description of Member name mask and Member name range.

Member Rmode

Residency mode of the CSECT. Valid entries are 24 or ANY.

Member Amode

Addressing mode of the CSECT. Valid entries are 24, 31, 64 or ANY.

Member Link Date

This field is displayed only for the "B" batch processing option. Specify a link edit date in the format CCYY/MM/DD. The Display member selection list option must be set to N (No) to use this Link Date filter.

Display member selection list

Specify Y (Yes) or N (No). This field controls the display of the member S/X (select/exclude) list after PDS processing options are applied. Specify Y (Yes) to display the list. For non-load libraries, this option is automatically set to Yes and is not displayed.

Include Compiler Options

Specify Y (Yes) or N (No). This field only appears for Batch processing mode (see Process Option) for Options A and N, and controls whether compiler options for load modules that have CSECTs compiled with 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 will be included in the report.

Create a CSV file

Specify Y (Yes) or N (No). This field only appears for Batch processing mode (see Process Option) for Options A, N, C, and I. It controls whether the report will also be output to a CSV (Comma Separated Values) file type in addition to the SYSLIST file. When you specify Y, the CSV Dataset Specification panel displays (CSV Dataset Specification).

CSV Dataset Specification

When Create a CSV file is set to Y, the CSV Dataset Specification panel displays (see the following figure) where you specify the dataset name for the CSV file to be used by File-AID/Batch as an additional output for the report.

CSV Dataset Specification

Field Descriptions

Dataset name

Specify the dataset name for the CSV file to be used by File-AID/Batch as an additional output for the report. Use the naming conventions described in Specifying a dataset name.

You can enter a pattern dataset or path name in this field to display a list of data sets from which you can make a selection. A pattern dataset name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern data set names for a complete description.

Enter the FILELIST primary command or blank out the Dataset name field to display the Last Referenced File List. For more information, see Last Referenced File List.

Volume serial

Specify the volume serial of the direct access device that contains the data set. Specify a volume if the data set is not cataloged.

Disposition

Specify OLD for an existing data set or NEW for a non-existing data set. When NEW, File-AID will allocate a new file after you provide the allocation values in the Allocate New Dataset screen (see Allocate new dataset screen).

The CSV file must be a sequential, variable data set with a minimum record length of 2769.

Sample CSV Output

The following figure shows a sample CSV output with compiler options. Each field is enclosed in double quotes (") and separated by a comma (,). The header line includes the field/column names for directory entry and link-edit attributes, load module name, CSECT name, the corresponding items listed under Map Columns, as well as CMPLOPTS for the compiler options, if selected. Scroll to the right to see the remaining listing of the compiler options, corresponding to the online display (Sample COBOL Compiler Options).

Sample CSV Output for Options A or N with Compiler Options (truncated)

The following figure shows a sample CSV output for Option I, directory entry and link-edit attributes of selected member(s). Each field is enclosed in double quotes (") and separated by a comma (,). The header line includes the field/column names corresponding to the online display as shown in Directory Information Screen. Scroll to the right to see the remaining listing of the link edit attributes. Refer to Display Member Directory Entry (I) for the description of the fields/columns.

Sample CSV Output for Option I (truncated)

The following figure shows a sample CSV output for Option C, listing all PDSE Binder Classes of selected member(s). Each field is enclosed in double quotes (") and separated by a comma (,). The header line includes the field/column names corresponding to the online display as shown in Library Utility CLASS List Screen. Scroll to the right to see the remaining listing of the link edit attributes. Refer to CLASS List (C) for the description of the fields/columns.

Sample CSV Output for Option C (truncated)