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

x25_ctr_get Subroutine

Purpose

Gets a counter.

Library

X.25 Communications Library (libx25s.a)

C Syntax

int x25_ctr_get(void)

Description

The x25_ctr_get subroutine allocates a counter whose value is incremented when a message associated with it arrives. The counter is decremented when a message associated with it is received by an application.

Return Values

If successful, the x25_ctr_get subroutine returns the counter identifier. If an error occurs, the x25_ctr_get 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:

X25NOCTRS

X25NOTINIT

X25SYSERR

Examples

Get a counter: example program svcxmit.

Implementation Specifics

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

Related Information

The x25_ctr_remove 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 ]