3.1.15. gc_OpenEx( )

The format of the fields used to specify the devicename parameter is as follows:

  :P_H323_NTSC:N_iptBxTy:M_ipmBxCy:V_dxxxBwCz 

The prefixes (P_, N_, M_, and V_) are used for parsing purposes. These fields may appear in any order. The conventions described below allow the Global Call API to map subsequent calls made on specific line devices or CRNs to interface-specific libraries. The fields within the devicename parameter must each begin with a colon.

The meaning of each field in the devicename parameter is as follows:

• P_H323_NTSC: Specifies that Global Call should use the H.323 embedded stack protocol. This field is mandatory.
• N_iptBxTy: Specifies the name of the IP network device. Bx and Ty represents the logical board and logical channel assigned by the user. When using Global Call with a DM3 board that uses an embedded stack, the range of logical channel numbers depends on the type of PSTN interface on the board (E-1 or T-1) and the number spans. For example, for a board with an E-1 interface and one span, the range of IP logical channels is 1 to 30. For a board with an E-1 interface and two spans, the range of IP logical channels is 1 to 60. When specifying an IP network device, it is recommended that an IP Media channel (M_ipmBxCx) be specified also.
• M_ipmBxCy: Specifies the name of the IP Media channel to be associated with the IP network device being opened. This field should be specified when the IP network device (N_iptBxTy) field is specified.
• V_dxxxBwCz: Specifies a voice resource. Bw and Cz are the voice board and channel number respectively. This field is optional.

  Note: The voice device should only be specified when using firmware downloads that support exportable voice resources, that is, the .pcd file for the firmware download has "_evr_" in the file name. When using a firmware download that does not support exportable voice resources, an error is generated if the voice device is specified since the voice device cannot be automatically routed.

The gc_OpenEx( ) function can also be used to open a board device. This function is useful since it allows the use of the ATDV_SUBDEVS( ) function to retrieve the number of subdevices for the board device. In this context, the devicename parameter has the following format:

  :P_H323_NTSC:N_iptBx 

In other technologies, a board device can be used for alarms. However, the use of an iptBx board device for alarms is not supported.

Notes:

1. When using Global Call with a DM3 board that uses an embedded stack, each IP Media device is preallocated (bound) to a specific network device, for example, iptB1T1 is bound to ipmB1C1, iptB1T2 is bound to ipmB1C2, etc.
2. The IP address corresponding to the network interface is configured at firmware download time. For Windows systems, this is done using the Dialogic Configuration Manager (DCM).

Click here to contact Telecom Support Resources