FINDPMAPADDR [ MPE Segmenter Reference Manual ] MPE/iX 5.0 Documentation
MPE Segmenter Reference Manual
FINDPMAPADDR
Searches the FPMAP in a program or SL file for a specific address in a
particular segment. An external FPMAP record corresponding to the
nearest entry point at or preceding address is returned. The caller must
have MULTI-RECORD READ access to open the file.
SYNTAX
IV IV IV V IV I
FINDPMAPADDR (progfnum,segnum,address,xpmaprec,xpmapreclen,status);
PARAMETERS
progfnum integer value
The number of the program or SL file of the FPMAP to be
searched, as returned from the FOPEN intrinsic. Caller
is responsible for opening the file with MULTI-RECORD
READ access.
segnum integer value
The number of the logical segment in which the address
is to be found.
address integer value
The PB-relative address in segment segnum with which the
external FPMAP record returned is associated.
xpmaprec value
The external FPMAP record corresponding to the first
entry point at or preceding address. If the entry point
located has more than one name, the first one
encountered in the FPMAP will be returned.
xpmapreclen integer value
The number of words of the external FPMAP record
returned in xpmaprec. If the call requests more words
than are currently defined for an external FPMAP record,
zeros are returned in the extra words.
status integer
A word that contains a Condition Code that tells if the
procedure call was successful and, if not, why.
CONDITION CODES
Error No. Status
CCE 0 The address was valid and an external FPMAP record was
returned.
CCG 2 The address was out of range.
3 The logical segment segnum did not exist.
CCL 10 The file progfnum did not contain FPMAP data.
11 The file progfnum was not a program of SL file.
12 A file system I/O error occurred on file progfnum.
MPE/iX 5.0 Documentation