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

x25_listen Subroutine

Purpose

Starts listening for incoming calls.

Library

X.25 Communications Library (libx25s.a)

C Syntax

int x25_listen(name, ctr_id)
NLchar *name;
int ctr_id;

Description

The x25_listen subroutine starts listening for incoming calls that fit the criteria in the routing list entry with the specified name parameter. It also tells the API to associate the calls with the counter identifier specified. It returns a listen identifier to be used by the x25_receive subroutine.

Parameters

name Contains a pointer to a name that is specified in the routing list.
ctr_id Identifies a counter, allocated by a previous x25_ctr_get subroutine.

Return Values

If successful, the x25_listen subroutine returns the listen identifier. If an error occurs, the x25_listen subroutine returns a value of -1 and sets the x25_errno global variable 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:

X25AUTHLISTEN

X25INVCTR

X25NAMEUSED

X25NOLINK

X25NONAME

X25NOTINIT

X25SYSERR

X25TABLE

X25TIMEOUT

Examples

Start listening for incoming calls: example program svcrcv.

Implementation Specifics

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

Related Information

The x25_deafen subroutine.

Processing Calls with the X.25 API in AIX Version 4.3 Communications Programming Concepts.


[ Previous | Next | Contents | Search ]