HP 3000 Manuals HP 3000 Manuals
HPLOADCMPROCEDURE
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)