1 02/06/84  send_message_
  2 
  3 
  4 Entry points in send_message_:
  5    (List is generated by the help command)
  6 
  7 
  8 :Entry: send_message_: 02/06/84  send_message_
  9 
 10 Function: sends an interactive message to be received by the message
 11 facility.  If the recipient is not currently accepting messages, the
 12 message is added to that user's mailbox.
 13 
 14 
 15 Syntax:
 16 declare send_message_ entry (char(*), char(*), char(*), fixed bin(35));
 17 call send_message_ (person, project, message, code);
 18 
 19 
 20 Arguments:
 21 person
 22    is the registered Person_id of the recipient.  (Input)
 23 project
 24    is a Project_id on which the recipient is registered.  (Input)
 25 message
 26    is the text of the message to be sent.  (Input)
 27 
 28 
 29 code
 30    is a standard status code.  (Output) It can be one of the following:
 31    error_table_$messages_deferred
 32       recipient is deferring messages.  The message is added to his
 33       mailbox, but the recipient will not receive it immediately.
 34    error_table_$messages_off
 35       recipient is not logged in or not accepting messages.  The
 36       message is added to his mailbox, but the recipient will not
 37       receive it immediately.
 38    error_table_$noentry
 39       no mailbox for the specified recipient.
 40 
 41 
 42    error_table_$no_append
 43       insufficient access to add a message to the recipient's mailbox.
 44    error_table_$wakeup_denied
 45       insufficient access to send the message interactively; the
 46       message is added to the recipient's mailbox.
 47    error_table_$no_info
 48       access class restrictions prevent the sender from finding out
 49       whether the message was sent.
 50 
 51 
 52 Notes:  The pathname of the mailbox sent to is
 53 >udd>Project_id>Person_id>Person_id.mbx.
 54 
 55 
 56 
 57 :Entry:  acknowledge:  02/06/84 send_message_$acknowledge
 58 
 59 
 60 Function:  This entry point sends a message to be acknowledged when
 61 read by the recipient.
 62 
 63 
 64 Syntax:
 65 declare send_message_$acknowledge entry (char(*), char(*), char(*),
 66      fixed bin(35));
 67 call send_message_$acknowledge (person, project, message, code);
 68 
 69 
 70 Arguments:
 71 person
 72    is the registered Person_id of the recipient.  (Input)
 73 project
 74    is a Project_id on which the recipient is registered.  (Input)
 75 message
 76    is the text of the message to be sent.  (Input)
 77 code
 78    is a standard status code.  (Output)
 79 
 80 
 81 Notes: The acknowledgement is an interactive message of the form
 82 "Acknowledged" if the message is printed immediately by the recipient,
 83 or "Acknowledge message of <time>" if printed later.
 84 
 85 
 86 :Entry:  express:  02/06/84 send_message_$express
 87 
 88 
 89 Function: sends a message only if the recipient is logged in and
 90 accepting interactive messages by means of the accept_messages
 91 command.  If the message cannot be sent interactively, it is not added
 92 to the recipient's mailbox.
 93 
 94 
 95 Syntax:
 96 declare send_message_$express entry (char(*), char(*), char(*),
 97      fixed bin(35));
 98 call send_message_$express (person, project, message, code);
 99 
100 
101 Arguments:
102 person
103    is the registered Person_id of the recipient.  (Input)
104 project
105    is a Project_id on which the recipient is registered.  (Input)
106 message
107    is the text of the message to be sent.  (Input)
108 code
109    is a standard status code.  (Output)
110 
111 
112 :Entry:  notify_mail:  02/06/84 send_message_$notify_mail
113 
114 
115 Function: sends a mail notification if the recipient is currently
116 accepting interactive messages.  The mail notification needs to be
117 decoded by the message facility (accept_messages), which prints either
118 "You have mail from Person_id.Project_id" or, for a mailbox other than
119 the default one, "You have mail from Person_id.Project_id in <path>".
120 
121 
122 Syntax:
123 declare send_message_$notify_mail entry (char(*), char(*),
124      fixed bin(35));
125 call send_message_$notify_mail (person, project, code);
126 
127 
128 Arguments:
129 person
130    is the registered Person_id of the recipient.  (Input)
131 project
132    is a Project_id on which the recipient is registered.  (Input)
133 code
134    is a standard status code.  (Output)