Rubrique précédente: Exemple 2Rubrique suivante: Exemple


fetch—Extraction d'éléments

La commande fetch est valide uniquement sur les gestionnaires d'entreprise.

Utilisez la commande fetch pour extraire des fichiers d'un gestionnaire de domaines CA ITCM ou d'un groupe de gestionnaires de domaines CA ITCM vers une zone d'extraction du gestionnaire d'entreprise.

Cette action a le format suivant :

fetch  item=élément  [comment=commentaire] 
path=nom_chemin
{{area=nom_zone} | {domain=nom_domaine} | toAllAreas}
[cname=nom]
[sendTime="AAAA-MM-JJ hh:mm"] 
[haltTime="AAAA-MM-JJ hh:mm"]
zone

Spécifie le nom d'un domaine CA ITCMduquel les éléments sont extraits.

Vous pouvez spécifier ce paramètre plusieurs fois pour désigner une liste de domaines CA ITCM.

cname

Spécifie le le nom unique facultatif de conteneur de job.

Si un conteneur / une distribution de jobs portant le nom spécifié existe déjà, une erreur sera signalée.
Si la commande cname n'est pas codée, un nom générique est créé.

Commentaire

Spécifie un commentaire fournissant une description des éléments extraits ou des éléments.

Domaine

Spécifie le nom d'un ou plusieurs groupes de domaines CA ITCM d'où les éléments sont extraits.

Vous pouvez spécifier ce paramètre plusieurs fois pour désigner une liste de groupes de domaines CA ITCM.

halttime

Spécifie le date et heure auxquelles une commande de distribution doit être interrompue La date doit être au format ISO AAAA-MM-JJ hh:mm.

élément

Spécifie le nom de l'élément à extraire des gestionnaires de domaines CA ITCM ciblés.

chemin

Spécifie le chemin d'accès aux éléments à extraire.

Le nom de chemin spécifié est celui des gestionnaires de domaines CA ITCM ciblés.

Il doit apparaître dans le script conformément aux conventions du système d'exploitation.

Pour extraire des données d'un gestionnaire de domaines CA ITCM , la commande fetch utilise le paramètre path pour spécifier les éléments à extraire du gestionnaire de domaines.

Pour chaque utilisation, le chemin peut contenir des variables d'environnement définies par le système, l'utilisateur ou les fichiers de configuration de SD.

Pour plus de détails, reportez-vous à l'aide de l'explorateur DSM.

Dans SD, ces variables d'environnement doivent être placées entre des signes de pourcentage %.

sendTime

Spécifie le heure à laquelle la distribution associée doit être envoyée aux gestionnaires de domaines désignés. La date doit être au format ISO AAAA-MM-JJ hh:mm. Si ce paramètre n'apparaît pas dans le script, la date et l'heure courantes sont utilisées.

toAllAreas

Si ce paramètre est défini dans le script, la distribution associée sera envoyée à tous les domaines CA ITCM enregistrés sur le gestionnaire d'entreprise.

Utilisation du symbole %

Considérons que la variable %SAMPLES% est définie à la fois sur le serveur d'entreprise et le gestionnaire de domaines, à la seule différence que la variable pointe vers c:\samples sur le gestionnaire d'entreprise et vers g:\examples sur le gestionnaire de domaines.

Tous les fichiers txt doivent être extraits. Lancez maintenant la commande suivante à partir de l'invite de commande Windows :

cadsmcmd fetch item=sample path=%SAMPLE%\*.txt area=domain_manager

Vous obtenez une erreur ou des résultats inattendus. SAMPLE étant défini sur le gestionnaire d'entreprise, l'invite de commande résout la variable et lance la commande cadsmcmd avec le paramètre de chemin suivant :

path=c:\samples\*.txt

Pour éviter la résolution des variables par l'invite de commande Windows, le symbole de pourcentage ne doit pas être interprété par l'invite de commande. Pour ce faire, insérez le signe ^ avant le signe de pourcentage.

Ainsi, dans l'invocation suivante, tous les paramètres sont transmis inchangés par l'invite de commande à la commande cadsmcmd ; la variable d'environnement SAMPLES est résolue sur le site du gestionnaire de domaines :

cadsmcmd fetch item=samples path=^%SAMPLES^%\*.txt area=domain_manager