DEFINE SCRIPT (Définition d'un script IBM Storage Protect )

Utilisez cette commande pour définir un script IBM Storage Protect ou pour créer un nouveau script IBM Storage Protect en utilisant le contenu d'un autre script.

La première ligne du script peut être définie à l'aide de cette commande. Pour ajouter des lignes supplémentaires, utilisez la commande UPDATE SCRIPT.

Conseils :
  • Lors du routage de commandes dans des scripts, vous devez mettre le serveur ou le groupe de serveurs entre parenthèses et éviter les deux points. Sinon, la commande ne sera pas acheminée lorsque la commande RUN est exécutée. A la place, elle n'est exécutée que sur le serveur à partir duquel la commande RUN est émise.
  • Vous ne pouvez pas rediriger la sortie d'une commande dans un script IBM Storage Protect . Au lieu de cela, exécutez le script et indiquez la redirection de commande. Par exemple, pour diriger le résultat de script1 vers le répertoire c:\temp\test.out, exécutez le script et indiquez la redirection de commande comme indiqué dans l'exemple suivant :
    run script1 > c:\temp\test.out

Classe de privilège

Pour exécuter cette commande, vous devez disposer de privilèges système, de stockage, de règle ou d'opérateur.

Syntaxe

Lire le diagramme de syntaxeIgnorer le diagramme de syntaxe graphiqueDEFine SCRiptnom_script command_lineLine=001Line =numberFile=file_nameDESCription=description

Paramètres

nom_script (obligatoire)
Désigne le nom du script à définir. Ce nom doit comporter au maximum 30 caractères.
ligne_commande
Indique la première commande à traiter dans un script. Vous devez spécifier ce paramètre (et, éventuellement, le paramètre LINE) ou le paramètre FILE.

La commande que vous indiquez peut inclure des variables de remplacement et peut être reproduite sur plusieurs lignes si vous indiquez un caractère de suite (-) comme dernier caractère dans la commande. Les variables de remplacement sont indiquées par le signe '$', suivi d'un nombre correspondant à la valeur du paramètre lorsque les script est traité. Ce nom doit comporter au maximum 1200 caractères. Si la commande comprend des espaces, placez-la entre guillemets.

Vous pouvez exécuter des commandes en série, en parallèle, ou en série et en parallèle en indiquant les commandes de script SERIAL ou PARALLEL pour le paramètre COMMAND_LINE. Vous pouvez exécuter plusieurs commandes en parallèle et attendre qu'elles se terminent avant de passer à la commande suivante. Les commandes s'exécutent en série jusqu'à ce que la commande parallèle soit rencontrée.

Restriction: Si vous spécifiez un script avec la commande PARALLEL , n'incluez pas de commande SHOW, QUERYou SELECT dans le script. Cette restriction est valable pour tous les scripts, y compris les scripts appelant d'autres scripts.

Des instructions de flux logique conditionnel peuvent être utilisées. Ces instructions sont IF, EXIT et GOTO.

Line
Définit le numéro de ligne de la ligne de commande. Les commandes étant indiquées dans plusieurs lignes, des numéros de ligne sont utilisés pour déterminer l'ordre de traitement lors de l'exécution du script. La première ligne, ou ligne 001, est la valeur par défaut. Ce paramètre est facultatif.
File
Désigne le nom du fichier dont le contenu est lu dans le script à définir. Le fichier doit résider sur le serveur qui exécute cette commande. Si vous définissez le paramètre FILE, vous ne pouvez spécifier une ligne de commande ou un numéro de ligne.

Vous pouvez créer un script en interrogeant un autre script et en définissant les paramètres FORMAT=RAW et OUTPUTFILE. Le résultat de cette analyse est transféré dans un fichier pouvant être spécifié à l'aide du paramètre OUTPUTFILE. Pour créer le nouveau script, le contenu du script à définir est lu dans le fichier indiqué dans le paramètre OUTPUTFILE.

DESCription
Correspond à la description du script. Vous pouvez indiquer 255 caractères au maximum. Si la description comprend des espaces, placez-la entre guillemets. Ce paramètre est facultatif.

Exemple: écriture d'un script pour afficher les clients AIX

Définissez un script qui affiche tous les clients AIX® .
define script qaixc "select node_name from nodes where platform_name='AIX'"
  desc='Display aix clients'

Exemple : Création et exécution d'un script pour acheminer une commande vers un groupe de serveurs

Définissez et exécutez un script acheminant la commande QUERY STGPOOL vers le groupe de serveurs DEV_GROUP.
define script qu_stg "(dev_group) query stgpool"
run qu_stg

Exemple : Création d'un script à partir d'un script existant

Définissez un script dont les lignes de commande sont lues dans le fichier MY.SCRIPT et nommez-le nouveau script AGADM. Le fichier doit résider sur le serveur et être lu par ce dernier.
define script agadm file=my.script

Commandes associées

Tableau 1. Commandes associées à DEFINE SCRIPT
Commande Description
COPIER LE SCRIPT Crée une copie d'un script.
SUPPRIMER LE SCRIPT Supprime le script ou les lignes individuelles du script.
SCRIPT DE DEMANDES Affichage d'informations concernant les scripts.
RENOMMER LE SCRIPT Attribution d'un nouveau nom à un script.
EXECUTER Exécute un script.
MISE A JOUR de SCRIPT Modifications ou ajouts de lignes à un script.