OfficeServ Link. User Guide

Transcription

1 OfficeServ Link User Guide Version 3 April 2008

2 (This page left blank intentionally.)

3 EULA End User License Agreement End user License Contract on Samsung Electronics Software Please read it carefully as being very important. This end user license contract (hereinafter called license contract ) is to be concluded by and between Samsung Electronics and you (individual or a single firm) on the Samsung s software product ( software product or software) specified herein above. Software products include telephony driver, related media, printings and on-line or electronic documents. You re deemed to agree with the terms and conditions of this license contract by installing, duplicating and using the software. Unless you do not agree with the terms and conditions of the license contract, Samsung Electronics will not allow you to have the right to use the software product. In this case you are not allowed to use and duplicate, and should give notice to Samsung Electronics on the disposal of the used products immediately. Right to Use Software Product This software product shall be protected by the Laws and Regulations on Intellectual Property Right, the Protection Laws of Computer Program, Copyright Acts and International Copyright Acts. Software products shall not be intended for sale and allowed for any use. Grant of License The following rights will be granted under this contract to use: Software. You are allowed to install one copy on your computer and use it. User Manual. You do not have any right to allow any third party to copy or publish part or the whole of User Manual in any form which is scheduled to release with this software product unless otherwise there is written consent form Samsung Electronics. Limitation to reverse engineering, decompile and disassembly. Except any limited scope as explicitly allowed by the relevant laws and regulations, you shall not do reverse engineering, decompile and disassembly. Part Separation. Software is allowed only for use in a single product. You can not use the software in more than two computers. Rent or Lease. You cannot rent or lease software product. Product Support. With regard to software product, Samsung Electronics will provide product support only for those places where Samsung Electronics policy, program and software products are sold. The

4 EULA technical information furnished by you for product support will be used by Samsung Electronics without any limitation for further product support and development. Transfer of Software. You can transfer all the rights for the use of the software bind to this contract. However, you must transfer all of the software (including all related parts, media and the right to use) without possessing any copies for private use, and the transferee must agree with every term of this contract. In the case of software upgrade, the use of this new software will follow this new license. Termination. In the case you are in breach of this contract, Samsung Electronics shall have the right to terminate this contract without any damage to the right of Samsung Electronics pursuant to this contract. In such a case, you should destroy all copies of the software. Upgrade and Copyright Upgrade. When the software is upgraded from software program package for which you are allowed to use as a single product, such a software shall be used or transferred as part of a single product package and shall not be use in more than two computers. Copyright and Ownership. Samsung Electronics shall reserve the ownership and copyright for the associated printings and copies. The products of Samsung Electronics shall be protected by the Copyright Acts and other International Agreements. You are not allowed to copy any of the printing materials enclosed with the software product. Privilege Privilege. This software can be used with telephony software which has been authorized by Samsung Electronics. Guarantee in the Republic of Korea Limitation to guarantee Limitation to guarantee. Samsung Electronics shall guarantee that (1) the guarantee will be subject to the conditions prescribed in the printing materials furnished with the products for the subsequent 90days on and after the receipt of software by the user and (2) there is not any defects in the material and technologies for 1 year on and after the same date under normal use and service conditions. All the implied guarantees for the software and hardware of Samsung Electronics shall continue to come into effect for 90days and 1 year respectively. Within the jurisdiction not limiting the implied guarantee period may not be applied such restriction as described above.

5 EULA Remedy for customer. As the whole liabilities imposed on Samsung Electronics as well as the only restriction levied on you, Samsung Electronics, with its option, will (1) return you the money already received or (2) perform repair activities for or exchange the software and hardware returned to Samsung Electronics with the copy of receipt into the new one, when this limited liability does not fulfill the requirement. These conditions will not be applied to the defect from accident, abuse or misuse. The guarantee for the exchanged software and hardware will continue for the remaining period of the existing product or for 30days, whichever comes later. Exclusion of other guarantees. Within the maximum scope allowed by the relevant laws, Samsung Electronics shall be excluded from any and every explicit or implied guarantee for the printing material and other hardware including any implied guarantee for the compatibility with any other specific purpose and the nature of product. This limited guarantee will grant the detailed legal right to you and may be subject to the jurisdiction. Indemnity from the resulting damage. Within the maximum scope allowed by the relevant laws, Samsung Electronics, in any case, shall be indemnified from any damage from the use or unuse of this product (direct or indirect damage to personal injury, loss of operating profit, suspension of works, loss of sales information or, but not limited to, any other financial loss) even though such potential losses have been already known to Samsung Electronics. In any case, all the liabilities shall be limited to the total payment to which customer has already paid for the software and hardware by you. There may exist such cases as being excluded or not restricted by the jurisdiction, which may cause that such a restriction does not apply to your case.

6 EULA This User Manual can be changed without prior notice. Unless otherwise specified, the data used in the example including company, name and others does not represent actual data. Part or whole of this manual cannot be used or duplicated in any form without written consent from Samsung Electronics. Patents, trademarks, copyrights and intellectual property right shall be owned by Samsung Electronics. Except those prescribed under this contract with Samsung Electronics, the purchase of User Manual does not mean any transfer of patents, trademarks, copyrights and intellectual property right Samsung Electronics Co., Ltd. All rights reserved. Indicate a potentially hazardous situation which if not avoided, may result in minor or moderate injury. It may also be used to alert against unsafe practices.

7

