[ IceCQ ver.02.00.04a ] Copyright (c) 2000 by Konstantin Bondarchuk (ik@os2.ru)



Contents


 Installation
 Main characteristics
 Preferences
   Preferences Notebook
   Command line options
   Fonts & colors change
 Work with IceCQ
   Adding  new User
   New UIN registration
   Quoting
   Hot keys
 Utilities
 Bugreports
 Support



Installation


Unpack IceCQ distrubution package into desired directory and run
install.cmd



Main characteristics


IceCQ is the native OS/2 PM ICQ pager (clone of Mirabilis ICQ client),
optimized for OS/2 Warp 4.0 (works under OS/2 Warp 3.0 too).

Communication with server works under ICQ protocol ver. 2.0.
By now the following basic functions have been supported:

   Messages send/receipt;
   URLs send/receipt;
   Contacts (from Contacts list) send/receipt;
   Authorization;
   Authorization requests send/receipt;
   Authorization refuse send/receipt;
   "You are added" message send/receipt;
   WWPager messages receipt;
   E-Mail Express message receipt;

and service functions:

   National language support 
	 traffic convert customization;
   Messages history:
 	 userful interface;
	 search;
	 quote reply;
	 plain text LOG type available;
   Search of users (by name, by second name, by nickname, by UIN, by E-Mail);
   Getting information about users;
   Personal information change;
   Authorization status change;
   New UIN registration.
   Multiuser support:
	 personal preferences for each user;
	 quick & comfortable user switching;
   E-mail POP3 checking:
	 the number of messages indication;
 	 authomatic or hot key/doubleclick e-mail client launch
   Sound system:
	 separate sound & volume for each event;
   Fonts & colors change;
   Message quoting;
   Automatic try to reconnect when connection is lost
    Autodetect internet connection !!!
   SOCKS5 support;


Preferences


 Preferences Notebook
 
   
  The majority of preferences starts functioning immediately after a change
or after closing preferences notebook. In some cases one has to restart IceCQ
so that the changes start functioning. These cases will be indicated later.

    __________
___/ Network  \_______________________________________________________

    Connection 

   [X] Connect at startup

	IceCQ connects automatically with server at startup

   [X] Automatically try to reconnect when connection is lost

	When the connection is broken IceCQ automatically tries
	to reconnect. If the option is disabled IceCQ won't
	try to reconnect but show the dialog with the request
	concerning the further actions.

   [X] Always keep connected

	This complex function acts as follows: every 10 seconds
	IceCQ checks online status. If the program is off-line
	it checks if PPP interface is up. If it is IceCQ connects
	with server.


    Login 

   [X] Enable timeout

	This option enables conenction timeout. If there is no reply
	from server during selected timeout IceCQ reconnects automatically.


    SOCKS5 

   [X] Use SOCKS5 server

	This option allow to connect through SOCKS server (only SOCKS5 
	protocol is supported).

   Host IP:

	IP address of SOCKS server.

   Port:

	SOCKS server port.


    __________
___/ General  \_______________________________________________________

   [X] Convert traffic

	This option enables traffic recode. You can select server 
	(remote) codepage. Local codepage (your computer) is detected
	automatically.
	For example, if your country is Russia convert traffic enables
	automatically at the first start of IceCQ, remote codepage
	is selected as 1251.


    Don't show error messages 

	Here you can disable some error messages.


    Confirmations 

	It is a confirmation customization.


    _______________
___/ Contact List  \__________________________________________________

   [X] Always on top

	IceCQ is always on-top.

   [X] Popup contact list upon incoming event

	If IceCQ is minimized and contact list changes occured
	IceCQ pops up (modified contact will be highlighted).

   [X] Auto hide delay (in seconds)

	Here you indicate the auto hide delay (in seconds) after
	IceCQ poped up.

        *!* this option is enabled after preferences notebook is closed.

   [X] Move user that sent an event to the top of contact list

	When a message from a remote user comes it appears as a contact
	icon in contact list. If there're many contacts in contact list
	it's not convinient to look for incoming messages. This option
	allows to move incoming contacts to the top of the contact list.
	After reading incoming messages contacts return to their place.

   [X] Beep on incoming messages

	There is a beep (on PC speaker, not through multimedia) when
	a new message comes.

   [X] Popup incoming messages

	Incoming messages pop up not appear in contact list. 

   [X] Flashing icons

	This option enables incoming messages icon flashing in contact
	list.

   [X] Don't change mouse pointer

	If this option is enabled mouse pointer doesn't change for
	"hand" when directing to the contact list.

   [X] Sort list by name

	This option enables contact list sorting in alphabetic order.

   [X] Remove separators

	This option allows to remove separators from contact list.

   [X] Show contacl list tabs

	If this switch is enabled ONLINE and OFFLINE buttons are
	on the top of contact list. 
	Click ONLINE to show only contacts which are on-line. OFFLINE
	button shows all the contacts no matter what their status is.


   [X] LButton double click message

	If this option is enabled you can operate the contact on double
	click (left mouse button):
		<double click>		- Send message;
		<double click> + CTRL	- Send URL;
		<double click> + ALT	- View Info

   [X] Contact list follow pointer

	This option enables highlighting of the pointed contact.



   [X] Menu follow mouse pointer

	This option enables highlighting of the pointed IceCQ menu.

        *!* this option is enabled after IceCQ restart.


    __________
