wrapper.thread_dump_control_code

Compatibilité :3.3.0
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :WindowsMac OSX (Non pris en charge)Linux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

AVERTISSEMENT

NE MODIFIEZ PAS la valeur de cette propriété tant qu'une application utilisant le fichier de configuration est installée en tant que service Windows. Veuillez désinstaller le service existant AVANT de modifier cette propriété. Le service avec la nouvelle valeur pourra ensuite être réinstallé ultérieurement en toute sécurité.

Cette propriété n'est utilisée que sur les plates-formes Windows.

Le Wrapper est capable d'initier un thread dump en réponse à un code de contrôle défini par l'utilisateur lorsqu'il s'exécute en tant que service Windows. Cette propriété permet de spécifier le code à utiliser, ou même de désactiver cette fonctionnalité, afin de répondre aux besoins d'une application spécifique. La valeur par défaut est "255", avec des valeurs valides dans la plage "128-255", ou "0" (zéro) pour désactiver.

Exemple :
wrapper.thread_dump_control_code=255

Il n'est possible de demander des thread dumps à l'aide de codes de contrôle de service que lorsque le service s'exécute en tant que service Windows. Cette propriété n'a aucun effet lors de l'exécution en mode console.

Il existe trois façons d'initier un thread dump sur un service en cours d'exécution à l'aide du code de contrôle.

  • La première consiste à utiliser la commande dump du Wrapper "-d" comme suit :
    Exemple de commande :
    wrapper.exe -d ..\conf\wrapper.conf
    
  • La deuxième consiste à utiliser la capacité du Wrapper à envoyer une commande de service arbitraire comme suit :
    Exemple de commande :
    wrapper.exe -l=255 ..\conf\wrapper.conf
    
  • La troisième consiste à utiliser les outils de ligne de commande Windows standard pour envoyer le code :
    Exemple de commande :
    sc control myapp 255
    

Il est également possible d'envoyer le code de contrôle de manière programmatique à l'aide des API Windows appropriées.