HP 3000 Manuals

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


MPE/iX Intrinsics Reference Manual

LOCRINOWNER 

NM and CM callable.

Determines process identification number (PIN) of the process that locked
a local resource identification number (RIN).

Syntax 
_____________________________________
|                                   |
|     I16               I16V        |
|     pin:=LOCRINOWNER(rinnum);     |
_____________________________________

            

Functional Return 

pin                   16-bit signed integer (assigned functional return) 

                      If the RIN is locked by the parent of the calling
                      process, LOCRINOWNER returns 0.  If the RIN is
                      locked by any other process in your process
                      structure, LOCRINOWNER returns the PIN of that
                      process.

Parameters 

rinnum                16-bit signed integer by value (required) 

                      Passes the number of the local RIN for which the
                      PIN of the locking process is to be determined.
                      The range of valid values is from 1 to the value
                      specified in the rincount parameter of the
                      GETLOCRIN intrinsic.

Operation Notes 

The LOCRINOWNER intrinsic determines the PIN of the process that has a
particular local RIN locked.  After a process has acquired local RINs,
other processes in the process structure can lock and unlock these RINs.

Condition Codes 

CCE (2)               Request granted.

CCG (0)               Request denied.  The local RIN specified by rinnum 
                      is not currently locked by any process.

CCL (1)               Request denied.  The rinnum parameter was invalid
                      (that is, rinnum was less than or equal to 0,
                      greater than the RIN table size, or greater than
                      the number of local RINs currently allocated to
                      this process structure).

Related Information 

Intrinsics            None

Commands              None

Manuals               Resource Management Programmer's Guide 
                      (32650-90024).



MPE/iX 5.0 Documentation