Agent Name Server
User Guide


Index | Overview | Requirements | Querying an ANS
Starting an ANS | ANS for Windows | Javadocs | Bug Report


Querying Your ANS (Option 2)

An Agent Name Server can be queried on your machine manually at the Unix command prompt or via the TestANS Graphical User Interface (TestANSGUI). Two complete sets of instruction are available, one set for each querying method. Each set is independent of the other, so feel free to jump directly to the method you prefer. The GUI method is below, the manual method is on the previous page.

Please keep in mind, however, that we virtually never register agents manually. This user guide is meant to demonstrate what typically occurs automatically through the Communicator Package.

Querying ANS with the GUI | Querying ANS at the command prompt


Querying ANS with the GUI

  1. Start the TestANSGUI program. The basic command is:

    java EDU.cmu.softagents.misc.ANS.TestANSGUI <ANS host> <port>

    Starting TestANSGUI Example
    java EDU.cmu.softagents.misc.ANS.TestANSGUI midea 6677 <CR>

    After a few seconds, the graphical interface should appear on your screen.


  2. Choose options and enter data into the desired fields. The TestANSGUI contains drop-down menus for issuing commands and for selecting hosts, fields for inputing agent names and port numbers, and buttons for submitting data and quitting:

    TestANSGUI screenshot

    1. To register an agent name with your ANS, 1) choose "register" from the pull down menu for issuing commands ("register" is the default option), 2) type the agent's name in the box to the right of the command menu, 3) select the host name on which your ANS is running from the pull-down menu for selecting ANS hosts (if you don't see your host, type it into the field below the host menu), 4) specify a port number for your agent in the far right field, and 5) press the "submit" button:

      TestANSGUI screenshot

      In this example, an agent named "midea_agent" is being registered with the ANS running on host "midea." The agent is using port number "6656."


    2. To list the agent names registered with a certain ANS, 1) choose "list all" from the pull-down menu for issuing commands, 2) choose the host from the pull-down menu for selecting ANS hosts, and 3) press the "submit" button:

    3. TestANSGUI screenshot

      In this example, the TestANSGUI program returned the name of "midea_agent," the agent name registered with the ANS on host "midea."


    4. To "unregister" or "lookup" an agent name, 1) select the appropriate command from the pull-down menu for issuing commands, 2) enter the name of the agent in the field to the right of the command menu, and 3) press the "submit" button.


    5. To quit TestANSGUI, press the "quit" button. Note that your ANS will still be running after you quit TestANS or TestANSGUI.
To initiate communication among agents, you will need to run the KQMLMessageSenderGUI, which provides an interface for testing KQML message formats. (See the
KQMLMessageSenderGUI User Guide for more information.)

Next Page: Starting an ANS
Previous Page: Querying an ANS at the Command Prompt
Or jump to: Javadocs


Copyright 1999 © Software Agents Group
Send questions and comments to:
Pleiades
<pleiades@cs.cmu.edu>
Software Agents Group
Internal Site
Robotics Institute