 |
» |
|
|
|
NM callable only. Obtains CM procedure plabel in preparation for Switch to CM through
plabel. Syntax | |
U16 CA U16V I32
plabel:=HPLOADCMPROCEDURE(procname,library,status);
|
Functional Return | |
- plabel
16-bit unsigned integer (assigned functional return) Plabel of the target CM procedure.
Parameters | |
- procname
character array (required) Passes an ASCII procedure name, left-justified and blank-padded.
The name can have a maximum of 16 characters.
- library
16-bit unsigned integer by value (required) Passes indicator of the CM segmented library to be searched. The
valid values are:
| Value | Meaning |
|---|
| 0 | Search the system SL only. (Default) | | 1 | Search the logon account SL, then the system SL. | | 2 | Search the logon group SL, then logon account SL, and then system SL last. | | 3 | Search the program file's account SL, then the system SL. | | 4 | Search the program file's group SL, then the program file's
account SL, and then the system SL last. |
- status
32-bit signed integer by reference (optional) Returns the status of the HPLOADCMPROCEDURE 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, and 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 HPLOADCMPROCEDURE is 105.
Operation Notes | |
The HPLOADCMPROCEDURE intrinsic helps you avoid switching by
name overhead. Switching by name incurs the overhead of forming
a hash probe out of the target procedure's name and finding the
name in a hash table in order to obtain the procedure's plabel.
You can eliminate this overhead by obtaining the target
procedure's plabel through the HPLOADCMPROCEDURE intrinsic.
You can then supply the result returned by HPLOADCMPROCEDURE
as the value of the procname parameter in the call to the
HPSWITCHTOCM intrinsic. Related Information | |
- Intrinsics
None - Commands
None - Manuals
Switch Programming Guide (32650-90014)
|
