GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  AGENT::MESSAGE (3)

.ds Aq ’

NAME

Agent::Message - the Transportable Agent Perl module

CONTENTS

SYNOPSIS



  use Agent;

  my $msg = new Agent::Message(
        Body      => [ foo bar, baz ],
        Transport => TCP,
        Address   => 127.0.0.1:24368
  );

  $msg->send;



DESCRIPTION

This module is meant to standardize agent communications over a number of different transport mediums (see Agent::Transport).

CONSTRUCTOR

new( [%args] ) new makes a nice new Message object with all the arguments you pass it. It understands the following parameters:



        Body => $body,
     [  Transport => $medium,
        Address => $destination,
        SendNow => $true_false   ]



This instantiates the class with only one destination (multiple destinations are possible - see below). If SendNow is true, the message is dispatched ASAP.

METHODS

$msg->body( [@value] ) Sets/gets the body of the message.
$msg->add_dest( $transport, $addr1 [, $addr2 ...] ) Adds the destination address to the list of destinations within said medium; adds the medium if need be.
$msg->del_dest( $transport, $addr1 [, $addr2 ...] ) Removes the destination address from the list of destinations within said medium. If last destination in medium, removes medium also.
$msg->del_transport( $transport ) Removes the specified transport medium and all of its destinations.
$msg->send( %args ) Sends the message body in all transport mediums. Passes \%args to all transport mediums when sending. Returns an array of results returned by each transport medium the message was sent in.

BUGS

$msg->del_dest and $msg->del_transport don’t work; I’m too lazy.

SEE ALSO

Agent, Agent::Transport, the example agents.

AUTHOR

Steve Purkis <spurkis@engsoc.carleton.ca>

COPYRIGHT

Copyright (c) 1998 Steve Purkis. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

THANKS

Whoever invented mail.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 AGENT::MESSAGE (3) 1998-10-07

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.