Digital

NAME

X25SendInterrupt − Transmits an X.25 interrupt

LIBRARY

X.25 Library (libx25.a)

SYNOPSIS

#include <netx25/x25.h>
int X25SendInterrupt(

int pd ,
unsigned char ∗ interrupt ,
int interruptLength );

PARAMETERS

pdIdentifies the port to which the interrupt is to be sent. 

interruptPoints to the interrupt data to be sent. 

interruptLength
Specifies the number of bytes of interrupt data in interrupt. 
 

DESCRIPTION

The X25SendInterrupt routine transmits an X.25 interrupt message to the remote system.  Once an interrupt has been transmitted, it is not possible to send another until the remote system has confirmed receipt of the first.  The maximum length of the interrupt data is either 1 or 32 bytes, depending on the network. 
 

RETURN VALUES

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

ERRORS

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

[X25RC_BADPD]
Invalid port descriptor specified.

[X25RC_INTALREADY]
The request to send an interrupt was ignored, as the previous interrupt has not yet been confirmed by the remote DTE.

[X25RC_INTTOOLONG]
The specified interrupt data is too long for the network being used.

[X25RC_INVALSTATE]
The port is not in a valid state to perform the requested operation. Either there is no connection established on the specified port, or the port is currently unable to accept an interrupt because it is processing a reset.

[X25RC_LINKDOWN]
The X.25 call was aborted due to a LAPB or LLC2 link failure.  Before attempting another call, ensure that the Link Service Provider of the DTE used to make the call is enabled and running.

[X25RC_NETABORT]
The X.25 call was aborted due to a network-initiated restart of the DTE on which the call was established.  Wait for the X25 Protocol DTE entity to return to the running state before making the call again.

[X25RC_NETMANCLR]
The call has been cleared by a network management command.

[X25RC_NOMEM]
There were insufficient system resources to perform the requested operation.  The interrupt was not transmitted.

[X25RC_PORTABORT]
The X.25 call was aborted due to a failure in a module below X25 Access.  Before attempting another call, ensure that the X25 Protocol DTE entity and its Link Service Provider are enabled and in the running state.

[X25RC_PORTCLR]
The operation could not be performed because the X.25 call has been cleared.  Clear information can be obtained using the X25ReadClear routine. 

[X25RC_PROTOCOL]
The X.25 call was aborted due to an invalid packet received from the network.  To further isolate this problem, use CTF to determine the packet in error.

[X25RC_SERVICEDOWN]
The X.25 service is not available because an entity is not in the correct state.  Either the X25 Access entity is disabled, or the X25 Protocol entity does not exist.

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

[X25RC_WOULDBLOCK]
The specified port is operating in non-blocking mode, and the interrupt cannot be sent at this time.
 

RELATED INFORMATION

Functions: X25GetPortStatus(3X25), X25ReadOOB(3X25), X25SendInterruptConf(3X25). 

CTF for Digital UNIX − CTF User’s Guide,
X.25 for Digital UNIX − Programmer’s Reference Manual.