Digital

NAME

X29SetAction − Sets the action to be performed on receipt of an X.29 event

LIBRARY

X.25 Library (libx25.a)

SYNOPSIS

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

int td ,
unsigned char event ,
X29ActionFlags actionFlags ,
char ∗message ,
unsigned short messageLength );

PARAMETERS

tdIdentifies the X.29 terminal for which the action is to be set. 
 

eventSpecifies the type of X.29 event for which the specified action is to be performed.  The event can be a break message from the remote PAD (X29E_BREAK) or an interrupt (X29E_INTERRUPT). 
 

actionFlagsSpecifies one or a combination of the following actions:

X29A_CLEAR
Clear the X.29 call.

X29A_PURGE
Purge any data pending for terminal.

X29A_RESET
Reset the X.29 call.

messagePoints to the message to output to the terminal on receipt of this event. 
 

messageLength
Specifies the length of the message to be displayed on receipt of this event.
 

DESCRIPTION

The X29SetAction routine sets the action to be performed on receipt of a break message (X29E_BREAK) or an interrupt (X29E_INTERRUPT) from the remote PAD. 

When an X.29 event is received, one or a combination of the following actions can be performed:

       •Clear the X.29 call (X29A_CLEAR)

       •Purge any data pending for the terminal (X29A_PURGE)

       •Reset the X.29 call (X29A_RESET)
 

RETURN VALUES

Upon successful completion, the X29SetAction routine returns a value of 0.  Otherwise, a (negative) error code is returned. 
 

ERRORS

 
If the X29SetAction 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_INVALEVENT]
No such X.29 event.

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

RELATED INFORMATION

Functions: X29GetAction(3X25). 
Files: x29remoteprof(4X25). 

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