MPE/iX Intrinsics Reference Manual (32650-90875)

490 Chapter8
Command Definitions (HPMERGEEND-LOGSTATUS)
LOCRINOWNER
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
Manual Resource Management Programmer's Guide .