Scripts de configuration J2C

La bibliothèque de scripts propose de nombreuses procédures de script destinées à gérer les configurations J2C (Java™ 2 Connector). Les scripts présentés dans cette rubrique permettent de créer des spécifications d'activation, des objets d'administration et des fabriques de connexions ou d'installer des adaptateurs de ressources. Vous pouvez exécuter chaque script individuellement ou combiner plusieurs procédures pour créer des scripts d'automatisation personnalisés pour votre environnement.

Chaque procédure de script J2C se trouve dans le répertoire app_server_root/scriptLibraries/resources/J2C.

Utilisez les procédures de script suivantes pour configurer J2C dans votre environnement :

createJ2CActivationSpec

Ce script crée une spécification d'activation J2C dans votre configuration. Le script renvoie l'ID configuration de la nouvelle spécification d'activation J2C.

Pour exécuter le script, indiquez l'adaptateur de ressources, le nom de la spécification d'activation, le type de programme d'écoute des messages ainsi que les arguments liés au nom JNDI (Java Naming and Directory Interface). Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 1. Script createJ2CActivationSpec. Exécutez le script pour créer une spécification d'activation J2C.
Argument Description
resourceAdapterID Indique l'ID configuration de l'adaptateur de ressources qui vous intéresse.
activationSpecName Indique le nom à attribuer à la nouvelle spécification d'activation.
messageListenerType Indique le type du programme d'écoute des messages.
jndiName Indique le nom JNDI (Java Naming and Directory Interface).
attributes
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 2. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
authenticationAlias Indique l'alias d'authentification de la spécification d'activation J2C créée.
["authenticationAlias", "myAlias"]
description Donne une description de la spécification d'activation J2C créée.
["description", "My description"]
destinationJndiName Indique le nom JNDI de destination de la spécification d'activation J2C créée.
["destinationJndiName", "myDestinationJndi"]

Syntaxe

AdminJ2C.createJ2CActivationSpec(resourceAdapterID, 
 activationSpecName, messageListenerType, jndiName, 
 attributes)

Syntaxe

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

AdminJ2C.createJ2CActivationSpec(
"J2CTest(cells/myCell/nodes/myNode|resources.xml#J2CResourceAdapter_1184091767578))", "J2CASTest", "javax.jms.MessageListener2", "jndiAS")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJ2C.createJ2CActivationSpec(
"J2CTest(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1245171531343)", 
"J2CASTest","javax.jms.MessageListener", "jndi/as1", 
"description=this is my J2C ActivationSpecification, 
destinationJndiName=jndi/J2CAS, authenticationAlias=J2CASTest")

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

AdminJ2C.createJ2CActivationSpec(
"myj2c(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1238380711218)", 
"J2CAC1", "javax.jms.MessageListener", "jndi/as", [['description','new j2cActivationSpec'], 
['destinationJndiName','ds/jndi'], ['authenticationAlias','test']])

createJ2CAdminObject

Ce script crée un objet d'administration J2C dans votre configuration. Le script renvoie l'ID configuration du nouvel objet d'administration J2C.

Pour exécuter le script, indiquez l'adaptateur de ressources, le nom de la spécification d'activation, le nom JNDI (Java Naming and Directory Interface) ainsi que les arguments liés au nom de l'interface d'objet d'administration. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 3. Script createJ2CAdminObject. Exécutez le script pour créer un objet d'administration J2C.
Argument Description
resourceAdapterID Indique l'ID configuration de l'adaptateur de ressources qui vous intéresse.
activationSpecName Indique le nom à attribuer à la nouvelle spécification d'activation.
adminObjectInterface Indique le nom de l'interface d'objet d'administration.
jndiName Indique le nom JNDI (Java Naming and Directory Interface).
attributes
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 4. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
description Donne une description de l'objet d'administration J2C créé.
["description", "My description"]

Syntaxe

AdminJ2C.createJ2CAdminObject(resourceAdapterID, 
 activationSpecName, adminObjectInterface, jndiName, 
 attributes)

Syntaxe

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

AdminJ2C.createJ2CAdminObject(
"J2CTest(cells/myCell/nodes/myNode|resources.xml#J2CResourceAdapter_1184091767578)",
 "J2CAOTest", "fvt.adapter.message.FVTMessageProvider2", "jndiAO")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJ2C.createJ2CAdminObject(
"J2CTest(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1245171531343)", 
"J2CAOTest", "fvt.adapter.message.FVTMessageProvider", "jndi/ao1", 
"description=this is my J2C AdminObject")

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

AdminJ2C.createJ2CAdminObject(
"myj2c(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1238380711218)", 
"J2CAO1", "fvt.adapter.message.FVTMessageProvider", "jndi/ao", 
[['description','new j2cAdminObject']])

createJ2CConnectionFactory

Ce script crée une fabrique de connexions J2C dans votre configuration. Le script renvoie l'ID configuration de la nouvelle fabrique de connexions J2C.

Pour exécuter le script, indiquez l'adaptateur de ressources, le nom de la fabrique de connexions, l'interface de la fabrique de connexions ainsi que les arguments liés au nom JNDI (Java Naming and Directory Interface). Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 5. Script createJ2CConnectionFactory. Exécutez le script pour créer une fabrique de connexions J2C.
Argument Description
resourceAdapterID Indique l'ID configuration de l'adaptateur de ressources qui vous intéresse.
connFactoryName Indique le nom à attribuer à la nouvelle fabrique de connexions.
connFactoryInterface Indique l'interface de la fabrique de connexions.
jndiName Indique le nom JNDI (Java Naming and Directory Interface).
attributes
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 6. Attributs facultatifs. Autres attributs disponibles pour le script.
Attribut Description Exemple
authDataAlias Indique l'alias de données d'authentification géré par composant de la fabrique de connexions créée.
["authDataAlias", "myAuthDataAlias"]
description Indique la description de la fabrique de connexions J2C créée.
["description", "My description"]

Syntaxe

AdminJ2C.createJ2CConnectionFactory(resourceAdapterID, 
 connFactoryName, connFactoryInterface, jndiName, 
 attributes)

Syntaxe

AdminJ2C.createJ2CConnectionFactory(
"J2CTest(cells/myCell/nodes/myNode|resources.xml#J2CResourceAdapter_11840917675
578)", "J2CCFTest", "javax.sql.DataSource2", "jndiCF")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJ2C.createJ2CConnectionFactory(
"J2CTest(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1245171531343)", 
"J2CCFTest", "javax.sql.DataSource", "jndi/j2ccftest", 
"description=this is my J2CConnectionFactory, authDataAlias=J2CTest")

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

