Technical Reference: Communications, 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.

Related Information

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