Une fonctionnalité très importante des packages d'installation intégrée (IIP) est l'utilisation de macros aidant à automatiser l'installation des packages d'installation inclus.
Cette rubrique contient les informations suivantes relatives aux macros IIP :
Vous pouvez utiliser des macros prédéfinies pour que les packages IIP soient plus souples et pour automatiser la façon dont certaines contributions sont installées sans avoir à spécifier tout dans l'assistant de définition de génération lors de la création de packages IIP. Vous pouvez, par exemple, installer deux packages d'installation différents dans le même emplacement (ou par rapport au même emplacement) sans avoir à spécifier manuellement cet emplacement à deux reprises dans l'assistant de définition de génération IIP. L'emplacement d'installation du premier package peut automatiquement être affecté à l'option -installLocation du second package, ce qui entraîne l'utilisation par défaut de cet emplacement. Il est noter que l'utilisateur peut modifier cette valeur au moment de l'installation si vous l'aviez autorisé à cet effet pendant la création de packages IIP. Dans la mesure où les macros ne sont pas résolues jusqu'à l'installation du package IIP, elles peuvent être utilisées non seulement par l'utilisateur qui crée le package IIP, mais aussi par l'utilisateur qui l'appelle. L'assistant de définition de génération et l'assistant d'installation de package IIP fournissent aux utilisateurs des moyens pratiques pour tirer parti des macros sans avoir à modifier manuellement les chaînes d'option pour créer ou modifier directement des macros.
Vous pouvez utiliser les macros suivantes dans votre IIP :
Cette macro utilise la valeur de résultat de l'appel spécifié et remplace la macro par cette valeur, où <ID_appel> indique quel appel de contribution du package IIP fournit la valeur de résultat nommée. L'ID appel est requis pour la résolution de toute ambiguïté pouvant se produire si des contributions différentes utilisent les mêmes noms de valeur de résultat ou s'il existe plusieurs appels de la contribution donnée. Par exemple, si un IIP contient le module d'installation de serveur de processus (ID_appel = 6.2.0-WS-WBI_1-1) et le Feature Pack for Web Services, vous voulez probablement que le module de fonctions soit automatiquement installé dans le même emplacement que le serveur de processus. Pour ce faire, transmettez l'option suivante au programme d'installation du module de fonctions sur la ligne de commande d'installation de package IIP :
-OPT installLocation=$RESV{6.2.0-WS-WBI_1-1:installLocation}
Cette macro utilise la valeur de l'option portant le nom donné et remplace la macro par cette valeur, où <ID_appel> indique quel appel de contribution du package IIP fournit l'option nommée. Cela est requis pour la résolution de toute ambiguïté pouvant se produire si des contributions différentes utilisent les mêmes noms de valeur de résultat ou s'il existe plusieurs appels de la contribution donnée. Une erreur se produit si, pendant l'installation du package IIP, l'option référencée ne peut pas être résolue car elle n'a pas réellement été indiquée pour l'appel référencé. L'utilisateur IIP doit modifier l'appel référencé pour que l'option soit incluse ou modifier/supprimer la macro comportant la référence. L'utilisation de cette macro pour référencer une option qui n'utilise pas de valeur, par exemple, –silent, est une erreur. Dans ce cas, l'assistant de définition de génération génère une erreur et le package IIP ne peut pas être généré.
Cet exemple est très similaire à l'exemple $RESV avec une seule exception importante :
-OPT installLocation=$OPTV{6.2.0-WS-WBI_1-1:installLocation}
Tout emplacement d'installation transmis au serveur de processus dans l'option -installLocation est transmis au module de fonctions pour son emplacement d'installation. Cela fonctionne correctement si le serveur de processus a été installé en mode silencieux ; cependant, s'il a été installé en mode graphique, il est possible que l'utilisateur ait modifié l'emplacement dans l'assistant d'installation. Cette macro permet néanmoins la résolution de la valeur d'origine définie pendant la création du package IIP. Dans ce cas, il convient d'utiliser la macro de valeur de résultat ($RESV) et non la macro de valeur d'option ($OPTV).
Cette macro utilise la spécification de l'option portant le nom donné et remplace la macro par cette spécification ou par chaîne si celle-ci a été fournie. <ID_appel> indique quel appel de contribution du package IIP fournit l'option nommée. La spécification d'option est une chaîne qui représente exactement la façon dont l'option est indiquée sur la ligne de commande, à l'exclusion de toute valeur, par exemple, -OPT installLocation=. Cette macro est couramment utilisée pour les options qui n'utilisent pas de valeur, par exemple, –silent. La partie chaîne de la macro permet d'utiliser une valeur de chaîne en remplacement de cette macro, au lieu d'utiliser directement la spécification d'option référencée. Cela prend en charge les cas où deux contributions différentes risquent d'avoir des options différentes pour la même fonction (dans ce cas, l'installation en mode silencieux). Une des contributions peut utiliser la macro pour vérifier si l'autre contribution a été appelée en mode silencieux et, si c'est le cas, elle peut spécifier sa propre option pour l'appel silencieux à l'aide de chaîne.
Contrairement à la macro $OPTV, $OPTS est développée au niveau de la chaîne vide si l'option référencée n'a pas été spécifiée dans l'appel référencé ; il ne s'agit pas d'une situation d'erreur. Il est important de prendre en charge des fonctions telles que le mode d'installation, où l'absence d'une option telle que -silent indique que le programme d'installation utilise le mode graphique. L'utilisation de cette macro pour référencer une option ne possédant pas de spécification donne lieu à une erreur.
Les options qui n'utilisent pas de valeurs, telles que –silent, peuvent également être résolues à l'aide de macros, par exemple :
$OPTS{6.2.0-WS-WBI_1-1:silent}
Dans ce cas, si l'option référencée, –silent, a été spécifiée au niveau de l'appel de la contribution de serveur de processus 6.2.0-WS-WBI, la macro est remplacée par la spécification d'option –silent. Si cette option n'a pas été spécifiée, la macro permet la résolution de la chaîne vide. Cela vous permet d'installer un ensemble de contributions de façon cohérente en mode silencieux ou en mode graphique en fonction de ce qui a été spécifié pour une de ces contributions. Un avertissement est émis si l'option n'a pas été spécifiée dans la contribution référencée au cas où cette référence serait une erreur utilisateur.
Cette macro permet la résolution de l'emplacement de l'appel de package donné dans le package IIP et le résultat correspond à un chemin d'accès absolu. Lorsqu'un ID_contribution et un ID_sub sont spécifiés, cela permet la résolution de l'emplacement racine de la contribution indiquée, au sein du package IIP. Par exemple, si vous disposez d'une contribution pour l'édition de base du serveur de processus sous Windows, le répertoire racine de cette contribution correspond à rép_principal_IIP/contrib/6.2.0-WS-WBI/1/WinX32. L'exemple de macro suivant permet la résolution de ce répertoire :
$LOC{6.2.0-WS-WBI_1}
Si seul IIP est spécifié, cette valeur est résolue au répertoire principal ou au répertoire_principal_IIP du package IIP :
$LOC{IIP}
Cette macro est remplacée par la valeur en cours de la propriété Java™ nommée. Il peut s'agir de n'importe quelle propriété reconnue par l'environnement d'exécution Java. Par exemple, pendant le processus de l'assistant de définition de génération IIP, vous êtes invité à indiquer le répertoire d'installation cible de vos appels de contribution. Par défaut, le répertoire d'installation cible d'un utilisateur non root est le suivant :
$JP{user.home}/IBM/WebSphere/ProcServer
Pour compléter le chemin du répertoire, /IBM/WebSphere/ProcServer est ajouté au répertoire principal de l'utilisateur en cours.