Digital

NAME

X25CreateListener − Creates an X.25 listener

LIBRARY

X.25 Library (libx25.a)

SYNOPSIS

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

void );

DESCRIPTION

The X25CreateListener routine creates an endpoint for listening for incoming X.25 calls and returns the descriptor of the newly created listener.  This descriptor is a positive integer. 

Once the listener has been created, filters are associated with the listener, using the X25BindFilter routine, to match incoming X.25 calls. 

The listener queues matched incoming calls.  If a call request arrives when the queue is full, the call is passed on to be matched against the remaining listeners.  The current queue length is eight calls. 
 

RETURN VALUES

Upon successful completion, the X25CreateListener routine returns a positive integer representing the listener.  Otherwise, a (negative) error code is returned. 
 

ERRORS

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

[X25RC_LIC_EXPIRED]
The X.25 license has expired.  The listener was not created.

[X25RC_LIC_MISMATCH]
The product version number is higher than the version number specified in the installed license or the product release date is more recent than the release date in the installed license.  The listener was not created. 

[X25RC_LIC_NOT_INSTALLED]
The X.25 license is not installed or is not registered.  The listener was not created.

[X25RC_LIC_VALIDERR]
An X.25 license validation error has occurred.  The listener was not created.

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

[X25RC_NOPORT]
An X25 Access Port entity could not be created because the system-wide limit had already been reached.  The listener was not created.

[X25RC_NOTINSTALLED]
The operating system has not been configured to support X.25.  For details on configuring the operating system to support X.25, refer to the X.25 for Digital UNIX − Installation Guide. 

[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: X25BindFilter(3X25), X25DeleteListener(3X25), X25Listen(3X25), X25UnbindFilter(3X25). 

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