MAPDNTRY (Map Directory Entry) Macro

The MAPDNTRY macro generates a mapping DSECT, which can be used to interpret the information that is returned by the LOAD or FETCH macro, if DE=VSE or DE=YES is specified.

Format

Read syntax diagramSkip visual syntax diagramMAPDNTRY DE=VSEYES

Requirements for the caller

RMODE:
ANY

Parameters

DE=VSE | YES
DE=VSE specifies the directory entry that is returned, if DE=VSE was specified in the LOAD or FETCH macro. For the layout and a description of the DSECT fields, see Table 1.

DE=YES specifies the directory entry that is returned, if DE=YES was specified in the LOAD or FETCH macro. Table 2 describes the mapping and contents of the DSECT fields.

Mapping

Table 1. Mapping of the MAPDNTRY-Generated DSECT for DE=VSE
Field Name No. of Bytes Contents
DIRNAME 8 Phase name
DIRIDVSE 3 VSE-ID (X'FFFFFF')
DIRN 1 Number of halfwords following
DIRLMBR 4 Length of library member (phase)
DIRC 1 Flags:
SELFREL     X'80' phase is self-relocatable
RELPHASE     X'40' phase is relocatable
SVAELIG     X'20' phase is SVA-eligible
SVAPHASE     X'10' phase is located in SVA
PCIL     X'08' non-SYSLIB phase
NOTFND     X'04' phase not found
ACTIVE     X'02' directory entry active
DIRSWIT 1 Flags:
DIRRMOD     X'20'   1: RMODE=ANY, 0: RMODE=24
DIRAM31     X'10'   1: AMODE=31 or AMODE=ANY
DIRAM24     X'08'   1: AMODE=24 or AMODE=ANY
             11: AMODE=ANY, 10: AMODE=31
             00 or 01: AMODE=24
  2 Reserved
DIRACOPY 4 Address of directory copy
DIRALPT 4 Load point at link-edit time
DIRAEPT 4 Entry point at link-edit time
DIRAPART 4 Partition start at link-edit time
DIRASVA 4 Entry point of phase in SVA
Table 2. Mapping of the MAPDNTRY-Generated DSECT for DE=YES
Field Name No. of Bytes Contents
DIRNAME 8 Phase name
DIRCOPY 3 Address of directory copy
DIRN 1 Number of halfwords following
DIRTT 2 Number of text blocks
DIRLL 2 Number of text bytes in last block
DIRC 1 Flags:
SELFREL     X'80' phase is self-relocatable
RELPHASE     X'40' phase is relocatable
SVAELIG     X'20' phase is SVA-eligible
SVAPHASE     X'10' phase is located in SVA
PCIL     X'08' non-SYSLIB phase
NOTFND     X'04' phase not found
ACTIVE     X'02' directory entry active
DIRSWIT 1 Flags:
DIRRMOD     X'20'   1: RMODE=ANY, 0: RMODE=24
DIRAM31     X'10'   1: AMODE=31 or AMODE=ANY
DIRAM24     X'08'   1: AMODE=24 or AMODE=ANY
             11: AMODE=ANY, 10: AMODE=31
             00 or 01: AMODE=24
DIRPPP 3 Load point at link-edit time
DIREEE 3 Entry point at link-edit time
  3 Reserved
DIRAAA 3 Partition start at link-edit time
DIRVEE 4 Entry point of phase in SVA
  4 Reserved