home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 35 Internet
/
35-Internet.zip
/
gtirc301.zip
/
GTIRC.HLP
(
.txt
)
< prev
next >
Wrap
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
jsmith@internet.net 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 user@host.name
to all private messages sent to you. However, if you have a query window open
for the sending user the user@host.name 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.
*!*baduser@somewhere.net. 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 user@host.mask 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 : (405) 947-8085
ΓòÉΓòÉΓòÉ 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