gc_StopTrace( )

---

Termination Events | Cautions | Errors | Example | See Also

Name:	int gc_StopTrace(linedev)
Inputs:	LINEDEV linedev	Global Call line device handle
Returns:	0 if successful <0 if failure
Includes:	gclib.h gcerr.h
Category:	interface specific
Mode:	synchronous
Platform and Technology:	Springware: T-1/E-1 (PDKRT only), ISDN†, Analog (PDKRT only) DM3: ISDN† SS7† †See the Global Call Technology User's Guides for additional information.

Description

The gc_StopTrace( ) function stops the logging of debug information that was started using the gc_StartTrace( ) function and closes the trace file.

Parameter	Description
linedev	Global Call line device handle

Termination Events

None

Cautions

If this function is invoked for an unsupported technology, the function fails. The error value EGC_UNSUPPORTED will be the Global Call value returned when the gc_ErrorInfo( ) function is used to retrieve the error code.

Errors

If this function returns <0 to indicate failure, use the gc_ErrorInfo( ) function to retrieve the reason for the error. See the "Error Handling" section in the Global Call API Programming Guide. All Global Call error codes are defined in the gcerr.h file. If the error returned is technology specific, see the technology-specific error header file(s) for the error definition (for example, ccerr.h or isdnerr.h file for the ISDN call control library).

Example

#include <stdio.h>
#include <srllib.h>
#include <gclib.h>
#include <gcerr.h> 
LINEDEV  bdev;                   /* board level device number */
int      parm_id;                /* parameter id */
int      rc;                     /* Return code */
int      value;                  /* value to be for the specified parameter */
int      D_CH_hdl;               /* identify D channel to be traced */
char     *filename;              /* file name for the trace */
GC_INFO  gc_error_info;          /* GlobalCall error information data */ 
main()
{
    /* Only one D channel can be traced at any given time. */
    .
    .
    .
    rc = gc_StopTrace(bdev);
    if(rc != GC_SUCCESS) {
        printf("Error in gc_StopTrace, rc = %x\n", rc);
    } else {
        /* Process event */
    }        
    .
    .
    .
} 

See Also

• gc_StartTrace( )

Click here to contact Telecom Support Resources