Frees a permanent virtual circuit (PVC).
X.25 Communications Library (libx25s.a)
int x25_pvc_free(conn_id) int conn_id;
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.
conn_id | Contains the connection identifier, returned by the previous x25_pvc_alloc subroutine. |
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.
On failure, the x25_errno global variable is set to one of the following values:
If the x25_errno global variable is set to the X25SYSERR value, the errno global variable is set to one of the following values:
Free a PVC: example program pvcxmit.
This subroutine is part of X.25 Application in Base Operating System (BOS) Extensions 2.
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.