Home

User Manual - TriVium Systems, Inc

1. Existing Folders Accessores Administrative Tools Java 2 Runtime Environment Microsoft Office 7 Print Internet Printing Snaglt 6 Spothewes 22 Startup unl EW a ii InstallShield z Back Cancel Figure 2 15 Selecting Installation Folder 18 Table of Contents 7 Enter the entry items of the Phone and Modem Options window below Phone 4nd Modem Options i ajx Dialing Rules SAI The list below displays the locations you have specified Select the Se location from which WOW are dialing Locations O My Location Oo Hew Edit Delete Phone number will be dialed as cae he Figure 2 16 Phone and Modem Options Dialing Rules Setup Refer to the steps from 1 to 4 of the Samsung TAPI Driver in 1 2 Installation Conditions for setting the Dialing Rules NOTE 19 Table of Contents 8 Enter the items of the Communication Parameters window below and click the OK button Communication Parameters Connect to Server OfficeSery Link Server F Address TE Server Port Mo E000 Trace Type None C Level C Level 2 Figure 2 17 Communication Parameters Trace Type The Trace Type setup affects the performance of the OpenTSP driver and should be set to None under normal circumstances Change the setting to Level 1 or Level 2 only when instructed by a trained support engineer If the Open
2. The OpenTSP driver creates the command that can be processed by the key telephone system and forwards it to the OfficeServ Link program in order to perform the functions requested by the TAPI service The OfficeServ Link forwards the command received from each OpenTSP driver to the key telephone system of Samsung The key telephone system interprets the forwarded command to make a call from Extension 2001 to Extension 2002 The key telephone system forwards the extension processing results to the OfficeServ Link The OfficeServ Link forwards the extension processing results received from the key telephone system to the OpenTSP driver The OpenTSP driver converts the event for the processing results into the form that can be processed by the TAPI service and forwards the event to the TAPI Service The TAPI service forwards the results for TAPI function processing to the Phone Dialer through the TAPI service Once the steps above are completed the Phone Dialer offers the call processing results to users through an internal processing module 50 Home Page Table of Contents List of the TAPI Functions Restriction The OpenTSP driver supports INTERACTIVEVOICE mode and only the Line Device function out of the list of the TAPI functions of Microsoft List of the TAPI Functions The list of the TAPI functions that the OpenTSP driver enables is shown below TAPI Functions of Microsoft LineAddToConference LineAnsw
3. Table of Contents 5 Select the Audio Video AY tab and check 1f the Line item of the Dialing Device is set to Telephone and click the OK button Lines Audio Video QE Sound Settings Devices Used For Calling E Line EEA A Audio Record eNe devices detected cf Audio Playback eNe devices detected r ath Video Record lt No devices detected gt E video Playback coed a Figure 4 12 Audio Video Tab of Option Screen 6 From the Phone Dialer screen below click Phone gt Dial f Phone Dialer i ee Ol xi File Edit view Phone Windows Help o Dial Rec Redial gt amp Directories G a Internet D My Ne 43 New Conference Pe GS Join Conference Co Egs Leaye Conference 3 My Netwo 4 Speed Dial Conference Room i Leave a Refresh Hide Calls Preview Speed Dial b new directory use the 4dd Directory command in the Edit menu The ries contain people and conferences that can receive Internet calls Place a phone Internet or conference call Figure 4 13 Selecting Dial from Phone Dialer Screen 7 From the Dial screen below check if the Dialing Pattern is set to Phone P and enter 2002 into the entry field Then Click the Connect C button SS sd Enter a phone number Number will be translated using Phone and Modem Options control panel
4. computer click Change Remove Change Remove EA Snagit 6 Size 12 0MB 5l Spothews 2 2 Size 968KE F univ IEW Size 47 9MB in Windows 2000 Service Pack 2 Close Figure 2 26 Add Delete Program 27 Home Page Table of Contents 2 Among the radio buttons select the Remove item and click the Next gt button InstallShield Wizard ng E xX Welcome Modify repair or remove the program WWelcome to the OfficeSer OpenT SF Driver Setup Maintenance program This program lets yan modify the current installation Click one of the options below Modify Select new program components to add or select currently installed components to remove Reinstall all program components installed by the previous setup amp Remove aI Remove all installed components InstallShield Back Cancel Figure 2 27 Delete Window 3 Click OK on the below message window confirming the removal of the OpenTSP driver files Confirm File Deletion x Do you want to completely remove the selected application and all of its components concel_ Figure 2 28 Confirm Deletion 4 The window below appears to confirm the deletion of the C WINNT System32 SCT32 TSP file Click the Retry button to delete this file Locked File Detected i p i x An option you selected requires that files be installed to or uninstalled from pour system or Goth 4 locked file O WINNT Sustems24 SCTSP32 TSP was
5. 1 Click Start gt Programs OfficeServ OpenTSP Driver gt TAPI Sampler Tool as shown below OpenTSP Contig Tool Scavenger Tool Tapi sampler Tool Figure 4 17 Executing the TAPI Sampler Tool 2 Select your extension number from the My Extension field on the screen below and click the Open button E gt Samsung TAPI Sampler NONE My Extention 4 v Open Destination Dial Time f CallHandle CallState CallStat Event Figure 4 18 Selecting Extension Number 44 Home Page Table of Contents 3 Enter the destination number in the Destination field and click the Dial button Setting different numbers for the My Extension and Destination fields will enable receiving calls through TAPI Sampler Samsung TAFI Sampler 2001 xi My Extention 2001 r Close Destination 2002 Dial CallHandle CallState CallStat 14 36 14 2001 opened Figure 4 19 Selecting Destination Number 4 Information on the TAPI messages sent to the TAPI Sampler by the TAPI service are displayed Message Status Window Samsung TAP Sampler 2001 x My Extention 2001 Close Destination 2002 ce CallHandle CallState CallStat 14 38 18 000010399 Ringback rea 14 38 15 LINECALLSTATE_DIALTONE received 14 38 18 LINEC ALLS TATE_AINGBACE received 14 38 18 LMECALLINFO on 000010399 received 14 58 18 LINECALLINFO 0400010399 dw TotalSize 000000
6. 58 Table of Contents 3 5 Page The Page enables the user to give a notice to people simultaneously through the speaker installed on the key telephone or the external speaker installed separately The page is categorized into internal page and external page The internal page is made to the key phones which are set as the internal page zone of the current key telephone system The external page 1s made through the speakers which are set as the external page zone When the external page is made an external speaker should be set in the lt System Programming gt of the Samsung key telephone system Enter the syntax below to call the lineDevSpecific function when the Page is used in the TAPI application LONG lineDevSpecific HLINE hLine DWORD dwAddressID HCALL hCall LPVOID lpParams DWORD dwSize Input Parameter Values e hline Processes the lines to be used e dwAddressID 0 e hCall Not used e lpParams Enters the command strings as shown below e DwsSize Buffer length Null value included Value Byte D C S 3 Bytes P 1 Byte Number of page 1 Byte The page zone numbers are described below e P Internal page zone e PP External page zone e Q Entire internal page e Q Entire external page e Entire internal external page 59 3 6 System Hold Retrieval The System Hold Retrieval enables the user to hold an incoming call momentarily and answer the call from another
7. Audio Video ey Phone and Modem Options Prefered Line For Calling Ce Phone m Internet Line Used For ne Phone Calls lt Auto Select gt m Internet Calls lt Auto Select gt Ea Internet Conferences lt Auto Select gt aree a _ Figure 4 10 Option Screen 40 Table of Contents Home Page Table of Contents e Default line for dialing Select Telephone since the OpenTSP driver is used for line telephones Telephone O Selects the communication line for line telephones Internet N Selects the communication line for Internet lines e Used lines Applies according to the default line used for dialing Phone P Sets telephone lines This number should be identical to the actual extension number of the Samsung switch Internet Communication l Internet Conference F 4 The settings of the Line tab are displayed below The DCS Line 2001 in the Phone field represents that the extension number 1s 2001 The OpenTSP driver displays the device list of the Samsung key telephone system as DCS Line XXXX extension number Lines Audio Video Phone and Modem Options Preferred Line For Calling Ce i Phone m rternet Line Used For ce Phone Calls OCS Line 201 m Internet Calls lt Auto Select gt pie Internet Conferences lt Auto Select gt coed soo Figure 4 11 Line Tab of Option Screen 41
8. Table of Contents The procedure for checking if the Telephony service is normally operating is as follows 1 Select Start gt Settings gt Control Panel from the computer g Programs Documents Settings Ee Search Help 2000 Professional aJ Z fe th amp Run Shut Down Log OFF Administrator Control Panel Printers A Taskbar amp Start Menu Network and Dial up Connections Figure 2 6 Executing the Control Panel 2 Double click the Administrative Tools from the control panel below J Control Panel 1O x File Edit view Favorites Tools Help 4 Back fy Gsearch GyFolders GBristory AG G2 X A Ea Uy a Display AR Game Controllers Keyboard Control Panel Administrative Tools Configures administrative settings For BPRegional Options your computer Windows Update Windows 2000 Support Bey Add Remove Programs EB Phone and Modem Options Kl Sounds and Multimedia 6 Accessibility Options Administrative Tools ij Folder Options Qij Internet Options HA M lt Mouse Ya Power Options By Scanners and Cameras E System Address fe Control Panel gt Go z Configures administrative settings for your computer 2S Add Remove Hardware GG Date Time Fonts gt Java Plug in 1 4 0_03 Network and Dial up Connections Printers Scheduled Tasks ZF Users and Passwords g
9. 031 enter 31 The Dialing Rules option is used for making external calls through TAPI Enter the number to be used for making external calls In Australia the number assigned for outside calls is usually 0 Dialing Rules Since phones in offices usually connect to the trunk line through a private switch consult the telephony manager of your company for information on the number assigned for outside calls 11 5 Select the Advanced tab from the Phone and Modem Options screen to display the list of drivers telephony service providers installed on the system Phone And Modem Options 2 x Dialing Rules Modems Advanced The following telephony providers are installed on this computer Providers Microsoft H 323 TAPI Service Provider Microsoft Multicast Conference TAP Service Provider NDIS Proxy TAP Service Provider TAP Remel Mode Service Provider Unimodem 5 Serice Provider Add Remove Configure me o Figure 2 5 Advanced Tab of Phone and Modem Options The TAPI compatible driver can be installed separately on each computer and a newly added TAPI driver is displayed on the Advanced tab of the Phone and Modem Options The TAPI driver is registered as Samsung SCTSP32 TAPI2 x Compatible Telephony Service Provider or Samsung DCSTSP Telephony Service Provider Home Page Table of Contents 1 3 Checking the Telephony Service
10. 29 Holding Calls in Progress lt i occscecadoscvntensvesanedeutsddeetniaiectiacedervedddsenssesduieleaseen ease 14 2 6 Procedure for Consult Transfer ccccccccceeceseeeeeeeeeceeeeeeeeesaeeeeseeeeaeeeeseeeens 76 ABBREVIATION s sisien EEEE E E aE 79 Table of Contents Purpose The OpenTSP User Manual provides a brief description of the Samsung OfficeServ OpenTSP the installation procedure and the procedure on using the functions of the OpenTSP for engineers who develop the TAPI service and telephony application programs Document Content and Organization This manual includes six chapters and the Acronyms The chapters are summarized as follows CHAPTER 1 Introduction This chapter provides an overview description of the Microsoft TAPI system used on the OfficeServ telephone systems a list of standard supported functions and a list of Samsung Specific functions used only on the Samsung TSP driver CHAPTER 2 OpenTSP Driver Installation This chapter describes items that must be checked before installing the OpenTSP driver and the procedure for installing the OpenTSP driver CHAPTER 3 OpenTSP Window Description This chapter provides descriptions of the screens toolbars and buttons of the various tools created during the installing the OpenTSP driver CHAPTER 4 OpenTSP Driver Guide This chapter provides the procedure on dialing receiving and disconnecting calls through the OpenTSP driver CHAPTER 5 TAPI Fu
11. How to Use Functions For information about how to use the functions refer to the Microsoft web sites about NOTE the TAPI 69 Table of Contents Call Processing Events for the OpenTSP Driver The TAPI service of the system offers the call processing events generated from the line device to the application after calling the lineOpen function so that the TAPI compatible application can use a specific line device as shown in the TAPI Life Cycle 2 of Figure 6 1 This section describes the type of the call processing events to be reported while the call processing events are generated from the Samsung key telephone system and forwarded to the TAPI service through the OpenTSP driver as well as processing procedures Major Events LINE CALSTATE and LINE CALLINFO are the events that all the TAPI compatible applications should process by default These events are reported when the status of a specific call and the details of each call are changed in each line device LINE_CALLSTATE The LINE CALSTATE event is reported when the status of calls 1s possibly changed in each line device Examples of the call status include IDLE RINGBACK OFFERING CONNECT HOLD and DISCONNECT The call status is reported in event of status transition When the LINE CALLSTATE event is generated the TAPI compatible application calls the lineGetCallState function to read the details of call status LINE_CALLINFO The LINE CALLINFO event is reported whe
12. LINE CALLSTATE event to the TAPI compatible application through the TAPI service The TAPI compatible application calls the lineGetCallInfo function to obtain the details of call status 2 3 Home Page Table of Contents Flow Chart of the Status of Calls in Progress The events and messages generated while a call 1s being processed 1 e from making a call to connecting a call by the TAPI compatible application are as follows The figure below shows the example of events on call status sent to the TAPI compatible applications of both a caller and called party when a call is in progress Caller Side TSP Switch Side Called Side Make Call to Destination Idle State Crate New Call Dial tone Event E Crate Idle State New Call Ringback Event Offering Event h B Answer This Call Connected Event Dial Tone State Ringback State Offering State Connected Event Connect State Connect State Drop Event Drop This call Hook On Disconnect State Hook On Event Deallocate N Disconnect idle IDLE State Current Call State Deallocate a Current Call be Figure 6 3 Flow Chart of the Status of Calls in Progress 72 2 4 Details of Calls Home Page Table of Contents When call status is changed for example when a call is made from Extension 201 to Extension 202 by using the TAPI Sampler program the status message of the call is displayed in real time for each event The call status
13. The list above shows only the TAPI functions supported by the OpenTSP driver Some functions from the list of the TAPI functions might be processed by the TAPI service itself Also some functions which are used to add the Telephony Service Provider to the system are not included 1n the list If the functions that are not supported by the OpenTSP driver are called an error message defined in the TAPI will appear The user can find the entire list of the Microsoft TAPI functions from the Microsoft site http www msdn microsoft com library default asp The user can check the format of each function how to use the functions or the status values returned from the list and refer to the list to develop an application Table of Contents Development General Enterprise Development Graphics and Multimedia a Messaging and Collaboration Welcome to the Mobile and Embedded Development MSDN Library NET Development programming esas Active Directory ADSI and Directory Services MAE TEON headlines Network Authentication a a Most Recent Articles Background Intelligent Transfer Service Breakthrough in Oire Fax Service Internet Connection Sharing and Internet Connection Firewall Message Queuing and Queued Components MSMQ Peer to Peer Real time Communications RTC Client Routing and Remote Access Services RRAS El Telephony Application Programming Interfaces TAPI TSPI MSPI BSD PDO VAY BATH SHAD Sas bnr 0332 Gee wearer Goce J
14. WA Power Options Fi Gp Regional Options dA Scanners and Cameras J gf Sounds and Multimedia Users and Passwords Configures vour telephone dialing rules and modem properties My Computer Figure 2 2 Selecting Phone and Modem Options Windows Update Windows 2000 Support 3 Select Edit E from the Phone and Modem Options window Phone And Modem Options p _ x Dialing Rules Modems Advanced 43 The list below displays the locations you have specified Select the location from which you are dialing Locations Ol My Location Oo Mew Edit Delete cat n Figure 2 3 Phone and Modem Options Window 10 Table of Contents Table of Contents 4 Enter the fields of the Edit Location Window by referring to the figure below and click the OK button Edit Location aE General Area Code Rules Calling Card P Location name Specify the location from which you will be dialing County region Area code Korea Republic of al Dialing rules When dialing from this location use the following rules E To access an outside line for local calls dial 3 To access an outside line for long distance calls dial ja F To disable call waiting dial Dial uzing Tone f Pulse Figure 2 4 Edit Location Window Select Country Region and enter your area code Do not enter 0 of the area code For example if the area code is
15. aE ws EI SDK Documentation Microsoft Telephony Overview TAPI 2 2 TAPI 3 1 TAPI Service Providers Figure 5 3 URL of the Entire List of Microsoft TAPI Functions 53 Table of Contents Feature List of the Expansion Functions in the OpenTSP Driver Besides the functions defined by the TAPI the OpenTSP driver provides a variety of expansion functions Call the lineDevSpecific function to use the expansion functions Enter the syntax below to call the lineDevSpecific function LONG lineDevSpecific HLINE hbLine DWORD dwAddressID HCALL hCall LPVOID lpParams DWORD dwSize The features available by the lineDevSpecific function in the Samsung key telephone system are as follows e Station Lock e Vacant Station Message e Follow Me e Make New Trunk Call e Page e System Hold Retrieval e Clear Message Waiting e Clear Call Back e OHVA e Silent Monitoring e Mute On Off e Line Reset 54 Table of Contents Station Lock The Station Lock disables other users from using their own phones to make or answer calls The available modes are as follows e Unlock Release lock e Locked all Lock call outgoing and incoming Enter the syntax below to call the lineDevSpecific function when the Station Lock 1s used in the TAPI application LONG lineDevSpecific HLINE hLine DWORD dwAddressID HCALL hCall LPVOID lpParams DWORD dwSize Input Parameter Values e hline Processes
16. before changing the environment settings Close all TAPI compatible programs that are currently operating and click the OK button 3 Enter the fields in the window shown below and click the OK button OpenTSP Configuration Tool E x Connect to Server OfficeSery Link Server IF Address 165 213 88 88 Server Port Mo 00g Trace Type 0 None C Level Level 2 0K Figure 4 8 OpenTSP Config Tool 39 2 Call Processing 2 1 Call Processing of the Phone Dialer Program A dialing program is installed as standard in all versions of Windows Dialing Procedure Procedure for dialing through the Phone Dialer is as follows 1 Connect the Samsung Key telephone system and the OfficeServ Link program through the CTI link 2 Execute the Phone Dialer program of the PC by clicking Start gt Programs gt Accessories gt Communication Phone Dialer The Phone Dialer screen shown below appears ee Phone Dialer 7 i Ioj x File Edit wiew Phone Windows Help lt eee ee a P E Dial Redial Speed i Leave Refresh Hide Gals Preview a To add a new directory use the Odd Directory command in the Edit menu The i My Network directories contain people and conferences that can receive Internet calls People gt Conferences Conference Room For Help press F1 Figure 4 9 Phone Dialer Screen 3 Select Edit gt Option and display the screen below Options Lines
17. change messages include caller IDs called IDs trunk numbers DNIS information call directions and reasons for call generation As shown in the displayed screen below the messages of call status show both the status change of the call LINE CALLSTATE and the change of the details of each call LINE CALLINFO Once the details of calls are changed the details are forwarded from the OpenTSP to the TAPI service through the LINE CALLINFO event Also the TAPI compatible application calls the lineGetCallInfo function to read the changed information or one to be checked Caller Extension 201 20 opened LINECALL STATE DIALTONE received LINEC ALLS TATE_AINGBACE received LINEC ALLINFO on 00001 02ee received LINECALLINFO 0 000102ee dw TotalSize 0 000001a8 dwhleededSize 0 00000154 dwlsedSize 0 00000154 hLine 04 00010355 dwLineDeviecelD 0 00000005 dwAaddress D 000000000 dw Trunk Os tft 13 CalledID 20 Connected D 0 LINECALLSTATE_CONNECTED received LINECALLINFO on Ox00010 ee received LINECALLINFO O 00010Zee dw TotalSize 0 000001a8 dwhleededSize 0 00000154 dwlsedSize 0 000001 54 hLine 04 00010355 dwLineDeviecelD 0 00000005 dw ddressiO 0 00000000 dw Trunk Os tft 1 Called D 20 ECET T ee CISCONNEC TED GSR LINEC ALLS TATE_IDLE received IDLE Call Handle 0 000102ee deallocated Figure 6 4 Messages of Call Status Called Party Extension 202 Ue opened LINECASLLSTATE_OFFERING received LINEC ALLINFO o
18. modify this warranty and no modification or extension of this warranty shall be effective unless in writing signed by the authorized officer of SAMSUNG TELECOMMUNICATIONS AMERICA L P SAMSUNG DIGIT everyone s invited Software License Agreement amp Limited Warranty For OfficeServ Link for iDCS Keyphone Series Samsung Telecommunications America L P IMPORTANT READ CAREFULLY This Samsung End User License Agreement EULA is a legal binding agreement between you either an individual or an entity and Samsung for Samsung software product identified above which includes computer software and may include printed material and online or electronic documentation SOFTWARE By installing using the SOFTWARE you indicate your acceptance of this Samsung License Agreement If you do not agree to the terms of this License Agreement please do not install or use the enclosed SOFTWARE SOFTWARE LICENSE The SOFTWARE is protected by copyright laws and international copyright treaties as well as other intellectual property laws and treaties 1 GRANT OF LICENSE This License Agreement grants you following rights a SOFTWARE Samsung grants to you a personal non exclusive license to make and use one 1 copy of the SOFTWARE accompanying this Agreement on any single computer provided the SOFTWARE is in use on only one computer at any time If you have multiple Licenses for the SOFTWARE then at any time you may have as many copies of th
19. of Calls on Hold The status message created when a call in progress is held is displayed on the TAPI Sampler program as shown below The Extension that has asked for holding a Call 10 10 03 LINECALLSTATE ONHOLD received 10 10 03 LINECALLSTATE DIALTONE received 10 10 05 LINECALLSTATE_IDLE received 10 10 05 IDLE Call Handle 0x000101ee deallocated 10 10 05 LINECALLSTATE CONNECTED received Figure 6 7 Messages of Call Status 74 Home Page Table of Contents The Extension where a Call has been Held LINEC ALLS TATE_CONNECTED received LINECALLINFO on Ox00010222 received LINEC ALLINFO O 0001022 dw TotalSize 0 000001a6 dwheededsSize 0 0000015 e dwllsedSize 0 000001 5c hLine 0400010311 dwLlineDeviecelD 0 00000006 dwAddressl 0 00000000 dw Trunk Ostttttttt 13 CallerlD 201 CallediD 202 ConnectediID 201 LINEC ALLS TATE_CONNECTED received LINECALLINFO on 000010222 received LINEC ALLINFO Ox0001022 dw TotalSize 0 000001a6 dwheededsize 0 0000015 dwllsedSize 0x 000001 5c hLine 0400010311 dwLlineDeviecelD 0 00000006 dwAddresslD 000000000 dw Trunk Ostttftff 13 CallerlD 201 CallediD 202 ConnectedID 201 Figure 6 8 Messages of Call Status 15 2 6 Home Page Table of Contents Procedure for Consult Transfer If either Extension 201 or Extension 202 forwards an extension call to another extension 203 while Extension 201 or Extension 202 is making the call the TAPI compatible applications of the ca
20. phone This feature is the same as call forwarding unconditional However the call forwarding unconditional is set in the user s phone while the Follow Me is set in another phone Enter the syntax below to call the lineDevSpecific function when the Follow Me is used in the TAPI application LONG lineDevSpecific HLINE hLine DWORD dwAddressID HCALL hCall LPVOID lpParams DWORD dwSize Input Parameter Values e htLine Processes the lines to be used e dwAddressID 0 e hCall Not used e lpParams Enters the command strings as shown below e DwsSize Buffer length Null value included Value Byte DCS 3 Bytes PF 1 Byte Phone number to be forwarded Up to 4 Bytes 57 Table of Contents 3 4 Make New Trunk Call The Make New Trunk Call enables the user to make a trunk call continuously without making the call again even after the trunk call 1s completed Enter the syntax below to call the lineDevSpecific function when the Make New Trunk Call is used in the TAPI application LONG lineDevSpecific HLINE hLine DWORD dwAddressID HCALL hCall LPVOID lpParams DWORD dwSize Input Parameter Values e HLine Processes the lines to be used e dwAddressID 0 e hCall Not used e lpParams Enters the command strings as shown below e DwsSize Buffer length Null value included Value Byte D C S 3 Bytes T 1 Byte Digit of the dialed phone number n 1 Byte Digit to be dialed n Byte s
21. removed and specify the operation time Close Sends the Scavenger Tool to the system tray Exit Closes the Scavenger Tool 32 Table of Contents TAPI Sampler The TAPI Sampler is a utility program that dials receives or disconnects calls through the OpenTSP driver or displays various TAPI events received by the application programs through the TAPI service Start the TAPI Sampler while the OfficeServ Link program is normally operating to display the screen below samsung TAP sampler WOME E x Destination CallHandle CallState CallStat Call Status Window Message Status Window Figure 3 15 TAPI Sampler Screen As shown above the TAPI Sampler is simply configured e My Extension Select the number of the device to be used by the TAPI Sampler e Destination Enter the destination number for an intercom external call e Call Status Window Displays the progress of call origination termination e Detail Message Information Window Displays detail information on messages the TAPI Sampler received through the TAPI service 33 Table of Contents Call Status Window Parameters of the Call Status Window are as follows Parameter Description Time Time when the event occurred CallHandle Call Handle Displayed in 4 byte hexadecimal CallState Displays the call status as Idle Connected Busy etc CallStatDetail Displays additional information if any on the call status Connected ID Displa
22. the Expansion Functions in the OpenTSP Driver cc cccceeees 54 31 Saon LOCK errep 55 3 2 Vacant Station Message ecscaixcciccascesnactessessnscaceascsshesanadigedeacacdseacescsncsedtecaaasenes 56 39 FONOW MG Se ee ee ee eee 57 3 4 Make New Trunk Call cccccccseccceecceeeceeeseseeceeeceeseusecaeeseeeceeesseesueeseeeaes 58 Do PAUE cata nipctcr tase E E 59 36 System Hold Remeval ssrsssrsiirass E E 60 3 7 Clear Message Waiting cccccccseccceseeceeeeceeeeceeseeceeeeseusessueeseueeseesessesenees 61 30 Clear Call BACK s21s cssactancnnsaceassdaacthaatiecadaachesdedactinadaatsadecthadeaentbaaantpandactsascnanaas 62 D OR AA E E T 63 310 SIGAUIMORMONING serate eee EE EEEIEE 64 311 MUE OMOR srren aa EEEN EEEE SNE 65 OZ ENER E s E sedepteaeanaeueste 66 CHAPTER a E EEEE ee AEEA 68 Call Processing FIOW sesisscacasaccssinasass serwessinetassacdades tovsinasewocusimaeianiedecaatoniinbasdtceadidachesusaneantawudass 68 1 ENS Cs VCS ON CS TAP Dessus a ase ema yaad ese rer easaer a deeiaetwshcecnaeeetnageace 68 2 Call Processing Events for the OpenTSP DIivel cccccseeeeceeeeeeeeeseeeeseeeeaeeeeees 70 2l Major Eveni sscan a NAi 70 22 TOW Cait OF Cail US sate ich spect cence E eatin dati clbaeseaane 71 2 3 Flow Chart of the Status of Calls in Progress ccccceeeeeseeeeeeeeeneeeeeaeeeees 72 24 Detalls Of Calls sire carpcectnsnctsey ate ecveareeneanneetandseseanstaltoseteaeoana E E 73
23. the OpenTSP Driver cccccescccsseeceeeeeeeeeceeeeeceeeeseueesaueeseaeeeseeesseeeesaees 27 CHAPTER Beara rcs acdc strates sre ns onesies E aa 30 OpenTSP Window Description iacedccsecdececsce cece cle cccedienes corcexeceeasic ce ecesced waectetaxeeeeeteelnsuesiencess 30 1 OO Sri SP Cong TOO leenena E a 31 2 Scavenger TOO aromia e Ei a E aa EdE 32 3 TAR ONC eea a E E 33 CHAPTER aoee E E TE EAE E EE E 35 OpenT SP Driver GUIR siirsississisnndis naiera Nanaia oR Eear ORANE AAE aE saadaa NENES 35 1 Environment Setup Procedure ccccccccsccsscccsseceeeceucecacecseessueseueeseeessueseeeeseeeseeess 36 1 1 Setup through the Phone and Modem Options Advanced tab 008 36 1 2 Setup through OpenTSP Contig TOol ccccccccsececeeeeceeeeeeeeeseeeeeseeeeaseeeeees 39 2 Call Processing sistein aa A E SNE 40 2 1 Call Processing of the Phone Dialer Program cccccecceeeeeeeeeeeseeeeaeeeeeees 40 2 2 Call Processing of the TAPI Sampler cccccssccceeecseseeceeeeceeeeseeeeseeeeeses 44 3 Checking Call Processing Messages through the Message Viewer Tool 47 Table of Contents CHAPTER S irpan cermin patna se naive sn mase ean seodn Gi EENEN Nose REES 49 TAPI PUNCUOIS ccssar A EEE AEA EEEE AERIENE REAREA 49 1 Relationship Between the TAPI and TSPI ccccccccccceeeeceeeeeeeeseeeseeeeaeeeseeeseeeeaees 49 2 PST Or ve TAPI FUNCIONS crisper E 51 3 Feature List of
24. the lines to be used e dwAddressID 0 e hCall Not used e lpParams Enters the command strings as shown below Value Byte DC S 3 Bytes 1 Byte Option 1 Byte 0 Unlock 2 Lock All Phone Password Up to 4 bytes e DwsSize Buffer length Null value included 55 3 2 Vacant Station Message The Vacant Station Message enables the phone to display a vacant message on the LED of the caller s extension phone when a user sets the vacant message to the user s phone before he or she is away from the phone Number of Vacant Messages The number of vacant messages that can be set to the system depends on the NOTE Samsung key telephone systems Home Page Table of Contents Enter the syntax below to call the lineDevSpecific function when the Vacant Station Message is used in the TAPI application LONG lineDevSpecific HLINE hbLine DWORD dwAddressID LPVOID lpParams DWORD dwSize HCALL hCall Input Parameter Values e hline Processes the lines to be used e dwAddressID 0 e hCall Not used e lpParams Enters the command strings as shown below e DwSize Buffer length Null value included Value D C S 3 Bytes V 1 Byte Message number Hexa value 1 Byte 0 Clears a message 1 20 Number of the messages 56 Byte Table of Contents 3 3 Follow Me The Follow Me function enables call forwarding so that the user can answer a call even if the user is away from the
25. way is that the device of the PBX is initialized along with the device of the OpenTSP driver The two ways of initialization can be requested by the application at a right time if needed When Only the Device of the OpenTSP Driver is initialized e htLine Processes the lines to be used e dwAddressID 0 e hCall Not used e lpParams Enters the command strings as shown below e DwSize Buffer length Null value included Value Byte D C S 3 Bytes R 1 Byte Optional Value 0 1 1 Byte 0 Deletes all the calls located on the line 1 Deletes the disconnected calls 66 Table of Contents When the Device of the PBX is initialized as Well e htLine Processes the lines to be used e dwAddressID 0 e hCall Not used e lpParams Enters the command strings as shown below e DwsSize Buffer length Null value included Value Byte D C S 3 Bytes xX 1 Byte Optional Value 1 Byte 0 Reads the information on the current line status Not used 1 Initializes the current line status 67 Table of Contents CHAPTER 6 Call Processing Flow This chapter describes the life cycle of the TAPI the call processing events of the OpenTSP driver and call processing procedures 1 Life Cycle of the TAPI The knowledge of the TAPI life cycle shown below is needed to use the TAPI based application to process calls linelnitialize ar En e EOE aucluial secs Seas nse deddes
26. 000101 ef dw TotalSize 0 00000185 dwMNeededSize 0 00000154 dwlsedSize 0 00000154 hLine 000010044 dwLineDeviecelD 0 00000005 dwAddressID 0 00000000 dw Trunk Osffttftff 13 CallediD 205 Connected ID 203 LINEC ALLS TATE_IDLE received on Ox00010 lef IDLE Call Handle Os000101ef deallocated LINEC ALLS TATE_IDLE received on Ox00010289 IDLE Call Handle 000010289 deallocated Figure 6 10 Call Status Messages for Consult Transfer of Extension 201 Extension 202 10 59 41 LINECALLS TATE_CONNECTED received on Ox00010212 10 59 41 LINECALLINFO on Ox00010212 received 10 59 41 LINECALLINFO 0200010212 dw Totalsize 02000001a8 dwhleededSize 0 0000015c dwlsedSize 0 000001 Sc hLine 0 00010055 dwLineDeviecelD 0 00000006 dwAddressiO 0 00000000 dw Trunk 0xtitii 1 CallerlD 201 CalledID 20 Connected D 201 10 59 49 LINECALLSTATE CONMECTED received on 000010212 10 59 49 LINECALLINFO on 000010212 received 10 59 49 LINECALLINFO 000010212 dw TotalSize 0x 00000146 dw eeded ize 0s0000016c dwllsedSize 0x0000016c hLine O0 00010053 dwLineDeviecelD 0 00000006 dwAddresslD 000000000 dw Trunk Osttttftf 13 Callerlb 201 CalledID 20 Connected D 205 RedirectionID 205 RedirectinglO 201 Figure 6 11 Call Status Messages for Consult Transfer of Extension 202 T Extension 203 10 59 44 10 59 44 10 59 44 10 59 46 10 59 46 10 59 46 10 59 45 10 59 45 UNECALLSTATE_OFFERING received on 000010234 LINECALLINFO on 000010234 received LINECALL
27. 1a6 dwheededSize 0 0000 hLine O 000103dd dwLineDeviecelO 000000005 dw Trunk Osttttttft 1 CallediD 2002 Connected D 2002 samsung API Sampler Figure 4 20 TAPI Message Display Screen 45 Table of Contents Receiving Calls Calls may also be received through the TAPI Sampler program A call is being sent from extension 2002 to extension 2001 in the figure below The Call Status Window displays information on the call such as time of event call status and destination number and the Message Status Window displays detail information on the TAPI messages sent to the TAPI Sampler by the TAPI service If a call arrives right click the information of the call on the Call Status Window to display the Context Menu as shown below Select Answer to answer the call EBs samsung TAPI Sampler 200 E x Mly Extention 200 Destination B 002 Dial Calllnfo Answer Drop Deallocate 14 40 50 DLE Call Handle O0x00010544 deallocated 14 40 52 LINECALLSTATE_OFFERING received 14 40 52 LINECALLINFO on Ox 00010522 received 14 40 52 LINECALLINFO 000010322 dwTotalSize 0 000001a8 dw eededSize 00000 hLine 04000103dd dwLineDeviecelD 000000005 dw Trunk Os t 1 CallerlD 2003 CalledID 2001 Connected D 2003 Figure 4 21 Context Menu Display Screen The Context Menu is described as follows e CallInfo Displays Detail information on the call on the Message Status Window This feature displays the
28. 2 OpenTSP Driver Installation Procedure for detailed NOTE descriptions of each field 26 Table of Contents Removing the OpenTSP Driver Remove the OpenTSP driver installed on the system when the driver is no longer needed or when removing a previous version to install a new version of the driver Closing all TAPI compatible programs All TAPI compatible application programs that are currently running must be closed CAUTION before removing the OpenTSP driver If the OpenTSP driver is being operated by a TAPI compatible application program error may occur during the uninstallation process The procedure for removing the OpenTSP driver is as follows 1 Select Start gt Settings gt Control Panel Add Delete Program to display the screen below Then select the Samsung Telephony Service Provider and click the Change Remove button loxi E ao Currently installed programs Sort by Name a A eer en Change or Remove ip Activex Control Size 920KE I Purtse E3 Adobe Acrobat 6 0 Professional Size 354MB am ie EP Size 754KB ip Java 2 Runtime Environment SE 1 4 0_03 Size 1 73MB Add New i e ip Java 2 SDK SE v1 4 0 _03 Size 1 89MB Java Web Start Size 1 94MB ay Microsoft Office 2000 Professional Size 185M6 z a H m Z js m Ondak E addinemove j OfficeSery OpentTSP Driver Size J04KB Vt i Mi d Os Components ne To change this program or remove it From your Change Remove
29. Capture Options Computer Help CA T Qi s RM Pao oF Figure 4 23 DBGView exe Screen 47 Table of Contents Setting the message display level Messages on the operation status of the OpenTSP driver are displayed on the Message viewer only when the Trace Type the OpenTSP driver s environment setup item is set to Level 1 or Level 2 and are not displayed when the Trace Type is set to None Verifying the operation of the OpenTSP driver Through the Message Viewer users can view detail messages related to the operation of the OpenTSP driver and can also save the displayed messages as files if necessary 48 Table of Contents CHAPTER 5 TAPI Functions This chapter describes the features of the standard TAPI functions and Samsung Specific functions that the OpenTSP driver supports 1 Relationship Between the TAPI and TSPI When the TAPI compatible application requests a TAPI function the Telephony Service Provider provides the TSPI functions related to the TAPI function That is the TAPI compatible application receives the TAPI service offered by the key telephone system through the Telephony Service Provider The procedure for exchanging messages between the TAPI and TSPI is shown in the figure below Key Telephone System TAPI Compatible Application CTI Service Telephony Service Operating System Provider Figure 5 1 Flow of Messages Between the TAPI and TSPI Each step shown
30. F THE POSSIBILITY OF SUCH DAMAGES THE TOTAL MAXIMUM LIABILITY OF SAMSUNG FOR BREACH OF WARRANTY SHALL BE LIMITED TO A REFUND OF THE COST OF THE DEFECTIVE PRODUCT No Dealer and no person other than an officer of SAMSUNG TELECOMMUNICATIONS AMERICA L P may extend or modify this warranty and no modification or extension of this warranty shall be effective unless in writing signed by the authorized officer of SAMSUNG TELECOMMUNICATIONS AMERICA L P SAMSUNG DIGITa l0 everyone s invited
31. FTWARE and the recipient agrees to the terms of this agreement by notifying in writing to authorized Samsung VAR outfit and or dealer in which the SOFTWARE was purchased And including all prior versions of SOFTWARE if the SOFTWARE is an upgrade h Termination Without prejudice to any other rights Samsung may terminate this agreement if you fail to comply with the terms and condition of this agreement In such event you must destroy all copies of the SOFTWARE and all of its component parts 2 UPGRADES amp COPYRIGHT a Upgrade If the SOFTWARE is an upgrade of a component of a package of software programs that you licensed as a single product the SOFTWARE may be used and transferred only as an part of that single product package and may not be separated for use on more than one computer b Copyright The SOFTWARE is owned by Samsung or its suppliers and protected by copyright laws and international treaty provisions Therefore you must treat the SOFWARE like any other copyrighted material except that you may install SAMSUNG DIGIT everyone s invited the SOFTWARE on a single computer provided you keep the original solely for backup or archival purpose You may not copy the printed materials accompanying the SOFTWARE LIMITED WARRANTY Samsung warrants that a the SOFTWARE will perform substantially in accordance with the accompanying written materials for a period of ninety 90 days from the date of receipt and b any Sams
32. INFO 000010234 dw Totalsize 02000001a8 dwhleededSize 0 0000015e dwllsedSize 0 000001 5c hLine 04 00010278 dwLineDeviecelD 0x 00000007 dwAddresslD 0 00000000 dw Trunk Os ttt 1 CallerlD 201 CallediD 203 Connected D 01 LINEC ALLS TATE_CONNECTED received on 000010234 LINECALLINFO on 000010234 received LINECALLINFO 000010234 dw Totalsize 0s 00000138 dwhleededSize 0 0000015 dwllsedSize 0 000001 5c hLine 04 00010278 dwLineDeviecelD 02 00000007 dwAddresslD 0 00000000 dw Trunk Os ttt 13 CallerllD 201 CallediD 205 Connected D 701 LINEC ALLINFO on 000010234 received LINECALLINFO 000010234 dw TotalSize 02000001a8 dwhleededSize 0 0000016c dwllsedSize 0 000001 6c HLine Ox 000102 8 dwLineDeviecelD 02 00000007 dwAddresslD 0 00000000 dw Trunk Os ttf 1 CallerlD 202 CallediD 203 Connected D 0e RedirectionID 205 RedirectinglO 201 Figure 6 12 Call Status Messages for Consult Transfer of Extension 203 Type of Call Processing Messages in the TAPI Sampler Program The messages of call progress such as Blind Transfer Conference PickUp and NOTE Redirect can be checked from the TAPI Sampler program Table of Contents 78 ABBREVIATION Table of Contents A API ASP CD CTI DCS DND DNIS DTMF HTTP OHVA PIDs ROM Application Program Interface Abstract Service Primitive Compact Disk Computer Telephony Interface Digital Cellular System Do Not Disturb Dialed Number Identifi
33. My Computer h Figure 2 7 Selecting Administrative Tools 13 Table of Contents 3 Select Service from the Administrative Tools window 3J Administrative Tools 0 x File Edit View Favorites Tools Help Back gt fy Qsearch yrolders History GS cK a E Ea Address E 5 Administrative Tools gt Go o an u Data Sources ODBC op Local Security Policy ofa Server Extensions Administrator Administrative Tools ate i Component Services au Event Viewer 5 Performance Computer Management Brne Services Manager M Personal Web Manager ail Telnet Server Administration Services Shortcut Starts and stop services Modified 1996 03 18 2 3 41 g Starts and stop services 1 30 KB My Computer Figure 2 8 Selecting Service 4 Check the Telephony service TAPI service status from the Service window below If the Telephony service is displayed as started as shown below the TAPI service is operating ie x a Services eee Services Local Sy Security Accounts Stores sec Started Automatic LocalSystem Sy Server Sa Simple Mail Transpo Sa Smart Card Sy Smart Card Helper Ky System Event Notifi Sy Task Scheduler Sa TCP IP NetBIOS Hel Telephony Sia Telnet S amp a Uninterruptible Pow Sa Utility Manager a Windows Installer Sa Windows Managem Sy Windows Managem Sy Window
34. Processes the lines to be used dwAddressID 0 hCall Not used DWORD dwAddressID lpParams Enters the command strings as shown below DwsSize Buffer length Null value included Value D C S Phone number for the OHVA 3 Bytes 1 Byte Up to 4 Bytes 63 Byte HCALE ACAI Table of Contents 3 10 Silent Monitoring The Silent Monitoring enables a caller to speak to the extension subscriber by interruption even while the subscriber is on the phone In the Samsung key telephone system the Silent Monitoring operates in Without Tone the monitored subscriber does not the monitoring sound Enter the syntax below to call the lineDevSpecific function when the Silent Monitoring is used in the TAPI application LONG lineDevSpecific HLINE hLine DWORD dwAddressID HCALL hCall LPVOID lpParams DWORD dwSize Input Parameter Values e hline Processes the lines to be used e dwAddressID 0 e hCall Not used e lpParams Enters the command strings as shown below e DwsSize Buffer length Null value included Value Byte D C S 3 Bytes B 1 Byte Phone number for silent monitoring Up to 4 Bytes 64 Table of Contents 3 11 Mute On Off The Mute On Off enables Mute Off or disables Mute On the other party to listen to a caller s voice while the caller is speaking to the other party or 1s on the Intrude or Silent Monitoring Although a caller sets the Mute On the ca
35. SIONS cc ge ise st tec cece ate ras eases a eee eeaaeeanscseee 2 Console Screen Output crasieecied ndacosscamsnciensbainssiucwsus sitisavemonedecdaceduceneestimenteeedmecieenbvnchamebinns 3 References saci ntsu acc tena teaateacsanice ate dnigansaseaaaeenasahede saaaeasedaaiasadnaatasaaseacoanedeiaaneasetacssaasesconaee 3 CHAPTER aes daa atedca detected decreas Er 4 1 introd cton to OpenT SP crenn a a a a a a books 4 2 ST Me WS AOS en E EEN 5 CHAPTER 2 saad cas cared E tee se veetweeenautenedeusteucateseceiteee 6 Opent SP Driver Installationer aaiae 6 1 Installation Environment and Conditions cccccccccccceccseeeceeeeseeeeeeeeseeeseeeeaseeseeesaees T Lt INsStalation ENVIronmMme Nesser EERE AETS T 1 2 Installation Conditions eee cecceececeeeeeeeceeeeseeeseeeseeeeeseeseeeseueeseeeseesaeesanes 8 1 3 Checking the Telephony ServiCe cccccccccseeeccseeceeseecseeceessseenseneesessenenees 13 2 OpenTSP Driver Installation Procedure cccceecceeccceeeeeeeeeeeeseeesaeesaeeeseeeeeeeeaeeees 16 3 Checking Installation Data ascent ts see eee tssee pasdtecie cos asine baceciacemne eee ware saceesteeeeaea 22 3 1 Checking the OpenTSP Driver Files ccccececseeeceseeceeseceeseceeseeeeeeseeeesees 22 3 2 Checking the OpenTSP Driver Registration ccccssceceeeeeeeeceeeeaeeeeaeeeenes 23 3 3 Changing the OpenTSP Driver Environment SettingS ccccccseceeeeeeeeeees 24 4 Removing
36. TSP is installed when OfficeServ Link is not operating Though the OpenTSP driver can be installed while the OfficeServ Link is not operating the CTI application program automatically attempts connection to the corresponding port after the installation Thus the Communication Parameter should be set to enable connection to the OfficeServ link before starting the CTI application program 20 Table of Contents 9 Upon successful installation of the OpenTSP driver the OpenTSP Setup Complete window appears Click the Finish button InstallShield Wizard a OfficeSery OpenT SP Setup Complete The InstallShield Wizard has successfully installed OfficeSery OpenTSP Driver Click Finish to exit the wizard Back Eancel Figure 2 18 Installation Complete 21 Table of Contents Checking Installation Data Checking the OpenTSP Driver Files During the installation of the OpenTSP driver the OpenTSP driver and utilities should have been copied to the folders below Location of the OpenTSP driver file The OpenTSP driver is copied to different folders depending on the OS e Windows NT Windows 2000 Winnt System32 sctsp32 tsp e Windows XP Windows system32 sctsp32 tsp e Windows 98 Me windows system sctsp32 tsp Location of the OpenTSP driver utility files The OpenTSP utility files should have been copied to the folder below if the default location in Figure 2 15 Selecting Installation Folder was not c
37. Table of Contents Enterprise IP Solutions OfficeServ Open User Manual July 2004 Every effort has been made to eliminate errors and ambiguities in the information contained in this guide Any questions concerning information presented here should be directed to SAMSUNG TELECOMMUNICATIONS AMERICA 1301 E Lookout Dr Richardson TX 75082 telephone 972 761 7300 SAMSUNG TELECOMMUNICATIONS AMERICA disclaims all liabilities for damages arising from the erroneous interpretation or use of information presented in this guide Home Page Table of Contents Samsung Telecommunications Publication Information SAMSUNG TELECOMMUNICATIONS AMERICA reserves the right without prior notice to revise information in this publication for any reason SAMSUNG TELECOMMUNICATIONS AMERICA also reserves the right without prior notice to make changes in design or components of equipment as engineering and manufacturing may warrant Copyright 2004 Samsung Telecommunications America All rights reserved No part of this manual may be reproduced in any form or by any means graphic electronic or mechanical including recording taping photocopying or information retrieval systems without express written permission of the publisher of this material PRINTED IN USA 07 04 Table of Contents Table of Contents FO SO eaaa EA EE A 1 Document Content and OrganiZatiOn ccccccseceeseeeeseeeeseeeeceeeeneeeeseeeeseueesaeeesaeeeeees 1 I
38. action view gt am ec 2 e n w Tree Name i Description Status Startup 14 Services Local 84 Print Spooler Loads files Started Automati Sa Protected Storage Provides pr Started Automati SRA QoS RSVP Provides n Remote Access 4uto Connection Manager Sa Remote Access Connection Manager Creates 4 Ra Remote Procedure Call RPC Provides th Started SBa Remote Procedure Call RPC Locator Manages t Rs Remote Registry Service Allows rem Started SBa Removable Storage Manages r Started Sa Routing and Remote Access Offers rout Ra Runds Service Enables st Started Rs Security Accounts Manager Stores sec Started Ra Server Provides R Started Rs Simple Mail Transport Protocol SMTP Transports Started Sa Smart Card Manages 4 Sa Smart Card Helper Provides 5 Sy System Event Notification Tracks syst Started Sa Task Scheduler Enables a Started Sa TCP IP NetBIOS Helper Service Enables su Started Sa Telephony Provides T Started Figure 2 10 Telephony Service Manual Manual Manual Automati Manual Automati Automati Disabled Automati Automati Automati Automati Manual Manual Automati Automati Automati Manual Y b Cases where the OpenTSP Driver is not Properly Loaded or Unloaded If the two services above are operated Manually the two services will act as a single CAUTION module of the telephony service If the two
39. ation of the applicable warranty period The obligation of Samsung under this warranty is at the sole option of Samsung 1 the repair or replacement with new or refurbished parts of the defective or missing parts that are causing the malfunction and which are determined to be the defective by Samsung and the return shipment of such parts to the Dealer Dealer or User shall be responsible to pay for shipment of the defective parts to Samsung and for all the expenses connected with their removal and reinstallation or 2 in lieu of repair or replacement Samsung may refund the price charged by Samsung to its Dealer for such parts as are determined by Samsung to be defective and which are returned to Samsung through an authorized Dealer within the warranty period and no later than 30 days after such malfunction whichever occurs first To obtain service under this warranty 1 USERS must provide written notice of the malfunction to an authorized Samsung Dealer within the warranty period and not later than 30 days after the date of the malfunction whichever occurs first If the USER is unable to identify an authorized Samsung Dealer USER must provide written notice of the malfunction including proof of the date of purchase of the equipment and the serial number of the malfunctioning Product to Samsung at its corporate offices Upon receipt of such notice and determination by Samsung that User Is eligible for Warranty service Samsung will provide
40. cation Service Dual Tone Multi Frequency Hypertext Transfer Protocol Identification internet Digital Cellular System Internet Protocol Off hook Voice Announce Process Identifications Read Only Memory 79 TAPI TCP TSP TSPI Telephony Application Programming Interface Transmission Control Protocol Telephony Service Provider Telephony Service Provider Interface 80 Table of Contents KEY SYSTEMS LI MI TED WARRANTY SAMSUNG TELECOMMUNICATIONS AMERICA L P Samsung warrants to its authorized Dealers and to the Original retail purchaser Users of a Samsung product for a period of 24 months from the date of shipment of the Product from Samsung s facility that the Product except for lamps fuses and other consumable items will be free from defects in material and workmanship Repaired or replaced materials shall be warranted for the balance of the warranty remaining on the original equipment or 90 days from date of shipment from Samsung s facility whichever is longer This warranty is for the benefit of and shall apply only to authorized Dealers and to Users This warranty will not apply if the defect arises out of accident neglect alteration or misuse failure of electric power air conditioning humidity control causes other than ordinary use or causes beyond Samsung s control All warranty claims shall be waived unless reported in writing to Samsung or its authorized Dealer prior to the expir
41. e SOFTWARE in use as you have Licenses b Electronic Documents Solely with respect to electronic documents included with the SOFTWARE you may make an unlimited number of the copies provided that such copies shall be used only for internal purpose and you shall not publish or distribute such to any third party without Samsung Electronics Co LTD written and expressed consent c Limitation on Reverse Engineering Decompilation Disassembly You shall not reverse engineer decompile or disassemble the SOFTWARE except to the extent that this restriction is expressly prohibited applicable law d Separation of Components The SOFTWARE is licensed as a single product Its component parts may not be separated for use on more than one computer e Rental You may not rent lease and or lend the licensed SOFTWARE f Support Services Samsung may provide you with support services related to the SOFTWARE according to Samsung policies and programs and in for the country in which the SOFTWARE was purchased With respect to technical information you provide to Samsung as part of the support services Samsung may use such information for its business purpose including for product support and development Samsung will not utilize such technical information in a form that personally identifies you g SOFTWARE Transfer You may permanently transfer all of your rights according to this agreement provided you retain no copies you transfer all of the SO
42. e entered by the operator on the console screen References OfficeServ Operator Manual The OfficeServ Operator Manual describes the main features installation procedure service settings and user guide of the OfficeServ Operator an application program for telephony communication OfficeServ Call Manual The OfficeServ Call Manual describes the main features installation procedure service settings and user guide of the OfficeServ Call an application program for telephony communication Table of Contents CHAPTER 1 1 Introduction to OpenTSP The OpenTSP Telephony Service Provider Driver 3 x referred to as OpenTSP hereinafter interfaces with the Samsung OfficeServ telephone system through the TCP IP system based on the Microsoft TAPI 2 x TAPI 3 x specifications and enables call control and call processing of the Telephony Application Programming Interface TAPI service through the TSPI The OpenTSP driver is installed on a PC using the Windows O S The Microsoft TAPI consists of the three modules shown below Window based PC Telephony Application TAPI Service Telephony st l Phone System ervice l PBX Key Telephone System etc TAPI Configuration Diagram Table of Contents Modules in Figure 1 1 are described below Telephony Application Supplied by the application vendor the Telephony Application provides features such as call processing to the users through TAPI an API provided by the M
43. eglect alteration or misuse failure of electric power air conditioning humidity control causes other than ordinary use or causes beyond Samsung s control All warranty claims shall be waived unless reported in writing to Samsung or its authorized Dealer prior to the expiration of the applicable warranty period The obligation of Samsung under this warranty is at the sole option of Samsung 1 the repair or replacement with new or refurbished parts of the defective or missing parts that are causing the malfunction and which are determined to be the defective by Samsung and the return shipment of such parts to the Dealer Dealer or User shall be responsible to pay for shipment of the defective parts to Samsung and for all the expenses connected with their removal and reinstallation or 2 in lieu of repair or replacement Samsung may refund the price charged by Samsung to its Dealer for such parts as are determined by Samsung to be defective and which are returned to Samsung through an authorized Dealer within the warranty period and no later than 30 days after such malfunction whichever occurs first To obtain service under this warranty 1 USERS must provide written notice of the malfunction to an authorized Samsung Dealer within the warranty period and not later than 30 days after the date of the malfunction whichever occurs first If the USER is unable to identify an authorized Samsung Dealer USER must provide written notice of the mal
44. ent Settings 4 The OpenTSP driver must be restarted to apply the changes Thus close all CTI application programs and restart the OpenTSP driver 25 Table of Contents Using the OpenTSP Config Tool program The OpenTSP Config Tool program which allows the user to change the configuration of the OpenTSP driver is installed in the OpenTSP driver installation folder Through this program users can easily check and change the settings The procedure for changing the OpenTSP driver environment through the OpenTSP Config Tool program is as follows 1 Execute the OpenTSP Config Tool under the Start gt Programs OfficeServ g OpenTSP Driver The screen below is displayed OfficeServ OpenTSP Driver J x Before changing each configuration value vou have to stop all tapi applications at First Figure 2 24 Closing TAPI Compatible Program 2 The message above informs the user that all TAPI compatible programs need to be closed before changing the environment settings Close all TAPI compatible programs that are currently operating and click the OK button 3 Enter the fields in the window shown below and click the OK button OpenTsSP Configuration Tool l x Connect to Server OfficeServ Link Server IP Address 165 213 88 88 Server Port Mo 00g Trace Type i None C Level Level 2 Ok Figure 2 25 OpenTSP ConfigTool OpenTSP Configuration Tool Refer to item 9 of the
45. er LineBlindTransfer LineClose LineCompleteCall LineComplete Transfer LineDeallocateCall LineDevSpecific LineDial LineDrop LineForward LineGenerateDigits LineGetAddressCaps LineGetAddressID LineGetAddressStatus LineGetCalllnfo LineGetCallStatus LineGetDevCaps LineGetDevConfig LineGetID LineGetLineDevStatus LineHold lineMakeCall lineNegotiateExtVersion lineOpen linePark linePickup Supported Remarks or Not Consultation Call Off Hook Consultation Call Transfer Camp on Msg Waiting OHVA Callback Transfer O Idle Call Remove Refer to 5 3 List of the OpenTSP Driver Expansion Functions Make Call On Hook Set Reset Forward DND Send DTMF Digits Hold Make Call Direct Park OK UnDirect Park System Hold OK O Direct Pickup Group Pickup S Table of Contents Supported TAPI Functions of Microsoft Remarks or Not Consultation Call Redirect Direct Park OK UnDirect Park System Hold OK linePrepareAdd ToConference lineRedirect O linePark lineRemoveFromConference 0 Consultation Call lineSetAppSpecific e LineSetCallData Lo lineSetCallParams 0 lineSetMediaMode 0 lineSetStatusMessages 0 lineSetupConference Lo Consultation Call lineSetup Transfer re Consultation Call lineSwapHold Consultation Call for T Hold And Hold Retrieve for a S Hold lineUnhold 0 Consultation Call for T Hold and Retrieve for S Hold lineUnpark O System Hold Retrieval
46. extension Enter the syntax below to call the lineDevSpecific function when the System Hold Retrieval is used in the TAPI application LONG lineDevSpecific HLINE hbLine DWORD dwAddressID HCALL hCall LPVOID lpParams DWORD dwSize Table of Contents Input Parameter Values e htLine Processes the lines to be used e dwAddressID 0 e hCall Not used e lpParams Enters the command strings as shown below e DwsSize Buffer length Null value included Value Byte D C S 3 Bytes S 1 Byte Number of the calls on hold Up to 4 Bytes 60 3 7 Table of Contents Home Page Clear Message Waiting The Clear Message Waiting disables the message waiting LED to be displayed when a message is left in the user s phone Checking if a message has been left In the Samsung key telephone system the LED on the message button of the NOTE connected phone turns on to notify the other party that a message has been left when a caller leaves the message because the caller cannot speak to the other party Enter the syntax below to call the lineDevSpecific function when the Clear Message Waiting is used in the TAPI application LONG lineDevSpecific HLINE hLine DWORD dwAddressID HCALL hCall LPVOID lpParams DWORD dwSize Input Parameter Values e htLine Processes the lines to be used e dwAddressID 0 e hCall Not used e l pParams Enters the command strings as shown below e DwsSize Buffer len
47. found while pertorming the needed file operations To leave this file as it is on your system click the Ignore button to retry the file operation click Retry orto perform the operation when your system is rebooted click Aeboot Don t display this message again Reboot tancre Retry he Cancel Figure 2 29 Confirm File Deletion 28 5 Files related to the OpenTSP driver are removed from the system Click the Finish button on the screen below InstallShield Wizard Maintenance Complete InstallShield Wizard has finished performing maintenance operations on OfficeSery OpenT SP Driver lt Back Cancel Figure 2 30 Deletion Complete 29 Table of Contents Table of Contents CHAPTER 3 OpenTSP Window Description This chapter provides description on the screens toolbars and buttons of the various tools offered by the OpenTSP Tools provided by the OpenTSP are displayed as five submenus under the Programs gt OfficeServ OpenTSP Driver OpenTSP Contig Tool 5 Scavenger Tool s Tapi Sampler Tool Figure 3 1 OpenTSP Submenu Tools provided by the OpenTSP are as follows e OpenTSP Config Tool e Scavenger Tool e TAPI Sampler 30 Table of Contents 1 OpenTSP Config Tool The OpenTSP Config Tool allows the user to set the network information Trace Type and the Licence Key of the OfficeServ Link to which the TSP connects OpenTSP Configuration Tool x Con
48. function including proof of the date of purchase of the equipment and the serial number of the malfunctioning Product to Samsung at its corporate offices Upon receipt of such notice and determination by Samsung that User is eligible for Warranty service Samsung will provide the USER with the name of an authorized Samsung Dealer to contact for warranty service DEALERS must provide written notice of malfunction to Samsung no later than the expiration of the warranty period 30 days after the date the Dealer becomes aware of the malfunction whichever comes first For purposes of this Warranty the issuance by Samsung of a Return Material Authorization RMA number by telephone to an authorized Dealer shall be deemed to be written notice from the Dealer with respect to the material returned under that RMA SAMSUNG MAKES NO OTHER WARRANTIES EXPRESS OR IMPLIED AND SPECIALLY DISCLAIMS ANY IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE THESE WARRANTIES ARE DEALER S AND USER S SOLE REMEDIES AND IN LIEU OF ALL OBLIGATIONS OR LIABILITIES ON THE PART OF SAMSUNG FOR DAMAGES INCLUDING BUT NOT LIMITED TO SPECIAL INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR IN CONNECTION WITH THE USE OF THE PRODUCTS OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE DATA OR PROFITS ARISING OUT OF OR IN CONNECTION WITH THE PERFORMANCE OF THE PRODUCTS WHETHER IN A CONTRACT OR TORT ACTION INCLUDING NEGLIGENCE EVEN IF SAMSUNG HAS BEEN ADVISED O
49. gdcharveus N E ST Cycle LineGetDevGap s4stecuexcinnncsmage l Cycle2 e Cycle3 ee eee lineShutdown ail eeerreere aoe nreetrne tere erenrnrrerreernenrener eee mr rere Figure 6 1 Life Cycle of the TAPI Cycles 1 to 3 shown in Figure 6 1 are described below Cycle 1 The Phone Dialer and call center makes connect answers a call according to the steps of Cycle 1 as shown in Figure 6 1 Each application can use the lineInitialize function and then other TAPI functions 68 Table of Contents Also the lineShutdown function should be called to prevent the TAPI compatible application from using the TAPI function Each TAPI compatible application can call the lineInitialize function to check the number of the devices available by the TAPI service and register the processing modules for call processing events generated from each device Also the TAPI service loads the unloaded Telephony Service Provider TSP on the TAPI service by executing the lineInitialize function to change each TSP driver to an operating state Different TAPI compatible applications can simultaneously call the lineInitalize function The information registered during each calling is automatically classified and sorted by the TAPI service The lineShutdown function is used when each TAPI compatible application does not use the TAPI functions any more If this function 1s called the TAPI service will delete the information registered dur
50. gth Null value included Value Byte D C S 3 Bytes M 1 Byte Number of the devices where a message is left Up to 4 Bytes 61 3 8 Home Page Clear Call Back The Call Back enables the user to make a call reservation when the other party is on the phone or does not answer Then a caller s phone rings automatically when the other party s phone becomes available The Clear Call Back disables the Call Back Enter the syntax below to call the lineDevSpecific function when the Call Back is used in the TAPI application LONG lineDevSpecific HLINE hbLine DWORD dwAddressID HCALL hCall LPVOID lpParams DWORD dwSize Input Parameter Values e htLine Processes the lines to be used e dwAddressID 0 e hCall Not used e lpParams Enters the command strings as shown below e DwsSize Buffer length Null value included Value Byte D C S 3 Bytes C 1 Byte Phone number to which a reservation has been made Up to 4 Bytes 62 Table of Contents 3 9 OHVA Table of Contents The Off Hook Voice Announcement OHVA enables a caller to leave a message in the other party s phone when the other party is on the phone This is useful when the caller needs to leave a message urgently Enter the syntax below to call the lineDevSpecific function when the OHVA is used in the TAPI application Input Parameter Values LONG lineDevSpecific HLINE hlLine LPVOID lpParams DWORD dwSize hLine
51. hanged e Program Files Samsung Electronics Samsung Telephony Service Provider Utilities for OpenTSP driver The utilities required for installing operating the OpenTSP driver are as follows e Scavenger exe Program for removing Mismatch Call Handle e TAPISampler exe Test program for simple dialing receiving disconnecting calls and for tracking call status data e OpenTSP Config Tool Communication environment setup program for OpenTSP driver 22 Home Page Table of Contents As shown below the utility programs are located at Start gt Programs OfficeServ OpenTSP Driver for convenient use OpenTSP Contig Tool scavenger Tool Tapi Sampler Tool Figure 2 19 OpenTSP Utility Program 3 2 Checking the OpenTSP Driver Registration The registration of the OpenTSP driver file which is registered as the TAPI driver of the Microsoft Windows OS can be verified as follows Check for the Samsung SCTSP32 TAPI2 x Compatible Telephony Service Provider on the Advanced tab of the Start gt Control Panel gt Phone and Modem Options Phone And Modem Options ajx Dialing Rules Modems Advanced Microsoft H 323 TAP Serice Provider Microsoft Multicast Conference TAPI Service Provider Unimodem 5 Service Provider Add Remove Configure Figure 2 20 Advanced Tab of Phone and Modem Options 23 3 3 g Table of Contents Changing the OpenTSP Driver Environment Sett
52. icrosoft TAPI Service Telephony applications include the dialer program embedded in the Windows OS and Outlook the Contact Manager program of Microsoft TAPI Service As a basic module of the Microsoft Windows OS the TAPI Service uses the Telephony Service Provider installed on a PC upon the request of the application program Telephony Service Provider TSP Provided by the switch vendor the TSP 1s a service provider that communicates with the Microsoft TAPI The TSP is executed when the application program requests the TAPI feature OpenTSP Features The Samsung OpenTSP driver is a Microsoft Windows compatible TSP the Telephony Application program connects to the TAPI Service through a Computer telephony interface to use the features of the Samsung key telephone system The OpenTSP referrers to the appropriate Microsoft TAPI specifications and supports the features introduced in Section 5 2 TAPI Functions of this manual The following system specific features that are supplied only by the OpenTSP driver are described in detail in Section 5 3 OpenTSP Driver Extended Function Feature List e Station Lock e Vacant Station Message e Follow me e Make new trunk call e Page e System hold retrieval e Clear Message Waiting e Clear Call back e OHVA e Silent Monitoring e Mute on off e Line Reset Function Table of Contents CHAPTER 2 OpenTSP Driver Installation This chapter describes the en
53. in Figure 5 1 is described below The TAPI compatible application calls a TSPI function to the TAPI service of the key telephone system in order to process calls The TAPI compatible application calls a TSPI function to the Telephony Service Provider The Telephony Service Provider forwards the event requested by the TAPI compatible application to the TAPI service of the key telephone system The TAPI service of the key telephone system processes the event and notifies the Telephony Service Provider of the results The Telephony Service Provider forwards the results received from the CTI service of the key telephone system to the TAPI compatible application F YO 49 Table of Contents Example of Internal Calling Using the Phone Dialer Figure 5 2 shows the procedures for using the phone dialer offered by the PC to make a call from Extension 2001 to Extension 2002 aa Aa A vg p y CUS A s d _ E gt Key Telephone System OfficeServ Link OpenTSP Driver un CTI Service Figure 5 2 Example of Internal Calling in the Phone Dialer The commands and events to be sent or received during internal calling are processed as described below lineMakeCall The Phone Dialer uses the lineMakeCall TAPI function to press Extension 2002 for making a call TSPI lineMakeCall The TAPI service calls the TSPI lineMakeCall function to the OpenTSP driver after being asked to process the TAPI function
54. ing the lineInitialize process in order not to report the call status events generated from each device Also if the lineShutdown function is called when any application does not use the TAPI service the TAPI service will upload all the loaded TSPs Cycle 2 Call the lineInitialize function to find out the number of devices available in the TAPI service of the system Then the TAPI compatible application calls the lineOpen function to make necessary line devices available to each application The application which has got permissions for the line after executing the lineOpen function can receive information on call processing in each line device and use functions on calls The TAPI compatible application calls the lineClose function when the application disables the line devices If the lineClose function is called the call processing events generated from the line devices will not be reported and the functions for call processing cannot be used for the line devices Cycle 3 The TAPI compatible application that has permissions for each line device through the lineOpen function can use call processing functions for the line Also since the TAPI compatible application receives the call processing events for the status of all calls it can be defined to perform necessary operations according to the processing rule of the application The call processing functions are available only if call objects exist in the line device
55. ings The user may change the environment settings of the OpenTSP driver The driver environment can be changed either through the Phone and Modem Options screen or through the OpenTSP Config Tool program Changing from the Phone and Modem Options screen 1 Click the Configure button from the Start gt Control Panel gt Phone and Modem Options gt Advanced screen Phone 4nd Modem Options E x Dialing Rules Modems Advanced The following telephony providers are installed on this computer Providers Microsoft H 323 TAPI Service Provider Microsoft Multicast Conference TAPI Service Provider HOI Proxy TAP Service Provider Samsung OfficeSery Open SF Orver for Keyphone Seres TAPI Kernel Mode Service Provider Unmodem 5 Service Provider Add Remove Configure Figure 2 21 Selecting Configure 24 Home Page Table of Contents 2 Onthe OpenTSP environment configuration screen below change the settings and click the OK button Communication Parameters Connect to Server OfficeSery Link Server IP Address 165 213 58 58 Server Port No e000 Trace Type None C Levelli Level 2 Figure 2 22 Communication Parameters 3 The message below appears to confirm the changes Samsung SCTSP32 for DCS Keyphone Series l x i You need to close and restart all TAPI applications For changes to take effect Figure 2 23 Confirming Changes in Environm
56. ller called party and forwarded party will receive the call status events as shown in the figure below Caller Side 201 TSP Switch Side Called Side 202 Target Side 202 Connect Connect State Call 1 Transfer Command wauaehyneupateinsaendevenlenn sah eateats gt Hold On State Gen Call 1 Dial tone Even Call 1 with 201 Dial tone State a caka Dial to Destination Create Idle State New Call Call 1 Offering Event a Offering State Answer Command Call 1 with 201 Ringback State Connected Event Connect State Call 2 Connect State Complete Transfer Command eae Transfered Event gt Completed Event Connect State ns aes Call 1 with 203 Call 1 with 202 Idle State Call 1 Idle State Call 1 Figure 6 9 Flow Chart of Call Forwarding Status Table of Contents The call status messages for the consult transfer are displayed on the TAPI Sampler program as shown below Extension 201 LINEC ALLS TS TE_ONHOLDPENDTAANSFER received on 000010289 LINECALLS TATE_DIALTONE received on Ox000101ef LINEC ALLS TATE_AINGBACE received on Ox00010 lef LIN EC ALLINFO on 000010 et received LINEC ALLINFO 0000101 ef dw TotalSize 0s000001a5 dwheededSize 0x00000154 dwllsedSize 0x00000154 hLine 0 00010044 dwLineDeviecelD 0x00000005 dwAddressID 0 00000000 dw Trunk 0x tit 1 CallediD 203 ConnectediD 203 LINECALLSTATE CONNECTED received on O 000101ef LINECALLINFO on Os00010 ef received LINECALLINFO 0
57. ller can listen to the other party s voice Enter the syntax below to call the lineDevSpecific function when the Mute On Off is used in the TAPI application LONG lineDevSpecific HLINE hLine DWORD dwAddressID HCALL hCall LPVOID lpParams DWORD dwSize Input Parameter Values e htLine Processes the lines to be used e dwAddressID 0 e hCall Not used e lpParams Enters the command strings as shown below e DwsSize Buffer length Null value included Value Byte D C S 3 Bytes m 1 Byte Phone number for Mute On Off Up to 4 Bytes 65 Table of Contents 3 12 Line Reset The Line Reset enables the user to initialize the device managed by the OpenTSP driver forcibly when the call status of the device is different from that of the Samsung key telephone system The status of calls in each device of the OpenTSP driver should be the same as that of calls in the Samsung telephone system However the device status of the PBX might be different from the call status of the device managed by the OpenTSP driver due to an error during the operation of the OpenTSP driver In this case the request of initializing the device in the application can be made The initialization can be made in the two ways described below The first way is that only the device managed by the OpenTSP driver is initialized That is only the device of the OpenTSP driver is initialized irrespective of the device status of the PBX The second
58. n Ox000102ce received LINECALLINFO 0O 000102cc dw TotalSize 0 000001a8 dwheededSize 020000015c dwUsedSize 0 000001 Sc hLine 0 00010311 dwLlineDeviecelO 0 00000006 dwAddresslO 0 00000000 dw Trunk Ostttttitt 13 CallerlD 201 CallediD 20 ConnectedID 201 LINEC ALLS TATE_CONNECTED received LINEC ALLINFO on Ox000102cc received LINECALLINFO O 000102cc dw TotalSize 0 000001a5 dwhleededSize 0 0000015c dwlsedSize 0 000001 5c hLine 0400010311 dwLlineDeviecelD 0 00000006 dwAddresslD 0 00000000 dw Trunk Ostttttitt 13 CallerlD 201 CallediD 20 Connected ID 201 LINEC ALLSTATE_IBLE received IDLE Call Handle O0000102cc deallocated Figure 6 5 Messages of Call Status 73 Home Page Table of Contents Holding Calls in Progress If an extension asks to hold a call in progress the TAPI compatible applications of both the caller and called party will receive the call status events as shown in the figure below Caller Side TSP Switch Side Called Side Connect Connect State Hold Command Connect State Call 1 Call 1 _ POUTEEETEREPEEELTEEEEEELOSEEE ECE PEET ELE ECEETeeTeee ere ee gt noe Connect State Call 1 Hold On State Dial tone Event Call 1 E Timeout a Dial tone State Hook On Event Call 2 IDLE State Call 2 Retrieve Command COUSEUELETELETELEPESTCETECEP TOPE CPPTTEe TEP rerereerere rere gt Retrieved Event Connect State Call 1 Connect State Call 1 Figure 6 6 Flow Chart
59. n information on calls in each line device is changed Information on calls needed during call processing includes caller ID name called party D name the phone number name of the person to whom a call is forwarded and call status The information can be changed When the information is changed the LINE CALLINFO event is reported The TAPI compatible application calls the lineGetCallInfo function to read the details when the LINE CALLINFO event is generated 70 Table of Contents Flow Chart of Call Status When call status is changed the OpenTSP driver reports information on call status through the LINE CALLSTATE and LINE CALLINFO events The LINE CALLSTATE event reports the information on the status change of the generated calls and the LINE CALLINFO event reports the information on the details of each call are changed The figure below briefly shows the change of call status from call generation to termination enosn JE Figure 6 2 Example of Flow Chart of Call Status g Outgoing and incoming calls are exemplified below When Making a Call from Extension 2001 to Extension 2002 The procedure for making a call from Extension 2001 is as follows e IDLE gt DIALTONE gt RINGBACK gt CONNECTED gt DISCONNECTED gt IDLE The procedure for connecting a call with Extension 2002 is as follows e IDLE gt Offeringz gt CONNECTED gt DISCONNECT gt IDLE When call status is changed as described above the OpenTSP driver forwards the
60. nctions This chapter describes the TAPI functions and expansion functions supported by the OpenTSP driver Home Page Table of Contents CHAPTER 6 Call Processing Flow This chapter describes the life cycle of the TAPI various call processing events of the OpenTSP driver and the call processing procedure ABBREVIATION The frequently used abbreviations and acronyms and their meanings in this guide are all collected and explained Conventions The following special paragraphs are used in this document to point out information that must be read This information may be set off from the surrounding text but is always preceded by a bold title in capital letters WARNING Indicates a potentially hazardous situation which if not avoided could result in death WARNING or serious injury CAUTION Indicates a potentially hazardous situation which if not avoided may result in minor or CAUTION moderate injury It may also be used to alert against unsafe practices CHECKPOINT Provides the operator with checkpoints for stable system operation NOTE Indicates additional information as a reference OPERATION PROCEDURES Indicates the operation procedures that should be executed in order Home Page Table of Contents Console Screen Output e The lined box with Courier New font will be used to distinguish between the main content and console output screen text e Bold Courier New font will indicate the valu
61. nect to Server OfticeSery Link Server IP Address 165 213 88 98 Server Port Mo e000 Trace Type None Level C Level 2 OF Figure 3 2 OpenTSP Config Tool Screen e Server IP Address Enter the IP address of the computer where the OfficeServ Link is installed The OfficeServ Link program may or may not be installed and operated on the same computer where the OpenTSP driver is installed e Server Port No This is the number of the port where the OfficeServ Link program is waiting for connection The default number is 6000 This port number should be set as the same port number set at the OfficeServ Link program e Trace Type The OpenTSP driver displays its operation data through the Tool DBGView exe Set the details of the operation data to be displayed None No display default Level 1 Displays only basic information Level 2 Displays detail information 31 Home Page Table of Contents Scavenger Tool The Scavenger Tool allows the user to initialize the TSP driver without restarting the driver during operation This can be used to remove the call details from one or more devices if required This tool should be used with care and only under instruction from a trained engineer Figure 3 10 Scavenger Tool Item Description Setup Displays the Scavenger option setup screen On the option setup screen select the phone line from which the Call details should be
62. nment below before installing the OpenTSP driver Table 2 2 OpenTSP Driver Installation Environment Type Category Requirement Hardware Compatible Switch iDCS 100 Version 1 34 or higher IDCS 500 Version 1 35 or higher IDCS 500 R2 Version 2 13 or higher The OpenTSP may only use the switch service through a separate S W called OfficeServ Link A network card supporting TCP IP protocol should be installed on the PC Software TAPI version TAPI 2 x or higher Operating system Windows 2000 Professional Server Windows XP Professional 1 2 Home Page Table of Contents Installation Conditions Check the items below before installing the OpenTSP driver on the system Valid Licence The licence key is required for installing and using the OpenTSP driver Refer to your Samsung Dealer for details of how to obtain a licence OfficeServ Link Program The OfficeServ Link program must be installed to use the CTI features of the Samsung telephone system All CTI application programs are connected to the switch through the OfficeServ Link program OfficeServ Link Program The OfficeServ Link program is software that enables multiple CTI application NOTE programs to connect to the switch and controls the message flow between the application programs and the switch Refer to the OfficeServ Link Manual for details such as installation and operation of the OfficeServ Link program Samsung TSP Driver Delete previous versions of
63. normally 35 1 1 Environment Setup Procedure There are two ways to set the environment for setting the IP address and port for selecting the trace type and for entering the licence key e Phone and Modem Options Advanced tab e OpenTSP Config Tool Setup through the Phone and Modem Options Advanced tab Procedure for setting the environment through the Phone and Modem Options Advanced tab of the OS is as follows 1 Select Start gt Settings gt Control Panel on the computer Windows Update Programs Documents Settings Search Printers Help Taskbar amp Start Menu Rum Log OFF Administrator Shut Down Windows 200 Professional Figure 4 1 Starting Control Panel 2 Select the Phone and Modem Options from the Control Panel shown below oxi File Edit View Favorites Tools Help ma Back Qsearch G3Folders Efhistory WS E X A Ea Address Go Sy amp Accessibility Options Add Remove Hardware Fy Add Remove Programs 3 Administrative Tools Bp Date Time Control Panel Display C Folder Options Ak Game Controllers Phone and Modem Options Gf Internet Options Sy lava Plug in 1 4 0_03 Configures your telephone dialing rules gy Keyboard D Mouse and modem properties Network and Dial up Connections amp Phone and Modem Options Windows Update YA Power Options Printers Regional Options Z Scanners and Cameras Scheduled Task
64. osoft H 323 TAFI Service Provider Microsoft Multicast Conference TAP Service Provider NDIS Prowy TAP Service Provider Samsung OfficeSery OpenTSP Driver for Reyphone Seres TAP Kemel Mode Service Provider Unimodem 5 Serice Provider Add Remove Configure Figure 4 5 Selecting Configure Button of Advanced Tab 7 Enter the fields of the Communication Parameters window and click the OK button Communication Parameters Trace Type None C Lexell Level 2 Figure 4 6 Communication Parameters Window Server IP Address IP address of the PC where the OfficeServ Link is installed Server Port No Use the default number 6000 This port number should be set as the same port number set at the OfficeServ Link program Trace Type Select Level 1 or Level 2 to display call processing messages or select None not to display messages 38 Table of Contents 1 2 Setup through OpenTSP Config Tool Procedure for setting the OpenTSP driver environment through the OpenTSP Config Tool is as follows 1 Execute the OpenTSP Config Tool under the Start gt Programs gt OfficeServ g OpenTSP Driver The screen below is displayed OfficeSery OpenTSP Driver a x Before changing each configuration value you have to stop all tapi applications at First Figure 4 7 Closing TAPI Compatible Program 2 The message above informs the user that all TAPI compatible programs need to be closed
65. r License Agreement EULA ts a legal binding agreement between hou ether an individual or an entity and Samsung for Samsung software product identified above which includes computer software and may include printed maternal and Do pou accept all the terme of the preceding License Agreement If vou choose Mo the setup will close To install OfficeS ery OpenT SP Driver you must accept this agreement InstallShield Back es Ho Figure 2 12 Licence Agreement 16 Table of Contents 4 The Choose Destination Location window appears as shown below Click the Next gt button to use the default path C Program Files Samsung Telephony Service Provider or click the Browse button to change the installation folder InstallShield Wizard j X Choose Destination Location Select folder where Setup will install files Setup will install OfficeSery OpenT SP Driver in the following folder To install to this folder click Mest To install to a different folder click Browse and select another folder Destination Folder 0 5 OfficeServ OpenT SP Driver Browse InstallShield a lt Back Cancel Figure 2 13 Selecting Installation Folder G OpenTSP Driver Installation Folder The OpenTSP installation program installs two types of programs on the user s NOTE computer The SCTSP32 TSP file basic Telephony Service Provider file is copied to the C WINNT system32 folder and is registered
66. result of the TAPI function lineGetCallInfo e Answer Answers the call e Drop Disconnects the connected call e Deallocate Clears all displayed call information regardless of the phone status This feature initializes the line device managed by the OpenTSP driver and deletes all call data on the corresponding line Irrespective to the actual status of the device This feature can be used to manually remove any inconsistencies between the status of the actual phone and the reported status in TAPI 46 Home Page Table of Contents Checking Call Processing Messages through the Message Viewer Tool The Message Viewer Tool is used for verifying the messages processed during the operation of the OpenTSP driver Downloading the DBGView exe file As the execution file of the Message Viewer Tool the DBGView exe is used along NOTE with the OpenTSP driver Made by Sysinternal this program is used for logging debug messages within the Windows OS Download and update your DBGView exe file from http www sysintenal com 1 Click Start gt Programs OfficeServ OpenTSP Driver gt TAPI Sampler Tool as shown below OpenTSP Contig Tool scavenger Tool Tapi sampler Tool Figure 4 22 Executing the TAPI Sampler Tool 2 The Message Viewer Tool DBGView exe screen below appears and displays the messages exchanged during the operation of the OpenTSP driver DebugView on 4HtAMAMIYA local O x File Edit
67. s Time By winFil32 Sa WINS Client Sa Workstation By world Wide Web Pu Provides R Transports Manages 4 Provides s Tracks syst Enables 4 Enables su Provides T Allows are Manages 4 Starts and Installs re Provides s Provides s Sets the co Maintains 4 Provides n Provides W Started Started Started Started Started Started Started Started Started Started Started Started Automatic Automatic Manual Manual Automatic Automatic Automatic Manual Manual Manual Manual Manual Automatic Manual Manual Automatic Automatic Automatic Automatic SSS Figure 2 9 Service Window Terminating Restarting the Telephony Service Users can terminate or restart the telephony service if necessary through the above window LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem LocalSystem 14 5 Home Page Table of Contents The telephony service of the Windows OS is related to the following services Thus the services below should be checked for normal operation Remote Access Auto Connection Manager Remote Access Connection Manager These two Services should be set to Disable or Manual and stopped for normal operation i Services Oj x
68. s sf Sounds and Multimedia g System Users and Passwords Windows 2000 Support Configures your telephone dialing rules and modem properties My Computer Figure 4 2 Selecting Phone and Modem Options 36 Home Page Table of Contents 3 Click the Edit E button on the Phone and Modem Options window Phone And Modem Options i x Dialing Rules Modems Advanced The list below dizplays the locations you have specified Select the location from which you are dialing Locations Od My Location 02 Mew Edit Delete coed s Figure 4 3 Phone and Modem Options Window 5 Select the Advanced tab on the Phone and Modem Options window Phone And Modem Options E k ajx Dialing Rules Modems Advanced The following telephony providers are installed on this computer Providers Microsoft H 323 TAP Service Provider Microsoft Multicast Conference TAP Service Provider NDIS Proy TAP Service Provider Samsung OfficeSery OpenT SF Driver for Kepphone Seres TAFI Kemel Mode Service Provider Unimodem 5 Serice Provider Add Remove Configure o Figure 4 4 Advanced Tab of Phone and Modem Options Window 37 Table of Contents Table of Contents 6 Select the Samsung OfficeServ OpenTSP Driver for Keyphone Series and click the Configure C button Phone 4nd Modem Options x Dialing Rules Modems Advanced Providers Micr
69. services were abnormally set during the system setup procedure the two services and the telephony service may not operate normally and the OpenTSP driver may not be loaded or unloaded properly disabling the use of related application programs To avoid such incidents it is recommended to set the start type as Disabled to disable unnecessary services If the two services are marked as Started and the OpenTSP does not operate properly change the start type to Disabled and reboot the system 15 Home Page Table of Contents 2 OpenTSP Driver Installation Procedure The procedure for installing the OpenTSP driver 1s as follows m 1 Double click the OpenTSP installation file Setup exe on the CD ROM es 2 Click the Next gt button on the screen below InstallShield Wizard x OfficeSery OpenT SP Driver Setup Welcomelll After now OfficeSery OpenTSP Driver will be Installed 4 Back Cancel Figure 2 11 Installation Window 3 Read the Licence Agreement below and select Yes to approve Select No to abort the installation program InstallShield Wizard License Agreement Please read the following license agreement carefully Press the PAGE DOWN key to see the rest of the agreement Software License Agreement amp Limited Warranty for Samsung Telephony Service Provider for DCS Keyphone Series Sameung Electronics Co LTD IMPORTANT READ CAREFULLY This Samsung End Use
70. settings Connect to Dial az Eb Phone call m Internet Call Add number to speed dial list Place Call Cancel Figure 4 14 Dialing from the Dial Screen 42 Table of Contents 8 The screen below appears and shows that extension 2001 is dialing extension 2002 Preview X Close BO Go e Phone Call eT Disconnect ez A Waiting for answer Phone Call ET ake Call all 7 Reject Call cf Incoming call Figure 4 15 Dialing Display Screen 9 The screen below appears upon successful connection Select Disconnect D to terminate the connection after completing the call Preview X Close amp Phone Call 201 X Close x Disconnected Phone Call 202 Disconnect lt Waiting for answer Phone Call 201 K Take Call T Reject Call A Incoming call Figure 4 16 Disconnecting the Call Checking the OpenTSP driver operation If the OpenTSP driver is successfully connected to the TAPI service through the dialing program the messages exchanged can be viewed through the Message Viewer 43 Table of Contents 2 2 Call Processing of the TAPI Sampler Users can dial receive or disconnect calls through the TAPI Sampler The OfficeServ Link program should be normally running to Dial using the TAPI program Dialing Calls Procedure for dialing calls using the TAPI Sampler is as follows
71. the Samsung TSP driver if any before installing the new driver Previous versions of the Samsung TSP driver may be installed in the following cases e Ifthe Samsung TAPI 2 x was installed on a PC using the Windows NT or 2000 Server OS e Ifthe computer where the Samsung TAPI 2 x driver was installed is set as the Telephony Client e IfiDCS Call Version 5 1 or lower is installed The procedure for checking the information on the TSP driver installed on the computer is as follows 1 Select Start gt Settings gt Control Panel on the computer Windows Update Programs j Documents e Control Panel Network and Dial up Connections Search Nias i Printers Taskbar amp Start Menu Help RUM Log OFF Administrator Shut Down Figure 2 1 Starting the Control Panel Table of Contents 2 Double click Phone and Modem Options from the Control Panel shown below Fie Edt View Favorites Tools Help a Eack p Gi Search Ut Folders EA History U KO O Ez Hi E Accessibility Options 8 Add Remove Hardware Feb Add Remove Programs ga dministrative Tools 3 Dake Tine Control Panel WA Display Sf Folder Options A AE Game Controllers ip Internet Options gt Java Plug in 1 4 0 03 Phone and Modem Options a Configures your telephone dialing rules Keyboard D Mouse and modem properties Network and Dial up Connections Aae onenean otete Sae
72. the USER with the name of an authorized Samsung Dealer to contact for warranty service DEALERS must provide written notice of malfunction to Samsung no later than the expiration of the warranty period 30 days after the date the Dealer becomes aware of the malfunction whichever comes first For purposes of this Warranty the issuance by Samsung of a Return Material Authorization RMA number by telephone to an authorized Dealer shall be deemed to be written notice from the Dealer with respect to the material returned under that RMA SAMSUNG MAKES NO OTHER WARRANTIES EXPRESS OR IMPLIED AND SPECIALLY DISCLAIMS ANY IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE THESE WARRANTIES ARE DEALER S AND USER S SOLE REMEDIES AND IN LIEU OF ALL OBLIGATIONS OR LIABILITIES ON THE PART OF SAMSUNG FOR DAMAGES INCLUDING BUT NOT LIMITED TO SPECIAL INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR IN CONNECTION WITH THE USE OF THE PRODUCTS OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE DATA OR PROFITS ARISING OUT OF OR IN CONNECTION WITH THE PERFORMANCE OF THE PRODUCTS WHETHER IN A CONTRACT OR TORT ACTION INCLUDING NEGLIGENCE EVEN IF SAMSUNG HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES THE TOTAL MAXIMUM LIABILITY OF SAMSUNG FOR BREACH OF WARRANTY SHALL BE LIMITED TO A REFUND OF THE COST OF THE DEFECTIVE PRODUCT No Dealer and no person other than an officer of SAMSUNG TELECOMMUNICATIONS AMERICA L P may extend or
73. to TAPI Utility programs required for installing and operating the OpenTSP driver are copied to the C Program Files Samsung Telephony Service Provider folder Thus the folder selected during the installation procedure above C Program Files Samsung Telephony Service Provider is the location to where the utility programs are copied 17 Home Page Table of Contents 5 Select Typical from the Setup Type window below and click the Next gt button InstallShield Wizard Setup Type Select the Setup Type to install Click the type of Setup you prefer then click Mest f Typical Program will be installed with the most common options Recommended for most Users Compact Program will be installed with minimum required options E Custom ou may choose the options you want to install Recommended for advanced MEETS InstallShield lt Back He Cancel Figure 2 14 Selecting Installation Type 6 The Select Program Folder window below appears Click the Next gt button to use the default name Samsung Telephony Service Provider Enter a new name into the field to change the folder name InstallShield Wizard l x Select Program Folder Please select 4 program folder Setup will add program icons to the Program Folder listed below ou may type a new folder name or select one from the existing folders list Click Next to continue Program Folders OfficeSery OpenT SP re
74. ung supplied hardware accompanying the SOFTWARE will be free from defects in materials and workmanship under normal use and service for a period of one 1 year from the date of receipt During the warranty periods specified above Samsung will replace or repair any software or hardware found to be defective Warranty claims should be made through the Samsung dealer from whom the products were purchased and must be made within the applicable warranty period NO OTHER WARRANTIES TO THE MAXIMUM EXTENT PERMITTED BY THE APPLICABLE LAW SAMSUNG DISCLAIMS ALL OTHER WARRANTIES EITHER EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR PARTICULAR PURPOSE WITH RESPECT TO THE SOFTWARE THE ACCOMPANYING PRODUCT MANUAL S AND WRITTEN MATERIALS AND ANY ACCOMPANYING HARDWARE NO LIABILITY FOR DAMAGES TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN NO EVENT SHALL SAMSUNG OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF BUSINESS PROFITS BUSINESS INTERRUPTION LOSS OF BUSINESS INFORMATION OR ANY OTHER PECUNIARY LOSS ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE PRODUCT EVEN IF SAMSUNG HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES Samsung Telecommunications America L P This warranty is for the benefit of and shall apply only to authorized Dealers and to Users This warranty will not apply if the defect arises out of accident n
75. vironment and procedure required for the installation of the OpenTSP driver For proper installation and operation of the OpenTSP driver the installation environment and conditions should be checked before installation Refer to the table below in which the installation procedure 1s summarized when installing the OpenTSP driver Table 2 1 OpenTSP Driver Installation Procedure 1 Installation Environment and Check the following environment and condition before Conditions installing the OpenTSP driver Check the H W and S W environments Check for the OpenTSP driver licence key Check if the OfficeServ Link program has been installed Previous versions of Samsung TAPI drivers should not be on the system 2 OpenTSP_ Driver Installation Install the OpenTSP driver according to the installation Procedure procedure Read the Cautions and Notes carefully to prevent error during installation 3 Installation Data Verification After installing the OpenTSP driver check if the installation is successful by verifying the driver file and the registration status Home Page Table of Contents 1 Installation Environment and Conditions The OpenTSP driver may be installed and executed for call processing on various versions of Microsoft Windows This section describes the environment and conditions that are required for proper installation of the OpenTSP driver 1 1 Installation Environment Check the installation enviro
76. ys the phone number of the other party Message Status Window Parameters of the Message Status Window are as follows Parameter Description Time Time when the event was received Event Displays details on the received event 34 Table of Contents CHAPTER 4 OpenTSP Driver Guide This chapter describes the procedures for dialing receiving and disconnecting calls using the OpenTSP driver after successfully installing the driver on the PC The tools or programs used for procedures from setting the environment to processing calls are as follows Step 1 Environment Setup 2 Call Processing 3 Checking Call Processing Messages Set IP address and port Phone and Modem Options Advanced tab OpenTSP Config Tool Phone and Modem Options Advanced tab Set Trace type OpenTSP Config Tool Set Dialing Rules Edit location of Phone and Modem Options Refer to 1 3 Checking Telephony Service in Chapter 2 Dialing receiving or Programs Accessories Communication disconnecting calls gt Dial TAPI Sampler OpenTSP driver Programs Accessories gt Communication operation status gt Dial Message viewer TAPI32 Browser Execute OpenTSP TAPI TAPI32 Browser call function Receive call processing Message viewer result log TAPI Compatible Application Program Ne TAPI Compatible Application Programs can be used when the OfficeServ Link CHECK program is connected through the OpenTSP driver and is operating

User Manual - TriVium Systems, Inc

Contents

Download Pdf Manuals

Related Search

Related Contents