Overview

The ResourceGroup is used to collect voice/fax resources into a group for allocation purposes. When a resource is required, it is allocated out of a specified group.

Each group may be used for a different purpose. For example, group A may be reserved for incoming calls, whereas group B may be used for station sets. Resources can be added at design time or added by code dependent on the application's requirements at runtime.

When the first ResourceGroup control is placed on a VBVFrame control, all available voice/fax resources will be listed in the list box of Available Resources. If the listbox of Available Resources is empty, it means that there are no more voice/fax resources available - either none were found or they have all been allocated to other groups.

Resource Types

A telephony board typically contains both interface resources and voice resources. The voice resources are used during calls for:

1. Processing tones (such as ringing and DTMF tones)

2. Playing and recording audio

3. TTS and speech recognition (ASR)

Analog and T1 robbed-bit interfaces require a voice resource to wait for a call. ISDN interfaces do not.

Putting voice resources in a ResourceGroup does not detach them from their interface channels. Only when a GetResource control is executed is the voice resource detached, causing its interface channel to lose the abilities described above.

Another type of telephony card is the resource board, containing only voice resources. These can also be used by the ResourceGroup control.

(voice)

A voice resource with the suffix (voice) is associated with a digital or MSI channel.

(analog + voice)

A voice resource with the suffix (analog + voice) means that it is associated with an analog line.

(Dialogic cards only) The analog line will be unavailable for the duration that the corresponding voice resource is in use by another interface. This means that if a call arrives on that analog line while its corresponding voice resource is unavailable, the call will keep ringing and will not be answered until its voice resource is freed.

(fax)

A fax resource with the suffix (fax) means that it can be dynamically allocated and its associated interface channel.

Compatibility

A specific resource can only be in one group at the same time.

If a channel requires a resource for any reason, and one is not allocated, the call will be disconnected.

Runtime Properties

IsResourceFree

(SourceChannel as Integer) Boolean

Returns the status of resource channel: TRUE: if free, FALSE: if in use.

NumOfResourcesInGroup

Integer

Returns the number of resources in the group.

NumOfFreeResourcesInGroup 

Integer

Returns the number of free resources in the group.

ResourceChannel

(Channel as Integer)Integer

Returns the resource channel associated with the specified interface channel. If there is no resource currently associated with the channel (such as a station set which did not use GetResource), an error will occur.

Methods

AddVoiceResource

AddVoiceResource(ByVal ResourceChannel)

Add the specified voice/fax resource channel into the current resource group. An error occurs if the resource is not available, error code 3031.

RemoveVoiceResource

RemoveVoiceResource(ByVal ResourceChannel)

Remove the specified resource channel from the current resource group. An error occurs if the resource is not in the group, error code 3032.

Setup Property Page