Edited Format

The edited format of a partitioned data set directory is meant to be used with module libraries. Most of the information given in an edited listing is meaningful only for load modules.

If you request an edited listing of a partitioned data set or PDSE whose members are not load modules, you will get an edited listing. In that case, the listing will contain information about your data set that will not necessarily be correct. Only request an edited listing of a data set whose members are load modules.

When you request an edited format of a module library, IEHLIST provides the following information:

Member name
Entry point
Relative address of start of member
Relative address of start of text
Contiguous virtual storage requirements
Length of first block of text
Origin of first block of text
System status indicators
Linkage editor attributes
APF authorization required
Other information.

Figure 1 shows an edited entry for a partitioned member, LOADMOD. The entry is shown as it is listed by the IEHLIST program. Please note, however, that this figure is only an example of a listing of a partitioned data set or PDSE directory. Your actual edited listing produced by the IEHLIST program may differ.

Figure 1. Sample of an Edited Partitioned Directory Entry

                                                  OTHER INFORMATION INDEX
SCATTER FORMAT  SCRT=SCATTER/TRANSLATION TABLE TTR IN HEX, LEN OF SCTR LIST IN DEC, LEN OF TRANS TABLE IN DEC,
                     ESDID OF FIRST TEXT RCD IN DEC, ESDID OF CSECT CONTAINING ENTRY POINT IN DEC
 
OVERLAY FORMAT  ONLY=NOTE LIST RCD TTR IN HEX, NUMBER OF ENTRIES IN NOTE LIST RCD IN DEC
 
ALIAS NAMES    ALIAS MEMBER NAMES WILL BE FOLLOWED BY AN ASTERISK IN THE PDS FORMAT LISTING
 
                                                     ATTRIBUTE INDEX
 
BIT   ON      OFF         BIT    ON       OFF         BIT    ON       OFF         BIT   ON          OFF
 
 0    RENT    NOT RENT     4     OL       NOT OL       8     NOT DC      DC          12    NOT EDIT    EDIT
 1    REUS    NOT REUS     5     SCTR     BLOCK        9     ZERO ORG    NOT ZERO    13    SYMS        NO SYMS
 2    ONLY    NOT ONLY     6     EXEC     NOT EXEC     10    EP ZERO     NOT ZERO    14    F LEVEL     E LEVEL
 3    TEST    TEST         7     1 TXT    MULTI RCD    11    NO RLD      RLD         15    REFR        NOT REFR
 
MEMBER    ENTRY    ATTR    REL    ADDR-HEX    CONTIG    LEN  1ST    ORG  1ST    SST    VS    AUTH    OTHER
NAME      PT-HEX   HEX     BEGIN  1ST TXT     STOR-DEC  TXT-DEC     TXT-HEX     INFO   ATTR  REQ     REQ INFORMATION
 
LOADMOD   000000   06E2    000004 00020F      000166248 0927                   ABSENT 880000 NO     SCTR=000000
                                                                                                    00484,01084,32,32
 
OF THE 00002 DIRECTORY BLOCKS ALLOCATED TO THIS PDS, 00001 ARE(IS) COMPLETELY UNUSED

Before printing the directory entries on the first page, an index is printed explaining the asterisk (*), if any, following a member name, the attributes (fields 3 and 10), and other information (field 12). Under OTHER INFORMATION INDEX, scatter and overlay format data is described positionally as it appears in the listing; under the ATTRIBUTE INDEX, the meaning of each attribute bit is explained. There is no index for the VS ATTR field. The data displayed in this field is from the PDS2FTBO field in the PDS directory.

Each directory entry occupies one printed line, except when the member name is an alias and the main member name and associated entry point appear in the user data field. When this occurs, two lines are used and every alias is followed by an asterisk. If the main member is renamed, the old member name will still be in the alias directory entry and consequently printed on the second line.