scx_tstcom( )

Description | Cautions | Example | Errors | See Also

Name:	int scx_tstcom(devh, tmo)
Inputs:	int devh	SCX160 SCxbus Adapter device handle
	short tmo	time-out value
Returns:	0 on success -1 on failure
Includes:	scxlib.h
Category:	Diagnostic
Mode:	synchronous

Description

The scx_tstcom( ) function runs a communication test to verify that the SCX160 SCxbus Adapter can communicate with the host computer. Usually performed during Dialogic Service startup, the test sends a single byte to the SCX160 SCxbus Adapter and waits for a single-byte response. A return code of 0 indicates successful completion of the test.

Parameter	Description
devh:	Specifies the SCX160 SCxbus Adapter device handle.
tmo:	Specifies the maximum amount of time in seconds that the function will block while waiting for a response from the SCX160 SCxbus Adapter. If a response is not received within tmo seconds, an error is returned. A suggested setting is 5 seconds.

Cautions

This function fails if:

• The device fails to responds within tmo seconds
• An invalid device handle is specified
• A hardware problem exists on the SCX160 SCxbus Adapter
• A configuration problem exists; for example, an IRQ conflict

NOTE:

Device configuration information is located in the appropriate hardware installation card.

Example

#include <windows.h>  
#include <stdio.h>  
#include <stdlib.h>  
#include <errno.h>  
   
#include <srllib.h>  
#include <scxlib.h>  
   
int devh;               /* SCX160 Device Handle */  
int rcode;              /* Function Return Code */  
   
/* Open SCX160 Board */  
if ((devh = scx_open("scxB1", 0)) == -1) {  
   printf("Cannot open board scxB1. errno=%d \n", errno);  
   exit(1);  
}  
   
/* Perform Communications Test with SCX160 Board */  
rcode = scx_tstcom(devh, 5);  
if (rcode == -1) {  
   printf("ERROR: SCX/160 Communications Test Failed on Board scxB1: %s\n",  
          ATDV_ERRMSGP(devh));  
} else {  
   printf("SCX/160 Communications Test was Successful on Board scxB1\n");  
}  
   
/* Close the SCX160 Board */  
scx_close(devh);

Errors

If the function returns -1, use the SRL Standard Attribute function ATDV_LASTERR( ) to obtain the error code, or you can use the ATDV_ERRMSGP( ) function to obtain a descriptive error message. The error codes returned by ATDV_LASTERR( ) function are listed in Chapter 7.  Errors.

See Also

• scx_tstdat( )

Click here to contact Dialogic Customer Engineering