Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-42
SENDBREAKMESSAGE Procedure
(Superseded by BREAKMESSAGE_SEND_
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 4-word process ID is:
[0:2] Process name or creation timestamp
[3].<0:3> Reserved
.<4:7> Processor number where the process is executing
.<8:15> PIN assigned by the operating system to identify the process
in the processor
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.
Considerations
•
A successful status indication from SENDBREAKMESSAGE does not imply that
the process has received the message, only that it has been sent.
•
If the process-id designates a member of a named process pair, the break-on-
device message delivery will automatically be retried to the backup process if a
failure or path switch occurs.
•
A break-on-device system message is delivered to the $RECEIVE file of the target
process. See the
Guardian Procedure Errors and Messages Manual for the format
of the interprocess system messages.
•
SENDBREAKMESSAGE cannot be used for a high-PIN unnamed process
because a high PIN cannot fit into
process-id; BREAKMESSAGE_SEND_
should be used instead. However, it can use SENDBREAKMESSAGE for a high-
PIN
named process.