HP 3000 Manuals

DUMPPMAP [ MPE Segmenter Reference Manual ] MPE/iX 5.0 Documentation


MPE Segmenter Reference Manual

DUMPPMAP 

Fills a file with external FPMAP records representing either all of the
FPMAP data stored in a program or SL file, or only that for a specified
segment.  One external record is created as each FPMAP record is
encountered.

SYNTAX 

                 IV        IV        IV        I       IV     I
     DUMPPMAP (progfnum,pmapfnum,xpmapreclen,reccount,segnum,status);

PARAMETERS 

progfnum         integer value 

                 The number of the program or SL file whose FPMAP is to
                 be dumped, as returned from the FOPEN intrinsic.  The
                 caller is responsible for opening the file with
                 MULTIRECORD, READ access.

pmapfnum         integer value 

                 The number of the file that is to contain the external
                 FPMAP records, as returned from the FOPEN intrinsic.
                 The caller is responsible for opening the file with
                 write access and records of size at least xmapreclen 
                 words.

xpmapreclen      integer value 

                 The number of words in each external FPMAP record to be
                 written to file pmapfnum.  If the caller requests more
                 words than are currently defined for an external FPMAP
                 record, the extra words in each record written are set
                 to zero.

reccount         integer 

                 The number of external FPMAP records which were (or
                 could have been) generated from the FPMAP data found in
                 the program or SL file.  If the caller's pmapfnum file
                 is large enough, it is also the number of records
                 written to that file.

segnum           integer value 

                 The number of the segment whose FPMAP data is to be
                 dumped.  When segnum is -1, all FPMAP records for all
                 segments in the file are dumped.

status           integer 

                 A word that contains a Condition Code that tells you if
                 the procedure call was successful and, if not, why it
                 failed.

CONDITION CODES 

                    Error No.     Meaning

CCE                     0         No errors detected.

CCG                     4         External PMAP file was too small.

CCL                     10        Program/SL file did not contain a PMAP.

                        11        Program/SL file code was not that of a program/SL
                                  file, or, SL loader ID was not compatible with this
                                  version of the PMAP intrinsic.

                        12        File system error on the program/SL file.
                        13        File system error on the external PMAP file.



MPE/iX 5.0 Documentation