Paul Barry > Mobile-Executive-2.03 > "Mobile::Executive"

Download:
Mobile-Executive-2.03.tar.gz

Annotate this POD

CPAN RT

Open  0
Report a bug
Source  

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.