8 Table of Contents Table of contents End User License Agreement...i End user License Contract on Samsung Electronics Software...i Guarantee in the Republic of Korea...ii Chapter 1 Introduction...1 Overview of OfficeServ Link...1 Simultaneous access of up to eight switches...1 Various Option Settings...1 License Management...1 User Management...1 Evaluation Period...1 (This page left blank intentionally.)...2 Chapter 2 Installing OfficeServ Link...3 Preparation for installing Link...3 Computer System Requirements...3 OfficeServ Key Telephone Requirements...3 Configuration Environment...4 System Administration Requirements...5 Installation...5 Post Installation Checking the registered program group in Windows Start menu...10 Installing the Link License Chapter 3 OfficeServ Link Settings...12 Executing OfficeServ Link Description of Link Main Window Configuration of Link Main Window...13 Communication Environment Setup Adding Switch Information...15 Modify Switch Information...16

9 Table of Contents Delete Switch Information...16 Switch Selection...17 Communication Environment for User Access Standby...17 User Connection Waiting Port and Bypass Connection Waiting Port...18 Option Settings Normal option...19 Message Monitoring and Saving Option...20 SMDR / UCD Message Exteranl Send Options...21 OfficeServ Call+ Function Support Option...22 Link State Message Display Option...22 Link Display Language Option...22 Switch Link Recovery Try Count Option...23 Recovery Try Time Period Option...23 User Management List User Management Information...23 Adding a User...24 Modify User Information...25 Delete User Information...25 Chapter 4 Using Link...26 Connecting to a telephone system Connecting PBX system after Setup of Communication Environment...26 Disconnecting Link from the PBX system Chapter 5 OfficeServ Link Operation Status...31 Viewing Link state in Default mode Chapter 6 Message Monitoring...34 Call processing message monitoring program SMDR / UCD Message Monitoring Program Installing Monitoring Program on other Computer Using SMDR/UCD Message from External Applications Chapter 7 License Registration...42 Trial Period License Registration Installing the License License Change... 48

10 Table of Contents (This page left blank intentionally.)

11 Introduction Chapter 1 Introduction Overview of OfficeServ Link The OfficeServ Link version 3 (called Link) is a software product that sits between CTI applications, (based on the Microsoft TAPI 2.x specifications), and Samsung s OfficeServ range of telephone systems(called Switch). Many different CTI applications based on TAPI 2.x can interact with the telephone system through the intervention of Link. Also, all kinds of call processing events generated from the telephone system are transferred to each CTI application through the intervention of Link. The Link has the following functions: Simultaneous access of up to eight switches Link accesses up to eight switches simultaneously and sends various call status information generated in the switch to the corresponding application programs that use the information. Link sends call processing commands from each application program to the corresponding switch. Various Option Settings The Link provides various options that you can easily change. This includes, SMDR/UCD message-related functions, OfficeServ Call, OfficeServ Call Plus, auto connection, run as service option, etc. License Management The Link provides a license management function for Samsung CTI Products including: OfficeServ Call / CallPlus, Operator, EasySet, News etc. To use any software, a valid license has to be installed on the Link. User Management Link provides a function that can control the switch message characteristics offered to each user based on the user computer IP address. Evaluation Period You can use the OfficeServ Link in an evaluation mode for thirty days from first installation. During this evaluation period, the Link application and other OfficeServ applications connected through the Link, e.g. OfficeServ Call, will function correctly. The Link must be registered by the application of a valid license key during this period, failure to apply a license key will result in the non operation of the Link and any associated applications at the end of the evaluation period. SAMSUNG Electronics Co., Ltd. Page 1

12 Introduction (This page left blank intentionally.)

13 Installing Link Chapter 2 Installing OfficeServ Link Preparation for installing Link Before installing the Link software, following system requirements are needed. Computer System Requirements Operating System (OS) Windows 2000 / 2003 Professional / Server Windows XP Professional Recommended OS: Windows XP Professional or later Note: Administrator privileges are required to install and run this application CPU - Intel P4 2.8 GHz (minimum) or faster Hard Disk 20 GB or more Memory Capability Minimum or more than the specification required for the installed OS Recommended Memory: 2 GB or more LAN - 100Mbps or faster OfficeServ Key Telephone Requirements Switch software version required for Link Operation OfficeServ 100/500: Version 2.69 or higher OfficeServ 7100/7200/7400: Version 4.14 or higher In order to check if your switch has the latest version capable of supporting the Link, please contact your Authorised Samsung Reseller. SAMSUNG Electronics Co., Ltd. Page 3

14 Installing Link Configuration Environment The following figure shows the connections between the Link computer, the OfficeServ telephone system, and the connections to the CTI application computers. 98/2000/ XP/ /XP/ /XP/ /XP/2003 OfficeServ Call OfficeServ Operator V1.3x /2.0.0.x OfficeServ DataView OpenTSP 3rd Party CTI S/ W TCP / IP OfficeServ Link V3 TCP/ IP Messenger Server OfficeServ Messenger EasySet Server (Web Server) OfficeServ Messenger OfficeServ ACD Server OfficeServ Link V3 Installed Computer No No. 8 Client Client EasySet EasySet Client Client ICC ICC ICC Agent Agent Agent ACD Agent OfficeServ System (MAX 8 EA) << OfficeServ Link, Call, Operator, EasySet, OpenTSP Driver, ACD, 3rd Party S/W Configuration Diagram >> Figure 2.1 Typical CTI Setup on the network As shown in the figure above, the Link supports LAN connections using TCP/IP protocol. In addition, the Link receives and manages a connection request from each user s computer through TCP/IP on the network, and transmits and receives messages generated between the switch and the CTI applications that are running on users computers. Note Link connections for each OfficeServ Key telephone system OfficeServ 100 / 500 / 7100 / 7200 / 7400 Supports LAN connections. Note All CTI applications connected to the Link must be TAPI 2.x based. 3 rd party application that requires a connection to the OfficeServ Key telephone system will use the OpenTSP Driver. The OpenTSP Driver is a TAPI 2.x compatible Telephony Service Provider. SAMSUNG Electronics Co., Ltd. Page 4

