HP 3000 Manuals

HPSWTONMPLABEL [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation


MPE/iX Intrinsics Reference Manual

HPSWTONMPLABEL 

CM callable only.

Allows CM user programs, user libraries, and system code to invoke NM
procedures as follows:

   *   Convert CM references in the argument list to virtual NM
       addresses.

   *   Change the execution mode.

   *   Invoke the NM procedure specified by the CM caller.

Syntax 
__________________________________________________________
|                                                        |
|                    U32V  I16V    I16    I16            |
|     status:=HPSWTONMPLABEL(proc,nparms,arglist,argdesc,|
|                    I16V                                |
|                  functype);                            |
__________________________________________________________

            

Functional Return 

status                I32 (assigned functional return) 

                      Returns a 32-bit integer indicating the status of
                      the call.

Parameters 

proc                  32-bit unsigned integer by value (required) 

                      Passes the NM plabel of the target procedure name.
                      This plabel is usually obtained by calling the
                      HPLOADNMPROC intrinsic.

nparms                16-bit signed integer by value (required) 

                      Passes the number of parameters to be passed to the
                      target NM procedure.  It specifies the length of
                      argdesc.  Account for any hidden parameters (such
                      as, parameters, an extensible parameter list, and
                      so forth).  For more information on hidden
                      parameters, refer to the Hewlett-Packard Pascal/XL 
                      Reference Manual (31502-90002).

arglist               16-bit signed integer array by reference (required) 

                      Passes the actual parameters to be passed to the NM
                      procedure.

argdesc               16-bit signed integer array by reference (required) 

                      Passes integer codes describing the parameters held
                      in the arglist array (that is, byte, word, double,
                      pointer, and so forth).

functype              16-bit signed integer by value (required) 

                      Passes the data type of the value the target
                      procedure returns if it is a function.  If the
                      target is not a function, the value of this
                      parameter is zero.  Refer to the Switch Programming 
                      Guide (32650-90014) for supported function types.

Operation Notes 

Do not use HPSWTONMPLABEL to invoke a native mode (NM) system supplied
intrinsic.  The result of the call may be unpredictable.

NM code can address the entire CM stack, so there is no copying of
reference parameters.  The length of each parameter is not required
because lengths are implied in the descriptor list.

Related Information 

Intrinsics            None

Commands              None

Manuals               Switch Programming Guide (32650-90014)



MPE/iX 5.0 Documentation