RemoteJTapiServer._Async (Java Legacy Documentation 8.5.0-SNAPSHOT API)

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

cisco.uc.cuae.legacy
Class RemoteJTapiServer._Async

java.lang.Object
  cisco.uc.cuae.legacy.RemoteJTapi._Async
      cisco.uc.cuae.legacy.RemoteJTapiServer._Async

Enclosing class:: RemoteJTapiServer

public final class RemoteJTapiServer._Async
extends RemoteJTapi._Async
extends RemoteJTapi._Async

Asynchronous implementation of service methods.

Constructor Summary
`RemoteJTapiServer._Async()`

Method Summary
`etch.bindings.java.support.Mailbox`	`_begin_jTapiAnswerCall(java.lang.String sessionId, java.lang.Long callId, JTapi.JTapiAnswerCallOptions options)` Begins a call to jTapiAnswerCall.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiBlindTransfer(java.lang.String sessionId, java.lang.Long callId, java.lang.String to, JTapi.JTapiBlindTransferOptions options)` Begins a call to jTapiBlindTransfer.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiConference(java.lang.String sessionId, java.lang.Long callId, java.lang.Long volatileCallId, JTapi.JTapiConferenceOptions options)` Begins a call to jTapiConference.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiDirectTransfer(java.lang.String sessionId, java.lang.Long firstCallId, java.lang.Long secondCallId, JTapi.JTapiDirectTransferOptions options)` Begins a call to jTapiDirectTransfer.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiGetActiveCalls(java.lang.String sessionId, java.lang.String deviceName, java.lang.String lineDN, JTapi.JTapiGetActiveCallsOptions options)` Begins a call to jTapiGetActiveCalls.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiGetAddressesOnTerminal(java.lang.String sessionId, java.lang.String deviceName, JTapi.JTapiGetAddressesOnTerminalOptions options)` Begins a call to jTapiGetAddressesOnTerminal.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiGetCallForwardStatus(java.lang.String sessionId, java.lang.String deviceName, java.lang.String directoryNumber, JTapi.JTapiGetCallForwardStatusOptions options)` Begins a call to jTapiGetCallForwardStatus.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiGetDeviceStatus(java.lang.String sessionId, java.lang.String deviceName, JTapi.JTapiGetDeviceStatusOptions options)` Begins a call to jTapiGetDeviceStatus.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiHangup(java.lang.String sessionId, java.lang.Long callId, JTapi.JTapiHangupOptions options)` Begins a call to jTapiHangup.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiHold(java.lang.String sessionId, java.lang.Long callId, JTapi.JTapiHoldOptions options)` Begins a call to jTapiHold.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiMakeCall(java.lang.String sessionId, java.lang.String to, java.lang.String deviceName, java.lang.String from, JTapi.JTapiMakeCallOptions options)` Begins a call to jTapiMakeCall.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiNonTriggeringSubscribe(java.lang.String sessionId, java.lang.String deviceName, java.lang.String devicePoolName, JTapi.DeviceType deviceType, JTapi.JTapiNonTriggeringSubscribeOptions options)` Begins a call to jTapiNonTriggeringSubscribe.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiParkCall(java.lang.String sessionId, java.lang.Long callId, JTapi.JTapiParkCallOptions options)` Begins a call to jTapiParkCall.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiRedirect(java.lang.String sessionId, java.lang.Long callId, java.lang.String to, java.lang.String prefferedOriginalCalledParty, JTapi.JTapiRedirectOptions options)` Begins a call to jTapiRedirect.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiRejectCall(java.lang.String sessionId, java.lang.Long callId, JTapi.JTapiRejectCallOptions options)` Begins a call to jTapiRejectCall.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiResume(java.lang.String sessionId, java.lang.Long callId, java.lang.String rxIP, java.lang.Long rxPort, JTapi.JTapiResumeOptions options)` Begins a call to jTapiResume.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiSendXSIData(java.lang.String sessionId, java.lang.String deviceName, java.lang.String xSIData, JTapi.JTapiSendXSIDataOptions options)` Begins a call to jTapiSendXSIData.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiStartMonitoring(java.lang.String sessionId, java.lang.String targetCallId, java.lang.String targetDeviceName, java.lang.String targetLineDN, java.lang.String listenerLineDN, JTapi.JTapiStartMonitoringOptions options)` Begins a call to jTapiStartMonitoring.
`etch.bindings.java.support.Mailbox`	`_begin_jTapiUnsubscribe(java.lang.String sessionId, java.lang.String deviceName, JTapi.JTapiUnsubscribeOptions options)` Begins a call to jTapiUnsubscribe.
`JTapi.JTapiAnswerCallResult`	`_end_jTapiAnswerCall(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiAnswerCall.
`JTapi.JTapiBlindTransferResult`	`_end_jTapiBlindTransfer(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiBlindTransfer.
`JTapi.JTapiConferenceResult`	`_end_jTapiConference(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiConference.
`JTapi.JTapiDirectTransferResult`	`_end_jTapiDirectTransfer(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiDirectTransfer.
`JTapi.JTapiGetActiveCallsResult`	`_end_jTapiGetActiveCalls(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiGetActiveCalls.
`JTapi.JTapiGetAddressesOnTerminalResult`	`_end_jTapiGetAddressesOnTerminal(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiGetAddressesOnTerminal.
`JTapi.JTapiGetCallForwardStatusResult`	`_end_jTapiGetCallForwardStatus(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiGetCallForwardStatus.
`JTapi.JTapiGetDeviceStatusResult`	`_end_jTapiGetDeviceStatus(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiGetDeviceStatus.
`JTapi.JTapiHangupResult`	`_end_jTapiHangup(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiHangup.
`JTapi.JTapiHoldResult`	`_end_jTapiHold(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiHold.
`JTapi.JTapiMakeCallResult`	`_end_jTapiMakeCall(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiMakeCall.
`JTapi.JTapiNonTriggeringSubscribeResult`	`_end_jTapiNonTriggeringSubscribe(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiNonTriggeringSubscribe.
`JTapi.JTapiParkCallResult`	`_end_jTapiParkCall(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiParkCall.
`JTapi.JTapiRedirectResult`	`_end_jTapiRedirect(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiRedirect.
`JTapi.JTapiRejectCallResult`	`_end_jTapiRejectCall(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiRejectCall.
`JTapi.JTapiResumeResult`	`_end_jTapiResume(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiResume.
`JTapi.JTapiSendXSIDataResult`	`_end_jTapiSendXSIData(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiSendXSIData.
`JTapi.JTapiStartMonitoringResult`	`_end_jTapiStartMonitoring(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiStartMonitoring.
`JTapi.JTapiUnsubscribeResult`	`_end_jTapiUnsubscribe(etch.bindings.java.support.Mailbox mb)` Ends a call to jTapiUnsubscribe.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

RemoteJTapiServer._Async

public RemoteJTapiServer._Async()

Method Detail

_begin_jTapiAnswerCall

public final etch.bindings.java.support.Mailbox _begin_jTapiAnswerCall(java.lang.String sessionId,
                                                                       java.lang.Long callId,
                                                                       JTapi.JTapiAnswerCallOptions options)

Begins a call to jTapiAnswerCall. Answers a call currently ringing on a monitored device. None. JTapiAnswer answers an incoming call that is ringing on a phone device currently being monitored by the application server. Once the action has successfully completed, the device being monitored will answer the ringing call. The application would have already received notification of the incoming call via the triggering JTapiIncomingCall event. The CallId present as an event parameter in the JTapiIncomingCall event would then be used as the CallId action parameter for the JTapiAnswer action. You can not successfully use JTapiAnswer after the ringing device has been answered (most likely cause is the user answering the phone, but another JTAPI-based application could be the cause of the answer as well). You can know in your application that the call has already been answered if the JTapiCallActive fires before you have used the JTapiAnswer action. If the calling party hangs up their end of the call before the call is answered, then it is no longer valid to use JTapiAnswer. You can know in your application that the call has already been hung up if the JTapiHangup event fires after the JTapiIncomingCall event instead of JTapiCallActive. If call is rejected with JTapiReject, then it is no longer valid to use JTapiAnswer.

Parameters:: sessionId - The session Id for this method call; callId - Indicates the call to answer with JTapiAnswer. The CallId must have originated from a JTapiIncomingCall event.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiAnswerCall.
See Also:: RemoteJTapiServer.jTapiAnswerCall(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiAnswerCallOptions), _end_jTapiAnswerCall(etch.bindings.java.support.Mailbox)

_end_jTapiAnswerCall

public final JTapi.JTapiAnswerCallResult _end_jTapiAnswerCall(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiAnswerCall. Answers a call currently ringing on a monitored device. None. JTapiAnswer answers an incoming call that is ringing on a phone device currently being monitored by the application server. Once the action has successfully completed, the device being monitored will answer the ringing call. The application would have already received notification of the incoming call via the triggering JTapiIncomingCall event. The CallId present as an event parameter in the JTapiIncomingCall event would then be used as the CallId action parameter for the JTapiAnswer action. You can not successfully use JTapiAnswer after the ringing device has been answered (most likely cause is the user answering the phone, but another JTAPI-based application could be the cause of the answer as well). You can know in your application that the call has already been answered if the JTapiCallActive fires before you have used the JTapiAnswer action. If the calling party hangs up their end of the call before the call is answered, then it is no longer valid to use JTapiAnswer. You can know in your application that the call has already been hung up if the JTapiHangup event fires after the JTapiIncomingCall event instead of JTapiCallActive. If call is rejected with JTapiReject, then it is no longer valid to use JTapiAnswer.

Parameters:: mb - mailbox returned by _begin_jTapiAnswerCall.
See Also:: RemoteJTapiServer.jTapiAnswerCall(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiAnswerCallOptions), _begin_jTapiAnswerCall(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiAnswerCallOptions)

_begin_jTapiHold

public final etch.bindings.java.support.Mailbox _begin_jTapiHold(java.lang.String sessionId,
                                                                 java.lang.Long callId,
                                                                 JTapi.JTapiHoldOptions options)

Begins a call to jTapiHold. Puts an active call on a monitored device on hold. The JTapiCallInactive will fire as a result of using this action successfully. JTapiHold puts an active call on hold. For this action to succeed, the script must have already received notification of the call entering the active state with the nontriggering JTapiCallActive event.

Parameters:: sessionId - The session Id for this method call; callId - Indicates the call to be put on hold with JTapiHold.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiHold.
See Also:: RemoteJTapiServer.jTapiHold(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiHoldOptions), _end_jTapiHold(etch.bindings.java.support.Mailbox)

_end_jTapiHold

public final JTapi.JTapiHoldResult _end_jTapiHold(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiHold. Puts an active call on a monitored device on hold. The JTapiCallInactive will fire as a result of using this action successfully. JTapiHold puts an active call on hold. For this action to succeed, the script must have already received notification of the call entering the active state with the nontriggering JTapiCallActive event.

Parameters:: mb - mailbox returned by _begin_jTapiHold.
See Also:: RemoteJTapiServer.jTapiHold(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiHoldOptions), _begin_jTapiHold(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiHoldOptions)

_begin_jTapiResume

public final etch.bindings.java.support.Mailbox _begin_jTapiResume(java.lang.String sessionId,
                                                                   java.lang.Long callId,
                                                                   java.lang.String rxIP,
                                                                   java.lang.Long rxPort,
                                                                   JTapi.JTapiResumeOptions options)

Begins a call to jTapiResume. Resume a held call on a monitored device. The JTapiCallActive will fire as a result of using this action successfully. JTapiResume resumes a held call. For this action to succeed, at a minimum, the script must have already received notification of the call entering the inactive state with the nontriggering JTapiCallInactive event. However, the JTapiCallInactive event does not necessarily always correspond to a call being held.

Parameters:: sessionId - The session Id for this method call; callId - Indicates the call to be resumed with JTapiResume.; rxIP - The IP address that the resumed audio should be sent to, from the monitored device. If this field is not specified, then the audio will resume sending to where it would have, if this parameter were not specified. In other words, not specifying this parameter generally causes the monitored device to begin streaming to the device it was previously streaming to before the call was held. This field has only rare use and should almost always be left specified.; rxPort - The port that the resumed audio should be sent to, from the monitored device. If this field is not specified, then the audio will resume sending to where it would have, if this parameter were not specified. In other words, not specifying this parameter generally causes the monitored device to begin streaming to the device it was previously streaming to before the call was held. This field has only rare use and should almost always be left unspecified.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiResume.
See Also:: RemoteJTapiServer.jTapiResume(java.lang.String, java.lang.Long, java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiResumeOptions), _end_jTapiResume(etch.bindings.java.support.Mailbox)

_end_jTapiResume

public final JTapi.JTapiResumeResult _end_jTapiResume(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiResume. Resume a held call on a monitored device. The JTapiCallActive will fire as a result of using this action successfully. JTapiResume resumes a held call. For this action to succeed, at a minimum, the script must have already received notification of the call entering the inactive state with the nontriggering JTapiCallInactive event. However, the JTapiCallInactive event does not necessarily always correspond to a call being held.

Parameters:: mb - mailbox returned by _begin_jTapiResume.
See Also:: RemoteJTapiServer.jTapiResume(java.lang.String, java.lang.Long, java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiResumeOptions), _begin_jTapiResume(java.lang.String, java.lang.Long, java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiResumeOptions)

_begin_jTapiRejectCall

public final etch.bindings.java.support.Mailbox _begin_jTapiRejectCall(java.lang.String sessionId,
                                                                       java.lang.Long callId,
                                                                       JTapi.JTapiRejectCallOptions options)

Begins a call to jTapiRejectCall. Rejects a call currently ringing on a monitored device, ending it. None. JTapiReject rejects a call inbound to a phone device, causing the call to end immediately. You can not successfully use JTapiReject after the ringing device has been answered (most likely cause is the user answering the phone, but another JTAPI-based application could be the cause of the answer as well). You can know in your application that the call has already been answered if the JTapiCallActive fires before you have used the JTapiReject action.

Parameters:: sessionId - The session Id for this method call; callId - Indicates the call to reject with JTapiReject. The CallId must have originated from a JTapiIncomingCall event.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiRejectCall.
See Also:: RemoteJTapiServer.jTapiRejectCall(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiRejectCallOptions), _end_jTapiRejectCall(etch.bindings.java.support.Mailbox)

_end_jTapiRejectCall

public final JTapi.JTapiRejectCallResult _end_jTapiRejectCall(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiRejectCall. Rejects a call currently ringing on a monitored device, ending it. None. JTapiReject rejects a call inbound to a phone device, causing the call to end immediately. You can not successfully use JTapiReject after the ringing device has been answered (most likely cause is the user answering the phone, but another JTAPI-based application could be the cause of the answer as well). You can know in your application that the call has already been answered if the JTapiCallActive fires before you have used the JTapiReject action.

Parameters:: mb - mailbox returned by _begin_jTapiRejectCall.
See Also:: RemoteJTapiServer.jTapiRejectCall(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiRejectCallOptions), _begin_jTapiRejectCall(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiRejectCallOptions)

_begin_jTapiHangup

public final etch.bindings.java.support.Mailbox _begin_jTapiHangup(java.lang.String sessionId,
                                                                   java.lang.Long callId,
                                                                   JTapi.JTapiHangupOptions options)

Begins a call to jTapiHangup. Hangs up a call currently active on a monitored device. The JTapiHangup event will still fire when one uses this action. JTapiHangup hangs a call currently active on a phone device, causing the call to end immediately. If the other party hangs up their end of the call before this action is used, then there is no need to use JTapiHangup, since the call is over. You can know that the call has been hung up by anything other than the script if the JTapiHangup event fires.

Parameters:: sessionId - The session Id for this method call; callId - Indicates the call to hangup with JTapiHangup.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiHangup.
See Also:: RemoteJTapiServer.jTapiHangup(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiHangupOptions), _end_jTapiHangup(etch.bindings.java.support.Mailbox)

_end_jTapiHangup

public final JTapi.JTapiHangupResult _end_jTapiHangup(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiHangup. Hangs up a call currently active on a monitored device. The JTapiHangup event will still fire when one uses this action. JTapiHangup hangs a call currently active on a phone device, causing the call to end immediately. If the other party hangs up their end of the call before this action is used, then there is no need to use JTapiHangup, since the call is over. You can know that the call has been hung up by anything other than the script if the JTapiHangup event fires.

Parameters:: mb - mailbox returned by _begin_jTapiHangup.
See Also:: RemoteJTapiServer.jTapiHangup(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiHangupOptions), _begin_jTapiHangup(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiHangupOptions)

_begin_jTapiMakeCall

public final etch.bindings.java.support.Mailbox _begin_jTapiMakeCall(java.lang.String sessionId,
                                                                     java.lang.String to,
                                                                     java.lang.String deviceName,
                                                                     java.lang.String from,
                                                                     JTapi.JTapiMakeCallOptions options)

Begins a call to jTapiMakeCall. Causes a monitored device to place a call from a specific line. None. JTapiMakeCall will cause a line on a monitored device to place a call. The JTapiCallActive event will fire to the same script that issued the JTapiMakeCall, if the remote party specified by the To action parameter answers the call. If the remote party specified by the To action parameter answers the call, then the call is bound to this script, meaning JTapiCallActive, JTapiCallInactive, JTapiGotDigits, and JTapiHangup event will fire to the same script that issued the JTapiMakeCall. If the outbound call from the monitored phone is cancelled before the remote party answers, then a JTapiHangup event is sent to the same script that issued the JTapiMakeCall. A device in Cisco Unified Communications Manager does not make or receive calls; the line(s) on that device do. Therefore it is necessary to specify a real line number found on the device as the value of the From action parameter.

Parameters:: sessionId - The session Id for this method call; to - The destination number for this call. In practice, this number must be routable according to the dial plan of the Cisco Unified Communications Manager cluster that the call is sent to.; deviceName - The name of a controlled device from which to place the call. The From action parameter must be a valid line number on this device.; from - The line on the controlled device from which to originate the call leg.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiMakeCall.
See Also:: RemoteJTapiServer.jTapiMakeCall(java.lang.String, java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiMakeCallOptions), _end_jTapiMakeCall(etch.bindings.java.support.Mailbox)

_end_jTapiMakeCall

public final JTapi.JTapiMakeCallResult _end_jTapiMakeCall(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiMakeCall. Causes a monitored device to place a call from a specific line. None. JTapiMakeCall will cause a line on a monitored device to place a call. The JTapiCallActive event will fire to the same script that issued the JTapiMakeCall, if the remote party specified by the To action parameter answers the call. If the remote party specified by the To action parameter answers the call, then the call is bound to this script, meaning JTapiCallActive, JTapiCallInactive, JTapiGotDigits, and JTapiHangup event will fire to the same script that issued the JTapiMakeCall. If the outbound call from the monitored phone is cancelled before the remote party answers, then a JTapiHangup event is sent to the same script that issued the JTapiMakeCall. A device in Cisco Unified Communications Manager does not make or receive calls; the line(s) on that device do. Therefore it is necessary to specify a real line number found on the device as the value of the From action parameter.

Parameters:: mb - mailbox returned by _begin_jTapiMakeCall.
See Also:: RemoteJTapiServer.jTapiMakeCall(java.lang.String, java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiMakeCallOptions), _begin_jTapiMakeCall(java.lang.String, java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiMakeCallOptions)

_begin_jTapiConference

public final etch.bindings.java.support.Mailbox _begin_jTapiConference(java.lang.String sessionId,
                                                                       java.lang.Long callId,
                                                                       java.lang.Long volatileCallId,
                                                                       JTapi.JTapiConferenceOptions options)

Begins a call to jTapiConference. Conferences two established calls that exist on the same/different line(s) on a single device. Conferencing calls established on 2 different lines on the same device is commonly known as Join Across Lines(JAL). 1. There must be conferencing resources available in the Cisco Unified Communications Manager deployment for the phone that has both calls. 2. Join Across Lines must be enabled on Cisco Unified Communications Manager in order to do a JAL operation. JTapiConference will conference, or 'join', two calls together that have been established on the same/different line(s) on a given device. Both calls must have been answered already.

Parameters:: sessionId - The session Id for this method call; callId - One of the two calls that have been established on the same line.; volatileCallId - One of the two calls that have been established on the same/different line(s). This call ID will be destroyed afterwards, because 2 calls are being joined into one. All future call events will be sent up with the ID specified by the CallId action parameter.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiConference.
See Also:: RemoteJTapiServer.jTapiConference(java.lang.String, java.lang.Long, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiConferenceOptions), _end_jTapiConference(etch.bindings.java.support.Mailbox)

_end_jTapiConference

public final JTapi.JTapiConferenceResult _end_jTapiConference(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiConference. Conferences two established calls that exist on the same/different line(s) on a single device. Conferencing calls established on 2 different lines on the same device is commonly known as Join Across Lines(JAL). 1. There must be conferencing resources available in the Cisco Unified Communications Manager deployment for the phone that has both calls. 2. Join Across Lines must be enabled on Cisco Unified Communications Manager in order to do a JAL operation. JTapiConference will conference, or 'join', two calls together that have been established on the same/different line(s) on a given device. Both calls must have been answered already.

Parameters:: mb - mailbox returned by _begin_jTapiConference.
See Also:: RemoteJTapiServer.jTapiConference(java.lang.String, java.lang.Long, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiConferenceOptions), _begin_jTapiConference(java.lang.String, java.lang.Long, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiConferenceOptions)

_begin_jTapiRedirect

public final etch.bindings.java.support.Mailbox _begin_jTapiRedirect(java.lang.String sessionId,
                                                                     java.lang.Long callId,
                                                                     java.lang.String to,
                                                                     java.lang.String prefferedOriginalCalledParty,
                                                                     JTapi.JTapiRedirectOptions options)

Begins a call to jTapiRedirect. Redirects a call currently ringing on a monitored device to a new destination. None. JTapiRedirect redirects a call inbound to a phone device, causing the call to be sent to a new destination elsewhere. You can not successfully use JTapiRedirect after the ringing device has been answered (most likely cause is the user answering the phone, but another JTAPI-based application could be the cause of the answer as well). You can know in your application that the call has already been answered if the JTapiCallActive fires before you have used the JTapiAnswer action.

Parameters:: sessionId - The session Id for this method call; callId - Indicates the call to redirect with JTapiRedirect.; to - The destination number for the redirected call. In practice, this number must be routable according to the dial plan of the Cisco Unified Communications Manager cluster that the call is sent to.; prefferedOriginalCalledParty - The called party information that would appear in the redirect request.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiRedirect.
See Also:: RemoteJTapiServer.jTapiRedirect(java.lang.String, java.lang.Long, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiRedirectOptions), _end_jTapiRedirect(etch.bindings.java.support.Mailbox)

_end_jTapiRedirect

public final JTapi.JTapiRedirectResult _end_jTapiRedirect(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiRedirect. Redirects a call currently ringing on a monitored device to a new destination. None. JTapiRedirect redirects a call inbound to a phone device, causing the call to be sent to a new destination elsewhere. You can not successfully use JTapiRedirect after the ringing device has been answered (most likely cause is the user answering the phone, but another JTAPI-based application could be the cause of the answer as well). You can know in your application that the call has already been answered if the JTapiCallActive fires before you have used the JTapiAnswer action.

Parameters:: mb - mailbox returned by _begin_jTapiRedirect.
See Also:: RemoteJTapiServer.jTapiRedirect(java.lang.String, java.lang.Long, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiRedirectOptions), _begin_jTapiRedirect(java.lang.String, java.lang.Long, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiRedirectOptions)

_begin_jTapiBlindTransfer

public final etch.bindings.java.support.Mailbox _begin_jTapiBlindTransfer(java.lang.String sessionId,
                                                                          java.lang.Long callId,
                                                                          java.lang.String to,
                                                                          JTapi.JTapiBlindTransferOptions options)

Begins a call to jTapiBlindTransfer. Transfers an established call on a monitored device to a new destination. None. JTapiBlindTransfer transfers an answered call, causing the call to be sent to a new destination elsewhere. Once the transfer has completed, the call is completely removed from the control of the application server. You can successfully use JTapiBlindTransfer only after the device has been answered. You can know in your application that the call has already been answered if the JTapiCallActive fires before you have used the JTapiBlindTransfer action.

Parameters:: sessionId - The session Id for this method call; callId - Indicates the call to redirect with JTapiBlindTransfer.; to - The destination number for the transferred call. In practice, this number must be routable according to the dial plan of the Cisco Unified Communications Manager cluster that the call is sent to.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiBlindTransfer.
See Also:: RemoteJTapiServer.jTapiBlindTransfer(java.lang.String, java.lang.Long, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiBlindTransferOptions), _end_jTapiBlindTransfer(etch.bindings.java.support.Mailbox)

_end_jTapiBlindTransfer

public final JTapi.JTapiBlindTransferResult _end_jTapiBlindTransfer(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiBlindTransfer. Transfers an established call on a monitored device to a new destination. None. JTapiBlindTransfer transfers an answered call, causing the call to be sent to a new destination elsewhere. Once the transfer has completed, the call is completely removed from the control of the application server. You can successfully use JTapiBlindTransfer only after the device has been answered. You can know in your application that the call has already been answered if the JTapiCallActive fires before you have used the JTapiBlindTransfer action.

Parameters:: mb - mailbox returned by _begin_jTapiBlindTransfer.
See Also:: RemoteJTapiServer.jTapiBlindTransfer(java.lang.String, java.lang.Long, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiBlindTransferOptions), _begin_jTapiBlindTransfer(java.lang.String, java.lang.Long, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiBlindTransferOptions)

_begin_jTapiDirectTransfer

public final etch.bindings.java.support.Mailbox _begin_jTapiDirectTransfer(java.lang.String sessionId,
                                                                           java.lang.Long firstCallId,
                                                                           java.lang.Long secondCallId,
                                                                           JTapi.JTapiDirectTransferOptions options)

Begins a call to jTapiDirectTransfer. Does a transfer between calls that exist on the same/different lines on a particular device. After a direct transfer, the common party(parties) on the device get dropped. JTapiDirectTransfer will transfer the parties from the SecondCall to the FirstCall.On completion of a JTapiDirectTransfer JTapiCallActive will get delivered to the other parties which were involved in FirstCall and SecondCall. The CallControlCause will be set to TRANSFER for the event. The associated party on the SecondCall will get a new CallID because of the transfer. Events due to a Direct Transfer on Same Line : Assume the following scenario 1. Line A on Device T1. 2. Line B1 on Device T2. 3. Line C on Device T3. Now A calls B1 and gets call id 1111. B1 gets CallID 2222. B1 calls C and gets call id 3333 while C gets call id 4444. Now invoke JtapiDirectTransfer(2222,3333) on T2. This will result in a call between A and C.B1 will get dropped from both the calls. A will receive JTapiCallActive with CallControlCause set to TRANSFER. Call ID 1111 will remain. C will receive JTapiHangup for 4444 with CallControlCause set to TRANSFER. This will be followed by JTapiCallActive with CallControlCause set to TRANSFER and a new call ID 5555. Events due to a Direct Transfer Across Lines : Assume the following scenario: 1. Line A on Device T1. 2. Lines B1 and B2 on Device T2. 3. Line C on Device T3. Now A calls B1 and gets call id 1111. B1 gets CallID 2222. B2 calls C and gets call id 3333 while C gets call id 4444. Now invoke JtapiDirectTransfer(2222,3333) on T2 This will result in a call between A and C.B1 and B2 will get dropped from both the calls. A will receive JTapiCallActive with CallControlCause set to TRANSFER. Call ID 1111 will remain. C will receive JTapiHangup for 4444 with CallControlCause set to TRANSFER. This will be followed by JTapiCallActive with CallControlCause set to TRANSFER and a new call ID 5555.

Parameters:: sessionId - The session Id for this method call; firstCallId - One of the two calls that have been established on the same line.This call leg for this callID will get dropped during transfer.; secondCallId - The second of the two calls that have been established on the same line or on the 2nd line on the same device.This call leg for this callID will get dropped during transfer.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiDirectTransfer.
See Also:: RemoteJTapiServer.jTapiDirectTransfer(java.lang.String, java.lang.Long, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiDirectTransferOptions), _end_jTapiDirectTransfer(etch.bindings.java.support.Mailbox)

_end_jTapiDirectTransfer

public final JTapi.JTapiDirectTransferResult _end_jTapiDirectTransfer(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiDirectTransfer. Does a transfer between calls that exist on the same/different lines on a particular device. After a direct transfer, the common party(parties) on the device get dropped. JTapiDirectTransfer will transfer the parties from the SecondCall to the FirstCall.On completion of a JTapiDirectTransfer JTapiCallActive will get delivered to the other parties which were involved in FirstCall and SecondCall. The CallControlCause will be set to TRANSFER for the event. The associated party on the SecondCall will get a new CallID because of the transfer. Events due to a Direct Transfer on Same Line : Assume the following scenario 1. Line A on Device T1. 2. Line B1 on Device T2. 3. Line C on Device T3. Now A calls B1 and gets call id 1111. B1 gets CallID 2222. B1 calls C and gets call id 3333 while C gets call id 4444. Now invoke JtapiDirectTransfer(2222,3333) on T2. This will result in a call between A and C.B1 will get dropped from both the calls. A will receive JTapiCallActive with CallControlCause set to TRANSFER. Call ID 1111 will remain. C will receive JTapiHangup for 4444 with CallControlCause set to TRANSFER. This will be followed by JTapiCallActive with CallControlCause set to TRANSFER and a new call ID 5555. Events due to a Direct Transfer Across Lines : Assume the following scenario: 1. Line A on Device T1. 2. Lines B1 and B2 on Device T2. 3. Line C on Device T3. Now A calls B1 and gets call id 1111. B1 gets CallID 2222. B2 calls C and gets call id 3333 while C gets call id 4444. Now invoke JtapiDirectTransfer(2222,3333) on T2 This will result in a call between A and C.B1 and B2 will get dropped from both the calls. A will receive JTapiCallActive with CallControlCause set to TRANSFER. Call ID 1111 will remain. C will receive JTapiHangup for 4444 with CallControlCause set to TRANSFER. This will be followed by JTapiCallActive with CallControlCause set to TRANSFER and a new call ID 5555.

Parameters:: mb - mailbox returned by _begin_jTapiDirectTransfer.
See Also:: RemoteJTapiServer.jTapiDirectTransfer(java.lang.String, java.lang.Long, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiDirectTransferOptions), _begin_jTapiDirectTransfer(java.lang.String, java.lang.Long, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiDirectTransferOptions)

_begin_jTapiParkCall

public final etch.bindings.java.support.Mailbox _begin_jTapiParkCall(java.lang.String sessionId,
                                                                     java.lang.Long callId,
                                                                     JTapi.JTapiParkCallOptions options)

Begins a call to jTapiParkCall. Parks a call currently active on a device. None. JTapiParkCall parks a call currently active on a device. A valid callID is passed as the argument. JTapiParkCall returns the parkDN(number of which the call is parked) in the result data. The event JTapiCallParked is also sent on successful parking. This event can further be used to trigger any other application. Any parked call can be unparked using JTapiMakeCall and passing the parkDN as the To parameter.A call when unparked results in a JTapiCallUnparked event.

Parameters:: sessionId - The session Id for this method call; callId - Indicates the call to be parked.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiParkCall.
See Also:: RemoteJTapiServer.jTapiParkCall(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiParkCallOptions), _end_jTapiParkCall(etch.bindings.java.support.Mailbox)

_end_jTapiParkCall

public final JTapi.JTapiParkCallResult _end_jTapiParkCall(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiParkCall. Parks a call currently active on a device. None. JTapiParkCall parks a call currently active on a device. A valid callID is passed as the argument. JTapiParkCall returns the parkDN(number of which the call is parked) in the result data. The event JTapiCallParked is also sent on successful parking. This event can further be used to trigger any other application. Any parked call can be unparked using JTapiMakeCall and passing the parkDN as the To parameter.A call when unparked results in a JTapiCallUnparked event.

Parameters:: mb - mailbox returned by _begin_jTapiParkCall.
See Also:: RemoteJTapiServer.jTapiParkCall(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiParkCallOptions), _begin_jTapiParkCall(java.lang.String, java.lang.Long, cisco.uc.cuae.legacy.JTapi.JTapiParkCallOptions)

_begin_jTapiGetCallForwardStatus

public final etch.bindings.java.support.Mailbox _begin_jTapiGetCallForwardStatus(java.lang.String sessionId,
                                                                                 java.lang.String deviceName,
                                                                                 java.lang.String directoryNumber,
                                                                                 JTapi.JTapiGetCallForwardStatusOptions options)

Begins a call to jTapiGetCallForwardStatus. Gets the call forward status of a line on a monitored device. JTapiGetCallForwardStatus gets the call forward status of a line on a monitored phone. If the action is successful, the CallForwardType result data parameter should be used to determine the status of the call forwarding status. If the CallForwardType indicates that the line has the forward condition Unconditional, then the Digits parameter can be used to determine which destination the line is currently forwarded to.

Parameters:: sessionId - The session Id for this method call; deviceName - The name of a controlled device from whose call forward status is queried. The DirectoryNumber action parameter must be a valid line number on this device.; directoryNumber - The line number on the device whose call forward status needs to be determined.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiGetCallForwardStatus.
See Also:: RemoteJTapiServer.jTapiGetCallForwardStatus(java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiGetCallForwardStatusOptions), _end_jTapiGetCallForwardStatus(etch.bindings.java.support.Mailbox)

_end_jTapiGetCallForwardStatus

public final JTapi.JTapiGetCallForwardStatusResult _end_jTapiGetCallForwardStatus(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiGetCallForwardStatus. Gets the call forward status of a line on a monitored device. JTapiGetCallForwardStatus gets the call forward status of a line on a monitored phone. If the action is successful, the CallForwardType result data parameter should be used to determine the status of the call forwarding status. If the CallForwardType indicates that the line has the forward condition Unconditional, then the Digits parameter can be used to determine which destination the line is currently forwarded to.

Parameters:: mb - mailbox returned by _begin_jTapiGetCallForwardStatus.
See Also:: RemoteJTapiServer.jTapiGetCallForwardStatus(java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiGetCallForwardStatusOptions), _begin_jTapiGetCallForwardStatus(java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiGetCallForwardStatusOptions)

_begin_jTapiGetAddressesOnTerminal

public final etch.bindings.java.support.Mailbox _begin_jTapiGetAddressesOnTerminal(java.lang.String sessionId,
                                                                                   java.lang.String deviceName,
                                                                                   JTapi.JTapiGetAddressesOnTerminalOptions options)

Begins a call to jTapiGetAddressesOnTerminal. Gets the LineDNs (addresses) mapped on the monitored device. JTapiGetAddressesOnTerminal gets the addresses mapped on a monitored phone. If the action is successful, the LineDNs result data parameter will contain the addresses (String Array of Address names) mapped on the device.

Parameters:: sessionId - The session Id for this method call; deviceName - The name of a monitored device whose addresses are being queried.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiGetAddressesOnTerminal.
See Also:: RemoteJTapiServer.jTapiGetAddressesOnTerminal(java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiGetAddressesOnTerminalOptions), _end_jTapiGetAddressesOnTerminal(etch.bindings.java.support.Mailbox)

_end_jTapiGetAddressesOnTerminal

public final JTapi.JTapiGetAddressesOnTerminalResult _end_jTapiGetAddressesOnTerminal(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiGetAddressesOnTerminal. Gets the LineDNs (addresses) mapped on the monitored device. JTapiGetAddressesOnTerminal gets the addresses mapped on a monitored phone. If the action is successful, the LineDNs result data parameter will contain the addresses (String Array of Address names) mapped on the device.

Parameters:: mb - mailbox returned by _begin_jTapiGetAddressesOnTerminal.
See Also:: RemoteJTapiServer.jTapiGetAddressesOnTerminal(java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiGetAddressesOnTerminalOptions), _begin_jTapiGetAddressesOnTerminal(java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiGetAddressesOnTerminalOptions)

_begin_jTapiGetActiveCalls

public final etch.bindings.java.support.Mailbox _begin_jTapiGetActiveCalls(java.lang.String sessionId,
                                                                           java.lang.String deviceName,
                                                                           java.lang.String lineDN,
                                                                           JTapi.JTapiGetActiveCallsOptions options)

Begins a call to jTapiGetActiveCalls. Gets the CallIDs active on the device. JTapiGetActiveCalls gets the active calls on a particular line on a monitored phone. If the action is successful, the CallIDs result data parameter will contain the call ids (String Array of call ids) active on the device or lineDN (address). These CallIDs can be used for other JTAPI operations like JTapiHold,JTapiStartMonitoring etc. Note: Both the LineDN and DeviceName need to be passed as arguments.

Parameters:: sessionId - The session Id for this method call; deviceName - The name of the device on which active calls are being queried.; lineDN - The directory number (address) on which active calls are being queried.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiGetActiveCalls.
See Also:: RemoteJTapiServer.jTapiGetActiveCalls(java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiGetActiveCallsOptions), _end_jTapiGetActiveCalls(etch.bindings.java.support.Mailbox)

_end_jTapiGetActiveCalls

public final JTapi.JTapiGetActiveCallsResult _end_jTapiGetActiveCalls(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiGetActiveCalls. Gets the CallIDs active on the device. JTapiGetActiveCalls gets the active calls on a particular line on a monitored phone. If the action is successful, the CallIDs result data parameter will contain the call ids (String Array of call ids) active on the device or lineDN (address). These CallIDs can be used for other JTAPI operations like JTapiHold,JTapiStartMonitoring etc. Note: Both the LineDN and DeviceName need to be passed as arguments.

Parameters:: mb - mailbox returned by _begin_jTapiGetActiveCalls.
See Also:: RemoteJTapiServer.jTapiGetActiveCalls(java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiGetActiveCallsOptions), _begin_jTapiGetActiveCalls(java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiGetActiveCallsOptions)

_begin_jTapiStartMonitoring

public final etch.bindings.java.support.Mailbox _begin_jTapiStartMonitoring(java.lang.String sessionId,
                                                                            java.lang.String targetCallId,
                                                                            java.lang.String targetDeviceName,
                                                                            java.lang.String targetLineDN,
                                                                            java.lang.String listenerLineDN,
                                                                            JTapi.JTapiStartMonitoringOptions options)

Begins a call to jTapiStartMonitoring. Starts monitoring the audio stream of an active call on a monitored device. JTapiStartMonitoring is supported only on Cisco Unified Communications Manager 6.0 and above. The monitoring target phone has to be a 3rd-generation phone, such as the 7911G, 7931G, 7941G, 7941G-GE, 7961G, 7961G-GE, 7970G, and 7971G-GE phone models. The built-in bridge must be turned 'ON' in the device configuration of the monitored target phone. JTapiStartMonitoring requires that the line indicated by TargetLineDN has the 'Monitoring Calling Search Space' configuration in Cisco Unified Communications Manager set to a value such that it can call the 'Route Partition' of the ListenerLineDN line. JTapiStartMonitoring will start monitoring a call on the specified destination specified by the combination of TargetDeviceName, TargetLineDN, and TargetCallId. The JTapiStartMonitoring action has two fundamentally different modes of operation. One mode causes the monitored audio stream to be sent to a physical device for human observation. If this is the desired behavior for the application, then one should specify ListenerDeviceName and ListenerLineDN to indicate which line on which device should be called. The ListenerDevicePool has no use and should be left unspecified in this mode of operation. The other mode causes the audio stream to be sent to a destination of the choosing of the application, as specified by RxIP and RxPort. If instead this is the desired behavior for the application, then one must set ListenerDevicePool to indicate to the application server which pool of CTI ports should be used to control the destination of the audio stream. With the second mode, the stream could be sent to a recording server, a Cisco IP Phone that's been told to listen on a specific port using XSI commands, or a previously provisioned media engine connection. Finally, one should not set ListenerDeviceName and ListenerLineDN if using the second mode. If specifying ListenerDevicePool so that the audio stream destination can be controlled, then this device pool should have as many CTI Ports configured within it as the maximum concurrent amount of monitors expected with JTapiStartMonitoring. In other words, one CTI Port will be used during the lifetime of a monitor. Note that the device pool described here is configured within the mceadmin web interface; this is not the device pool configured within Cisco Unified Communications Manager. The CallId result data parameter is the unique identifier for this call. All Call Control API actions and events use CallId, so practically the application developers almost always stores this CallId value in a variable for the use in subsequent Call Control operations. This CallId should not be considered unique across multiple application servers. The monitor will be stopped permanently if the JTapiCallInactive or JTapiHangup event occurs.

Parameters:: sessionId - The session Id for this method call; targetCallId - The call ID of the call that will be monitored.; targetDeviceName - The device name of a JTAPI-controlled device that has associated with it the TargetLineDN.; targetLineDN - The monitoring target directory number to initiate the monitor on. The RX and TX audio will be mixed by the TargetDeviceName, and will be sent to either the ListenerLineDN, or to RxIP:RxPort, depending on usage of those action parameters.; listenerLineDN - The line number that should receive the monitor call. If specified, also specify ListenerDeviceName, but do not specify ListenerDevicePool. In Cisco Unified Communications Manager, the 'Route Partition' on this line must be callable by the 'Monitoring Calling Search Space' defined on the TargetLineDN line.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiStartMonitoring.
See Also:: RemoteJTapiServer.jTapiStartMonitoring(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiStartMonitoringOptions), _end_jTapiStartMonitoring(etch.bindings.java.support.Mailbox)

_end_jTapiStartMonitoring

public final JTapi.JTapiStartMonitoringResult _end_jTapiStartMonitoring(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiStartMonitoring. Starts monitoring the audio stream of an active call on a monitored device. JTapiStartMonitoring is supported only on Cisco Unified Communications Manager 6.0 and above. The monitoring target phone has to be a 3rd-generation phone, such as the 7911G, 7931G, 7941G, 7941G-GE, 7961G, 7961G-GE, 7970G, and 7971G-GE phone models. The built-in bridge must be turned 'ON' in the device configuration of the monitored target phone. JTapiStartMonitoring requires that the line indicated by TargetLineDN has the 'Monitoring Calling Search Space' configuration in Cisco Unified Communications Manager set to a value such that it can call the 'Route Partition' of the ListenerLineDN line. JTapiStartMonitoring will start monitoring a call on the specified destination specified by the combination of TargetDeviceName, TargetLineDN, and TargetCallId. The JTapiStartMonitoring action has two fundamentally different modes of operation. One mode causes the monitored audio stream to be sent to a physical device for human observation. If this is the desired behavior for the application, then one should specify ListenerDeviceName and ListenerLineDN to indicate which line on which device should be called. The ListenerDevicePool has no use and should be left unspecified in this mode of operation. The other mode causes the audio stream to be sent to a destination of the choosing of the application, as specified by RxIP and RxPort. If instead this is the desired behavior for the application, then one must set ListenerDevicePool to indicate to the application server which pool of CTI ports should be used to control the destination of the audio stream. With the second mode, the stream could be sent to a recording server, a Cisco IP Phone that's been told to listen on a specific port using XSI commands, or a previously provisioned media engine connection. Finally, one should not set ListenerDeviceName and ListenerLineDN if using the second mode. If specifying ListenerDevicePool so that the audio stream destination can be controlled, then this device pool should have as many CTI Ports configured within it as the maximum concurrent amount of monitors expected with JTapiStartMonitoring. In other words, one CTI Port will be used during the lifetime of a monitor. Note that the device pool described here is configured within the mceadmin web interface; this is not the device pool configured within Cisco Unified Communications Manager. The CallId result data parameter is the unique identifier for this call. All Call Control API actions and events use CallId, so practically the application developers almost always stores this CallId value in a variable for the use in subsequent Call Control operations. This CallId should not be considered unique across multiple application servers. The monitor will be stopped permanently if the JTapiCallInactive or JTapiHangup event occurs.

Parameters:: mb - mailbox returned by _begin_jTapiStartMonitoring.
See Also:: RemoteJTapiServer.jTapiStartMonitoring(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiStartMonitoringOptions), _begin_jTapiStartMonitoring(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiStartMonitoringOptions)

_begin_jTapiSendXSIData

public final etch.bindings.java.support.Mailbox _begin_jTapiSendXSIData(java.lang.String sessionId,
                                                                        java.lang.String deviceName,
                                                                        java.lang.String xSIData,
                                                                        JTapi.JTapiSendXSIDataOptions options)

Begins a call to jTapiSendXSIData. Send XSI data to a monitored phone. JTapiSendXSIData and SendExecute both allow one to send an XSI command to an IP Phone. To help determine which one is more appropriate, consider the following points: The SendExecute action requires an IP address to send the XML command to using an HTTP POST. However, it is a common problem to not have the IP address of a Cisco IP phone readily available, although often one has the device name (of the form SEPXXXXXXXXXXXX) of the phone. While it is possible that one can use the Cisco DeviceListX cache to determine IP address of a Cisco IP Phone based on this device name, with JTapiSendXSIData only the phone device name is needed. SendExecute sends an HTTP request from the application server directly to the phone; whereas JTapiSendXSIData instructs Cisco Unified Communications Manager to send the command via the phone's transport protocol. Because of this difference, the JTapiSendXSIData command is generally more robust when one considers firewalls and security policies. For instance, because IP Communicator runs on the personal computer of an end user, it is possible that the user has a firewall running on that machine. Also, in some Cisco Unified Communication Manager deployments, it is possible that the internal web server on the IP Phone has been turned off, rendering SendExecute useless. When SendExecute is executed, the IP phone will request from its configured 'Authentication URL' whether the username and password sent to the phone is valid. By default, this request is sent to the Cisco Unified Communications Manager publisher node, which makes this determination by checking that specified credentials match the credentials of a user associated with the phone in the Cisco Unified Communications Manager database. In contrast, with JTapiSendXSIData, super user credentials can be used to send commands to any phone, without having to know the enduser associated with that phone. This action communicates with the Cisco IP Phone using the phone's protocol (SCCP or SIP) as the transport. JTapiSendXSIData will send XSI data to the monitored phone. A maximum of 2000 bytes can be sent to the phone. JTapiSendXSIData is supported in Cisco Unified Communications Manager 5.0 and above. JTapiSendXSIData can send two distinctly different commands to the Cisco IP Phone. One type of command is the Execute XML object, which is used to cause the phone to execute internal commands, such as RTPRx or Dial, or to cause the phone to fetch IP Phone XML from an HTTP server. JTapiSendXSIData can also used to send content-based XML objects, such as a Text or Menu XML object. The Cisco IP Phones have an important limitation in that one can only push 2000 bytes of content to the phone. This effectively means that pushing a Execute XML object to a phone is the more robust way to have the phone render large amounts of data, instead of pushing a potentially large content-based XML object, such as Text or Menu. With an Execute XML object, one can send an HTTP-based URI that will server out the content-based XML, circumventing the 2000 byte 'push' limitation. There is no 2000 byte limitation when the phone makes a request to a HTTP-based URI.

Parameters:: sessionId - The session Id for this method call; deviceName - The name of a controlled device which will be sent the XSI command.; xSIData - The XSI object to be pushed to the monitored device. The object can not be directly passed in to this parameter. Instead, one must invoke the ToString() method on the object, and the resulting string must be passed in.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiSendXSIData.
See Also:: RemoteJTapiServer.jTapiSendXSIData(java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiSendXSIDataOptions), _end_jTapiSendXSIData(etch.bindings.java.support.Mailbox)

_end_jTapiSendXSIData

public final JTapi.JTapiSendXSIDataResult _end_jTapiSendXSIData(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiSendXSIData. Send XSI data to a monitored phone. JTapiSendXSIData and SendExecute both allow one to send an XSI command to an IP Phone. To help determine which one is more appropriate, consider the following points: The SendExecute action requires an IP address to send the XML command to using an HTTP POST. However, it is a common problem to not have the IP address of a Cisco IP phone readily available, although often one has the device name (of the form SEPXXXXXXXXXXXX) of the phone. While it is possible that one can use the Cisco DeviceListX cache to determine IP address of a Cisco IP Phone based on this device name, with JTapiSendXSIData only the phone device name is needed. SendExecute sends an HTTP request from the application server directly to the phone; whereas JTapiSendXSIData instructs Cisco Unified Communications Manager to send the command via the phone's transport protocol. Because of this difference, the JTapiSendXSIData command is generally more robust when one considers firewalls and security policies. For instance, because IP Communicator runs on the personal computer of an end user, it is possible that the user has a firewall running on that machine. Also, in some Cisco Unified Communication Manager deployments, it is possible that the internal web server on the IP Phone has been turned off, rendering SendExecute useless. When SendExecute is executed, the IP phone will request from its configured 'Authentication URL' whether the username and password sent to the phone is valid. By default, this request is sent to the Cisco Unified Communications Manager publisher node, which makes this determination by checking that specified credentials match the credentials of a user associated with the phone in the Cisco Unified Communications Manager database. In contrast, with JTapiSendXSIData, super user credentials can be used to send commands to any phone, without having to know the enduser associated with that phone. This action communicates with the Cisco IP Phone using the phone's protocol (SCCP or SIP) as the transport. JTapiSendXSIData will send XSI data to the monitored phone. A maximum of 2000 bytes can be sent to the phone. JTapiSendXSIData is supported in Cisco Unified Communications Manager 5.0 and above. JTapiSendXSIData can send two distinctly different commands to the Cisco IP Phone. One type of command is the Execute XML object, which is used to cause the phone to execute internal commands, such as RTPRx or Dial, or to cause the phone to fetch IP Phone XML from an HTTP server. JTapiSendXSIData can also used to send content-based XML objects, such as a Text or Menu XML object. The Cisco IP Phones have an important limitation in that one can only push 2000 bytes of content to the phone. This effectively means that pushing a Execute XML object to a phone is the more robust way to have the phone render large amounts of data, instead of pushing a potentially large content-based XML object, such as Text or Menu. With an Execute XML object, one can send an HTTP-based URI that will server out the content-based XML, circumventing the 2000 byte 'push' limitation. There is no 2000 byte limitation when the phone makes a request to a HTTP-based URI.

Parameters:: mb - mailbox returned by _begin_jTapiSendXSIData.
See Also:: RemoteJTapiServer.jTapiSendXSIData(java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiSendXSIDataOptions), _begin_jTapiSendXSIData(java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiSendXSIDataOptions)

_begin_jTapiNonTriggeringSubscribe

public final etch.bindings.java.support.Mailbox _begin_jTapiNonTriggeringSubscribe(java.lang.String sessionId,
                                                                                   java.lang.String deviceName,
                                                                                   java.lang.String devicePoolName,
                                                                                   JTapi.DeviceType deviceType,
                                                                                   JTapi.JTapiNonTriggeringSubscribeOptions options)

Begins a call to jTapiNonTriggeringSubscribe. Registers a device with JTAPI. The JTapiNonTriggeringSubscribe action is a way for an application to register a device at application run-time. However, one can also specify devices for permanent JTAPI registration via the mceadmin web interface. he following information is meant to help determine if you should use the mceadmin 'static' mechanism, or the JTapiNonTriggeringSubscribe dynamic mechanism: if you know that you need to always monitor a phone in order to catch certain interesting events which occur non-deterministically, then use the static mechanism available via mceadmin. If instead you only need to monitor a phone for a specific, deterministic amount of time, then this dynamic mechanism is probably more ideal because there is a maximum number of concurrent JTAPI registrations possible for a given Cisco Unified Communications Manager cluster. By registering a device only as you need it, an application which does not have extremely high usage patterns could help keep the total number of registrations below this maximum concurrent amount, but still be able to control any device in the deployment as needed. If the application server is restarted, then all registrations created via JTapiNonTriggeringSubscribe will be lost and are not automatically re-created upon startup of the application server. JTapiNonTriggeringSubscribe will register a device dynamically. The specific Cisco Unified Communications Manager node to which the device is registered is decided by the specified DevicePoolName, which is described in mceadmin. Note that the device pool described by DevicePoolName is a Cisco Unified Application Environment configuration; it is completely distinct from device pools as defined by Cisco Unified Communications Manager. If a device has successfully been registered with JTapiNonTriggeringSubscribe, then later that device can be unregistered with JTapiUnsubscribe.

Parameters:: sessionId - The session Id for this method call; deviceName - The device name of the device to be registered.; devicePoolName - The device pool to which this device should be placed in. This device pool is configured in the mceadmin web interface, and does not correspond to device pools as defined by Cisco Unified Communications Manager.; deviceType - The device type of the device. This must currently be set to CtiMonitored in all situations.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiNonTriggeringSubscribe.
See Also:: RemoteJTapiServer.jTapiNonTriggeringSubscribe(java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.DeviceType, cisco.uc.cuae.legacy.JTapi.JTapiNonTriggeringSubscribeOptions), _end_jTapiNonTriggeringSubscribe(etch.bindings.java.support.Mailbox)

_end_jTapiNonTriggeringSubscribe

public final JTapi.JTapiNonTriggeringSubscribeResult _end_jTapiNonTriggeringSubscribe(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiNonTriggeringSubscribe. Registers a device with JTAPI. The JTapiNonTriggeringSubscribe action is a way for an application to register a device at application run-time. However, one can also specify devices for permanent JTAPI registration via the mceadmin web interface. he following information is meant to help determine if you should use the mceadmin 'static' mechanism, or the JTapiNonTriggeringSubscribe dynamic mechanism: if you know that you need to always monitor a phone in order to catch certain interesting events which occur non-deterministically, then use the static mechanism available via mceadmin. If instead you only need to monitor a phone for a specific, deterministic amount of time, then this dynamic mechanism is probably more ideal because there is a maximum number of concurrent JTAPI registrations possible for a given Cisco Unified Communications Manager cluster. By registering a device only as you need it, an application which does not have extremely high usage patterns could help keep the total number of registrations below this maximum concurrent amount, but still be able to control any device in the deployment as needed. If the application server is restarted, then all registrations created via JTapiNonTriggeringSubscribe will be lost and are not automatically re-created upon startup of the application server. JTapiNonTriggeringSubscribe will register a device dynamically. The specific Cisco Unified Communications Manager node to which the device is registered is decided by the specified DevicePoolName, which is described in mceadmin. Note that the device pool described by DevicePoolName is a Cisco Unified Application Environment configuration; it is completely distinct from device pools as defined by Cisco Unified Communications Manager. If a device has successfully been registered with JTapiNonTriggeringSubscribe, then later that device can be unregistered with JTapiUnsubscribe.

Parameters:: mb - mailbox returned by _begin_jTapiNonTriggeringSubscribe.
See Also:: RemoteJTapiServer.jTapiNonTriggeringSubscribe(java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.DeviceType, cisco.uc.cuae.legacy.JTapi.JTapiNonTriggeringSubscribeOptions), _begin_jTapiNonTriggeringSubscribe(java.lang.String, java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.DeviceType, cisco.uc.cuae.legacy.JTapi.JTapiNonTriggeringSubscribeOptions)

_begin_jTapiUnsubscribe

public final etch.bindings.java.support.Mailbox _begin_jTapiUnsubscribe(java.lang.String sessionId,
                                                                        java.lang.String deviceName,
                                                                        JTapi.JTapiUnsubscribeOptions options)

Begins a call to jTapiUnsubscribe. Unregisters a device with JTAPI. None JTapiUnsubscribe will unregister a device previously successfully registered with JTapiNonTriggeringSubscribe.

Parameters:: sessionId - The session Id for this method call; deviceName - The device name of the device to be unregistered.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiUnsubscribe.
See Also:: RemoteJTapiServer.jTapiUnsubscribe(java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiUnsubscribeOptions), _end_jTapiUnsubscribe(etch.bindings.java.support.Mailbox)

_end_jTapiUnsubscribe

public final JTapi.JTapiUnsubscribeResult _end_jTapiUnsubscribe(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiUnsubscribe. Unregisters a device with JTAPI. None JTapiUnsubscribe will unregister a device previously successfully registered with JTapiNonTriggeringSubscribe.

Parameters:: mb - mailbox returned by _begin_jTapiUnsubscribe.
See Also:: RemoteJTapiServer.jTapiUnsubscribe(java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiUnsubscribeOptions), _begin_jTapiUnsubscribe(java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiUnsubscribeOptions)

_begin_jTapiGetDeviceStatus

public final etch.bindings.java.support.Mailbox _begin_jTapiGetDeviceStatus(java.lang.String sessionId,
                                                                            java.lang.String deviceName,
                                                                            JTapi.JTapiGetDeviceStatusOptions options)

Begins a call to jTapiGetDeviceStatus. Gets the device status of a phone using JTAPI. JTapiGetDeviceStatus gets the device status of a monitored phone using JTAPI.

Parameters:: sessionId - The session Id for this method call; deviceName - The name of a controlled device to query.; options - An object holding all the optional parameters
Returns:: mailbox used to retrieve the result using _end_jTapiGetDeviceStatus.
See Also:: RemoteJTapiServer.jTapiGetDeviceStatus(java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiGetDeviceStatusOptions), _end_jTapiGetDeviceStatus(etch.bindings.java.support.Mailbox)

_end_jTapiGetDeviceStatus

public final JTapi.JTapiGetDeviceStatusResult _end_jTapiGetDeviceStatus(etch.bindings.java.support.Mailbox mb)

Ends a call to jTapiGetDeviceStatus. Gets the device status of a phone using JTAPI. JTapiGetDeviceStatus gets the device status of a monitored phone using JTAPI.

Parameters:: mb - mailbox returned by _begin_jTapiGetDeviceStatus.
See Also:: RemoteJTapiServer.jTapiGetDeviceStatus(java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiGetDeviceStatusOptions), _begin_jTapiGetDeviceStatus(java.lang.String, java.lang.String, cisco.uc.cuae.legacy.JTapi.JTapiGetDeviceStatusOptions)