Defines a new persistent channel on the specified servers.
See also /DeleteChannel, /SetChannel, /GetChannel, /ListChannels.
Chatcmd ServerList /AddChannel:ChannelName=[Parameters]
| ServerList | This switch supports multiple servers in its command line. Creating a persistent channel on one server does not update the other servers on the network; you must specify all servers on the network to keep them synchronized. List applicable servers in the form Server1,Server2,Server3¼. |
| ChannelName | A persistent channel (or chat room) on a chat server. |
| The standard IRC channel naming convention is fully supported. The name of an IRC-compatible channel can contain between 1 and 200 ANSI characters, but must begin with the number sign (#) or an ampersand (&). All characters except null, bell, carriage return, line feed, space, comma, and backslash are permitted. All parameters are optional for IRC channels. | |
| The name of a channel that allows only Microsoft Internet Chat (MIC) protocol connections, called a MICONLY channel, can contain between 1 and 63 ANSI or Unicode characters. All characters except null, bell, carriage return, line feed, comma, and backslash are permitted. If a MICONLY channel name includes a space, the channel name must be enclosed in quotation marks. To specify a MICONLY channel you must specify the MICONLY flag. | |
| Parameters | Parameters are provided in the following table. Two special parameters are mode and flag. The modes and flags are defined following the parameters. |
You must enter the channel parameters on the command line in the order specified in the following table. If you don't want to alter a parameter, use a number sign (#). If you want to set a parameter to its default, use an asterisk (*). Separate each parameter with a comma (,).
| ChannelName | Name of the persistent channel. |
| MemberKey | A keyword with which users can join the channel as a member. The member keyword is limited to 31 characters. |
| OwnerKeyword | A keyword that members can use to join a channel with owner permissions. The owner keyword is limited to 31 characters. |
| Topic | The channel topic. The topic is limited to 160 ANSI or Unicode characters. |
| Subject | One or more subject keywords. Keywords for the channel subject are used by Web-based searches. The subject is limited to 31 ANSI or Unicode characters. |
| Account | Member account that Chat Service uses to restrict or deny access to the channel. A member account can be associated with a Windows NT group, or it can contain one or more users that you designate. When you choose a member account, each account member must authenticate. |
| Modes | Channel modes. Modes are given in a following table. |
| Flags | Channel flags. Flags are given in a following table. |
| Limit | Sets the maximum number of members who can join the channel. You can set a value from 0 to 48000. The default value is 0. |
| PICS | A Platform for Internet Content Selection (PICS) label that allows you to rate the channel based on its content. The server passes the PICS string to the chat client, which interprets it and allows (or prevents) access to the channel. |
| The PICS string, which is limited to 255 characters, is generated and provided by ratings organizations such as SafeSurf or the Recreational Software Advisory Council (RSAC). Visit the Web site of one of these organizations to acquire a PICS string. | |
| ClientGUID | Globally Unique Identifier (GUID) for custom client use. A GUID is a unique number that identifies a Dynamic Link Library (DLL) file. The GUID is generated when the DLL is registered. An example of a GUID is {F1CC3C17-09E3-11d1-873D-00C04FB6E8E9}. The GUID must be enclosed in braces ({}). |
| ServiceGUID | GUID of the channel service DLL. The GUID must be enclosed in braces ({}). |
| Data | A text string that chat client developers can use to pass instructions or parameters to custom clients. This string is limited to 255 ANSI or Unicode characters. |
| You can also use this string to send a client's GUID, which represents an ActiveX control that runs on the client. | |
| HostKeyword | A keyword that members can use to join a channel with host permissions. The host keyword is limited to 31 characters. |
| language | The preferred language for a channel. Use the language codes specified by the Internet Engineering Task Force (IETF) in Request for Comments (RFC) 1766. These are the same codes used by Hypertext Transfer Protocol (HTTP). The language code is limited to 31 characters. |
| OnJoin | A message automatically sent to Internet Relay Chat (IRC) or Extended IRC (IRCX) clients after they join a channel. The channel name is displayed as the sender of the message. Only the client who joins the channel sees the message. This message is limited to 255 characters. |
| OnPart | A message sent to Internet Relay Chat (IRC) or Extended IRC (IRCX) clients after they leave a channel. The channel name is displayed as the sender of the message. Only the client who leaves the channel sees the message. This message is limited to 255 characters. |
The channel modes are described in the following table. To add several modes at once, separate them by a plus sign (+), with no spaces in between. Order is not important.
| PUBLIC | Default mode used when no other mode is set. |
| PRIVATE | The channel is private. Only the name and number of members can be queried by nonmembers. |
| SECRET | The channel is secret and cannot by located by any query. |
| INVITE | Permits only invited users to enter the channel. |
| KNOCK | Causes a message to be sent to all channel hosts if an uninvited user attempts to join an invite-only channel. Useful for clients who want to use custom access control of a channel and will automatically issue an invite to a select group of users. |
| MODERATED | Sets the default mode for new members to Spectator, which means that chat user joining a moderated channel cannot post messages to the channel but can see messages posted by the channel hosts. However, a channel host can grant speaking permission to a specific member using the following command: |
| Mode +v Channel Nickname | |
| Moderated channels are often used for small chat events. | |
| NOEXTERN | Blocks nonmembers from sending messages to the channel. |
| TOPICOP | Allows only channel hosts to change the channel topic property. |
| AUDITORIUM | Permits non-host members to send messages to, or see, only host members. Host members, however, can see and send messages to non-host members. When AUDITORIUM is selected, only hosts are notified when non-host members join or leave the channel. |
| Consider an online conference held in an auditorium channel. A chat user joining the channel can post messages to the channel but can see only his or her own messages and those posted by the conference speakers. The speakers, however, can see and send messages to any conference participant (channel member). Only the speakers, as channel hosts, are notified when participants join or leave the channel. | |
| Auditorium channels are often used for large chat events. | |
| NOALIAS | The client's identity (userid@host) is returned for channel members. |
| NOREMOTE | Permits only local users to join this channel. |
| NOWHISPER | Disables the ability to whisper to one or more members within a channel. |
| SYSOPISOWNER | Sets users with Sysop privileges to owner status when they enter the channel. |
The channel flags are described in the following table. To add several flags at once, separate them by a plus sign (+), with no spaces in between. Order is not important.
| DEFAULT | Used when the sysop manager does not select any special flags. |
| AUTHJOIN | Permits only authenticated users to join the channel. This flag overrides the AUTHTALK flag. |
| AUTHTALK | Permits only authenticated users to speak. |
| FEED | Disables enter or leave messages for all members. Any message sent by a host member is sent to all hosts. All members, including hosts, see only themselves in the channel. Useful for supporting a very large number of users receiving a specific data flow (for example, stocks). |
| MICONLY | Permits MICONLY clients to enter this channel. This mode enables the UNICODE flag, which can only be set when the channel is created. |
| UNICODE | Permits Unicode channel properties to be set. Allows users to send Unicode messages. This can only be set when the channel is created; the MICONLY flag must also be set. |
| ROOMCHAT | Prevents the client from displaying the "From" alias prefix. This improves user interaction within a room or MUD-based chat channel. |
| TEMPLATE | Permits a new channel to be automatically created if all current channels with the same base name are full. |
| Note Attempting to enter a full Template channel with the OWNERKEYWORD will override the Template channel member limit setting and allow the owner to join the original channel. | |
| ECHOSOURCE | Messages are echoed back to the originator. Normally used by channel services only. |
| IMPERSONATE | Permits a channel service to impersonate members in a channel. |
| AUTOSTART | Starts the persistent channel as though a user had joined it. Allows it to be seen along with other channels that have members in them. |
| For the AUTOSTART feature to take effect, a member must enter and leave the channel, or the chat service must be stopped and restarted. In addition, after any change is made to a channel that utilizes the AUTOSTART feature, the channel must be stopped using the /KillChannel switch, and then restarted before the changes will take effect. |
chatcmd myserv01 /addchannel:localchat=*,*,"localchat",*,*,private+topicop,miconly,25 | |
| Adds a private channel for MICONLY clients. | |
chatcmd myserv01 /addchannel:#irc_channel=* | |
| Adds a channel with all default values (mode=PUBLIC, flag=DEFAULT). |