Open System Services Programmer's Guide

OSS Notes
Additional considerations or restrictions when the Guardian procedure is called from an OSS
process.
Table 23 (page 206) displays information about Guardian procedures useful when performing
interprocess communication. The columns of the table contain the same kind of information as in
Table 22. For details about a procedure, refer to the Guardian Procedure Calls Reference Manual
and the Guardian Programmer’s Guide.
Table 22 Guardian Interprocess-Communication Procedures
OSS NotesGuardian Procedure
AWAITIO[X]
Checks for completion of nowait operations pending on
one or all Guardian file opens (using file numbers),
including operations on a server process file.
Closes only a Guardian semaphore, not an OSS
semaphore.
BINSEM_CLOSE_
Closes a binary semaphore.
Creates, opens, and locks only a Guardian semaphore,
not an OSS semaphore.
BINSEM_CREATE_
Creates, opens, and locks a binary semaphore.
Forces a lock on only a Guardian semaphore, not an OSS
semaphore.
BINSEM_FORCELOCK_
Forces a lock on a binary semaphore.
Beginning with the H06.23 and J06.12 RVUs.BINSEM_ISMINE_
Reports whether this process owns (has locked) the
semaphore.
Locks only a Guardian semaphore, not an OSS semaphore.BINSEM_LOCK_
Locks a binary semaphore.
Opens only a Guardian semaphore, not an OSS
semaphore.
BINSEM_OPEN_
Opens a binary semaphore.
Relinquishes a lock on only a Guardian semaphore, not
an OSS semaphore.
BINSEM_UNLOCK_
Relinquishes a lock on a binary semaphore.
CANCEL
Cancels the oldest outstanding nowait operation on a
specified Guardian open, such as a server process file.
CANCELREQ
Cancels a a specific outstanding nowait operation on a
specified Guardian file open, such as a server process file.
Beginning with the H06.24 and J06.13 RVUs.FILE_AWAITIO64_
Completes a previously initiated I/O operation.
FILE_CLOSE_
Closes a Guardian file open, such as a server process file.
FILE_GETINFO_
Provides error information and characteristics about a
Guardian file open, such as a server process file.
FILE_GETRECEIVEINFO_
Returns information about the last message read from the
$RECEIVE file of the calling process.
OSS SEEP consultation, beginning with the J06.15 and
H06.26 RVUs. For OSS SEEP details, see “Accessing OSS
SEEP-Protected Files” (page 83).
FILE_OPEN_
204 Interprocess Communication