OS/2 Shareware BBS: 35 Internet/35-Internet.zip/gtirc306.zip/GTIRC.HLP

OS/2 Help File | 1997-11-24 | 113KB | 3,680 lines

ΓòÉΓòÉΓòÉ 1. Acknowledgements ΓòÉΓòÉΓòÉ

The folks at GammaTech would like to thank Chuck Oxier for the many hours he
put into reworking the printed documentation for GtIrc. His assistance is
greatly appreciated.


ΓòÉΓòÉΓòÉ 2. GammaTech Internet Relay Chat Help ΓòÉΓòÉΓòÉ

The IRC Client window is divided into 6 parts. The Title Bar, the Menu Bar, the
Output Window, the Toolbar, the Input Window, and the Nick List Window. In
addition, you may access the popup menu by clicking mouse button 2 in the
Output Window, the Input Window, or the Nick List window - the popup menu is
specific for each window.

What follows is a description of each of the parts:

The Title Bar - The title bar of the primary window indicates your nickname,
user mode and server name. The title bar of a Channel Window shows your
nickname, user mode, the channel name and channel mode. The title bar for query
Window shows your nickname, user mode and the nickname of the user being
queried.

The Menu Bar - From the menu bar you may select any of the items below. Double
click on any of the choices shown for additional information.

  File
           Connect or terminate IRC.

  Options
           Configure IRC options.

  Help
           Display help on using IRC, IRC Commands or Product Information.

 The Output Window - The Output Window is where all messages are displayed.
 These messages may consist of various notification messages, responses from
 commands, text received from other IRC users and text you send to other IRC
 users. Its height can be changed by sizing up and down - only the Output
 Window's height will change.

 Notification messages are usually prefixed with three asterisks (***). Public
 messages from other users are prefixed with their nickname in < > such as
 <george>. Private messages from another user to you will be prefixed with
 their nickname in asterisks such as *george*.

 The Output Window contains a scroll bar and a scroll back buffer, which saves
 the last 256 lines of text sent to the window. Text that has been scrolled off
 of the screen can be viewed by using the scroll bar. Screen updating is
 disabled when the last line of text is not on the display. To enable screen
 updating, scroll to the bottom of the screen. Messages received during the
 scrollback will be displayed at this time, and automatic updating of the
 screen will continue. Also, entering and sending standard text will cause the
 Output Window to scroll, while entering the IRC / commands will not.

 In addition, the Output Window supports copy to the clipboard only. To do
 this, select the desired text - swiping with the mouse from left to right, or
 top to bottom works best - then use the popup menu to copy.

 Be sure to read the section on Message Routing in the manual. Because IRC was
 originally developed for all input and output in a single window area, there
 are some peculiarities regarding message routing to multiple windows, as is
 done with the GammaTech IRC client.

 The Toolbar - The Toolbar is located below the Output Window and above the
 Input window and has the following Icon controls:

 Join a channel.

 Leave the current channel.

 Establish a query session.

 Update the notify list.

 Recall previous commands (from last 25 executed commands).

 Embolden selected text in Input Window.

 Display this help window.

 Show/hide the nick list.

 Open/Close log file.

 Execute user defined command no. 1.

 Execute user defined command no. 2.

 Execute user defined command no. 3.

 Execute user defined command no. 4.

 The last four icons represent actions that are user definable through the
 Toolbar Dialog. You can access the Toolbar Dialog through the Popup or Options
 menu.

 The Input Window - The Input Window is where you enter text to be sent to the
 channel or query, or enter various IRC commands. Its height is fixed and
 dependent upon the font size you choose in setting the GammaTech IRC Options.
 The function and syntax of the available IRC commands is provided elsewhere in
 this helpfile.

 The window supports the standard editing and functionality, i.e., the
 keystrokes of the OS/2 MLE (Multi-Line Entry) control. The behavior of the
 MLE, when typing, depends on whether it is in insert or overtype mode, and
 whether the selection is empty or not. The selection is defined to be empty
 when the cursor point is equal to the anchor point.

 When a character is typed, it replaces the current selection. If the selection
 is empty, the character is viewed as replacing nothing, so the character is
 effectively inserted into the text. If one or more characters are selected,
 those characters are deleted from the text and replaced by the typed
 character.

 If the MLE is in insert mode, the cursor and anchor points are moved to
 immediately follow the newly typed character.

 If the MLE is in overtype mode, the cursor is moved to immediately follow the
 newly typed character. If there is no character after the  cursor (the new
 character is at the end of the text) or if the  character after the cursor is
 a line-break character, the anchor is  set to be equal to the cursor point. In
 any other case, the anchor is extended one character past the cursor point,
 defining the next character as the current selection.

 If the typing causes the cursor to go off the screen in any direction, the
 display is automatically scrolled. If word-wrap is on, text continues on a new
 line, otherwise, the screen is scrolled horizontally. Scrolling of the text in
 the window is independent of cursor movement. The cursor and selection remain
 unaltered at the same location within the text during all scrolling but the
 converse is not true. Any movement of the cursor causes auto-scrolling, if
 necessary, to ensure that the text location of the cursor is visible within
 the window.

 Hitting the Return key causes the text to be sent to IRC as a command and the
 Input Window is cleared in preparation for the next input operation.

 When a channel is joined or a query started, a new window is opened for that
 channel or query. When the channel is left or a query terminated, the
 associated window is closed.


ΓòÉΓòÉΓòÉ 3. File Menu Option ΓòÉΓòÉΓòÉ

 From this menu drop down you may perform the operations shown below. Double
 click on any choice for additional information.

  Connect
           Connect to an IRC server.

  Signoff
           Quit IRC normally.

  Exit
           Force IRC termination.


ΓòÉΓòÉΓòÉ 4. Popup Menu Help ΓòÉΓòÉΓòÉ

 Popup menus are available by clicking mouse button 2 within the appropriate
 window. Several of the dialogs (i.e., list) can be accessed directly as well
 as special functions. Different windows have different popup menus.

 The popup menu for the Output window contains the following items:

  Copy
  Connection Dialog
  Settings Dialog
  Toolbar Dialog
  BanList Dialog
  ChanMode Dialog
  UserMode Dialog

 The popup menu for the Input window contains the following items:

  Command Help
  Copy
  Join Dialog
  Notify Dialog
  Paste
  Query Dialog
  Toolbar Dialog

 The popup menu for the NickList window contains the following items:

  Msg selected
  Query selected
  Add to Notify list
  Ping selected list
  UserHost of selected list
  Version of selected list
  Who on selected
  Whois on selected
  Ignore nick
  DCC Chat
  DCC Send
  Op selected nick
  DeOp selected nick
  Kick selected
  Ban selected
  Ban and Kick selected

 The popup menu for the List Output window contains the following items:

  Join selected
  Names on selected

 The popup menu for the Names Output window contains the following items:

  Query selected
  Add to Notify list
  Ping selected list
  UserHost of selected list
  Version of selected list
  Who on selected
  Whois on selected


ΓòÉΓòÉΓòÉ 5. Signoff Menu Option ΓòÉΓòÉΓòÉ

 Selecting the Signoff option sends a QUIT to the server with a reason of
 "Leaving", and closes the connection with the server. All windows are closed
 and the IRC program is terminated.

 Using the Signoff menu option is the correct way to terminate your IRC
 session. You may also use the /QUIT command and specify the reason you are
 leaving.

 Generally, you should not terminate IRC with the Exit menu option or by double
 clicking on the system menu icon in the top left corner of the window if you
 are connected to a server. Doing so will not notify the server that you are
 terminating gracefully.


ΓòÉΓòÉΓòÉ 6. Exit Menu Option ΓòÉΓòÉΓòÉ

 Selecting the Exit option immediately terminates the IRC program. Normally,
 the Signoff option should be used instead in order to perform proper
 termination handshaking with the server.

 Using this option can leave your nickname in use on the IRC network until the
 required cleanup can be performed by the servers. This will prevent you from
 accessing IRC with that nickname until the cleanup has completed.


ΓòÉΓòÉΓòÉ 7. Keystroke Commands for Input Window ΓòÉΓòÉΓòÉ

 For all the following keys, unless otherwise noted, the display is scrolled,
 if necessary, to keep the cursor point visible. Where noted, the cursor
 setting behaves differently in insert mode than in overtype mode. This is
 subject to the boundary conditions noted above.

 Keystroke           Resulting Action

 Esc                 Causes any input in the input window to be erased.

 Del                 Causes the contents of the selected region to be deleted.
                     If the selected region contains no text, it causes the
                     character to the right of the cursor to be deleted.

 Tab                 If the window is a channel window the tab key is used to
                     complete a nickname in the nickname list of users on that
                     channel. The first nickname found which matches the
                     partial nickname entered immediately prior to pressing the
                     tab key is inserted.

 Shift+Del           Causes the contents of the selected region to be cut to
                     the clipboard.

 Insert              Toggles between insert and overtype mode. The MLE ignores
                     the Insert key when it occurs without a modifier.

 Shift+Ins           Causes the contents of the clipboard to replace the
                     selected region.

 Ctrl+Ins            Causes the selected region to be copied to the clipboard.
                     The selected region is not otherwise affected.

 Backspace           Functions similar to Del. If the selection is not empty,
                     Backspace deletes the selection. If the selection is
                     empty, Backspace deletes the character to the left of the
                     cursor point. If the MLE is in overtype mode, the anchor
                     point is set, and the cursor point is moved to be one
                     character previous in the text. If no such character
                     exists (because the anchor is set to the beginning of the
                     text) the cursor is set to the anchor point. If the MLE is
                     in insert mode, the cursor and anchor points are set, as
                     defined at the start of this chapter.

 Down Arrow          Sets the cursor point to the closest insertion point on
                     the following line, then sets the anchor point to the
                     cursor point (insertion mode) or one character following
                     (overtype mode).

 Shift+Down Arrow    Causes the cursor point to be moved to the closest
                     insertion point on the following line. The anchor point
                     does not move.

 Up Arrow            Sets the cursor point to the closest insertion point on
                     the preceding line, then sets the anchor point to the
                     cursor point (insert mode) or one character following
                     (overtype mode).

 Shift+Up            Sets the cursor point to the closest insertion point on
                     the preceding line. The anchor point is not moved.

 Right Arrow         Sets the cursor point to the insertion point one character
                     following the cursor point. The anchor point is set to the
                     cursor point (insert mode) or one character following
                     (overtype mode).

 Shift+Right         Causes the cursor point to be set to the insertion point
                     immediately following the previous cursor point. The
                     anchor point is not moved.

 Left and Shift+Left Work analogously.

 Ctrl+Right          Recalls the next command in the recall buffer moving in a
                     forward direction.

 Ctrl+Shift+Right    Moves only the cursor point in the same way as Ctrl+Right,
                     but leaves the anchor point unmoved.

 Ctrl+Left           Recalls the next command in the recall buffer moving in a
                     backward direction.

 Ctrl+Shift+Left     Moves only the cursor point in the same way as Ctrl+Left
                     but leaves the anchor point unmoved.

 Pagedown and Pageup Causes the display to be scrolled one screen at a time in
                     either direction. This behavior is the same as would be
                     encountered during a page-down or page-up caused by the
                     scroll-bar.

 Ctrl+Up and Ctrl+Down Causes the output window to be scrolled one line at a
                     time up or down respectively. This behavior is the same as
                     would be encountered during a up or down caused by the
                     output window scroll-bar.

 Ctrl+Pageup and Ctrl+Pagedown Causes the output window to be scrolled one
                     screen at a time up or down respectively. This behavior is
                     the same as would be encountered during a page-up or
                     page-down caused by the output window scroll-bar.

 Home                Sets the cursor point to the insertion point at the
                     beginning of the line containing the cursor point, and
                     sets the anchor point equal to (insert mode) or one
                     character following (overtype mode).

 Shift+Home          Moves the cursor point to the insertion point at the
                     beginning of the line. The anchor point is not moved.

 End                 Sets the anchor point to the insertion point at the end of
                     the line containing the cursor point. If the last
                     character on the line is a line-break character, the
                     anchor is positioned just before it. The cursor is set
                     equal to (insert mode) or one character previous to
                     (overtype mode) the anchor.

 Shift+End           Moves the cursor point to the insertion point at the end
                     of the line, as above. The anchor point is not moved.

 Ctrl+Home           Moves the cursor point to the insertion point at the
                     beginning of the document. The anchor point is set equal
                     to (insert mode) or one character following it (overtype
                     mode).

 Ctrl+End            Moves the anchor point to the insertion point at the end
                     of the document. The cursor point is set to be equal to
                     the anchor point (insert mode) or one character preceding
                     it (overtype mode).

 Ctrl+Shift+Home     Moves the cursor point in the same way as Ctrl+Home, but
                     leaves the anchor point unmoved.

 Ctrl+Shift+End      Moves the cursor point in the same way as Ctrl+End, but
                     leaves the anchor point unmoved.

 The user may enter special characters directly into the Input Window as
 follows: ^A for manually entered CTCP commands; ^B to add a Bold text marker;
 ^G to ring the bell on the destination machine.


ΓòÉΓòÉΓòÉ 8. Recall Last 25 Commands ΓòÉΓòÉΓòÉ

 Clicking on the Recall icon located on the Toolbar causes each of the last
 twenty five executed commands from the Input Window to be be scrolled through.
 Hitting the Return key after the command is placed into the Input Window by
 the Recall function executes that particular command.


ΓòÉΓòÉΓòÉ 9. Copy Help ΓòÉΓòÉΓòÉ

 Issuing this command will copy selected text to the OS/2 clipboard, so that it
 can be pasted into the Input Window or into other active OS/2 applications.
 Note that the Output Window supports copy only, and not other editing
 functions like paste and insert.


ΓòÉΓòÉΓòÉ 10. Paste Help ΓòÉΓòÉΓòÉ

 Issuance of this command will paste text from the OS/2 clipboard into the
 window that has the focus. Note that the Output Window does not support paste
 and insert, only copy. The Input Window, however, does support paste.


ΓòÉΓòÉΓòÉ 11. Join Selected ΓòÉΓòÉΓòÉ

 Issuing the command through the Popup menu will execute the Join command on
 the item selected.


ΓòÉΓòÉΓòÉ 12. Names on selected ΓòÉΓòÉΓòÉ

 Issuing the command through the Popup menu will execute the Names command on
 the item selected.


