HP 3000 Manuals

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