Hibaüzenetek és problémamegoldás

Figyelmeztetés vagy hibaüzenet jelenhet meg a felhasználói felületen az illesztővel kapcsolatos információk adása érdekében, illetve hiba fellépése esetén.

Hibaüzenetek

Memórialefoglalási hibák

Az illesztő leállítja a feldolgozást, ha memórialefoglalási hibaüzenetbe ütközik.

BSE:_ermAlloc: ERROR: malloc FAILED: size 60

Ezek az üzenetek a memórialefoglalási hiba miatti megszakítást jelzik.

ERR: zSecRacfSearch: Entry creation returned failure
ERR: zSecRacfSearch: reconciliation ABORTED

A rendszer az alábbi hibaüzenetet írja az illesztőnaplóba:

ERR: FATAL memory error encountered, shutting down now

A memórialefoglalási vagy malloc hibákat gyakran az z/OS Language Environment (LE) HEAP-méretének elégtelensége okozza. Malloc hibák jelentkezésekor használja az alábbi beállításokat az illesztőhöz. Adja hozzá ezeket a beállításokat az illesztő indítási parancsfájljához, amely a read_write_home/bin mappában található:

RPTOPTS(ON),RPTSTG(ON)
export
_CEE_RUNOPTS='HEAP(80K,8K,ANYWHERE,,1K,1K),AN(1450K,4K,ANY,FREE),AL(ON),
HEAPPOOLS(ON,8,8,16,16,24,17,32,3,56,8,72,3,136,4,296,7,480,3,848,4,
2080,4104,)'

Az RPTOPTS(ON),RPTSTG(ON) nem kötelező. Csak akkor adja hozzá, ha engedélyezni szeretné a diagnosztikai adatoknak az illesztő STC-jébe való naplózását.

Amikor a rendszer végrehajtja az RACF-parancsokat az IRRSEQ00 R_Admin hívható szolgáltatással, a rendszer az RACF által visszaadott hibák mindegyikét rögzíti az illesztőnaplóban. Ha egy parancs nem hajtható végre, az illesztő az SAF visszatérési kódot, az RACF visszatérési kódot és az RAFC-okkódot az alábbi példában látható módon rögzíti az illesztőnaplóban:

ERR:15/05/01 11:48:47 issueRadmin: safRC = 8, racfRC = 8 racfReason = 24, 
returning rc =5

A példában az ADAPTERID vagy a SURROGATID nem rendelkezik engedéllyel a Hozzáférés konfigurálása című témakörben ismertetett kötelező profilok mindegyikéhez. A visszatérési és okkódokkal kapcsolatos további információkért tekintse meg a z/OS Knowledge Center z/OS Security Server RACF Callable Services (A z/OS Security Server meghívható RACF-szolgáltatásai) című cikkét.

Az agentCfg konfigurációs kulcsának minimális karakterszáma

A konfigurációs kulcsok nem lehetnek 5 karakternél rövidebbek. Ellenkező esetben a következő üzenet jelenik meg, ha az aktív illesztők konfigurálásához az agentCfg eszközt használja:

Configuration key too short - 5 characters minimum. Aborting...

Ezután az agentCfg általi feldolgozás megszakad.

Nyilvántartásfájl inicializálása

A nyilvántartásfájl inicializálásának naplózása az alábbi forgatókönyvek esetén a z/OS-rendszernaplóban történik az illesztő inicializálása során.

Az illesztő indítására szolgáló héjparancsfájlban konfigurált nyilvántartásfájl nem létezik. Ebben az esetben a rendszer egy új nyilvántartásfájlt hoz létre, és az alábbi üzeneteket naplózza a rendszernaplóba:
```
zSecRacfAgent: Registry file specified by environment
REGISTRY is’<adapter_read_write_home>/data/<adapter_name>.dat’
zSecRacfAgent : REGISTRY does not exist
zSecRacfAgent: Creating a new registry file
```

A nyilvántartásfájl létezik, de nem érhető el (például helytelen fájlengedélyekkel rendelkezik). Ebben az esetben az illesztő megszakítja az inicializálást, és a következő üzeneteket írja a rendszernaplóba:

