Huomautus
Näissä ohjeissa olevissa tiedosto- ja hakemistosijaintien viittauksissa <install-home> on hakemisto, johon agentin ohjaimen paketti on purettu.
Agentin aloituksen kokoonpanotiedosto (agent.xml) sisältää kiinteitä tietoja, joita agentin ohjain tarvitsee agentin aloituksessa ja hallinnassa. Näitä kiinteitä tietoja ovat muun muassa seuraavat tiedot:
Agent.xml-tiedoston on oltava agenttia varten nimetyn hakemiston alihakemistossa. Agentille nimetyn hakemiston on oltava serviceconfig.xml-tiedoston Agent-elementissä määritetyssä hakemistossa. Jos agentin nimi on esimerkiksi org.eclipse.tptp.TimeCollector, kokoonpanotiedoston hakemisto on <install-home>/agents/org.eclipse.tptp.TimeCollector/agent.xml. Agentin ohjain tunnistaa nimellä pyydetyt agentit hakemiston nimen perusteella. Agent.xml-kokoonpanotiedoston sisältämät tiedot ovat agentin metatietoja.
Huomaa, että agentin ohjain lukee kaikkien agenttien agent.xml-tiedostot vain kerran, oman aloituksensa aikana. Jos muokkaat näitä tiedostoja tai lisäät uusia agenttihakemistoja, muutokset tulevat voimaan vasta, kun aloitat agentin ohjaimen uudelleen.
Elementti: Agent
Tämä on agentin kokoonpanotiedoston juurielementti. Se määrittää agentin
metatiedot. Objekti voi pyytää agentin metatietoja ja käyttää niitä
vapaasti. Agentin ohjain käyttää alla lueteltuja alielementtejä agentin
aloituksessa ja hallinnassa. Agentin sovelluskehittäjät voivat määrittää
muita alielementtejä halutessaan määrittää lisää metatietoina palautettavia
tietoja. Työasemaohjelmat, jotka tekevät päätöksen tehtävässä käytettävästä
agentista ajonaikaisesti, voivat käyttää metatietoja.
Alielementit: Interface
SingleInstance
Bound
MaxControllers
MaxObservers
ConfigFile
LaunchConfigurationMääritteet:
- Name
- Tämä merkkijonomuotoinen arvo on agentin yksilöllinen nimi. Tämän arvon pitäisi olla sama, jota agentti käyttää agentin ohjaimeen rekisteröityessään. Jos nämä arvot ovat erilaiset, nimen perusteella tehdyt agentin pyynnöt toimivat eri lailla sen mukaan, onko agentti jo ajossa vai ei.
Elementti:Interface
Tämän elementin merkkijonomuotoinen arvo on sen rajapinnan nimi, jota tämä
agentti tukee. Interface-elementti ei ole pakollinen Agent-elementissä, mutta niitä voi määrittää halutun määrän. Rajapinta on yksilöllinen nimi sille
komentojoukolle, jota agentti tukee.
- Käyttöelementti: Agent
Elementti:SingleInstance
Tämän elementin kokonaislukumuotoinen arvo voi olla joko 0 tai 1. Arvo 0
(epätosi) määrittää, että tästä agentista voi olla ajossa useita ilmentymiä
samanaikaisesti. Arvo 1 (tosi) määrittää, että tästä agentista voi olla ajossa
vain yksi ilmentymä. Jos arvo on 1, agentin ohjain hylkää kaikki agentin
uudet ilmentymäpyynnöt, jos yksi agentin ilmentymä on jo ajossa.
Käyttöelementti: Agent
Elementti: Bound
Tämän elementin kokonaislukumuotoinen arvo voi olla joko 0 tai 1. Arvo 0
(epätosi) määrittää, ettei tätä agenttia ole sidottu sovellukseen. Arvo (tosi)
määrittää, että agentti on sidottu sovellukseen. Sovellukseen sidotun
agentin voi aloittaa vain kyseinen sovellus, joten agentin ohjain ei
hyväksy agentin aloituspyyntöä, jos sen Bound-arvo on 1.
Käyttöelementti: Agent
Elementti: MaxControllers
Tämän elementin kokonaislukumuotoinen arvo voi olla joko -1, 0 tai jokin positiivinen arvo.
Arvo -1 määrittää, ettei rajoituksia ole. Agentin ohjain hylkää tämän agentin
hallintaoikeuksien myöntöpyynnöt, jos pyyntöjen määrä ylittää tämän arvon. Agentin
sovelluskehittäjä määrittää hallintaoikeudet. Tätä elementtiä on tarkoitettu
käytettäväksi niiden objektien määrän rajoittamiseen, jotka voivat tehdä ristiriitaisia
toimintopyyntöjä (esimerkiksi tietokokoelman aloitus- ja lopetuspyyntöjä).
Käyttöelementti: Agent
Elementti: MaxObservers
Tämän elementin kokonaislukumuotoinen arvo voi olla joko -1, 0 tai jokin positiivinen arvo.
Arvo -1 määrittää, ettei rajoituksia ole. Agentin ohjain hylkää tämän agentin
tarkkailuoikeuksien myöntöpyynnöt, jos pyyntöjen määrä ylittää tämän arvon. Agentin
sovelluskehittäjä määrittää tarkkailuoikeudet. Tätä elementtiä on tarkoitettu
käytettäväksi niiden objektien määrän rajoittamiseen, jotka voivat pyytää kyselyjen
kaltaisia toimintopyyntöjä, kuten staattisten tai kerättävien tietojen
selvityspyyntöjä (esimerkiksi ohjaimen pyynnön täyttämiseksi).
Käyttöelementti: Agent
Elementti: ConfigFile
Tämän elementin merkkijonomuotoinen arvo määrittää sen lisäkokoonpanotiedoston
täydellisen polun ja tiedostonimen, joka sisältää dynaamiset kokoonpanotiedostot. Tämä lisätiedosto on valinnainen tiedosto, jonka käyttötavan
ja sisällön agentin sovelluskehittäjä määrittää. Tämä elementti on tarkoitettu
käytettäväksi siihen, että agentti voi lukea omat kokoonpanotietonsa tästä
tiedostosta joko aloituksen aikana tai muulloin.
Käyttöelementti: Agent
Elementti:
LaunchConfiguration
Tämä elementti määrittää tämän agentin aloituskokoonpanon parametrit.
Käyttöelementti: Agent
Alielementit: launchInfo
Elementti:
launchInfo
Tämä elementti sisältää ohjelmatiedoston aloituksessa käytettävät tiedot.
Käyttöelementti: LaunchConfiguration
Alielementit: Application
Elementti: Application
Application-elementti määrittää sovelluksen aloituksessa käytettävät
tiedot. Sen executable-määritteen arvo määrittää joko sovelluksen
valenimen (katso serviceconfig.xml-tiedoston ApplicationAliases-elementin
kuvaus) tai varsinaisen aloitettavan ohjelmatiedoston polun nimen. Järjestelmä
etsii ensin arvolle vastinetta serviceconfig.xml-tiedostosta, kun agentin
ohjain aloitetaan. Jos vastinetta ei löydy, järjestelmä käyttää Application-elementin
aloitustietoja sellaisenaan. Jos vastine löytyy, järjestelmä käyttää tälle
valenimelle määritettyjä aloitustietoja tässä elementissä määritettyjen tietojen
kanssa alla kuvatulla tavalla.
Käyttöelementti:
LaunchConfiguration
Alielementit: Variable
Parameter
Määritteet:
- executable
Tämä merkkijonomuotoinen arvo määrittää aloitettavan sovelluksen nimen. Se voi olla joko valenimi tai varsinaisen aloitettavan ohjelmatiedoston polun nimi. Jos arvo on valenimi, ohjelmatiedoston nimi korvautuu kyseiselle valenimelle määritetyllä polun nimellä.
- location
(Valinnainen) Tämä merkkijonomuotoinen arvo määrittää hakemiston, josta ohjelmatiedosto aloitetaan. Tätä hakemistoa kutsutaan joissakin tilanteissa ohjelmatiedoston työhakemistoksi, kun ohjelmatiedosto on ajossa. Jos tätä määritettä ei ole määritetty eikä ohjelmatiedostoa vastaavaa valenimeä löydy, järjestelmä ajaa sovelluksen agentin ohjaimen hakemistosta. Jos tätä määritettä ei ole määritetty mutta ohjelmatiedostoa vastaava valenimi löytyy, järjestelmä käyttää valenimelle määritettyä sijaintia.
Elementti: Variable
Tämä Variable-elementti määrittää ympäristömuuttujan ja sen, miten se on sijoitettava
käytössä olevaan ympäristöön. Application-elementissä tämä elementti muuttaa
sovelluksen aloituksessa käytettävää ympäristöä. Voit määrittää näitä
elementtejä haluamasi määrän Application-elementtiin. Jos Application-elementin
executable-määritteen arvona on valenimi, järjestelmä lisää
oletusympäristöön valenimen mukaiset ympäristömuuttujien asetukset ja tässä
määritetyt ympäristömuuttujat.
Käyttöelementti: Application
Määritteet:
- name
Tämä merkkijonomuotoinen arvo määrittää ympäristömuuttujan nimen.
- value
Tämä merkkijonomuotoinen arvo määrittää ympäristömuuttujan arvon.
- position
(Valinnainen) Tämä merkkijonomuotoinen arvo, joka voi olla "append" (liitä loppuun), "prepend" (liitä alkuun) tai "replace" (korvaa), määrittää, mihin tämä ympäristömuuttuja sijoitetaan suhteessa käytössä olevaan ympäristöön. Jos tätä arvoa ei ole määritetty, järjestelmä liittää muuttujan ympäristön loppuun.
Elementti: Parameter
Parameter-elementti määrittää aloitettavaan sovellukseen välitettävän
komentorivin argumentin. Voit määrittää näitä elementtejä haluamasi määrän
Application-elementtiin. Jos Application-elementin
executable-määritteen arvona on valenimi, järjestelmä käyttää
valenimen mukaisia komentorivin argumentteja ja lisää niihin tässä
määritetyt komentorivin argumentit.
Käyttöelementti: Application
Määritteet:
- value
Tämä merkkijonomuotoinen arvo määrittää komentorivin argumentin.
- position
(Valinnainen) Tämä merkkijonomuotoinen arvo, joka voi olla "append" (liitä loppuun), "prepend" (liitä alkuun) tai "replace" (korvaa), määrittää, mihin tämä argumentti sijoitetaan suhteessa aiemmin määritettyihin komentorivin argumentteihin. Jos tätä arvoa ei ole määritetty, järjestelmä liittää argumentin komentorivin loppuun.
<Agent Name="org.eclipse.tptp.TimeCollector">
<Interface>org.eclipse.tptp.agent</Interface>
<Interface>org.eclipse.tptp.collector</Interface>
<SingleInstance>0</SingleInstance>
<Bound>0</Bound>
<MaxControllers>-1</MaxControllers>
<MaxObservers>-1</MaxObservers>
<ConfigFile>c:\tptp\agents\org.eclipse.tptp.TimeCollector\config\agentconfig.xml</ConfigFile>
<LaunchConfiguration>
<launchInfo>
<Application executable=".\TimeCollector.exe">
<Parameter value="-serviceconfig ..\config\serviceconfig.xml" />
</Application>
</launchInfo>
</LaunchConfiguration>
</Agent>
Aiheeseen liittyviä ohjeita
Agentin ja agentin ohjaimen yleiskuvaukset
Copyright (C) 2005, 2006 Intel Corporation.