MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 7 401
Command Definitions (HP32208-HPLOACNMPROC)
HPGETPROCPLABEL
HPGETPROCPLABEL
NM callable only.
Dynamically loads a native mode (NM) executable library procedure.
Syntax
CA U32 I32 CA
HPGETPROCPLABEL(
procname,plabel , status,firstfile,
B
casesensitive );
Parameters
procname character array (required)
Passes the name of the procedure being searched for. The first character of
procname designates the terminating character that HPGETPROCPLABEL
uses to search for the end of the name. That delimiter can appear again
only following the last valid character of the procedure name.
plabel 32-bit unsigned integer by reference (required)
Returns a procedure label (NM plabel) for the procedure that was found.
status 32-bit signed integer by reference (optional)
Returns the status of the HPGETPROCPLABEL intrinsic call. If no errors or
warnings are encountered,
status returns 32 bits of zero. If errors or
warnings are encountered,
status is interpreted as two 16-bit fields.
Bits (0:16) comprise
status.info . A negative value indicates an error
condition, a positive value indicates a warning condition. Refer to the
MPE/iX Error Message Manual Volumes 1, 2 and 3 for a description of its
value.
Bits (16:16) comprise
status.subsys . The value represented by these bits
defines the subsystem that set the status information. The subsystem
identifier for HPGETPROCPLABEL is 104.
firstfile character array (optional)
Passes the name of the program file or XL at which to begin searching. The
firstfile parameter can be either in MPE syntax or HFS syntax. If the
name of the program file or XL is in HFS syntax, you must use an absolute
pathname. The first character that HPGETPROCPLABEL uses to search for
the end of the file name. That delimiter can appear again only following
the last valid character of the name.
If
firstfile is located in the binding sequence of the calling process,
then, beginning with
firstfile , HPGETPROCPLABEL directs the NM loader
to search through each file in the binding sequence for the first instance of