gl_route( )

Description | Example | Errors

Name:	int gl_route (int bddev, int chan, int tslot)
Inputs:	int bddev	Purpose: Unused - for compatibility with Dialogic software. Range: Must be -1.
	int chan	Purpose: Specifies logical fax channel. Range: 1 -- 60, inclusive.
	int tslot	Purpose: Specifies transmit and receive PEB timeslot. Range: 1 -- 30, inclusive, for E1, 1 -- 24, inclusive, for T1 to connect a timeslot to the fax channel, -1 to disconnect the timeslot of the fax channel.
Returns:	0	Success.
	-1	Error.
Includes:	gfpeb.h

Description

The gl_route( ) function connects and disconnects fax channel to PEB timeslot.

The gl_route function establishes or removes a connection between a logical fax channel and a PEB timeslot. The timeslot is used by the fax channel for both transmitting to and receiving from the PEB. If gl_route( ) is called to establish a connection and the fax channel is already connected to a PEB timeslot, the existing connection will be removed before the specified connection is established.

If gl_route( ) is called to remove a connection and no connection currently exists between the fax channel and a PEB timeslot, gl_route( ) will return an indication of success.

Example

#include "gfpeb.h"  
int faxchan, status;  
/* disconnect faxchan from transmit and receive timeslots on   
   PEB */  
status = gl_route(-1, faxchan, -1);  
if (status)  
{  
  fprintf(stderr, "gl_route( ) disconnect failed: %d\n", status);  
  return (status);  
}  
/* connect faxchan transmit and receive to timeslot 1 on PEB */  
status = gl_route(-1, faxchan, 1);  
if (status)  
{  
  fprintf(stderr, "gl_route( ) connect failed:" " %d\n", status);  
  return (status);  
}

Errors

• This function fails if an invalid channel is specified.
• This function fails if called on a device in SCbus mode.
• This function fails if gl_pebenter( ) has not been previously called.

Click here to contact Dialogic Customer Engineering