ACTIVESOCKET 3.0 RELEASE NOTES
INTRODUCTION
ActiveSocket 3.0 is the newest version of the ActiveSocket Network Communication Toolkit. The mission of the product is to provide a collection of useful network communication tools for a variety of development platforms.
WHAT'S NEW IN ACTIVESOCKET 3.0
- Constants -
- Constants are now defined in a separate class called 'ASConstants'. The use of a separate constants class makes your code better readable and maintainable.
- Snmp -
- New SNMP classes. The ActiveSocket 2.4 'Snmp' object doesn't exist anymore; instead, two new objects are introduced: 'SnmpManager' and 'SnmpData'. The 'SnmpManager' object is used to connect to the remote SNMP manager. The 'SnmpData' object encapsulates a single SNMP data object;
- In previous versions of ActiveSocket, the 'Set' operation didn't work for identifiers of type 'IPAddress'. This has been fixed in v.3.0.
- Snmp Traps -
- New SNMP Trap classes. The ActiveSocket 2.4 'SnmpTrapIn' and 'SnmpTrapOut' objects don't exist anymore; instead, two new objects are introduced: 'SnmpTrapManager' and 'SnmpTrapData'. The 'SnmpTrapManager' object is used to connect to the remote SNMP manager and send or receive SNMP trap data. The 'SnmpTrapData' object encapsulates a single SNMP trap data object;
- You can now see the sender of a trap when a trap is received. The IP address of the sender is part of the SnmpTrapData object;
- In previous versions of ActiveSocket, traps where received from any community, regardless of which community was specified. This has been fixed in v.3.0;
- ActiveSocket now supports SNMP v.1 trap types. The following generic SNMP v.1 trap types are supported: Cold Start, Warm Start, Link Down, Link Up, Authentication Failure, Neighbor Loss and User Specific.
- Socket -
- The 'Socket' object now automatically detects a broken connection. The ConnectionState property is set to asSOCKET_CONNSTATE_DISCONNECTED when the connection is beroken, for instance because the remote TCP/IP party initiated a disconnect. In previous versions of ActiveSocket, a disconnect was not detected;
- The SendString function now only takes one parameter, and sends a carriage return/line feed automatically. If you don't want to send a carriage return/line, use the SendBytes function. In previous versions of ActiveSocket, the SendString function required a second parameter to specify whether or not to send a carriage return/line feed;
- You can now specify a maximum buffer size for a receive cycle. The default buffer size is 16KB, which means that no more than 16K is received by a ReadString or ReadBytes operation (i.e. you need to call ReadString or ReadBytes twice to receive all data);
- New protocol supported: Ftp -
- ActiveSocket now supports FTP, featuring: Anonymous login, login using username and password, binary- and ascii up/download of files, passive/active mode and more.
- Licensing -
Licensing of ActiveSocket has changed. There are now 3 different license schemes:
- Standard License (#AX001-0010) - Allows you to use the following objects only: Icmp, Http, Ftp, Socket and ASConstants;
- Professional License (#AX001-0012) - Allows you to use all objects: Icmp, Http, Ftp, Socket, Dns, Ntp, Rsh, SnmpManager/SnmpData, SnmpTrapManager/SnmpTrapData, WOL and ASConstants;
- Distribution License (#AX001-0020) - Allows you to use all objects; Allows you to Rent, lease or distribute an unlimited number of licenses of the software outside your organization bundled with an application.
For a detailed description of the new licensing scheme, click here.
INSTALLATION AND UPGRADE
- Installation -
To learn more about installing the product for the first time, please read our manual.
- Upgrade from ActiveSocket 2.4 -
Upgrade to ActiveSocket 3.0 in the following way:
- Uninstall the ActiveSocket 2.4 product. Use the 'Add/Remove Programs' applet in the Control Panel to start the Uninstall procedure;
- Download the ActiveSocket 3.0 Installation file from the ActiveXperts Software web site: www.activexperts.com/download;
- Start the ActiveSocket 3.0 Installation. The InstallShield wizard will guide you through the steps of the installation.
Please note that some interfaces of ActiveSocket have changed. The following interfaces have changed:
- The Socket::SendString function now only takes one parameter, and sends a carriage return/line feed automatically. If you don't want to send a carriage return/line, use the SendBytes function. In previous verisons of ActiveSocket, the SendString function required a second parameter to specify whether or not to send a carriage return/line feed;
- The 'Snmp' object doesn't exist anymore; instead, two new objects are introduced: 'SnmpManager' and 'SnmpData'. The 'SnmpManager' object is used to connect to the remote SNMP manager. The 'SnmpData' object encapsulates a single SNMP data object;
- New SNMP Trap classes. The ActiveSocket 2.4 'SnmpTrapIn' and 'SnmpTrapOut' objects don't exist anymore; instead, two new objects are introduced: 'SnmpTrapManager' and 'SnmpTrapData'. The 'SnmpTrapManager' object is used to connect to the remote SNMP manager and send or receive SNMP trap data. The 'SnmpTrapData' object encapsulates a single SNMP trap data object;