Allocates a permanent virtual circuit (PVC) for use by an application.
X.25 Communications Library (libx25s.a)
int x25_pvc_alloc(pvc_ptr, ctr_id) struct cb_pvc_alloc_struct *pvc_ptr; int ctr_id;
The x25_pvc_alloc subroutine reserves the use of the specified permanent virtual circuit (PVC) for an application.
| pvc_ptr | Contains a pointer to the cb_pvc_alloc_struct structure, which contains the name of the X.25 port and the logical channel number of the PVC to be used. Together, the port and the logical number, identify the PVC. |
| ctr_id | Identifies a counter allocated by a previous x25_ctr_get subroutine. |
If successful, the x25_pvc_alloc subroutine returns the connection identifier to be used by other subroutines. If an error occurs, the x25_pvc_alloc 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:
If the x25_errno global variable is set to the X25SYSERR value, the errno global variable is set to one of the following values:
The example program, pvcxmit, illustrates code statements that allocate a PVC.
This subroutine is part of X.25 Application in Base Operating System (BOS) Extensions 2.
The x25_pvc_free subroutine.
Processing Calls with the X.25 API, Using the X.25 Structures and Flags, in AIX Version 4.3 Communications Programming Concepts.