NAME

Net::Jabber::Query::Agents - Jabber Query Agents Module

SYNOPSIS

  Net::Jabber::Query::Agents is a companion to the Net::Jabber::Query 
  module. It provides the user a simple interface to set and retrieve all 
  parts of a Jabber Query Agents.

DESCRIPTION

  To initialize the Agents with a Jabber <iq/> you must pass it the 
  XML::Parser Tree array from the module trying to access the <iq/>.  
  In the callback function:

    use Net::Jabber;

    sub iqCB {
      my $iq = new Net::Jabber::IQ(@_);
      my $agents = $iq->GetQuery();
      .
      .
      .
    }

  You now have access to all of the retrieval functions available.

  To create a new Agents request to send to the server:

    use Net::Jabber;

    $client = new Net::Jabber::Client();

    $iq = new Net::Jabber::IQ();
    $agents = $iq->NewQuery("jabber:iq:agents");

    $client->Send($iq);

  Or you can call the creation functions below before sending.

  For more information about the array format being passed to the CallBack
  please read the Net::Jabber::Client documentation.

Retrieval functions

    @agents = $agents->GetAgents();

Creation functions

    $agent = $agents->NewAgent(jid=>"icq.jabber.org",
                               name=>"ICQ Transport",
                               description=>"This is the ICQ Transport",
                               transport=>"ICQ#",
                               service=>"icq",
                               register=>"",
                               search=>"");
    $agent = $agents->NewAgent();

    $agent->SetXXXXX()

METHODS

Retrieval functions

  GetAgents() - returns an array of jabber:iq:agent objects.  For
                more info on this object see the docs for 
                Net::Jabber::Query::Agent.

Creation functions

  NewAgent(jid=>string,         - creates a new jabber:iq:agent object
           name=>string,          and sets multiple fields in the <iq/> 
           description=>string,   at one time.  This is a cumulative and
           transport=>string,     over writing action.  If you set the
           service=>string,       "jid" attribute twice, the second
           register=>string,      setting is what is used.  If you set
           search=>string)        the name, and then set the search
                                  then both will be in the <iq/> tag. 
                                  For valid settings read the specific
                                  Set functions in Net::Jabber::Query::Agent.
                                  This function returns a new JID object
                                  that you can call the SetXXX functions
                                  on directly if you want.

AUTHOR

By Ryan Eatmon in May of 2000 for http://jabber.org..

COPYRIGHT

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.