Library Utility screen
The upper area of the screen displays the Library options; the lower area is used to specify data set characteristics.
Library Utility screen
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.
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, the member lists can be printed by using the P (Print) primary command. 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 can be modified, 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.
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)