zSecRacfAgent: Registry files pecified by environment
REGISTRY is’<adapter_read_write_home>/data/<adapter_name>.dat’
zSecRacfAgent : FATAL ERROR: REGISTRY file open error: EDC5111I Permission
denied.
zSecRacfAgent: can’t continue without access to the
registry file r a c fAg e n t : exiting process

A nyilvántartás létezik, de az illesztő nem tudja elérni az útvonal egy részét. Ebben az esetben az illesztő megszakítja az inicializálást, és az alábbi üzeneteket írja a rendszernaplóba:

zSecRacfAgent: Registry file specified by environment
REGISTRY is’<adapter_read_write_home>/data/<adapter_name>.dat’
zSecRacfAgent : FATAL ERROR: REGISTRY file stat error:
EDC5111I Permission denied.
zSecRacfAgent: can’t continue without access to the
registry file zSecRacfAgent : exiting process

A nyilvántartás létezik, de nincs megadva az illesztő elindításához használt héjparancsfájlban. Ebben az esetben létrejön egy új nyilvántartásfájl a /tmp mappában, és a rendszer a következő üzeneteket írja a rendszernaplóba:
```
zSecRacfAgent: WARNING no REGISTRY file specified by the
environment zSecRacfAgent: Creating a new registry file
zSecRacfAgent : Registry to be created
is’/tmp/<adapter_name>.dat’
```

Az illesztőműveletek max. szálra vonatkozó beállításai

Az illesztő inicializálásakor az összes illesztőművelethez (keresés, módosítás, hozzáadás, törlés) háromra van beállítva a szálak alapértelmezett maximális száma. Az illesztő inicializálásakor a szálak alapértelmezett minimális száma egyre van beállítva mindegyik illesztőművelethez, mert a műveletek végrehajtásához legalább egy szál szükséges. Az illesztő ekkor hibakeresési üzeneteket ír az illesztőnaplóba az új műveletek végrehajtásához aktuálisan elérhető szálak számával kapcsolatban. Így jobban áttekinthető, milyen késések jelentkezhetnek a szálak rendelkezésre állása miatt a feldolgozás során.

Az illesztő indítása konzolüzemmódban

A hibakereséshez közvetlenül a konzolon indítsa el az illesztőt. A rendszernaplóba vagy az illesztőnaplóba írt üzenetek mindegyike megjelenik azon a konzolon, amelyen elindította az illesztőt. Az illesztő konzolüzemmódban történő indításához futtassa az összes exportálási parancsot az illesztő indításához használt héjparancsfájlban konfigurált módon. Ez a feladat biztosítja, hogy az összes könyvtár elérhető legyen az illesztő számára. Futtassa az alábbi parancsot az illesztő indításához:

/<adapter_readonly_home/lpp/bin/zSecRacfAgent -name <adapter_name> -registry
<adapter_readwrite_home>/data/<adapter_name>.dat -console

A CKGRACF rc 20 értéket ad vissza

CKG740I 20 A CKGRACF futtatásához APF-jogosultság szükséges. Lásd: RACF felhasználói azonosító.

A CKGRACF rc 8 értéket ad vissza

CKG604I 08 Az XFACILIT CKG.CMD.CMD.EX.PERMIT parancserőforrásra vonatkozó UPDATE jogosultságot a rendszer megtagadta a PARM karakterláncban található parancsnak.

CKG107I 08 A parancs 8-as eredménykóddal ért véget.

CKG111I 08 A legmagasabb eredménykód 8 volt.

Lásd: RACF felhasználói azonosító.

Kiszolgálóüzenetek

Az alábbi táblázat azokat a figyelmeztetéseket és hibákat tartalmazza, amelyeket az illesztő visszaad a kiszolgálónak.

