Digital

NAME

X29InviteClear − Invites the remote PAD to clear the call

LIBRARY

X.25 Library (libx25.a)

SYNOPSIS

#include <netx25/x29.h>
int X29InviteClear(

int td ,
unsigned short timeout );

PARAMETERS

tdIdentifies the X.29 terminal corresponding to the call to be cleared. 

timeoutSpecifies the maximum time (in seconds) to wait for a response from the remote PAD before the call is cleared by the X.29 Server.  A timeout value of 0 (zero) causes the application to wait indefinitely for a response from the remote PAD. 

DESCRIPTION

The X29InviteClear routine sends an X.29 message to the remote PAD requesting that the call be cleared.  If the remote PAD does not respond to this request in the specified time then the call is cleared by the X.29 Server. 

RETURN VALUES

A successful X29InviteClear does not return, because the X.29 application process is terminated by the X.29 Server when the call is cleared.  If the X29InviteClear routine fails, a (negative) error code is returned. 
 

ERRORS

 
If the X29InviteClear routine fails, one of the following error codes is returned:

[X25RC_SYSERR]
An operating system error occurred.  The external variable errno is set to indicate the error. 

[X29RC_NOTTY]
The terminal specified is not an X.29 terminal.
 

RELATED INFORMATION

Functions: X29Break(3X25). 

X.25 for Digital UNIX − Programmer’s Reference Manual.