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/ .

- Script createCompleteResourceEnvProvider
- Script createCompleteResourceEnvProviderAtScope
- Script createResourceEnvEntries
- Script createResourceEnvEntriesAtScope
- Script createResourceEnvProvider
- Script createResourceEnvProviderAtScope
- Script createResourceEnvProviderRef
- Script createResourceEnvProviderRefAtScope
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.
Portée | Chemin d'imbrication | ID configuration | Type |
---|---|---|---|
Cell | /Cell:myCell/ |
|
Cell=myCell ou cell=myCell |
Noeud | /Cell:myCell/Node:myNode/ ou /Node:myNode/ |
|
ou
ou
|
Serveur |
ou
|
|
ou
or
|
Cluster |
or
|
|
or
or
|
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.
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.
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.
|
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. |
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")
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.
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.
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.
|
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")
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.
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.
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.
|
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")
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.
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.
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.
|
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")
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.
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.
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.
|
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. |
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")
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.
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.
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.
|
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")
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.
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.
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.
|
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")
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.
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.
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.
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.
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.
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.
|
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. |
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")
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.
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.
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.
|
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")
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.
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.
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.
|
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")
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).
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.
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.
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]](../images/windows.gif)
AdminResources.createSharedLibrary("myNode", "myServer",
"myLibrary", "c:/myLibrary.zip")
![[AIX]](../images/aixlogo.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
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.
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.
|
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]](../images/windows.gif)
AdminResources.createSharedLibraryAtScope("myScope",
"myLibrary", "c:/myLibrary.zip")
![[AIX]](../images/aixlogo.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminResources.createSharedLibraryAtScope("myScope", "myLibrary",
"/myLibrary.zip")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
![[Windows]](../images/windows.gif)
AdminResources.createSharedLibraryAtScope("Node=AMYLIN4Node09, server=server1", "myLibrary",
"c:/myLibrary.zip", "description='this is my library',
nativePath=c:/nativepath, isolatedClassLoader=true")
![[AIX]](../images/aixlogo.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
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]](../images/windows.gif)
AdminResources.createSharedLibraryAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myLibrary",
"c:/myLibrary.zip", [['description', 'this is my library'],
['nativePath', 'c:/nativepath'], ['isolatedClassLoader', 'true']])
![[AIX]](../images/aixlogo.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
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.
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.
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.
|
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)")
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.
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.
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 :
|
otherAttributesList | Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
|
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.
|
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)")
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
Argument | Description |
---|---|
script | Indique le nom du script qui vous intéresse. |
Syntaxe
AdminResources.help(script)
Exemple de syntaxe
AdminResources.help("createWorkManager")