|
New Features and Updates for XAPILast Update: 06/02/99
1. XAPI key code ApkClearBuf ============================ For asynchronous devices only, a new key code has been added to allow the image buffer to be cleared from an XAPI application. api_request: apisndkey api_key_code: ApkClearBuf (Note: ApkClearBuf is defined in header CFXDVCST.H) Execution of this command will not impact the state of the connection to the host. It's primary function, though, is to be used in recovery processing when the connection to the host has been lost. For example, assume the image buffer contains the following: CONNECT 9600 . . . CARRIER LOST Here, it's clear the phone connection has been dropped. If the XAPI program were to scan the image buffer for the string 'CONNECT', then the scan would be satisfied immediately, even before a new connection could be established. The solution is to issue send the ApkClearBuf key upon detection of the CARRIER LOST condition, then attempt to redial. In CFXDIAL/DIALOG/etc., ApkClearBuf can be invoked via the following command: SEND CLEARBUF
|