 |
» |
|
|
|
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 (32650-90066, 32650-90152, and 32650-90368) 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
a procedure named procname. If either procname is not located in the XL
or procname contains unresolved external references
that must be satisfied in subsequent XLs, then each XL in
the binding sequence after firstfile is searched. If firstfile is not located in the binding sequence,
then firstfile has a binding sequence independent of
the program and is bound directly to the system libraries. Any
unresolved external references found within firstfile
must be resolved in the system libraries. Default: System libraries
- casesensitive
Boolean (optional) Indicates in the following manner whether the procname parameter
is case sensitive:
- FALSE
HPGETPROCPLABEL first tries finding procname as it
was specified. If procname cannot be
found, HPGETPROCPLABEL tries to find the procedure
with the case of procname the opposite case of
the first character of procname for
example, if you specify procname as scanforkey and
the procedure scanforkey is not found, the intrinsic searches
for the procedure SCANFORKEY. Default: FALSE - TRUE
The procname parameter is case-sensitive.
HPGETPROCPLABEL does not alter the name in any way.
Related Information | |
- Intrinsics
None - Commands
None - Manuals
Resource Management Programmer's Guide (32650-90024).
|
