Utilisation de variables de substitution dans le Kit de stockage

Cette section explique comment utiliser les variables de substitution avec le Kit de stockage et propose des exemples.

Vous pouvez utiliser les variables de substitution pour indiquer des parties d'un travail par lots ou d'une commande du Kit de stockage qui doivent être remplacées par des noms de volume, des noms de fichier ou d'autres valeurs. Pour savoir comment utiliser les variables de substitution, voir Limites et conseils relatifs au Kit de stockage.

Rubrique parent : Onglets standard des boîtes de dialogue du Kit de stockage
Information associée:
Onglet Commande
Boîte de dialogue Créer un travail par lots

Configuration des variables de substitution pour les commandes du kit de stockage

De nombreuses demandes d'action générées par le Kit de stockage peuvent inclure des variables de substitution. Vous pouvez les définir dans l'onglet Commande comme indiqué dans l'étape 6 de la procédure générale suggérée suivante :
Remarque : La boîte de dialogue Création de travail par lots ne comporte pas d'onglet Commande. Pour définir des variables de substitution dans cette boîte de dialogue, vous utilisez l'onglet Options.
  1. Dans un espace de travail, cliquez avec le bouton droit de la souris sur l'une des vues pour accéder au menu contextuel.
  2. Sélectionnez la commande du Kit de stockage que vous souhaitez appeler. L'onglet Options est sélectionné par défaut dans la boîte de dialogue.
    Remarque : L'onglet Options ne figure pas dans la boîte de dialogue Emission de commande car vous utilisez cette boîte de dialogue pour créer une commande et des chaînes de paramètres à structure libre arbitraires. Si vous utilisez cette boîte de dialogue, passez à l'étape 6.
  3. Effectuez les sélections et indiquez les valeurs requises dans l'onglet Options.
  4. Sélectionnez l'onglet Commande. La zone Commande montre comment les options sélectionnées dans l'onglet Options sont rendues au format texte brut au sein d'une commande.
  5. Avant d'apporter des modifications dans l'onglet Commande, contrôlez les paramètres et la syntaxe de la commande qui s'affichent pour vous assurer qu'ils correspondent bien à vos attentes. Si nécessaire, modifiez la commande en utilisant l'une des méthodes suivantes :
    • Avant d'apporter des modifications à l'onglet Commande, revenez à l'onglet Options et modifiez vos sélections.
      Remarque : Si vous apportez des modifications dans l'onglet Commande, l'onglet Options est désactivé et vous ne pouvez pas modifier les sélections que vous avez apportées à ce niveau. Pour pouvoir réutiliser l'onglet Options, vous pouvez ouvrir une nouvelle instance de la boîte de dialogue du kit de stockage. Cliquez sur Annuler pour ne pas tenir compte de l'instance active de la boîte de dialogue, puis accédez une nouvelle fois à la boîte de dialogue via Tivoli Enterprise Portal.
    • Si vous connaissez bien la syntaxe de commande, modifiez le texte brut qui s'affiche dans la zone Commande de l'onglet Commande. N'oubliez pas que vous ne pourrez plus apporter de modifications à l'onglet Options une fois que vous aurez modifié l'onglet Commande.
  6. Si vous souhaitez définir des variables de substitution, accédez à l'onglet Commande et définissez les dans la zone Variables de substitution et valeurs de remplacement à l'exécution. Dans de nombreux cas, la table Variables de substitution et valeurs de remplacement à l'exécution est alimentée de variables et de valeurs définies par le Kit de stockage selon l'action et les ressources que vous avez sélectionnées.
    Remarque : La boîte de dialogue Création de travail par lots ne comporte pas d'onglet Commande. Pour définir des variables de substitution dans cette boîte de dialogue, vous utilisez l'onglet Options.
  7. Cliquez sur le bouton Afficher les données pour accéder à la Boîte de dialogue Vue Données où vous pourrez confirmer que les volumes ou les fichiers appropriés sont bien ciblés par les variables de substitution.

Variables de substitution standard du kit de stockage

