Scripts de configuration des ressources

La bibliothèque de scripts propose de nombreuses procédures de script pour automatiser la configuration des serveurs d'applications. Utilisez les scripts de configuration de ressources, de courrier électronique et d'URL pour créer et configurer des ressources dans votre environnement. Vous pouvez exécuter chaque script individuellement ou combiner des procédures pour créer des scripts d'automatisation personnalisés.

Les procédures de script de gestion de courriers électroniques, d'URL et de ressources se trouvent dans le répertoire racine_serveur_app/scriptLibraries/resources/ .

Depuis la Version 7, la bibliothèque de scripts Jython fournit des fonctions de script pour les fournisseurs JDBC, les ressources JMS et les fournisseurs de ressources à la portée du serveur. Vous pouvez écrire vos propres scripts personnalisés pour configurer des ressources au niveau de la cellule, du noeud ou du cluster.
Eviter les incidents Eviter les incidents: Ne modifiez pas les procédures de script de la bibliothèque de scripts. Pour écrire des procédures de bibliothèque de scripts personnalisés, utilisez les scripts du répertoire racine_serveur_app/scriptLibraries en tant qu'exemples de syntaxe Jython. Enregistrez les scripts personnalisés dans un nouveau sous-répertoire pour éviter d'écraser la bibliothèque.gotcha
Raccourci : Depuis Fix Pack 5, la bibliothèque de scripts Jython fournit des fonctions de script pour les fournisseurs JDBC, les ressources JMS et les fournisseurs de ressources à la portée de la cellule, du noeud, du serveur ou du cluster. Les fournisseurs de ressources sont les fournisseurs de messagerie, d'URL et d'environnement de ressources. Vous n'avez pas besoin de rédiger des scripts personnalisés pour configurer des ressources à une portée particulière.
Avertissement : Les modèles de script et leur syntaxe apparaissent sur plusieurs lignes pour des raisons liées à l'affichage.
Utilisez les procédures de script suivantes pour configurer les paramètres du fournisseur d'URL :
Utilisez les procédures de script suivantes pour configurer des ressources JEE (Java™ Enterprise Edition) supplémentaires :

Format de l'argument de portée

Le format de portée s'applique aux scripts de la bibliothèque de scripts qui possèdent l'argument de portée.

Une cellule est facultative sur des portées de noeud, de serveur et de cluster. Un noeud est obligatoire sur la portée de noeud.

Vous pouvez délimiter le type à l'aide d'une virgule (,) ou d'un signe deux-points (:). Vous pouvez utiliser les minuscules pour le type (cell=, node=, server= ou cluster=.)

Les exemples du tableau suivant sont divisés en plusieurs lignes à des fins de publication.

