Digital

NAME

X25OpenPort − Creates an X.25 port

LIBRARY

X.25 Library (libx25.a)

SYNOPSIS

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

void );

DESCRIPTION

The X25OpenPort routine creates an endpoint for X.25 communication called a port.  A port is represented by a positive integer.  The port is subsequently associated with an X.25 virtual circuit upon the successful completion of the X25MakeCall routine. 

This routine is only used in making outgoing X.25 calls.  For incoming X.25 calls, the port is created as a result of calling the X25Listen routine. 
 

RETURN VALUES

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

ERRORS

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

[X25RC_LIC_EXPIRED]
The X.25 license has expired.  The port 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 port was not created. 

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

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

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

[X25RC_NOPORT]
An X25 Access Port entity could not be created because the system-wide limit had already been reached.  The port 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_SYSERR]
An operating system error occurred.  The external variable errno is set to indicate the error. 
 

RELATED INFORMATION

Functions: X25ClosePort(3X25), X25GetPortStatus(3X25), X25MakeCall(3X25), X25ReadData(3X25), X25ReadOOB(3X25), X25SendData(3X25), X25SendInterrupt(3X25), X25SendReset(3X25). 

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