Környezeti változók listája

A környezeti változók segítségével szabályozhatja az ügynök futásidejű viselkedését.

A környezeti változók az ügynökbe a Környezeti változók oldalon építhetők be. Windows rendszereken a környezeti változók az ügynök KXXENV fájljában vannak meghatározva. UNIX és Linux rendszereken ezek a változók az ügynök CANDLEHOME/config/XX.ini fájljában adhatók meg. Az XX a kétkarakteres termékkód. Az ügynököt újra kell indítani az új beállítások érvénybe lépéséhez.

Megjegyzés: A környezeti változók nincsenek megfelelően megadva egy C parancsértelmezőt futtató távoli rendszeren. Használjon alternatív parancsértelmezőt, ha környezeti változókat kell igénybe vennie.

1. Táblázat Környezeti változók. A táblázat felsorolja a környezeti változókat, valamint az egyes változókhoz tartozó alapértelmezett értéket, érvényes értéktartományt és leírást.
Környezeti változó	Alapérték	Érvényes értékek	Leírás
`CDP_ATTRIBUTE_GROUP_REFRESH_INTERVAL`	Nem alkalmazható	Bármilyen nem negatív egész szám	Az az időköz másodpercben, amilyen gyakran egy adott meghatározott attribútumcsoport frissítésre kerül a háttérben. Ez a változó ugyanúgy működik, mint a `CDP_DP_REFRESH_INTERVAL`, kivéve, hogy csak a megadott attribútumcsoportra irányul. A változónévben szereplő attribútumcsoport-névnek nagybetűsnek kell lennie, még akkor is, ha a tényleges attribútumcsoport-név nem is az.
`CDP_DP_CACHE_TTL`	`55`	Bármilyen egész szám, amely nem kisebb, mint 1.	Egy attribútumcsoporthoz gyűjtött adatok gyorsítótárazása ennyi ideig tart, másodpercben. Ha ezen időtartomány során ugyanazon adatokat többször is lekérik, akkor az adatok gyorsítótárazott másolatát adja vissza a program. Ez az érték az ügynök minden attribútumcsoportjára érvényes.
`CDP_ATTRIBÚTUMCSOPORT_CACHE_TTL`	`CDP_DP_CACHE_TTL` értéke	Bármilyen egész szám, amely nem kisebb, mint 1.	A megadott attribútumcsoporthoz gyűjtött adatok gyorsítótárazása ennyi ideig tart, másodpercben. Ha ezen időtartomány során ugyanazon adatokat többször is lekérik, akkor az adatok gyorsítótárazott másolatát adja vissza a program. Ez az érték felülbírálja a megadott csoport `CDP_DP_CACHE_TTL` értékét. A változónévben szereplő attribútumcsoport-névnek nagybetűsnek kell lennie, még akkor is, ha a tényleges attribútumcsoport-név nem is az.
`CDP_DP_IMPATIENT_COLLECTOR_TIMEOUT`	`5`, ha az alcsomópontok meg vannak határozva, más esetben nincs beállítva	Bármely pozitív egész szám	Azon másodpercek száma, amennyit egy adatgyűjtés bekövetkeztére várni kell az időtúllépés és az ideiglenesen tárolt adatok visszaadását megelőzően, még akkor is, ha a gyorsítótárazott adatok elévültek. (A gyorsítótárban lévő adatok elavultak, ha `CDP_DP_CACHE_TTL` másodpercnél régebbiek.) Ha ez a változó nincs beállítva, az ügynök addig vár, amíg az adatok gyűjtése befejeződik. A várakozási idő esetenként a Tivoli Enterprise Portal időtúllépését, és a várakozás feladását eredményezheti. Ha nincs beállított szálkészlet, ez a változó figyelmen kívül marad és az adatgyűjtés szinkron módon történik.
`CDP_DP_REFRESH_INTERVAL`	`60`, ha az alcsomópontok meg vannak határozva, más esetben nincs beállítva	Bármilyen nem negatív egész szám	Az az időköz másodpercben, amilyen gyakran az attribútumcsoportok frissítésre kerülnek a háttérben. Ha ez a változó nem beállított vagy 0 értékre állított, akkor a háttérben történő frissítések tiltottak. Ha egy szálkészlet konfigurálva van (lásd a `CDP_DP_THREAD_POOL_SIZE` változót), akkor az attribútumcsoportok párhuzamosan frissíthetők. Ha nincs szálkészlet, a frissítések sorban történnek, ami sok időt vehet igénybe. Logikailag megfelel egy 1 méretű szálkészletnek.
`CDP_DP_THREAD_POOL_SIZE`	`15`, ha az alcsomópontok meg vannak határozva, más esetben nincs beállítva	Bármilyen nem negatív egész szám	Azon szálak száma, amelyek azért jöttek létre, hogy a `CDP_DP_REFRESH_INTERVAL` által meghatározott időtartamban adatokat lehessen gyűjteni a háttérben. Ha ez a változó nem beállított vagy 0 értékre állított, akkor nincs szálkészlet. Ha a `CDP_DP_THREAD_POOL_SIZE` 1-nél nagyobb értékre van beállítva, akkor a `CDP_DP_REFRESH_INTERVAL` 0 értékre kerül beállításra, a `CDP_DP_THREAD_POOL_SIZE` értéke figyelmen kívül marad és az adatgyűjtés igény szerint történik. A Szálkészletállapot-attribútumcsoport a szálkészlet futási módját jeleníti meg. A legjobb eredmények érdekében a Szálkészlet állapotát a szálkészletméret és a frissítési időköz a hangolására érdemes használni. Alapértelmezésben az attribútumcsoport lekérdezése nem jelenik meg az ügynök Navigátorfájában. Előfordulhat, hogy elfelejti a lekérdezést belefoglalni az ügynök egyéni munkaterületébe. Ezt azonban könnyen megtekintheti úgy, hogy a Szálkészlet állapota lekérdezést hozzárendeli az alap ügynök szintű munkaterület-nézethez.
`CDP_JDBC_MAX_ROWS`	`1000`	Bármely pozitív egész szám	A JDBC adatszolgáltató által visszadható adatsorok maximális száma. Az ennél több sort tartalmazó eredményhalmazok csak eddig a pontig kerülnek feldolgozásra. A lekérdezések úgy is fejleszthetők, hogy ne adjanak vissza túl sok adatot az IBM® Tivoli Monitoring számára.
`CDP_NT_EVENT_LOG_GET_ALL_ENTRIES_FIRST_TIME`	`NO`	YES, NO	Ha a beállítása YES, akkor az ügynök a Windows eseménynapló minden eseményénél egy eseményt küld. Ha a beállítása NO, akkor csak a Windows eseménynapló új eseményeinek elküldésére kerül sor.
`CDP_NT_EVENT_LOG_CACHE_TIMEOUT`	`3600`	Bármilyen egész szám, amely nem kisebb, mint 300.	Az ügynök által a Windows eseménynapló eseményeinek gyorsítótárazási ideje másodpercben. Az eseménynapló-attribútumcsoport lekérdezésekor minden gyorsítótárazott esemény visszaadására sor kerül. Megjegyzés: Ez a változó többé már nem használatos. Használja a `CDP_PURE_EVENT_CACHE_SIZE` változót.
`CDP_PURE_EVENT_CACHE_SIZE`	`100`	Bármilyen pozitív egész szám, amely nem kisebb, mint 1.	A gyorsítótárazandó események maximális száma olyan naplófájl-adatforrás esetén, amely új rekordok feldolgozására van konfigurálva, illetve a Windows eseménynapló-attribútumcsoportja. Továbbá JMX-megfigyelők és értesítések esetén. A napló minden új rekordjának hatására esemény elküldésére kerül sor. Ez a környezeti változó meghatározza, hogy az ügynök hány eseményre emlékszik a gyorsítótárban. Az attribútumcsoport lekérdezésekor a program a gyorsítótárazott értékeket adja vissza.
`CDP_DP_ACTION_TIMEOUT`	`20` másodperc	Bármilyen pozitív egész szám, amely nem kisebb, mint 1.	Várakozási idő másodpercben az ügynök által kezelt műveletindítási parancs befejeződésére.
`CDP_DP_SCRIPT_TIMEOUT`	`30` másodperc	Bármilyen pozitív egész szám, amely nem kisebb, mint 10.	Azon másodpercek száma, ameddig a parancsfájlalapú attribútumcsoport által indított program befejeződésére várni kell.
`CDP_DP_PING_TIMEOUT`	`30` másodperc	Bármilyen pozitív egész szám, amely nem kisebb, mint 10.	Azon másodpercek száma, ameddig a parancsvisszatérési kód által indított program befejeződésére várni kell. Megjegyzés: Ez a változó nem kapcsolódik az ICMP ping adatszolgáltatóhoz.
`CDP_SNMP_MAX_RETRIES`	`2`	Bármely pozitív egész szám	Az SNMP kérést újraküldéseinek száma. Az SNMP ügynöknek küldött kérések teljes számát az ennél eggyel nagyobb érték, ha nem érkezik válasz.
`CDP_SNMP_RESPONSE_TIMEOUT`	`2` másodperc	Bármely pozitív egész szám	Azon másodpercek száma, amennyit a rendszer várakozik az egyes SNMP kérések időtúllépéséig. Az attribútumcsoport mindegyik sora egy-egy kérés. Az időtúllépés értéke az a másodpercben megadott időtartam, ameddig a rendszer válaszra vár az újrapróbálkozás előtt. Egy adatsor teljes időtúllépése: (`CDP_SNMP_MAX_RETRIES` + 1) * `CDP_SNMP_RESPONSE_TIMEOUT`. Az alapértelmezett teljes időkorlát értéke (2+1)*2 = 6 másodperc.
`CDP_DP_HOSTNAME`	Az első telepített hálózati csatoló neve	Egy IP-cím vagy gazdanév	Beállítja az előnyben részesített hoszt nevét (hálózati csatolót) egy több csatolóval rendelkező rendszer esetén. Ezt a környezeti változót akkor használja, ha az ügynök a figyelő portjait egy nem alapértelmezett hálózati csatoló címhez köti. Az SNMP adatszolgáltató használja. Socket adatforrások esetén ez a változó érvényes, ha a `CDP_DP_ALLOW_REMOTE` is be van állítva.
`CDP_SNMP_ALLOW_DECREASING_OIDS`	`NO`	YES, NO	YES értékre beállítva az SNMP adatszolgáltató nem ellenőrzi, hogy a visszaadott objektumazonosítók növekednek-e. Legyen óvatos a YES érték beállításával, mivel a megfigyelt ügynöknek olyan problémái lehetnek, amelyet ez az ellenőrzés normál esetben észlel.
`KUMP_DP_COPY_MODE_SAMPLE_INTERVAL`	`60`	Várakozási idő másodpercben	Megadja egy naplófájl adatszolgáltatója esetében, hogy mennyi ideig kell várnia egy fájl tartalmának újraolvasása előtt, amikor az ügynökhöz Az összes rekord feldolgozása a fájl mintavételezésekor lehetőség be van jelölve. Az idő másodpercekben van megadva.
`KUMP_MAXPROCESS`	`100%`	5-100%	Megadja egy naplófájl adatszolgáltatója esetében a fájladatok feldolgozásához használható maximális processzorhasználatot. Az értéknek 5 és 100 százalék közöttinek kell lennie. Az alapértelmezett érték a 100 százalék.
`KUMP_DP_SAMPLE_FACTOR`	`5`	Bármilyen nem negatív egész szám	Megadja egy naplófájl adatszolgáltatója esetében a mintavételezési tényezőt, ha kiválasztja Az összes rekord feldolgozása a fájl mintavételezésekor lehetőséget az Agent Builder rendszeren. Ez a várakozási idő biztosítja, hogy a több rekordon átívelő minták ki legyenek írva a minta kereséseinek naplózása előtt.
`KUMP_DP_EVENT`	`5`	Bármilyen nem negatív egész szám	Egy naplófájl adatszolgáltatója esetében beállítja az eseményadatok mintavételezési gyakoriságát, másodpercben.
`KUMP_DP_FILE_EXIST_WAIT`	`YES`	YES, NO	Egy naplófájl adatszolgáltatója esetében megadja, hogy a fájlfigyelőszál tovább fusson, ha azt észleli, hogy a megfigyelt fájl hiányzik vagy üres. A szál vár, hogy a fájl létrejön-e, néhány másodpercenként újraellenőrzi, és elindítja vagy újraindítja a megfigyelést, ha a fájl elérhetővé válik.
`KUMP_DP_FILE_SWITCH_CHECK_INTERVAL`	`600`	Bármilyen nem negatív egész szám	Az a másodpercben megadott gyakoriság, amellyel a naplófájl adatszolgáltatója rákeres egy másik megfigyelőfájlra, amelyre át kell váltania dinamikusfájlnév-támogatás engedélyezése esetén.
`KUMP_DP_FILE_ROW_PAUSE_INCREMENT`	Nincs	Bármilyen nem negatív egész szám	Egy naplófájl adatszolgáltatója esetében megadja az olvasott fájlrekordok számát mielőtt a fájlfigyelő szál rövid időre szünetel. A szünet addig tart, amíg a korábbi frissítések feldolgozása befejeződik. Ezt a környezeti változót csak akkor használja, ha a megfigyelt fájlba rendkívül nagy mennyiségű új rekord kerül, és tart attól, hogy néhány rekordfrissítés elveszik.
`CDP_COLLECTION_TIMEOUT`	`60` másodperc	Bármely pozitív egész szám	Az ügynök egy másik folyamatból indított adatgyűjtő válaszára való várakozási ideje másodpercekben. Ilyenek például a JMX, JDBC, HTTP vagy a SOAP adatgyűjtők.
`CDP_SSH_TEMP_DIRECTORY`	`.` (időszak)	A távoli rendszer összes érvényes elérésiút-karaktersorozata	SSH engedélyezésű Parancsfájl adatszolgáltató esetében megadja a helyet a távoli rendszeren. Az ügynökkel megadott parancsfájlokat fel kell tölteni erre a helyre. A relatív h\ely relatív a felhasználó saját könyvtárához. A `.` (pont) alapértelmezett beállítása a felhasználó kezdőkönyvtárát jelöli.
`CDP_SSH_DEL_COMMAND`	`rm -Rf`	A távoli rendszer összes érvényes törlésiparancs-karaktersorozata	Megadja egy az SSH rendszert használó parancsfájl-adatszolgáltató esetén az ügynökhöz tartozó feltöltött parancsfájlok törlésének elindítására vonatkozó parancsot.
`CDP_SNMP_SEND_DELAY_ FACTOR`	`0` ezredmásodperc	Bármely pozitív egész szám	A kezdeti SNMP küldés elhalasztódik 0-ról a megadott számú ezredmásodperccel Ez a változó csak akkor engedélyezett, ha a szálkészlet is engedélyezett. A halasztás nem érvényes minden küldésre, csak az attribútumcsoportok létrehozta első küldés esetében. A változó megadása akkor hasznos, ha a megfigyelés alatt álló eszköznek néha nem sikerül helyesen válaszolni, ha egyszerre több kérést kap.
`CDP_ICMP_PING_REFRESH_INTERVAL`	`60` másodperc	Bármilyen egész szám, amely nem kisebb, mint 1	Az eszközlista fájlban megadott rendszerek pingelése ezen időközönként. Ha a pingelések túl sok időt vesznek igénybe, a pingelések újrakezdése legalább `CDP_PING_MIN_INTERVAL_DELAY` másodperc késleltetéssel történik. Az adatok nem frissülnek gyakrabban az ebben a beállításban megadott időtartamnál. Az adatok ritkábban is frissíthetők az eszközlista fájlbejegyzéseinek száma és a válaszok fogadási ideje alapján.
`CDP_ICMP_PING_MIN_INTERVAL_DELAY`	`30` másodperc	Bármilyen egész szám, amely nem kisebb, mint 1, és kisebb, mint a `CDP` pingelés frissítési időköze.	Az eszközlista fájlban megadott eszközök pingelése után következő pingfrissítési intervallum nem indul el legalább addig, amíg a megadott számú másodperc el nem telik.
`CDP_ICMP_PING_BURST`	`10`	Bármilyen egész szám, amely nem kisebb, mint 0	A `CDP_ICMP_PING_BURST_DELAY` változó által meghatározott ideig tartó ügynökszüneteltetés előtt elküldendő pingek száma. A 0 érték letiltja ezt a funkciót.
`CDP_ICMP_PING_BURST_DELAY`	`10`	Bármilyen egész szám, amely nem kisebb, mint 0	A `CDP_ICMP_PING_BURST` változó által meghatározott számú ping küldése utáni várakozási idő ezredmásodpercben. A 0 érték letiltja ezt a funkciót.
`CDP_ICMP_PING_TIMEOUT`	`2000` ezredmásodperc	Bármilyen egész szám, amely nem kisebb, mint 1	A ping válaszra várakozás ideje ezredmásodpercben megadva. A beállítás az összes pingelési kísérletre érvényes. Minden gazdagépre vonatkozóan három pingelési kísérletet hajt végre a rendszer. Ha a 3 kísérlet közül egyre sem érkezik válasz, a válaszra való várakozás teljes ideje a `CDP_ICMP_PING_TIMEOUT` háromszorosa lesz. Alapértelmezés szerint ez az érték 6000 ezredmásodperc. A `CDP_ICMP_PING_TIMEOUT` értékének módosításával az Aktuális válaszidő attribútum alapértelmezett `TIMEOUT` listája már nem lesz érvényes. A `TIMEOUT` listát a `CDP_ICMP_PING_TIMEOUT` új értékének háromszorosára kell módosítani.
`CDP_JDBC_CONNECTIONLESS`	`false`	true, false	Ha a true érték van megadva, minden adatgyűjtési próba után bezáródnak a JDBC kapcsolatok. Ez azt jelenti, hogy minden adatgyűjtés esetén az összes attribútumcsoport saját kapcsolatot próbál létrehozni. Ha ez a változó le van tiltva, a kapcsolatok nem lesznek újból felhasználva. Ha a false érték van megadva, egy kapcsolat jön létre az adatbázissal, és ez a kapcsolat lesz megosztva az attribútumcsoportok között.
`CDP_SSH_EXCLUDED_ ENVIRONMENT_VARIABLES`	Nincs	Környezeti változók nevének vesszőkkel elválasztott listája	Megadja egy az SSH rendszert használó parancsfájl-adatszolgáltató esetén a távoli rendszerben nem megadható helyi környezeti változók készletét.
`CDP_DP_EVENT_LOG_MAX_BACKLOG_TIME`	`0` másodperc	0, 1 vagy 1-nél nagyobb egész szám	Ha értéke 0, és a `CDP_DP_EVENT_LOG_MAX_BACKLOG_EVENTS` beállítása nem 1 vagy nagyobb egész szám, akkor a rendszer nem dolgozza fel az ügynök állásideje során létrejött eseményeket. Az alapértelmezett érték 0. Ha értéke 1, és a `CDP_DP_EVENT_LOG_MAX_BACKLOG_EVENTS` változó értéke 1-nél nem nagyobb egész szám, akkor a rendszer feldolgozza az ügynök állásideje során létrejött eseményeket. Ha értéke nagyobb mint 1, és a `CDP_DP_EVENT_LOG_MAX_BACKLOG_EVENTS` változó értéke nem nagyobb mint 1, akkor a rendszer feldolgozza az értéknek megfelelő időtartamon belül létrejött eseményeket, a számítógép aktuális rendszeridejének megfelelően. Ha például az érték 300, indításkor az ügynök feldolgozza az összes, 300 másodpercen belül létrejött eseményt, az aktuális rendszeridőnek megfelelően. Ha 1-nél nagyobb érték van megadva a `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME` és a `CDP_DP_EVENT_LOG_MAX _BACKLOG_EVENTS` változó számára, a rendszer az események időközét vagy az események számát dolgozza fel. A változó kiválasztása attól függ, hogy melyik teljesül elsőként.
`CDP_DP_EVENT_LOG_ Windows_Event_Log_MAX_BACKLOG_TIME`	`0` másodperc (Ne dolgozza fel a kimaradt eseményeket, amíg az ügynök le van állítva)	0, 1 vagy 1-nél nagyobb egész szám	Ha értéke be van állítva
`CDP_DP_EVENT_LOG_ MAX_BACKLOG_EVENTS`	`0` esemény	0, 1 vagy 1-nél nagyobb egész szám	Ha az érték 0, és a `CDP_DP_EVENT_LOG_MAX_BACKLOG_ _TIME` változó értéke nem 1 vagy nagyobb egész szám, akkor a rendszer nem dolgozza fel az ügynök állásideje során létrejött eseményeket. Az alapértelmezett érték 0. Ha az értéke 1, és a `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME` változó értéke nem 1-nél nagyobb egész számra lett beállítva, akkor a rendszer feldolgozza az összes, az ügynök állásideje során létrejött eseményt. Ha az értéke nagyobb, mint 1, és a `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME` változó értéke 1-nél nem nagyobb, akkor a rendszer legfeljebb ennyi eseményt dolgoz fel az ügynök állásideje során létrejött események közül. Ha például az érték 200, az ügynök indításakor a rendszer feldolgozza a közvetlenül az indítást megelőzően létrejött 200 eseményt. Ha 1-nél nagyobb érték van megadva a `CDP_DP_EVENT_LOG_MAX_BACKLOG EVENTS` és a `CDP_DP_EVENT_LOG_MAX_BACKLOG_ _TIME` változó számára, akkor a rendszer a megadott számú eseményt vagy az adott időtartamban előállított eseményeket dolgozza fel. A változó kiválasztása attól függ, hogy melyik teljesül elsőként.
`CDP_DP_EVENT_LOG_ Windows_Event_Log_MAX_BACKLOG_EVENTS`	`0` esemény (Ne dolgozza fel a kimaradt eseményeket, amíg az ügynök le van állítva)	0 vagy 1, vagy 1-nél nagyobb bármilyen egész szám	Ha értéke be van állítva
`CDP_HTTP_READ_TIMEOUT`	`10`	Bármely pozitív egész szám	A HTTP-kérésre adott válaszra való várakozás ideje másodpercben.
`CDP_JAT_THREAD_POOL_SIZE`	`15`	Bármely pozitív egész szám	A Java™ szolgáltatók által az adatgyűjtési kérések kezelésére használt szálak száma. Ez a szálkészlet a JMX, JDBC, HTTP és a SOAP adatszolgáltatók számára előnyös.
`CDP_HTML_OBJECTS_THREAD_ POOL_SIZE`	`10`	Bármely pozitív egész szám	A HTTP-adatszolgáltató segítségével megfigyelt URL-címekben található oldalobjektumok letöltéséhez használt szálak száma.
`CDP_HTTP_SOAP_MAX_ROWS`	`500`	Bármely pozitív egész szám	A HTTP SOAP-adatszolgáltató által visszaadott sorok maximális száma.
`CDP_DP_ALLOW_REMOTE`	`NO`	`NO, YES`	Ha a Yes (Igen) érték van beállítva, az ügynök engedélyezi a távoli szoftvercsatorna-csatlakozásokat. Ha a No (Nem) érték van beállítva, az ügynök csak a helyi gazdagépről való szoftvercsatorna-csatlakozásokat engedélyezi. Az alapérték a No.
`CDP_DP_INITIAL_COLLECTION_ DELAY`	változik	Bármely pozitív egész szám	Azon másodpercek száma, amely az ügynök elindulása és a szálkészlet általi ütemezett adatgyűjtések megkezdése között telik el.