Instruction de script : Modifie les paramètres système au cours de l'exécution.
:SET_UC_SETTING Setting, Component, Value
Syntaxe |
Description / format |
---|---|
Paramètre |
Paramètre système devant être modifié. 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 |
Composant |
Composant dont les paramètres système doivent être modifiés. Pour WORKLOAD_MAX, WORKLOAD_MAX_FT et WORKLOAD_MAX_JOB : Nom d'un agent actif ou d'un groupe d'agents. |
Valeur |
Nouvelle valeur assignée au paramètre système. Pour WORKLOAD_MAX, WORKLOAD_MAX_FT et WORKLOAD_MAX_JOB : Toute valeur entre -1 et 100000, ou UNLIMITED. Pour SET_TRACE : Options de trace à 16 caractères. Attention : Vous ne pouvez pas changer un processus de travail en processus de dialogue s'il effectue un rôle de serveur. |
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.
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 |
---|---|
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