Tableau 1. Exemple de chemin d'imbrication, d'ID de configuration et de type pour une portée donnée. La portée peut être une cellule, un noeud, un serveur ou un Cluster.
Portée Chemin d'imbrication ID configuration Type
Cell /Cell:myCell/
myCell(cells/myCell|
cell.xml#Cell_1)
Cell=myCell ou cell=myCell
Noeud /Cell:myCell/Node:myNode/ ou /Node:myNode/
myNode(cells/myCell
/nodes/myNode|
node.xml#Node_1)
Cell=myCell,
Node=myNode
ou
Cell=myCell:
Node=myNode
ou
cell=myCell,
node=myNode
Serveur
/Cell:myCell/Node:
myNode/
Server:myServer/
ou
/Node:myNode/Server:
myServer/
myServer(cells
/myCell/
nodes/myNode/
servers/myServer|
server.xml#Server_1)
Cell=myCell,
Node=myNode,
Server=myServer
ou
Node=myNode:
Server=myServer
or
cell=myCell,
Node=myNode,
Server=myServer
Cluster
/Cell:myCell/
ServerCluster:
myCluster/
or
/ServerCluster:
myCluster/
myCluster(cells
/myCell/clusters/
myCluster|
cluster.xml
#ServerCluster_1)
Cell=myCell,
Cluster=myCluster
or
Cell=myCell:
Cluster=myCluster
or
cell=myCell,
Cluster=myCluster

createCompleteMailProvider

Ce script configure des attributs de configuration supplémentaires pour votre fournisseur de messagerie. Un fournisseur de messagerie encapsule une série de fournisseurs de protocole tels que SMTP, IMAP et POP3, alors que les sessions de messagerie authentifient les utilisateurs et contrôlent l'accès des utilisateurs aux systèmes de messagerie. Configurez vos propres fournisseurs et sessions de messagerie pour personnaliser la façon dont JavaMail est traité. Le script renvoie l'ID de configuration du nouveau fournisseur de messagerie.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 2. Arguments de createCompleteMailProvider. Exécutez le script pour configurer un fournisseur de messagerie.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
mailProviderName Indique le fournisseur de messagerie que le serveur d'applications utilise pour cette session de messagerie.
propName Indique le nom de la propriété personnalisée.
propValue Valeur de la propriété personnalisée.
protocolName Indique le nom du fournisseur de protocole. Le serveur d'applications contient des fournisseurs de protocole pour SMTP, IMAP et POP3.
className Indique le nom de classe d'implémentation du fournisseur de protocole.
mailSessionName Indique le nom d'administration de l'objet Session JavaMail.
JNDIName Désigne le nom JNDI qui doit être associé à la ressource, y compris les éventuels sous-contextes de changement de nom. Ce nom sert de lien entre les informations de liaison de la plateforme pour les ressources définies dans le descripteur de déploiement des applications du client et les ressources réelles confinées dans JNDI par la plateforme.
mailStoreHost Indique le serveur activé lors de la réception de courrier. Combiné à l'ID utilisateur et au mot de passe correspondants, ce paramètre représente un compte de messagerie correct. Par exemple, si le compte de messagerie est john_william@mon.entreprise.com, l'hôte de stockage de courrier est mon.entreprise.com.
mailStoreUser Indique l'ID utilisateur du compte de messagerie donné. Par exemple, si le compte de messagerie est john_william@mon.entreprise.com, l'utilisateur est john_william.
mailStorePassword Indique le mot de passe du compte de messagerie donné. Par exemple, si le compte de messagerie est john_william@mon.entreprise.com, entrez le mot de passe correspondant à l'ID john_william.

Syntaxe

AdminResources.createCompleteMailProvider(nodeName, 
 serverName, mailProviderName, propName, propValue, 
 protocolName, className, mailSessionName, JNDIName, 
 mailStoreHost, mailStoreUser, mailStorePassword)

Exemple de syntaxe

AdminResources.createCompleteMailProvider("myNode", 
 "myServer", "myMailProvider", "myProp", "myPropValue", "myMailProtocol", 
 "com.ibm.mail.myMailProtocol.myMailStore", "myMailSession", "myMailSession/jndi", "server1", 
 "mailuser", "password")

Script createCompleteMailProviderAtScope

Ce script configure des attributs de configuration supplémentaires pour votre fournisseur de messagerie et la portée que vous spécifiez. Un fournisseur de messagerie encapsule une série de fournisseurs de protocole tels que SMTP, IMAP et POP3, alors que les sessions de messagerie authentifient les utilisateurs et contrôlent l'accès des utilisateurs aux systèmes de messagerie. Configurez vos propres fournisseurs et sessions de messagerie pour personnaliser la façon dont JavaMail est traité. Le script renvoie l'ID de configuration du fournisseur de messagerie créé dans la portée spécifiée.

Pour exécuter le script, indiquez la portée, le nom du fournisseur de messagerie, le nom de la propriété, la valeur de la propriété, le nom du protocole, le nom de classe, le type, le nom de la session de messagerie et le nom JNDI comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 3. Arguments de createCompleteMailProviderAtScope. Exécutez le script pour configurer un fournisseur de messagerie.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur de messagerie.
mailProviderName Indique le fournisseur de messagerie que le serveur d'applications utilise pour cette session de messagerie.
propName Indique le nom de la propriété personnalisée.
propValue Valeur de la propriété personnalisée.
protocolName Indique le nom du fournisseur de protocole. Le serveur d'applications contient des fournisseurs de protocole pour SMTP, IMAP et POP3.
className Indique le nom de classe d'implémentation du fournisseur de protocole.
type Indique le type de fournisseur de protocoles. Les options correctes sont Stockage et Transfert.
mailSessionName Indique le nom d'administration de l'objet Session JavaMail.
jndiName Désigne le nom JNDI qui doit être associé à la ressource, y compris les éventuels sous-contextes de changement de nom. Ce nom sert de lien entre les informations de liaison de la plateforme pour les ressources définies dans le descripteur de déploiement des applications du client et les ressources réelles confinées dans JNDI par la plateforme.
otherAttributesList, mailProviderAttributesList, mailSessionAttributesList
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Le tableau suivant indique les attributs facultatifs que vous pouvez indiquer pour un fournisseur de messagerie :
Tableau 4. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
classpath Liste de chemins ou de noms de fichiers d'archive Java (JAR) qui, ensemble, spécifient l'emplacement des classes du fournisseur de ressources. Utilisez le point-virgule (;) pour séparer les chemins de classe.
description Indique une description du fournisseur de messagerie.
isolatedClassLoader Si la valeur associée est "true", indique que le fournisseur de messagerie sera chargé dans son propre chargeur de classe.
Avertissement : Vous ne pouvez pas isoler un fournisseur si vous spécifiez un chemin de bibliothèque native.
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple *.dll ou *.so. Utilisez le point-virgule (;) pour séparer les entrées de chemin natif.
providerType Indique le type de ce fournisseur de messagerie.
Le tableau suivant indique les attributs facultatifs que vous pouvez indiquer pour une session de messagerie :
Tableau 5. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
debug Indique si le mode débogage est utilisé pour cette session de messagerie. La valeur par défaut est off.
description Indique une description du fournisseur de messagerie.
mailFrom Indique l'adresse électronique Internet. Si la valeur associée est "true", le fournisseur de messagerie sera chargé dans son propre chargeur de classe.
ATTENTION :
Vous ne pouvez pas isoler un fournisseur si vous spécifiez un chemin de bibliothèque native.
mailStoreHost Indique le serveur auquel se connecter pour recevoir les messages.
mailStorePort Indique le port auquel se connecter pour recevoir les messages.
mailStoreUser Indique l'utilisateur du compte de messagerie lors de l'authentification par le serveur de courrier entrant.
mailStorePassword Indique le mot de passe du compte de messagerie lors de l'authentification par le serveur de courrier entrant.
mailStoreProtocol Spécifie le protocole à utiliser pour la réception des messages.
mailTransportHost Indique le serveur auquel se connecter lors de l'envoi de messages.
mailTransportPort Indique le port auquel se connecter pour envoyer les messages.
mailTransportUser Indique l'utilisateur du compte de messagerie lors de l'authentification par le serveur de courrier sortant.
mailTransportPassword Indique le mot de passe du compte de messagerie lors de l'authentification par le serveur de courrier sortant.
mailTransportProtocol Indique le protocole à utiliser pour l'envoi de messages.
strict Indique si l'adresse de destinataire est analysée en conformité avec la spécification RFC 822. La valeur par défaut est true.

Syntaxe

AdminResources.createCompleteMailProviderAtScope(scope, 
  mailProviderName, propName, propValue, 
 protocolName, className, type, mailSessionName, JNDIName, otherAttributesList, 
mailProviderAttributesList, mailSessionAttributesList)

Exemple de syntaxe

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminResources.createCompleteMailProviderAtScope("myScope", 
 "myMailProvider", "myProp", "myPropValue", "myMailProtocol", 
 "com.ibm.mail.myMailProtocol.myMailStore", "myMailSession", "myMailSession/jndi", "server1", "STORE")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminResources.createCompleteMailProviderAtScope("Node=AMYLIN4Node09, server=server1", "myMailProvider", "myProp", 
"myPropValue", "myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore", "STORE", "myMailSession", "myMailSession/jndi", 
"classpath=c:/temp, description='this is my mail', nativepath=c:/temp/nativepath, isolatedClassLoader=true", 
"category=myCategory, debug=true, description='this is my mailsession', mailStoreUser=user1, mailStorePassword=password, 
mailStoreHost=user1, mailStorePort=1000, mailTransportUser=user2, mailTransportPassword=password, mailTransportHost=test2, 
mailTransportPort=1001, strict=true, mailFrom=test1@gmail.com")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

AdminResources.createCompleteMailProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myMailProvider", "myProp", 
"myPropValue", "myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore", "STORE", "myMailSession", "myMailSession/jndi", 
[['classpath', 'c:/temp'], ['description', 'this is my mail'], ['nativepath', 'c:/temp/nativepath'], ['isolatedClassLoader', 'true']] 
[['category', 'myCategory'], ['debug', 'true'], ['description', 'this is my mailsession'], ['mailStoreUser', 'user1'], 
['mailStorePassword', 'password'], ['mailStoreHost', 'user1'], ['mailStorePort', 1000], ['mailTransportUser', 'user2'], 
['mailTransportPassword', 'password'], ['mailTransportHost', 'test2'], ['mailTransportPort', 1001], ['strict', 'true'], 
['mailFrom', 'test1@gmail.com']])

Script createMailProvider

Ce script crée un fournisseur de messagerie dans votre environnement. Le serveur d'applications contient un fournisseur de messagerie par défaut appelé fournisseur intégré. Si vous utilisez le fournisseur de messagerie par défaut, vous devez uniquement configurer la session de messagerie. Pour pouvoir utiliser le fournisseur de messagerie personnalisé, vous devez d'abord créer le fournisseur et la session de messagerie. Le script renvoie l'ID de configuration du nouveau fournisseur de messagerie.

Pour exécuter le script, spécifiez le noeud, le serveur et le fournisseur de messagerie, comme défini dans le tableau ci-après :
Tableau 6. Arguments de createMailProvider. Exécutez le script pour créer un fournisseur de messagerie.
Argument Description
nodeName Indique le nom du noeud sur lequel doit être créé le fournisseur de messagerie.
serverName Indique le nom du serveur pour lequel doit être créé le fournisseur de messagerie.
mailProviderName Indique le nom à attribuer au nouveau fournisseur de messagerie.

Syntaxe

AdminResources.createMailProvider(nodeName, serverName, 
 mailProviderName)

Exemple de syntaxe

AdminResources.createMailProvider("myNode", "myServer", 
 "myMailProvider")

Script createMailProviderAtScope

Ce script crée un fournisseur de messagerie dans votre environnement avec une portée que vous définissez. Le serveur d'applications contient un fournisseur de messagerie par défaut appelé fournisseur intégré. Si vous utilisez le fournisseur de messagerie par défaut, vous devez uniquement configurer la session de messagerie. Pour pouvoir utiliser le fournisseur de messagerie personnalisé, vous devez d'abord créer le fournisseur et la session de messagerie. Le script renvoie l'ID de configuration du fournisseur de messagerie créé dans la portée spécifiée.

Pour exécuter le script, indiquez la portée et le nom du fournisseur de messagerie comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 7. Arguments de createMailProviderAtScope. Exécutez le script pour créer un fournisseur de messagerie.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur de messagerie.
mailProviderName Indique le nom à attribuer au nouveau fournisseur de messagerie.
otherAttributesList
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 8. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
classpath Liste de chemins ou de noms de fichiers d'archive Java (JAR) qui, ensemble, spécifient l'emplacement des classes du fournisseur de ressources. Utilisez le point-virgule (;) pour séparer les chemins de classe.
description Indique une description du fournisseur de messagerie.
isolatedClassLoader Si la valeur associée est "true", indique que le fournisseur de messagerie sera chargé dans son propre chargeur de classe.
Avertissement : Vous ne pouvez pas isoler un fournisseur si vous spécifiez un chemin de bibliothèque native.
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple *.dll ou *.so. Utilisez le point-virgule (;) pour séparer les entrées de chemin natif.
providerType Indique le type de ce fournisseur de messagerie.

Syntaxe

AdminResources.createMailProviderAtScope(scope, mailProviderName, otherAttributesList)

Exemple de syntaxe

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminResources.createMailProviderAtScope("myScope", "myMailProvider")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminResources.createMailProviderAtScope("Node=AMYLIN4Node09, server=server1", "myMailProvider", "classpath=c:/temp, 
description='this is my mail', nativepath=c:/temp/nativepath, isolatedClassLoader=true")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

AdminResources.createMailProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myMailProvider", 
[['classpath', 'c:/temp'], 
['description', 'this ismy mail'], ['nativepath', 'c:/temp/nativepath'], ['isolatedClassLoader', 'true']])

Script createMailSession

Ce script crée une nouvelle session de messagerie pour votre fournisseur de messagerie. Les sessions de messagerie sont représentées par la classe javax.mail.Session. Un objet Session de messagerie authentifie les utilisateurs et contrôle l'accès des utilisateurs aux systèmes de messagerie. Le script renvoie l'ID de configuration de la nouvelle session de messagerie.

Pour exécuter le script, indiquez le nom du noeud, du serveur, du fournisseur de messagerie, de la session de messagerie ainsi que le nom JNDI (Java Naming and Directory Interface) en tant qu'arguments, comme défini dans le tableau ci-après :
Tableau 9. Arguments de createMailSession. Exécutez le script pour créer une session de messagerie.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
mailProviderName Indique le fournisseur de messagerie que le serveur d'applications utilise pour cette session de messagerie.
mailSessionName Indique le nom d'administration de l'objet Session JavaMail.
JNDIName Nom JNDI devant être associé à la ressource, y compris les éventuels sous-contextes de nommage. Ce nom sert de lien entre les informations de liaison de la plateforme pour les ressources définies dans le descripteur de déploiement des applications du client et les ressources réelles confinées dans JNDI par la plateforme.

Syntaxe

AdminResources.createMailSession(nodeName, serverName, 
 mailProviderName, mailSessionName, JNDIName)

Exemple de syntaxe

AdminResources.createMailSession("myNode", "myServer", "myMailProvider", 
 "myMailSession", "myMailSession/jndi")

Script createMailSessionAtScope

Ce script crée une session de messagerie pour votre fournisseur de messagerie avec une portée que vous définissez. Les sessions de messagerie sont représentées par la classe javax.mail.Session. Un objet Session de messagerie authentifie les utilisateurs et contrôle l'accès des utilisateurs aux systèmes de messagerie. Le script renvoie l'ID de configuration de la session de messagerie créée dans la portée spécifiée.

Pour exécuter le script, indiquez la portée, le nom du fournisseur de messagerie, le nom de la session de messagerie ainsi que le nom JNDI (Java Naming and Directory Interface) en tant qu'arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 10. Arguments de createMailSessionAtScope. Exécutez le script pour créer une session de messagerie.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur de messagerie.
mailProviderName Indique le fournisseur de messagerie que le serveur d'applications utilise pour cette session de messagerie.
mailSessionName Indique le nom d'administration de l'objet Session JavaMail.
JNDIName Nom JNDI devant être associé à la ressource, y compris les éventuels sous-contextes de nommage. Ce nom sert de lien entre les informations de liaison de la plateforme pour les ressources définies dans le descripteur de déploiement des applications du client et les ressources réelles confinées dans JNDI par la plateforme.
otherAttributesList
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 11. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
debug Indique si le mode débogage est utilisé pour cette session de messagerie. La valeur par défaut est off.
description Indique une description du fournisseur de messagerie.
mailFrom Indique l'adresse électronique Internet. Si la valeur associée est "true", le fournisseur de messagerie sera chargé dans son propre chargeur de classe.
ATTENTION :
Vous ne pouvez pas isoler un fournisseur si vous spécifiez un chemin de bibliothèque native.
mailStoreHost Indique le serveur auquel se connecter pour recevoir les messages.
mailStorePort Indique le port auquel se connecter pour recevoir les messages.
mailStoreUser Indique l'utilisateur du compte de messagerie lors de l'authentification par le serveur de courrier entrant.
mailStorePassword Indique le mot de passe du compte de messagerie lors de l'authentification par le serveur de courrier entrant.
mailStoreProtocol Spécifie le protocole à utiliser pour la réception des messages.
mailTransportHost Indique le serveur auquel se connecter lors de l'envoi de messages.
mailTransportPort Indique le port auquel se connecter pour envoyer les messages.
mailTransportUser Indique l'utilisateur du compte de messagerie lors de l'authentification par le serveur de courrier sortant.
mailTransportPassword Indique le mot de passe du compte de messagerie lors de l'authentification par le serveur de courrier sortant.
mailTransportProtocol Indique le protocole à utiliser pour l'envoi de messages.
strict Indique si l'adresse de destinataire est analysée en conformité avec la spécification RFC 822. La valeur par défaut est true.

Syntaxe

AdminResources.createMailSessionAtScope(scope,  
 mailProviderName, mailSessionName, JNDIName, otherAttributesList)

Exemple de syntaxe

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminResources.createMailSessionAtScope("myScope", "myMailProvider", 
 "myMailSession", "myMailSession/jndi", attributes")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminResources.createMailSessionAtScope("Node=AMYLIN4Node09, server=server1", "myMailProvider", "myMailSession", 
"myMailSession/jndi", "category=myCategory, debug=true, description='this is my mailsession', mailStoreUser=user1, 
mailStorePassword=password, mailStoreHost=user1, mailStorePort=1000, mailTransportUser=user2, mailTransportPassword=password, 
mailTransportHost=test2, mailTransportPort=1001, strict=true, mailFrom=test1@gmail.com")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

AdminResources.createMailSessionAtScope("/Cell:AMYLIN4Cell01/ServerClust
er:c1/", "myMailProvider", "myMailSession", "myMailSession/jndi", 
[['category','myCategory'], ['description', 'this is mailsession'], ['debug', 'true'], 
['mailTransportHost', 'test1'], ['mailTransportUser', 'user2'], ['mailTransportPassword', 'password'], 
['mailStoreUser', 'user1'], ['mailStorePassword', 'password'], ['mailStoreHost', 'test2'], ['strict', 'true'], 
['mailFrom', 'tester@mail.com']]))

Script createProtocolProvider

Ce script crée un fournisseur de protocole dans votre configuration, lequel fournit la classe d'implémentation d'un protocole spécifique prenant en charge la communication entre votre application JavaMail et vos serveurs de messagerie. Le serveur d'applications contient des fournisseurs de protocole pour SMTP, IMAP et POP3. Si vous avez besoin de fournisseurs de protocole personnalisés pour des protocoles différents, installez-les dans votre environnement servant d'application avant de configurer les fournisseurs. Pour plus d'instructions, reportez-vous à la spécification de conception de l'interface de programme d'application JavaMail. Après avoir configuré vos fournisseurs de protocole, revenez à la page du fournisseur de messagerie afin de trouver le lien qui vous permettra de configurer les sessions de messagerie. Le script renvoie l'ID de configuration du nouveau fournisseur de protocole.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 12. Arguments de createProtocolProvider. Exécutez le script pour créer un fournisseur de protocole.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
mailProviderName Indique le nom du fournisseur de messagerie que le serveur d'applications utilise en association avec le fournisseur de protocole.
protocolName Indique le nom du fournisseur de protocole. Le serveur d'applications contient des fournisseurs de protocole pour SMTP, IMAP et POP3.
className Indique le nom de classe d'implémentation du fournisseur de protocole.
type Indique le type de fournisseur de protocoles. Les options correctes sont Stockage et Transfert.

Syntaxe

AdminResources.createProtocolProvider(nodeName, 
 serverName, mailProviderName, protocolName, 
 className, type)

Exemple de syntaxe

AdminResources.createProtocolProvider("myNode", "myServer", "myMailProvider",
   "myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore", 
   "STORE")

Script createProtocolProviderAtScope

Ce script crée un fournisseur de protocole dans votre configuration avec une portée que vous définissez. Le fournisseur de protocole fournit la classe d'implémentation d'un protocole spécifique prenant en charge la communication entre votre application JavaMail et vos serveurs de messagerie dans la portée que vous spécifiez. Le serveur d'applications contient des fournisseurs de protocole pour SMTP, IMAP et POP3. Si vous avez besoin de fournisseurs de protocole personnalisés pour des protocoles différents, installez-les dans votre environnement servant d'application avant de configurer les fournisseurs. Pour plus d'instructions, reportez-vous à la spécification de conception de l'interface de programme d'application JavaMail. Après avoir configuré vos fournisseurs de protocole, revenez à la page du fournisseur de messagerie afin de trouver le lien qui vous permettra de configurer les sessions de messagerie. Le script renvoie l'ID de configuration du fournisseur de protocole créé dans la portée spécifiée.

Pour exécuter le script, indiquez la portée, le nom du fournisseur de messagerie, le nom du protocole, le nom de classe et le type comme arguments. Vous pouvez aussi spécifier l'attribut du chemin de classe. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 13. Arguments de createProtocolProviderAtScope. Exécutez le script pour créer un fournisseur de protocole.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur de messagerie.
mailProviderName Indique le nom du fournisseur de messagerie que le serveur d'applications utilise en association avec le fournisseur de protocole.
protocolName Indique le nom du fournisseur de protocole. Le serveur d'applications contient des fournisseurs de protocole pour SMTP, IMAP et POP3.
className Indique le nom de classe d'implémentation du fournisseur de protocole.
type Indique le type de fournisseur de protocoles. Les options correctes sont Stockage et Transfert.
otherAttributesList
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 14. Attributs facultatifs. L'attribut classpath est également disponible pour le script.
Attributs Description
classpath Liste de chemins ou de noms de fichiers d'archive Java (JAR) qui, ensemble, spécifient l'emplacement des classes du fournisseur de ressources. Utilisez le point-virgule (;) pour séparer les chemins de classe.

Syntaxe

AdminResources.createProtocolProviderAtScope(nodeName, 
 serverName, mailProviderName, protocolName, 
 className, type, otherAttributesList)

Exemple de syntaxe

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminResources.createProtocolProviderAtScope("myScope", "myMailProvider",
   "myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore", 
   "STORE")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminResources.createProtocolProviderAtScope("Node=AMYLIN4Node09, server=server1", "myMailProvider", "myMailProtocol", 
“com.ibm.mail.myMailProtocol.myMailStore", "STORE", "classpath=c:/temp")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

AdminResources.createProtocolProviderAtScope("/Cell:AMYLIN4Cell01/Server
Cluster:c1/", "myMailProvider", "myMailProtocol", "com.ibm.mail.myMailProtocol.m
yMailStore", "STORE", [['classpath', 'c:/temp']]))

Script createCompleteResourceEnvProvider

Ce script permet de configurer un fournisseur d'environnements de ressources encapsulant les référençables qui convertissent les données des entrées de l'environnement de ressources en objets Ressource dans votre configuration. Le script renvoie l'ID de configuration du nouveau fournisseur d'environnement de ressource.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 15. Arguments de createCompleteResourceEnvProvider. Exécutez le script pour configurer un fournisseur d'environnement de ressource.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
resourceEnvProviderName Indique le nom à attribuer au fournisseur d'environnements de ressources.
propName Indique le nom de la propriété personnalisée à définir.
propValue Valeur de la propriété personnalisée.
factoryClass Indique la fabrique qui convertit les données d'entrée de l'environnement de ressources en une instance de classe associée à une ressource physique.
className Indique le nom de classe du référençable.
resourceEnvEntryName Indique le nom de l'entrée de l'environnement de ressources.
JNDIName Indique le nom JNDI à associer à l'entrée de l'environnement de ressources, y compris les éventuels sous-contextes de changement de nom. Ce nom est utilisé comme lien entre les informations de liaison de la plateforme pour les ressources définies dans le descripteur de déploiement du module et les ressources réelles liées à JNDI par la plateforme.

Syntaxe

AdminResources.createCompleteResourceEnvProvider(nodeName, 
 serverName, resourceEnvProviderName, propName, 
 propValue, factoryClass, className, 
 resourceEnvEntryName, JNDIName)

Exemple de syntaxe

AdminResources.createCompleteResourceEnvProvider("myNode", "myServer", 
 "myResEnvProvider", "myProp", "myPropValue", "com.ibm.resource.res1", "java.lang.String", 
 "myResEnvEntry", "res1/myResEnv")

Script createCompleteResourceEnvProviderAtScope

Ce script crée un fournisseur d'environnement de ressource avec une portée que vous définissez. Le fournisseur d'environnements de ressources encapsule les référençables qui convertissent les données des entrées de l'environnement de ressources en objets ressource dans votre configuration. Le script renvoie l'ID de configuration du fournisseur d'environnement de ressource créé dans la portée spécifiée.

Pour exécuter le script, indiquez la portée, le nom du fournisseur d'environnement de ressource, le nom de la propriété personnalisée, la valeur de la propriété personnalisée, la classe de fabrique, le nom de classe, l'entrée d'environnement de ressource et le nom JNDI comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 16. Arguments de createCompleteResourceEnvProviderAtScope. Exécutez le script pour configurer un fournisseur d'environnement de ressource.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur de messagerie.
resourceEnvProviderName Indique le nom à attribuer au fournisseur d'environnements de ressources.
propName Indique le nom de la propriété personnalisée à définir.
propValue Valeur de la propriété personnalisée.
factoryClass Indique la fabrique qui convertit les données d'entrée de l'environnement de ressources en une instance de classe associée à une ressource physique.
className Indique le nom de classe du référençable.
resourceEnvEntryName Indique le nom de l'entrée de l'environnement de ressources.
jndiName Indique le nom JNDI à associer à l'entrée de l'environnement de ressources, y compris les éventuels sous-contextes de changement de nom. Ce nom est utilisé comme lien entre les informations de liaison de la plateforme pour les ressources définies dans le descripteur de déploiement du module et les ressources réelles liées à JNDI par la plateforme.
otherAttributesList, resourceEnvProviderAttributesList, resourceEnvEntryAttributesList
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Le tableau suivant indique les attributs facultatifs que vous pouvez indiquer pour un fournisseur d'environnement de ressource :
Tableau 17. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
classpath Liste de chemins ou de noms de fichiers d'archive Java (JAR) qui, ensemble, spécifient l'emplacement des classes du fournisseur de ressources. Utilisez le point-virgule (;) pour séparer les chemins de classe.
description Fournit une description du fournisseur d'environnement de ressources.
isolatedClassLoader Si la valeur associée est "true", indique que le fournisseur d'environnement de ressource sera chargé dans son propre chargeur de classe.
Avertissement : Vous ne pouvez pas isoler un fournisseur si vous spécifiez un chemin de bibliothèque native.
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple *.dll ou *.so. Utilisez le point-virgule (;) pour séparer les entrées de chemin natif.
providerType Indique le type de fournisseur de ressources de ce fournisseur d'environnement de ressource.
Le tableau suivant indique les attributs facultatifs que vous pouvez indiquer pour l'entrée d'environnement de ressource :
Tableau 18. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
description Fournit une description du fournisseur de ressources.
providerType Indique le type de fournisseur de messagerie de ce fournisseur d'environnement de ressource.
referenceable Indique le référençable encapsulant le nom de classe de la fabrique qui convertit la donnée d'entrée de l'environnement de ressources en une instance de classe pour une ressource physique.

Syntaxe

AdminResources.createCompleteResourceEnvProviderAtScope(scope, 
  resourceEnvProviderName, propName, 
 propValue, factoryClass, className, 
 resourceEnvEntryName, JNDIName, otherAttributesList, 
resourceEnvProviderAttributesList, resourceEnvProviderAttributesList)

Exemple de syntaxe

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminResources.createCompleteResourceEnvProviderAtScope("myScope", 
 "myResEnvProvider", "myProp", "myPropValue", "com.ibm.resource.res1", "java.lang.String", 
 "myResEnvEntry", "res1/myResEnv")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminResources.createCompleteResourceEnvProviderAtScope("Node=AMYLIN4Node09, server=server1", "myResEnvProvider", "myProp", 
"myPropValue", "com.ibm.resource.res1", "java.lang.String", "myResEnvEntry", "res1/myResEnv", "classpath=c:/temp, 
description='this is my resource provider', nativepath=c:/temp/nativepath, 
isolatedClassLoader=false", "category=myCategory, description='this is my resource entry', 
referenceable=(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09|resources.xml#Referenceable_1238331401156)")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

AdminResources.createCompleteResourceEnvProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myResEnvProvider", 
"myProp", "myPropValue", "com.ibm.resource.res1", "java.lang.String", "myResEnvEntry", "res1/myResEnv", [['classpath', 'c:/temp'], 
['description', 'this is my resource provider'], ['nativepath','c:/temp/nativepath'], ['isolatedClassLoader', 'false']] 
[['category', 'myCategory'], ['description', 'this is my resource entry'], 
['referenceable', '(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09|resources.xml#Referenceable_1238331401156)']])

Script createResourceEnvEntries

Ce script crée une entrée d'environnement de ressources dans votre configuration. Dans un espace de nom de serveur d'applications, les données contenues dans une entrée de l'environnement de ressources sont converties en objet représentant une ressource physique. Cette ressource est fréquemment appelée "Ressource d'environnement". Le script renvoie l'ID de configuration de la nouvelle entrée d'environnement de ressource.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 19. Arguments de createResourceEnvEntries. Exécutez le script pour créer une entrée d'environnement de ressource.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
resourceEnvProviderName Indique le fournisseur d'environnement de ressources pour cette entrée. Le fournisseur encapsule les classes qui, une fois implémentées, convertissent les données de l'entrée d'environnement de ressources en objets Ressource.
referenceable Indique le référençable encapsulant le nom de classe de la fabrique qui convertit la donnée d'entrée de l'environnement de ressources en une instance de classe pour une ressource physique.
resourceEnvEntry Spécifie le nom de l'entrée d'environnement de ressources à créer.
JNDIName Spécifie la chaîne à utiliser pour rechercher cette ressource d'environnement à l'aide de JNDI. Il s'agit de la chaîne à laquelle vous liez les descripteurs de déploiement des références de l'environnement de ressources.

Syntaxe

AdminResources.createResourceEnvEntries(nodeName, 
 serverName, resourceEnvProviderName, referenceable, 
 resourceEnvEntry, JNDIName)

Exemple de syntaxe

AdminResources.createResourceEnvEntries("myNode", "myServer", 
 "myResEnvProvider", "com.ibm.resource.res1", "myResEnvEntry", "res1/myResEnv")

Script createResourceEnvEntriesAtScope

Ce script crée une entrée d'environnement de ressource dans votre configuration avec une portée que vous définissez. Dans un espace de nom de serveur d'applications, les données contenues dans une entrée de l'environnement de ressources sont converties en objet représentant une ressource physique. Cette ressource est fréquemment appelée "Ressource d'environnement". Le script renvoie l'ID de configuration de l'entrée d'environnement de ressource créée dans la portée spécifiée.

Pour exécuter le script, indiquez les arguments de la portée, du fournisseur d'environnement de ressource, de l'entrée d'environnement de ressource et le nom JNDI comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 20. Arguments de createResourceEnvEntriesAtScope. Exécutez le script pour créer une entrée d'environnement de ressource.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur de messagerie.
resourceEnvProviderName Indique le fournisseur d'environnement de ressources pour cette entrée. Le fournisseur encapsule les classes qui, une fois implémentées, convertissent les données de l'entrée d'environnement de ressources en objets Ressource.
resourceEnvEntry Spécifie le nom de l'entrée d'environnement de ressources à créer.
JNDIName Spécifie la chaîne à utiliser pour rechercher cette ressource d'environnement à l'aide de JNDI. Il s'agit de la chaîne à laquelle vous liez les descripteurs de déploiement des références de l'environnement de ressources.
otherAttributesList
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 21. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
description Fournit une description du fournisseur de ressources.
providerType Indique le type de fournisseur de messagerie de ce fournisseur d'environnement de ressource.
referenceable Indique le référençable encapsulant le nom de classe de la fabrique qui convertit la donnée d'entrée de l'environnement de ressources en une instance de classe pour une ressource physique.

Syntaxe

AdminResources.createResourceEnvEntriesAtScope(scope, 
  resourceEnvProviderName, 
 resourceEnvEntry, JNDIName, otherAttributesList)

Exemple de syntaxe

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminResources.createResourceEnvEntriesAtScope("myScope", 
 "myResEnvProvider", "myResEnvEntry", "res1/myResEnv")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminResources.createResourceEnvEntriesAtScope("Node=AMYLIN4Node09, server=server1", "myResEnvProvider", 
"myResEnvEntry", "res1/myResEnv", "category=myCategory, description='this is my resource entry', 
referenceable=(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09|resources.xml#Referenceable_1238331401156)")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

AdminResources.createResourceEnvEntriesAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myResEnvProvider", 
"myResEnvEntry", "res1/myResEnv", [['category', 'myCategory'], ['description', 'this is my resource entry'], 
['referenceable', '(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09|resources.xml#Referenceable_1238331401156)']])

Script createResourceEnvProvider

Ce script crée un fournisseur d'environnement de ressources dans votre configuration. Ce fournisseur encapsule les classes qui, une fois implémentées, convertissent les données de l'entrée d'environnement de ressources en objets Ressource. Le script renvoie l'ID de configuration du nouveau fournisseur d'environnement de ressource.

Pour exécuter le script, spécifiez le nom du noeud, le nom du serveur ainsi que le nom du fournisseur d'environnement de ressources en tant qu'arguments, comme défini dans le tableau ci-après :
Tableau 22. Arguments de createResourceEnvProvider. Exécutez le script pour créer un fournisseur d'environnement de ressource.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
resourceEnvProviderName Indique le fournisseur d'environnement de ressources à créer.

Syntaxe

AdminResources.createResourceEnvProvider(nodeName, 
 serverName, resourceEnvProviderName)

Exemple de syntaxe

AdminResources.createResEnvProvider("myNode", "myServer", 
 "myResEnvProvider")

Script createResourceEnvProviderAtScope

Ce script crée un fournisseur d'environnement de ressource dans votre configuration avec une portée que vous définissez. Ce fournisseur encapsule les classes qui, une fois implémentées, convertissent les données de l'entrée d'environnement de ressources en objets Ressource. Le script renvoie l'ID de configuration du fournisseur d'environnement de ressource créé dans la portée spécifiée.

Pour exécuter le script, indiquez la portée et le nom du fournisseur d'environnement de ressource comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 23. Arguments de createResourceEnvProviderAtScope. Exécutez le script pour créer un fournisseur d'environnement de ressource.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur de messagerie.
resourceEnvProviderName Indique le fournisseur d'environnement de ressources à créer.
otherAttributesList
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 24. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
classpath Liste de chemins ou de noms de fichiers d'archive Java (JAR) qui, ensemble, spécifient l'emplacement des classes du fournisseur de ressources. Utilisez le point-virgule (;) pour séparer les chemins de classe.
description Fournit une description du fournisseur d'environnement de ressources.
isolatedClassLoader Si la valeur associée est "true", indique que le fournisseur d'environnement de ressource sera chargé dans son propre chargeur de classe.
Avertissement : Vous ne pouvez pas isoler un fournisseur si vous spécifiez un chemin de bibliothèque native.
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple *.dll ou *.so. Utilisez le point-virgule (;) pour séparer les entrées de chemin natif.
providerType Indique le type de fournisseur de ressources de ce fournisseur d'environnement de ressource.

Syntaxe

AdminResources.createResourceEnvProviderAtScope(scope, 
 resourceEnvProviderName, otherAttributesList)

Exemple de syntaxe

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminResources.createResEnvProviderAtScope("myScope", 
 "myResEnvProvider")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminResources.createResourceEnvProviderAtScope("Node=AMYLIN4Node09, server=server1", "myResEnvProvider", 
"classpath=c:/temp, description='this is my resource provider', nativepath=c:/temp/nativepath, isolatedClassLoader=false")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

AdminResources.createResourceEnvProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", 
"myResEnvProvider", [['classpath', 'c:/temp'], 
['description','this is my resource provider'], ['nativepath', 'c:/temp/nativepath'], ['isolatedClassLoader', 'false']])

Script createResourceEnvProviderRef

Ce script crée une référence de fournisseur d'environnement de ressources dans votre configuration. Les références d'environnement de ressources diffèrent des références de ressources. Les premières permettent au client d'applications d'utiliser un nom logique pour rechercher une liaison de ressource dans l'espace de noms JNDI du serveur. Les secondes permettent à votre application d'utiliser un nom logique pour rechercher une ressource JEE locale. La spécification JEE n'indique pas d'implémentation de ressource particulière. Le script renvoie l'ID de configuration de l'ID de référence du nouveau fournisseur d'environnement de ressource.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 25. Arguments de createResourceEnvProviderRef. Exécutez le script pour créer une référence de fournisseur d'environnement de ressource.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
resourceEnvProviderName Indique le fournisseur d'environnement de ressources pour cette référence. Le fournisseur encapsule les classes qui, une fois implémentées, convertissent les données de l'entrée d'environnement de ressources en objets Ressource.
factoryClass Indique la classe de la fabrique qui convertit les données d'entrée de l'environnement de ressources en une instance de classe associée à une ressource physique.
className Indique le nom de classe à associer au référençable.

Syntaxe

AdminResources.createResourceEnvProviderRef(nodeName, 
 serverName, resourceEnvProviderName, factoryClass, 
 className)

Exemple de syntaxe

AdminResources.createResourceEnvProviderRef("monNoeud",
"monServeur", 
 "myResEnvProvider", "com.ibm.resource.res1", "java.lang.String")

Script createResourceEnvProviderRefAtScope

Ce script crée une référence de fournisseur d'environnement de ressource dans votre configuration avec une portée que vous définissez. Les références d'environnement de ressources diffèrent des références de ressources. Les premières permettent au client d'applications d'utiliser un nom logique pour rechercher une liaison de ressource dans l'espace de noms JNDI du serveur. Les secondes permettent à votre application d'utiliser un nom logique pour rechercher une ressource JEE locale. La spécification JEE n'indique pas d'implémentation de ressource particulière. Le script renvoie l'ID de configuration de l'ID de référence du fournisseur d'environnement de ressource créé dans la portée spécifiée.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 26. Arguments de createResourceEnvProviderRefAtScope. Exécutez le script pour créer une référence de fournisseur d'environnement de ressource.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur de messagerie.
resourceEnvProviderName Indique le fournisseur d'environnement de ressources pour cette référence. Le fournisseur encapsule les classes qui, une fois implémentées, convertissent les données de l'entrée d'environnement de ressources en objets Ressource.
factoryClass Indique la classe de la fabrique qui convertit les données d'entrée de l'environnement de ressources en une instance de classe associée à une ressource physique.
className Indique le nom de classe à associer au référençable.

Syntaxe

AdminResources.createResourceEnvProviderRefAtScope(scope, 
 resourceEnvProviderName, factoryClass, 
 className, otherAttributesList)

Exemple de syntaxe

AdminResources.createResourceEnvProviderRefAtScope("/Node:AMYLIN4Node09/Server:server1/", 
"myResEnvProvider", "com.ibm.resource.res1", "java.lang.String")

Script configURLProvider

Ce script configure un fournisseur d'URL qui fournit les classes d'implémentation nécessaires au serveur d'applications pour accéder à une URL au travers d'un protocole spécifique. Le fournisseur d'URL par défaut fournit une connectivité au travers de protocoles pris en charge par IBM® Developer Kit. Ces protocoles incluent HTTP et FTP (File Transfer Protocol), qui fonctionnent pour les URL indispensables.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 27. Arguments de configURLProvider. Exécutez le script pour configurer un fournisseur d'URL.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
URLProviderName Indique le nom du fournisseur d'URL à configurer.
URLStreamHandlerClass Indique le nom qualifié complet d'une classe Java définie par l'utilisateur, qui étend la classe java.net.URLStreamHandler à un protocole d'URL spécifique, tel que FTP.
URLProtocol Spécifie le protocole pris en charge par ce gestionnaire de flux. Par exemple, NNTP, SMTP ou FTP.
propName Indique le nom de la propriété personnalisée à définir pour le fournisseur d'URL.
propValue Indique la valeur de la propriété personnalisée à définir pour le fournisseur d'URL.
URLName Spécifie une adresse URL pointant vers une ressource Internet ou intranet, par exemple : http://www.ibm.com.
JNDIName Indique le nom JNDI. N'attribuez pas deux fois le même nom JNDI à différents types de ressources, tels que des sessions de messagerie par opposition à des configurations d'URL. N'affectez pas de nom JNDI en double à plusieurs ressources d'un même type dans la même portée.
URLSpec Spécifie la chaîne à partir de laquelle vous pouvez former une URL.

Syntaxe

AdminResources.configURLProvider(nodeName, serverName, 
 URLProviderName, URLStreamHandlerClass, URLProtocol, 
 propName, propValue, URLName, JNDIName, 
 URLSpec)

Exemple de syntaxe

AdminResources.configURLProvider("monNoeud",
"monServeur", "myURLProvider", 
 "com.ibm.resource.url1", "ftp",
"maProp", "maValeurProp",
"monURL", "url1/monURL",
 "maSpécURL")

createCompleteURLProvider

Ce script crée un fournisseur d'URL qui fournit les classes d'implémentation nécessaires au serveur d'applications pour accéder à une URL au travers d'un protocole spécifique. Le fournisseur d'URL par défaut fournit une connectivité au travers de protocoles pris en charge par IBM Developer Kit. Ces protocoles incluent HTTP et FTP (File Transfer Protocol), qui fonctionnent pour les URL indispensables. Le script renvoie l'ID de configuration du nouveau fournisseur d'URL.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 28. Arguments de createCompleteURLProvider. Exécutez le script pour créer un fournisseur d'URL.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
URLProviderName Indique le nom du fournisseur d'URL à configurer.
URLStreamHandlerClass Indique le nom qualifié complet d'une classe Java définie par l'utilisateur, qui étend la classe java.net.URLStreamHandler à un protocole d'URL spécifique, tel que FTP.
URLProtocol Spécifie le protocole pris en charge par ce gestionnaire de flux. Par exemple, NNTP, SMTP ou FTP.

Syntaxe

AdminResources.createCompleteURLProvider(nodeName, 
 serverName, URLProviderName, URLStreamHandlerClass, 
 URLProtocol)

Exemple de syntaxe

AdminResources.createCompleteURLProvider("myNode", "myServer", 
 "myURLProvider", "com.ibm.resource.url1", "ftp")

Script createCompleteURLProviderAtScope

Ce script crée un fournisseur d'URL dans la portée spécifiée. Le fournisseur d'URL fournit les classes d'implémentation nécessaires au serveur d'applications pour accéder à une URL au travers d'un protocole spécifique. Le fournisseur d'URL par défaut fournit une connectivité au travers de protocoles pris en charge par IBM Developer Kit. Ces protocoles incluent HTTP et FTP (File Transfer Protocol), qui fonctionnent pour les URL indispensables. Le script renvoie l'ID de configuration du fournisseur d'URL créé dans la portée spécifiée.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 29. Arguments de createCompleteURLProviderAtScope. Exécutez le script pour créer un fournisseur d'URL.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur de messagerie.
URLProviderName Indique le nom du fournisseur d'URL à configurer.
URLStreamHandlerClass Indique le nom qualifié complet d'une classe Java définie par l'utilisateur, qui étend la classe java.net.URLStreamHandler à un protocole d'URL spécifique, tel que FTP.
URLProtocol Spécifie le protocole pris en charge par ce gestionnaire de flux. Par exemple, NNTP, SMTP ou FTP.
propName Indique le nom de la propriété personnalisée à définir pour le fournisseur d'URL.
propValue Indique la valeur de la propriété personnalisée à définir pour le fournisseur d'URL.
URLName Spécifie une adresse URL pointant vers une ressource Internet ou intranet, par exemple : http://www.ibm.com.
jndiName Indique le nom JNDI. N'attribuez pas deux fois le même nom JNDI à différents types de ressources, tels que des sessions de messagerie par opposition à des configurations d'URL. N'affectez pas de nom JNDI en double à plusieurs ressources d'un même type dans la même portée.
URLSpec Spécifie la chaîne à partir de laquelle vous pouvez former une URL.
otherAttributesList, urlProviderAttributesList, urlAttributesList
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Le tableau suivant indique les attributs facultatifs que vous pouvez indiquer pour le fournisseur d'URL :
Tableau 30. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
classpath Liste de chemins ou de noms de fichiers d'archive Java (JAR) qui, ensemble, spécifient l'emplacement des classes du fournisseur de ressources. Utilisez le point-virgule (;) pour séparer les chemins de classe.
description Fournit une description du fournisseur d'environnement de ressources.
isolatedClassLoader Si la valeur associée est "true", indique que le fournisseur d'URL sera chargé dans son propre chargeur de classe.
Avertissement : Vous ne pouvez pas isoler un fournisseur si vous spécifiez un chemin de bibliothèque native.
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple *.dll ou *.so. Utilisez le point-virgule (;) pour séparer les entrées de chemin natif.
providerType Indique le type de fournisseur d'URL de ce fournisseur d'environnement de ressource.
Le tableau suivant indique les attributs facultatifs que vous pouvez indiquer pour le fournisseur d'URL :
Tableau 31. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
description Fournit une description du fournisseur de ressources.
providerType Indique le type de fournisseur de messagerie de ce fournisseur d'environnement de ressource.
referenceable Indique le référençable encapsulant le nom de classe de la fabrique qui convertit la donnée d'entrée de l'environnement de ressources en une instance de classe pour une ressource physique.

Syntaxe

AdminResources.createCompleteURLProviderAtScope(Scope, 
  URLProviderName, URLStreamHandlerClass, 
 URLProtocol, propName, propValue, 
 URLName, JNDIName, URLSpec, otherAttributesList,  urlProviderAttributesList,  urlAttributesList)

Exemple de syntaxe

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminResources.createCompleteURLProviderAtScope("Scope", 
 "myURLProvider", "com.ibm.resource.url1", "ftp", myProp", myPropValue",
 "myURL", "url1/myURL", "myURLSpec")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminResources.createCompleteURLProviderAtScope("Node=AMYLIN4Node09,
server=server1", "myURLProvider", 
"com.ibm.resource.url1", 
"ftp","myProp", "myPropValue", "myURL", "url1/myURL", "myURLSpec", "classpath=c:/temp, description='this
 is my url provider', 
nativepath=c:/temp/nativepath, isolatedClassLoader=true", "category=myCategory, description='this is my url'")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

AdminResources.createCompleteURLProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", 
"myURLProvider", "com.ibm.resource.url1", 
"ftp","myProp", "myPropValue", "myURL", "url1/myURL", "myURLSpec", [['classpath', 'c:/temp'], 
['description', 'this is my urlProvider'], 
['nativepath', 'c:/temp/nativepath'], ['isolatedClassLoader', 'true']] [['category', 'myCategory'], 
['description', 'this is my url']])

createURL

Ce script crée un fournisseur d'URL qui fournit les classes d'implémentation nécessaires au serveur d'applications pour accéder à une URL au travers d'un protocole spécifique. Le fournisseur d'URL par défaut fournit une connectivité au travers de protocoles pris en charge par IBM Developer Kit. Ces protocoles incluent HTTP et FTP (File Transfer Protocol), qui fonctionnent pour les URL indispensables. Le script renvoie l'ID de configuration de la nouvelle adresse URL.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 32. Arguments de createURL. Exécutez le script pour créer un fournisseur d'URL.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
URLProviderName Indique le nom du fournisseur d'URL auquel affecter l'URL.
URLName Indique le nom de l'URL à créer.
JNDIName Indique le nom JNDI. N'attribuez pas deux fois le même nom JNDI à différents types de ressources, tels que des sessions de messagerie par opposition à des configurations d'URL. N'affectez pas de nom JNDI en double à plusieurs ressources d'un même type dans la même portée.
URLSpec Spécifie la chaîne à partir de laquelle vous pouvez former une URL.

Syntaxe

AdminResources.createURL(nodeName, serverName, 
 URLProviderName, URLName, JNDIName, 
 URLSpec)

Exemple de syntaxe

AdminResources.createURL("myNode", "myServer", "myURLProvider", 
 "myURL", "url1/myURL", "myURLSpec")

createURLAtScope

Ce script crée un fournisseur d'URL avec une portée que vous définissez. Le fournisseur d'URL fournit les classes d'implémentation nécessaires au serveur d'applications pour accéder à une URL au travers d'un protocole spécifique. Le fournisseur d'URL par défaut fournit une connectivité au travers de protocoles pris en charge par IBM Developer Kit. Ces protocoles incluent HTTP et FTP (File Transfer Protocol), qui fonctionnent pour les URL indispensables. Le script renvoie l'ID de configuration de l'adresse URL créée dans la portée spécifiée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur d'URL, le nom de l'URL, le nom JNDI, ainsi que la spécification d'URL comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 33. Arguments de createURLAtScope. Exécutez le script pour créer un fournisseur d'URL.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur de messagerie.
URLProviderName Indique le nom du fournisseur d'URL auquel affecter l'URL.
URLName Indique le nom de l'URL à créer.
JNDIName Indique le nom JNDI. N'attribuez pas deux fois le même nom JNDI à différents types de ressources, tels que des sessions de messagerie par opposition à des configurations d'URL. N'affectez pas de nom JNDI en double à plusieurs ressources d'un même type dans la même portée.
URLSpec Spécifie la chaîne à partir de laquelle vous pouvez former une URL.
otherAttributesList
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 34. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
description Indique une description du fournisseur d'URL.
providerType Indique le type de fournisseur de messagerie du fournisseur d'URL.

Syntaxe

AdminResources.createURLAtScope(scope, 
 URLProviderName, URLName, JNDIName, 
 URLSpec, otherAttributesList)

Exemple de syntaxe

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminResources.createURLAtScope("myScope", "myURLProvider", 
 "myURL", "url1/myURL", "myURLSpec")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminResources.createURLAtScope("Node=AMYLIN4Node09, server=server1", "myURLProvider", "myURL", "url1/myURL", 
"myURLSpec", "category=myCategory, description='this is my url'")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

AdminResources.createURLAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/",
 "myURLProvider", "myURL", "url1/myURL", "myURLSpec", [['category', 'myCategory'], ['description', 'this is my url']])

createURLProvider

Ce script crée un fournisseur d'URL qui fournit les classes d'implémentation nécessaires au serveur d'applications pour accéder à une URL au travers d'un protocole spécifique. Le fournisseur d'URL par défaut fournit une connectivité au travers de protocoles pris en charge par IBM Developer Kit. Ces protocoles incluent HTTP et FTP (File Transfer Protocol), qui fonctionnent pour les URL indispensables. Le script renvoie l'ID de configuration du nouveau fournisseur d'URL.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 35. Arguments de createURLProvider. Exécutez le script pour créer un fournisseur d'URL.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
URLProviderName Indique le nom du fournisseur d'URL à configurer.
URLStreamHandlerClass Indique le nom qualifié complet d'une classe Java définie par l'utilisateur, qui étend la classe java.net.URLStreamHandler à un protocole d'URL spécifique, tel que FTP.
URLProtocol Spécifie le protocole pris en charge par ce gestionnaire de flux. Par exemple, NNTP, SMTP ou FTP.

Syntaxe

AdminResources.createURLProvider(nodeName, 
 serverName, URLProviderName, URLStreamHandlerClass, 
 URLProtocol)

Exemple de syntaxe

AdminResources.createURLProvider("myNode", "myServer", 
 "myURLProvider", "com.ibm.resource.url1", "ftp")

createURLProviderAtScope

Ce script crée un fournisseur d'URL avec une portée que vous définissez. Le fournisseur d'URL fournit les classes d'implémentation nécessaires au serveur d'applications pour accéder à une URL au travers d'un protocole spécifique. Le fournisseur d'URL par défaut fournit une connectivité au travers de protocoles pris en charge par IBM Developer Kit. Ces protocoles incluent HTTP et FTP (File Transfer Protocol), qui fonctionnent pour les URL indispensables. Le script renvoie l'ID de configuration du fournisseur d'URL créé dans la portée spécifiée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur d'URL, la classe du gestionnaire de flux de l'URL et le protocole de l'URL comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 36. Arguments de createURLProviderAtScope. Exécutez le script pour créer un fournisseur d'URL.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur de messagerie.
URLProviderName Indique le nom du fournisseur d'URL à configurer.
URLStreamHandlerClass Indique le nom qualifié complet d'une classe Java définie par l'utilisateur, qui étend la classe java.net.URLStreamHandler à un protocole d'URL spécifique, tel que FTP.
URLProtocol Spécifie le protocole pris en charge par ce gestionnaire de flux. Par exemple, NNTP, SMTP ou FTP.
otherAttributesList
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 37. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
classpath Liste de chemins ou de noms de fichiers d'archive Java (JAR) qui, ensemble, spécifient l'emplacement des classes du fournisseur de ressources. Utilisez le point-virgule (;) pour séparer les chemins de classe.
description Fournit une description du fournisseur d'environnement de ressources.
isolatedClassLoader Si la valeur associée est "true", indique que le fournisseur d'URL sera chargé dans son propre chargeur de classe.
Avertissement : Vous ne pouvez pas isoler un fournisseur si vous spécifiez un chemin de bibliothèque native.
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple *.dll ou *.so. Utilisez le point-virgule (;) pour séparer les entrées de chemin natif.
providerType Indique le type de fournisseur d'URL de ce fournisseur d'environnement de ressource.

Syntaxe

AdminResources.createURLProviderAtScope(scope, 
  URLProviderName, URLStreamHandlerClass, 
 URLProtocol, otherAttributesList)

Exemple de syntaxe

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminResources.createURLProviderAtScope("myScope", 
 "myURLProvider", "com.ibm.resource.url1", "ftp")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminResources.createURLProviderAtScope("Node=AMYLIN4Node09, server=server1", "myURLProvider", "com.ibm.resource.url1", 
"ftp", "classpath=c:/temp, description='this is my url provider', nativepath=c:/temp/nativepath, isolatedClassLoader=true")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

AdminResources.createURLProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myURLProvider", "com.ibm.resource.url1", 
"ftp", [['classpath', 'c:/temp'], ['description', 'this is my url provider'], ['nativepath', 'c:/temp/nativepath'], 
['isolatedClassLoader', 'true']])

createJAASAuthenticationAlias

Ce script crée un alias d'authentification JAAS (JavaAuthentication and Authorization Service) qui identifie les données d'authentification entrées. Lorsque l'administrateur configure les adaptateurs de ressources ou les sources de données JDBC, il peut indiquer les données d'authentification à choisir pour l'alias correspondant. Le script renvoie l'ID de configuration du nouvel alias d'authentification JAAS (JavaAuthentication and Authorization Service).

Pour exécuter le script, indiquez les arguments suivants :
Tableau 38. Arguments de createJAASAuthenticationAlias. Exécutez le script pour créer un alias d'authentification JAAS.
Argument Description
authAliasName Indique le nom de l'alias d'authentification à créer.
authAliasID Identité d'utilisateur du domaine de sécurité voulu. Par exemple, si une entrée de données d'authentification particulière est utilisée pour ouvrir une nouvelle connexion à DB2, cette entrée contient une identité d'utilisateur DB2.
authAliasPW Indique le mot de passe de l'identité d'utilisateur codé dans le référentiel de configuration.

Syntaxe

AdminResources.createJAASAuthenticationAlias(authAliasName, 
 authAliasID, authAliasPW)

Exemple de syntaxe

AdminResources.createJAASAuthenticationAlias("myJAAS", "user01", 
 "password")

createLibraryRef

Ce script crée une référence de bibliothèque, qui définit comment utiliser des bibliothèques globales. La première étape permettant de rendre un fichier de bibliothèque accessible par plusieurs applications déployées sur un serveur consiste à créer une bibliothèque partagée pour chaque fichier de bibliothèque requis par vos applications. Lorsque vous créez les bibliothèques partagées, définissez les variables des fichiers de bibliothèque. Le script renvoie l'ID de configuration de la nouvelle référence de bibliothèque.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 39. Arguments de createLibraryRef. Exécutez le script pour créer une référence de bibliothèque.
Argument Description
libraryRefName Indique le nom de la référence de bibliothèque à créer.
applicationName Indique le nom de l'application à associer à la référence de bibliothèque.

Syntaxe

AdminResources.createLibraryRef(libraryRefName, 
 applicationName)

Exemple de syntaxe

AdminResources.createLibraryRef("myLibrary", "myApplication")

createSharedLibrary

Ce script crée une bibliothèque partagée dans votre configuration. La première étape permettant de rendre un fichier de bibliothèque accessible par plusieurs applications déployées sur un serveur consiste à créer une bibliothèque partagée pour chaque fichier de bibliothèque requis par vos applications. Lorsque vous créez les bibliothèques partagées, définissez les variables des fichiers de bibliothèque. Le script renvoie l'ID de configuration de la nouvelle bibliothèque.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 40. Arguments de createSharedLibrary. Exécutez le script pour créer une bibliothèque partagée.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
sharedLibName Indique le nom à attribuer à la bibliothèque partagée.
sharedLibClassPath Indique le chemin où le produit recherchera des classes et des ressources de la bibliothèque partagée. Si ce chemin correspond à un fichier, le produit effectue une recherche dans le contenu du fichier d'archive .jar ou du fichier compressé .zip. S'il s'agit d'un répertoire, le produit analysera le contenu des fichiers .jar et .zip de ce répertoire. Pour des raisons de performances, le produit n'effectue une recherche dans le répertoire lui-même que s'il comporte des sous-répertoires ou des fichiers de type autre que .jar ou .zip.

Syntaxe

AdminResources.createSharedLibrary(nodeName, 
 serverName, sharedLibName, sharedLibClassPath)

Exemple de syntaxe

[Windows]
AdminResources.createSharedLibrary("myNode", "myServer", 
 "myLibrary", "c:/myLibrary.zip")
[AIX][Solaris][Linux][HP-UX][IBM i][z/OS]
AdminResources.createSharedLibrary("myNode", "myServer", "myLibrary", 
 "/myLibrary.zip")

createSharedLibraryAtScope

Ce script crée une bibliothèque partagée dans votre configuration avec une portée que vous définissez. La première étape permettant de rendre un fichier de bibliothèque accessible par plusieurs applications déployées sur un serveur consiste à créer une bibliothèque partagée pour chaque fichier de bibliothèque requis par vos applications. Lorsque vous créez les bibliothèques partagées, définissez les variables des fichiers de bibliothèque. Le script renvoie l'ID de configuration de la bibliothèque créée dans la portée spécifiée.

Pour exécuter le script, indiquez le nom de la bibliothèque partagée et le chemin de classe de la bibliothèque partagée de la portée comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 41. Arguments de createSharedLibraryAtScope. Exécutez le script pour créer une bibliothèque partagée.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur de messagerie.
sharedLibName Indique le nom à attribuer à la bibliothèque partagée.
sharedLibClassPath Indique le chemin où le produit recherchera des classes et des ressources de la bibliothèque partagée. Si ce chemin correspond à un fichier, le produit effectue une recherche dans le contenu du fichier d'archive .jar ou du fichier compressé .zip. S'il s'agit d'un répertoire, le produit analysera le contenu des fichiers .jar et .zip de ce répertoire. Pour des raisons de performances, le produit n'effectue une recherche dans le répertoire lui-même que s'il comporte des sous-répertoires ou des fichiers de type autre que .jar ou .zip.
otherAttributesList
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 42. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
description Fournit une description de la bibliothèque partagée.
isolatedClassLoader Si la valeur associée est "true", indique que le fournisseur d'URL sera chargé dans son propre chargeur de classe. La valeur par défaut est false.
Avertissement : Vous ne pouvez pas isoler un fournisseur si vous spécifiez un chemin de bibliothèque native.
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple *.dll ou *.so. Utilisez le point-virgule (;) pour séparer les entrées de chemin natif.

Syntaxe

AdminResources.createSharedLibraryAtScope(scope, 
 sharedLibName, sharedLibClassPath, otherAttributesList)

Exemple de syntaxe

L'exemple de script suivant contient uniquement des attributs obligatoires :

[Windows]
AdminResources.createSharedLibraryAtScope("myScope", 
 "myLibrary", "c:/myLibrary.zip")
[AIX][Solaris][Linux][HP-UX][IBM i][z/OS]
AdminResources.createSharedLibraryAtScope("myScope", "myLibrary", 
 "/myLibrary.zip")

L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :

[Windows]
 AdminResources.createSharedLibraryAtScope("Node=AMYLIN4Node09, server=server1", "myLibrary", 
"c:/myLibrary.zip", "description='this is my library', 
nativePath=c:/nativepath, isolatedClassLoader=true")
[AIX][Solaris][Linux][HP-UX][IBM i][z/OS]
 AdminResources.createSharedLibraryAtScope("Node=AMYLIN4Node09, server=server1", "myLibrary", 
"c:/myLibrary.zip", "description='this is my library', 
nativePath=/nativepath, isolatedClassLoader=true")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

[Windows]
AdminResources.createSharedLibraryAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myLibrary", 
"c:/myLibrary.zip", [['description', 'this is my library'], 
['nativePath', 'c:/nativepath'], ['isolatedClassLoader', 'true']])
[AIX][Solaris][Linux][HP-UX][IBM i][z/OS]
AdminResources.createSharedLibraryAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myLibrary", 
"c:/myLibrary.zip", [['description', 'this is my library'], 
['nativePath', '/nativepath'], ['isolatedClassLoader', 'true']])

createScheduler

Ce script crée un planificateur dans votre configuration. Les planificateurs sont des services de temporisation transactionnels et persistants qui exécutent la logique métier. Chaque planificateur exécute des tâches indépendamment et dispose d'une interface de programmation accessible à partir des applications JEE à l'aide de l'interface JNDI (Java Naming and Directory Interface). Vous pouvez également gérer des planificateurs à l'aide d'un MBean JMX (Java Management Extensions). Pour plus d'informations sur la configuration et l'utilisation des planificateurs, voir la documentation correspondante dans le centre de documentation. Le script renvoie l'ID de configuration du nouveau planificateur.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 43. Arguments de createScheduler. Exécutez le script pour créer un planificateur.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
schedulerName Indique le nom identifiant ce service de planification à des fins administratives.
JNDIName Indique le nom JNDI qui détermine l'emplacement où cette instance de planificateur est liée dans l'espace de nom. Les clients peuvent rechercher ce nom directement bien qu'il soit préférable d'utiliser les références de ressources.
scheduleCategory Indique une chaîne permettant de classifier ou de grouper ce service de planification.
datasourceJNDI Indique le nom de la source de données dans laquelle sont stockés les tâches persistantes. Toute source de données disponible dans l'espace de nom peut être utilisée avec un planificateur. Plusieurs planificateurs peuvent partager une source de données unique tout en utilisant des tables différentes en indiquant un préfixe de table.
tablePrefix Indique le préfixe de chaîne à ajouter au début du nom des tables du planificateur. Plusieurs services de planification indépendants peuvent partager la même base de données si chaque instance définit une chaîne différente pour le préfixe.
pollInterval Indique l'intervalle en secondes pendant lequel un planificateur interroge la base de données. La valeur par défaut est adaptée à la plupart des applications. Les interrogations peuvent nécessiter beaucoup de ressources. En effet, si l'intervalle est très court et qu'un grand nombre de tâches sont planifiées, l'opération d'interrogation peut mobiliser une grande partie des ressources système. La valeur par défaut est 30.
workMgmtJNDI Indique le nom JNDI du gestionnaire de tâches utilisé pour gérer le nombre de tâches pouvant être exécutées à l'aide du planificateur. Le gestionnaire de travaux peut également limiter la quantité de contexte JEE appliquée à la tâche.

Syntaxe

AdminResources.createScheduler(nodeName, serverName, 
 schedulerName, JNDIName, scheduleCategory, 
 datasourceJNDI, tablePrefix, pollInterval, workMgmtJNDI)

Exemple de syntaxe

AdminResources.createScheduler("myNode", "myServer", "myScheduler", 
 "myScheduleJndi", "Default", "jdbc/MyDatasource", "sch1", "30", 
 "myWorkManager")

createSchedulerAtScope

Ce script crée un planificateur dans votre configuration avec une portée que vous définissez. Les planificateurs sont des services de temporisateur transactionnels et persistants qui exécutent la logique métier. Chaque planificateur exécute des tâches indépendamment et dispose d'une interface de programmation accessible à partir des applications JEE à l'aide de l'interface JNDI (Java Naming and Directory Interface). Vous pouvez également gérer des planificateurs à l'aide d'un MBean JMX (Java Management Extensions). Pour plus d'informations sur la configuration et l'utilisation des planificateurs, voir la documentation correspondante dans le centre de documentation. Le script renvoie l'ID de configuration du planificateur créé dans la portée spécifiée.

Pour exécuter le script, indiquez la portée, le nom du planificateur, son nom JNDI, la source de données JNDI, le préfixe de la table, la fréquence de sondage, le nom JNDI du gestionnaire de travaux et l'ID de fournisseur du planificateur comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 44. Arguments de createSchedulerAtScope. Exécutez le script pour créer un planificateur.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
schedulerName Indique le nom identifiant ce service de planification à des fins administratives.
JNDIName Indique le nom JNDI qui détermine l'emplacement où cette instance de planificateur est liée dans l'espace de nom. Les clients peuvent rechercher ce nom directement bien qu'il soit préférable d'utiliser les références de ressources.
datasourceJNDI Indique le nom de la source de données dans laquelle sont stockés les tâches persistantes. Toute source de données disponible dans l'espace de nom peut être utilisée avec un planificateur. Plusieurs planificateurs peuvent partager une source de données unique tout en utilisant des tables différentes en indiquant un préfixe de table.
tablePrefix Indique le préfixe de chaîne à ajouter au début du nom des tables du planificateur. Plusieurs services de planification indépendants peuvent partager la même base de données si chaque instance définit une chaîne différente pour le préfixe.
pollInterval Indique l'intervalle en secondes pendant lequel un planificateur interroge la base de données. La valeur par défaut est adaptée à la plupart des applications. Les interrogations peuvent nécessiter beaucoup de ressources. En effet, si l'intervalle est très court et qu'un grand nombre de tâches sont planifiées, l'opération d'interrogation peut mobiliser une grande partie des ressources système. La valeur par défaut est 30.
workMgmtJNDI Indique le nom JNDI du gestionnaire de tâches utilisé pour gérer le nombre de tâches pouvant être exécutées à l'aide du planificateur. Le gestionnaire de travaux peut également limiter la quantité de contexte JEE appliquée à la tâche.
schedulerProviderID Indique l'ID de fournisseur du planificateur.
otherAttributesList
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 45. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
description Indique une description du fournisseur d'URL.
providerType Indique le type de fournisseur de ressources du fournisseur d'URL.
datasourceAlias Indique l'alias du nom d'utilisateur et le mot de passe utilisés par ce fournisseur d'URL pour accéder à la source de données.
loginConfigName Indique le nom de configuration du module de connexion.
securityRole Indique le rôle de sécurité.
useAdminRoles Indique qu'en cas d'activation de cette option et de la sécurité administrative, les rôles d'administration des utilisateurs sont appliqués. Pour que les rôles administratifs des utilisateurs soient appliqués, vous devez utiliser les API ou les commandes JMX du planificateur pour créer et modifier des tâches. Si cette option n'est pas activée, tous les utilisateurs peuvent créer et modifier des tâches. La valeur par défaut est false.
referenceable Indique le référençable encapsulant le nom de classe de la fabrique qui convertit la donnée d'entrée de l'environnement de ressources en une instance de classe pour une ressource physique.

Syntaxe

AdminResources.createSchedulerAtScope(scope, 
 schedulerName, JNDIName,
 datasourceJNDI, tablePrefix, pollInterval, workMgmtJNDI,
 ScheduleProviderID, otherAttributesList)

Exemple de syntaxe

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminResources.createSchedulerAtScope("myNode",  "myScheduler", 
 "myScheduleJndi", "Default", "jdbc/MyDatasource", "sch1", "30", 
 "myWorkManager, "SchedulerProvider(cells/AMYLIN4Cell01/nodes/AMY
LIN4Node09/servers/server1|resources-pme.xml#SchedulerProvider_1)")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminResources.createSchedulerAtScope("Node=AMYLIN4Node09, server=server1", "myScheduler", 
"myScheduleJndi", "jdbc/MyDatasource", "sch1", "30", 
"myWorkManager",  “SchedulerProvider(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09/servers/server1|
resources-pme.xml#SchedulerProvider_1)", "category=myCategory, 
description='this is my scheduler', datasourceAlias=abc, useAdminRoles=false, loginConfigName=test, securityRole=user1")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

AdminResources.createSchedulerAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myScheduler", 
"myScheduleJndi", "jdbc/MyDatasource", "sch1", "30", 
"myWorkManager", "SchedulerProvider(cells/AMYLIN4Cell01/clusters/c1|resources-pme.xml#SchedulerProvider_1)", 
[['category', 'myCategory'], ['description', 'this is my scheduler'], ['datasourceAlias', 'abc'], ['useAdminRoles', 'false'],
 ['loginConfigName', 'test'], ['securityRole', 'user1']])

createWorkManager

Ce script crée un gestionnaire de travaux dans votre configuration. Les gestionnaires de travaux contiennent un groupe d'unités d'exécution liées à l'interface JNDI (Java Naming and Directory Interface). Le script renvoie l'ID de configuration du nouveau gestionnaire de travaux.

Pour exécuter le script, indiquez les arguments suivants :
Tableau 46. Arguments de createWorkManager. Exécutez le script pour créer un gestionnaire de travaux.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
workMgrName Indique le nom sous lequel le gestionnaire de travaux est connu de l'administrateur.
JNDIName Indique le nom JNDI (Java Naming and Directory Interface) utilisé pour rechercher le gestionnaire de travaux dans l'espace de nom.
workMgrCategory Chaîne permettant de classifier ou de grouper ce gestionnaire de travaux.
alarmThreads Indique le nombre maximal d'unités d'exécution à utiliser pour les alarmes. La valeur par défaut est 2.
minThreads Indique le nombre minimal d'unités d'exécution disponibles dans ce gestionnaire de travaux.
maxThreads Indique le nombre maximal d'unités d'exécution disponibles dans ce gestionnaire de travaux.
threadPriority Indique la priorité des unités d'exécution disponibles dans ce gestionnaire de travaux. Une priorité est affectée à chaque unité d'exécution. Les unités d'exécution dotées d'une priorité plus élevée sont lancées avant celles dotées d'une priorité moindre. Pour plus d'informations sur le mode d'utilisation des priorités d'unité d'exécution, voir la documentation sur les API relative à la méthode setPriority de la classe java.lang.Thread dans la spécification Java EE.
isGrowable Indique si vous pouvez augmenter le nombre d'unités d'exécution dans ce gestionnaire de travaux. Spécifiez la valeur true pour indiquer que le nombre d'unités d'exécution peut être augmenté.
serviceNames Donne la liste des services auxquels ce gestionnaire de travaux doit pouvoir accéder.

Syntaxe

AdminResources.createWorkManager(nodeName, serverName, 
 workMgrName, JNDIName, workMgrCategory, 
 alarmThreads, minThreads, maxThreads, threadPriority, isGrowable, serviceNames)

Exemple de syntaxe

AdminResources.createWorkManager("myNode", "myServer", "myWorkManager", 
 "Work Manager", "wm/myWorkManager", "Default", 5, 1, 10, 5, "true",
   "AppProfileService UserWorkArea com.ibm.ws.i18n security")

createWorkManagerAtScope

Ce script crée un gestionnaire de travaux dans votre configuration avec une portée que vous définissez. Les gestionnaires de travaux contiennent un groupe d'unités d'exécution liées à l'interface JNDI (Java Naming and Directory Interface). Le script renvoie l'ID de configuration du gestionnaire de travaux créé dans la portée spécifiée.

Pour exécuter le script, indiquez pour la portée, le nom du gestionnaire de travaux, son nom JNDI, les unités d'exécution des alarmes, le maximum et le minimum d'unités d'exécution, la priorité des unités d'exécution et l'ID de fournisseur du gestionnaire de travaux comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 47. Arguments de createWorkManageratScope. Exécutez le script pour créer un gestionnaire de travaux.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
workMgrName Indique le nom sous lequel le gestionnaire de travaux est connu de l'administrateur.
JNDIName Indique le nom JNDI (Java Naming and Directory Interface) utilisé pour rechercher le gestionnaire de travaux dans l'espace de nom.
alarmThreads Indique le nombre maximal d'unités d'exécution à utiliser pour les alarmes. La valeur par défaut est 2.
minThreads Indique le nombre minimal d'unités d'exécution disponibles dans ce gestionnaire de travaux.
maxThreads Indique le nombre maximal d'unités d'exécution disponibles dans ce gestionnaire de travaux.
threadPriority Indique la priorité des unités d'exécution disponibles dans ce gestionnaire de travaux. Une priorité est affectée à chaque unité d'exécution. Les unités d'exécution dotées d'une priorité plus élevée sont lancées avant celles dotées d'une priorité moindre. Pour plus d'informations sur le mode d'utilisation des priorités d'unité d'exécution, voir la documentation sur les API relative à la méthode setPriority de la classe java.lang.Thread dans la spécification Java EE.
workManagerProviderID Indique l'ID configuration du fournisseur de gestionnaire de travaux parent. Le gestionnaire de travaux est créé avec cet ID. Vous pouvez créer un gestionnaire de travaux sous un fournisseur de gestionnaire de travaux existant ou sous un nouveau fournisseur de gestionnaire de travaux. L'exemple de commande wsadmin suivant montre comment récupérer l'ID de configuration d'un fournisseur de gestionnaire de travaux existant depuis la portée d'un serveur :
workManagerProviderID = AdminConfig.getid
(“/Cell:myCell/Node:myNode/Server:myServer
/WorkManagerProvider:/”)
otherAttributesList
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 48. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
description Indique une description du fournisseur d'URL.
providerType Indique le type de fournisseur de ressources du fournisseur d'URL.
daemonTranClass Indique la classe de transaction utilisée pour la classification de la charge de travail d'un travail de démon. Le travail du démon est destiné au service WLM.
defTranClass Indique le nom de la classe de transaction employé pour classifier le travail exécuté par cette instance de gestionnaire de travaux lorsque les informations de classe du service WLM de z/OS ne figurent pas dans les informations du contexte de travail.
isDistributable Indique si ce gestionnaire de travaux peut être distribué. La valeur par défaut est false.
isGrowable Indique si vous pouvez augmenter le nombre d'unités d'exécution dans ce gestionnaire de travaux. La valeur par défaut est true.
serviceNames Spécifie la liste des services auxquels ce gestionnaire de travaux doit pouvoir accéder.
workReqQFullAction Action entreprise lorsque le groupe d'unités d'exécution et la file d'attente des demandes de travaux sont saturés. La valeur par défaut est 0.
workReqQSize Indique la taille de la file d'attente des demandes de travaux. La valeur par défaut est 0.
workTimeout Indique le temps d'attente (en millisecondes) avant la tentative de libération d'une unité de travail. La valeur par défaut est 0.
referenceable Indique le référençable encapsulant le nom de classe de la fabrique qui convertit la donnée d'entrée de l'environnement de ressources en une instance de classe pour une ressource physique.
otherAttributesList
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"

Syntaxe

AdminResources.createWorkManagerAtScope(scope, 
 workMgrName, JNDIName, 
 alarmThreads, minThreads, maxThreads, threadPriority, workManagerProviderID, otherAttributesList)

Exemple de syntaxe

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminResources.createWorkManagerAtScope("scope", "myWorkManager", 
 "Work Manager", "Default", 5, 1, 10,
   "WorkManagerProvider(cells/AMYLIN4Cell01/nodes/A
MYLIN4Node09/servers/server1|resources-pme.xml#WorkManagerProvider_1)")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminResources.createWorkManagerAtScope("Node=AMYLIN4Node09, server=server1", "myWorkManager", 
"wm/myWorkManager", "5", "1", "10", "5", 
"WorkManagerProvider(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09/servers/server1|resources-pme.xml#WorkManagerProvider_1)")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

AdminResources.createWorkManagerAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myWorkManager", 
"wm/myWorkManager", "5", "1", "10", "5", 
WorkManagerProvider(cells/AMYLIN4Cell01/clusters/c1|resources-pme.xml#WorkManagerProvider_1)", 
[['category', 'myCategory'], ['description', 'this is my workmanager'], 
['daemonTranClass', ''], ['defTranClass', ''], ['isDistributable', 'false'], ['isGrowable', 'true'], ['serviceNames', 'security'], ['workReqQFullAction', 0], 
['workReqQSize', 0], ['workTimeout', 10]])

help

Ce script affiche les procédures de script prises en charge par la bibliothèque de scripts AdminResources. Pour accéder à l'aide détaillée d'un script spécifique, indiquez le nom du script qui vous intéresse, comme défini dans le tableau ci-après :
Tableau 49. Arguments de help. Exécutez le script pour afficher l'aide.
Argument Description
script Indique le nom du script qui vous intéresse.

Syntaxe

AdminResources.help(script)

Exemple de syntaxe

AdminResources.help("createWorkManager")

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7libmail
Nom du fichier : rxml_7libmail.html