TRACE

La fonction de script TRACE vous permet de sortir des valeurs vers un fichier de trace.

Syntaxe

TRACE (Trace option, trace level, trace output)

Paramètres

• TRACE

  Ecrit les valeurs 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.

• Trace output

  Texte libre servant de génération de trace.

  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

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 activer la sortie de trace, tenez compte des instructions suivantes :

  • L'option de trace indiquée doit également être activée dans Perspective Administration (dans les propriétés des processus serveur, voir Processus & utilisation).

  • 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]).

Exemple

Dans l'exemple suivant, une trace pour le contenu d'une variable de script est activée. La trace est réussie si une trace de la 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 &NUMBER# = 10
:SET &RET# = TRACE(2,4,"The variable NUMBER has the value: &NUMBER#")

Voir aussi :

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