Manuel d'administration > Outils de diagnostic > TRACE_DUMP

TRACE_DUMP

Fonction de script : Génère un fichier de trace contenant les valeurs de la zone de mémoire.

Syntaxe

TRACE_DUMP (Trace option, trace level, memory range[, memory range,...][, additional info])

Syntaxe

Description / format

Option_trace

Paramètres de trace
Format : variable de script ou nombre

Valeurs autorisées :

"1" - TCP/IP
"2" - Base de données
"4" - Srcall
"5" - Memio
"6" - JCL
"7" - Memsv
"8" - SNMP
"9" - Zuxml
"10" - Cache
"12" - Ucds
"13" - Xscript
"14" - UC4global
"16" - Minimal

Niveau_trace

Etendue de la trace
Format : variable de script ou nombre

Les valeurs autorisées dépendent des options de trace choisies.

Zone_mémoire

Zone destinée à l'enregistrement dans la mémoire

Format : littéral de script ou variable de script

Valeurs autorisées :
"MEMOIREDETRAVAIL"
"MEMOIRELOCALE"
"XML + XML-Handle"
"DB + Nom de Table(Nom de colonne;Nom de colonne;...)"
"DB + Nom de Table"
"SCRIPT_VARA"
"SCRIPT_PRG"
"USER_TAB"
"CLNT_TAB"
"EX_TAB"
"*_TAB"
"GIVE_ME_ALL"

Si plusieurs zones de mémoire doivent être enregistrées, il faut les séparer par des virgules.

Information Complémentaire

Texte libre servant d'informations supplémentaires.

Format : littéral de script ou variable de script

Codes retour

"0" - Trace réussie.
"20208" - Le niveau de Trace n'est pas situé dans le domaine autorisé.
"20209" - Le domaine de mémoire donné n'est pas pris en charge.
"20210" - Le XML-Handle est incorrect.
"20211" - La table n'existe pas.

Commentaires

Cette fonction de script ne sert qu'à des fins de diagnostic et ne doit être utilisée qu'en coopération étroite avec le support.

Pour que la trace puisse être générée, il faut respecter les points suivants :

La trace est générée dans le fichier que vous avez défini dans le fichier INI du serveur (voir la section [TRACE]).

La fonction de script LOG_DUMP fonctionne de manière similaire mais écrit le résultat dans le fihcier log et prend en compte toutes les valeurs.

Exemple

Dans l'exemple, une trace est réalisée pour diverses zones de mémoire. La trace s'est bien terminée si une trace de base de données avec l'un des quatre niveaux de trace a été activée dans les propriétés des processus serveur.

:SET &RET# = TRACE_DUMP(2,4, "DB + XAO(XAO_Idnr, XAO_MsgNr), LOCAL_MEMORY, SCRIPT_VARA", "Various Information")

 

Rubriques connexes :

Elément de script Description
LOG_DUMP Génère un fichier log contenant les valeurs de la zone de mémoire.

TRACE

Génère un fichier de trace contenant des valeurs.

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle