Prop

Adds, changes, or deletes a channel data property. The Prop command provides a new method for manipulating the string and numeric properties of channels.

Note The user must be in IRCX mode to use this command.

Syntax

Prop Channel PropertyList

Queries a property.

Prop Channel Property :[Data]

Sets a property or deletes (when data is absent).

Prop Channel *

Lists all non-empty properties.

Parts

Channel	The name of the channel.
PropertyList	A list of channel properties, separated by commas (,).
Data	A string to which a property is set.

Channel Properties

Channel properties are listed in the following table:

ACCOUNT Contains an implementation-dependent string for attaching a security account. This controls access to the channel using the native OS security system. The ACCOUNT property is limited to 31 characters.

CLIENT Contains client-specified information. The format is not defined by the server. The CLIENT property is limited to 255 characters.

CLIENTGUID Contains a Globally Unique Identifier (GUID) that defines the client protocol to be used within the channel.

CREATION The time that the channel was created, in number of seconds elapsed since midnight (00:00:00), January 1, 1970, Universal Coordinate Time.

HOSTKEY The host keyword that will provide host (channel op) access when entering the channel. The HOSTKEY property is limited to 31 characters.

LAG Contains a numeric value between 0 to 2 seconds. The server will add an artificial delay of that length between subsequent messages from the same member. All messages to the channel are affected.

LANGUAGE The perferred language type. The LANGUAGE property is a string limited to 31 characters. Follow the guidelines of RFC1766 to form well-understood language-defining strings.

MEMBERKEY The keyword required to enter the channel. The MEMBERKEY property is limited to 31 characters. The property is backwards-compatible with RFC1459 because users can still use the Mode command as an alternative way to set this property.

NAME The name of the channel (limited to 63 characters, including 1 or 2 characters for channel prefix). Valid characters are as defined in RFC1459.

OID The internal object identifier (OID) for the channel. As a shortcut, the OID can be optionally used in place of the full string name of a channel. If the OID is set to "0,quot; then this feature is not supported on the server.

ONJOIN Contains a string to be sent (using the Privmsg command) to a user after the user has joined the channel. The channel name is displayed as the sender of the message. Only the user joining the channel will see this message. Multiple lines can be generated by embedding "\n" in the string. The ONJOIN property is limited to 255 characters.

ONPART Contains a string that is sent (using the Notice command) to a user after they have left the channel. The channel name is displayed as the sender of the message. Only the user leaving the channel will see this message. Multiple lines can be generated by embedding "\n" in the string. The ONPART property is limited to 255 characters.

OWNERKEY The owner keyword that provides owner access when entering the channel. The OWNERKEY property is limited to 31 characters.

PICS The current Platform for Internet Content Selection (PICS) rating of the channel. Chat clients that are PICS-enabled can use this property to determine if the channel is appropriate for the user. The PICS property is limited to 255 characters. The format for this field is defined by PICS (see http://www.w3.org).

SERVICEPATH Contains the path of a server-side extension that is used to control the channel operation. Details are implementation-dependent.

SUBJECT A string that can contain subject keywords. The SUBJECT property is limited to 31 characters.

TOPIC The current topic of the channel. The TOPIC property is limited to 160 characters.

Examples

	prop #mychannel topic,onjoin
	Queries the TOPIC and ONJOIN properties on the channel #MyChannel.

	prop #mychannel *
	Queries all properties on the channel #MyChannel.

	prop hischannel topic :cheese
	Sets the TOPIC on the MICONLY channel HisChannel to "Cheese."

	prop #bigchannel tag :
	Deletes the TAG property on channel #BigChannel.

ACCOUNT	Contains an implementation-dependent string for attaching a security account. This controls access to the channel using the native OS security system. The ACCOUNT property is limited to 31 characters.
CLIENT	Contains client-specified information. The format is not defined by the server. The CLIENT property is limited to 255 characters.
CLIENTGUID	Contains a Globally Unique Identifier (GUID) that defines the client protocol to be used within the channel.
CREATION	The time that the channel was created, in number of seconds elapsed since midnight (00:00:00), January 1, 1970, Universal Coordinate Time.
HOSTKEY	The host keyword that will provide host (channel op) access when entering the channel. The HOSTKEY property is limited to 31 characters.
LAG	Contains a numeric value between 0 to 2 seconds. The server will add an artificial delay of that length between subsequent messages from the same member. All messages to the channel are affected.
LANGUAGE	The perferred language type. The LANGUAGE property is a string limited to 31 characters. Follow the guidelines of RFC1766 to form well-understood language-defining strings.
MEMBERKEY	The keyword required to enter the channel. The MEMBERKEY property is limited to 31 characters. The property is backwards-compatible with RFC1459 because users can still use the Mode command as an alternative way to set this property.
NAME	The name of the channel (limited to 63 characters, including 1 or 2 characters for channel prefix). Valid characters are as defined in RFC1459.
OID	The internal object identifier (OID) for the channel. As a shortcut, the OID can be optionally used in place of the full string name of a channel. If the OID is set to "0,quot; then this feature is not supported on the server.
ONJOIN	Contains a string to be sent (using the Privmsg command) to a user after the user has joined the channel. The channel name is displayed as the sender of the message. Only the user joining the channel will see this message. Multiple lines can be generated by embedding "\n" in the string. The ONJOIN property is limited to 255 characters.
ONPART	Contains a string that is sent (using the Notice command) to a user after they have left the channel. The channel name is displayed as the sender of the message. Only the user leaving the channel will see this message. Multiple lines can be generated by embedding "\n" in the string. The ONPART property is limited to 255 characters.
OWNERKEY	The owner keyword that provides owner access when entering the channel. The OWNERKEY property is limited to 31 characters.
PICS	The current Platform for Internet Content Selection (PICS) rating of the channel. Chat clients that are PICS-enabled can use this property to determine if the channel is appropriate for the user. The PICS property is limited to 255 characters. The format for this field is defined by PICS (see http://www.w3.org).
SERVICEPATH	Contains the path of a server-side extension that is used to control the channel operation. Details are implementation-dependent.
SUBJECT	A string that can contain subject keywords. The SUBJECT property is limited to 31 characters.
TOPIC	The current topic of the channel. The TOPIC property is limited to 160 characters.