4.2.6. gc_OpenEx( )

Global Call device naming conventions apply to SS7 telephony devices. The protocol name to use is SS7. A voice device name may be specified, in which case this device will be opened and its handle will be available through the gc_GetVoiceH( ) function. An application should use the following device name format:

     N_network_device_name:P_SS7:V_voice_device_name  

See the Global Call API Library Reference for more on the device name format.

If the circuit resides on a DM3 board, the devicename string should include the additional :L_SS7 component. This may also be used for other network interfaces controlled by Global Call SS7 but must be specified for DM3 network interfaces. The format of the devicename string therefore becomes:

     :L_SS7:N_network_device_name:P_SS7:V_voice_device_name  

The result of specifying a voice device name in the Global Call device name given to gc_OpenEx( ) is the same as opening the voice device separately, using dx_open( ), and then performing a gc_Attach( ). This means that a voice device opened as part of a Global Call line device can later be detached from the line device using gc_Detach( ). A voice device that has been opened together with a Global Call line device but that has later been detached from it is not closed during the corresponding gc_Close( ).

The network device that is specified is the physical time slot where the voice circuit is located. This is completely independent of the signaling path. The latter need only be specified in the configuration of the system. The circuit time slot can reside on a Intel® Dialogic network interface board (D/240SC-T1, D/300SC-E1, D/480SC-2T, and so on) or on a PCCS6 board.

For an Intel® Dialogic interface board, the standard device names are used: dtiBxTy where x is the logical board number and y is the logical circuit number (from 1 to the number of circuit on the trunk, no gaps are left for unused time slots or time slots used for signaling).

For a PCCS6 board, the devices names used are: dkBxTy where x is 1 for the first trunk of the board and 2 for the second trunk (if present) and y is the logical circuit number (same as for DTI boards).

Note: In this release of the software, trunk device (for example,dtiB1) may not be opened for SS7.

As part of executing gc_OpenEx( ), Global Call SS7 will start initializing the circuit. The application must wait for a GCEV_UNBLOCKED event to be received before it can start using the opened line device.

Click here to contact Telecom Support Resources