|
ROLLBACK_UC_OBJECT |
Activation d'objets |
SYS_STATE_ACTIVE |
|
Fonction de script : Renvoie le nombre de tous les objets activés
SYS_ACTIVE_COUNT(Status, Object Type [,Objet] [,Groupe] [,Hôte])
|
Syntaxe |
Description / format |
|---|---|
|
Statut |
Statut des objets affichés dans la fenêtre des activités. Valeurs autorisées : "*", "ANY_ABEND", "BLOCKED", "ANY_ALIVE", "PREPARED" et "RUNNING" "*" : toutes les tâches, tous les statuts |
|
Type d'objet |
Description courte du type d'objet ou "*" pour tous les types d'objet. |
|
Les paramètres suivants sont des critères de filtrage facultatifs. 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. Example: |
|
|
Objet |
Nom d'un objet ou filtre sur plusieurs objets. L'utilisation de caractères génériques est possible. "*" signifie n'importe quelle chaîne de caractères et "?" exactement un caractère. |
|
Groupe |
Nom d'un groupe ou "*" pour tous les groupes. |
|
Hôte |
Nom de l'agent ou filtre sur plusieurs agents. 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 fenêtre des activités. |
La fonction de script SYS_ACTIVE_COUNT peut être utilisée pour vérifier le nombre d'objets listés dans la fenêtre des activités. 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 hôte 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.
Les exemples suivants comptent le nombre d'objets listés dans la fenêtre des activités. 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 récupère le nombre de jobs qui utilisent l'agent "UNIX01".
:SET &COUNT# = SYS_ACTIVE_COUNT("*", "JOBS", "*",,"UNIX01")
Rubriques connexes :
| Elément de script | Description |
|---|---|
| Retourne le nombre de jobs enregistrés dans des groupes. |
Eléments de script - Activation d'objets
Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle