VariablePackage: net.jlinkerToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 9.0
New since 9.0 release.


This variable was added in a patch release in late July, 2013. That patch upgraded jlinker to version 7.1. See jlinker.htm for more information on the patch and version 7.1.

This variable specifies the default parameters for a jlinker connection pool.

The initial value is nil to specify no connection pool (for compatibility with earlier versions where connection pooling was not available).

A typical value is a list of the form

   (lisp-min lisp-max lisp-idle java-min java-max java-idle)


All values are positive integers, 0 or -1 (see below for the meanings of 0 and -1).

This list can be abbreviated by the following shorter forms:

;;  A single number n denotes the list 

   (h n 0 h n 0)

;; where h == (ceiling n 2)

;; A 2-element list (a b) denotes the list 

  (h a 0 k b 0)

;; where h == (ceiling a 2) and k = (ceiling b 2)

The effective connection pool parameters are determined by comparing this list with a corresponding list from the Java side. The comparison is made using the following rules:

Each port from Lisp to Java represents a socket connection in Lisp and a thread in Java.

Each port from Java to Lisp represents a socket connection In Java and a thread (Lisp process) in Lisp.

Ports up to the minimum number are created during jlinker initialization (but after jlinker-init returns). Ports above the minumum number are created on demand. The idle times apply to ports above the minimum number; if one such port is idle for the specified time, it is closed and the associated thread ended.

See jlinker.htm for more information on the jLinker facility.

Copyright (c) 1998-2017, Franz Inc. Oakland, CA., USA. All rights reserved.
This page is new in the 9.0 release.
Created 2017.2.15.

Allegro CL version 9.0
New since 9.0 release.