GET_CONSOLE

Traitement d'Evènements

GET_WIN_EVENT

---

GET_FILESYSTEM

Fonction de script : récupère différentes valeurs du système de fichiers d'une machine à partir du chemin indiqué.

Syntaxe

GET_FILESYSTEM([Host], [Path], FileSystem Value,[Unit], [Include sub-directories], [Login object])

Remarques

Cet élément de script ne peut être utilisé qu'avec des agents de système d'exploitation (Windows, UNIX, VMS, z/OS, OS/400, NSK et BS2000).

Le code de retour de cette fonction est zéro si une erreur survient lors de l'accès aux informations sur le système de fichiers (telle que chemin introuvable).

L'instruction de script :ON_ERROR permet de définir la réaction à cette erreur. L'analyse de l'erreur est possible avec les fonctions de script pour le traitement des erreurs. Le traitement du script se poursuit mais il peut aussi être interrompu.

Si vous utilisez cette fonction de script avec PATH_FILE_COUNT, la fonction peut renvoyer 0 si le répertoire ne contient aucun fichier. Vous devez donc utiliser en plus les fonctions de script pour le traitement des erreurs (par ex. SYS_LAST_ERR_NR). Les erreurs (telle qu'un hôte inactif) peuvent ainsi être détectées et il est possible de différencier si le code retour 0 se rapporte au nombre de fichiers ou à une erreur.

 Le manque de droits d'accès aux dossiers du système (information de volume système, Windows) retourne également un code retour 0.

L'instruction de script écrit toutes les transactions ouvertes du script dans la base de données AE.

Paramètres facultatifs Hôte et Chemin

Exemple 1 :

GET_FILESYSTEM peut être utilisé dans les onglets Traitement de tous les objets activables (tels que les Workflows). Il faut toujours indiquer un hôte et un chemin lors de l'exécution de cette fonction de script. Ces paramètres ne peuvent être omis que si GET_FILESYSTEM a déjà été exécuté une fois dans le script. Dans ce cas la valeur retournée est la même que celle de l'exécution précédente.

:SET &NumberFiles# = GET_FILESYSTEM(WIN01, "C:\Temp", PATH_FILE_COUNT)
!several script lines
:SET &NumberFiles# = GET_FILESYSTEM(,, PATH_FILE_COUNT)
!several script lines
:SET &NumberFiles# = GET_FILESYSTEM(WIN01, "C:\Temp", PATH_FILE_COUNT)

La première exécution de GET_FILESYSTEM renvoie le nombre de fichiers dans le répertoire C:\Temp (par ex. 50). Si certains de ces fichiers on été supprimés, cette fonction de script continuera à renvoyer la valeur 50. Finalement, la troisième exécution recalcule les valeurs du système de fichiers et renvoie un nombre de fichiers inférieur.

Exemple 2 :

Si un événement de type système de fichier survient, la fonction de script GET_FILESYSTEM peut être utilisée pour récupérer des informations sur le système de fichiers, la mémoire ou l'espace disque. Toutes les informations sont transférées à l'agent. Chaque élément peut être interrogé séparément en indiquant la valeur du système de fichiers. Dans ce cas, la fonction de script est exécutée sans indiquer d'hôte ni de chemin, car ces paramètres sont déjà définis dans l'onglet Détail de l'événement.

OS/400 : Particularités des valeurs du système de fichiers
Spécifiez toujours une bibliothèque et un fichier pour obtenir des valeurs valides du système de fichiers.

z/OS : Particularités des valeurs du système de fichiers
PATH_SPACE_ALLOCATED : l'espace mémoire attribué dans z/OS ne peut pas être récupéré. Retourne l'espace disque utilisé
PATH_SPACE_USED : espace disque utilisé.
PATH_SPACE_UNUSED : est toujours nul, car cette valeur correspond à la différence entre PATH_SPACE_ALLOCATED et PATH_SPACE_USED.

Si un nom GDG est indiqué, la fonction de script peut récupérer les valeurs du système de fichiers suivantes : PATH_SPACE_USED et PATH_FILE_COUNT.

Particularités des valeurs du système de fichiers BS2000 par rapport aux autres systèmes d'exploitation
Seulement dans BS2000, l'espace disque alloué et utilisé peuvent différer. Par exemple, 1000 pages PAM peuvent être réservées. Mais le contenu du fichier ne comporte que 100 pages PAM.

Ce qui suit vaut pour d'autres systèmes d'exploitation comme UNIX, VMS et MPE :
PATH_FILE_COUNT : nombre de fichiers
PATH_FOLDER_COUNT : nombre de dossiers
PATH_SPACE_USED : somme de la taille des fichiers pour le chemin indiqué
PATH_SPACE_TOTAL : identique à PATH_SPACE_USED et PATH_SPACE_ALLOCATED

Exemples

Dans l'exemple suivant, la fonction de script GET_FILESYSTEM est utilisée pour récupérer le nombre de fichiers existants et pour envoyer le message correspondant. Il s'agit d'un extrait du script d'un événement, les deux premiers paramètres n'étant pas spécifiés.

:SET &NUMBER# = GET_FILESYSTEM(,,PATH_FILE_COUNT)  
:SEND_MSG "BROWN","IT","&NUMBER# files are available for processing."

Dans l'exemple suivant, la fonction de script GET_FILESYSTEM est utilisée dans le script d'un job. Toutes les informations disponibles sur le disque sont récupérées et écrites dans le protocole d'activation.

: SET &E1# = GET_FILESYSTEM(WIN01,"E:\",FILESYSTEM_SPACE_TOTAL,MB)
: SET &E2# = GET_FILESYSTEM(,,FILESYSTEM_SPACE_USED,MB)
: SET &E3# = GET_FILESYSTEM(,,FILESYSTEM_SPACE_FREE,MB)  
: PRINT "Memory capacity of the drive: &E1# MB"
: PRINT "Used drive space: &E2# MB"
: PRINT "Available space: &E3# MB"  

Les exemples suivants montrent l'utilisation de la fonction de script avec GDG :

!Number of file generations of the group TEST.XXX
:SET &FILENAME# = GET_FILESYSTEM("MVSHOST", "TEST.XXX(*)", PATH_FILE_COUNT)

!Sum of the space used by the current generation
:SET &SPACE# = GET_FILESYSTEM("MVSHOST", "TEST.XXX(0)", PATH_SPACE_USED)

Rubriques connexes :

Scripts - Manipulation des événements

Exemples :
Affichage à l'aide du Cockpit

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