1. Táblázat Hibaüzenetek, figyelmeztetések és javító intézkedések
Hibaüzenet vagy figyelmeztetés	További figyelmeztetések, üzenetek vagy információ	Javító művelet
Adapter error message: could not set security environment for SURROGAT.	Adapter log: ERR:14/07/31 10:42:31 zSecRacfSearch: pthread_security_ np() create failed. errno2=0BE800D8: EDC5139I Operation not permitted	Biztosítson READ jogosultságot az `IGIAGNT` számára a BPX.SERVER osztályra vonatkozóan a FACILITY osztályban
zSecRacfSearch : failed to create RECOJOB thread	A z/OS-rendszernapló az INSUFFICIENT AUTHORITY üzenetet is naplózhatja	Ellenőrizze, hogy az illesztő RACF és SURROGAT azonosítója rendelkezik-e olvasási és írási hozzáféréssel a READWRITE adatkönyvtárhoz.
Could not set security environment for SURROGAT user	Nem alkalmazható	Biztosítson READ jogosultságot az `IGIAGNT` számára a BPX.SRV.<SURROGATID> osztályra vonatkozóan a SURROGAT osztályban
zSecRacfSearch : failed to create RECOJOB thread	DETAILAdapter log: tsoCmd: result is IKJ56644I NO VALID TSO USERID, DEF AUL T USER ATTRIBUTES USED	Győződjön meg arról, hogy az illesztő azonosítója érvényes TSO USERID azonosítóval rendelkezik.
CTGIMU107W `The connection to the specified service cannot be established. Verify the service information, and try again`	An IO error occurred sending a request. Error: `Connection refused: connect`	Győződjön meg arról, hogy az illesztőszolgáltatás fut. További információ az illesztőszolgáltatás elindításával kapcsolatban: Az illesztőszolgáltatás újraindítása.
	Az illesztő hibaállapotot adott vissza egy kötési kérésre vonatkozóan. Állapotkód: érvénytelen hitelesítő adatok illesztő hibaüzenete: `A hitelesítés sikertelen volt`	Ellenőrizze, az illesztő hitelesítési azonosítója és jelszava megegyeznek-e a telepített értékekkel. Tekintse meg az illesztőspecifikus paraméterek képernyőképét itt: Az ISPF-párbeszédpanel futtatása.
	An IO error occurred sending a request. Error: `com.ibm.daml.jndi. JSSESocketConnection .HANDSHAKE_FAILED:`	Ha az SSL engedélyezve lett, ellenőrizze a konfigurációt. Lásd: Az SSL-hitelesítés konfigurálása. Az illesztőnapló tartalmazza az inicializálás során betöltött tanúsítványokkal kapcsolatos adatokat.
CTGIMD812E `An error occurred while processing the adapter response message. The following error occurred. Error: Premature end of file.`		Győződjön meg arról, hogy az illesztőszolgáltatás fut. További információ az illesztőszolgáltatás elindításával kapcsolatban: Az illesztőszolgáltatás újraindítása
tsoCmd: result is YOUR TSO ADMINISTRATOR MUST AUTHORIZE USE OF THIS COMMAND	Nem alkalmazható.	Biztosítson READ jogosultságot az `IGIAGNT` számára a JCL osztályra vonatkozóan a TSOAUTH osztályban Például: PE JCL CLASS(TSOAUTH) ID(IGIAGNT) ACCESS(READ)SETROPTS RACLIST(TSOAUTH) REFRESH
tsoCmd: RECOJOB was not submitted	tsoCmd: result is `<result string>` zSecRacfSearch: failed to initiate reco_open	Ellenőrizze, hogy az eredmény karakterlánc standard TSO üzenet-e a SYS1.MSGENU(IKJSCHEN) elemben meghatározottak szerint. Ha nem standard üzenetet visszaadó egyéni kilépés implementálódik, zárja ki az összeegyeztetési feladatot ebből a kilépésből.
LDAP: error code 92		Növelje a tranzakciónapló méretét. Lásd: DB2-tranzakciónapló mérete.
`*BPXI040I PROCESS LIMIT MAXPROCUSER HAS REACHED XX % OF ITS CURRENT CAPACITY OF XX FOR PID=XXX IN JOB ISIAGNT`		Növelje az `adapterid` számára elérhető folyamatok számát.