[ Previous | Next | Contents | Search ]
AIXLink/X.25 1.1 for AIX: Guide and Reference

x25_pvc_free Subroutine

Purpose

Frees a permanent virtual circuit (PVC).

Library

X.25 Communications Library (libx25s.a)

C Syntax

int x25_pvc_free(conn_id)
int conn_id;

Description

The x25_pvc_free subroutine frees the permanent virtual circuit (PVC) used for the specified connection for use by another application. Any data queued for the x25_receive subroutine is lost. It is the responsibility of the application to check the counter identifier for queued data before freeing the PVC.

Parameters

conn_id Contains the connection identifier, returned by the previous x25_pvc_alloc subroutine.

Return Values

If successful, the x25_pvc_free subroutine returns a value of 0. If an error occurs, the x25_pvc_free subroutine returns a value of -1 and sets the x25_errno global variable to one of the error codes shown below.

Error Codes

On failure, the x25_errno global variable is set to one of the following values:

X25BADCONNID

X25NOCARD

X25NOLINK

X25NOTINIT

X25SYSERR

If the x25_errno global variable is set to the X25SYSERR value, the errno global variable is set to one of the following values:

EINTR

EIO

Examples

Free a PVC: example program pvcxmit.

Implementation Specifics

This subroutine is part of X.25 Application in Base Operating System (BOS) Extensions 2.

Related Information

The x25_pvc_alloc subroutine.

Processing Calls with the X.25 API, Using the X.25 Structures and Flags, in AIX Version 4.3 Communications Programming Concepts.


[ Previous | Next | Contents | Search ]