Messages d'erreur et résolution des problèmes

Un message d'erreur ou d'avertissement peut s'afficher dans l'interface utilisateur pour fournir des informations sur l'adaptateur ou lorsqu'une erreur se produit.

Messages d'erreur

Erreurs d'allocation de mémoire

L'adaptateur arrête le traitement quand il rencontre le message d'erreur d'allocation de mémoire.

BSE:_ermAlloc: ERROR: malloc FAILED: size 60

Ces messages indiquent l'abandon en raison de l'erreur d'allocation de mémoire.

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

Le message d'erreur final suivant est écrit dans le journal de l'adaptateur :

ERR: FATAL memory error encountered, shutting down now

Les erreurs d'allocation de mémoire ou malloc sont souvent provoquées par une insuffisance de la taille de segment de mémoire (HEAP) Language Environment (LE) du z/OS. Lorsque les erreurs malloc se produisent, utilisez les paramètres suivants pour l'adaptateur. Ajoutez ces paramètres au script de démarrage de l'adaptateur, qui se trouve dans le dossier read_write_home/bin :

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,)'

RPTOPTS(ON),RPTSTG(ON) est facultatif. Ne l'ajoutez que si vous souhaitez activer la consignation des données de diagnostic pour la STC de l'adaptateur.

Lorsque les commandes RACF sont exécutées à l'aide du service d'appels R_Admin IRRSEQ00, toutes les erreurs renvoyées par RACF sont enregistrées dans le journal de l'adpatateur. Si une commande ne peut pas être exécutée, l'adaptateur enregistre le code retour SAF, le code retour RACF et les codes anomalie RACF dans le journal de l'adaptateur, comme illustré dans l'exemple suivant :

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

Dans l'exemple, ADAPTERID ou SURROGATID ne dispose pas des droits d'accès à tous les profils requis décrits dans Configuration d'accès. Pour plus d'informations sur les codes retour et les codes anomalie, voir le document z/OS Security Server RACF Callable Services dans le z/OS Knowledge Center.

Caractères minimum de clé de configuration d'agentCfg

Une clé de configuration ne peut pas comporter moins de cinq caractères. Dans le cas contraire, le message suivant s'affiche lorsque vous utilisez agentCfg pour configurer un adaptateur actif :

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

Après quoi le traitement de l'agentCfg est abandonné.

Initialisation de fichiers de registre

L'initialisation du fichier de registre pour les scénarios suivants est consignée dans le syslog z/OS pendant l'initialisation de l'adaptateur.

Le fichier de registre qui est configuré dans le script shell utilisé pour démarrer l'adaptateur n'existe pas. Dans cet événement, un nouveau fichier de registre est créé et les messages suivants sont écrits dans le syslog :
```
zSecRacfAgent: Registry file specified by environment
REGISTRY is'<rép_base_lecture_écriture_adaptateur>/data/<nom_adaptateur>.dat'
zSecRacfAgent : REGISTRY does not exist
zSecRacfAgent: Creating a new registry file
```

Le fichier de registre existe, mais il n'est pas accessible (par exemple, droits d'accès au fichier incorrects). Dans cet événement, l'adaptateur abandonne l'initialisation et les messages suivants sont écrits dans le syslog :

zSecRacfAgent: Registry files pecified by environment
REGISTRY is'<rép_base_lecture_écriture_adaptateur>/data/<nom_adaptateur>.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

Le registre existe mais l'adaptateur ne peut pas accéder à une partie du chemin d'accès. Dans cet événement, l'adaptateur abandonne l'initialisation et les messages suivants sont écrits dans le syslog :

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

Le registre existe, mais n'est pas indiqué dans le script shell utilisé pour démarrer l'adaptateur. Dans cet événement, un nouveau fichier de registre est créé dans /tmp et les messages suivants sont écrits dans le syslog :
```
zSecRacfAgent: WARNING no REGISTRY file specified by the
environment zSecRacfAgent: Creating a new registry file
zSecRacfAgent : Registry to be created
is'/tmp/<nom_adaptateur>.dat'
```

Paramètres d'unités d'exécution maximales pour des opérations d'adaptateur

Le nombre maximal d'unités d'exécution par défaut pour toutes les opérations d'adaptateur (recherche, modification, ajout, suppression) est défini sur trois à l'initialisation de l'adaptateur. Le nombre minimal d'unités d'exécution par défaut pour toutes les opérations d'adaptateur est défini sur un à l'initialisation de l'adaptateur puisqu'au moins une unité d'exécution est requise pour exécuter une opération. L'adaptateur écrit maintenant des messages de débogage dans le journal d'adaptateur concernant le nombre d'unités d'exécution actuel encore disponibles pour effectuer de nouvelles opérations. Cela fournit plus de connaissances sur les possibles retards relatifs à la disponibilité d'unités d'exécution dans le traitement.

Démarrage de l'adaptateur en mode console

Pour le débogage, démarrez l'adaptateur directement depuis la console. Tous les messages qui sont écrits dans syslog ou dans le journal d'adaptateur sont affichés sur la console à partir de laquelle vous avez démarré l'adaptateur. Pour démarrer l'adaptateur en mode console, exécutez toutes les commandes telles qu'elles sont configurées dans le script shell utilisé pour démarrer l'adaptateur. Cette tâche assure que toutes les bibliothèques sont disponibles pour l'adaptateur. Exécutez la commande suivante pour démarrer l'adaptateur :