ΓòÉΓòÉΓòÉ 13. Ping selected nickname ΓòÉΓòÉΓòÉ

 Selecting this item executes a /PING on the selected nickname.


ΓòÉΓòÉΓòÉ 14. Options Menu Option ΓòÉΓòÉΓòÉ

 From this menu drop down you may perform the operations shown below. Double
 click on any choice for additional information.

  Settings
           IRC Configuration and Options

  Startup
           Startup and Script Options

  Toolbar
           Assign commands to user Toolbar icons.

  Colors
           Configure screen and text colors.

  CTCP/DCC Options
           Configure options relating to CTCP queries.

  Font
           Configure the font.

  Messages
           Configure message options and routing.

  On Message
           Perform actions based on incoming text.

  Preferences
           Configure custom preferences.

  Sound
           Configure sound preferences.


ΓòÉΓòÉΓòÉ 15. Msg selected ΓòÉΓòÉΓòÉ

 Issuing the command through the Popup menu will place a /MSG <nick> command in
 the input area and position the cursor for entering text.


ΓòÉΓòÉΓòÉ 16. Query selected ΓòÉΓòÉΓòÉ

 Issuing the command through the Popup menu will execute the Query command on
 the item selected.


ΓòÉΓòÉΓòÉ 17. Kick selected ΓòÉΓòÉΓòÉ

 Issuing the command through the Popup menu will execute the Kick command on
 the selected nickname. You must be a chanop to use this feature.


ΓòÉΓòÉΓòÉ 18. Ignore selected nickname ΓòÉΓòÉΓòÉ

 Issuing the command through the Popup menu will execute the Ignore command for
 the selected nickname for all message types.


ΓòÉΓòÉΓòÉ 19. Ban List ΓòÉΓòÉΓòÉ

 This option displays a dialog of all current bans and allows channel operators
 to modify the ban list.


ΓòÉΓòÉΓòÉ 20. Ban ΓòÉΓòÉΓòÉ

 This option allows a channel operator to issue a ban on the selected nickname.

 The default ban mask is constructed using the nickname's user@host mask if it
 is available at the time. If the user@host is not available, the nickname is
 supplied.

 When you first join a channel the user@host mask is not immediately available
 for those nicknames who joined before you.  It may take 1 to 5 minutes to
 collect the information. If the mask is required before it can be obtained
 normally you may acquire it by doing a UserHost on the nickname either by
 using the NickList pop-up menu or the /UserHost command.


ΓòÉΓòÉΓòÉ 21. Ban+Kick ΓòÉΓòÉΓòÉ

 This option allows a channel operator to issue a ban and kick the selected
 nickname in a single operation.

 The default ban mask is constructed using the nickname's user@host mask if it
 is available at the time. If the user@host is not available, the nickname is
 supplied.

 When you first join a channel the user@host mask is not immediately available
 for those nicknames who joined before you.  It may take 1 to 5 minutes to
 collect the information.  If the mask is required before it can be obtained
 normally you may acquire it by doing a UserHost on the nickname either by
 using the NickList pop-up menu or the /UserHost command.


ΓòÉΓòÉΓòÉ 22. DCC Chat ΓòÉΓòÉΓòÉ

 This option initiates a DCC Chat session with the selected nickname.


ΓòÉΓòÉΓòÉ 23. DCC Send ΓòÉΓòÉΓòÉ

 This option initiates a DCC session with the selected nickname. A standard
 files dialog will be presented by which you may select the file to be
 transmitted.


ΓòÉΓòÉΓòÉ 24. Add selected ΓòÉΓòÉΓòÉ

 Issuing the command through the Popup menu will execute the Add to Notify List
 command on the item selected.


ΓòÉΓòÉΓòÉ 25. Who ΓòÉΓòÉΓòÉ

 Issuing the command through the Popup menu will execute a /WHO command on the
 selected nickname.


ΓòÉΓòÉΓòÉ 26. Version ΓòÉΓòÉΓòÉ

 Issuing the command through the Popup menu will execute a /VERSION command on
 the selected nickname.


ΓòÉΓòÉΓòÉ 27. Whois on selected ΓòÉΓòÉΓòÉ

 Issuing the command through the Popup menu will execute a /WHOIS command on
 the selected nickname.


ΓòÉΓòÉΓòÉ 28. UserHost of selected ΓòÉΓòÉΓòÉ

 Issuing the command through the Popup menu will execute a /USERHOST command on
 the selected nickname.


ΓòÉΓòÉΓòÉ 29. Op nick ΓòÉΓòÉΓòÉ

 Issuing the command through the Popup menu will grant channel operator status
 to the selected nickname. You must be a chanop to use this option.


ΓòÉΓòÉΓòÉ 30. DeOp nick ΓòÉΓòÉΓòÉ

 Issuing the command through the Popup menu will remove channel operator status
 of the selected nickname. You must be a chanop to use this option.


ΓòÉΓòÉΓòÉ 31. Font Dialog ΓòÉΓòÉΓòÉ

 Use the fonts dialog to set the point size of the text for all of the windows.

 Select the point size and then press the "OK" button to put the changes into
 effect or the "Cancel" button to return to the original pointsize.

 When "OK" is pressed, all IRC windows are immediately changed to the new point
 size.


ΓòÉΓòÉΓòÉ 32. Help Menu Options ΓòÉΓòÉΓòÉ

 From this menu drop down you may perform the operations shown below. Double
 click on any choice for additional information.

  General Help
           How to use the GammaTech IRC Client program.

  Command Help
           Command syntax for IRC commands.

  Product Info
           Product information regarding the GammaTech IRC Client.


ΓòÉΓòÉΓòÉ 33. General Help Contents ΓòÉΓòÉΓòÉ

 The General Help option displays help on using the GammaTech IRC Client
 program.


ΓòÉΓòÉΓòÉ 34. Command Help Contents ΓòÉΓòÉΓòÉ

 The Command Help option displays help on each of the IRC Client commands which
 can be executed from the input line of any IRC client window.

 Generally, the IRC command is preceded by a / on the command line. For example
 the JOIN command would be entered as /JOIN on the command line.


ΓòÉΓòÉΓòÉ 35. Product Information ΓòÉΓòÉΓòÉ

 This option displays the product version, contact and copyright information.


ΓòÉΓòÉΓòÉ 36. Settings Help ΓòÉΓòÉΓòÉ

 The Settings Dialog defines custom information for your client. There are only
 3 required fields.

 User Name is normally the section of your Internet address which appears to
 the left of the @ symbol. For example, if your Internet address is
 [e-mail] then your User Name would be jsmith.

 Real Name is your real name such as John Q. Smith.

 Nickname is the nickname you wish to use on IRC. It can be anything you wish
 but the following limitations exist: It can be no more than 9 characters long;
 it must not be in use by another active IRC user.


ΓòÉΓòÉΓòÉ 37. Colors Help ΓòÉΓòÉΓòÉ

 The Color Dialog configures the background and foreground colors for all IRC
 windows.

 To configure the colors, select the Area Type from the list box at the top
 left of the dialog. Then press the desired radio button for the desired color
 for that area. Note the change in the Sample Display Area.

 Repeat the procedure above for all of the Area Types and until you are
 satisfied with the color configuration.

 If you would like to suppress mIrc color codes so that they are not displayed,
 check the "Strip mIrc Colors" check box.

 The Word Highlight List is a list of words, separated by spaces, which you
 would like to have highlighted in the output window. Words which are one
 character in length are ignored. The highlighting color used for these words
 is the same as that specified for Private Message highlighting. When placing
 words in this list you should specify the longest length words first to obtain
 the best results.

 Set - Press the Set push button to save the color configuration for future IRC
 sessions, terminate the Color dialog, and immediately set the colors for all
 IRC windows.

 Default - Press this push button to reset the colors to their default
 settings.

 Cancel - Press this push button to terminate the Colors dialog without making
 any changes.


ΓòÉΓòÉΓòÉ 38. Toolbar Help ΓòÉΓòÉΓòÉ

 The ToolBar dialog lets you define the commands which will be executed when
 you press the Toolbar icons for User Defined actions 1, 2, 3, or 4, in the
 Control, Channel, and Query Windows. The Toolbar dialog can be activated by
 using the Popup or Options menu.

 The commands that are executed from the Toolbar depend upon which window has
 the focus when a Toolbar icon is pressed. For each control, enter the command
 or text you would like to enter in either the Control, Channel, or Query
 Window when the respective Toolbar icon is clicked. The values entered should
 be exactly what would be entered at the command line if entering it manually.
 Note that the information bar to the right of the Toolbar will display the
 command that would be executed if the icon were pressed.

 Additional fuctionality can be obtained from the Toolbar commands by
 specifying a /RUN or /REXX command to execute commands from a text file or
 execute a REXX procedure respectfully.

 Note that /Commands executed from the toolbar may contain IRC variables to
 customize the commands for dynamic information such as your current nickname.
 See the /VAR command and IRC Variables section for more information on this
 feature.

 If the character sequence %% is embedded in the text of the command, the
 command will not be immediately executed. Instead it will be displayed in the
 Input Window without the %% characters. In addition, if the %% sequence is not
 at the end of the text, insert mode will be activated.

 The Toolbar icons appear on the DCC Chat and Send windows, but they are
 disabled on DCC windows.

 OK - Press the OK push button to save the definitions for future IRC sessions
 and terminate the Toolbar dialog.

 Cancel - Press this push button to terminate the Toolbar dialog without making
 any changes.

 The Toolbar dialog can be activated by using the Popup or Options - Toolbar
 menu option.


ΓòÉΓòÉΓòÉ 39. Join Help ΓòÉΓòÉΓòÉ

 This dialog is used to join a channel and is invoked by pressing the icon on
 the Toolbar or via the Popup menu. A new window is created for each channel
 joined.

 To join a channel in the list, select the channel and press the "OK" button,
 or simply double click on the channel entry.

 You may join a channel not listed by entering the name of the channel in the
 top line of the list box and pressing "OK".

 You may add a channel to the list by entering the name of the channel in the
 top line of the list box and pressing "Add". Up to 40 channel names can be
 saved.

 To delete a channel from the list, select the channel entry and press
 "Delete".

 The "Cancel" push button terminates the Join dialog without attempting to join
 a channel.


ΓòÉΓòÉΓòÉ 40. Query Help ΓòÉΓòÉΓòÉ

 This dialog is used to begin a query session with another nickname and is
 invoked by pressing the icon on the Toolbar or via the Popup menu.  A new
 window is created for each query initiated.

 To start a query, select the nickname from the list box and press the "OK"
 button, or simply double click on the nickname entry.

 You may query a nickname not listed by entering the nickname in the top line
 of the list box and pressing "OK".

 You may add a nickname to the list by entering the nickname in the top line of
 the list box and pressing "Add". Up to 100 names may be saved.

 To delete a nickname from the list, select the nickname entry and press
 "Delete".

 The "Cancel" push button terminates the Query dialog without initiating a
 query session.


ΓòÉΓòÉΓòÉ 41. Notify Dialog Help ΓòÉΓòÉΓòÉ

 This dialog is used to update the Notify nickname list and is invoked by
 pressing the icon on the Toolbar or via the Popup menu.

 To add a nickname to the list enter the nickname in the top line of the list
 box and press "Add". Up to 100 nicknames may be saved.

 To delete a nickname from the list, select the nickname entry and press
 "Delete".

 When you have finished updating the list press the "OK" button.

 When a user in the notify lists signs on or off of IRC you will be notified.
 Keep in mind that if a user changes their nickname it will be treated as if
 the user signed off of IRC.


ΓòÉΓòÉΓòÉ 42. DCC Chat Dialog ΓòÉΓòÉΓòÉ

 This dialog is presented when another IRC user has made an offer to join a
 private DCC chat session with you. The nickname of the user, their Internet IP
 Address and the TCP/IP Port are displayed.

 If you wish to accept the offer and join the private chat session, press the
 "Yes" button. If you do not wish to establish the session, press the "No"
 button.

 DCC Chat offers can be automatically refused by checking the "Disable DCC"
 checkbox in the Settings Dialog.


ΓòÉΓòÉΓòÉ 43. DCC File Offered Dialog ΓòÉΓòÉΓòÉ

 This dialog is presented when another IRC user has made an offer to send you a
 file via the DCC protocol. The nickname of the user, their Internet IP
 Address, the TCP/IP Port, the file size and the file name are displayed.

 The file name is prefixed with the default receive path, if any, as specified
 in the Settings Dialog. If no path is specified, the received file will be
 placed in the directory containing the GammaTech IRC software.

 You may change the path and or file name by overtyping in the file name field.

 If you wish to accept the offer to receive the file, press the "Yes" button.
 If you do not wish to receive the file, press the "No" button.

 DCC File offers can be automatically refused by checking the "Disable DCC"
 checkbox in the Settings Dialog.


