Node:create-conf, Next:create-person, Previous:create-anonymous-text, Up:Protocol Requests

create-conf [88] (10) Recommended

        create-conf [88] (( name        :   HOLLERITH;
                            type        :   Any-Conf-Type;
                            aux-items   :   ARRAY Aux-Item-Input ))
                -> ( Conf-No );

This call is used to create new conferences. name is the name of the new conference and type is its type. If successful, the call returns the conference number of the newly created conference. The list aux-items contains the aux items to attach to the conference.

To use this call the session must have logged in as a user with privileges to create conferences (see Security).

Error codes

login-first

Login required before issuing this call.

permission-denied

The server does not allow everyone to create a conference and user does not have the create-conf bit set. May also be an attempt to create a conference with the letterbox bit set.

conference-exists

A conference named name already exists.

bad-name

name contains invalid characters.

string-to-long

name is too long to be used as a conference name.

secret-public

The conference type has the secret bit set, but the rd-prot bit is cleared.

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 conferences or whatever

aux-item-permission

One of the items looks valid but could not be created anyway.