rpc-invoke

Arguments: (port rpc-port) op arglist &key mode (result :copy-maybe) destination (wait t) (error-p t) timeout

This generic function provides a more controlled way of making a remote call than rcall. If wait is non-nil, the returned value is the value or values returned from the remote call, when these finally arrive. If wait is nil, a value is returned immediately. The value is a message instance that serves as a handle for the call. This handle may be used with the methods rpc-query, rpc-wait, and rpc-get to monitor the progress of the call.

The op is a function reference that may be a string, a symbol, or a remote reference to a string, symbol or function (see Operator Conversion in rpc.htm).

Except for datagram ports, the mode argument may be :nest, :parallel, or :block to override the default call mode in the port definition. The destination argument may be :new to specify that the remote call should be handled in a new process regardless of the mode settings.

For datagram ports, the timeout argument overrides the default value in the message-timeout slot of the port. A timeout is signaled as an error.

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.