|
|
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
- Manual
Switch Programming Guide
|