15 Installing Link System Administration Requirements Users must be logged on with Administrator privileges to install and run this program successfully. Administrators have complete and unrestricted access to the computer/domain. Installation The Link installation process is provided in a single installation program. Execute LinkSetup.exe, and then the Link installation program will run automatically. Note You have to install the Link program to use the CTI applications built for OfficeServ Key telephone systems. OfficeServ Call / CallPlus, OfficeServ Operator, OfficeServ Dataview, OfficeServ EasySet, and OfficeServ ACD Package, are CTI applications for OfficeServ Key telephone system that requires the Link. You must install the Link before using those programs. Install the Link program as follows: 1. Execute OfficeServ Link.exe, the Link installation program, and the following dialog box will appear on the screen. Click on the [Next] button to continue. SAMSUNG Electronics Co., Ltd. Page 5

16 Installing Link 2. License Agreement dialog box appears on the screen. Read the text of License Agreement, and click on the [Yes] button if you agree with the license. If you do not agree, click [No], and the Link installation program will exit automatically. 3. User and Company Registration box appears on the screen. Insert a valid username and company name and click on the [Next] button to continue. SAMSUNG Electronics Co., Ltd. Page 6

17 Installing Link 4. Confirmation Box appears on the screen. Check the name and company as appear in the box and click on the [Next] button to continue. 5. The installation program requires you to specify the destination of Link software. By default, Link software is installed on the path of C:\Program Files\Samsung Electronics\OfficeServ Link. Click on the [Browse] button if you want to install software on a different destination. After specifying the install destination of Link software, click on the [Next] button to continue. SAMSUNG Electronics Co., Ltd. Page 7

18 Installing Link 6. The installation program requires you to register the Program Folder name in the Start menu for the Link program. By default, the installation program registers OfficeServ Link V3 as the group name. Click on the [Next] button to continue. 7. The installation program requires you to specify the computer s Windows Operating System (OS) that you will install Link software on. Choose the correct Windows OS, and click on the [Next] button to continue. SAMSUNG Electronics Co., Ltd. Page 8

19 Installing Link 7. The Link software supports two languages: Korean and English. The text displayed in Link software is dependent on the mode specified in this dialog box. The language mode can be changed after installation if required. Choose a mode and click on the [Next] button to continue. 9. The installation program will start the installation process by copying the necessary files onto the computer. You may cancel the installation process at any time by clicking on the [Cancel] button. SAMSUNG Electronics Co., Ltd. Page 9

20 Installing Link 10. Installation has successfully completed. Click on the [Finish] button to exit the installation program. Post Installation When Link software has successfully completed, you have to ensure that the following programs have installed on the computer. Checking the registered program group in Windows Start menu OfficeServ Link V3 License Tools Switch Message Monitor SMDR-UCD Message Monitor : Link executable program : License registration tool program : CTI message monitoring program : SMDR-UCD message monitoring program Note For further the details of each program, see Chapter 3. SAMSUNG Electronics Co., Ltd. Page 10

21 Installing Link Installing the Link License. Before the Link Application can be configured and used, it must be licensed. The License procedure is described in Chapter 7. You can use the OfficeServ Link in an evaluation mode for thirty days from first installation. During this evaluation period, the Link application and other OfficeServ applications connected through the Link, e.g. OfficeServ Call, will function correctly. The Link must be registered with a valid license key during this period, failure to apply a license key will result in the non operation of the Link and any associated applications at the end of the evaluation period. This rule is not applicable to the bypass port applications. SAMSUNG Electronics Co., Ltd. Page 11

22 Link Settings Chapter 3 OfficeServ Link Settings Executing OfficeServ Link Proceed to [Start] -> [Program] -> [OfficeServ Link V3] and choose OfficeServ Link V3. Then, Link program will run. As soon as Link starts running, the following dialog box appears on the screen. Figure 3.1 OfficeServ Link main window Note OfficeServ Link will run automatically if you have set up the Link to start in the Startup folder during installation. Note The Link icon automatically appears in the system tray when minimized. Double click the icon or right click the icon to restore the Link window. mouse over the Link icon in system tray will display the following messages: OfficeServ Link V3 Disconnected when not connected. [Connected User Count : 0 / 0] when Link is connected to switch. SAMSUNG Electronics Co., Ltd. Page 12

23 Link Settings Description of Link Main Window The main window of Link consists of several sections as follows: Configuration of Link Main Window Figure 3.3 OfficeServ Link main window Connected User List View This section shows the status of connected users to the Link in real time. Notification Message View This area shows the current status of Link. In addition, it also shows the connection state to the switch, connection state to user, and any error description if an error occurs. Feature Buttons These buttons are related to the environment setting and operation of Link software. Insert switch information and modify user access standby port. SAMSUNG Electronics Co., Ltd. Page 13

