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

x25_ctr_remove Subroutine

Purpose

Removes a counter.

Library

X.25 Communications Library (libx25s.a)

C Syntax

int x25_ctr_remove(ctr_id)
int ctr_id;

Description

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.

Parameters

ctr_id Contains the counter identifier allocated by a previous x25_ctr_get subroutine call.

Return Values

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.

Error Codes

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

X25AUTHCTR

X25CTRUSE

X25INVCTR

X25NOTINIT

X25SYSERR

Examples

See the example program svcxmit for a code sample that removes a counter.

Implementation Specifics

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

Related Information

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.


[ Previous | Next | Contents | Search ]