ΓòÉΓòÉΓòÉ 44. Preferences Dialog ΓòÉΓòÉΓòÉ

 This dialog permits you to select various preferences regarding IRC
 processing. Each option available is described below.

 Automatic Nickname Resolution - This option indicates the action to be
 performed if a nickname collision occurs on an initial connection to a server.
 If this option is selected and a collision occurs, the following attempts will
 be made to resolve the nickname: If your nickname ends with a numeric
 character and that character is less than '9', a value of 1 will be added and
 the new nickname used. If your nickname does not end with a numeric character
 and if your nickname is less than 9 characters in length, then a 0 will be
 appended to your nickname and that nickname used.

 Nickname Highlighting - With this option selected, nicknames displayed in the
 output window are highlighted in accordance with the Colors selections. If
 this option is not selected, no highlighting is performed.

 Minimized Window Alerts - With this option selected, an alert beep is sounded
 each time a message arrives in a minimized window. This allows you to minimize
 windows for channels or queries with little traffic and be notified when
 message traffic does occur.

 Beep While Away - With this option selected you will receive a beep any time
 you receive a private message while you are marked away with the /AWAY
 command.

 Sort Names List - This option causes the nicknames displayed in the Names List
 window to be sorted in alphanumeric order. If this option is not selected the
 names are displayed in the order they joined the channel, most recent first.

 Initially Show Nick List - With this option checked, the Nick List subwindow
 will be automatically displayed when you join a channel.

 Do UserHost on Notify - When a user in your notify list signs on IRC you will
 be notified that the specified nickname has signed on. However, this nickname
 may be in use by someone other than you expect. Selecting this option causes
 an automatic /USERHOST command to be executed for the nickname which allows
 you to see the user@host mask of the nickname for further identification.

 Rejoin Chans on Reconnect - When you are disconnected from a server due to
 some error condition, and you reconnect to the same or a different server,
 this option will cause a automatic join for those channels you were on at the
 time of the disconnect. If this option is not selected you will not be joined
 with any channels when you reconnect. This option is ignored when GtIrc is
 terminated and restarted.

 Bells - Text directed to you or a channel you are on may contain special
 characters to sound a bell at your end. If the Bells checkbox is checked these
 characters will cause a bell to sound. If the checkbox is not checked, the
 bell will not be sounded.

 Bell Flag on Messages - Checking this option will append "[Bell]" to any
 message where a bell is sent so you can identify who rang the bell easily.

 Netsplit Notify - With this option checked a special notice message will be
 displayed when a netsplit occurs. The message will display the name of the
 server which split from the IRC network. You must be joined to a channel where
 users are split from the network for this feature to detect a netsplit.

 Mark Outbound Text With -> - Messages you send will normally be displayed in
 your window with a prefix of <yournick>. Checking this option will cause your
 messages to be displayed back to you with a prefix of -> instead of your
 nickname.

 Tabs - Text directed to you or a channel you are on may contain embedded tab
 characters. When a tab character is encountered it is expanded according to
 this parameter.

 Disable Ctrl-L/R Recall Keys - The Ctrl-Left and Ctrl-Right keys are
 overridden to recall the previous commands from the input command buffer. You
 may disable this function by checking this option and return those key
 sequences to their normal behavior.

 Hide Toolbar - The toolbar found between the output and input windows can be
 removed by selecting this option. Once this setting has been changed, GtIrc
 must be restarted to place the new setting into effect.

 Input Area Height in Lines - Specifies the height of the input area for each
 window in lines. Changes to this value take effect with new windows or when
 existing windows are resized.

 Default Kick Reason - If a reason is not specified on a Kick or Kick+Ban
 request, the text provided here is used. If no text is provided here, then
 your nickname is used for the reason text.

 Default Signoff Text: If a reason is not specified on a QUIT or SIGNOFF or BYE
 command, the text provided here is used. If no text is provided here then a
 reason of "Leaving" is used.

 Log File Path - This option specifies the path where you wish to place any log
 files. If the path does not exist it will be created.


ΓòÉΓòÉΓòÉ 45. CTCP Options Dialog ΓòÉΓòÉΓòÉ

 This dialog permits you to select various options relating to CTCP query
 processing. CTCP is the Client to Client Protocol. It is used to obtain
 various information about a server or another client. When someone wishes to
 know something about you they may use a CTCP query to obtain that information.
 You may also query information from servers or other clients. See the help on
 the following commands which do CTCP queries: /USERINFO /CLIENTINFO /PING
 /TIME /ECHO /FINGER /SOURCE /VERSION. Each option available is described
 below.

 DCC File Path - This parameter specifies the default drive and path where
 files transmitted to you via DCC will be placed. You will have the option to
 change this path on a file at a time basis. If no value is provided, the
 incoming files will be placed in the directory where the GammaTech IRC
 software is installed.

 DCC Blksize - This value is the requested transmission block size used when
 transferring files using DCC. The minimum size is 1 and the maximum size is
 28672 bytes. The default size is 4096. Sizes above 4096 are not recommended
 since the DCC protocol specifications establish a limit of 4096 for this
 value.

 Disable DCC - When this option is checked, incoming Direct Client to Client
 offers are automatically refused. DCC offers made by you are still permitted.
 This option prevents unwanted DCC requests from becoming an annoyance.

 Auto Accept DCC Gets - Enabling this feature causes all incoming DCC file
 transfers to be automatically accepted. Warning - this feature can open your
 system to denial of service attacks by users sending files to your system
 without authorization and exhausting your free disk space.

 Auto Accept DCC Chats - Enabling this feature causes all incoming DCC chat
 requests to be automatically accepted. A DCC Chat window will be automatically
 opened when a chat request is received.

 Flood Control - Some users of IRC take pleasure in what is called CTCP
 flooding. They do this by flooding the target client with many unwanted CTCP
 requests which often times results in the server closing the connection of the
 target client because it is sending too much data to the server in a limited
 time frame because it is attempting to respond to the many CTCP requests being
 received by the flooder.

 The Flood Control options provide a automatic method of protection against
 CTCP flooders. By setting limit values on the number of CTCP messages
 permitted in a given time frame your client can identify CTCP floods and
 execute an Ignore command on the flooder.

 The values you may specify are the number of messages and the number of
 seconds which when exceeded will be considered a flood. For example a value of
 5 messages and 10 seconds will cause your client to identify a flood when it
 receives 5 CTCP messages in less than 10 seconds. An automatic Ignore command
 will be executed and notification given to you, for each person sending a CTCP
 request to you from the 5th message on until the 10 seconds has elapsed. Note
 that a value of 0 for either the messages or seconds value disables the CTCP
 Flood Control feature.

 User Information - This field may be filled in with any text you desire, or
 left blank. Other IRC users may query this information by entering a /USERINFO
 command against your nickname. The information found here is returned to the
 requester in CTCP fashion. If no information is supplied here, the word "None"
 is returned.

 Client Information - Normally the Client Information request is responded to
 with a list of supported client features in CTCP fashion. If text is entered
 here that text is sent as a private message to the requester instead of the
 normal CTCP reply.

 Finger Information - Normally the Finger request is responded to with a your
 real name as entered in the Settings Dialog in normal CTCP fashion. If text is
 entered here that text is sent as a private message to the requester instead
 of the normal CTCP reply.

 Ping Information - Normally the Ping request is responded to by returning the
 received ping string to the caller in normal CTCP fashion. This permits the
 requester to determine the round trip reponse time between their client and
 your client. If text is entered here that text is sent as a private message to
 the requester as well as the normal CTCP reply.

 Echo Information - Normally the Echo request is responded to by returning the
 received echo text to the requester in normal CTCP fashion. This allows the
 requester to verify that connectivity with your client is present. If text is
 entered here that text is sent as a private message to the requester as well
 as the normal CTCP reply.

 Time Information - Normally the Time request is responded to by returning the
 date and time set on your local system in normal CTCP fashion. If text is
 entered here that text is sent as a private message to the requester instead
 of the normal CTCP reply.

 You may use IRC variables in any of the CTCP override fields. For additional
 information on IRC variables see the IRC Variables section and the /VAR
 command.


ΓòÉΓòÉΓòÉ 46. Startup and Script Dialog ΓòÉΓòÉΓòÉ

 This dialog is used to specify various startup options and script files.

 Initialization - This field may contain the file name of a stand alone REXX
 script to be executed when the GtIrc client initializes. The exit is executed
 only one time per execution of GtIrc when the first connection with an IRC
 server is made. A sample initialization script is provided with a file name of
 REXXINIT.CMD.

 Server Connect - This field may contain the file name of a stand alone REXX
 script to be executed each time a connection is made with an IRC server. A
 sample server connection script is provided with a file name of REXXCONN.CMD.

 Input Message Script - This parameter specifies the name of a REXX procedure
 script to be executed for each input message received from IRC. Using the REXX
 procedure language you may examine the message and perform actions including
 suppression of the message, display of additional text, execution of IRC
 commands and send text to the channel. You must have REXX installed to use
 this feature. A sample script is provided by the name of REXXMSG.CMD.

 Output Command Script - This parameter specifies the name of a REXX procedure
 script to be executed for each output command entered. Using the REXX
 procedure language you may examine the command and perform actions including
 suppression of the command, display of additional text, execution of IRC
 commands and send text to the channel. You must have REXX installed to use
 this feature. A sample script is provided by the name of REXXCMD.CMD.

 AutoJoin - By checking this checkbox and filling in the information to its
 right, the indicated channel(s) will be joined automatically when the initial
 connection to the server is made.

 The text area to the right must contain the parameter(s) for the Join command.
 Do not specify /JOIN here, only the parameters. See the Command Help for the
 Join command for additional information.

 Script Programming Click here for more information on scripts.


ΓòÉΓòÉΓòÉ 47. Script Programming ΓòÉΓòÉΓòÉ

Scripts are written in REXX. A working knowledege of Procedure Language REXX is
assummend.

There are several exit routines each of which calls a different script file. In
addition you may create and execute stand alone REXX procedures to execute from
the toolbar or command line using the /REXX or /SCR command.

The Initialization script is called only one time for each execution of GtIrc
when the first connection is made with an IRC server.

The Server Connect script is called each time a connection is made with an IRC
server.

The message exit is called each time a message is received from the IRC server
and before it is processed by the client. You may use this exit to automate
actions when certain events occur such as when someone joins a channel you are
on.

The command exit is called each time you enter text to IRC and before the text
is processed. You may use this exit to create aliases for other commands, add
new commands of your own, etc.

Stand alone scripts are executed using the /REXX command.

Sample scripts are provided as examples. Do not alter the sample scripts.
Instead, copy them to new names and modify the copies. It is also strongly
recommended that you test your scripts from the OS/2 command line before using
them on IRC. Debugging is much easier from the command line.

Refer to the sample scripts for parameters passed to the scripts and examples
of use. The sample scripts are located in the GTIRC directory with the
following names:

   REXXINIT.CMD  Sample Command Exit
   REXXCONN.CMD  Sample Command Exit
   REXXCMD.CMD   Sample Command Exit
   REXXMSG.CMD   Sample Message Exit
   REXXSCR.CMD   Stand alone Script

The return string from the REXX exit indicates if the associated message or
command should be processed normally or suppressed. To suppress the message,
return a null string. To process the message normally return a string such as
"OK",

Be aware that suppressing messages from the server can result in unpredictable
behavior by the GammaTech IRC client. Be careful when suppressing important
messages. The client keys off of many different messages for internal
processing. In addition, keep your script processing to a minimum. Performance
problems can result if excessive processing is performed.

There are several external functions available to the exit scripts which are
described below.

IrcRexxDisplay(text,win)

   This function displays "text" in the window. It does not send the text over
   IRC. The "text" parameter is a null terminated string containing the text to
   display.

   The "win" parameter describes the window in which to display the text. Use a
   null string to cause the text to be displayed in the control window. To
   display the text in the window where the message would normally be
   displayed, use the first argument passed to this procedure.

 IrcRexxCommand(text,win)

   This function sends "text" over IRC. The "text" is a null terminated string
   containing the text to be sent. The text may be text to the channel or a IRC
   command.

   The "win" parameter describes the window in which to display the output of
   the text or command. Use a null string to cause the output to be displayed
   in the control window. To display the output in the window where the
   message would normally be displayed, use the first argument passed to this
   procedure.

 IrcRexxSend(text,win)

   This function sends the "text" as a raw string directly to the server. A
   carriage return and line feed is appended to the text before transmission.

   The "win" parameter should be specified but it is ignored at this time. It
   is reserved for future use.

 IrcRexxVariable(win,name[,value])

   This function retreives or sets the value of a IRC variable. If "value" is
   specified, the variables value is set to that value. If a null string ("")
   is specified for "value" the variable is deleted from the variable pool. If
   "value" is not specified then the value for the specified variable is
   returned. If the variable does not exist or has not been set then "" is
   returned.

   In all cases the return value is the value of the variable if the request
   was successful or a null string ("") is the request failed.

   The "win" parameter is required but ignored at this time. It is reserved for
   future use.

   Note that these variables can also be set from the command line using the
   /VAR command. For more information of IRC variables see the IRC Variables
   section.

 IrcRexxWildCard(wildcard,string)

   This function checks "string" for a match against "wildcard". A return value
   of MATCH or NOMATCH is returned.


ΓòÉΓòÉΓòÉ 48. Channel Mode Help ΓòÉΓòÉΓòÉ

 The channel mode dialog is available for channel windows and is accessed via
 the output window pop-up menu. This dialog is used to view and change channel
 modes and the channel topic.

 To alter the channel modes check and uncheck the appropriate check boxes and
 press the Change button. You must be a channel operator to change the channel
 modes. If you are not a channel operator the Change button will be disabled.

 A description of the various channel modes is shown below:

  p   The channel is private.

  s   The channel is secret.

  i   Channel is invite only. Users joining must be invited first.

  t   The channel topic may be set only by channel operators.

  n   No messages from outside the channel may be sent to this channel.

  m   The channel is moderated. Only chanops and those they designate may talk.

  l   Sets a channel limit. No more than the number of users specified will be
      permitted to join the channel. To set a limit specify the limit in the
      entry field. A limit of 0 removes the limit.

  k   Sets a channel key (password) which must be specified by users joining
      the channel. To set or change a key specify the key in the entry field.
      To remove a key delete the key from the entry field.


ΓòÉΓòÉΓòÉ 49. User Mode Help ΓòÉΓòÉΓòÉ

 The user mode dialog is accessed via the output window pop-up menu. This
 dialog is used to view and change your user mode.

 To alter the user mode check and uncheck the appropriate check boxes and press
 the Change button.

 A description of the various user modes is shown below:

  i   Your nickname is invisible to anyone who does not know it's exact
      spelling.

  s   This client is to receive server notices.

  w   This client is to receive wallops messages. These are messages to all
      IRCops. If this mode is set, wallops messages received are displayed in
      the Control output window only.

  d   Deaf mode suppresses all public (channel) messages to this user. Private
      messages are still received. Suppression occurs at the server level. You
      may use this mode if you wish to suspend public messages while you are
      away so that any private messages will likely be available for viewing
      when you return. Note that this mode is not available on all IRC servers
      so you may receive an error attempting to set it.


ΓòÉΓòÉΓòÉ 50. BanList Dialog ΓòÉΓòÉΓòÉ

 The Ban List dialog is accessed via the output window pop-up menu. This dialog
 is used to view and change the ban list for a channel. Only channel operators
 may alter the ban list but anyone may view it.

 Close - The close button terminates the dialog. Press it when you are finished
 making changes or viewing the ban list.

 Ban - This button allows you to add an entry to the ban list. When pressed,
 another dialog will appear where you enter the ban mask.

 UnBan - This button removes the ban on all selected entries in the list box.

 Edit - This button allows you to edit the selected ban mask. If more than one
 entry is selected, only the first selected entry will be presented for
 editing.

 Mass UnBan - This button unbans all entries whether selected or not. In
 effect, it purges the ban list.


