MPE/iX Intrinsics Reference Manual (32650-90905)
Chapter 10 603
Command Definitions (QUIT-ZSIZE)
SENDMAIL
outgoing mail.
location
user-defined structure (required)
The buffer containing the message.
waitflag
16-bit unsigned integer by value (required)
Action to be taken if the mailbox contains previously sent mail, as
specified in bit (15:1):
Bits Value/Meaning
0 Cancel (overwrite) any mail sent previously with the
current mail.
1 Wait until the receiving process collects the previous mail
before sending current mail.
Operation Notes
If the receiving process mailbox contains an uncollected message from the calling process,
the action taken depends on the
waitflag
parameter specified in the SENDMAIL call. If the
mailbox currently is being used by another process, SENDMAIL waits until the mailbox is
free and then sends the mail.
Condition Codes
CCE (2) Request granted. The mail was sent (value 0 or 1 is returned to
mailstatus
), or the mail was not sent because the mailbox contained
incoming mail to be collected by the sending process (value 2 is returned to
mailstatus
).
CCG (0) Request denied. An illegal
length
parameter (value 5 is returned to
mailstatus
), an illegal
pin
parameter was specified (value 3 is returned
to
mailstatus
), or storage for the mail data segment was not available
(value 6 is returned to
mailstatus
).
CCL (1) Request denied. The
length
or
location
parameter does not allow write
access on the stack address (value 3 is returned to
mailstatus
), or both
processes are waiting to send mail (value 4 is returned to
mailstatus
).
Related Information
Manual Interprocess Communication Programmer's Guide