Guardian Procedure Calls Reference Manual

GIVE^BREAK Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Example
Related Programming Manual
Summary
The GIVE^BREAK procedure returns BREAK to the previous owner (the process that owned BREAK
before the last call to TAKE^BREAK).
GIVE^BREAK is a sequential I/O (SIO) procedure and should be used only with files that have
been opened by OPEN^FILE.
Syntax for C Programmers
#include <cextdecs(GIVE_BREAK)>
short GIVE_BREAK ( short { _near *common-fcb }
{ _near *file-fcb } );
Syntax for TAL Programmers
error := GIVE^BREAK ( { common-fcb } ! i
{ file-fcb } ); ! i
Parameters
common-fcb
input
INT:ref:*
identifies the file returning BREAK to the previous owner. The common-fcb parameter is
allowed for convenience. If BREAK is not owned, this call is ignored.
file-fcb
input
INT:ref:*
identifies the file returning BREAK to the previous owner. If BREAK is not owned, this call is
ignored.
Returned Value
INT
A file-system or sequential I/O error code that indicates the outcome of the call.
Example
CALL GIVE^BREAK ( OUT^FILE ); ! return BREAK to
! previous owner.
676 Guardian Procedure Calls (G)