: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
Setting	Paramètre système à modifier. Format: Nom AE, littéral de script ou variable de script Valeurs autorisées : WORKLOAD_MAX : quantité maximale de ressources que l'agent fournit pour les transferts de fichiers et les jobs. WORKLOAD_MAX_FT : quantité maximale de ressources que l'agent fournit pour les transferts de fichiers. WORKLOAD_MAX_JOB : quantité maximale de ressources que l'agent fournit pour les jobs. SET_TRACE : options de trace pour les processus de travail d'un agent ou système AE. SERVER_MODE : type de processus serveur.
Component	Composant du paramètre système à modifier. 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 agent ou système AE. Pour SERVER_MODE : Nom du processus serveur.
Value	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. Les valeurs supérieures à 100000 sont interprétées comme UNLIMITED. Pour SET_TRACE : Options de trace à 16 caractères. Pour SERVER_MODE : Type de serveur. Les valeurs autorisées sont "D" pour passer à un processus de dialogue et "W" pour passer à un processus de travail. Vous ne pouvez pas changer un processus de travail en processus de dialogue s'il a un rôle de serveur.
Trace Target	Les traces cibles y sont consignées. Format: Nom AE, littéral de script ou variable de script Pour SET_TRACE : FILE : Consigne les traces dans un fichier. MEMORY : Consigne les traces dans la mémoire interne des processus serveur ou de l'agent.
Memory Buffer Size	Taille de mémoire disponible en écriture. Format: Nom AE, littéral de script ou variable de script Pour SET_TRACE : Taille du tampon en Mo.
Search Text	Texte à rechercher dans les traces. Format: Nom AE, littéral de script ou variable de script Pour SET_TRACE : Texte de recherche.

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

L'instruction de script écrit toutes les transactions ouvertes du script dans la base de données AE. Pour plus d'informations, voir Traitement du script.

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.

Remarque : Ne définissez les options de trace qu'en étroite coopération avec l'équipe d'assistance.

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 de propriétés Perspective Administration pour les processus 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

Dans le premier exemple, la quantité maximale de ressources que l'agent WIN01 fournit pour les jobs et les transferts de fichiers est 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

Dans cet exemple, les options de trace du système AE sont définies avec des valeurs notées pour rechercher le premier job qui s'est terminé anormalement (message d'erreur 11003).

Si le système trouve ce type de message dans une trace, il écrit la trace dans un fichier et non dans la mémoire.

:SET_UC_SETTINGSET_TRACE, &$SYSTEM#,"2400000000000000", "MEMORY", "128", "U00011003"

Pour plus d'informations, voir la boîte de dialogue des propriétés de l'agent dans Perspective Administration.

Dans cet exemple, les options de trace pour l'agent WINAGENT01 sont définies avec des valeurs notées pour rechercher le premier transfert de fichier qui s'est terminé anormalement.

Si le système trouve ce type de message dans une trace, il écrit la trace dans un fichier et non dans la mémoire.

:SET_UC_SETTINGSET_TRACE,"WINAGENT01","2400000000000000", "MEMORY", "128", "FileTransfer * ended abnormally."

Pour plus d'informations, voir les propriétés de l'agent dans Perspective Administration.

Voir aussi :