HP 3000 Manuals

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