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

SYS_INFO

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

Version Automation Engine

[Automation Engine version] [Charge de travail]

Syntaxe

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

Syntaxe

Description / format

Composant

Composants dont la version doit être déterminé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 obtenir.
Type

Indique la partie de la version à lire.
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
Nom du composant

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

Version de Automation Engine des composants requis.

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

Commentaires

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. Vous trouverez plus d'informations sur la structure du numéro de version dans le chapitre Automation EngineDénominations des versions .

Pour lire la version d'un agent, la valeur "AGENT" doit être attribuée au paramètre Composant et le nom de l'agent doit être attribué au Nom du composant.

Une version Automation Engine est composée de diverses informations (version majeure, version mineure, ...). Pour lire seulement une certaine partie de la version, le paramètre Type peut être utilisé.

Exemples

Dans l'exemple suivant, la version de Automation Engine est lue :

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

Le second exemple détermine la version des données initiales de la base de données AE.

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

Dans le troisième exemple, la version de l'agent WIN01 est lue :

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

Le quatrième exemple détermine chaque partie de la version de Automation Engine (majeure, mineure, pack de service, numéro de version et de build) et les affiche dans le rapport d'activation. Le numéro de version complet s'affiche ensuite.

: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 protocole 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

[Automation Engine version] [Charge de travail]

Syntaxe

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

Syntaxe

Description / format

File d'attente des messages

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 du processus de travail
"MQDWP" : file d'attente des messages du 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 en pourcentage de Automation Engine.
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.
Période

Période utilisée pour le calcul de 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 dix dernières minutes
"60" : la dernière heure


Codes retour

"20876" : la file d'attente des messages n'existe pas.
"20864" : le deuxième paramètre n'est pas valide.
"20877" : la période ne correspond pas aux valeurs autorisées.

BUSY :
la charge de travail en pourcentage de Automation Engine.

COUNT :
nombre de messages dans la file d'attente

LENGTH :
durée moyenne de traitement de la file d'attente des messages

Commentaires

La fonction de script détermine les données concernant les files d'attente des messages.

Vous pouvez récupérer la charge de travail en pourcentage de Automation Engine avec le mot-clé BUSY, mais aussi avec les fonctions de script SYS_BUSY_01, SYS_BUSY_10 et SYS_BUSY_60.

Exemples

Le premier exemple demande la charge de travail de Automation Engine pendant les 10 dernières minutes. Si elle est supérieure à 80 %, un message est envoyé à un utilisateur.

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

Le deuxième exemple lit le nombre de messages se trouvant dans la file d'attente du processus de dialogue.

:SET  &NUMBER# = SYS_INFO(MQDWP, COUNT)

Le troisième exemple indique la durée de traitement actuelle de la file d'attente des messages du processus de travail pendant la dernière heure.

:SET &DURATION# = SYS_INFO(MQWP, LENGTH, "60")

 

Rubriques connexes :

Statuts et utilisation du système

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