Nortel CTI ToolKit, User Manual

Page: 29 / 108

CTI Toolkit Blocks Reference
# P0606089 Ver: 1.1 Nortel Networks Confidential Page 29
You can also use a CTI.Status data card to determine whether a request succeeds or
fails. After a block is executed, the value of the
CTI.Status
data card is assigned the
value 0 if the block’s execution was successful, or is set to a non-zero value if there
was a problem. Normally, applications must only check the value of
CTI.status
to
determine the success or failure of an operation such as transferring a call, receiving
data, etc.
In the case of a general failure (one which is not a direct result of executing a
particular block), a
ctifail
condition can be asynchronously generated. In general,
it is recommended that the application explicitly handle the
ctifail
condition.
Generally speaking, requests can fail for different reasons. The most common include:
• unavailable resources
• invalid parameter specifications in a block
• timer expiration.The maximum amount of time that an application waits for a
response is determined by the value of the Environment block variable
vpsrcvtime . If a request times out, the application receives a vrto
condition (instead of
of
). This is another condition that the application should
handle.
• unregistered ports. The ports used to run an IVR application or Agent phone
have to be registered using the IPML Configurator. The switch and/or SCCS
must be configured properly to identify Agent Position IDs and CDNs.
• invalid configuration file entries. To use the functions in the CTI Toolkit, the
IPML packages must be properly configured by following the procedures in
the MPS Interface to M1 publication. The following are some configuration
essentials that should be verified if particular blocks produce problems when
executed:
• CTI blocks— Use the IPML Configurator to set up communications
between CSVAPI and VMS, CSVAPI and TLS, and TLS and SCCS (or
the switch).
• TAPI blocks— Use the IPML Configurator to set up communications
between CSTAPILS and VMS, CSTAPI and CSTAPILS, and CSTAPILS
and the Symposium TAPI server.
• RSM block— The configuration files must be set up to allow
communications between CSRSM and VMS, CSRSM and CSRSMLS,
and TLS and SCCS (or the switch). Skill levels, agent names, and
application (SCCS script names) must be entered in IPML Configurator
in PeriView.