| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
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:
nil
. See below for possible values for query and the resulting value of the function call.
nil
,
display the status, parameters and statistics of the process pool on
*standard-output*
.
nil
,
discard all the idle processes in the pool.
nil
,
discard any pending remote calls waiting for a process.
:none
, disable the
process pool facility. When non-nil
(but not
:none
), start a new pool. In both cases, all
previous statistics are discarded.If the flush
and/or forget arguments are non-nil
, their effect takes place first. If the
flush argument is nil
or
omitted, then any idle processes are discarded with a warning. If the
forget argument is nil
or omitted, then any waiting work items are
discarded with a warning.
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-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.
| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |