Guardian Procedure Calls Reference Manual

proc-semid
input
INT (32):value
specifies the binary semaphore ID of an open binary semaphore. The proc-semid value can
be obtained by a previous call to the BINSEM_CREATE_ or BINSEM_OPEN_ procedure. The
processhandle must designate the process in which that call occurred.
Returned Value
INT
Outcome of the call:
No error.0
Bounds error. The semid parameter cannot be written by the calling process or processhandle cannot
be read from the calling process.
22
Required parameter missing. The semid, processhandle, and proc-semid parameters must be specified.29
Either the process or the processor has reached the maximum number of user semaphores it can open
concurrently. The corresponding errno value is ENOENT.
NOTE: The number of binary semaphores a processor can have open on systems running H06.17 and later
H-series RVUs and J06.06 and later J-series RVUs is 65536. On earlier RVUs, the limit is 64.
4002
Invalid access. The calling process does not have access to the binary semaphore because of its security. The
security for a binary semaphore is set by the BINSEM_CREATE_ procedure. The corresponding errno value
is EACCES.
4013
Invalid parameter. The processhandle parameter does not specify a process. A process that is being
created or is terminating is treated as though it does not exist. The corresponding errno value is EINVAL.
4022
Process cannot open the binary semaphore. The process has reached the maximum limit of binary semaphores
it can open. The corresponding errno value is EMFILE.
4024
Considerations
NOTE: There are additional considerations for privileged callers.
• The open operation and the state of the binary semaphore
The state of the binary semaphore remains unchanged from its original state.
• For more information about binary semaphores, see General Considerations for Binary
Semaphores (page 89).
Example
error := BINSEM_OPEN_( semid, processhandle, proc^semid );
Related Programming Manuals
For programming information about the BINSEM_OPEN_ procedure, see the Guardian Programmer's
Guide.
102 Guardian Procedure Calls (A-B)