Les instructions générales suivantes s'appliquent aux variables de substitution utilisées par le kit de stockage :
  • OMEGAMON for Storage on z/OS utilise une paire de signes de pourcentage (%) autour d'un nom SUBnn pour identifier les variables de substitution fournies (%SUB01%, par exemple).
  • Lorsque vous créez des variables pour des fichiers JCL, nous vous recommandons d'utiliser la convention reposant sur les signes de pourcentage (%) comme dans l'exemple %MY_VAR%. Cette convention permet au Kit de stockage de trouver ces variables et de les répertorier automatiquement dans la Boîte de dialogue Créer un travail par lots. Toutes les variables ne respectant pas cette convention ne s'affichent pas automatiquement dans la boîte de dialogue.
  • Ne créez pas de variable qui pourrait être un sous-ensemble d'une autre variable. Par exemple, nous vous déconseiller d'appeler une variable MA_VARIABLE et une autre variable MA_VAR.
  • Ne créez pas de variable qui pourrait correspondre à des données de votre commande, de vos fichiers ou d'un fichier JCL généré qui ne doit en aucun cas être remplacé. Dans le scénario suivant, le système risque de remplacer une valeur qui ne devrait pas l'être :
    1. Vous définissez une variable ADDR et vous lui attribuez la valeur 01AE.
    2. Vous utilisez la variable dans la commande suivante : 
      ANALYZE UNITADDRESS(ADDR) SCAN
    3. Normalement, le processus de substitution automatique de la variable ADDR devrait générer la commande suivante. La commande générée inclut une modification du paramètre UNITADDRESS qui risque d'avoir un impact à l'encontre de vos intentions :
      ANALYZE UNIT01AEESS(01AE) SCAN
    DISP constitue un autre exemple de nom de variable déconseillé, car il y a de fortes chances que la chaîne apparaisse sur une instruction de définition de données JCL où elle ne doit en aucun cas être remplacée.
  • Le produit fournit des noms d'attribut génériques comme *DSN and *ROWNUMBER.

Pour visualiser la portée des variables de substitution que vous définissez dans l'onglet Options, cliquez sur le bouton Afficher les données.

Exécution des commandes lorsque des variables de substitution sont définies

Vous définissez des variables de substitution ainsi que leurs correspondances dans la zone Variables de substitution et valeurs de remplacement à l'exécution de la boîte de dialogue. Selon vos paramètres, la demande d'action émet la commande une ou plusieurs fois :
Nombre de lignes sélectionnées dans l'espace de travail Les variables de substitution sont-elles définies dans l'onglet Commande ? Mode d'exécution de la commande
Une Oui ou non Une seule fois pour l'élément sélectionné
Plusieurs Oui Plusieurs fois (une fois pour chaque élément sélectionné)
Un ou plusieurs groupes Oui. Un attribut Groupe est spécifié. Une fois pour chaque ressource de volume ou de fichier dans chaque groupe sélectionné.

Exemples de variables de substitution

Le tableau suivant montre quelques exemples de variables de substitution standard dans une commande exécutée par le Kit de stockage. Les boîtes de dialogue du kit de stockage comportent un tableau à deux colonnes similaire.
Variable de commande1 Attribut ou chaîne2
%dsname% ENTRYNAME
my-volser VOLUME
%job-name% "USER01A"
%sysout-class% "X"
%rownum% *ROWNUMBER
%user-account% *USERID
  1. L'en-tête de la colonne est "Variable" si vous définissez les variables de substitution d'un travail par lots dans la boîte de dialogue Création d'un travail par lots. Pour plus d'informations, voir Présentation de la colonne "Variable de commande" (ou "Variable").
  2. Vous pouvez saisir du texte brut ou utiliser un menu déroulant pour sélectionner les entrées de la colonne Attribut ou chaîne. Pour plus d'informations, voir Présentation de la colonne "Attribut ou chaîne".
Information associée:
Boîte de dialogue Créer un travail par lots

Présentation de la colonne "Variable de commande" (ou "Variable")

Pour obtenir un exemple de colonne Variable de commande (ou Variable) dans le cas de variables de substitution, voir Exemples de variables de substitution. Ces exemples reflètent les noms des variables de substitution qui peuvent exister dans un fichier JCL défini par l'utilisateur. Les exemples illustrent les instructions et caractéristiques suivantes pour les entrées de la colonne Variable de commande :
  • Les chaînes peuvent comporter jusqu'à 64 caractères de l'ensemble de caractères suivant : [a-zA-Z0-9_.%-]. Les chaînes ne différencient pas les majuscules des minuscules lors de leur traitement par l'agent grand système.
  • Le caractère perluète (&) ne peut pas être utilisé dans les variables de substitution. Si vous l'utilisez, le système risque de en pas comprendre car le perluète est utilisé à d'autres fins dans le fichier JCL.
  • N'utilisez pas de nom de variable comme sous-chaîne d'une autre variable de substitution. Par exemple, n'utilisez pas my_dsn et my_dsname comme variables de substitution.
  • Ne créez pas de variable qui pourrait correspondre à des données de votre commande, de vos fichiers ou d'un fichier JCL généré qui ne doit en aucun cas être remplacé. Par exemple, nous vous déconseillons d'utiliser DISP comme nom d'une variable de substitution car il y a de fortes chances que la chaîne apparaisse sur une instruction de définition de données JCL où elle ne doit en aucun cas être remplacée.