ΓòÉΓòÉΓòÉ 51. Sound Dialog ΓòÉΓòÉΓòÉ

 The Sound settings dialog is accessed via the Options menu item. This dialog
 is used to view and configure your preferences regarding sound file
 processing.

 Wav File Search Paths - The paths specified here will be searched for the wave
 file which is to be played. You may add or delete paths from this list. The
 path which is selected when you press the "OK" button will be presented first
 when you wish to select a wav file to be played by another client.

 Permit Playing of Sounds - Check this option to enable the playing of wav
 files when the CTCP SOUND message is received from another client. Disable
 this option if you do not wish to receive these sounds.

 Play Locally - Normally sounds you send are not played on your machine.
 Checking this box will play sounds you send on your machine as well as the
 target machines.

 OK - Press this button to save any changes to this dialog. The selected path
 entry at this time will be the default path to search when you issue a /SOUND
 command.

 Cancel - Press this button to exit the dialog without saving any changes.

 Add - A new path can be added to the list by entering the path in the entry
 field at the top of the list box and pressing the "Add" button.

 Delete - Press this button after selecting an entry to delete it.

 Help - Pressing this button displays this help information.


ΓòÉΓòÉΓòÉ 52. On Message Dialog ΓòÉΓòÉΓòÉ

 The On Message dialog is accessed via the Options menu item. This dialog is
 used to execute special actions when a specified string of text is received by
 your client in the form of a message to you.

 ON Message Text - This field specifies the text which will cause an action to
 occur if it is found in the message sent to you by another client and which
 matches the message type specified. The text is not case sensitive.

 Anywhere in message - When checked, the compare for the text will match if it
 is found anywhere in the message text. Otherwise the matching text must appear
 at the beginning of the text.

 Msg Type - Specifies the type of message to be checked for the matching text.
 Available message types are described below:

   Priv Msg - Private messages.

   CTCP - CTCP messages.

   Priv Notice - Private notices.

   Special - Special GtIrc notices such as flood detection.

   Serv Notice - Server notices.

   Wallop - IRC operator wallop messages.

 Option - Specifies one of the available actions to be performed when the
 specified message text occurs. The available options are described below.

   Disabled - Indicates no action should be taken. This is useful if you wish
   to temporarily disable an item.

   Beep - causes a short beep to be sounded on your machine.

   Play Wav - Causes a specified multimedia wav file to be played on your
   machine.

   Send File - Executes a DCC SEND to send a specified file from your system to
   the requesting client system.

   Priv Msg - Reads a specified ASCII text file on your machine and sends each
   line as a private message to the requesting client. Lines of text in the
   ASCII file should not exceed 256 characters in length.

   Exec Rexx - Executes the stand alone REXX script specified in the File Name
   field. The 4th argument passed to the REXX script is the entire raw IRC
   message.

 File Name - This field specifies the file name for the related option. This
 field is not required for the Beep option. If the file name is not fully
 qualified the GtIrc directory will be searched for it. In the case of a wav
 file used with the "Play Wav" option, the wav paths will be searched as
 specified on the Sound Dialog.

 For example, to play a wav file with a name of water.wav when a private
 message is received containing the text "turn faucet on", the On Message Text
 field would contain "turn faucet on" (without the "'s), the Msg Type field
 would be set to "Priv Msg", the                Play Wav, and the Option field
 would be set to File Name field would contain "water.wav" (without the "'s).

 To add an entry to the list, fill in the ON Message Text, Option and FIle Name
 fields and press the Add push button.

 To update an existing entry, click on the entry in the Current Entries list
 box, modify the fields as desired and press the Update push button.

 To delete an entry, click on the entry in the Current Entries list box, then
 press the Delete push button.

 OK - Press this button when you have finished viewing or changing the ON
 Message entries.

 Add - Press this button to add a new entry to the Current Entries.

 Update - Press this button after selecting and modifying an entry to update
 it.

 Delete - Press this button after selecting an entry to delete it.

 Help - Pressing this button displays this help information.


ΓòÉΓòÉΓòÉ 53. IRC Variables ΓòÉΓòÉΓòÉ

IRC variables are useful for in REXX scripts as well as for automatic
substitution in /Commands, CTCP reply overrides and user Toolbar definitions.
There are certain system variables available to the customer and the customer
can define and set their own variable names using the /VAR command or the
IrcRexxVariable() REXX function.

You may set the value of IRC variables you define when GtIrc starts each time
by use of the Initialize script defined in the Startup Dialog. For an example
of how this is done, refer to the example initialize script REXXINIT.CMD.

Whenever a valid $Variable is encountered in a /Command or in a CTCP override
string, the associated value for that $Variable replaces the $Variable in that
string and the new string is used for processing.

IRC variable names always begin with a $ character, They are case sensitive and
are limited to 32 characters in length including the $ character. They may not
contain embedded spaces or commas.

All system variables are upper case. It is recommended that user variables be
either lower case or mixed case to avoid future naming conflicts. System
variables cannot be altered or removed by the user.

IRC variables are assigned out of a variable pool. There are approximately 400
entries in the pool available for user variables.

The following system variables are available:

$AWAY - This variable is set to "AWAY" if you are set away or to "HERE" if you
are not set away.

$CHANNELNAME - The name of the channel. This variable is valid only for channel
windows.

$F2 - $F9 - When these variables are set, you may cause their values to be
inserted at the cursor location in the inout window by pressing the F2 - F9
keys. If the corresponding variable is not set, no action is taken when the Fx
key is pressed. Note that the value of the $Fx variables may contain other
$variables.

$NICK - This variable contains your current nickname.

$PORT - Contains the port address on the server you are connected with.

$REALNAME - This variable contains your real name from the settings dialog.

$SELECTEDNICK - The first nickname selected in the nicklist. This variable is
only valid for channel windows.

$SERVER - Contains the name of the server you are currently connected with.

$TIMEIDLE - This variable contains the number of seconds since a command or
text was entered.

$TIMEONCHAN - This variable contains the time in seconds that the client has
been joined with the respective channel. This variable is only valid for
channel windows.

$TIMEONSERV - This variable contains the time in seconds that the client has
been connected with the current IRC server. If there is no connection with a
server at the time the variable is queried a value of 0 is returned.

$USERHOST - This variable contains your user@host name as the IRC server knows
you. If you are not connected to a server when this variable is queried, a null
string is returned.

$USERNAME - This variable contains your user name from the settings dialog.

$VERSION - This variable contains the name and version of the executing IRC
client. i.e. "GtIrc 2.03"  For additional information refer to the /VAR command
and the REXX scripts section, particularly the IrcRexxVariable() function.


ΓòÉΓòÉΓòÉ 54. Messages Dialog ΓòÉΓòÉΓòÉ

 This dialog permits you to select various message related options and
 customize message routing of various types of messages.

 Message Routing - Several types of messages can be suppressed or rerouted to a
 specific window. Suppressed messages are not displayed at all. If the Send To
 Current Window option is selected then the message is sent to the current
 window in addition to where ever else it might be displayed.

 To select the message type, click on the arrow of the Message type box and
 scroll to the desired message type, then click on the type. The current
 routing options for that message type are then displayed.

 The Suppress Message option prevents the message from being displayed
 anywhere.

 The Send To Current Window option will cause the message to be sent to the
 current window also if it is not the same as the window where the message
 would otherwise be routed.

 The Route to Window area may be used to place the name of a window where you
 wish to have the message displayed. This can be the name of a channel or the
 name of a query window. You may also route to the main server window by
 specifying a name of ".server".  For example, you may wish to have all server
 notices displayed in a window called "Notices". You would then place the word
 Notices in the Route to Window area and then open a query window with /query
 Notices. If a window does not exist with the specified name, the message is
 routed normally as if no name were provided. In addition, when routing private
 messages to a specific window, those messages will only be routed there if
 there is no open query for the sender of the message.

 Beep on priv msg - Selecting this option will cause a series of beeps to sound
 any time a private message is received for you. It is similar to the "Beep
 while Away" option except you are notified even through you are not away.

 Add user@host to Join Msg - Selecting this option causes the user@host to be
 appended to the Join message when a user joins a channel you are on. This
 permits further identification of the joining user. The draw back is that the
 join message is increased in length adding clutter to the display.

 Open Query on Priv Msg - Selecting this option will cause a Query window to be
 opened automatically when a private message is received. The private message
 will be displayed in the query window. If this option is not selected the
 private message is displayed in the current window.

 Add user@host to Priv Msg - This option will append the senders [e-mail]
 to all private messages sent to you. However, if you have a query window open
 for the sending user the [e-mail] is not added to the message.

 Away Message Recording - When this feature is checked, all private messages to
 you will be recorded to a file while you are marked as away. When you return,
 all recorded messages are played back and the file is deleted.

 Timestamp Priv Msgs - This feature specifies if and when a time in HH:MM
 format should be appended to all private messages to you.  The available
 options are "Never", "Always", and "When Away".  The "When Away" option means
 timestamps are to be used only when you are marked as being away.


ΓòÉΓòÉΓòÉ 55. Connection Help ΓòÉΓòÉΓòÉ

 This dialog is used to configure your server networks and servers and to
 connect with a IRC server. To simply connect to a server, select the desired
 server from the list and press the "Connect" button.

 IRC Network - You may configure your desired servers in groups by network.
 When GtIrc is initially installed it configures a few default networks. To
 list the configured networks click on the down arrow at the right of the
 Network name control.

 Add Network - Use this button to add new networks of your choice. The Network
 name must be a unique name. Once the network entry has been added you will
 need to add servers to it before it can be used to connect with a server.

 Delete Network - Pressing this button will delete the selected Network from
 the configuration and all servers defined for this network. You will be
 prompted to verify you really wish to do this.

 IRC Server - This drop down list contains the list of IRC servers for the
 selected network. To connect with a server select it's name here then press
 the "Connect" button.

 Port - This field displays the port for the selected server. You may change
 the port used for this server with the "Edit" feature.

 Desc - This field displays descriptive information about the selected server.
 You may edit the description using the "Edit" feature. This field is not used
 by GtIrc so you may put what ever information you desire here.

 Arrange - When automatically connecting to a server, connection attempts are
 made with each server in the list starting with the top most entry. To
 rearrange the server list so that your most desired servers are tried first,
 click on the "Arrange" button.

 Add - Click here to add a new server to the list of servers for the selected
 network.

 Edit - A number of items may be configured or displayed about a specific
 server such as the port number, connection preferences and IP address. Click
 here to view or edit these values for the selected server.

 Delete - This button removes the selected server from the server list.

 Automatically Connect - When selected, the client will, on start up,
 automatically attempt to locate the selected network and the most desired
 server for that network, and then attempt connection with that server.

 Connect - Press this button when the desired server is selected to initiate
 the connection attempt.

 Cancel - Press this button to leave this dialog without connecting to a
 server.

 Help - Pressing "Help" gives you this help panel.


ΓòÉΓòÉΓòÉ 56. Server Help ΓòÉΓòÉΓòÉ

 This dialog is presented when adding a new server to the server list or when
 editing an existing server entry.

 Server - This is the server name. Normally it should be the host name of the
 desired IRC server however, you may specify a IP address here also. For "Edit"
 this field displays the server name but it cannot be changed. For "Add"
 operations this name must be a unique name. The server name field contains
 only the server name. Port and password information are not included here as
 they are specified else where.

 Desc - This is a description field for the selected server entry. This field
 is not used by the client so you may put whatever comments you wish here or
 leave it empty.

 Port - This field specifies the port via which to connect with the IRC server.
 The default is 6667 which is the standard port for client connections with IRC
 servers. Some servers permit connecting on additional ports and connection
 performance can sometimes be improved by connecting on one of these additional
 ports. You may set the port to any desired value except it may not be zero.
 This field is required.

 Password - Some private IRC networks require a password to connect with their
 server. For public networks this field should be left empty. If you are
 configuring a server which requires a password specify that password here.
 Note that this is a protected field and displays asterisks instead of the
 actual password.

 Bypass DNS - This option is used to bypass the normal DNS lookup. It is only
 valid if a previous connection with the selected server has been made and the
 "IP Addr" field contains the IP address of the server. If this option is not
 checked and if the server name is specified as an IP address instead of a
 domain name, DNS lookup is automatically bypassed.

 Provide Ident - When this option is selected a pseudo Ident daemon will be
 executed during the connection attempt for this server. The authenticated user
 name returned by the Ident daemon will be the user name specified in the
 "Settings Dialog".

 Reconnect - Normally when a connection fails you will be notified and then you
 must reconnect to a server manually. With this option selected, a connection
 will be attempted automatically with the selected server. This reconnect will
 be attempted as many times as the value of "Connect Attempts". If the "Jump to
 Next Server" option is also selected, the current server is tried before a
 server jump is made.

 Jump to Next Server - When this option is selected, during initial connections
 or recovery for failed connections, if connection with the current server
 fails after the specified number of attempts, the client will attempt to
 locate the next server in the list which has a non-zero Connect Attempts value
 and attempt to connect with that server.

 Network - This is a display only field which shows the network for which this
 server is related.

 IP Addr: - This is a read only field. Once a connection has been made to the
 selected server, the IP Addr field will be filled in, or updated as the case
 may be, automatically. After this has occurred you may bypass the DNS lookup
 process for faster connections by checking the "Bypass DNS" checkbox.

 Connect Attempts: - This value determines the number of times the client will
 initially attempt to connect with the server. If the "Reconnect" box is
 checked, this value also is used for reconnection attempts. To prevent
 automatic connection or reconnection attempts with a server set the value of
 Connect Attempts to zero.

 Done - Click this button when you are finished configuring the server fields.

 Cancel - Press this button to leave this dialog without making any changes.

 Help - Pressing "Help" gives you this help panel.


ΓòÉΓòÉΓòÉ 57. Server Arrange Help ΓòÉΓòÉΓòÉ

 This dialog is used to arrange the server list for the selected network such
 that preferred servers will be attempted first during automatic connection or
 reconnection attempts.

 The servers for the selected network are displayed in the list box. The most
 desired server is at the top of the list and the least desired server is at
 the bottom of the list.

 To change the order of the list, select the server you wish to reposition,
 then click on the "Up" or "Down" button to move it up or down in the list
 respectively.

 Once you have completed ordering of the list, press the "Done" button to save
 the changes and leave the dialog.

 The "Help" button displays this help panel.


ΓòÉΓòÉΓòÉ 58. IRC Commands Help ΓòÉΓòÉΓòÉ

 A list of the supported IRC commands is shown below. Double click on the
 desired command to display additional information, syntax and command
 examples. Note that when entering an IRC command, it must be preceded by a /
 character. For example to execute the LEAVE command you would type /LEAVE.

 Note that IRC variables may be used in /Commands to substitute dynamic
 information such as your nickname. See the section on IRC Variables and the
 /VAR command for more information on this feature.

  ACTION           Send an action message to a channel.
  ADMIN            Display administrator information.
  ALL              Send public message to all channels.
  ALLME            Send action message to all channels.
  AWAY             Set or reset away status.
  AWAYMSG          Send away msg to all channels and set away.
  BYE              Terminate IRC.
  CLEAR            Clear the output window.
  CLIENTINFO       Check CTCP capabilities of a user.
  CTCP             Send custom CTCP command.
  DATE             Display the time from a server or user.
  DCC CHAT         Offer a DCC Chat session with another user.
  DCC SEND         Send a file via DCC to another user.
  DEOP             Remove IRC operator privileges.
  DISCONNECT       Disconnect from the IRC Server.
  DNS              Perform DNS lookup.
  ECHO             Echo a text string to and from another client.
  F (Find)         Find text in the output window.
  FINGER           Display a users real name.
  IGNORE           Ignore messages from other users.
  INFO             Display information about the IRC creators.
  INVITE           Invite a user to join a channel.
  IRCTRACE         Write raw IRC messages to a trace file.
  ISON             See if specific users are on IRC.
  JOIN             Join a channel.
  KICK             Kick someone off of a channel.
  KILL             Terminate a users IRC connection.
  KLINE            Ban user from server.
  LEAVE            Close a channel or query.
  LINKS            Display server links.
  LIST             Display existing channels.
  LOG              Write log file of message traffic.
  LUSERS           Display summary of users, servers and operators.
  MAP              Display servers connected to network.
  ME               Send an action message to a channel.
  MENU             Add custom menu items.
  MODE             Set a channel or user's mode.
  MOTD             Display a servers Message Of The Day.
  MSG              Send a private message.
  NAMES            See who is on a channel.
  NICK             Change your nickname.
  NL               Toggle Nicklist window on or off.
  NOTICE           Send a notice message.
  NOTIFY           Notify when users join or leave IRC.
  OMSG             Send message to all chan-ops.
  ONOT             Send notice to all chan-ops.
  OPER             Set IRC operator status.
  PING             Check network response time.
  QUERY            Open a Query Window.
  QUIT             Terminate IRC.
  RAW              Send raw text to the server.
  REHASH           Force server to reread it's config file.
  RESTART          Force server to reread it's config file.
  REXX             Execute a stand alone REXX procedure script.
  RUN              Execute IRC commands from a file.
  SCR              Execute a stand alone REXX procedure script.
  SERVER           Connect to or change IRC servers.
  SIGNOFF          Terminate IRC.
  SILENCE          Silence private messages at the server.
  SNAP             Record current srcoll buffer to a file.
  SOUND            Send a sound to another client.
  SOURCE           Display where to obtain a users client software.
  SQUIT            Disconnect a server from the IRC network.
  STATS            Query a servers statistics.
  SUMMON           Invite a user to join IRC.
  TIME             Display the time from a server or user.
  TIMER            Manage event timers.
  TOPIC            Display or set a channel topic.
  UMODE            Display or set your user mode.
  USERHOST         Display information about a user.
  USERINFO         Display a users information string.
  USERIP           Display the IP address of a user.
  USERS            Display users connected to a server.
  VAR              Set, display and modify IRC $Variables.
  VERSION          Display the name and version of a users IRC client.
  WALLOPS          Send a message to all IRC Operators.
  WHO              List users on a channel or IRC.
  WHOIS            Display detail about a nickname.
  WHOWAS           Display history detail about a nickname.


ΓòÉΓòÉΓòÉ 59. ADMIN Command ΓòÉΓòÉΓòÉ

 The ADMIN command displays information regarding the administration of an IRC
 server.

 Syntax: /ADMIN [servername | nickname]

 If the server name is omitted, information for the server you are connected
 with will be displayed. If a nickname is specified, information about the
 server on which that client is connected will be displayed.

 Examples:

     /ADMIN

     /ADMIN irc.texas.net

     /ADMIN george admin


ΓòÉΓòÉΓòÉ 60. ALL Command ΓòÉΓòÉΓòÉ

 The ALL command sends a public message to all channels to which you are
 joined.

 Syntax: /ALL text

 Example:

     /ALL Guess who won the Superbowl?


ΓòÉΓòÉΓòÉ 61. ALLME Command ΓòÉΓòÉΓòÉ

 The ALLME command sends a action message to all channels to which you are
 joined.

 Syntax: /ALLME text

 Example:

     /ALLME is very tired.


ΓòÉΓòÉΓòÉ 62. AWAY Command ΓòÉΓòÉΓòÉ

 The AWAY command is used to notify other IRC users that you are away and will
 not be responding to messages. When the Away status is set, and an IRC user
 sends you a private message, a response is returned to that user explaining
 that you are away and the reason.

 Syntax: /AWAY [reason]

 When a reason is given, you set as Away. When no reason is provided, you are
 set as not Away.

 Examples:

     /AWAY gone to eat

     /AWAY


ΓòÉΓòÉΓòÉ 63. AWAYMSG Command ΓòÉΓòÉΓòÉ

 The AWAYMSG command is used to notify other IRC users that you are away and
 will not be responding to messages. When the Away status is set, and an IRC
 user sends you a private message, a response is returned to that user
 explaining that you are away and the reason.

 The AWAYMSG command differs from the AWAY command in that it also sends a
 action message to all channels to which you are joined and sets you away with
 the same message text.

 Syntax: /AWAYMSG [reason][*]

 The command should be entered like a /ME or /ACTION message since your
 nickname will prefix the message sent to the channels.

 If a "*" is specified for a reason, a message saying you are back is sent to
 all channels and you are marked as not away.

 If a reason is not provided, a default reason will be used.

 Examples:

     /AWAYMSG gone to eat, [/msg will beep]

     /AWAYMSG


ΓòÉΓòÉΓòÉ 64. BYE Command ΓòÉΓòÉΓòÉ

 The BYE command terminates your IRC session. A reason may be given which is
 broadcast to the participants of any channels you had joined.

 Syntax: /BYE [reason]

 If a reason is not provided, the reason specified in the Preferences Dialog is
 used. If no reason is found there a reason of "Leaving" is used.

 This command is synonymous with "QUIT" and "SIGNOFF".

 You may also use the File - Signoff menu option to terminate your IRC session.

 Examples:

     /BYE going to class


ΓòÉΓòÉΓòÉ 65. CLEAR Command ΓòÉΓòÉΓòÉ

 The CLEAR command clears the output window.

 Syntax: /CLEAR

 The scroll buffer is purged and the output window cleared.

 This command may be abbreviated /CLE.

 Examples:

     /CLEAR

     /CLE


ΓòÉΓòÉΓòÉ 66. CLIENTINFO Command ΓòÉΓòÉΓòÉ

 The CLIENTINFO command sends a request to the specified IRC user client
 software asking what CTCP (Client To Client Protocol) commands are supported.

 Syntax: /CLIENTINFO nickname

 Providing that the client software for "nickname" supports the CLIENTINFO
 command, a list of supported commands will be returned. Clients that do not
 support CLIENTINFO may return an error message, or nothing at all. Some
 clients may return information other than that expected.

 Examples:

     /CLIENTINFO george  Result:

     *** CLIENTINFO (george): VERSION CLIENTINFO PING FINGER


ΓòÉΓòÉΓòÉ 67. CTCP Command ΓòÉΓòÉΓòÉ

 The CTCP command allows you to send custom CTCP command requests to another
 nick.

 Syntax: /CTCP nickname command-text

 Most standard CTCP commands are supported by the GammaTech IRC Client by their
 own commands. For example, see /PING or /VERSION. This command allows one to
 send a customized CTCP command that is not otherwise supported.

 Examples:

     /CTCP george VER


ΓòÉΓòÉΓòÉ 68. DATE Command ΓòÉΓòÉΓòÉ

 The DATE command queries the requested server of client for the current time
 at that location. The DATE command is synonymous with the TIME command.

 Syntax: /DATE [servername] [nickname]

 If no server or client name is provided, the request is made to the server on
 which you are connected. If a nickname is provided, the request is sent to the
 client software used by the nickname as a CTCP command. Not all IRC clients
 support CTCP TIME requests so information returned may not be that which is
 expected or no response may be given at all.

 Examples:

     /DATE

     /DATE irc.texas.net

     /DATE george  Results:

     *** irc.texas.net : Tuesday March 28 1995 -- 08:47 -06:00

     *** TIME (george): Tue Mar 28 08:47:15 1995


ΓòÉΓòÉΓòÉ 69. DCC CHAT Command ΓòÉΓòÉΓòÉ

 The DCC CHAT command is used to initiate a private DCC chat session with
 another user.

 Syntax: /DCC CHAT nickname

 When this command is entered, the user specified is notified that you wish to
 establish a DCC Chat session with them. They then have the option to accept
 the offer and establish the chat session or decline the offer. In any event, a
 new window is created where the chat session will take place if it is
 accepted.

 The DCC chat session is conducted as a direct client to client session and is
 therefore more secure since it does not use the IRC network for message
 traffic. The session is not affected by netsplits or server outages and you
 can change servers without impacting the DCC Chat session.

 Example:

     /DCC CHAT george


ΓòÉΓòÉΓòÉ 70. DCC SEND Command ΓòÉΓòÉΓòÉ

 The DCC SEND command is used to transmit a file to another user.

 Syntax: /DCC SEND nickname [file.name]

 If the file name is not provided a standard files dialog is presented by which
 you may select a file to be transmitted.

 When this command is entered, the user specified is notified that you wish to
 send them a file. They then have the option to accept the offer and receive
 the file or decline the offer. In any event, a new window is created where the
 file transfer session will take place if it is accepted.

 The DCC SEND session is conducted as a direct client to client session and is
 therefore not affected by server performance netsplits or server outages.
 Changing servers will not impact the DCC file transfer.

 Example:

     /DCC SEND george myfile.dat


ΓòÉΓòÉΓòÉ 71. DEOP Command ΓòÉΓòÉΓòÉ

 The DEOP command removes IRC operator status.

 Syntax: /DEOP

 This command is used by a user with IRC operator privileges to remove IRC
 operator status from themselves.

 Example:

     /DEOP


ΓòÉΓòÉΓòÉ 72. DISCONNECT Command ΓòÉΓòÉΓòÉ

 The DISCONNECT command closes the session with the IRC server. It does not
 however shut down the client as the QUIT command does. In addition, DCC
 sessions are not impacted. After disconnect they user may later connect to the
 IRC server again.

 Syntax: /DISCONNECT [comments]

 The command may be abbreviated "DISC".

 If comments are provided they are included in the signoff message on the IRC
 network. If no comment is provided, the default signoff text is used. If no
 default signoff text is provided the text "Leaving" is used.

 Example:

     /DISC Bye bye folks


ΓòÉΓòÉΓòÉ 73. DNS Command ΓòÉΓòÉΓòÉ

 The DNS command provides online DNS lookups.

 Syntax: /DNS hostname|IPaddress

 Either the hostname or IP address may be provided.

 Example:

     /DNS orville.somewhere.com

     /DNS 202.111.37.15


ΓòÉΓòÉΓòÉ 74. ECHO Command ΓòÉΓòÉΓòÉ

 The ECHO command sends a string of text to the requested IRC users client
 software which in turn sends it back unchanged.

 Syntax: /ECHO nickname text

 The ECHO command uses the CTCP protocol to send the request to the client. Not
 all IRC client software supports the CTCP ECHO command. For this reason, an
 error message may be returned, or text which is not expected, or no response
 at all.

 Example:

     /ECHO george Hello world

 Result:

     *** ECHO (george): Hello world


ΓòÉΓòÉΓòÉ 75. F (Find) Command ΓòÉΓòÉΓòÉ

 The F command locates text in the output window.

 Syntax: /F[-|+] [text]

 Specifying /F- searches backward in the buffer. If a [text] string is supplied
 this is the default. If no text is supplied the default will be the last - or
 + flag specified on a previous /F command. On an initial search with /F- the
 search begins with the last line on the display. Otherwise the search begins
 at the first line which contains selected text. This line is normally the line
 where the last find command selected text.

 Specifying /F+ searches forward in the text. If [text] is specified the search
 will begin with the first line displayed. If no text is provided the search
 begins at the first line which contains selected text. This line is normally
 the line where the last find command selected text.

 If the text is found it will be selected. If the text cannot be found a beep
 is sounded and the display is not changed.

 The search for the text string is case insensitive. The text may consist of
 multiple words but may not span more than one line.

 Examples:

     /F any text

     /F+ my text

     /F+

     /F-

     /F


ΓòÉΓòÉΓòÉ 76. FINGER Command ΓòÉΓòÉΓòÉ

 The FINGER command displays the real name and idle time of an IRC user.

 Syntax: /FINGER nickname

 The FINGER command uses the CTCP protocol to send the request to the client.
 Not all IRC client software supports the CTCP FINGER command. For this reason,
 an error message may be returned, or text other than that expected, or no
 response at all.

 Example:

     /FINGER george

 Result:

     ***FINGER (george): George D. Smith, Idle 15 seconds


ΓòÉΓòÉΓòÉ 77. IGNORE Command ΓòÉΓòÉΓòÉ

 The IGNORE command allows you to block messages from another user so that they
 are not displayed in your IRC windows.

 Syntax: /IGNORE [nickname|user@host] [+|-type ...]

 Syntax: /IGNORE -

 If no parameters are specified, the ignore list is displayed.

 If the only parameter is a "-" then the ignore list is purged.

 If only the nickname or user@host parameter is specified, all messages for
 that user will be ignored.

 Either the nickname or a user@host mask for the user may be specified.  If a
 user@host mask is specified it should be in the form of nick!user@host. i.e.
 *!*[e-mail]. You may obtain the users user@hostname using the
 WHOIS or USERHOST command.

 You may specify the types of messages to be ignored. Specifying a "+" will
 cause the associated message type to be ignored.  Specifying a "-" will allow
 those message types through if previously they were set to be ignored. If
 neither "+" or "-" are specified "+" is assumed.  The allowable message types
 are shown below. If no type is provided, ALL is assumed.

  MSGS       Private messages to you.
  CHAN       Messages to channels.
  INV        Invites.
  CTCP       CTCP command requests.
  ALL        All messages.

 The ignore list is not retained from IRC session to IRC session.

 Examples:

     /IGNORE george

     /IGNORE george MSGS CTCP

     /IGNORE george +MSGS +CTCP

     /IGNORE george -

     /IGNORE george -MSGS

     /IGNORE -


ΓòÉΓòÉΓòÉ 78. INFO Command ΓòÉΓòÉΓòÉ

 The INFO command shows information regarding people related to the development
 of Internet Relay Chat.

 Syntax: /INFO [server]

 If server is not provided, the server to which you are connected responds to
 the command. Otherwise it is sent to the requested server for processing.

 Examples:

     /INFO

     /INFO irc.texas.net


ΓòÉΓòÉΓòÉ 79. INVITE Command ΓòÉΓòÉΓòÉ

 Invite a user to join a channel.

 Syntax: /INVITE nickname [channel]

 If channel is not specified, the current channel is used.

 This command sends a message to the specified nickname inviting them to join
 the channel specified or defaulted. The channel does not have to exist.

 If the channel is invite only (+i) then the issuer of this command must be a
 channel operator.

 Examples:

     /INVITE george

     /INVITE george #chatter


ΓòÉΓòÉΓòÉ 80. IRCTRACE Command ΓòÉΓòÉΓòÉ

 The IRCTRACE command is used to create a trace file of raw IRC messages during
 your IRC session. The trace file may be used for debugging or for
 informational purposes when developing scripts.

 Syntax: /IRCTRACE ON [filename] | OFF

 If the trace is started without specifying a trace file name the file name
 "gtirc.trc" is used.

 If a trace is started while a trace is currently active, the current trace is
 terminated and a new trace started with the new file name.

 If the trace file already exists it will be appended to.

 Example:

     /IRCTRACE ON

     /IRCTRACE ON c:\mytrace.dat

     /IRCTRACE OFF


ΓòÉΓòÉΓòÉ 81. ISON Command ΓòÉΓòÉΓòÉ

 The ISON command is used to determine if one or more nicknames are currently
 on IRC.

 Syntax: /ISON nick1 [nick2 ...]

 The list of nicknames, separated by spaces, is analyzed and the list is
 returned with only those nicknames currently on IRC.

 Example:

     /ISON george linker jazzy wizard

 Result:

     ISON george wizard


ΓòÉΓòÉΓòÉ 82. JOIN Command ΓòÉΓòÉΓòÉ

 The JOIN command is used to join one or more channels. A new window is opened
 for each channel joined.

 Syntax: /JOIN channel[,channel ...]  [key,key ...]

 A maximum of 10 channels may be joined.

 If the channel is protected by a key (password) then the appropriate key must
 be provided to join the channel. In the parameter list for the JOIN command,
 the first key listed goes with the first channel listed and so on.

 You may also join a channel by using the icon on the Toolbar or via the Popup
 menu.

 The total number of channel plus Query Windows permitted at any point in time
 is 10.

 Examples:

     /JOIN #chat

     /JOIN #chat,#os/2

     /JOIN #secret please


ΓòÉΓòÉΓòÉ 83. KICK Command ΓòÉΓòÉΓòÉ

 The KICK command is used to remove someone from a channel. It is a forced
 leave. This command is restricted to channel operators only. Note that a user
 removed by KICK can simply rejoin the channel.

 Syntax: /KICK [channel] nickname [reason for kick]

 If the KICK command is issued from the channel window of the channel where the
 nick is joined, the channel does not need to be specified. To kick from a
 different channel or window, specify the channel name.

 Since kicking is often times used as a warning, a reason for the kick is
 generally appropriate, but not required.

 Examples:

     /KICK #chat george for flooding the channel

     /KICK george for acting up


ΓòÉΓòÉΓòÉ 84. KILL Command ΓòÉΓòÉΓòÉ

 The KILL command is used to disconnect a IRC user (client) from a server.

 Syntax: /KILL nick[,nick,...] reason text

 The KILL command is restricted to IRC operators only. It is used primarily to
 get rid of ghost sessions. Servers may automatically generate KILL's when
 nickname collisions occur.

 Example:

     /KILL george Clean up ghost session


ΓòÉΓòÉΓòÉ 85. KLINE Command ΓòÉΓòÉΓòÉ

 The KLINE command is used to ban a user from connecting to a server.

 Syntax: /KLINE [e-mail] reason text

 The KLINE command is restricted to IRC operators only. It is used to terminate
 connected clients which match the user/host mask and prevent them from
 reconnecting to the server.

 Example:

     /KLINE *george@*.somewhere.net Running clone bots


ΓòÉΓòÉΓòÉ 86. LEAVE Command ΓòÉΓòÉΓòÉ

 The LEAVE command is used to depart from a channel or terminate a query
 session.

 Syntax: /LEAVE [channel,channel ...]

 If the LEAVE command is issued without parameters, the current channel / query
 will be terminated. If issued from a window other than the channel/query you
 wish to leave, the channel and/or query names must be specified.

 You may leave multiple channels and/or query sessions by specifying multiple
 names separated by commas.

 Leaving a channel or query will automatically close the channel or query
 window.

 You may also leave by pressing the icon on the Toolbar of the related window,
 or close the window by double clicking on the system menu icon at the top left
 corner of the window.

 When terminating IRC, it is not necessary to leave all channels and queries
 first.

 Examples:

     /LEAVE

     /LEAVE #chat

     /LEAVE george

     /LEAVE #chat,george


ΓòÉΓòÉΓòÉ 87. LINKS Command ΓòÉΓòÉΓòÉ

 The LINKS command displays a list of all the servers connected to the server
 specified.

 Syntax: /LINKS [server [wildcard]]

 If server is not specified the server you are attached to is used. Otherwise
 the information is requested from the specified server.

 If the wildcard is specified, information is returned only if it matches the
 wildcard expression. If a wildcard is specified, the server must also be
 specified.

 The output of this command is directed to a new window created when the
 command is entered. The information shown in this display window is a snapshot
 at the time when the command was executed. To close this display window double
 click on the icon in the upper left corner of the window. Depending on the
 server response time it may take several seconds for information to appear in
 the window.

 Examples:

     /LINKS

     /LINKS irc.texas.net

     /LINKS *.au coombs*

 In the last example above, the server with a name matching *.au will be
 queried for a list of attached servers matching coombs*.


ΓòÉΓòÉΓòÉ 88. LIST Command ΓòÉΓòÉΓòÉ

 The LIST command displays one or more active channels which includes the
 channel name, number of users and, if available, the topic for the channel.

 Syntax: /LIST [mask]  [channel[,channel ...] ]

 If no parameters are specified, all channels are displayed. This list can be
 very lengthy.

 The list can be limited by specifying a mask value of one or more of the
 following:

  -MIN n     Display channels with at least n users.
  -MAX n     Display channels with no more than n users.
  -PUB       Display only public channels.
  -PRI       Display only private channels.
  -TOP       Display only channels with a topic set.

 If one or more channel names are specified, only those channels are listed.

 The /LIST command also allows the use of wildcard characters in the channel
 name field. Valid characters are * and ?, and have the same meaning as when
 used with OS/2 file names. So, the channel operand of the /LIST command can
 have any one of the following three formats:

 channel, channel,...          Lists the specified channels only
 *                             Lists the current channel, when executed from a
                               Channel Window
 <wildcard expression>         Lists all channels matching the expression

 Example of wildcard expressions:

    ?bible
    #bib*
    ?chat*

 Note that when using wildcard expressions it takes time to create the list
 since all channels must be retrieved and then filtered using the wildcard
 expressions input by the user.

 If a channel name of "*" is used, the current channel is listed, provided you
 execute the command from a channel window.

 Secret channels are not listed unless you are joined to that channel.

 The output of this command is directed to a new window created when the
 command is entered. The information shown in this display window is a snapshot
 at the time when the command was executed. To close this display window double
 click on the icon in the upper left corner of the window. Depending on the
 server response time it may take several seconds for information to appear in
 the window.

 Examples:

     /LIST

     /LIST #chat,#os/2

     /LIST -min 3 -max 10

     /LIST *

     /LIST -pub


ΓòÉΓòÉΓòÉ 89. LOG Command ΓòÉΓòÉΓòÉ

 The LOG command is used to create a log file of messages for a window. The log
 file for the window may be opened using the toolbar icon also.

 Syntax: /LOG ON [filename] | OFF

 If the log is opened and no file name is specified the name of the window will
 be used as a default. When the default is used, the name is adjusted to 8.3
 file naming conventions by stripping invalid characters and then truncating to
 8 bytes then adding a .log extension. The logfile name will generally be the
 channel name or query name with a .log extension. For the control window the
 default file name will be gtirc.log. Unless overridden, the log files will be
 placed in the default directory which is normally \GTIRC.

 When using the toolbar icon to open a log file, the previous log file name for
 this window is used. If there was not a previous log file then the default
 name is used. There is no method provided to specify a log file name using the
 toolbar icon. If you desire a different name you must use the /LOG command to
 set the name initially.

 The toolbar icon changes when the log file is opened or closed. This occurs
 regardless of whether the log operation was done using the icon or the /LOG
 command. The two methods are interchangeable.

 If a log is already active when a log on command is entered, the current log
 file is closed and the new one opened.

 If the log file already exists it will be appended to.

 Each record in the log file will contain a timestamp.

 Examples:

     /LOG ON

     /LOG ON c:\mylog.dat

     /LOG OFF


ΓòÉΓòÉΓòÉ 90. LUSERS Command ΓòÉΓòÉΓòÉ

 The LUSERS command lists a summary of visible users, servers and operators.

 Syntax: /LUSERS [wildcard [server]]

 If the wildcard expression is provided, the summary is limited to those users
 and servers which match the wild card.

 If server is specified, the information is queried from that server. Otherwise
 it is obtained from the server to which you are connected.

 Examples:

     /LUSERS

     /LUSERS *.edu

     /LUSERS *.edu irc.texas.net


ΓòÉΓòÉΓòÉ 91. MAP Command ΓòÉΓòÉΓòÉ

 The MAP command displays a hierarchical list of the IRC servers connected to
 the IRC network.

 Syntax: /MAP [server]

 If a server name is specified, only that servers tree will be displayed.
 Otherwise the entire network is displayed.

 Not all servers support the /MAP command so you may receive an error on some
 servers.

 Examples:

     /MAP

     /MAP norman.ok.us.undernet.org


ΓòÉΓòÉΓòÉ 92. ME Command ΓòÉΓòÉΓòÉ

 The ME command describes an action on the current channel. The ME command is
 only valid when executed for a window joined to a channel. The ME command is
 synonymous with the /ACTION or /ACT command.

 Syntax: /ME text

 This command displays a message on the channel which indicates that you are
 doing something interesting.

 Examples:

     /ME is very happy

     /ACTION is rolling on the floor laughing

 Results:

     * mynick is very happy

     * mynick is rolling on the floor laughing


ΓòÉΓòÉΓòÉ 93. MENU Command ΓòÉΓòÉΓòÉ

 The MENU command permits you to add customized menu items to various popup
 menus.

 Syntax: /MENU type text /command

 type - is the menu type where the new item is added. Valid values are "in" for
 the input window popup menu, "out" for the output window popup, or "nick" for
 the nicklist popup menu.

 text - is the text you wish to have displayed in the menu.

 /command - is the IRC command, including the /, to be executed when this menu
 item is selected. The /command may contain $variables.

 The new menu item exists for the life of this IRC session only. You may
 however use the initialization script to define your custom menu items which
 will make them available each time GtIrc is started. The example
 initialization script, REXXINIT.CMD has examples of how to do this.

 Examples:

     /MENU nick UserIP /UserIP $SELECTEDNICK


ΓòÉΓòÉΓòÉ 94. MODE Command ΓòÉΓòÉΓòÉ

 The MODE command displays or changes the user or channel modes. It is also
 used to ban users from a channel.

 To display or set the user mode use the following syntax:

 Syntax: /MODE nickname [+|-][flags]

 Your nickname is required. If no other parameters are specified the current
 mode is displayed. Note that your user mode is automatically displayed to the
 right of your nickname in the title bar.

 The acceptable flags are shown below. The flags may be prefixed with a "+" to
 set the mode on, or a "-" to set the mode off. If neither "+" or "-" is
 specified then "+" is assumed. More than one flag character may be specified.

  i   Your nickname is invisible to anyone who does not know it's exact
      spelling.

  o   IRC Operator status. This flag can only be set off with the MODE command.
      To set it on use the /OPER command.

  s   This client is to receive server notices.

  w   This client is to receive wallops messages. These are messages to all
      IRCops. If this mode is set, wallops messages received are displayed in
      the Control output window only.

  d   Deaf mode suppresses all public (channel) messages to this user. Private
      messages are still received. Suppression occurs at the server level. You
      may use this mode if you wish to suspend public messages while you are
      away so that any private messages will likely be available for viewing
      when you return. Note that this mode is not available on all IRC servers
      so you may receive an error attempting to set it.

 See the /UMODE command for similar functionality.

 Examples:

     /MODE george

     /MODE george +iw

     /MODE george -w

 To display or change the channel mode use the following syntax:

 Syntax: /MODE *|channel [+|-][flags [parameters]]

 To alter a mode the user must have channel operator status.

 The channel name or "*" is required. If a channel name of "*" is specific the
 current channel name is used. If no other parameters are specified the current
 mode is displayed. Note that the channel mode is automatically displayed to
 the right of the channel name in the title bar.

 The acceptable flags are shown below. The flags may be prefixed with a "+" to
 set the mode on, or a "-" to set the mode off. If neither "+" or "-" is
 specified then "+" is assumed. More than one flag character may be specified.

  o   Gives or takes chanop status to another user. The nickname of the user
      must be specified in the parameters.

  v   Gives or takes the ability to talk on a moderated channel. The nickname
      of the user must be specified in the parameters. Chanops always have the
      ability to talk on a moderated channel. This gives them the ability to
      allow others to talk also without giving them ops.

  p   The channel is private.

  s   The channel is secret.

  i   Channel is invite only. Users joining must be invited first.

  t   The channel topic may be set only by channel operators.

  n   No messages from outside the channel may be sent to this channel.

  m   The channel is moderated. Only chanops and those they designate may talk.

  l   Sets a channel limit. No more than the number of users specified will be
      permitted to join the channel. When setting a limit the count must be
      specified in the parameters. When removing a limit the count is not
      specified.

  k   Sets a channel key (password) which must be specified by users joining
      the channel. The key is provided in the parameters. The key must be
      specified whether adding or removing it. The key cannot be changed, only
      added and removed.

  b   Sets a ban mask. Users matching the ban mask will not be permitted to
      join the channel. The ban mask is specified in the parameters and has the
      format of [nick[!user[@host]]] and may contain wild card characters. The
      list of current bans may be obtained by /MODE channel b.

 Note that more than one flag and their respective parameters may be specified
 in the same command. However, a limit of three "o" or "b" flags may be
 specified.

 Examples:

 /MODE *

 /MODE * +im

 /MODE #mychan +o george

 /MODE #mychan -s

 /MODE * +l 30

 /MODE * + lk 30 please

 /MODE * +b george

 /MODE * -b *!*@texas.net

 /MODE * b


ΓòÉΓòÉΓòÉ 95. MOTD Command ΓòÉΓòÉΓòÉ

 The MOTD command displays the Message Of The Day from the specified server.

 Syntax: /MOTD [servername|nickname]

 If the server name is omitted, information from the server you are connected
 with will be displayed. If a nickname is specified, information from the
 server on which that client is connected will be displayed.

 Examples:

     /MOTD

     /MOTD irc.texas.net

     /MOTD george


ΓòÉΓòÉΓòÉ 96. MSG Command ΓòÉΓòÉΓòÉ

 The MSG command sends a "private" message to the specified nickname(s) or
 sends a message to a channel which you have not joined.

 Syntax: /MSG nick1[,nick2 ...] | [channel] text

 If one or more nicknames are specified, the message is directed to only those
 clients. Therefore, membership in any forums you, and they, are participating
 will not see the message. Keep in mind that no message on IRC is truly private
 in that various administrative positions have the capability to see any
 message traffic.

 Two special characters may be used in place of a nickname. If "," is specified
 for a nickname, the message will be sent to the last nickname who sent you a
 message. If "." is specified for the nickname, the message is sent to the last
 nickname you sent a message to. When using "," or "." only one nickname may be
 specified in the command.

 If a channel is specified, the message is sent to that channel provided that
 the channel mode is not (+n) which prevents messages from the outside.

 The /MSG command may be abbreviated /M.

 Examples:

     /MSG george How are you today?

     /MSG #chat I will be joining in 5 minutes, sorry I'm late.

     /MSG george,pauline Talk to you folks later.

 Private messages you receive can be discerned from normal channel messages by
 the way in which the sending nickname is presented. Normal channel traffic
 shows the sending nickname as <nick> where private messages show them as
 *nick*.

 If several private messages are to be sent and received, it is more convenient
 to start a query with the nickname involved. See the QUERY command for more
 details on this option.


ΓòÉΓòÉΓòÉ 97. NAMES Command ΓòÉΓòÉΓòÉ

 The NAMES command will display the nicknames of users joined to the specified
 channel.

 Syntax: /NAMES [channel,channel ...]

 If the channel name is omitted, the current channel is listed. If executed
 from a non-channel window and a channel is not provided, an error message is
 returned.

 The name information is displayed only for those channels which are visible.
 That is, channels which you have joined, or those which do not have a channel
 mode of (+p) or (+s).

 The output of this command is directed to a new window created when the
 command is entered. The information shown in this display window is a snapshot
 at the time when the command was executed. To close this display window double
 click on the icon in the upper left corner of the window. Depending on the
 server response time it may take several seconds for information to appear in
 the window.

 Examples:

     /NAMES

     /NAMES #os/2

     /NAMES #chat,#os/2


ΓòÉΓòÉΓòÉ 98. NICK Command ΓòÉΓòÉΓòÉ

 The NICK command is used to change your nickname.

 Syntax: /NICK newnickname

 The nickname may have a maximum length of 9 characters. If another IRC user is
 using the new nickname, an error will be returned.

 Example:

     /NICK george2


ΓòÉΓòÉΓòÉ 99. NL Command ΓòÉΓòÉΓòÉ

 The NL command toggles the Nicklist window on or off.

 Syntax: /NL

 The window must be a channel window.

 Example:

     /NL


ΓòÉΓòÉΓòÉ 100. NOTICE Command ΓòÉΓòÉΓòÉ

 The NOTICE command is just like the MSG command except that it has one
 additional property in that IRC client software should never automatically
 reply to a NOTICE message.

 Syntax: /NOTICE nick1[,nick2 ...] | [channel] text

 The NOTICE command may be abbreviated NOT.

 For additional information see the /MSG command.


ΓòÉΓòÉΓòÉ 101. NOTIFY Command ΓòÉΓòÉΓòÉ

 The NOTIFY command is used to notify you when a specified nickname signs on or
 off to IRC.

 Syntax: /NOTIFY [[-]nickname] ... | [+]

 The Notify list can also be updated using the Notify Dialog which is accessed
 by clicking on the icon on the Toolbar or via the Popup menu.

 If no parameters are specified, the NOTIFY command will display the current
 status of each nickname in the notify list.

 Nicknames specified in the command list are added to the notify list. If the
 specified nickname is prefixed with a "-", it will be removed from the notify
 list.

 Specifying a "-" without any other parameters causes all nicknames in the
 notify list to be removed.

 Specifying a "+" without any other parameters will display those nicknames in
 the notify list which are currently on IRC.

 The Notify nickname list may contain up to 25 nicknames. The check for the
 nickname presence on IRC is performed once per minute.

 A user will be shown as signed off when they change their nickname too, so
 keep this in mind.

 Notification is performed by displaying a highlighted message in your current
 Output Window such as "*** Signon by nickname detected" or "*** Signoff by
 nickname detected".

 The notify nickname list is retained across executions of the GammaTech IRC
 client.

 Examples:

     /NOTIFY

     /NOTIFY george pauly

     /NOTIFY -george

     /NOTIFY +

     /NOTIFY -


ΓòÉΓòÉΓòÉ 102. OMSG Command ΓòÉΓòÉΓòÉ

 The OMSG command sends the specified message text to all channel operators on
 the channel where the command is entered. The message is sent as a private
 message.

 Syntax: /OMSG message text

 You must have channel operator status to execute this command.


ΓòÉΓòÉΓòÉ 103. ONOT Command ΓòÉΓòÉΓòÉ

 The ONOT command sends the specified message text to all channel operators on
 the channel where the command is entered. The message is sent as a notice.

 Syntax: /ONOT message text

 You must have channel operator status to execute this command.


ΓòÉΓòÉΓòÉ 104. OPER Command ΓòÉΓòÉΓòÉ

 The OPER command is used by a normal user to acquire IRC operator privileges.

 Syntax: /OPER userid password

 If the correct userid and password are supplied, the user will be given IRC
 operator privileges on the server to which they are connected.


ΓòÉΓòÉΓòÉ 105. PING Command ΓòÉΓòÉΓòÉ

 The PING command is used to determine the time it takes to send a message to
 another IRC user and back. It is used primarily to determine lag time.

 Syntax: /PING nick[,nick ...]

 If and when a ping response is received from the remote client, the elapsed
 time sill be displayed. PING uses the CTCP protocol. Not all IRC client
 software supports CTCP PING. For this reason, the expected response may not be
 received, or no response may be received at all.

 Examples:

     /PING george

     /PING george,lindap

     /PING #os/2

 Results:

     *** PING (george): 3 seconds

     *** PING (lindap): 45 seconds


ΓòÉΓòÉΓòÉ 106. QUERY Command ΓòÉΓòÉΓòÉ

 The QUERY command starts a private chat session with the specified nickname. A
 new Query Window is opened.

 Syntax: /QUERY nickname[,nickname,...] [text]

 Issuing the query command opens a window for the private chat session, but
 does not notify the other user that such has taken place. Most IRC clients do
 not support separate windows for private chat sessions.

 If [text] is supplied, it will be sent to the queried nickname as an initial
 private message. If [text] is not supplied, no message is sent.

 All message traffic in Query Windows is performed as if you were executing
 /MSG commands to the related nickname.

 The Query Window can be closed at any time in the same way a channel window is
 closed. See /LEAVE.

 A query may also be initiated by clicking on the icon on the Toolbar or via
 the Popup menu.

 The total number of channel plus Query Windows permitted at any point in time
 is 10.

 Example:

     /QUERY george

     /QUERY george Howdy, how's George today?


ΓòÉΓòÉΓòÉ 107. QUIT Command ΓòÉΓòÉΓòÉ

 The QUIT command terminates your IRC session. A reason may be given which is
 broadcast to the participants of any channels you had joined.

 Syntax: /QUIT [reason]

 If a reason is not provided, the reason specified in the Preferences Dialog is
 used. If no reason is found there a reason of "Leaving" is used.

 This command is synonymous with "BYE" and "SIGNOFF".

 You may also use the File - Signoff menu option to terminate your IRC session.


ΓòÉΓòÉΓòÉ 108. RAW Command ΓòÉΓòÉΓòÉ

 The RAW command sends the supplied text to the server as is except that a
 carriage return and line feed are appended to the text before sending it to
 the server.

 Syntax: /RAW text


ΓòÉΓòÉΓòÉ 109. REHASH Command ΓòÉΓòÉΓòÉ

 The REHASH command forces the server to re-read and process its configuration
 file.

 Syntax: /REHASH

 This command is restricted to IRC operators.


ΓòÉΓòÉΓòÉ 110. RESTART Command ΓòÉΓòÉΓòÉ

 The RESTART command forces a server to restart itself.

 Syntax: /RESTART

 This command is restricted to IRC operators. Not all servers may support this
 command.


ΓòÉΓòÉΓòÉ 111. REXX Command ΓòÉΓòÉΓòÉ

 The REXX command executes the specified REXX procedure script, passing to it
 any parameters on the command line.

 Syntax: /REXX script [parameters]

 The script file is a REXX procedure file created by the user. A sample script
 file is provided in the GtIrc directory with a name of REXXSCR.CMD. See this
 sample file for details regarding creating your own.

 If the script name does not contain the *.cmd extension it will be provided
 automatically.

 Any parameters following the script file name will be passed directly to the
 script being executed.

 This command is functionally equivalent to the /SCR command.

 For additional information on GtIrc scripts, see Script Programming and
 Startup and Script Dialog.

 Examples:

     /REXX hello.cmd Hello all.

     /REXX hello Hello all.


ΓòÉΓòÉΓòÉ 112. RUN Command ΓòÉΓòÉΓòÉ

 The RUN command executes IRC commands from a text file you have previously
 created.

 Syntax: /RUN filename

 Each line of the file is treated as a IRC command and is executed in the
 window where the RUN command was entered.

 The file name may contain a complete drive, path and file name. If the drive
 is omitted, the drive where the IRC software is installed is assumed. If the
 path is omitted, the path where the IRC software is assumed.

 Script files which flood a channel with unwanted messages can result in you
 being kicked and / or banned from the channel or server. Do not abuse this
 feature.

 Examples:

     /RUN script.txt

     /RUN c:\scripts\myscript.txt


ΓòÉΓòÉΓòÉ 113. SCR Command ΓòÉΓòÉΓòÉ

 The SCR command executes the specified REXX procedure script, passing to it
 any parameters on the command line.

 Syntax: /SCR script [parameters]

 The script file is a REXX procedure file created by the user. A sample script
 file is provided in the GtIrc directory with a name of REXXSCR.CMD. See this
 sample file for details regarding creating your own.

 If the script name does not contain the *.cmd extension it will be provided
 automatically.

 Any parameters following the script file name will be passed directly to the
 script being executed.

 This command is functionally equivalent to the /REXX command.

 For additional information on GtIrc scripts, see Script Programming and
 Startup and Script Dialog.

 Examples:

     /SCR hello.cmd Hello all.

     /SCR hello Hello all.


ΓòÉΓòÉΓòÉ 114. SERVER Command ΓòÉΓòÉΓòÉ

 The SERVER command connects you with an IRC server. If you are already
 connected to a server you are signed off of that server before connecting with
 the new server.

 Syntax: /SERVER [server.name[:port]]

 Ther command may be abbreviated as /SERV.

 If no server name is provided, an existing server is selected from the server
 list by priority.

 If a server name is provided, the existing list of servers is searched first
 for a complete match and then for a partial match of the supplied name with
 any part of the server names in the list. If the server is still not found an
 attempt is made to add the specified server to the server list.

 Examples:

     /SERVER

     /SERV irc.ionet.net

     /SERVER irc.ionet.net:6669

     /SERV vancouver


ΓòÉΓòÉΓòÉ 115. SIGNOFF Command ΓòÉΓòÉΓòÉ

 The SIGNOFF command terminates your IRC session. A reason may be given which
 is broadcast to the participants of any channels you had joined.

 Syntax: /SIGNOFF [reason]

 If a reason is not provided, the reason specified in the Preferences Dialog is
 used. If no reason is found there a reason of "Leaving" is used.

 This command is synonymous with "BYE" and "QUIT". It may also be abbreviated
 as /SIGN.

 You may also use the File - Signoff menu option to terminate your IRC session.


ΓòÉΓòÉΓòÉ 116. SILENCE Command ΓòÉΓòÉΓòÉ

 The SILENCE command is used to suppress private messages from an annoying
 user. The suppression is performed at the server level. Not all servers may
 support this feature.

 Syntax: /SILENCE [+nick!user@host] [-nick!user@host]

 Entering the command without any parameters displays the current list of
 silence entries.

 Entries are added by entering a + followed by a nickname and or user@host
 mask. Wildcard characters are accepted in the mask.

 Entries are removed by entering a - followed by the mask.

 There is generally a limit of 5 silence entries.

 Examples:

     /SILENCE

     /SILENCE +badboy

     /SILENCE -badboy

     /SILENCE +*joe@*somewhere.net


ΓòÉΓòÉΓòÉ 117. SNAP Command ΓòÉΓòÉΓòÉ

 The SNAP command records the contents of the scroll buffer for the current
 window to the specified file.

 Syntax: /SNAP  filename

 A file name must be provided. The file will be placed in the log file
 directory as specified in the Preferences dialog. If the file exists it will
 be appended to.

 Example:

     /SNAP myfile.txt


ΓòÉΓòÉΓòÉ 118. SOUND Command ΓòÉΓòÉΓòÉ

 The SOUND command requests another client to play a sound file. This command
 can be abbreviated as /SND.

 Syntax: /SOUND nickname|#channel [sound.wav] [message text]

 Providing that the client software for "nickname" supports the SOUND command,
 and the specified wav file exists on their system, the associated sound will
 be played.

 If the sound.wav file name is not specified the standard files dialog will be
 displayed for specification of the wav file to play.

 If no message text is specified no text will be sent.

 Example:

     /SOUND george shred.wav Duh, hi George.


ΓòÉΓòÉΓòÉ 119. SOURCE Command ΓòÉΓòÉΓòÉ

 The SOURCE command sends a request to the specified IRC user client software
 asking where that software can be acquired.

 Syntax: /SOURCE nickname

 Providing that the client software for "nickname" supports the SOURCE command,
 a description of where the software may be obtained will be returned. Clients
 that do not support SOURCE may return an error message, or nothing at all.
 Some clients may return information other than that expected. SOURCE uses the
 CTCP protocol.

 Example:

     /SOURCE george

 Result:

     *** SOURCE (george): SofTouch Systems : [phone]


ΓòÉΓòÉΓòÉ 120. SQUIT Command ΓòÉΓòÉΓòÉ

 The SQUIT command is used to force a server to disconnect from the IRC
 network.

 Syntax: /SQUIT [server] [comment]

 This command is restricted to IRC operators.

 If a comment is specified, then the server name must also be specified.

 Example:

     /SQUIT irc.server.edu Disconnecting due to bad connection


ΓòÉΓòÉΓòÉ 121. STATS Command ΓòÉΓòÉΓòÉ

 The STATS command is used to query statistics from a server.

 Syntax: /STATS query [server]

 The query field is one of the following characters:

  c   Returns a list of servers which the server may connect to or allow
      connections from.

  h   Returns a list of servers which are either forced to be treated as leaves
      or allowed to act as hubs.

  i   Returns a list of hosts which the server allows a client to connect from.

  k   Returns a list of banned username/hostname combinations for the server.

  l   Returns a list of the server's connections, showing how long each
      connection has been established and the traffic over that connection in
      bytes and messages for each direction.

  m   Returns a list of commands supported by the server and the usage count
      for each if the usage count is non-zero.

  o   Returns a list of hosts from which normal clients may become operators.

  y   Show Y class lines from server's configuration file.

  u   Returns a string showing how long the server has been up.

 If the server parameter is not provided, the server you are connected with is
 assumed.

 The implementation of this command on any given server may vary widely
 depending on the server version, patch level and configuration.

 Examples:

     /STATS c

     /STATS i irc.texas.net


ΓòÉΓòÉΓòÉ 122. SUMMON Command ΓòÉΓòÉΓòÉ

 Invite a user to join IRC.

 Syntax: /SUMMON user [server]

 For this command to function the following conditions must apply: The user
 must be logged into a host running an IRC server; the server must have SUMMON
 enabled; the server must be able to write to the users tty terminal.

 Most servers do not support SUMMON, so don't expect it to work.

 Examples:

     /SUMMON george

     /SUMMON george irc.texas.net


ΓòÉΓòÉΓòÉ 123. TIME Command ΓòÉΓòÉΓòÉ

 The TIME command queries the requested server or client for the current time
 at that location. The TIME command is synonymous with the DATE command.

 Syntax: /TIME [servername] [nickname]

 If no server or client name is provided, the request is made to the server on
 which you are connected. If a nickname is provided, the request is sent to the
 client software used by the nickname as a CTCP command. Not all IRC clients
 support CTCP TIME requests so information returned may not be that which is
 expected or no response may be given at all.

 Examples:

     /TIME

     /TIME irc.texas.net

     /TIME george

 Result:

     *** irc.texas.net : Tuesday March 28 1995 -- 08:47 -06:00 *** TIME
     (george): Tue Mar 28 08:47:15 1995


ΓòÉΓòÉΓòÉ 124. TIMER Command ΓòÉΓòÉΓòÉ

 The TIMER command is used to set, remove and display user specified events to
 occur at a specified time or on an interval.

 Syntax: /TIMER once|idle|recur interval|timeofday /command

 Syntax: /TIMER list [id]

 Syntax: /TIMER kill id

 The first format sets a timer event. If "once" is specified, this is a one
 time event and the timer will automatically be removed when it expires. If
 "idle" is specified then the event is triggered each time the idle time meets
 or exceeds the specified interval. If "recur" is specified then the event is
 triggered each time the specified interval expires.

 The interval is specified in seconds or as a time value. The interval must not
 be zero. If a time is specified it must be in the format of
 hours:minutes[:seconds]. The maximum time that may be specified is 24 hours 0
 minutes 0 seconds. If a time is specified for a idle or recur timer type, the
 interval is computed to be the difference between the current time and the
 time specified. The specified time is always considered to be a time in the
 future.

 The /command value can be any valid /command. You may use the /SCR or /REXX
 command to execute a stand alone REXX script. The /command may contain
 $variables.

 When the interval expires or the time of day arrives, the /command is executed
 as if it were entered from the master server window. Note that the timer
 processing has a 5 second granularity.

 The second form of the /TIMER command is used to display active timers. If
 "id" is provided, only that timer is displayed. Otherwise all active timers
 are displayed.

 The third form of the /TIMER command is used to remove a active timer. "id" is
 the identifier as shown by the /TIMER LIST command.

 Examples:

     /TIMER once 14:25 /msg george It's 2:25 pm

     /TIMER idle 300 /rexx rexxaway.cmd

     /TIMER recur 900 /msg #mychannel This is a lame repeating message

     /TIMER list

     /TIMER kill 3


ΓòÉΓòÉΓòÉ 125. TOPIC Command ΓòÉΓòÉΓòÉ

 The TOPIC command is used to display or set a channel topic.

 Syntax: /TOPIC [channel] [topic text]

 The channel name may be omitted provided the command is entered from a window
 joined to a channel.

 You must be joined to the channel before you can set the topic. In addition,
 if the channel mode is +t, then only channel operators may set the channels
 topic.

 Examples:

     /TOPIC

     /TOPIC #chat

     /TOPIC #chat IRC is fun

     /TOPIC IRC is fun


ΓòÉΓòÉΓòÉ 126. USERHOST Command ΓòÉΓòÉΓòÉ

 The USERHOST command takes a list of up to 5 nicknames and returns information
 about each one.

 Syntax: /USERHOST nick1 [nick2 ...]

 Note that the nicknames are separated by spaces and not commas as in most
 commands.

 Example:

     /USERHOST george pauline


ΓòÉΓòÉΓòÉ 127. USERIP Command ΓòÉΓòÉΓòÉ

 The USERIP command takes a list of up to 5 nicknames and returns information
 about each one similar to the /USERHOST command except that the user's IP
 address is displayed instead of their host name.

 The USERIP command may not be a supported feature on all servers. Recent
 Undernet servers support this feature.

 Syntax: /USERIP nick1 [nick2 ...]

 Note that the nicknames are separated by spaces and not commas as in most
 commands.

 Example:

     /USERIP george pauline


ΓòÉΓòÉΓòÉ 128. UMODE Command ΓòÉΓòÉΓòÉ

 The UMODE command is used to set or display your user mode.

 Syntax: /UMODE [+|-][mode]

 If no parameters are specified the current user mode string is displayed.

 The acceptable modes are shown below. The modes may be prefixed with a "+" to
 set the mode on, or a "-" to set the mode off. If neither "+" or "-" is
 specified then "+" is assumed. More than one flag character may be specified.

  i   Your nickname is invisible to anyone who does not know it's exact
      spelling.

  o   IRC Operator status. This flag can only be set off with the MODE command.
      To set it on use the /OPER command.

  s   This client is to receive server notices.

  w   This client is to receive wallops messages. These are messages to all
      IRCops. If this mode is set, wallops messages received are displayed in
      the Control output window only.

  d   Deaf mode suppresses all public (channel) messages to this user. Private
      messages are still received. Suppression occurs at the server level. You
      may use this mode if you wish to suspend public messages while you are
      away so that any private messages will likely be available for viewing
      when you return. Note that this mode is not available on all IRC servers
      so you may receive an error attempting to set it.

 Example:

     /UMODE +i


ΓòÉΓòÉΓòÉ 129. USERINFO Command ΓòÉΓòÉΓòÉ

 The USERINFO command sends a request to the specified IRC user client software
 asking for user information.

 Syntax: /USERINFO nickname

 Providing that the client software for "nickname" supports the CTCP USERINFO
 command, and that the remote user has set this information, the text set by
 the remote user will be returned. Clients that do not support CTCP USERINFO
 may return an error message, or nothing at all. Some clients may return
 information other than that expected.

 Each user sets the text that is to be returned by this command. For the
 GammaTech IRC Client, you set this information in the "User Information" field
 of the Settings dialog.

 Example:

     /USERINFO george

 Result:

     *** USERINFO (george): I am a happy camper


ΓòÉΓòÉΓòÉ 130. USERS Command ΓòÉΓòÉΓòÉ

 The USERS command shows the users logged in to the specified server.

 Syntax: /USERS [server]

 If the server is not specified, the server you are connected with is used.

 Many servers have this command disabled for security reasons.

 Examples:

     /USERS

     /USERS irc.texas.net


ΓòÉΓòÉΓòÉ 131. VAR Command ΓòÉΓòÉΓòÉ

 The VAR command is used to set, display and modify IRC $Variable values.

 Syntax: /VAR [[-]$Variable[[,]value]]

 Specifying no parameters will display all defined IRC variables and their
 values.

 If only the name of the variable is specified, only that variable will be
 displayed along with it's value.

 If the variable name is preceded with a "-" the variable is deleted from the
 variable pool provided it is not a system variable.

 If the variable name is followed by a comma and text, the variable's value is
 set to the text specified. If a comma is present but no text follows then the
 value is set to a null string.

 Note: Variable substitution is performed for all /Commands when they are
 entered with the exception of the /VAR command. Variables entered when setting
 a variable are resolved when the variable is used, not when it is set.

 For additional information on IRC variables see IRC Variables

 Example:

     /VAR

     /VAR $MyVariable

     /VAR $MyVariable,My name

     /VAR $MyVariable,

     /VAR -$MyVariable


ΓòÉΓòÉΓòÉ 132. VERSION Command ΓòÉΓòÉΓòÉ

 The VERSION command sends a request to the specified IRC user client software
 asking the name, version and platform of the IRC client software.

 Syntax: /VERSION nickname

 Providing that the client software for "nickname" supports the VERSION
 command, a description of the name, version and platform will be returned.
 Clients that do not support CTCP VERSION may return an error message, or
 nothing at all. Some clients may return information other than that expected.

 Example:

     /VERSION george

 Result:

     *** VERSION (george): GammaTech IRC : Version 1.00 : OS/2 Warp


ΓòÉΓòÉΓòÉ 133. WALLOPS Command ΓòÉΓòÉΓòÉ

 The WALLOPS command is used to send messages to all IRC Operators. You  must
 be an IRC Operator to use this command.

 Syntax: /WALLOPS text

 This command may be abbreviated as WALLOP.

 Example:

     /WALLOP Is anyone from the chicago server on right now?


ΓòÉΓòÉΓòÉ 134. WHO Command ΓòÉΓòÉΓòÉ

 The WHO command lists users on IRC.

 Syntax: /WHO [channel | name | 0] [o]

 If no parameters are supplied, the current channel name is used.

 If a channel name is supplied, or provided by default, the members of that
 channel are listed.

 If a name is provided, which is anything that is not a channel name, then it
 may be a wildcard expression and the users will be searched by examining their
 host, server, real name and nickname fields.

 If a name of 0 (zero) is specified for a name, all IRC users are listed. This
 will be a very lengthy list.

 If the o (oh) operand is provided, then only IRC operators matching the name
 mask are displayed. The o operand may only be supplied when a name is
 provided.

 Users who are invisible by having a mode of (+i) are listed only if they are
 on a common channel with you.

 If the output of the WHO command displays an asterisk (*) in place of the
 channel name, it indicates that the user is either not joined to any channels,
 or that the channels they are joined to are private or secret.

 Examples:

     /WHO

     /WHO #os/2

     /WHO *george*

     /WHO 0 o


ΓòÉΓòÉΓòÉ 135. WHOIS Command ΓòÉΓòÉΓòÉ

 The WHOIS command displays detailed information about a nickname.

 Syntax: /WHOIS [server] nickname[,nickname ...]

 If server is specified for a user connected to a distant server, then
 additional information will be provided on how long the user has been idle is
 provided. There is no other good reason to supply a server name.

 Information displayed consists of the users name, host, server, real name,
 away status and idle time information.

 The output of this command is directed to a new window created when the
 command is entered. The information shown in this display window is a snapshot
 at the time when the command was executed. To close this display window double
 click on the icon in the upper left corner of the window. Depending on the
 server response time it may take several seconds for information to appear in
 the window.

 Examples:

     /WHOIS george

     /WHOIS george,philly

     /WHOIS irc.texas.net george

     /WHOIS george george

 The last example is a special case where the server name is acquired from the
 nickname. The server used for the query is the server to which "george" is
 connected.


ΓòÉΓòÉΓòÉ 136. WHOWAS Command ΓòÉΓòÉΓòÉ

 The WHOWAS command displays information about who used the specified nickname
 last, even if it is not currently in use.

 Syntax: /WHOWAS nickname [count]

 The servers history file is searched for the past usages of the nickname and
 the associated information displayed.

 If count is specified, then only the last "count" items are displayed.

 The server history information is not retained very long, so information may
 not be available.

 Examples:

     /WHOWAS george

     /WHOWAS george 3