jlinker-end

Arguments: &key wait server lisp-file lisp-port verbose error-p

The function was modified (by the addition of the error-p keyword argument and the resulting changes in handling errors) in jlinker version 3.2.4 released as patch jlinker.001 around Dec. 6, 2002. The currently running version is returned by the function jlinker-version, with a call like (javatools.jlinker:jlinker-version). Get the patch for the new version with sys:update-allegro.

This function ends a connection.

If lisp-port is non-nil, the lisp-file argument is ignored; the function attempts to stop advertising at the given port. If port is nil but lisp-file is non-nil, then the function attempts to stop advertising at the port specified in the file. If the wait argument is nil, the function returns before the attempts are completed but the attempts continue.

If the wait argument is non-nil (the default) or if the lisp-port or lisp-file arguments are omitted, then this function attempts to close down a connection between Lisp and Java. If a graceful disconnect fails, the connection is aborted unilaterally. If the wait argument is nil, return while attempted disconnects are going on, otherwise return only when the connection is shut down completely.

It is important to call jlinker-end before calling jlinker-init again even if the connection appears to be broken already.

The following keyword arguments alter the behavior jlinker-end:

• verbose: When t, emit status and warning messages. The default is the value of *jlinker-verbose*.
• error-p: this argument determines the behavior of jlinker-end when an error occurs. If the value of this argument is true, an error of type jlinker-error is signaled. If the value is nil, no error is signaled. This argument defaults to the value of *jlinker-error-p*.

jlinker-end returns one of the following values:

• :jlinker-end: jlinker connection is properly shut down in response to this call
• :wait: jlinker connection was shutdown in another process; this call was waiting for it to finish because wait is true
• :busy: jlinker shutdown is in progress already in another process, return immediately because wait is nil
• nil: immediate return because there is no jlinker connection at all
• a port instance: lisp-file or lisp-port arguments non-nil but wait is nil
• a list: lisp-file or lisp-port arguments non-nil and error-p is nil and an error occurred. The list contains information about the error. The value of wait does not affect this case.
• [jlinker-error signaled so no value returned]: lisp-file or lisp-port arguments non-nil and error-p is true and an error occurred. The value of wait does not affect this case.

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

Copyright (c) 1998-2009, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 8.1. This page was not revised from the 8.0 page.
Created 2009.7.29.