Dial Runtime Properties

CallingName

(Channel as Integer)String

(ISDN only)

This property sets the name to be sent as the Originating Party Name for an outgoing call. The maximum length of the name is 16 characters.

CallingNumber

(Channel as Integer)String

This property sets the Originating Party Number for an outgoing call. This property is only applicable on selected protocols, which are supported by the Dialogic GlobalCall library. Please refer to the GlobalCall Technology User's Guide from Dialogic for more information. 

CallResult

(Channel as Integer)Integer

This property contains the result of the last dial operation on the speci�fied channel. It uses the vbvCallResultConstants:

1. vbvNoDialTone(27)

2. vbvFastBusy(28)

3. vbvBusy(29)

4. vbvNoAnswer(30)

5. vbvNoRing(31)

6. vbvConnected(32)

7. vbvIntercept(33)

8. vbvAnsMachine (36)

9. vbvFaxAnswer(47)

10. vbvNetTimeout(57)

11. vbvTransferRejected(100)

12. vbvTransferTimeout (101)

13. vbvTransferSucceeded = vbvConnected (32)

If a call result is returned from the voice card that is not represented by the standard return codes above, the CallResult property will contain a negative return code and the call will exit out of the Other node. This allows VB code to provide custom processing for specific conditions.

For example, to detect fax machines, the code in the Exit event may check for a result value of CallResult = -18 (fax tone detected) and use the TakeCall method to move the call to an appropriate handler. (Please note that CallResult = -18 may not work on ISDN).

Private Sub Dial1_Exit(ByVal channel As Integer, Node As Integer)

Dim res As Integer

res = Dial1.CallResult(channel)

If res = -18 Then

Fax tone detected process it

SendFax1.TakeCall(channel)

End If

End Sub

When using ISDN, the CallResult property returns the ISDN Cause parameter, as defined in the Q.931 specification. For a failing call, the CallResult is set to a negated value of the cause. For example, if an outgoing call is rejected by the destination device (ISDN cause 21), CallResult will be set to -21.

The table below lists possible cause values as defined in the specification. Please note that not all cause values are universally supported across switch types. Before a particular cause value is used, its validity should be compared with the appropriate switch vendor specs.

Possible cause values:

For Dialogic T1 cards only:

If you need to connect the T1 call when a fax tone is detected (CallResult = -18), the Call Progress will not detect a hang-up unless DetectDisconnectWhileOffhook=1 (default is 0) in [VoiceCard] section of VBVOICE.INI file.

[VoiceCard]
DetectDisconnectWhileOffhook=1 ;Call Progress enabled

CallTime

(Channel as Integer)String

This property contains a formatted string containing the start time of the last call. The string is formatted as mm/dd/yy hh:mm using a 24-hour clock. It is useful when creating call logs using the Dial Log option.

DestinationAddress

(Channel as Integer) String

(Dialogic VoIP only. )

It sets the DestinationAddress of the H225 setup message to be sent by the Dial control, on a per call basis.

It should be used in the Enter event of Dial control.

DurationOfAnswer

(Channel as Integer) Long

(Not supported by HMP, not recommended as it is supported by few cards)

If answering machine detection is disabled, this property contains the duration of the answer, in milliseconds, that occurs as a result of tone call analysis. An answer is considered the period of non-silence that begins after cadence is broken.

The duration of the answer can be used to determine whether the call was answered by a person or an answering machine: it returns 0 when answering machine detection is enabled. It should be used in the Exit event of the Dial control.

For digital protocols the tones call analysis is active only if the fax tone detection is enabled.

EXAMPLE

Private Sub Dial1_Exit(ByVal channel As Integer, Node As Integer)

Dim answerDur As Long

answerDur = Dial1.DurationOfAnswer(channel)

If answerDur > 3200 Then assume its an answering machine

PlayGreeting1.TakeCall channel

End If

End Sub

NumToDial

(Channel as Integer) String

The dialed number is recalculated for each call if it contains control names. The NumToDial property makes this number available to VB code in the Enter event, for reading or updating. When a new number is set in the Enter event , the number is only changed for that call. See Configuring Dial Strings section above.

EXAMPLES

To access the number:

Dim actualnumber as String

actualnumber = Dial1.NumToDial(channel)

To override the predefined number with your own:

Dial1.NumToDial(channel) = "6138390033"

max string length is 64 characters

For HMP, the type of call depends on the number to be dialled. If the @ character is found in the number to be dialled, a SIP call is initiated, otherwise a H.323 call is initiated.

EXAMPLE

For SIP:

Dial1.NumToDial = "Suser@192.168.0.2"

This initiates a SIP call to sip:user@192.168.0.2

For H.323:

Dial1.NumToDial = "S192.168.0.2"

This initiates a H.323 call to 192.168.0.2.

NoAnswer

(Channel as Integer)Integer

Analog: This property sets the time in seconds to wait for the call to be answered after the first ring; if that time has elapsed and the call has not been answered the control would exit through the NoAnswer node. This is for Dialogic cards only.

Digital: This property sets the time in seconds to wait for the call to be answered after the call was initiated; if that time has elapsed and the call has not been answered the control would exit through the NoAnswer node.

GotoNode

(Integer)

This property will transfer a call to another control. See GotoNode.

SecondTransferChannel

(Channel as Integer) Integer

Set a channel to be used as an auxiliary line for transfer. Applicable only to ISDN transfers.

TransferType

(Channel as Integer) vbvTransferTypeConstants

(Applicable only to ISDN and HMP transfers.)

Set the type of transfer to be performed.

Read more about Dial control.