24 Link Settings Setup user management, message monitoring functions, change language mode, automatic connection mode, run as service, and others. - Configure users to receive multiple switch information using this button. By default, all users are only allowed access to the default switch. / - Connect to a switch using this button. Once connected, t0his button will change to Disconnect and vice versa. Link Status Bar Figure 3.3 OfficeServ Link status bar Switch Count: Shows the number of connected telephone systems. Link State: Shows the status of Link; connected or disconnected. Used License: Shows the number of users currently connected to OfficeServ Link. Total License: Shows the total number of users allowed with the current licence. Communication Environment Setup Click the button to set up communication environment. This area must be setup for Link to communicate with the respective telephone system. Figure 3.4 Setting communication environment The following task is performed through the Config Switch Information window: Configure connections to Ttlephone system (add/delete/modify) SAMSUNG Electronics Co., Ltd. Page 14

25 Link Settings Set the Default switch information for users connected to Link Set the Listening port for standby applications Adding Switch Information Link provides a function of connecting up to 8 Samsung key phone switches. In the configuration item, assign a switch number against each connected switch. Then, setup the IP address of the switch, associate a name to the switch and then save the information. Select the button to display the window for adding a switch. Figure 3.5 Add switch Information Enter the following information for each switch. Switch No.: 1 to 8. Switch IP Address: OfficeServ MCP IP address. Switch Port No.: Default switch CTI port is Switch Name: Switch name entered by the user. Switch Type: OfficeServ. EasySet Password: Password required to operate OfficeServ EasySet. (MMC 841) Use Switch Information: Check this box to enable connection to this switch. A new entry will be added to the Switch Information List as below once the Add button is clicked. Figure 3.6 Result from adding switch Information SAMSUNG Electronics Co., Ltd. Page 15

26 Link Settings Note Link only connects to the switch when Use Switch Information is checked. The number of switch displayed in the status bar of the main Link window shows the number of switch that is enabled with Use Switch Information. Note To improve CTI access stability, the following switch settings must be modified: MMC 830 CTI Server Addr: Enter the computer IP address where Link is install and executed. This information allows the switch to reject all other CTI connection attempts to it. Thus, prevents abnormal CTI link disconnection. Modify Switch Information Select the switch for modification from the Config Switch Information list, and click the button to modify the switch information. Figure 3.7 Modify switch information Click Apply once the modification for this switch is completed. Note An error message as below will display if switch IP address is already registered. Figure 3.8 Duplicated switch IP address error Delete Switch Information Select the switch you want to delete, and click the button to remove this entry from Config Switch Information list. A confirmation window will appear as below, click OK delete the switch information permanently. Figure 3.9 Delete switch information confirmation box SAMSUNG Electronics Co., Ltd. Page 16

27 Link Settings Switch Selection By default, each connected user is assign to use the default switch information specified in the Config Switch Information Window as shown below: Figure 3.10 Default switch selection User List Management can override the default switch assigned to each user. This section will be covered later in this user guide. Communication Environment for User Access Standby As soon as connections have been successfully completed with the telephone system, the Link starts a process to perform the service needed to receive requests from users. In the LAN-based TCP/IP case this listening port is set to 6000 by default. Usually this will not need to be changed, but in the event that a port conflict occurs, then port numbers 1024 or higher can be used if necessary. Port numbers ranging from 0 ~ 1023 are reserved by the Operating System. There is a command for you to check which TCP/IP port numbers are currently used. Use the following command in the command prompt of Windows as follows: C:\Netstat a e n p TCP Figure 3.11 Port status Note Communication environment can only be modified when Link is disconnected from all switches. SAMSUNG Electronics Co., Ltd. Page 17

28 Link Settings User Connection Waiting Port and Bypass Connection Waiting Port There are two types of user connection waiting ports used in Link. Port 6000 is the default port number used by license registered programs such as OfficeServ Call, Operator, DataView, EasySet, OpenTSP and News. Port 6500, also known as the bypass port, is the default port number used by other programs which are not license through Link. For example: OfficeServ ACD, Messenger, Call Simulator, and other programs. Note The bypass connection port is always to the User Connection port. Therefore, if 6000 is configured as the user connection waiting port, then 6500 will operate as the bypass port. SAMSUNG Electronics Co., Ltd. Page 18

29 Link Settings Option Settings The Link has options that allow you to control various operations. Choose the option button and the following dialog box will appear on the screen. Figure 3.12 OfficeServ Link option menu The following description applies to each of the above function. Normal option User Connection Limit This value is set automatically when avalid license key is installed. Figure 3.13 Status bar showing the number of installed licenses Note The Link will not accept any client connection requests without a valid license. To get the valid license key, Contact the Authorised Samsung Reseller. Use Message Auto Clear Option During Operation, the Link shows various status messages on the status message bar placed at the bottom of the Window. If enabled, the maximum number of message lines retained can be set in this field. (choose from a range of 100 to 9999). If disabled, a SAMSUNG Electronics Co., Ltd. Page 19

