HPlogo MPE/iX Intrinsics Reference Manual > Chapter 7 Command Definitions (HP32208-HPLOACNMPROC)

HPLOADCMPROCEDURE

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

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:

ValueMeaning
0Search the system SL only. (Default)
1Search the logon account SL, then the system SL.
2Search the logon group SL, then logon account SL, and then system SL last.
3Search the program file's account SL, then the system SL.
4Search 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


Intrinsics HPFIRSTLIBRARY, HPGETPROCPLABEL, HPLOADNMPROC, HPSETCCODE, HPSWITCHTOCM, HPSWITCHTONMNAME, HPSWTONMPLABEL, HPUNLOADCMPROCEDURE, LOADPROC, UNLOADPROC
Manuals Switch Programming Guide




HPGETPROCPLABEL


HPLOADNMPROC