Guardian Procedure Calls Reference Manual

SENDBREAKMESSAGE Procedure (Superseded by
BREAKMESSAGE_SEND_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The SENDBREAKMESSAGE procedure allows user processes to send break-on-device messages
to other processes.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
error := SENDBREAKMESSAGE ( process-id ! i
,[ breaktag ] ); ! i
Parameters
process-id
input
INT .EXT:ref:4
identifies the process to which the break-on-device message is to be sent. The format of the
four-word process ID is:
Process name or creation timestamp.[0:2]
Reserved..<0:3>[3]
Processor number where the process is executing..<4:7>
PIN assigned by the operating system to identify the process in the processor..<8:15>
breaktag
input
INT .EXT:ref:2
if present, is a user-defined value to be delivered in the fourth and fifth words of the
break-on-device message. This value corresponds to the break tag value that can be supplied
to an access method with SETPARAM function 3.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
1302 Guardian Procedure Calls (S)