HP 3000 Manuals

Introduction to MPE XL for MPE V Programmers Migration Guide

HPGETPROCPLABEL (NM) 
(new) 

The HPGETPROCPLABEL intrinsic locates a procedure found in an NM
executable library file (XL) and returns its procedure label (plabel).
In addition, if the procedure is not yet loaded for the process,
HPGETPROCPLABEL dynamically loads the procedure.

You can then use the NM plabel to dynamically call the specified
procedure, provided the programming language contains features for making
dynamic procedure calls.

A plabel returned by HPGETPROCPLABEL is valid only for the duration of
the calling process.

Two parameters are required:  the process name, a character array, and
the plabel, a 32-bit unsigned integer passed by reference.

The status parameter, a 32-bit signed integer passed by reference, is
optional but recommended.  It indicates status in two fields.  One
reports the presence of errors and warnings, and the other indicates
their source.  If an error or warning condition is encountered, and you
did not specify the status parameter, HPGETPROCPLABEL causes the calling
process to abort.  Using the status parameter in MPE XL is analogous to
using the condition codes and the PRINTFILEINFO intrinsic in MPE V/E.

You can use an optional parameter to passes the name of the program file
or XL at which to begin searching.  Another optional parameter indicates
whether you want the process name parameter to be case-sensitive.

MPE/iX 5.0 Documentation