Removes a counter.
X.25 Communications Library (libx25s.a)
int x25_ctr_remove(ctr_id) int ctr_id;
The x25_ctr_remove subroutine removes the specified counter from the system. Only the application that requested the counter can remove it from the system. The counter cannot be removed if it has a non-zero value, which indicates that data is waiting to be read from an associated call. The counter identifier may be reused by a future call to the x25_ctr_get subroutine.
|ctr_id||Contains the counter identifier allocated by a previous x25_ctr_get subroutine call.|
If successful, the x25_ctr_remove subroutine returns a value of 0. If an error occurs, the x25_ctr_remove 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 value:
See the example program svcxmit for a code sample that removes a counter.
This command is part of X.25 Application in Base Operating System (BOS) Extensions 2.
The x25_ctr_get subroutine, x25_ctr_test subroutine, x25_ctr_wait subroutine.
Processing Calls with the X.25 API in AIX Version 4.3 Communications Programming Concepts.