SYS_INFO

Fonction de script : Lecture des informations relatives aux systèmes AE.

Version Automation Engine

Syntaxe

SYS_INFO (component, VERSION, [ type ], [component name])

Syntaxe	Description / format
Component	Composant dont la version doit être récupérée Format : littéral de script ou variable de script Valeurs autorisées : "SERVER" et "INITIALDATA"
VERSION	Ce mot clé indique la version Automation Engine des composants a récupérer.
Type	Spécifie la partie de la version qui doit être lue. Format: Nom AE, littéral de script ou variable de script Valeurs autorisées : "MAJOR" : version majeure "MINOR" : version mineure "PATCH" : numéro du pack de service "RELEASE_IDENTIFIER" : type et numéro de build "ALL" (valeur par défaut) : version complète
Component name	Nom de l'agent dont la version doit être récupérée. Format: Nom AE, littéral de script ou variable de script

Codes retour
La version de Automation Engine des composants requis. "20291" : l'agent indiqué n'a pas été trouvé. "20680" : une valeur est inconnue pour cette partie de la version. "20863" : une valeur non valide a été saisie pour le composant. "20864" : le deuxième paramètre n'est pas VERSION.

Codes retour

La version de Automation Engine des composants requis.

"20291" : l'agent indiqué n'a pas été trouvé.
"20680" : une valeur est inconnue pour cette partie de la version.
"20863" : une valeur non valide a été saisie pour le composant.
"20864" : le deuxième paramètre n'est pas VERSION.

Cette fonction de script récupère la version de Automation Engine, d'un agent ou des données initiales de la base de données AE.

Pour lire la version d'un agent, définissez la valeur "AGENT" dans le paramètre Componentt et spécifiez le nom de l'agent dans le paramètre Component name.

Une version Automation Engine est composée de diverses informations (version majeure, version mineure, ...). Vous pouvez utiliser le paramètre Type si vous ne voulez lire qu'une partie spécifique d'une version.

Exemples

L'exemple suivant illustre la lecture de la version de Automation Engine :

:SET &VERSION# = SYS_INFO(SERVER, VERSION)

Le second exemple récupère la version des données initiales de la base de données AE.

:SET &VERSION# = SYS_INFO(INITIALDATA, VERSION)

Le troisième exemple lit la version de l'agent WIN01 :

:SET &VERSION# = SYS_INFO(AGENT, VERSION,,"WIN01")

Le quatrième exemple récupère chaque partie de la version de Automation Engine (majeure, mineure, pack de service, numéro de version et de build) et les écrit dans le rapport d'activation. Finalement, le numéro de version complet est affiché.

:SET  &VERSION# = SYS_INFO(SERVER, VERSION,MAJOR)
:PRINT "Automation Engine - Major Version: &VERSION#"
:SET  &VERSION# = SYS_INFO(SERVER, VERSION,MINOR)
:PRINT "Automation Engine - Minor Version: &VERSION#"
:SET  &VERSION# = SYS_INFO(SERVER, VERSION,PATCH)
:PRINT "Automation Engine - Service Pack: &VERSION#"
:SET  &VERSION# = SYS_INFO(SERVER, VERSION,RELEASE_IDENTIFIER)
:PRINT "Automation Engine - Build: &VERSION#"
:SET  &VERSION# = SYS_INFO(SERVER, VERSION,ALL)
:PRINT "Automation Engine - Version: &VERSION#"

Exemple d'affichage dans le rapport d'activation :

2013-05-07 16:16:52 - U0020408 Automation Engine - Major Version: 10
2013-05-07 16:16:52 - U0020408 Automation Engine - Minor Version: 0
2013-05-07 16:16:52 - U0020408 Automation Engine - Patch: 0
2013-05-07 16:16:52 - U0020408 Automation Engine - Build: -dev+build.954
2013-05-07 16:16:52 - U0020408 Automation Engine - Version: 10.0.0-dev+build.954

Charge de travail

Syntaxe

SYS_INFO (MQPWP, BUSY, Period)
SYS_INFO (Message queue, COUNT)
SYS_INFO (Message queue, LENGTH, Period)

Syntaxe	Description / format
Message queue	File d'attente des messages pour laquelle les informations doivent être récupérées. Format : littéral de script ou variable de script Valeurs autorisées : "MQPWP", "MQWP" , "MQDWP", "MQOWP" et "MQRWP" "MQPWP" : file d'attente des messages du processus de travail primaire "MQWP" : file d'attente des messages des processus de travail "MQDWP" : file d'attente des messages des processus de dialogue "MQOWP" : file d'attente des messages des sorties "MQRWP" : file d'attente des messages des calculs de ressources
BUSY	Fournit la charge de travail de Automation Engine en pourcentage.
COUNT	Indique le nombre de messages dans la file d'attente.
LENGTH	Indique la durée moyenne de traitement de la file d'attente des messages.
Period	Période utilisée pour calculer l'utilisation ou de la durée moyenne de traitement. Format : littéral de script ou variable de script Valeurs autorisées : "01", "10" et "60" "01" : la dernière minute. "10" : les 10 dernières minutes. "60" : la dernière heure.

Codes retour
"20876" : Queue des messages inexistante. "20864" : Deuxième paramètre non valide. "20877" : La période ne correspond pas aux valeurs autorisées. BUSY : Charge de travail de Automation Engine, en pourcentage. COUNT : Nombre de messages dans mis en queue. LENGTH : Durée moyenne de traitement de la queue des messages.

Codes retour

"20876" : Queue des messages inexistante.
"20864" : Deuxième paramètre non valide.
"20877" : La période ne correspond pas aux valeurs autorisées.

BUSY :
Charge de travail de Automation Engine, en pourcentage.

COUNT :
Nombre de messages dans mis en queue.

LENGTH :
Durée moyenne de traitement de la queue des messages.

La fonction de script récupère les données des files d'attente de messages.

Conseil : Vous pouvez extraire le pourcentage de la capacité de charge utilisée par Automation Engine avec le mot-clé BUSY ou les fonctions de script suivantes :

Exemples

Le premier exemple récupère la charge de travail de Automation Engine pendant les 10 dernières minutes. Un message est envoyé à un utilisateur si elle est supérieure à 80%.

:IF SYS_INFO(MQPWP, BUSY, "10") > 80
: SEND_MSG SMITH,AE,"Workload of Automation Engine is above 80%"
:ENDIF