NAME
          irPriXfer - perform a PRI Two B-Channel Transfer

     SYNOPSIS
          #include <irapi.h>

          int irPriXfer (channel_id cid, channel_id cid2,int tag);

     DESCRIPTION
          The irPriXfer function performs the TBCT on ISDN PRI,
	  and is only supported only by the NI2 and DMS variant, user-side.

	  cid is the channel id for an outgoing call being in at 
	  alerting or connected state.

          cid2 is the channel id for an incoming or outgoing call 
	  being at connected state 

          tag is returned to the application with the subsequent
          IRE_TBCT_DONE.

	  Usually the function is issueed when the first call (cid2) is 
	  answered by the IVR, then the application places another outgoing 
	  call (cid).  Base on the call state of the outgoing call, 
	  irPriXfer() then is issued.  If the switch takes the request for 
	  transfer and completes the transfer operation, then both calls
	  will be released by the switch.

     EVENT

	  IRE_TBCT_DONE
	  After the irPriXer is issued, the IRE_TBCT_DONE event is 
	  generated with one of the following three modifiers.

	    IREM_COMPLETE
	    The call has been successfully transfered, and both channel are
            or soon-to-be released.
	    IREM_CALLSTATE
	    The irPriXfer is issued when the calls are not in the acceptable 
	    call state.
	    IREM_CAPABLE
	    The irPriXfer is issued when the protocol is not supported for TBCT.

     RETURN VALUE
          IRR_OK is returned if the transfer request is successfully
          initiated.

          IRR_FAIL is returned if an error occurs.

     VERSION
          This is version 11/07/02 of this man page.