12.2. Additional API Restrictions in an R4 on DM3 Fixed Routing Configuration

The following restrictions apply to DM3 fixed routing configurations only.

NOTE:

Except where explicitly stated, these restrictions are in addition to those described for the DM3 flexible routing configuration.

The following areas are restricted or not supported when using a DM3 fixed routing configuration:

• SCbus voice resource routing is not supported
• SCbus fax resource routing restricted
• Voice, Fax, and GlobalCall resource/device management restricted

Table 19. List of Additional API Functions Restricted and Not Supported in a DM3 Fixed Routing Configuration

Function Name	Notes
dx_close( )	Limitations: Although dx_open( ) and dx_close( ) are operational on DM3 voice devices, their purpose is extremely limited by nature of the voice resource membership in a DM3 cluster. (Instead, you must use the gc_OpenEx( ), gc_GetVoiceH( ), and gc_Close( ) functions.)
dx_getxmitslot( )	Not supported. The function fails with error code EDX_SH_MISSING, indicating "Switching Handler is not present".
dx_listen( )	Not supported. The function fails with error code EDX_SH_MISSING, indicating "Switching Handler is not present".
dx_open( )	Limitations: Although dx_open( ) and dx_close( ) are operational on DM3 voice devices, their purpose is extremely limited by nature of the voice resource membership in a DM3 cluster. (Instead, you must use the gc_OpenEx( ), gc_GetVoiceH( ), and gc_Close( ) functions.)
dx_unlisten( )	Not supported. The function fails with error code EDX_SH_MISSING, indicating "Switching Handler is not present".
fx_close( )	Limitations: See fx_open( ).
fx_getxmitslot( )	Not supported. The function fails with error code EDX_SH_MISSING, indicating "Switching Handler is not present".
fx_listen( )	Not supported. The function fails with error code EDX_SH_MISSING, indicating "Switching Handler is not present".
fx_open( )	Limitations: The following additional limitations apply to fax resources in a DM3 fixed routing configuration. Because of the fax resource membership in a DM3 cluster, the voice and fax devices are automatically associated with a network interface device. Therefore, it is recommended that you do the following to retrieve and use the fax device handle:   Use gc_Open( ) to open the network interface line device.   Use gc_GetVoiceH( ) to retrieve the voice device handle.   Use ATDV_NAMEP( ) to retrieve the voice device name for the voice device handle returned by the gc_GetVoiceH( ) function.   Use fx_open( ) on this voice device name to open the associated fax device and retrieve the fax device handle. The function will succeed if the channel device has fax capabilities; otherwise the function will fail.   Use fx_close( ) to close the fax device.
fx_unlisten( )	Not supported. The function fails with error code EDX_SH_MISSING, indicating "Switching Handler is not present".
gc_Attach( )	Not supported. See Section 12.3.2. Associating Network and Voice Devices (Fixed Routing) for more information.
gc_Detach( )	Not supported. See Section 12.3.2. Associating Network and Voice Devices (Fixed Routing) for more information.
gc_Open( )	Limitations: See Sections 12.3.1. gc_Open( ) and gc_OpenEx( ) Restrictions (Fixed Routing), 12.3.2. Associating Network and Voice Devices (Fixed Routing), and 12.4.2. Getting, Using, and Closing Device Handles in a DM3 Fixed Routing Configuration for more information.
gc_OpenEx( )	Limitations: See Sections 12.3.1. gc_Open( ) and gc_OpenEx( ) Restrictions (Fixed Routing), 12.3.2. Associating Network and Voice Devices (Fixed Routing), and 12.4.2. Getting, Using, and Closing Device Handles in a DM3 Fixed Routing Configuration for more information.
nr_scroute( )	Limitations: Does not support voice, fax, analog network interface devices (LSI), or MSI devices. Supports DTI devices only.
nr_scunroute( )	Limitations: Does not support voice, fax, analog network interface devices (LSI), or MSI devices. Supports DTI devices only.

Click here to contact Dialogic Customer Engineering