30 Link Settings maximum of 9999 lines is specified. If the number of message lines exceeds the maximum, old lines will be deleted. Note We recommend that you enable the message Auto clear option, and set the number of lines to a low setting during normal use. If you specify a high value, the performance of Link may degrade. Use Automatic Switch Connection Option When Link is executed, this option decides whether Link should connect automatically to the designated switch. This is recommended for normal use. Note When the Link is setup in the Startup folder of the Start menu, this option will enable Link to start automatically when a user logs onto the computer. This option should be disabled if you need to change the communication environment in Link. Run as System Service This function registers Link as a Service in Windows Operating System. Link will start automatically without requiring a user to log on after the computer restarts. Note It is recommended to use the automatic connection function if Run as system service is used. Message Monitoring and Saving Option The Link has the ability of transmitting internally processed messages to an external monitoring program. This monitoring program is installed together with Link software. In addition, if you install the additionally provided monitoring program, you can also monitor the messages that are currently processed via LAN on the other computers. Switch message monitoring option settings A general message means a call-processing message that is transmitted and received between Link and the telephone system. The Link transmits the currently exchanged general message to the general message-monitoring program, and the monitoring program shows you the received message. It also provides a Save function. The General message monitoring program, [Switch Message Monitor] is installed when Link software is installed. Figure 3.14 General message monitoring program For connection to the general message monitoring program, Port Number 6001 is specified by default. You can access to the Link by using the IP address of computer that Link runs and its specified port No, when setting up the monitoring program. A value of 6001 is default. SAMSUNG Electronics Co., Ltd. Page 20

31 Link Settings SMDR/ UCD message monitoring option settings SMDR message or UCD message can be transmitted to the Link from the telephone system, according to the settings of CTI option. The SMDR / UCD message can provide charging or UCD group information through an additional program (not supplied). The Link can monitor such SMDR / UCD messages in the form of that is transmitted from the telephone system. To monitor such messages, the Link provides the SMDR / UCD message monitoring program similar to the general message-monitoring program. It is set to 6002 by default. Figure 3.15 SMDR/UCD message monitoring program Information of the message monitoring setting state is indicated on the main window of Link as follows: Figure 3.16 Link message monitoring status Note The detailed description of Switch Message Monitor and SMDR / UCD Message Monitor program is included in the section of message monitoring. Password Protection Option The Link protects the anonymous access to SMDR port by using a password. Before connecting the message monitoring port, each monitor program should send the valid password to the Link to establish the connection. SMDR / UCD Message Exteranl Send Options The Link provides a port capable of transmitting two messages for use by optional SMDR or UCD collection and analysis software, independently of the SMDR / UCD Message Monitor. This Port No. is 6003 by default. Note According to the 3 rd party application, you can change the access method for the SMDR / UCD Message external send option. With the password protection mode, the 3 rd party application should follow the password check protocol before accessing the external send port. Without the protection mode, any 3 rd party application can access the SMDR / UCD message external send port. You have to remember that SMDR or UCD message can include some internal security data relating to system or each device. To protect them, use the Password protection mode.. SAMSUNG Electronics Co., Ltd. Page 21

32 Link Settings OfficeServ Call+ Function Support Option The OfficeServ CallPlus program transmits caller information saved in the computer to the telephone system, based on the CLI details of the originating call, so that the telephone system can display this and other pertinent information on the LCD of digital telephone. However, some older types of Samsung telephone system cannot process the OfficeServ CallPlus message. In this case, the transmission of Link Plus message toward such systems may cause an error in the connection process. This option allows you to specify if the OfficeServ CallPlus message shall be transmitted to the telephone system. Note To check whether or not your telephone system supports the function of OfficeServ Call Plus message, contract an Authorised Samsung Reseller. Link State Message Display Option In the case of a system error, the Link can transmit a trace message of its internal processes to an external program to provide debugging information. A debugging tool, DBView.exe, can be found in the Tools folder. If you execute the DBView.exe program while this option is active, you can monitor the detailed messages through the DBView.exe program and can save the output result in a file. The Link also supports a log message save option. Link can save the current event messages into a specific log file on the Link installed folder. (Log File Name: OSLx.LOG). Log files are numbered from 0 to 29, and each log file size is five megabytes at maximum. For example: OSL0.LOG, OSL1.LOG, OSL29.LOG OSL0.LOG is reused automatically once OSL29.LOG is full. Note The status message output options have a significant effect on the performance of Link program. Therefore, in normal use, operate the Link with these options disabled. We recommend you activate this option only when you need to trace the cause of a problem or abnormal working in the Link. Link Display Language Option The Link supports five languages, Korean, English, German, Italian and Russian, and runs in the mode specified during installation. However, this option allows you to change the language mode if necessary. If you want to change the language mode, you have to restart the Link after changing the mode and deactivating the Link. When changing the language mode, you get the following alarm message. Figure 3.17 Applying new language option SAMSUNG Electronics Co., Ltd. Page 22

33 Link Settings Click on the [OK] button to save the changes after you have completed the setting of all the options above. Switch Link Recovery Try Count Option When the CTI link is failed between the Link and the Switch, the link will try to recover the CTI link until the retry count elapsed or the CTI link is recovered. The initial value of this recovery count is 30.(the minimum value). User can select one value between 30 and Recovery Try Time Period Option User can adjust the recover interval time period by changing the recovery try time period. The default value of this option is 1 minute. User can select one value between 1 and 255. User Management List Link manages user access switch information by using IP address filtering. The Manage User List menu works as an access control list to determine which switch information is allowed for a particular IP address. Static IP address allocation is required for those users accessing multiple switch information. User Management Information Figure 3.18 User list management Users requiring access to multiple switch information needs to be added onto the User Management List. The function of this list is to reduce the traffic send between multiple switches and every connected user. A manager can register a new user, modify or delete an existing user through the user management list. User IP Address: Insert the static IP address of the user s computer. User Name: Enter the full name of the user. User Information: Enter a brief description of the user. Status: Check user connection status. Filtering: Set OfficeServ Call filtering option. Default Switch: Set the primary switch information used by the user. Multi-switch: Allow other switch access by selecting o on the sw# column. SAMSUNG Electronics Co., Ltd. Page 23