/<rép_base_lecture_seule_adaptateur/lpp/bin/zSecRacfAgent -name <nom_adaptateur> -registry
<rép_base_lecture_écriture_adaptateur>/data/<nom_adaptateur>.dat -console

CKGRACF renvoie le code retour 20

CKG740I 20 CKGRACF doit s'exécuter avec des droits APF. Voir ID utilisateur RACF.

CKGRACF renvoie le code retour 8

CKG604I 08 Accès UPDATE à la ressource de commande XFACILIT CKG.CMD.CMD.EX.PERMIT refusé pour la commande dans la chaîne PARM.

CKG107I 08 La commande a pris fin avec le code de résultat 8.

CKG111I 08 Le code de résultat le plus élevé était 8.

Voir ID utilisateur RACF.

Messages du serveur

Le tableau suivant contient les avertissements ou les erreurs que l'adaptateur renvoie au serveur.

Tableau 1. Messages d'erreur, avertissements et actions correctives
Message d'erreur ou avertissement	Avertissements, messages ou informations supplémentaires	Action corrective
Message d'erreur de l'adaptateur : 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	Autorisez l'accès READ pour `IGIAGNT` sur le BPX.SERVER de la classe FACILITY
zSecRacfSearch : échec de création de l'unité d'exécution RECOJOB	Il est possible que le syslog z/OS produise un message INSUFFICIENT AUTHORITY	Vérifiez que l'ID RACF et l'ID SURROGAT de l'adaptateur disposent de l'accès en lecture et en écriture au répertoire de données READWRITE.
Could not set security environment for SURROGAT user	Non applicable	Accès PERMIT READ pour `IGIAGNT` sur BPX.SRV.<SURROGATID> dans CLASS SURROGAT
zSecRacfSearch : échec de création de l'unité d'exécution RECOJOB	DETAILAdapter log: tsoCmd: result is IKJ56644I NO VALID TSO USERID, DEF AUL T USER ATTRIBUTES USED	Assurez-vous que l'ID adaptateur possède un ID utilisateur TSO valide.
CTGIMU107W `La connexion au service désigné n'a pas pu être établie. Vérifiez les informations relatives au service, puis renouvelez l'opération.`	Une erreur d'entrée-sortie s'est produite lors de l'envoi d'une demande. Erreur : `Connection refused: connect`	Vérifiez que le service de l'adaptateur est en cours d'exécution. Pour plus d'informations sur le démarrage du service de l'adaptateur, voir Redémarrage du service de l'adaptateur.
	L'adaptateur a renvoyé une erreur pour une demande Bind. Code d'état : message d'erreur de l'adaptateur signalant des données identification non valides : `Authentication Failed`	Vérifiez que l'ID et le mot de passe d'authentification de l'adaptateur correspondent aux valeurs installées. Voir l'écran concernant les paramètres spécifiques à l'adaptateur dans Exécution de la boîte de dialogue ISPF.
	Une erreur d'entrée-sortie s'est produite lors de l'envoi d'une demande. Erreur : `com.ibm.daml.jndi. JSSESocketConnection .HANDSHAKE_FAILED:`	Si SSL est activé, vérifiez la configuration. Voir Configuration de l'authentification SSL. Le journal de l'adaptateur contient des détails sur les certificats chargés lors de l'initialisation.
CTGIMD812E `Une erreur s'est produite lors du traitement du message de réponse de l'adaptateur. L'erreur suivante a été générée. Erreur : Fin prématurée du fichier.`		Vérifiez que le service de l'adaptateur est en cours d'exécution. Pour plus d'informations sur le démarrage du service de l'adaptateur, voir Redémarrage du service de l'adaptateur.
tsoCmd : résultat : VOTRE ADMINISTRATEUR TSO DOIT AUTORISER L'UTILISATION DE CETTE COMMANDE	Non applicable.	Autorisez l'accès READ pour `IGIAGNT` sur le JCL de la classe TSOAUTH Par exemple : PE JCL CLASS(TSOAUTH) ID(IGIAGNT) ACCESS(READ)SETROPTS RACLIST(TSOAUTH) REFRESH
tsoCmd : RECOJOB n'a pas été soumis	tsoCmd : le résultat est `<chaîne de résultat>` zSecRacfSearch : échec de l'initialisation de reco_open	Vérifiez si la chaîne de résultat est un message TSO standard comme défini dans SYS1.MSGENU (IKJSCHEN). Si un exit personnalisé qui renvoie un message non standard est implémenté, excluez le travail de synchronisation de cet exit.
LDAP: error code 92		Augmentez la taille du journal des transactions. Voir Taille du journal des transactions DB2.
`*BPXI040I PROCESS LIMIT MAXPROCUSER HAS REACHED XX % OF ITS CURRENT CAPACITY OF XX FOR PID=XXX IN JOB ISIAGNT`		Augmentez le nombre de processus disponibles pour `adapterid`.