FunctionPackage: net.rpcToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 9.0
Unrevised from 8.2 to 9.0.
8.2 version

rpc-process-pool

Arguments: &key limit drop active query flush forget show

This function is used to query and to manage the process pool maintained by the Allegro CL RPC Module. Each new in-bound remote call (a call that is not a callback from an out-bound call) is evaluated in a new Lisp process. In the os-threads model of Lisp multi-processing (see multiprocessing.htm), there is some overhead associated with the creation of a new Lisp process. The process pool reduces this overhead by re-using processes.

The keyword arguments are:

Possible values for the query argument

If the value of the query argument is one of the listed keywords, rpc-process-pool returns information about the process pool and the status of processes, as described. If the value of the query argument is nil or omitted, rpc-process-pool returns nil.

Value of query Value returned by rpc-process-pool
nil. This is the default. nil
:waiting Return the number of remote calls waiting for a process at this moment.
:pool Return the number of idle processes in the pool at this moment.
:running Return the number of processes running a remote call at this moment.
:limit Return the limit on the number of idle processes kept in the pool.
:drop Return the limit on how long idle processes are kept in the pool.
:active Return the limit on the number of processes that will be run simultaneously to handle remote calls.
:max-active Return the maximum number of active processes.
:max-waiting Return the maximum number of calls waiting for a process.
:re-used Return the number of times a process was re-used.
:new Return the number of times a process was created.
:saved Return the number of times a process was saved for re-use.
:killed Return the number of times a process was discarded after use.
:dropped Return the number of times a process was discarded from the idle pool

See also rpc.htm for general information on the Remote Procedure Call utility in Allegro CL.


Copyright (c) 1998-2012, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 9.0. This page was not revised from the 8.2 page.
Created 2012.5.30.

ToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 9.0
Unrevised from 8.2 to 9.0.
8.2 version