34 Link Settings Adding a User Click on the [Add] button to add a new user as follows. Figure 3.19 Add user Insert the static IP Address of the user s computer. Insert the name and a brief description of the user. Allocate Switch Usage Select the corresponding row that you want to allocate switch access for this user. Then, click the Use button to change it from x to o. You may also do this by double clicking on the selected row. Default switch Assign the default switch for this user. This will override the Default switch used in Config Switch Information. The error message will display as below if no default switch has been setup for the user. Figure 3.20 Default switch selection error Use Filtering Mode for OfficeServ Call This feature filters traffic between Link and several OfficeServ Call Connections. Without this option, Each OfficeServ Call will receive all switch messages from Link. When there are many connected OfficeServ Calls at the moment and Link are connected to several switch systems. This situation can create huge useless traffics to both Link and each OfficeServ Call. This option applies only to OfficeServ Call. SAMSUNG Electronics Co., Ltd. Page 24

35 Link Settings The following is a sample of a configured user management list. Figure 3.21 Manage user list Modify User Information Select a user from the list and click the [Modify] button. Figure 3.22 Modify user information The following error message is displayed if the IP information already exists. Delete User Information Figure 3.23 Duplicated user IP address error You can select from the corresponding information list, and delete a user by selecting the [Delete] button. The information is permanently deleted if the [OK] button is clicked. SAMSUNG Electronics Co., Ltd. Page 25

36 Using Link Chapter 4 Using Link Check the configuration of the Phone System. Before connecting to the telephone system, you have to set up the connection parameters within the system. Telephone settings for an IP Link connection Be sure that the IP address of the telephone system has been specified in the MMC 830. This IP address shall be the same as in the communication environment of Link. The Link computer static IP Address also should be inserted under CTI Server Address in MMC830 to avoid unnecessary disruption. Connecting to a telephone system After setting the parameters above, click on the [CONNECT] button of Link, and proceed to the connection process of PBX system. Note In you intend to use the Link in the user management mode, add the user information before proceeding to the connection process of PBX system. Connecting PBX system after Setup of Communication Environment 1. After all the steps have been normally completed, clicking on the [CONNECT] button will generate the following dialog box on the screen. Figure 4.1 Click the [OK] button Click on the [OK] button; and the Link attempts to connect the telephone system by using the communication environment established. SAMSUNG Electronics Co., Ltd. Page 26

37 Using Link 2. The following window appears on the screen. Figure 4.2 Process of connection to telephone system As soon as the process of connection to the telephone system has successfully completed, the following state message pane appears on the screen. Figure 4.3 Connection success message The connection state of Link is shown as (number of successfully connected switch), and the AVI picture rotates in the bottom right corner of the window. This means the currently connected state is normal. The static AVI picture means that the connection has stopped running or there is an error. At this time, the [CONNECT] button of Link changes into. SAMSUNG Electronics Co., Ltd. Page 27

38 Using Link Note If there is an error in the connection between Link and PBX system, error information is displayed on the message pane. Information of each state displayed on the state message pane has its icon respectively. GeneralMessage.ico ErrorMessage.ico The General Message Icon means that the Link notifies a user of general message, and the Error Message Icon means that the Link notifies a user of error message generated while the Link runs. If an error occurs during the connection process, the Link performs an automatic recovery process until the error disappears (or up to the number of retries). If the Link cannot perform the automatic recovery, it notifies users of the error through the status message pane. Figure 4.4 Automatic recovery message after error event SAMSUNG Electronics Co., Ltd. Page 28

39 Using Link Disconnecting Link from the PBX system 1. Click the [Disconnect] button to disconnect the Link from the Switch. The following dialog box will appear. Figure 4.5 Terminate all connections confirmation box Click on the [OK] button. 2. The Link displays the following pane on the screen, and finishes the connection with the telephone system and all the users. Figure 4.6 Successfully disconnected from all telephone systems SAMSUNG Electronics Co., Ltd. Page 29

40 Using Link Successful disconnection changes the connection state of Link and indicates it as, and changes the [Disconnect] button from to. SAMSUNG Electronics Co., Ltd. Page 30

41 Link Operations Chapter 5 OfficeServ Link Operation Status When the Link program is successfully connected to the specified switch, each user can access the Link program to perform call processing and other relevant functions using Samsung s key phone switch. This chapter describes the operation state for Link in normal service. Viewing Link state in Default mode Figure 5.1 Link running in default mode Figure 5.1 shows the normal working of Link running in default mode. While the Link is running in this mode, the user connection state window shows the following information: IP address Shows the IP address of the connected user. Port No. Shows the port number of the connected user s PC. The port number of the Link program is set to 6000 by default. This is specified in the communication environment options. User type Shows the connected application to Link. SAMSUNG Electronics Co., Ltd. Page 31

42 Link Operations Connection state Shows the connection status. If the connection is successful, this state is displayed as Connected... In addition, if the program is call or operator, the extension number used by the program is also displayed. Connection Time Shows the time when the connection was made by the user to Link. A screen shot of Link with connected users Figure 5.2 User connected to Link Figure 5.3 Link connection events SAMSUNG Electronics Co., Ltd. Page 32

43 Link Operations Viewing the connection status of Link Bypass ports The Link program displays Bypass port users on a separate screen. Press F11 key on the Link window to open the Bypass port window as follows: Figure 5.4 Bypass port connection status Note The type of Link s Bypass port application program and the number of users who are connected to the port are managed separately. SAMSUNG Electronics Co., Ltd. Page 33

