Digital

NAME

X25ReadClearConf − Reads clear confirmation received from remote DTE

LIBRARY

X.25 Library (libx25.a)

SYNOPSIS

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

int pd ,
unsigned char ∗ epl ,
int ∗ eplLength );

PARAMETERS

pdIdentifies the port on which the call has been cleared. 

eplPoints to an Encoded Parameter List in which the X.25 clear confirmation facilities are returned. 

eplLengthPoints to the size of the Encoded Parameter List epl.  On return this is set to the length of the encoded facilities written to epl. 
 

DESCRIPTION

A user may clear an X.25 virtual circuit using the X25ClearCall routine.  The user may then wish to obtain the information supplied by the remote DTE in the clear confirmation.  This can be done using the X25ReadClearConf routine.  Any information is returned in the encoded parameter list epl and can be interpreted using the X25GetItemList and X25Decode routines. 

The parameters returned in the encoded parameter list are network dependent but may include the following:

 
Any pointer passed to the routine that has a NULL value is ignored and no value is returned for this parameter.
 

RETURN VALUES

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

ERRORS

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

[X25RC_BADPD]
Invalid port descriptor specified.

[X25RC_EPLSIZE]
The specified EPL is too small to contain the clear confirmation items.  As many of the items as will fit are returned in epl. 

[X25RC_INVALSTATE]
The port is not in a valid state to perform the requested operation. Either there is a connection still in progress on the specified port, or there has never been a call established on the specified port.

[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_NOCLRDATA]
There is no clear confirmation available for the specified port.

[X25RC_NOMEM]
There were insufficient system resources to perform the requested operation.  The clear confirmation was not retrieved.

[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. 
 

RELATED INFORMATION

Functions: X25ClearCall(3X25), X25Decode(3X25), X25GetItemList(3X25). 

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