Manuel des Scripts Automation Engine > Organisation fonctionnelle > Statuts et utilisation du système > :SET_UC_SETTING

:SET_UC_SETTING

Instruction de script : Modifie les paramètres système au cours de l'exécution.

Syntaxe

:SET_UC_SETTING Setting, Component, Value

Syntaxe

Description / format

Paramètre 

Paramètre système devant être modifié.
Format : Nom AE, littéral de script ou variable de script

Valeurs autorisées : WORKLOAD_MAX, WORKLOAD_MAX_FT, WORKLOAD_MAX_JOB, SET_TRACE, SERVER_MODE

WORKLOAD_MAX : nombre maximal de ressources que l'agent fournit pour les transferts de fichiers et les jobs
WORKLOAD_MAX_FT : nombre maximal de ressources que l'agent fournit pour les transferts de fichier.
WORKLOAD_MAX_JOB : nombre maximal de ressources que l'agent fournit pour les jobs
SET_TRACE : options de trace pour les processus de travail d'un système AE ou d'un agent.
SERVER_MODE : type de processus serveur.

Composant 

Composant dont les paramètres système doivent être modifiés.
Format : littéral de script, variable de script, nom AE ou fonction de script

Pour WORKLOAD_MAX, WORKLOAD_MAX_FT et WORKLOAD_MAX_JOB : Nom d'un agent actif ou d'un groupe d'agents.
Pour SET_TRACE : Nom d'un système AE ou d'un agent.
Pour SERVER_MODE : Nom du processus serveur.

Valeur 

Nouvelle valeur assignée au paramètre système.
Format : littéral de script, variable de script ou fonction de script

Pour WORKLOAD_MAX, WORKLOAD_MAX_FT et WORKLOAD_MAX_JOB : Toute valeur entre -1 et 100000, ou UNLIMITED.
 Notez que les valeurs supérieures à 100000 sont interprétées comme UNLIMITED.

Pour SET_TRACE : Options de trace à 16 caractères.
Pour SERVER_MODE : Le type de serveur, les valeurs autorisées sont "D" pour passer à un processus de dialogue et "W" pour passer à un processus de travail.

Attention : Vous ne pouvez pas changer un processus de travail en processus de dialogue s'il effectue un rôle de serveur.

Remarques

Vous pouvez utiliser l'instruction de script :SET_UC_SETTING pour modifier trois paramètres système. Les modifications sont valables jusqu'à l'attribution d'une nouvelle valeur ou lorsque les processus serveur ou l'agent sont terminés.

Pour modifier les paramètres du système, vous avez besoin de l'autorisation "Modifier à l'exécution" et du privilège "Créer une information de diagnostic".

Cette instruction de script a pour effet d'écrire toutes les transactions ouvertes dans la base de données AE.

Si vous changez les options de trace pour les WP, vous ne pouvez les changer que pour tous ensemble. Il n'est pas possible de les changer pour des WP individuels.

Vous devez changer les options de trace des CP un par un.

Modification des options de trace

En définissant des options de trace, vous pouvez utiliser un script pour journaliser le comportement des processus de travail et des agents dans des cas exceptionnels. Les processus de travail ou les agents n'ont pas besoin d'être arrêtés pour cela, mais définir des options de trace peut entraîner d'importants volumes de données et il peut y avoir une perte de performances.
Automic recommande ne ne définir des options de trace qu'en étroite coopération avec le support technique. 

Pour modifier les options de trace, vous pouvez utiliser le paramètre SET_TRACE. La valeur est une chaîne de 16 caractères. Chaque caractère représente un indicateur de trace spécifique (comme le premier caractère d'une trace TCP/IP).
L'ordre des indicateurs de trace correspond à l'ordre utilisé dans la boîte de dialogue Propriétés de la supervision système pour leprocessus serveur et les agents.

Si vous redémarrez un seul processus de travail, il utilisera les options de trace définies dans le fichier INI. Tous les autres processus de travail utilisent les valeurs spécifiées via l'instruction de script :SET_UC_SETTING jusqu'à leur redémarrage.

Exemples

Le premier exemple définit le nombre maximal de ressources que l'agent WIN01 fournit pour les jobs et les transferts de fichiers à 1000. Le résultat est écrit dans le rapport d'activation.

:SET_UC_SETTING WORKLOAD_MAX, WIN01, 1000
:
SET &RET# = GET_UC_SETTING(WORKLOAD_MAX_JOB, WIN01)
:
PRINT &RET#

Le deuxième exemple récupère le nom du système AE puis active la trace TCP/IP ses processus de travail.

:SET &TRC# = GET_UC_SYSTEM_NAME()
:
SET_UC_SETTING SET_TRACE, &TRC#, "1000000000000000"

L'exemple suivant change le processus serveur AE#WP003 en processus de dialogue, lorsque celui-ci est actif.

:IF SYS_SERVER_ALIVE("AE#WP003") = "Y"
:   
SET_UC_SETTING "SERVER_MODE", "AE#WP003", "D"
:
ELSE
:   
SEND_MSG "ADMIN","AE","Work process AE#WP003 is not active!"
:
ENDIF

In this example the trace options for the agent WINAGENT01 are set with the noted values, those to be found in the agent's properties dialog in the System Overview:

:SET_UC_SETTINGSET_TRACE,"WINAGENT01","2400000000000000,MEMORY,128,SIMPLE,FileTransfer * Interruption anormale."

 

Rubriques connexes :

Elément de script Description

GET_UC_SETTING

Lit les paramètres système courants.

Eléments de script - Paramètres et statuts du système

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

Eléments de script - Répartition fonctionnelle