44 Message Monitoring Chapter 6 Message Monitoring The following messages are transmitted and received between the telephone system, Link and user applications: CTI messages exchanged between the Samsung key phone switch and the user program SMDR/UCD messages provided in the Samsung Key phone switch To monitor such messages, the Link provides two kinds of monitoring programs. Call processing message monitoring program: SCMMonitor.exe i.e., placed in [\Program Files\Samsung Electronics\Link]. SMDR / UCD message monitoring program: SUMonitor.exe i.e., placed in [\Program Files\Samsung Electronics\Link]. Call processing message monitoring program Many kinds of messages are transmitted and received between the telephone system, Link, and other applications such as OfficeServ Call, OfficeServ EasySet, OfficeServ Operator, Dataview as well as TAPI 2.x Standard API-based CTI applications. The call processing message monitoring program allows you to monitor the call processing messages currently received and processed by Link, regardless of program location. Running the Switch Message Monitor (SCMMonitor.exe) Figure 6.1 Switch Message Monitor program Execute the Switch Message Monitor program (SCMMonitor.exe), and the following dialog box will appear on the screen. SAMSUNG Electronics Co., Ltd. Page 34

45 Message Monitoring Figure 6.2 Setup Switch Message Monitor program Environment Setup Server IP address Enter the IP address of the computer where the Link program is operating. Server port number (default port #: 6000) Enter the value as indicated in the option menu use SW Msg Monitor of the Link program. Access Password. Enter the password for monitoring the CTI message. This password is configured within the option menu of Link. If you enter the invalid password, you can t connect to the link and get any CTI message. Auto clear option If you select this option, the automatic message deletion function is enabled. Auto clear line count If the number of monitoring output messages exceeds this value while the auto clear option is active, old message lines will be deleted. File save option This option allows you to save the currently monitored messages to a file in the local computer. Language option The monitoring programs support two languages: Korean and English. Restart the monitoring program for the new language to take effect. SAMSUNG Electronics Co., Ltd. Page 35

46 Message Monitoring Note The monitoring environment configuration window appears only when the monitoring program is installed and operates for the first time. For the environment configuration, please refer to the value entered in the option menu of the Link program. Note If the file save function is set, the monitoring file is created in the log folder of the Link program. The log file is created as SWMSG0.LOG in this folder. Basically, 10 log files are automatically created successively and managed. (The number rotates between 00 to 09.) If the size of one log file exceeds 10 MB, the monitoring program creates a new log file (Within the range of 00 ~ 09) and saves the monitored contents. Click on the [OK] button when the environment setup has completed, then the following main window of Switch Message Monitor (SCMMonitor.exe) appears on the screen. Figure 6.3 Switch Message Monitor main window The configuration of the main window is as follows: Messages contents This window displays the call processing switch message received to the Link program. The call processing switch messages are classified into the message that goes from the user program to the switch and the message that goes from the switch to the user program. The information displayed in the message display window of the monitoring program is as follows: Received time This records the message direction and the received time of the message. ICON means the message transferred to the switch, and ICON means the message provided from the switch. Switch number This indicates the switch number to which the message should be send or receive. Message contents This displays the actual contents of the exchanged message. SAMSUNG Electronics Co., Ltd. Page 36

47 Message Monitoring Config button This button allows you to set up the environment, start / terminate monitoring, and delete messages. Status indication bar This bar shows the connected server, connection status, and whether or not the deletion / save function of message monitoring has been activated, etc. Once the configuration is completed and Link is running, select the monitoring start button to start monitoring messages. The following figure shows a running monitoring program. Figure 6.4 Monitoring program showing CTI messages Click on the [STOP MONITORING] button [ ] to stop monitoring. Click on the [CLEAR VIEW] button [ ] to delete the messages that are currently displayed on the window. This function does not delete messages already saved to a file. SMDR / UCD Message Monitoring Program The telephone system can provide SMDR messages and UCD messages if required to external applications for processing through an additional communications port. The SMDR / UCD message monitoring program provides the ability of monitoring such SMDR / UCD messages. Note For the Link to receive SMDR or UCD message from the telephone system, you have to set up MMC 841 to send SMDR/UCD messages from the switch to the Link program. SAMSUNG Electronics Co., Ltd. Page 37

48 Message Monitoring Running the SMDR / UCD Message Monitor (SUMonitor.exe) Figure 6.5 SMDR/UCD Message Monitor program Execute the SMDR / UCD Message Monitor Program, and the following dialog box appears on the screen. Figure 6.6 Setup SMDR/UCD Message Monitor program Environment Setup Server IP address Enter the IP address of computer that the Link runs on. Server port number (default port #: 6002) Enter the port number as specified in the Option menu of Link. Access Password. Enter the password for monitoring the SMDR/UCD message. This password is configured in the options menu of the link. If you enter the invalid password, you can t connect to the link and get any SMDR/UCD message. Auto clear option If you select this option, the automatic message deletion function is enabled. SAMSUNG Electronics Co., Ltd. Page 38

49 Message Monitoring Auto clear line count If the number of monitoring output messages exceeds this value while the auto clear option is active, old message lines will be deleted. Saving SMDR message to file This option allows you to save the currently monitored SMDR messages to a file in the local computer. Saving UCD message to file This option allows you to save the currently monitored UCD messages to a file in the local computer. Language option The monitoring programs support two languages: Korean and English. Note The monitoring environment configuration window appears only when the monitoring program is installed and operates for the first time. For the environment configuration, please refer to the value entered in the option menu of the Link program. Note If the file save function is set, the monitoring file is created in the log folder of the Link program. Each log file is created as SMDR0X.TXT / UCD0X.TXT in this folder. Basically, 10 log files are automatically created successively and managed. (The number rotates between 00 to 09.) If the size of one log file exceeds 10 MB, the monitoring program creates a new log file (Within the range of 00 ~ 09) and saves the monitored contents. Complete the environment setup and click on the [OK] button, then the main window of SMDR / UCD Message Monitor (SUMonitor.exe) appears on the screen. Figure 6.7 SMDR/UCD Message Monitor main window SAMSUNG Electronics Co., Ltd. Page 39

50 Message Monitoring The configuration of window is as follows: SMDR/UCD message contents This window displays the SMDR/UCD message that are currently being monitored. The information displayed in the message window is as follows: Received time Recording the message direction and the received time of the message. ICON means the message provided from the switch. Switch number This indicates the number of the switch to which the message should be provided or which should be processed. Message contents This displays the actual contents of the exchanged message. Config button This button allows you to set up the environment, start / terminate monitoring, and delete messages. Status bar This bar shows the connected server, connection status, and whether or not the deletion / save function of message monitoring has been activated, etc. Click on the [START MONITOR] button. The message monitoring starts after the Link is connected. The following figure shows an example of the SMDR/UCD monitoring program and some sample messages. Figure 6.8 SMDR messages from telephone system SAMSUNG Electronics Co., Ltd. Page 40

51 Message Monitoring Click on the [STOP MONITORING] button, then the monitoring stops running immediately. Click on the [CLEAR SMDR, UCD] buttons,, and the currently displayed messages are deleted. This function does not delete messages already saved to a file. Note In the function of saving the monitoring contents as files, if the file name is not changed, the contents are appended to the bottom of the designated file. Installing Monitoring Program on other Computer The installation of Switch Message Monitor program and SMDR / UCD Message Monitor program is completed together with the installation of Link. Sometimes, however, you may need to run the monitoring programs on another computer that the Link does not run on. In this situation, you may copy the monitoring programs and use it on a different computer. Using SMDR/UCD Message from External Applications The Link provides a separate TCP/IP port for external program that needs the SMDR and UCD message. If the password is set in the option setting of the Link, the external program must supply the password after accessing the TCP/IP port. SAMSUNG Electronics Co., Ltd. Page 41

52 License Registration Chapter 7 License Registration This chapter describes the license installation and update procedure with the license tools applet. To use a CTI application with the link, you have to install the valid license key into the Link within 30 days of first installation. The valid license key will be generated and distributed by an Authorised Samsung Reseller. To get more information about the license and the license key for your own purpose, contact an Authorized Samsung Reseller. Trial Period The Link runs in trial mode for a maximum of 30 days on first install. Trial mode will expire in 3 conditions: 1. If the 30 days is reached 2. If Link is uninstalled and reinstalled 3. If a license key is applied. During trial mode, you are allowed to use all CTI applications supported from Link with limited concurrent connections as follows: Figure 7.1 Number of days left to run Link in trial period SAMSUNG Electronics Co., Ltd. Page 42

53 License Registration Figure 7.2 Trial mode license limitations As shown in the above figure, the trial period is set to expire after 30 days from the installation, and during this period, you may use the following applications with limited connections as follows: OfficeServ Call - 20 concurrent connections OfficeServ Operator - 2 concurrent connections OfficeServ OpenTSP - 1 concurrent connection OfficeServ DataView, EasySet - access allowed If the trial period expires, access to the applications above will be rejected until a valid license key is registered in the Link. However, bypass port access software will continue to work without a valid license. Figure 7.3 Trial period expired dialog box SAMSUNG Electronics Co., Ltd. Page 43

54 License Registration Figure 7.4 License registration showing trial period has expired License Registration Figure 7.5 Running the License Tools program Execute the License Tools program, and the following dialog box appears on the screen. Figure 7.6 License Tools window SAMSUNG Electronics Co., Ltd. Page 44

55 License Registration Registered License displays the installed license key string. License Type shows the installed license s type. Allowed MAC Type shows if the MAC address from the Telephone system or the computer is to be used. This type is determined by the license key License Allowed MAC Address shows the MAC Address to be allowed by the license key Allowed Software Status shows the applications that have been licensed by the key and can be used. MAC Information shows the MAC Addresses detected by the Link - Computer MAC Address is the current computer system MAC Address. - Switch MAC Address is the current switch system MAC Address. Installing the License Copy and Paste the valid license key string into Enter License of Add License and click register button. If the entered license is valid, that license will be registered into the link. *Note: The Link program must be terminated before performing the license registration procedures. Figure 7.7 Registering a valid license key SAMSUNG Electronics Co., Ltd. Page 45

56 License Registration Figure 7.8 Link shutdown check before registering a license key When you click OK button, the license tool will show the registered license information as shown below. Figure 7.9 License successfully registered If the application requirements change, the license can be updated by applying a new key in the same manner as show above. You must select a computer MAC address before terminating License Tools. Figure 7.10 Select a default computer MAC address to use Otherwise, License Tools will display the following error message: Figure 7.11 Default computer MAC address has not been selected Link will run according to the restrictions of the license key once it is successfully registered. SAMSUNG Electronics Co., Ltd. Page 46

57 License Registration The license information can be verified through the main Link as follows: Figure 7.12 License information through Link s main window SAMSUNG Electronics Co., Ltd. Page 47