The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

"Mobile::Executive" - used to signal the intention to relocate a Scooby mobile agent from the current Location to some other (possibly remote) Location.

VERSION

2.03 (version 1.0x never released).

SYNOPSIS

use Mobile::Executive;

   ...

relocate( $remote_location, $remote_port );

DESCRIPTION

Part of the Scooby mobile agent machinery, the Mobile::Executive module provides a means to signal the agents intention to relocate to another Location. Typical usage is as shown in the SYNOPSIS section above. Assuming an instance of Mobile::Location is executing on $remote_location at protocol port number $remote_port, the agent stops executing on the current Location, relocates to the remote Location, then continues to execute from the statement immediately AFTER the relocate statement.

Note: a functioning keyserver is required.

Overview

The only subroutine provided to programs that use this module is:

    relocate

and it takes two parameters: a IP address (or name) of the remote Location, and the protocol port number that the Location is listening on.

Internal methods/subroutines

A Perl BEGIN block determines the absolute path to the mobile agents source code file, and puts it into the $absolute_fn scalar (which is automatically exported). This block also generates a PK+/PK- pairing (in $public_key and $private_key) and exports both values (as they are used by Devel::Scooby).

RULES FOR WRITING MOBILE AGENTS

There used to be loads, but now there is only one. Read the Scooby Guide, available on-line at: http://glasnost.itcarlow.ie/~scooby/guide.html.

SEE ALSO

The Mobile::Location class (for creating Locations), and the Devel::Scooby module (for running mobile agents).

The Scooby Website: http://glasnost.itcarlow.ie/~scooby/.

AUTHOR

Paul Barry, Institute of Technology, Carlow in Ireland, paul.barry@itcarlow.ie, http://glasnost.itcarlow.ie/~barryp/.

COPYRIGHT

Copyright (c) 2003, Paul Barry. All Rights Reserved.

This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.