|
|
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 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
|