AdminJ2C.createJ2CConnectionFactory(
"myj2c(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1238380711218)", 
"J2CCFTest", "javax.sql.DataSource2", "jndi/cf", 
[['description', 'new j2ccf'], ['authDataAlias', 'test']]) 

Script installJ2CResourceAdapter

Ce script installe un adaptateur de ressources J2C dans votre configuration. Le script renvoie l'ID configuration du nouvel adaptateur de ressources J2C.

Pour exécuter le script, indiquez le nom du noeud, le fichier d'archive RAR contenant l'adaptateur de ressources, ainsi que les arguments liés au nom de l'adaptateur de ressources. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 7. Script installJ2CResourceAdapter. Exécutez le script pour installer un adaptateur de ressources J2C.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
rarFile Indique le chemin complet du fichier RAR à installer.
resourceAdapterName Indique le nom à attribuer au nouvel adaptateur de ressources.
attributes
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
rar.desc Indique la description de l'adaptateur de ressources J2C.
rar.archivePath Indique le nom du chemin dans lequel le fichier est extrait. Si ce chemin n'est pas spécifié, le fichier archive est extrait dans le répertoire $CONNECTOR_INSTALL_ROOT.
rar.classpath Indique le chemin d'accès aux classes supplémentaire.
rar.nativePath Indique le chemin d'accès natif.
rar.threadPoolAlias Indique l'alias du pool d'unités d'exécution.
rar.propertiesSet Indique l'ensemble de propriétés de l'adaptateur de ressources J2C.
rar.DeleteSourceRar Indique si le fichier RAR source doit être supprimé.
rar.isolatedClassLoader Indique la valeur booléenne du chargeur de classe isolé.
rar.enableHASupport Indique la valeur booléenne de la haute disponibilité activée.
rar.HACapability Indique le type de la fonction de haute disponibilité.

Syntaxe

AdminJ2C.installJ2CResourceAdapter(nodeName, rarFile, 
 resourceAdapterName, attributes)

Syntaxe

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

[Windows]
AdminJ2C.installJ2CResourceAdapter("myNode", 
 "C:\temp\jca15cmd.rar", "J2CTest")
[IBM i][z/OS][Linux][Solaris][AIX][HP-UX]
AdminJ2C.installJ2CResourceAdapter("myNode", "/temp/jca15cmd.rar", "J2CTest")

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

[Windows]
AdminJ2C.installJ2CResourceAdapter("AMYLIN4CellManager03", "c:\ears\jca15cmd.rar", "J2CTest", "rar.desc=this is J2C, 
rar.archivePath=c:\temp\test.rar, rar.classpath=c:\temp, rar.isolatedClassLoader=false, rar.enableHASupport=true, 
rar.DeleteSourceRar=false")
[IBM i][z/OS][Linux][Solaris][AIX][HP-UX]
AdminJ2C.installJ2CResourceAdapter("AMYLIN4CellManager03", "/ears/jca15cmd.rar", "J2CTest", "rar.desc=this is J2C, 
rar.archivePath=/temp/test.rar, rar.classpath=/temp, rar.isolatedClassLoader=false, rar.enableHASupport=true, 
rar.DeleteSourceRar=false")

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

[Windows]
AdminJ2C.installJ2CResourceAdapter("AMYLIN4Node09", "c:\ears\jca15cmd.rar", "j2ctest", [['rar.desc', 'this is J2C'], 
['rar.archivePath', 'c:\temp\test.rar'], ['rar.classpath', 'c:\temp'], ['rar.nativePath', ''], ['rar.threadPoolAlias', 'test'], 
['rar.isolatedClassLoader', 'false'], ['rar.enableHASupport', 'true'], ['rar.DeleteSourceRar', 'false']])
[IBM i][z/OS][Linux][Solaris][AIX][HP-UX]
AdminJ2C.installJ2CResourceAdapter("AMYLIN4Node09", "/ears/jca15cmd.rar", "j2ctest", [['rar.desc', 'this is J2C'], 
['rar.archivePath', '/temp/test.rar'], ['rar.classpath', '/temp'], ['rar.nativePath', ''], ['rar.threadPoolAlias', 'test'], 
['rar.isolatedClassLoader', 'false'], ['rar.enableHASupport', 'true'], ['rar.DeleteSourceRar', 'false']])

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_7adminj2c2
Nom du fichier : rxml_7adminj2c2.html