Node:create-text, Next:, Previous:get-collate-table, Up:Protocol Requests


create-text [86] (10) Recommended


        create-text [86] (( text        :   HOLLERITH;
                            misc-info   :   ARRAY Misc-Info;
                            aux-items   :   ARRAY Aux-Item-Input ))
                -> ( Text-No );

Creates a new text with contents from text and recipients etc. defined by misc-info (see The Misc-Info List). In addition to the result, the server will send an asynchronous message to all members of any of the recipients of the new text. It is not defined whether this messages comes before or after the reply to the create-text message. Clients should be prepared for either situation.

The text up to the first line feed is considered to be the subject line. The remaining text is the message body. Although messages with only a subject are valid, clients should avoid letting users create such messages.

The items in aux-items are attached to the new text.

The only Misc-Info items valid for this call are recpt, cc-recpt, bcc-recpt (introduced in protocol version 10), comm-to and footn-to.

Error codes

login-first
Login required before issuing this call.
string-too-long
The string text is longer than the maximum length of a message.
temporary-failure
The text could not be created at the moment.
no-such-text
Attempt to comment or footnote a non-existent or secret text.
not-author
Attempt to footnote a text authored by someone else.
footnote-limit
Attempt to footnote a text with the maximum number of footnotes already set.
comment-limit
Attempt to comment a text with the maximum number of comments already set.
index-out-of-range
Attempt to create a text failed because we reached the maximum number of texts permitted.
access-denied
Attempt to send a text to a conference failed because no access to the conference or any super conference that will accept a text.
illegal-misc
Invalid misc-info list. A recipient is listed more than once or there is an unknown misc item in the misc-info list.
illegal-aux-item
One of the aux-items in aux-items is illegal. The tag might be out of range, the item not applicable to texts or whatever
aux-item-permission
One of the items looks valid but could not be created anyway.
long-array
Too many Misc-Info items or aux-items were specified.