Présentation de la colonne "Attribut ou chaîne"

Pour obtenir un exemple de colonne Attribut ou chaîne dans le cas de variables de substitution, voir Exemples de variables de substitution. Dans la plupart des cas, les valeurs des variables de substitution proviennent de colonnes de données de l'espace de travail d'où est issue la demande d'action du kit de stockage. Utilisez la liste déroulante de la colonne Attribut ou chaîne pour sélectionner une valeur. Cette valeur est utilisé comme source pour la variable de substitution correspondante.

Le kit de stockage détecte les entrées qui sont disponibles pour la ligne que vous sélectionnez dans un espace de travail avant d'appeler une boîte de dialogue du Kit de stockage. La section Exemples de variables de substitution illustre les instructions et caractéristiques suivantes pour les entrées de la colonne Attribut ou chaîne :
  • ENTRYNAME : Dans cet exemple, l'utilisateur a sélectionné dans une zone de liste un attribut de table baptisé ENTRYNAME comme valeur de la variable.
  • USER01A : Dans cet exemple, l'utilisateur a tapé un nom littéral (USER01A) pour refléter la variable %nom-travail%.
  • %job-name%, %sysout-class% : Vous pouvez entrer des chaînes de texte littéral à la place de noms d'attribut dans cette colonne. Le texte brut peut désigner des éléments du fichier JCL qui ne sont pas liés à la table sous-jacente, notamment %job-name%, %sysout-class%, etc. Le kit de stockage traite les valeurs comprises entre des guillemets simples ou doubles comme des chaînes littérales et nom comme des noms de colonne de table. Le système n'utilise qu'une seule occurrence de la chaîne dans la commande ou le travail par lots.
  • *ROWNUMBER : Dans cet exemple, l'utilisateur a sélectionné la valeur *ROWNUMBER dans le menu déroulant correspondant à la variable %rownum%. En raison de ce paramètrage, le système génère une variable de numéro de ligne qui sera utilisé dans le fichier JCL. Le kit de stockage génère des numéros entiers compris entre 1 et le nombre total de lignes de données transmises qui proviennent de la table sous-jacente. Par exemple, vous pouvez sélectionner trois lignes à partir d'une vue d'espace de travail lorsque vous créez ou resoumettez une demande d'action. Dans ce cas, le système génère les valeurs 1, 2 et 3.
  • *USERID : Dans cet exemple, l'utilisateur a sélectionné la valeur *USERID dans le menu déroulant correspondant à la variable %user-account%. Le système remplace cette valeur par une seule occurrence du nom du compte utilisateur qui est actif dans Tivoli Enterprise Portal.
  • Tenez compte des points suivants pour configurer des travaux par lots dans la boîte de dialogue Créer un travail par lots :
    • Lorsque le kit de stockage cible un membre dans un fichier partitionné ou un fichier séquentiel déjà existant, le kit de stockage analyse le fichier pour voir s'il contient des chaînes respectant la convention de dénomination suivante : %nom% (où nom représente le nom d'une variable de substitution). Le kit de stockage remplit la boîte de dialogue avec chacune des variables correspondantes pour %name%.
    • Le processus de substitution des variables au sein du fichier JCL risque de produire des lignes de plus de 72 caractères. Si cela se produit, l'exécution de la demande d'action risque d'échouer. L'espace de travail Récapitulatif des résultats affiche le statut JCL invalide.
    • Le processus de substitution de variables au sein d'autres fichiers nécessitant une telle substitution risque de produire des lignes de plus de 80 caractères. Si cela se produit, l'exécution de la demande d'action risque d'échouer. Le statut JCLNonValide s'affiche dans l'espace de travail Récapitulatif des résultats.

    • Lorsque la configuration du travail par lots est terminée, cliquez sur OK dans la boîte de dialogue Créer un travail par lots. A ce stade, le fichier JCL que vous fournissez et les autres fichiers contenant des variables de substitution sont copiés dans des fichiers temporaires. Ces fichiers temporaires sont utilisés lorsque le langage JCL de travail par lots est soumis. Le kit ne modifie pas les fichiers d'origine car d'autres utilisateurs peuvent y faire référence au même moment.