Node:create-text-old, Next:, Previous:mark-as-read, Up:Protocol Requests


create-text-old [28] (1) Obsolete (10)


        create-text-old [28] (( text        : HOLLERITH;
                                misc-info   : ARRAY Misc-Info ))
                -> ( 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 only Misc-Info items valid for this call are recpt, cc-recpt, bcc-recpt (protocol version 10), comm-to and footn-to.

Example: 

        1 28 20HExample\nMessage body 3 { 0 5 1 112 2 33467 }
        :16 0 33502 13 16 15 16 6 97 3 196 1 119 1 20 0
            5 { 0 5 6 148 1 112 6 3438 2 33467 } 
        =1 33502

In this example, person 119 creates a text containing a subject and a one-line body. The recipient of the text is conference five, conference 112 is a CC recipient and the text is a comment to text 33467. The server reply indicates that the new text has been given number 33502. Finally there is an asynchronous message sent to all members of recipient conferences. Note how the message was sent before the reply to the client. The misc-info list in this message has two additional fields, the local numbers of the text in each of its recipient conferences.

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.
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.
anonymous-rejected
Attempt to send an anonymous text to a conference that does not accept anonymous texts.
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.