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