rpc_$listen Library Routine

AIX Version 4.3 Communications Technical Reference, Volume 1

rpc_$listen Library Routine

Purpose

Listens for and handles remote procedure call packets.

Syntax

void rpc_$listen (max_calls, status)
unsigned long max_calls;
status_$t *status;

Description

The rpc_$listen routine dispatches incoming remote procedure call requests to manager procedures and returns the responses to the client. You must issue an rpc_$use_family or rpc_$use_family_wk routine before you use the rpc_$listen routine.

Note: This routine is used by servers only.

Parameters

Input
max_calls	Specifies the maximum number of calls (in the range 1 through 10) that a server is allowed to process concurrently. Although concurrent processes are not supported in this operating system's implementation of Network Computing System (NCS), this parameter is provided for compatibility with other NCS implementations.

Output
status	Points to the completion status.

Return Values

This routine normally does not return.

Examples

To have a server listen for incoming remote procedure call requests, enter:

rpc_$listen(5, &status);

Note: The max_calls parameter, which is set at 5 in the example, is insignificant because this implementation of NCS does not support concurrent processes. The parameter is provided for compatibility with other implementations.

Implementation Specifics

This Library Routine is part of Network Computing System in Network Support Facilities in Base Operating System (BOS) Runtime.

Related Information

Remote Procedure Call (RPC) Runtime Library (NCS) in AIX Version 4.3 Communications Programming Concepts.