HPLOADNM PROC Intrinsic [ Switch Programming User's Guide ] MPE/iX 5.0 Documentation
Switch Programming User's Guide
HPLOADNM PROC Intrinsic
The HPLOADNMPROC intrinsic returns the plabel of an NM procedure.
You call this intrinsic to obtain the NM plabel of the target procedure.
This plabel is then used by the HPSWTONMPLABEL intrinsic as the value of
its proc parameter.
Syntax
Prior to calling HPLOADNMPROC, your programming language may require you
to declare it. In Pascal/V, the declaration is as follows:
FUNCTION HPLOADNMPROC : INTEGER; INTRINSIC;
Next, an example of a Pascal/V call to HPLOADNMPROC:
plabel := HPLOADNMPROC (procname, proclen, libname,
liblen);
You call the HPLOADNMPROC with four parameters. These parameters supply
the following information:
* Name of the NM target procedure
* Length of the name of the NM target procedure
* Name of the library to be searched for the NM target procedure
* Length of the name of the library to be searched
CAUTION The strings you supply as values of the procname and libname
parameters must exactly match the names of the target NM routine
and its NM library, respectively.
Parameters
A detailed explanation of the parameters of the HPLOADNMPROC intrinsic
follows.
Required parameters are shown in boldface; optional parameters are shown
in italics.
procname byte array by reference (required)
Passes the target procedure name. The target procedure
must be contained in an Executable Library. If the
value of procname is invalid, blank, or does not contain
your NM procedure, NL.PUB.SYS is searched.
proclen 16-bit signed integer by value (required)
Passes the byte length of the procedure name.
libname byte array by reference (required)
Passes the name of the NM library to be searched for the
target. If the value of libnameis invalid, blank or
does not contain your NM procedure, NL.PUB.SYS is
searched.
liblen 16-bit signed integer by value (required)
Passes the byte length of the library name.
MPE/iX 5.0 Documentation