SYS_ACTIVE_COUNT

Fonction de script : Renvoie le nombre de tous les objets activés

Syntaxe

SYS_ACTIVE_COUNT (Status, Object Type [,Object] [,Group] [,Host])

Syntaxe	Description / format
Status	Statut de tous les objets affiché dans la perspective Surveillance des processus Format: Nom AE, littéral de script ou variable de script Valeurs autorisées : * : toutes les tâches, tous les statuts ANY_ABEND : tâches interrompues ANY_ALIVE : tâches d'un groupe ni terminées ni interrompues BLOCKED : tâches bloquées PREPARED : groupe de tâches enregistrées RUNNING : jobs actifs
Object Type	Description courte du type d'objet ou "*" pour tous les types d'objet. Format: Nom AE, littéral de script ou variable de script
Object	Nom d'un objet ou filtre sur plusieurs objets. Format: Nom AE, littéral de script ou variable de script L'utilisation de caractères génériques est possible. "*" signifie n'importe quelle chaîne de caractères et "?" exactement un caractère. Les paramètres suivants sont des critères de filtrage optionnels. Vous pouvez utiliser un, deux ou les trois paramètres dans n'importe quelle combinaison. Notez que si un paramètre n'est pas utilisé, la virgule doit tout de même apparaître. Exemple :SET &COUNT# = SYS_ACTIVE_COUNT("*", JOBS,,"MM.GROUP")
Group	Nom d'un groupe ou "*" pour tous les groupes. Format: Nom AE, littéral de script ou variable de script
Host	Nom de l'agent ou filtre sur plusieurs agents. Format: Nom AE, littéral de script ou variable de script L'utilisation de caractères génériques est possible. "*" signifie n'importe quelle chaîne de caractères et "?" exactement un caractère.

Code retour
Nombre d'objets listés dans la perspective Surveillance des processus

La fonction SYS_ACTIVE_COUNT peut être utilisée pour vérifier le nombre d'objets listés dans la perspective Surveillance des processus. Utilisez des paramètres pour limiter la recherche à certaines tâches. Des filtres peuvent être spécifiés sur le statut, le type d'objet, le nom d'objet, le groupe ou l'hôte. Toutes les combinaisons sont possibles.

Le paramètre host peut aussi être utilisé pour traiter les exécutions parallèles d'un job sur une machine spécifique. Vérifiez si un job est actif avec SYS_ACTIVE_COUNT, si ce job est exécuté périodiquement. Vous pouvez ainsi éviter que des exécutions se chevauchent. L'hôte cible peut ensuite être défini ensuite à l'aide de l'instruction de script :PUT_ATT. Lors de transferts de fichiers, l'hôte source et l'hôte cible sont pris en compte.

L'utilisation du paramètre hôte n'est pertinente que pour les types d'objets "JOBS", "JOBF", "EVNT" ou "*". Le filtrage sur l'hôte exclut tous les autres types d'objet car ceux-ci ne nécessitent aucun agent pour s'exécuter. C'est pourquoi l'exemple de script suivant renvoie toujours la valeur "0".

:SET &COUNT# = SYS_ACTIVE_COUNT(ANY_ABEND,JOBP,,,"*")

Notez que le système ne vérifie pas que l'hôte indiqué existe.

Lors du filtrage de jobs actifs à l'aide du paramètre "RUNNING", tous les jobs ayant un code retour système entre 1500 et 1599 sont pris en compte.

Exemples

Les exemples suivants illustrent le nombre d'objets listés dans perspective Surveillance des processus. Ceci inclut le nombre d'objets bloqués, interrompus et tous les événements.

:SET &COUNT# = SYS_ACTIVE_COUNT("BLOCKED", "*")

:SET &COUNT# = SYS_ACTIVE_COUNT(ANY_ABEND, "*")

:SET &COUNT# = SYS_ACTIVE_COUNT("*", EVNT)

L'exemple suivant compte les tâches enregistrées dans un groupe. La chaîne "FILE" doit apparaître dans tous les noms des tâches. 

:SET &COUNT# = SYS_ACTIVE_COUNT("PREPARED", "*", "*FILE*","GRP7")

L'exemple suivant illustre l'extraction du nombre de jobs qui utilisent l'agent "UNIX01".

:SET &COUNT# = SYS_ACTIVE_COUNT("*", "JOBS", "*",,"UNIX01")

Voir aussi :