___/ Servers  \_______________________________________________________

Here you can add/modify/delete servers list used for connecting
to ICQ server. If the list is empty IceCQ uses default ICQ server.

You can change the servers order using buttons [Move up] & [Move down].
IceCQ connects to server using addresses from the top to the bottom.


    _________
___/ E-Mail  \________________________________________________________

   [X] Automatically launch e-mail client when new messages arrive

	If the option is enabled the E-mail client is automatically launched
	on finding new message(s).


    Check for new E-Mail 
	This option sets up the period of checking e-mail.

        *!* this option is enabled after preferences notebook is closed.

   (o) Never
	Never check e-mail.

   (o) At connect only
	Check e-mail at connect only.

   (o) Every x minute(s)
	Check e-mail at connect and every X minute(s).


    ________
___/ Sound  \_________________________________________________________

   Here you can:
	- look through the list of events and corresponding sound files;
	- select sound file for each event;
	- listen to sound files;
	- change sound volume for each event;
	- enable/disable sound for each event;

Enable "Sound On" checkbox to turn on the sound system.

IceCQ supports sound files in any sound format supported in OS/2 Multimedia
System.



 Command line options
 

  /min		- minimize at start;
  /noanim	- no frame animation at startup;
  /user xxxxxxx	- xxxxxxx = UIN of current user to work with;


 Fonts & Colors change
 

You can change fonts & colors in contact list, message editor, "IceCQ" and
status buttons using drag-and-drop from OS/2 color and font palettes.

These settings are saved for each user.



Work with IceCQ
===============

 Adding new user
 

To add a new user open 'Add/Change Current User' in IceCQ menu and
select 'Log Another Registered User'.  
You should enter your UIN and password.


 New UIN registration
 

If you are not registered on Mirabilis you should create new ICQ user.
Select "(Un)Register User" -> "Register new user UIN" in the main menu.
You should enter a password twice to register on Mirabilis ICQ server.
After registration IceCQ will create automatically a new user (UIN)
with empty settings.
You can add the user information using "View/Change My Listings.." menu.


 Quoting
 

When replying to the message you can use quoting. Mark a part of the
text that you want to quote and press "Reply" button. The marked part of
the text will be in message editor, each line starting with '>'.


 Hot Keys
 

 > Contact List:

	F4	- Check E-Mail;
	F5	- Open preferences notebook;
	F9	- Show all contacts;
	F10	- Show only on-line contacts;
	F11	- Open main menu (IceCQ button);
	F12	- Open status menu ('flower' button).

 > Double click on contact:

		- Send Message;
	+ CTRL	- Send URL;
	+ ALT	- View Info.

 > In message editor:

	TAB-ENTER,
	CTRL+ENTER,
	CTRL+S	- Send the message;
	ESC	- Cancel the message;
	CTRL+h	- Show messages history.



Utilities


UNSCM.EXE
	Utility for ICQ sound scheme extracting:
	http:\\www.icq.com\sound

HISTCVRT.EXE
	Old style (IceCQ 2.99.x) history format conversion utility.
	

Bugreports


If IceCQ traps occure please send CRASH.LOG file (from IceCQ working directory)
with explanations to icecq@os2.ru



Support


 Desc			Info
  
 Author:		Konstantin Bondarchuk (IceKool, ik@os2.ru)
 Sales, hosting:	Konstantin Okounkov (OS2OK, admin@os2.ru)
 Email:		 	icecq@os2.ru
 Fido:   		2:5040/30.10, 2:5040/59.4
 IceCQ WWW: 		http://os2.ru/projects/icecq
  
 North American technical support contact
  
 Name:			Yvon Letourneau
 E-Mail:		yvon_letourneau@hotmail.com
 IRC:			EfNet: #os2russian, #os/2, #os2coders Nick:[Yvon]
