DEFINE CLIENTACTION (Définition d'une opération client ponctuelle)

Classe de privilège

Pour exécuter cette commande, vous devez disposer des privilèges système, des privilèges de règles illimités ou restreints pour le domaine de règles auquel le planning appartient.

Paramètres

nom_poste (obligatoire)

Spécifie le nom du noeud client qui traite la planification associée à l'action. Si vous spécifiez plusieurs noms de noeud, séparez-les par une virgule, sans espace intermédiaire. Vous pouvez utiliser le caractère générique astérisque pour spécifier plusieurs noms.

DOmain

Permet de définir la liste des domaines de règles qui permettent de limiter la liste des noeuds client. Seuls les noeuds client qui sont affectés à l'un des domaines de règles définis seront impliqués dans le planning. Tous les clients affectés à l'un des domaines correspondant seront impliqués dans le planning. Si vous entrez plusieurs noms de domaines, séparez-les par une virgule mais sans ajouter d'espaces. Si aucune valeur n'est affectée à ce paramètre, tous les domaines de règles seront inclus dans la liste.

ACTion

Indique l'action exécutée lorsque cette planification est traitée. Les valeurs admises sont les suivantes :

Incremental

La planification effectue une sauvegarde de tous les fichiers nouveaux ou modifiés depuis la dernière sauvegarde incrémentielle. Ce paramètre permet également de sauvegarder tout fichier pour lequel toutes les sauvegardes existantes sont susceptibles d'avoir expiré.

Selective

La planification sauvegarde uniquement les fichiers spécifiés avec le paramètre OBJECTS.

Archive

La planification archive les fichiers spécifiés avec le paramètre OBJECTS.

Backup

Spécifie que la planification sauvegarde les fichiers spécifiés avec le paramètre OBJECTS.

REStore

La planification restaure les fichiers spécifiés avec le paramètre OBJECTS.

Si vous indiquez ACTION=RESTORE pour une opération planifiée et que l'option REPLACE a la valeur PROMPT, aucune invite ne se produit. Si vous attribuez la valeur PROMPT à l'option, les fichiers sont ignorés.

Si vous indiquez une seconde spécification de fichier, celle-ci joue le rôle de la destination de la restauration. Si vous devez restaurer plusieurs groupes de fichiers, planifiez-en un pour chaque spécification de fichier à restaurer.

RETrieve

Spécifie que la planification récupère les fichiers spécifiés avec le paramètre OBJECTS.

Rappel: Un second fichier spécifié sert de destination d'extraction. Si vous devez récupérer plusieurs groupes de fichiers, créez une planification distincte pour chaque groupe de fichiers.

IMAGEBACkup

La planification sauvegarde les volumes logiques spécifiés avec le paramètre OBJECTS.

IMAGEREStore

La planification restaure les volumes logiques spécifiés avec le paramètre OBJECTS.

Command

Spécifie que la planification traite un système de commande client ou un script spécifiés avec le paramètre OBJECTS.

Macro

Un client traite une macro dont le nom de fichier est spécifié avec le paramètre OBJECTS.

SUBACTion

Vous pouvez spécifier l'une des valeurs suivantes :

""

Lorsqu'une chaîne nulle (doubles guillemets) est spécifiée avec ACTION=BACKUP, la sauvegarde est incrémentielle.

FASTBAck

Indique qu'une opération client FastBack identifiée par le paramètre ACTION doit être planifiée en vue de son traitement. Le paramètre ACTION doit être défini sur ARCHIVE ou BACKUP.

SYSTEMSTate

Indique qu'une sauvegarde Systemstate client est planifiée.

VApp

Indique qu'une opération de sauvegarde vApp client est planifiée. Une sauvegarde vApp est une collection de machines virtuelles prédéployées.

VM

Indique qu'une opération de sauvegarde VMware client est planifiée.

OPTions

Indique les options client que vous spécifiez à la commande planifiée au moment où la planification est traitée. Ce paramètre est facultatif.

Seules les options admises dans la commande planifiée peuvent être spécifiées pour ce paramètre. Reportez-vous au document client approprié pour obtenir des informations concernant les options valides à partir de la ligne de commande. Toutes les options décrites ici comme étant valides uniquement sur la ligne de commande initiale déclencheront une erreur ou seront ignorées lors de l'exécution de la planification à partir du serveur. Par exemple, n'utilisez pas les options suivantes car elles sont sans effet lorsque le client traite la commande planifiée :

• MAXCMDRETRIES
• OPTFILE
• QUERYSCHEDPERIOD
• RETRYPERIOD
• SCHEDLOGNAME
• SCHEDMODE
• SERVERNAME
• TCPCLIENTADDRESS
• TCPCLIENTPORT

Lorsque vous définissez un service de planificateur à l'aide de la commande DSMCUTIL ou de l'assistant de l'interface graphique du client de sauvegarde-archivage, vous spécifiez un fichier d'options. Vous ne pouvez pas remplacer les options à l'aide de la commande planifiée. Vous devez modifier les options dans le service de planificateur.

Si la chaîne d'options contient plusieurs options ou si des options contiennent des espaces imbriqués, placez l'ensemble de la chaîne d'options entre apostrophes. Placez les options individuelles contenant des espaces entre guillemets. Un signe moins doit être placé devant l'option. Si la chaîne d'options contient des espaces qui ne sont pas correctement encadrés, des erreurs risquent de survenir.

Les exemples suivants indiquent comment spécifier certaines options client :

• Pour spécifier subdir=yes et domain all-local -systemobject, entrez :
  • options='-subdir=yes -domain="all-local -c: -systemobject"'
• Pour spécifier domain all-local -c: -d:, entrez :
  • options='-domain="all-local -c: -d:"'

Conseil:

Pour les clients Windows exécutés en mode de traitement par lots, si l'utilisation de guillemets est nécessaire, utilisez le mode interactif ou les caractères d'échappement du système d'exploitation. Pour plus d'informations, reportez-vous aux rubriques suivantes :

• t_cmdline_adclient.html #t_cmdline_adclient__process_series_cmd
• t_cmdline_adclient.html #t_cmdline_adclient__process_indivi_cmd

OBJects

Indique pour quels objets l'action spécifiée est effectuée. Séparez chaque objet par un seul espace. Ce paramètre est obligatoire excepté avec ACTION=INCREMENTAL. Si l'action est une opération de sauvegarde, d'archivage, de récupération ou de restauration, les objets sont des espaces fichier, des répertoires ou des volumes logiques. Si l'action est d'exécuter une commande ou une macro, l'objet est le nom de la commande ou de la macro a exécuter.

Lorsque vous indiquez ACTION=INCREMENTAL sans préciser de valeur pour ce paramètre, la commande planifiée est appelée sans qu'aucun objet ne soit spécifié et tente de traiter les objets selon la définition qui figure dans le fichier d'options du client. Pour sélectionner tous les espaces fichier ou répertoires en vue d'une action, dressez-en explicitement la liste dans la chaîne-objet. Lorsque vous entrez uniquement un astérisque dans la chaîne-objet, une sauvegarde du répertoire dans lequel la planification a été démarrée, est effectuée.

Important :

• Si vous indiquez une seconde spécification de fichier, et qu'il s'agit d'une destination incorrecte, vous recevez ce message d'erreur :

  ANS1082E Invalid destination file specification <filespec> entered.

• Si vous indiquez plusieurs spécifications de fichier, vous recevez ce message d'erreur :

  ANS1102E Excessive number of command line arguments passed to the 
  program!

Lorsque vous attribuez à ce paramètre la valeur ACTION=ARCHIVE, INCREMENTAL ou SELECTIVE, vous pouvez afficher 20 spécifications de fichier au maximum.

Placez la chaîne d'objets entre guillemets si elle contient des espaces, puis placez des apostrophes autour des guillemets. Si la chaîne d'objets contient plusieurs noms de fichier, chacun d'eux doit être placé entre guillemets, l'ensemble de ces fichiers étant placé entre apostrophes. Des erreurs peuvent se produire si les noms de fichier contiennent des espaces qui ne sont pas placés entre guillemets.

Si vous utilisez des caractères qui ont une signification particulière pour les utilisateurs Windows, tels que les virgules, placez l'argument entier entre deux paires de guillemets doubles, puis placez la chaîne entière entre guillemets simples. Les exemples suivants vous montrent comment spécifier certains noms de fichier :

• Pour spécifier C:\FILE 2, D:\GIF FILES et E:\MY TEST FILE, entrez :
  • OBJECTS='"C:\FILE 2" "D:\GIF FILES" "E:\MY TEST FILE"'
• Pour spécifier D:\TEST FILE, entrez :
  • OBJECTS='"D:\TEST FILE"'
• Pour spécifier D:TEST,FILE:
  • OBJECTS='""D:\TEST,FILE""'

Les exemples suivants montrent comment spécifier certains noms de fichiers :

• Pour spécifier les fichiers /home/file 2, /home/gif et le fichier /home/my test, entrez :
  • OBJECTS='"/home/file 2" "/home/gif files" "/home/my test file"'
• Pour spécifier le fichier /home/test, entrez :
  • OBJECTS='"/home/test file"'

Conseil :

Pour les clients Windows exécutés en mode de traitement par lots, si l'utilisation de guillemets est nécessaire, utilisez le mode interactif ou les caractères d'échappement du système d'exploitation. Pour plus d'informations, reportez-vous aux rubriques suivantes :

• Traitement de commandes individuelles depuis le client d'administration
• Traitement de commandes individuelles depuis le client d'administration

Wait

Indique s'il est nécessaire d'attendre la fin de l'opération planifiée pour un client. Ce paramètre est utile lors de la définition des opérations du client à partir d'un script de commandes ou d'une macro. Ce paramètre est facultatif. La valeur par défaut est No. Les valeurs admises sont les suivantes :

No

Permet d'indiquer qu'il n'est pas nécessaire d'attendre la fin de l'opération planifiée pour un client. Si vous indiquez cette valeur, et que la valeur du paramètre ACTION est COMMAND, le code retour indique si l'opération client a été définie.

Yes

Permet d'indiquer qu'il est nécessaire d'attendre la fin de l'opération planifiée pour un client. Si vous indiquez cette valeur, et que la valeur du paramètre ACTION est COMMAND, le code retour indique l'état de l'opération client.

Vous ne pouvez pas exécuter la commande DEFINE CLIENTACTION depuis la console serveur en indiquant WAIT=YES. A partir de la console serveur, vous pouvez toutefois :

• Indiquer WAIT=YES avec DEFINE CLIENTACTION comme ligne de commande DEFINE SCRIPT.
• Indiquer WAIT=YES avec DEFINE CLIENTACTION comme ligne de commande d'un fichier dont le contenu sera intégré au script défini par une commande DEFINE SCRIPT.

Restriction: Si vous spécifiez la commande DEFINE CLIENTACTION avec WAIT = YES dans une macro, les plannings immédiats définis par la commande ne seront pas rétromigration si la macro ne s'exécute pas correctement.

Commandes associées