HP 3000 Manuals HP 3000 Manuals
FINDPMAPNAME
Searches the FPMAP in a program or SL file for a segment name or an entry
point name.
SYNTAX
IV BA BA IA V I
FINDPMAPNAME (progfnum,segname,entname,xpmaprec,xmapreclen,status);
FUNCTIONAL RETURN
This intrinsic returns the external FPMAP record specified. If unable to
find the segment or entry point specified, the intrinsic returns a status
code that indicates why the search failed.
PARAMETERS
progfnum integer value
The number of the program or SL file whose FPMAP is
searched, as returned from the FOPEN intrinsic. The
caller must have MULTI-RECORD and READ access to open
the file.
segname byte array
Optional. The name of the segment to be found.
Terminate with a blank. If the first character of
segname is blank, segname is omitted from the calling
sequence. A maximum of 15 characters can be specified
for the search. All characters will be upshifted.
entname byte array
Optional. The name of the procedure or secondary entry
point to be found. Terminate with a blank. If the
first character of entname is blank, entname is omitted
from the calling sequence. A maximum of 15 characters
can be specified for the search. All characters will be
upshifted.
xpmaprec integer array
The external FPMAP record corresponding to the entry
point passed in entname. The format of the record is
defined in figure 3-1. The record returned may be a
segment, a procedure, or a secondary entry point
(depending upon segname and entname specified).
xpmapreclen 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 was successful and, if not, why.
CONDITION CODES
Error No. Meaning
CCE 0 No errors detected.
CCG 1 Entry point name not located.
2 Address to be located outside the bounds of segment
specified.
3 Program/SL file did not contain segment specified, or,
the SL segment requested was marked as deleted.
4 External PMAP file was too small.
CCL 9 Option variable parameter list was illegal.
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 intrinsics.
12 File system error on the program/SL file.
13 File system error on the external PMAP file.
14 Internal PMAP file improperly FOPENed.
15 Bad internal PMAP.