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.
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
authenticationAlias | Indique l'alias d'authentification de la spécification d'activation J2C créée. |
|
description | Donne une description de la spécification d'activation J2C créée. |
|
destinationJndiName | Indique le nom JNDI de destination de la spécification d'activation J2C créée. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
description | Donne une description de l'objet d'administration J2C créé. |
|
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")
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.
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.
|
Attribut | Description | Exemple |
---|---|---|
authDataAlias | Indique l'alias de données d'authentification géré par composant de la fabrique de connexions créée. |
|
description | Indique la description de la fabrique de connexions J2C créée. |
|
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")
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.
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.
|
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]](../images/windows.gif)
AdminJ2C.installJ2CResourceAdapter("myNode",
"C:\temp\jca15cmd.rar", "J2CTest")
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
AdminJ2C.installJ2CResourceAdapter("myNode", "/temp/jca15cmd.rar", "J2CTest")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
![[Windows]](../images/windows.gif)
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]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
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]](../images/windows.gif)
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]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
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']])