TRACE_DUMP

La fonction de script TRACE_DUMP vous permet de donner la valeur de la zone mémoire dans un fichier de trace.

Syntaxe

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

Paramètres

• TRACE_DUMP

  Fournit la valeur de la zone mémoire dans un fichier de trace

• Trace option

  Paramètres de trace

  Format : variable de script ou nombre

  Valeurs autorisées :

  • 1 TCP/IP
  • 2 Database
  • 4 Srcall
  • 5 Memio
  • 6 JCL
  • 7 Memsv
  • 8 SNMP
  • 9 Zuxml
  • 10 Cache
  • 12 Ucds
  • 13 Xscript
  • 14 UC4global
  • 16 Minimal

• Trace level

  Taille de la trace

  Format : variable de script ou nombre

  Les valeurs autorisées dépendent de l'option de trace sélectionnée.

• Memory range

  Zone mémoire qui doit être enregistrée

  Format : littéral de script ou variable de script

  Valeurs autorisées :

  "WORK MEMORY" : mémoire de travail

  "LOCAL MEMORY" : mémoire locale

  "XML + identifiant XML"

  "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"

  Remarque : Séparez plusieurs zones mémoire qui doivent être enregistrées par des virgules.

• Additional info

  Texte ou informations supplémentaires libres.

  Format : littéral de script ou variable de script

Codes retour

• 0

  Trace réussie

• 20208

  Le niveau de trace n'est pas dans la plage autorisée

• 20209

  La zone mémoire indiquée n'est pas prise en charge

• 20210

  L'identifiant XML est incorrect

• 20211

  La table n'existe pas

Remarques :

• 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 :

  • L'option de trace indiquée doit être également activée dans Perspective Administration(Options avancées - Traçage).

  • En plus, le niveau de trace spécifié doit être au moins aussi élevé que celui qui a été défini dans les propriétés.

• La trace est écrite dans le fichier spécifié 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 fichier log et prend en compte toutes les valeurs.

Exemple

Dans l'exemple ci-dessous, une trace est activée pour plusieurs zones mémoire. La trace est résussie si une trace de base de données avec au moins 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")

Voir aussi :

• LOG_DUMP - Ecrit des valeurs de la zone mémoire dans un fichier log
• Logique fonctionnelle avec les scripts