Scripts de configuración JMS

La biblioteca de scripts proporciona muchos procedimientos de script para gestionar las configuraciones JMS (Java™ Message Service). Consulte la información de uso para los scripts que consultan la configuración JMS. Puede ejecutar cada script de forma individual o combinar varios procedimientos para crear scripts de automatización personalizados para el entorno.

Cada procedimiento de script de gestión de AdminJMS se encuentra en el directorio raíz_servidor_aplicaciones/scriptLibraries/resources/JMS/V70.

A partir de la versión 7, la biblioteca de scripts Jython proporciona funciones de script para proveedores JDBC y recursos JMS y proveedores de recursos en el ámbito del servidor. Puede escribir sus propios scripts para configurar recursos en la célula, nodo o nivel de clúster.
Avoid trouble Avoid trouble: No edite los procedimientos de script de la biblioteca de scripts. Para escribir procedimientos personalizados de la biblioteca de scripts, utilice los scripts del directorio raíz_servidor_aplic/scriptLibraries como ejemplo de sintaxis de Jython. Guarde los scripts personalizados en un subdirectorio nuevo para evitar sobrescribir la biblioteca.gotcha
Vía de acceso rápida: A partir del fixpack 5, la biblioteca de scripts Jython proporciona funciones de script para recursos JMS y proveedores de recursos en el ámbito de célula, el nodo, el servidor o clúster. Los proveedores de recursos incluyen proveedores de correo, proveedores de URL y proveedores del entorno de recursos. No tiene que escribir scripts personalizados para configurar recursos en un ámbito determinado.
Atención: Los scripts del ejemplo de uso y la sintaxis del script se han partido en varias líneas para facilitar la impresión.

Formato del argumento scope

El formato de scope se aplica a los scripts de la biblioteca de scripts que tienen el argumento scope.

Una célula es opcional en los ámbitos de nodo, servidor y clúster. Se requiere un nodo en el ámbito de servidor.

Puede delimitar el tipo utilizando una coma (,) o un signo de dos puntos (:). Puede utilizar las minúsculas para el tipo (cell=, node=, server= o cluster=.)

Los ejemplos de la tabla siguiente se dividen en varias líneas para facilitar su publicación.

Tabla 1. Ejemplos de vía de acceso de contención, ID de configuración y tipo de un ámbito concreto. El ámbito puede ser Célula, Nodo, Servidor o Clúster.
Ámbito Vía de acceso de contención ID de configuración Tipo
Cell /Cell:myCell/
myCell(cells/myCell|
cell.xml#Cell_1)
Cell=myCell o cell=myCell
Nodo /Cell:myCell/Node:myNode/ o /Node:myNode/
myNode(cells/myCell
/nodes/myNode|
node.xml#Node_1)
Cell=myCell,
Node=myNode
o
Cell=myCell:
Node=myNode
o
cell=myCell,
node=myNode
Servidor
/Cell:myCell/Node:
myNode/
Server:myServer/
o
/Node:myNode/Server:
myServer/
myServer(cells
/myCell/
nodes/myNode/
servers/myServer|
server.xml#Server_1)
Cell=myCell,
Node=myNode,
Server=myServer
o bien
Node=myNode:
Server=myServer
o bien
cell=myCell,
Node=myNode,
Server=myServer
Clúster
/Cell:myCell/
ServerCluster:
myCluster/
o bien
/ServerCluster:
myCluster/
myCluster(cells
/myCell/clusters/
myCluster|
cluster.xml
#ServerCluster_1)
Cell=myCell,
Cluster=myCluster
o bien
Cell=myCell:
Cluster=myCluster
o bien
cell=myCell,
Cluster=myCluster

createGenericJMSConnectionFactory

Este script crea una fábrica de conexiones JMS genérica en la configuración. El script devuelve el ID de configuración de la fábrica de conexiones JMS creada en la célula respectiva.

Para ejecutar el script, especifique los argumentos de nombre de nodo, nombre de servidor, nombre de proveedor de JMS, nombre de la nueva fábrica de conexiones, nombre JNDI y nombre JNDI externo. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 2. Argumentos del script createGenericJMSConnectionFactory. Ejecute el script para crear una fábrica de conexiones JMS genérica.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jmsProvider Especifica el nombre del proveedor de JMS.
connFactoryName Especifica el nombre que se va a asignar a la nueva fábrica de conexiones.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
extJndiName Especifica el nombre JNDI utilizado para enlazar la cola con el espacio de nombres del servidor de aplicaciones. Como convenio, utilice el nombre JNDI plenamente cualificado; por ejemplo, con el formato jms/Nombre, donde Nombre es el nombre lógico del recurso. Este nombre se utiliza para enlazar la información de enlace de la plataforma. El enlace asocia los recursos definidos en el descriptor de despliegue del módulo con los recursos reales (físicos) enlazados con JNDI por la plataforma.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 3. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
XAEnabled Especifica si se ha habilitado el proceso de recuperación XA.
['XAEnabled', 'false']
authDataAlias Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Especifica el mecanismo de autenticación. Los valores válidos son BASIC_PASSWORD para autenticación básica y KERBEROS para autenticación Kerberos.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['authMechanismPreference', 
'BASIC_PASSWORD']
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
connectionPool Especifica las propiedades de agrupación de conexiones JMS de la instancia de fábrica de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
diagnoseConnectionUsage Especifica si se ha habilitado el diagnóstico de uso de la conexión.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
['logMissingTransactionContext', 'true']
manageCachedHandles Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es true.
['manageCachedHandles', 'true']
mapping Especifica la correlación del inicio de sesión de configuración con un nombre de alias de autenticación especificado.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Especifica los valores de configuración de conexión de preprueba.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties Especifica un tipo de propiedad definida o un tipo de propiedad descriptiva.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["properties",[["description","Mi descripción"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
sessionPool Especifica las propiedades de agrupación de sesiones JMS de la instancia de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
['xaRecoveryAuthAlias', 'myCellManager01/a1']
Tabla 4. Atributos opcionales (continuación). Atributo adicional disponible para el script.
Atributos Descripción Ejemplo
type Especifica QUEUE para colas, TOPIC para temas y UNIFIED para colas y temas.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['type', 'TOPIC']

Sintaxis

AdminJMS.createGenericJMSConnectionFactory(nodeName, 
 serverName, jmsProvider, connFactoryName, jndiName, 
 extJndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createGenericJMSConnectionFactory("myNode", "myServer", 
 "JMSTest", "JMSCFTest", "jmsjndi", "extjmsjndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createGenericJMSConnectionFactory("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName", "XAEnabled=false, 
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory, 
description='my JMS Connection Factory',
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true, 
providerType=myJMSProviderType, type=TOPIC, xaRecoveryAuthAlias=myCellManager01/a1")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createGenericJMSConnectionFactory("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"My Generic JMSConnection Factory",
"JNDIName", "extJNDIName", [['XAEnabled', 'false'], ['authDataAlias', 'myAuthDataAlias'], 
['authMechanismPreference', 'BASIC_PASSWORD'], ['category', 'myCategory'], 
['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], 
['numberOfUnsharedPoolPartitions', '3'], 
['properties', [[['description', 'My description'], ['name', 'myName'], 
['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeCreationInterval', '10'], 
['surgeThreshold', '10'], ['testConnection', 'true'], ['testConnectionInterval', '10'], 
['unusedTimeout', '10000']]], ['description', 'My description'], 
['diagnoseConnectionUsage', 'false'], ['logMissingTransactionContext', 'true'], 
['manageCachedHandles', 'true'], ['mapping', [['authDataAlias', 'authDataAliasValue'], 
['mappingConfigAlias', 'mappingConfigAliasValue']]], ['preTestConfig', 
[['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', 
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], 
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], 
['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], 
['value', 50000]]]]]], ['providerType', 'myJMSProviderType'], ['sessionPool', 
[['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], 
['maxConnections', '12'], ['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], 
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties', 
[[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], 
['surgeCreationInterval', '10'], ['surgeThreshold', '10'], 
['testConnection', 'true'], ['testConnectionInterval', '10'], [
'unusedTimeout', '10000']]], ['type', 'TOPIC'], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

createGenericJMSConnectionFactoryUsingTemplate

Este script utiliza una plantilla para crear una fábrica de conexiones JMS genérica en la configuración. El script devuelve el ID de configuración de la fábrica de conexiones JMS creada mediante una plantilla en la célula respectiva.

Para ejecutar el script, especifique los argumentos de nombre de nodo, nombre de servidor, nombre de proveedor de JMS, ID de plantilla, nombre de fábrica de conexiones, nombre JNDI y nombre JNDI externo. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 5. Argumentos del script createGenericJMSConnectionFactoryUsingTemplate. Ejecute el script para crear una fábrica de conexiones JMS genérica.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jmsProvider Especifica el nombre del proveedor de JMS.
templateID Especifica el ID de configuración de la plantilla que se va a utilizar.
connFactoryName Especifica el nombre que se va a asignar a la nueva fábrica de conexiones.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
extJndiName Especifica el nombre JNDI utilizado para enlazar la cola con el espacio de nombres del servidor de aplicaciones. Como convención, utilice el nombre JNDI plenamente cualificado; por ejemplo, con el formato jms/Nombre, donde Nombre es el nombre lógico del recurso. Este nombre se utiliza para enlazar la información de enlace de la plataforma. El enlace asocia los recursos definidos en el descriptor de despliegue del módulo con los recursos reales (físicos) enlazados con JNDI por la plataforma.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 6. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
XAEnabled Especifica si se ha habilitado el proceso de recuperación XA.
['XAEnabled', 'false']
authDataAlias Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Especifica el mecanismo de autenticación. Los valores válidos son BASIC_PASSWORD para autenticación básica y KERBEROS para autenticación Kerberos.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['authMechanismPreference', 
'BASIC_PASSWORD']
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
connectionPool Especifica las propiedades de agrupación de conexiones JMS de la instancia de fábrica de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
diagnoseConnectionUsage Especifica si se ha habilitado el diagnóstico de uso de la conexión.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
['logMissingTransactionContext', 'true']
manageCachedHandles Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es true.
['manageCachedHandles', 'true']
mapping Especifica la correlación del inicio de sesión de configuración con un nombre de alias de autenticación especificado.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Especifica los valores de configuración de conexión de preprueba.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties Especifica un tipo de propiedad definida o un tipo de propiedad descriptiva.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["properties",[["description","Mi descripción"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
sessionPool Especifica las propiedades de agrupación de sesiones JMS de la instancia de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
['xaRecoveryAuthAlias', 'myCellManager01/a1']
Tabla 7. Atributos opcionales (continuación). Atributo adicional disponible para el script.
Atributos Descripción Ejemplo
type Especifica QUEUE para colas, TOPIC para temas y UNIFIED para colas y temas.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['type', 'TOPIC']

Sintaxis

AdminJMS.createGenericJMSConnectionFactoryUsingTemplate(nodeName, 
 serverName, jmsProvider, templateID, 
 connFactoryName, jndiName, extJndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createGenericJMSConnectionFactoryUsingTemplate("myNode", "myServer", 
 "JMSTest", "Generic QueueConnectionFactory for 
 Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)", 
"JMSCFTest", "jmsjndi", "extjmsjndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createGenericJMSConnectionFactoryUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Generic QueueConnectionFactory for Windows
(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)", 
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName",  "XAEnabled=false, 
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory, 
description='my JMS Connection Factory using template',
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true, 
providerType=myJMSProviderType, type=TOPIC, xaRecoveryAuthAlias=myCellManager01/a1")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createGenericJMSConnectionFactoryUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Generic QueueConnectionFactory for Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)", 
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName", [['XAEnabled', 'false'], 
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], 
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'], 
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeCreationInterval', '10'], 
['surgeThreshold', '10'], ['testConnection', 'true'], ['testConnectionInterval', '10'], 
['unusedTimeout', '10000']]], ['description', 'My description'], ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping', 
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myJMSProviderType'], ['sessionPool', [['agedTimeout', '100'], 
['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'], 
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], 
['type', 'TOPIC'], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

createGenericJMSConnectionFactoryAtScope

Este script crea una fábrica de conexiones JMS genérica nueva en la configuración en el ámbito que especifique. El script devuelve el ID de configuración de la fábrica de conexiones JMS creada en la célula respectiva.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de JMS, nombre de la nueva fábrica de conexiones, nombre JNDI y nombre JNDI externo. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 8. Argumentos del script createGenericJMSConnectionFactoryAtScope. Ejecute el script para crear una fábrica de conexiones JMS genérica.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
jmsProvider Especifica el nombre del proveedor de JMS.
connFactoryName Especifica el nombre que se va a asignar a la nueva fábrica de conexiones.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
extJndiName Especifica el nombre JNDI utilizado para enlazar la cola con el espacio de nombres del servidor de aplicaciones. Como convenio, utilice el nombre JNDI plenamente cualificado; por ejemplo, con el formato jms/Nombre, donde Nombre es el nombre lógico del recurso. Este nombre se utiliza para enlazar la información de enlace de la plataforma. El enlace asocia los recursos definidos en el descriptor de despliegue del módulo con los recursos reales (físicos) enlazados con JNDI por la plataforma.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 9. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
XAEnabled Especifica si se ha habilitado el proceso de recuperación XA.
['XAEnabled', 'false']
authDataAlias Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Especifica el mecanismo de autenticación. Los valores válidos son BASIC_PASSWORD para autenticación básica y KERBEROS para autenticación Kerberos.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['authMechanismPreference', 
'BASIC_PASSWORD']
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
connectionPool Especifica las propiedades de agrupación de conexiones JMS de la instancia de fábrica de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
diagnoseConnectionUsage Especifica si se ha habilitado el diagnóstico de uso de la conexión.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
['logMissingTransactionContext', 'true']
manageCachedHandles Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es true.
['manageCachedHandles', 'true']
mapping Especifica la correlación del inicio de sesión de configuración con un nombre de alias de autenticación especificado.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Especifica los valores de configuración de conexión de preprueba.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties Especifica un tipo de propiedad definida o un tipo de propiedad descriptiva.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["properties",[["description","Mi descripción"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
sessionPool Especifica las propiedades de agrupación de sesiones JMS de la instancia de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
['xaRecoveryAuthAlias', 'myCellManager01/a1']
Tabla 10. Atributos opcionales (continuación). Atributo adicional disponible para el script.
Atributos Descripción Ejemplo
type Especifica QUEUE para colas, TOPIC para temas y UNIFIED para colas y temas.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['type', 'TOPIC']

Sintaxis

AdminJMS.createGenericJMSConnectionFactoryAtScope(scope, 
 jmsProvider, connFactoryName, jndiName, 
 extJndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createGenericJMSConnectionFactoryAtScope("myScope", "JMSTest", "JMSCFTest", "jmsjndi", 
"extjmsjndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createGenericJMSConnectionFactoryAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My Generic JMSConnection Factory", "JNDIName", "extJNDIName", 
"XAEnabled=false, authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, 
category=myCategory, diagnoseConnectionUsage=false, logMissingTransactionContext=true, 
description='my JMS Connection Factory at scope',
manageCachedHandles=true, providerType=myJMSProviderType, type=TOPIC, 
xaRecoveryAuthAlias=myCellManager01/a1")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createGenericJMSConnectionFactoryAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My Generic JMSConnection Factory", "JNDIName", "extJNDIName", [['XAEnabled', 'false'], 
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['connectionPool', [['agedTimeout', '100'], 
['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'], 
['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], 
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties', 
[[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'], 
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], 
['description', 'My description'], ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping', 
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], 
['retryLimit', '4']]], ['properties', [[['description', 'My description'], ['name', 'myName'], 
['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', 
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], 
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], 
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], 
[['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myJMSProviderType'], ['sessionPool', [['agedTimeout', '100'], 
['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'], 
['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], 
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'], 
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], 
['type', 'TOPIC'], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

createGenericJMSConnectionFactoryUsingTemplateAtScope

Este script utiliza una plantilla para crear una fábrica de conexiones JMS genérica en la configuración en el ámbito que especifique. El script devuelve el ID de configuración de la fábrica de conexiones JMS creada mediante una plantilla en la célula respectiva.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de JMS, ID de plantilla, nombre de fábrica de conexiones, nombre JNDI y nombre JNDI externo. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 11. Argumentos del script createGenericJMSConnectionFactoryUsingTemplateAtScope. Ejecute el script para crear una fábrica de conexiones JMS genérica.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
jmsProvider Especifica el nombre del proveedor de JMS.
templateID Especifica el ID de configuración de la plantilla que se va a utilizar.
connFactoryName Especifica el nombre que se va a asignar a la nueva fábrica de conexiones.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
extJndiName Especifica el nombre JNDI utilizado para enlazar la cola con el espacio de nombres del servidor de aplicaciones. Como convención, utilice el nombre JNDI plenamente cualificado; por ejemplo, con el formato jms/Nombre, donde Nombre es el nombre lógico del recurso. Este nombre se utiliza para enlazar la información de enlace de la plataforma. El enlace asocia los recursos definidos en el descriptor de despliegue del módulo con los recursos reales (físicos) enlazados con JNDI por la plataforma.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 12. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
XAEnabled Especifica si se ha habilitado el proceso de recuperación XA.
['XAEnabled', 'false']
authDataAlias Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Especifica el mecanismo de autenticación. Los valores válidos son BASIC_PASSWORD para autenticación básica y KERBEROS para autenticación Kerberos.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['authMechanismPreference', 
'BASIC_PASSWORD']
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
connectionPool Especifica las propiedades de agrupación de conexiones JMS de la instancia de fábrica de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
diagnoseConnectionUsage Especifica si se ha habilitado el diagnóstico de uso de la conexión.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
['logMissingTransactionContext', 'true']
manageCachedHandles Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es true.
['manageCachedHandles', 'true']
mapping Especifica la correlación del inicio de sesión de configuración con un nombre de alias de autenticación especificado.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Especifica los valores de configuración de conexión de preprueba.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties Especifica un tipo de propiedad definida o un tipo de propiedad descriptiva.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["properties",[["description","Mi descripción"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
sessionPool Especifica las propiedades de agrupación de sesiones JMS de la instancia de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
['xaRecoveryAuthAlias', 'myCellManager01/a1']
Tabla 13. Atributos opcionales (continuación). Atributo adicional disponible para el script.
Atributos Descripción Ejemplo
type Especifica QUEUE para colas, TOPIC para temas y UNIFIED para colas y temas.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['type', 'TOPIC']

Sintaxis

AdminJMS.createGenericJMSConnectionFactoryUsingTemplateAtScope(scope, 
  jmsProvider, templateID, 
 connFactoryName, jndiName, extJndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createGenericJMSConnectionFactoryUsingTemplateAtScope("myScope", 
 "JMSTest", "Generic QueueConnectionFactory for 
 Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)", 
"JMSCFTest", "jmsjndi", "extjmsjndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createGenericJMSConnectionFactoryUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", 
"Generic QueueConnectionFactory for Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)", 
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName", "XAEnabled=false, 
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory, 
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true, 
description='my JMS Connection Factory using a template and scope',
providerType=myJMSProviderType, type=TOPIC, xaRecoveryAuthAlias=myCellManager01/a1")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createGenericJMSConnectionFactoryUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", 
"Generic QueueConnectionFactory for Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)", 
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName", 
[['XAEnabled', 'false'], ['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], 
['surgeCreationInterval', '10'], ['surgeThreshold', '10'], ['testConnection', 'true'], 
['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], ['description', 'My description'], 
['diagnoseConnectionUsage', 'false'], ['logMissingTransactionContext', 'true'], 
['manageCachedHandles', 'true'], ['mapping', [['authDataAlias', 'authDataAliasValue'], 
['mappingConfigAlias', 'mappingConfigAliasValue']]], ['preTestConfig', [['preTestConnection', 'true'], 
['retryInterval', '12343'], ['retryLimit', '4']]], ['properties', [[['description', 'My description'], 
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], 
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], 
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myJMSProviderType'], 
['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], 
['maxConnections', '12'], ['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], 
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties', 
[[['description', 'My description'], ['name', 'myName'], ['required', 'false'], ['validationExpression', ''], 
['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], 
['surgeCreationInterval', '10'], ['surgeThreshold', '10'], ['testConnection', 'true'], 
['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], ['type', 'TOPIC'], 
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

createGenericJMSDestination

Este script crea un destino de JMS genérico en la configuración. El script devuelve el ID de configuración del destino de JMS creado en la célula respectiva.

Para ejecutar el script, especifique los argumentos de nombre de nodo, nombre de servidor, nombre de proveedor de JMS, nombre de destino de JMS, nombre JNDI y nombre JNDI externo. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 14. Argumentos del script createGenericJMSDestination. Ejecute el script para crear un destino de JMS genérico.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jmsProvider Especifica el nombre del proveedor de JMS.
genericJMSDestination Especifica el nombre que se va a asignar al nuevo destino de JMS genérico.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
extJndiName Especifica el nombre JNDI utilizado para enlazar la cola con el espacio de nombres del servidor de aplicaciones. Como convención, utilice el nombre JNDI plenamente cualificado; por ejemplo, con el formato jms/Nombre, donde Nombre es el nombre lógico del recurso. Este nombre se utiliza para enlazar la información de enlace de la plataforma. El enlace asocia los recursos definidos en el descriptor de despliegue del módulo con los recursos reales (físicos) enlazados con JNDI por la plataforma.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 15. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] [[name driverType]
[type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myProviderType']
type Especifica QUEUE para colas, TOPIC para temas y UNIFIED para colas y temas.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['type', 'QUEUE']

Sintaxis

AdminJMS.createGenericJMSDestination(nodeName, 
 serverName, jmsProvider, genericJMSDestination, 
 jndiName, extJndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createGenericJMSDestination("myNode", "myServer", "JMSTest", 
 "JMSDest", "destjndi", "extDestJndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createGenericJMSDestination("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"My JMSDestination", "JNDIName", "extJNDIName", "category=myCategory, description='My description', 
providerType=myProviderType, type=QUEUE")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createGenericJMSDestination("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"My JMSDestination", "JNDIName", "extJNDIName", [['category', 'myCategory'], ['description', 
'My description'], ['propertySet', [['resourceProperties', [[['name', 'databaseName'], 
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['type', 'QUEUE']] )

createGenericJMSDestinationUsingTemplate

Este script utiliza una plantilla para crear un destino de JMS genérico en la configuración. El script devuelve el ID de configuración del destino de JMS creado en la célula respectiva.

Para ejecutar el script, especifique los argumentos de nombre de nodo, nombre de servidor, nombre de proveedor de JMS, ID de plantilla, nombre de destino de JMS genérico, nombre JNDI y nombre JNDI externo. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:

Tabla 16. Argumentos del script createGenericJMSDestinationUsingTemplate. Ejecute el script para crear un destino de JMS genérico.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jmsProvider Especifica el nombre del proveedor de JMS.
templateID Especifica el ID de configuración de la plantilla que se va a utilizar.
genericJMSDestination Especifica el nombre que se va a asignar al nuevo destino de JMS genérico.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
extJndiName Especifica el nombre JNDI utilizado para enlazar la cola con el espacio de nombres del servidor de aplicaciones. Como convención, utilice el nombre JNDI plenamente cualificado; por ejemplo, con el formato jms/Nombre, donde Nombre es el nombre lógico del recurso. Este nombre se utiliza para enlazar la información de enlace de la plataforma. El enlace asocia los recursos definidos en el descriptor de despliegue del módulo con los recursos reales (físicos) enlazados con JNDI por la plataforma.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 17. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] [[name driverType]
[type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myProviderType']
type Especifica QUEUE para colas, TOPIC para temas y UNIFIED para colas y temas.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['type', 'QUEUE']

Sintaxis

AdminJMS.createGenericJMSDestinationUsingTemplate(nodeName, 
 serverName, jmsProvider, templateID, 
 genericJMSDestination, jndiName, extJndiName, 
 attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createGenericJMSDestinationUsingTemplate("myNode",
"myServer", 
 "JMSTest", 
 "Example.JMS.Generic.Win.Topic(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_2)", 
 "JMSDest", "destjndi", "extDestJndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createGenericJMSDestinationUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Example.JMS.Generic.Win.Queue(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_1)", 
"My JMSDestination", "JNDIName", "extJNDIName","category=myCategory, description='My description', 
providerType=myProviderType, type=QUEUE ")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createGenericJMSDestinationUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Example.JMS.Generic.Win.Queue(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_1)", 
"My JMSDestination", "JNDIName", "extJNDIName", [['category', 'myCategory'], 
['description', 'My description'], ['propertySet', [['resourceProperties', [[['name', 'databaseName'], 
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value','localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['type', 'QUEUE']] )

createGenericJMSDestinationAtScope

Este script crea un destino de JMS genérico en la configuración en el ámbito que especifique. El script devuelve el ID de configuración del destino de JMS creado en la célula respectiva.

Para ejecutar el script, especifique los argumentos de nombre de ámbito, nombre de proveedor de JMS, nombre de destino de JMS, nombre JNDI y nombre JNDI externo. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 18. Argumentos del script createGenericJMSDestinationAtScope. Ejecute el script para crear un destino de JMS genérico.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
serverName Especifica el nombre del servidor de interés.
jmsProvider Especifica el nombre del proveedor de JMS.
genericJMSDestination Especifica el nombre que se va a asignar al nuevo destino de JMS genérico.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
extJndiName Especifica el nombre JNDI utilizado para enlazar la cola con el espacio de nombres del servidor de aplicaciones. Como convención, utilice el nombre JNDI plenamente cualificado; por ejemplo, con el formato jms/Nombre, donde Nombre es el nombre lógico del recurso. Este nombre se utiliza para enlazar la información de enlace de la plataforma. El enlace asocia los recursos definidos en el descriptor de despliegue del módulo con los recursos reales (físicos) enlazados con JNDI por la plataforma.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 19. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] [[name driverType]
[type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myProviderType']
type Especifica QUEUE para colas, TOPIC para temas y UNIFIED para colas y temas.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['type', 'QUEUE']

Sintaxis

AdminJMS.createGenericJMSDestinationAtScope(scope, 
 jmsProvider, genericJMSDestination, 
 jndiName, extJndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createGenericJMSDestinationAtScope("myScope", "JMSTest", 
 "JMSDest", "destjndi", "extDestJndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createGenericJMSDestinationAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My JMSDestination", "JNDIName", "extJNDIName", "category=myCategory, 
description='My description', providerType=myProviderType, type=QUEUE")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createGenericJMSDestinationAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My JMSDestination", "JNDIName", "extJNDIName", [['category', 'myCategory'], 
['description', 'My description'], ['propertySet', [['resourceProperties', [[['name', 'databaseName'], 
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], 
['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value',50000]]]]]], ['providerType', 'myProviderType'], ['type', 'QUEUE']] )

createGenericJMSDestinationUsingTemplateAtScope

Este script utiliza una plantilla para crear un destino de JMS genérico en la configuración en el ámbito que especifique. El script devuelve el ID de configuración del destino de JMS creado en la célula respectiva.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de JMS, ID de plantilla, nombre de destino de JMS genérico, nombre JNDI y nombre JNDI externo. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:

Tabla 20. Argumentos del script createGenericJMSDestinationUsingTemplateAtScope. Ejecute el script para crear un destino de JMS genérico.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
serverName Especifica el nombre del servidor de interés.
jmsProvider Especifica el nombre del proveedor de JMS.
templateID Especifica el ID de configuración de la plantilla que se va a utilizar.
genericJMSDestination Especifica el nombre que se va a asignar al nuevo destino de JMS genérico.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
extJndiName Especifica el nombre JNDI utilizado para enlazar la cola con el espacio de nombres del servidor de aplicaciones. Como convención, utilice el nombre JNDI plenamente cualificado; por ejemplo, con el formato jms/Nombre, donde Nombre es el nombre lógico del recurso. Este nombre se utiliza para enlazar la información de enlace de la plataforma. El enlace asocia los recursos definidos en el descriptor de despliegue del módulo con los recursos reales (físicos) enlazados con JNDI por la plataforma.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 21. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] [[name driverType]
[type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myProviderType']
type Especifica QUEUE para colas, TOPIC para temas y UNIFIED para colas y temas.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['type', 'QUEUE']

Sintaxis

AdminJMS.createGenericJMSDestinationUsingTemplateAtScope(scope, 
 jmsProvider, templateID, 
 genericJMSDestination, jndiName, extJndiName, 
 attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createGenericJMSDestinationUsingTemplateAtScope("myScope", 
 "JMSTest", 
 "Example.JMS.Generic.Win.Topic(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_2)", 
 "JMSDest", "destjndi", "extDestJndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createGenericJMSDestinationUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "Example.JMS.Generic.Win.Queue(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_1)", 
"My JMSDestination", "JNDIName", "extJNDIName", "category=myCategory, 
description='My description', providerType=myProviderType, type=QUEUE")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createGenericJMSDestinationUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "Example.JMS.Generic.Win.Queue(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_1)", 
"My JMSDestination", "JNDIName", "extJNDIName", [['category', 'myCategory'], ['description', 'My description'], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], 
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['type', 'QUEUE']] )

createJMSProvider

Este script crea un proveedor de JMS en la configuración. El script devuelve el ID de configuración del proveedor de JMS creado en la célula respectiva.

Para ejecutar el script, especifique los argumentos de nodo, servidor, nombre de proveedor JMS, nombre de fábrica contextual inicial externa y URL de proveedor externo. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:

Tabla 22. Argumentos del script createJMSProvider. Ejecute el script para crear un proveedor de JMS.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jmsProvider Especifica el nombre que se va a asignar al nuevo proveedor de JMS.
extContextFactory Especifica el nombre de clase Java de la fábrica de contexto inicial del proveedor de JMS.
extProviderURL Especifica el URL de proveedor de JMS para búsquedas de JNDI externas.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 23. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
classpath Especifica una lista de vías de acceso o nombres de archivos JAR (Java Archive) que forman conjuntamente la ubicación de las clases de proveedores de recursos. Utilice un punto y coma (;) para separar las vías de acceso de clases.
'-classpath', 
'${EXTERNAL_JMSPROVIDER_CLASSPATH}/extJms.jar'
description Especifica una descripción del proveedor de JMS.
['description', 'My description']
isolatedClassLoader Si se establece en true, especifica que el proveedor de recursos se ha cargado en su propio cargador de clases.
Atención: No se puede aislar un proveedor cuando se especifica una vía de acceso de biblioteca nativa.
['isolatedClassLoader', 'true']
nativepath Especifica una vía de acceso opcional a cualquier biblioteca nativa, como por ejemplo *.dll y *.so. Las entradas de las vías de acceso nativas están separadas por un punto y coma (;).
'-nativePath', 
'${EXTERNAL_JMSPROVIDER_NATIVEPATH}'
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] 
]]]]
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
supportsASF Si se establece en true, especifica que el proveedor de JMS admite Application Server Facilities (ASF), que proporciona soporte transaccional y de simultaneidad para las aplicaciones.
['supportsASF', 'true']

Sintaxis

AdminJMS.createJMSProvider(nodeName, serverName, 
 jmsProvider, extContextFactory, extProviderURL, 
 attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createJMSProvider("myNode",
"myServer", "JMSTest1", 
 "extInitCF", "extPURL")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createJMSProvider("IBM-F4A849C57A0Node01", "server1", "MyJMSProvider", "extInitCF", "extPURL", 
"classpath='${DB2_JCC_DRIVER_PATH}/db2jcc4.jar; ${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar', 
description='My JMSProvider description',isolatedClassLoader=true, 
nativepath=${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}, providerType=myJMSProviderType, supportsASF=true")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createJMSProvider("IBM-F4A849C57A0Node01", "server1", "MyJMSProvider", "extInitCF", "extPURL", 
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar; ${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], ['description', 'My JMSProvider description'], 
['isolatedClassLoader', 'true'], ['nativepath', '${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}'], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], 
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], 
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myJMSProviderType'], 
['supportsASF', 'true']] )

createJMSProviderUsingTemplate

Este script utiliza una plantilla para crear un proveedor de JMS en la configuración. El script devuelve el ID de configuración del proveedor de JMS creado mediante una plantilla en la célula respectiva.

Para ejecutar el script, especifique los argumentos de nodo, servidor, ID de configuración del proveedor de JMS, plantilla, nombre que se va a asignar al proveedor de JMS nuevo, fábrica externa de contexto inicial y el URL del proveedor externo. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:

Tabla 24. Argumentos del script createJMSProviderUsingTemplate. Ejecute el script para crear un proveedor de JMS.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
templateID Especifica el ID de configuración de la plantilla del proveedor de JMS que se va a utilizar.
jmsProvider Especifica el nombre que se va a asignar al nuevo proveedor de JMS.
extContextFactory Especifica el nombre de clase Java de la fábrica de contexto inicial del proveedor de JMS.
extProviderURL Especifica el URL de proveedor de JMS para búsquedas de JNDI externas.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 25. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
classpath Especifica una lista de vías de acceso o nombres de archivos JAR (Java Archive) que forman conjuntamente la ubicación de las clases de proveedores de recursos. Utilice un punto y coma (;) para separar las vías de acceso de clases.
'-classpath', 
'${EXTERNAL_JMSPROVIDER_CLASSPATH}/extJms.jar'
description Especifica una descripción del proveedor de JMS.
['description', 'My description']
isolatedClassLoader Si se establece en true, especifica que el proveedor de recursos se ha cargado en su propio cargador de clases.
Atención: No se puede aislar un proveedor cuando se especifica una vía de acceso de biblioteca nativa.
['isolatedClassLoader', 'true']
nativepath Especifica una vía de acceso opcional a cualquier biblioteca nativa, como por ejemplo *.dll y *.so. Las entradas de las vías de acceso nativas están separadas por un punto y coma (;).
'-nativePath', 
'${EXTERNAL_JMSPROVIDER_NATIVEPATH}'
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] 
]]]]
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
supportsASF Si se establece en true, especifica que el proveedor de JMS admite Application Server Facilities (ASF), que proporciona soporte transaccional y de simultaneidad para las aplicaciones.
['supportsASF', 'true']

Sintaxis

AdminJMS.createJMSProviderUsingTemplate(nodeName, 
 serverName, templateID, jmsProvider, 
 extContextFactory, extProviderURL, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createJMSProviderUsingTemplate("myNode", "myServer", "WebSphere JMS 
 Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#builtin_jmsprovider)", 
 "JMSTest", "extInitCF", "extPURL")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createJMSProviderUsingTemplate("IBM-F4A849C57A0Node01", "server1", 
"WebSphere JMSProvider(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jmsprovider)", 
"MyJMSProvider", "extInitCF", "extPURL", 
"classpath='${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar', description='My JMSProvider description', 
isolatedClassLoader=true, nativepath=${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}, 
providerType=myJMSProviderType,supportsASF=true")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminJMS.createJMSProviderUsingTemplate("IBM-F4A849C57A0Node01", "server1", 
"WebSphere JMSProvider(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jmsprovider)", 
"MyJMSProvider", "extInitCF", "extPURL", 
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar; ${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'],
['description', 'My JMSProvider description'], ['isolatedClassLoader', 'true'], 
['nativepath', '${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}'], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], 
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], 
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], 
[['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myJMSProviderType'], ['supportsASF', 'true']])

createJMSProviderAtScope

Este script crea un proveedor de JMS en la configuración en el ámbito que especifique. El script devuelve el ID de configuración del proveedor de JMS creado en la célula respectiva.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de JMS, nombre de fábrica contextual inicial externa y URL de proveedor externo. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:

Tabla 26. Argumentos del script createJMSProviderAtScope. Ejecute el script para crear un proveedor de JMS.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
jmsProvider Especifica el nombre que se va a asignar al nuevo proveedor de JMS.
extContextFactory Especifica el nombre de clase Java de la fábrica de contexto inicial del proveedor de JMS.
extProviderURL Especifica el URL de proveedor de JMS para búsquedas de JNDI externas.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 27. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
classpath Especifica una lista de vías de acceso o nombres de archivos JAR (Java Archive) que forman conjuntamente la ubicación de las clases de proveedores de recursos. Utilice un punto y coma (;) para separar las vías de acceso de clases.
'-classpath', 
'${EXTERNAL_JMSPROVIDER_CLASSPATH}/extJms.jar'
description Especifica una descripción del proveedor de JMS.
['description', 'My description']
isolatedClassLoader Si se establece en true, especifica que el proveedor de recursos se ha cargado en su propio cargador de clases.
Atención: No se puede aislar un proveedor cuando se especifica una vía de acceso de biblioteca nativa.
['isolatedClassLoader', 'true']
nativepath Especifica una vía de acceso opcional a cualquier biblioteca nativa, como por ejemplo *.dll y *.so. Las entradas de las vías de acceso nativas están separadas por un punto y coma (;).
'-nativePath', 
'${EXTERNAL_JMSPROVIDER_NATIVEPATH}'
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] 
]]]]
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
supportsASF Si se establece en true, especifica que el proveedor de JMS admite Application Server Facilities (ASF), que proporciona soporte transaccional y de simultaneidad para las aplicaciones.
['supportsASF', 'true']

Sintaxis

AdminJMS.createJMSProviderAtScope(scope, 
 jmsProvider, extContextFactory, extProviderURL, 
 attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createJMSProvider("myScope",
"JMSTest1", 
 "extInitCF", "extPURL")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS. createJMSProviderAtScope ("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"MyJMSProvider", "extInitCF", "extPURL", 
"classpath='${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar', description='My JMSProvider description', 
isolatedClassLoader=true, nativepath=${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}, 
providerType=myJMSProviderType,supportsASF=true")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createJMSProviderAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"MyJMSProvider", "extInitCF", "extPURL", [['classpath', 
'${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], ['description', 'My JMSProvider description'], 
['isolatedClassLoader', 'true'], ['nativepath', '${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}'], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], 
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], 
['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myJMSProviderType'], 
['supportsASF', 'true']] )

createJMSProviderUsingTemplateAtScope

Este script utiliza una plantilla para crear un proveedor de JMS en el ámbito que especifique. El script devuelve el ID de configuración del proveedor de JMS creado mediante una plantilla en la célula respectiva.

Para ejecutar el script, especifique los argumentos de ámbito, ID de configuración del proveedor de JMS, plantilla, nombre que se va a asignar al proveedor de JMS nuevo, fábrica externa de contexto inicial y el URL del proveedor externo. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:

Tabla 28. Argumentos del script createJMSProviderUsingTemplateAtScope. Ejecute el script para crear un proveedor de JMS.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
templateID Especifica el ID de configuración de la plantilla del proveedor de JMS que se va a utilizar.
jmsProvider Especifica el nombre que se va a asignar al nuevo proveedor de JMS.
extContextFactory Especifica el nombre de clase Java de la fábrica de contexto inicial del proveedor de JMS.
extProviderURL Especifica el URL de proveedor de JMS para búsquedas de JNDI externas.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 29. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
classpath Especifica una lista de vías de acceso o nombres de archivos JAR (Java Archive) que forman conjuntamente la ubicación de las clases de proveedores de recursos. Utilice un punto y coma (;) para separar las vías de acceso de clases.
'-classpath', 
'${EXTERNAL_JMSPROVIDER_CLASSPATH}/extJms.jar'
description Especifica una descripción del proveedor de JMS.
['description', 'My description']
isolatedClassLoader Si se establece en true, especifica que el proveedor de recursos se ha cargado en su propio cargador de clases.
Atención: No se puede aislar un proveedor cuando se especifica una vía de acceso de biblioteca nativa.
['isolatedClassLoader', 'true']
nativepath Especifica una vía de acceso opcional a cualquier biblioteca nativa, como por ejemplo *.dll y *.so. Las entradas de las vías de acceso nativas están separadas por un punto y coma (;).
'-nativePath', 
'${EXTERNAL_JMSPROVIDER_NATIVEPATH}'
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] 
]]]]
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
supportsASF Si se establece en true, especifica que el proveedor de JMS admite Application Server Facilities (ASF), que proporciona soporte transaccional y de simultaneidad para las aplicaciones.
['supportsASF', 'true']

Sintaxis

AdminJMS.createJMSProviderUsingTemplateAtScope(scope, 
 templateID, jmsProvider, 
 extContextFactory, extProviderURL, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createJMSProviderUsingTemplateAtScope("myScope", "WebSphere JMS 
 Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#builtin_jmsprovider)", 
 "JMSTest", "extInitCF", "extPURL")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS. createJMSProviderUsingTemplateAtScope("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"WebSphere JMSProvider(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jmsprovider)", 
"MyJMSProvider", "extInitCF", "extPURL", 
"classpath='${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar', description='My JMSProvider description', 
isolatedClassLoader=true, nativepath=${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}, 
providerType=myJMSProviderType,supportsASF=true")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminJMS.createJMSProviderUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01, Node=IBM-F4A849C57A0Node01", 
"WebSphere JMS Provider(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jmsprovider)", 
"MyJMSProvider", "extInitCF", "extPURL", 
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar; ${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], ['description', 'My JMSProvider description'], 
['isolatedClassLoader', 'true'], ['nativepath', '${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}'], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], 
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], 
['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value',50000]]]]]], ['providerType', 'myJMSProviderType'], 
['supportsASF', 'true']] )

createWASQueue

Este script crea una cola de WebSphere Application Server en la configuración. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMSServer incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración de la cola de WebSphere Application Server creada en la célula respectiva.

Para ejecutar el script, especifique los parámetros de nombre de nodo, servidor, nombre de proveedor de JMS, nombre que se va a asignar a la cola y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:

Tabla 30. Argumentos del script createWASQueue. Ejecute el script para crear una cola.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jmsProvider Especifica el nombre del proveedor de JMS de interés.
queueName Especifica el nombre para asignar a la cola nueva.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 31. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
expiry Especifica el período de tiempo después del cual caducarán los mensajes enviados a este destino y se tratarán en función de sus opciones de disposición. Los valores válidos son APPLICATION_DEFINE, SPECIFIED y UNLIMITED.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['expiry', 'SPECIFIED']
persistence Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y SPECIFIED.
['priority', 'SPECIFIED']
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores específica. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myProviderType']
specifiedExpiry Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan.
['specifiedExpiry', '1000']
specifiedPriority Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere.
['specifiedPriority', '0']

Sintaxis

AdminJMS.createWASQueue(nodeName, serverName, 
 jmsProvider, queueName, jndiName, 
 attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASQueue("myNode",
"myServer", "JMSTest", 
 "WASQueueTest", "queuejndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASQueue("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)", 
"My WASQueue Name", "JNDIName", "category =myCategory, description='My description', 
expiry=SPECIFIED, persistence=NONPERSISTENT, priority=SPECIFIED, specifiedExpiry=1000, 
specifiedPriority=0")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWASQueue("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", "My WASQueue Name", 
"JNDIName", [['category ', 'myCategory'], ['description', 'My description'], ['expiry', 'SPECIFIED'], 
['persistence', 'NONPERSISTENT'], ['priority', 'SPECIFIED'], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

createWASQueueUsingTemplate

Este script utiliza una plantilla para crear una cola de WebSphere Application Server en la configuración. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMSServer incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración de la cola de WebSphere Application Server mediante una plantilla en la célula respectiva.

Para ejecutar el script, especifique los argumentos de nombre de nodo, nombre de servidor, nombre de proveedor de JMS, ID de configuración de la plantilla, nombre que se va a asignar a la cola y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 32. Argumentos del script createWASQueueUsingTemplate. Ejecute el script para crear una cola.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jmsProvider Especifica el nombre del proveedor de JMS de interés.
templateID Especifica el ID de configuración de la plantilla de la cola de WebSphere Application Server que se va a utilizar.
queueName Especifica el nombre para asignar a la cola nueva.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 33. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
expiry Especifica el período de tiempo después del cual caducarán los mensajes enviados a este destino y se tratarán en función de sus opciones de disposición. Los valores válidos son APPLICATION_DEFINE, SPECIFIED y UNLIMITED.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['expiry', 'SPECIFIED']
persistence Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y SPECIFIED.
['priority', 'SPECIFIED']
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores específica. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myProviderType']
specifiedExpiry Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan.
['specifiedExpiry', '1000']
specifiedPriority Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere.
['specifiedPriority', '0']

Sintaxis

AdminJMS.createWASQueueUsingTemplate(nodeName, 
 serverName, jmsProvider, templateID, queueName, 
 jndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASQueueUsingTemplate("myNode", "myServer", "JMSTest", 
 "WASQueueTest", "queuejndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASQueueUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)", "My WASQueue Name", 
"JNDIName", “category =myCategory, description='My description', expiry=SPECIFIED, 
providerType=myProviderType, specifiedExpiry=1000, specifiedPriority=0”)

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

Usage: AdminJMS.createWASQueueUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)", "My WASQueue Name", 
"JNDIName", [['category ', 'myCategory'], ['description', 'My description'], ['expiry', 'SPECIFIED'], 
['persistence', 'NONPERSISTENT'], ['priority', 'SPECIFIED'], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

createWASQueueAtScope

Este script crea una cola de WebSphere Application Server en la configuración en el ámbito que especifique. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMSServer incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración de la cola de WebSphere Application Server creada en la célula respectiva.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de JMS, nombre que se va a asignar a la cola y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:

Tabla 34. Argumentos del script createWASQueueAtScope. Ejecute el script para crear una cola.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
jmsProvider Especifica el nombre del proveedor de JMS de interés.
queueName Especifica el nombre para asignar a la cola nueva.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 35. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
expiry Especifica el período de tiempo después del cual caducarán los mensajes enviados a este destino y se tratarán en función de sus opciones de disposición. Los valores válidos son APPLICATION_DEFINE, SPECIFIED y UNLIMITED.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['expiry', 'SPECIFIED']
persistence Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y SPECIFIED.
['priority', 'SPECIFIED']
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores específica. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myProviderType']
specifiedExpiry Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan.
['specifiedExpiry', '1000']
specifiedPriority Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere.
['specifiedPriority', '0']

Sintaxis

AdminJMS.createWASQueueAtScope(scope, 
 jmsProvider, queueName, jndiName, 
 attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASQueueAtScope("scope",
"JMSTest", 
 "WASQueueTest", "queuejndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASQueueAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", “category =myCategory, description='My description', 
expiry=SPECIFIED, providerType=myProviderType, specifiedExpiry=1000, specifiedPriority=0”)

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWASQueueAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", [['category ', 'myCategory'], ['description', 'My description'], 
['expiry', 'SPECIFIED'], ['persistence', 'NONPERSISTENT'], ['priority', 'SPECIFIED'], ['propertySet', 
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], 
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], [
'providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

createWASQueueUsingTemplateAtScope

Este script utiliza una plantilla para crear una cola de WebSphere Application Server en la configuración en el ámbito que especifique. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMSServer incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración de la cola de WebSphere Application Server mediante una plantilla en la célula respectiva.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de JMS, ID de configuración de la plantilla, nombre que se va a asignar a la cola y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 36. Argumentos del script createWASQueueUsingTemplateAtScope. Ejecute el script para crear una cola.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
jmsProvider Especifica el nombre del proveedor de JMS de interés.
templateID Especifica el ID de configuración de la plantilla de la cola de WebSphere Application Server que se va a utilizar.
queueName Especifica el nombre para asignar a la cola nueva.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 37. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
expiry Especifica el período de tiempo después del cual caducarán los mensajes enviados a este destino y se tratarán en función de sus opciones de disposición. Los valores válidos son APPLICATION_DEFINE, SPECIFIED y UNLIMITED.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['expiry', 'SPECIFIED']
persistence Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y SPECIFIED.
['priority', 'SPECIFIED']
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores específica. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myProviderType']
specifiedExpiry Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan.
['specifiedExpiry', '1000']
specifiedPriority Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere.
['specifiedPriority', '0']

Sintaxis

AdminJMS.createWASQueueUsingTemplateAtScope(scope, 
 jmsProvider, templateID, queueName, 
 jndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASQueueUsingTemplateAtScope("myScope", "JMSTest", 
 "WASQueueTest", "queuejndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASQueueUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)", 
"My WASQueue Name", "JNDIName", "category =myCategory, description='My description', expiry=SPECIFIED, 
providerType=myProviderType, specifiedExpiry=1000, specifiedPriority=0")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWASQueueUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)", 
"My WASQueue Name", "JNDIName", [['category ', 'myCategory'], ['description', 'My description'], ['expiry', 'SPECIFIED'], 
['persistence', 'NONPERSISTENT'], ['priority', 'SPECIFIED'], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

createSIBJMSQueue

Este script crea una cola JMS en la configuración en el ámbito que especifique. El script devuelve el ID de configuración de la cola JMS de SIB creada.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de la cola JMS, nombre que se va a asignar a la cola y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 38. Argumentos para el script createSIBJMSQueue. Ejecute el script para crear una cola JMS.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
nombre Especifica el nombre de la cola JMS de interés.
queueName Especifica el nombre del destino del bus de integración de servicios con el que se correlaciona la cola JMS.
jndiName Especifica el nombre JNDI que utiliza el sistema para enlazar la cola con el espacio de nombres del servidor de aplicaciones.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 39. Atributos opcionales. Atributos adicionales para el script.
Atributos Descripción
description Especifica una descripción de la cola JMS de SIB.
DeliveryMode Especifica la modalidad de entrega para mensajes. Los valores válidos son Application, NonPersistent y Persistent.
timeToLive Especifica el tiempo en milisegundos antes de que caduque un mensaje.
priority Especifica la prioridad de mensajes. Los valores válidos son enteros entre 0 y 9, inclusive.
readAhead Especifica el valor de lectura anticipada. Los valores válidos son Default, AlwaysOn y AlwaysOff.
NombreBus Especifica el nombre del bus en el que reside la cola.
ScopeToLocalQP Especifica si el destino de cola SIB es un punto de cola local cuando se direcciona utilizando esta cola JMS.
ProducerBind Especifica cómo se enlazan los generadores JMS a los puntos de cola de la cola en clúster. Un valor de TRUE indica que se ha de elegir un punto de cola cuando la sesión está abierta y no cambia nunca. Un valor FALSE indica que se selecciona un punto de cola cada vez que se envía un mensaje.
ProducerPreferLocal Especifica si se utilizan los puntos de cola local para el productor.
GatherMessages Especifica si se proporciona a los consumidores JMS y navegadores mensajes de cualquier punto de cola, en lugar desde el punto de cola individual al que están conectados.

Sintaxis

AdminJMS.createSIBJMSQueue(scope, 
 name, queueName, 
 jndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createSIBJMSQueue("myScope", "myName", 
 "SIBJMSQueueTest", "queuejndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createSIBJMSQueue
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName7", "myQueueName7", "readAhead=AlwaysOff,timeToLive=9")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createSIBJMSQueue
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName7", "myQueueName7", [['readAhead', 'AlwaysOff'], ['timeToLive', '9']])

createWMQQueue

Este script crea destinos de tipo de cola para el proveedor de mensajería de IBM MQ en el ámbito que especifique. El script devuelve el ID de configuración de la cola de IBM MQ creada.

Para ejecutar el script, especifique el ámbito, el nombre del destino de tipo de cola, el nombre que se ha de asignar a la cola y los argumentos del nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 40. Argumentos para el script WMQQueue. Ejecute el script para crear un destino de tipo de cola.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de mensajería de IBM MQ.
nombre Especifica el nombre del destino de tipo de cola de proveedor de mensajería de IBM MQ.
queueName Especifica el nombre de la cola de IBM MQ para almacenar mensajes para la definición de destino de tipo de cola del proveedor de mensajería de IBM MQ.
jndiName Especifica el nombre utilizado para enlazar este objeto en la JNDI de WebSphere Application Server.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 41. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción
ccsid Especifica el identificador del conjunto de caracteres codificado.
decimalEncoding Especifica el valor de codificación decimal para esta cola. Los valores válidos son Normal y Reversed.
description Especifica una descripción administrativa que se asocia con este tipo de destino de cola JMS de IBM MQ.
expiry Especifica el período de tiempo después del cual los mensajes enviados a este destino caducarán y se manejarán en función de sus opciones de disposición. Los valores válidos son APP, UNLIM o cualquier entero positivo.
floatingPointEncoding Especifica el valor de codificación de coma flotante para esta cola. Los valores válidos son IEEENormal, IEEEReversed y z/OS.
integerEncoding Especifica el valor de codificación de enteros para esta cola. Los valores válidos son Normal y Reversed.
persistence Especifica el nivel de persistencia que se utiliza para almacenar los mensajes enviados a este destino. Los valores válidos son APP, QDEF, PERS, NON o HIGH.
priority Especifica el nivel de prioridad que se asigna a los mensajes enviados a este destino. Los valores válidos son APP, QDEF, 0, 1, 2, 3, 4, 5, 6, 7, 8, ó 9.
qmgr Especifica el gestor de colas en el que reside la cola de IBM MQ.
readAheadClose Especifica el comportamiento que se produce al cerrar un consumidor de mensajes que recibe mensajes asíncronamente. El consumidor de mensajes utiliza un escucha de mensajes de un destino que tiene establecido el parámetro readAhead en true. Cuando se especifica un valor DELIVERALL, la invocación del método close espera a que se entreguen al consumidor todos los mensajes de lectura anticipada antes de cerrarlo. Cuando se especifica un valor DELIVERCURRENT, el método close() sólo espera a que finalice cualquier entrega que esté en proceso antes de cerrar el consumidor. Los valores válidos son DELIVERALL y DELIVERCURRENT.
readAhead Especifica si los mensajes para los consumidores no persistentes se pueden leer de forma anticipada y guardar en la memoria caché. Los valores válidos son YES, NO o QDEF.
sendAsync Especifica si los mensajes se pueden enviar a este destino sin necesidad de que el gestor de colas reconozca que han llegado. Los valores válidos son YES, NO o QDEF.
useRFH2 Especifica si se añade una cabecera RFH versión 2 a los mensajes enviados a este destino. Los valores válidos son true o false.
useNativeEncoding Especifica los valores de codificación nativa para esta cola.

Sintaxis

AdminJMS.createWMQQueue(scope, 
 name, queueName, 
 jndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWMQQueue("myScope", "myName", 
 "WMQQueueTest", "queuejndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWMQQueue
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName8", "myQueueName8", "readAhead=YES,description=myDescription")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWMQQueue
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName8", "myQueueName8", [['readAhead', 'YES'], ['description', 'myDescription']])

createWASQueueConnectionFactory

Este script crea una fábrica de conexiones de cola de WebSphere Application Server en la configuración. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMSServer incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración de la fábrica de conexiones de cola de WebSphere Application Server creada en la célula respectiva.

Para ejecutar el script, especifique los argumentos de nombre de nodo, nombre de servidor, nombre de proveedor de JMS, nombre que se va a asignar a la fábrica de conexiones de la cola y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:

Tabla 42. Argumentos del script createWASQueueConnectionFactory. Ejecute el script para crear una fábrica de conexiones de cola.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jmsProvider Especifica el nombre del proveedor de JMS de interés.
queueConnFactoryName Especifica el nombre que se debe asignar a la nueva fábrica de conexiones de cola de WebSphere Application Server.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 43. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
XAEnabled Especifica si se ha habilitado el proceso de recuperación XA.
['XAEnabled', 'false']
authDataAlias Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Especifica el mecanismo de autenticación. Los valores válidos son BASIC_PASSWORD para autenticación básica y KERBEROS para autenticación Kerberos.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['authMechanismPreference', 
'BASIC_PASSWORD']
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
connectionPool Especifica las propiedades de agrupación de conexiones JMS de la instancia de fábrica de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
diagnoseConnectionUsage Especifica si se ha habilitado el diagnóstico de uso de la conexión.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
['logMissingTransactionContext', 'true']
manageCachedHandles Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es true.
['manageCachedHandles', 'true']
mapping Especifica la correlación del inicio de sesión de configuración con un nombre de alias de autenticación especificado.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Especifica los valores de configuración de conexión de preprueba.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties Especifica un tipo de propiedad definida o un tipo de propiedad descriptiva.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["properties",[["description","Mi descripción"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
sessionPool Especifica las propiedades de agrupación de sesiones JMS de la instancia de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
['xaRecoveryAuthAlias', 'myCellManager01/a1']

Sintaxis

AdminJMS.createWASQueueConnectionFactory(nodeName, 
 serverName, jmsProvider, queueConnFactoryName, 
 jndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASQueueConnectionFactory("myNode", "myServer", 
 "JMSTest", "queueCFTest", "queuejndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASQueueConnectionFactory("IBM-F4A849C57A0Node01", "server1", 
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", “XAEnabled=false, 
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD,  category=myCategory, 
description='My description', diagnoseConnectionUsage=false, logMissingTransactionContext=true, 
manageCachedHandles=true, providerType=myProviderType, xaRecoveryAuthAlias=myCellManager01/a1")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWASQueueConnectionFactory("IBM-F4A849C57A0Node01", "server1", 
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", [['XAEnabled', 'false'], 
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ' '], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'], 
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], 
['description', 'My description'], ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping', 
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], 
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'], 
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]], 
['xaRecoveryAuthAlias', 'myCellManager01/a1']] ))

createWASQueueConnectionFactoryUsingTemplate

Este script utiliza una plantilla para crear una fábrica de conexiones de cola de WebSphere Application Server en la configuración. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMSServer incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración de la fábrica de conexiones de cola de WebSphere Application Server creada mediante una plantilla en la célula respectiva.

Para ejecutar el script, especifique los argumentos de nombre de nodo, nombre de servidor, nombre de proveedor de JMS, ID de configuración de la plantilla, nombre que se va a asignar a la fábrica de conexiones de la cola y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 44. Argumentos del script createWASQueueConnectionFactoryUsingTemplate. Ejecute el script para crear una fábrica de conexiones de cola.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jmsProvider Especifica el nombre del proveedor de JMS de interés.
templateID Especifica el ID de configuración de la plantilla de fábrica de conexiones de cola de WebSphere Application Server que se va a utilizar.
queueConnFactoryName Especifica el nombre que se debe asignar a la nueva fábrica de conexiones de cola de WebSphere Application Server.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 45. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
XAEnabled Especifica si se ha habilitado el proceso de recuperación XA.
['XAEnabled', 'false']
authDataAlias Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Especifica el mecanismo de autenticación. Los valores válidos son BASIC_PASSWORD para autenticación básica y KERBEROS para autenticación Kerberos.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['authMechanismPreference', 
'BASIC_PASSWORD']
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
connectionPool Especifica las propiedades de agrupación de conexiones JMS de la instancia de fábrica de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
diagnoseConnectionUsage Especifica si se ha habilitado el diagnóstico de uso de la conexión.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
['logMissingTransactionContext', 'true']
manageCachedHandles Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es true.
['manageCachedHandles', 'true']
mapping Especifica la correlación del inicio de sesión de configuración con un nombre de alias de autenticación especificado.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Especifica los valores de configuración de conexión de preprueba.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties Especifica un tipo de propiedad definida o un tipo de propiedad descriptiva.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["properties",[["description","Mi descripción"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
sessionPool Especifica las propiedades de agrupación de sesiones JMS de la instancia de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
['xaRecoveryAuthAlias', 'myCellManager01/a1']

Sintaxis

AdminJMS.createWASQueueConnectionFactoryUsingTemplate(nodeName, 
 serverName, jmsProvider, templateID, 
 queueConnFactoryName, jndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASQueueConnectionFactoryUsingTemplate("myNode", "myServer", 
 "JMSTest", "Example WAS 
 QueueConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)", 
 "queueCFTest", "queuecfjndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASQueueConnectionFactoryUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Example WAS QueueConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)", 
"My WASQueue Name", "JNDIName", “XAEnabled=false, authDataAlias=myAuthDataAlias, 
authMechanismPreference=BASIC_PASSWORD,  category=myCategory, description='My description', 
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true, 
providerType=myProviderType, xaRecoveryAuthAlias=myCellManager01/a1")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWASQueueConnectionFactoryUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Example WAS QueueConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)", 
"My WASQueue Name", "JNDIName", [['XAEnabled', 'false'],['authDataAlias', 'myAuthDataAlias'], 
['authMechanismPreference', 'BASIC_PASSWORD'], ['category', 'myCategory'], ['connectionPool', 
[['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], 
['maxConnections', '12'], ['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], 
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties', 
[[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ' '], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'],['surgeCreationInterval', '10'], ['surgeThreshold', '10'], 
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], 
['description', 'My description'], ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping', 
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]], 
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

createWASQueueConnectionFactoryAtScope

Este script crea una fábrica de conexiones de cola de WebSphere Application Server en la configuración en el ámbito que especifique. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMSServer incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración de la fábrica de conexiones de cola de WebSphere Application Server creada en la célula respectiva.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de JMS, el nombre que se va a asignar a la fábrica de conexiones de la cola y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:

Tabla 46. Argumentos del script createWASQueueConnectionFactoryAtScope. Ejecute el script para crear una fábrica de conexiones de cola.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
jmsProvider Especifica el nombre del proveedor de JMS de interés.
queueConnFactoryName Especifica el nombre que se debe asignar a la nueva fábrica de conexiones de cola de WebSphere Application Server.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 47. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
XAEnabled Especifica si se ha habilitado el proceso de recuperación XA.
['XAEnabled', 'false']
authDataAlias Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Especifica el mecanismo de autenticación. Los valores válidos son BASIC_PASSWORD para autenticación básica y KERBEROS para autenticación Kerberos.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['authMechanismPreference', 
'BASIC_PASSWORD']
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
connectionPool Especifica las propiedades de agrupación de conexiones JMS de la instancia de fábrica de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
diagnoseConnectionUsage Especifica si se ha habilitado el diagnóstico de uso de la conexión.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
['logMissingTransactionContext', 'true']
manageCachedHandles Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es true.
['manageCachedHandles', 'true']
mapping Especifica la correlación del inicio de sesión de configuración con un nombre de alias de autenticación especificado.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Especifica los valores de configuración de conexión de preprueba.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties Especifica un tipo de propiedad definida o un tipo de propiedad descriptiva.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["properties",[["description","Mi descripción"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
sessionPool Especifica las propiedades de agrupación de sesiones JMS de la instancia de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
['xaRecoveryAuthAlias', 'myCellManager01/a1']

Sintaxis

AdminJMS.createWASQueueConnectionFactoryAtScope(scope, 
 jmsProvider, queueConnFactoryName, 
 jndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASQueueConnectionFactoryAtScope("myScope", 
 "JMSTest", "queueCFTest", "queuejndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASQueueConnectionFactoryAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", “XAEnabled=false, authDataAlias=myAuthDataAlias, 
authMechanismPreference=BASIC_PASSWORD,  category=myCategory, description='My description', diagnoseConnectionUsage=false, 
logMissingTransactionContext=true, manageCachedHandles=true, providerType=myProviderType, 
 xaRecoveryAuthAlias=myCellManager01/a1")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWASQueueConnectionFactoryAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", [['XAEnabled', 'false'], ['authDataAlias', 'myAuthDataAlias'], 
['authMechanismPreference', 'BASIC_PASSWORD'], ['category', 'myCategory'], ['connectionPool', [['agedTimeout', '100'], 
['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], ['validationExpression', ' '], 
['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeCreationInterval', '10'], 
['surgeThreshold', '10'], ['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], 
['description', 'My description'], ['diagnoseConnectionUsage', 'false'], ['logMissingTransactionContext', 'true'], 
['manageCachedHandles', 'true'], ['mapping', [['authDataAlias', 'authDataAliasValue'], 
['mappingConfigAlias', 'mappingConfigAliasValue']]], ['preTestConfig', [['preTestConnection', 'true'], 
['retryInterval', '12343'],
['retryLimit', '4']]], ['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', [[['name', 'databaseName'], 
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], 
['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], ['sessionPool', 
[['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'], 
['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], 
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], 
['surgeThreshold', '10'], ['testConnection', 'true']]], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

createWASQueueConnectionFactoryUsingTemplateAtScope

Este script utiliza una plantilla para crear una fábrica de conexiones de cola de WebSphere Application Server en la configuración en el ámbito que especifique. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMSServer incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración de la fábrica de conexiones de cola de WebSphere Application Server creada mediante una plantilla en la célula respectiva.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de JMS, ID de configuración de la plantilla, nombre que se va a asignar a la fábrica de conexiones de la cola y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 48. Argumentos del script createWASQueueConnectionFactoryUsingTemplateAtScope. Ejecute el script para crear una fábrica de conexiones de cola.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
jmsProvider Especifica el nombre del proveedor de JMS de interés.
templateID Especifica el ID de configuración de la plantilla de fábrica de conexiones de cola de WebSphere Application Server que se va a utilizar.
queueConnFactoryName Especifica el nombre que se debe asignar a la nueva fábrica de conexiones de cola de WebSphere Application Server.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 49. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
XAEnabled Especifica si se ha habilitado el proceso de recuperación XA.
['XAEnabled', 'false']
authDataAlias Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Especifica el mecanismo de autenticación. Los valores válidos son BASIC_PASSWORD para autenticación básica y KERBEROS para autenticación Kerberos.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['authMechanismPreference', 
'BASIC_PASSWORD']
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
connectionPool Especifica las propiedades de agrupación de conexiones JMS de la instancia de fábrica de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
diagnoseConnectionUsage Especifica si se ha habilitado el diagnóstico de uso de la conexión.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
['logMissingTransactionContext', 'true']
manageCachedHandles Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es true.
['manageCachedHandles', 'true']
mapping Especifica la correlación del inicio de sesión de configuración con un nombre de alias de autenticación especificado.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Especifica los valores de configuración de conexión de preprueba.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties Especifica un tipo de propiedad definida o un tipo de propiedad descriptiva.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["properties",[["description","Mi descripción"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
sessionPool Especifica las propiedades de agrupación de sesiones JMS de la instancia de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
['xaRecoveryAuthAlias', 'myCellManager01/a1']

Sintaxis

AdminJMS.createWASQueueConnectionFactoryUsingTemplateAtScope(scope, 
 jmsProvider, templateID, 
 queueConnFactoryName, jndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASQueueConnectionFactoryUsingTemplateAtScope("myScope",
 "JMSTest", "Example WAS 
 QueueConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)", 
 "queueCFTest", "queuecfjndi")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASQueueConnectionFactoryUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "Example WAS QueueConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)", 
"My WASQueue Name", "JNDIName", “XAEnabled=false, authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD,  
category=myCategory, description='My description', diagnoseConnectionUsage=false, logMissingTransactionContext=true, 
manageCachedHandles=true, providerType=myProviderType, xaRecoveryAuthAlias=myCellManager01/a1")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWASQueueConnectionFactoryUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "Example WAS QueueConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)", 
"My WASQueue Name", "JNDIName", [['XAEnabled', 'false'],['authDataAlias', 'myAuthDataAlias'], 
['authMechanismPreference', 'BASIC_PASSWORD'],
['category', 'myCategory'], ['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'],
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties', 
[[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
 ['purgePolicy', 'EntirePool'],
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'], ['testConnection', 'true'], 
['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], ['description', 'My description'], 
 ['diagnoseConnectionUsage', 'false'],
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping', 
[['authDataAlias', 'authDataAliasValue'],
['mappingConfigAlias', 'mappingConfigAliasValue']]], ['preTestConfig', [['preTestConnection', 'true'], 
['retryInterval', '12343'],
['retryLimit', '4']]], ['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', [[['name', 'databaseName'], 
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], 
['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], ['sessionPool', 
[['agedTimeout', '100'],
['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], 
['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'],
 ['testConnection', 'true']]],
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

createWASTopic

Este script crea un tema de WebSphere Application Server en la configuración de JMS. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMSServer incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración del tema de WebSphere Application Server creado en la célula respectiva.

Para ejecutar el script, especifique los argumentos de nodo, servidor, nombre de proveedor de JMS, nombre que se va a asignar al tema, nombre JNDI y tema. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 50. Argumentos del script createWASTopic. Ejecute el script para crear un tema.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jmsProvider Especifica el nombre del proveedor de JMS de interés.
topicName Especifica el nombre para asignar al tema nuevo.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
topic Especifica el nombre del tema (como un calificador del espacio de temas) que va a utilizar este tema.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 51. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
expiry Especifica el período de tiempo después del cual caducarán los mensajes enviados a este destino y se tratarán en función de sus opciones de disposición. Los valores válidos son APPLICATION_DEFINE, SPECIFIED y UNLIMITED.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['expiry', 'SPECIFIED']
persistence Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y SPECIFIED.
['priority', 'SPECIFIED']
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores específica. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myProviderType']
specifiedExpiry Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan.
['specifiedExpiry', '1000']
specifiedPriority Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere.
['specifiedPriority', '0']

Sintaxis

AdminJMS.createWASTopic(nodeName, serverName, 
 jmsProvider, topicName, jndiName, topic, 
 attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASTopic("myNode",
"myServer", "JMSTest", 
 "TopicTest", "topicjndi", "mytopic")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASTopic("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"My WASTopic", "JNDIName", "A WAS Topic",” category=myCategory, description='My description', 
expiry=SPECIFIED, persistence=PERSISTENT, priority=APPLICATION_DEFINED")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWASTopic("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", "My WASTopic", 
"JNDIName", "A WAS Topic", [['category', 'myCategory'], ['description', 'My description'], 
['expiry', 'SPECIFIED'], ['persistence', 'PERSISTENT'], ['priority', 'APPLICATION_DEFINED'], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], 
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], 
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], 
['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

createWASTopicUsingTemplate

Este script utiliza una plantilla para crear un tema de WebSphere Application Server en la configuración de JMS. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMSServer incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración del tema de WebSphere creado en la célula respectiva.

Para ejecutar el script, especifique los argumentos de nodo, servidor, nombre de proveedor de JMS, ID de configuración de la plantilla, nombre que se va a asignar al tema, nombre JNDI y tema. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 52. Argumentos del script createWASTopicUsingTemplate. Ejecute el script para crear un tema.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jmsProvider Especifica el nombre del proveedor de JMS de interés.
templateID Especifica el ID de configuración de la plantilla de tema de WebSphere Application Server que se va a utilizar.
topicName Especifica el nombre para asignar al tema nuevo.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
topic Especifica el nombre del tema (como un calificador del espacio de temas) que va a utilizar este tema.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 53. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
expiry Especifica el período de tiempo después del cual caducarán los mensajes enviados a este destino y se tratarán en función de sus opciones de disposición. Los valores válidos son APPLICATION_DEFINE, SPECIFIED y UNLIMITED.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['expiry', 'SPECIFIED']
persistence Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y SPECIFIED.
['priority', 'SPECIFIED']
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores específica. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myProviderType']
specifiedExpiry Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan.
['specifiedExpiry', '1000']
specifiedPriority Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere.
['specifiedPriority', '0']

Sintaxis

AdminJMS.createWASTopicUsingTemplate(nodeName, 
 serverName, jmsProvider, templateID, topicName, 
 jndiName, topic, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASTopicUsingTemplate("myNode", "myServer", "JMSTest", 
 "Example.JMS.WAS.T1(templates/system|JMS-resource-provider-templates.xml#WASTopic_1)", 
"TopicTest", 
 "topicjndi", "mytopic")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASTopic("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"My WASTopic", "JNDIName", "A WAS Topic",” category=myCategory, description='My description', 
expiry=SPECIFIED, persistence=PERSISTENT, priority=APPLICATION_DEFINED”)
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminJMS.createWASTopic("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", "My WASTopic", 
"JNDIName", "A WAS Topic", [['category', 'myCategory'], ['description', 'My description'], [
'expiry', 'SPECIFIED'], ['persistence', 'PERSISTENT'], ['priority', 'APPLICATION_DEFINED'], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], 
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], 
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], 
['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

createWASTopicAtScope

Este script crea un tema de WebSphere Application Server en la configuración de JMS en el ámbito que especifique. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMSServer incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración del tema de WebSphere Application Server creado en la célula respectiva.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de JMS, nombre que se va a asignar al tema, nombre JNDI y tema. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 54. Argumentos del script createWASTopicAtScope. Ejecute el script para crear un tema.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
jmsProvider Especifica el nombre del proveedor de JMS de interés.
topicName Especifica el nombre para asignar al tema nuevo.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
topic Especifica el nombre del tema (como un calificador del espacio de temas) que va a utilizar este tema.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 55. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
expiry Especifica el período de tiempo después del cual caducarán los mensajes enviados a este destino y se tratarán en función de sus opciones de disposición. Los valores válidos son APPLICATION_DEFINE, SPECIFIED y UNLIMITED.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['expiry', 'SPECIFIED']
persistence Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y SPECIFIED.
['priority', 'SPECIFIED']
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores específica. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myProviderType']
specifiedExpiry Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan.
['specifiedExpiry', '1000']
specifiedPriority Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere.
['specifiedPriority', '0']

Sintaxis

AdminJMS.createWASTopicAtScope(scope, 
 jmsProvider, topicName, jndiName, topic, 
 attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASTopic("myScope",
"JMSTest", 
 "TopicTest", "topicjndi", "mytopic")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASTopicAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My WASTopic", "JNDIName", "A WAS Topic", ” category=myCategory, description='My description', 
expiry=SPECIFIED, persistence=PERSISTENT, priority=APPLICATION_DEFINED”)

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWASTopicAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My WASTopic", "JNDIName", "A WAS Topic", [['category', 'myCategory'],
['description', 'My description'],
['expiry', 'SPECIFIED'], ['persistence', 'PERSISTENT'], ['priority', 'APPLICATION_DEFINED'], ['propertySet', 
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], 
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], 
['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

createWASTopicUsingTemplateAtScope

Este script utiliza una plantilla para crear un tema de WebSphere Application Server en la configuración de JMS en el ámbito que especifique. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMSServer incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración del tema de WebSphere creado en la célula respectiva.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de JMS, ID de configuración de la plantilla, nombre que se va a asignar al tema, nombre JNDI y tema. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 56. Argumentos del script createWASTopicUsingTemplateAtScope. Ejecute el script para crear un tema.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
jmsProvider Especifica el nombre del proveedor de JMS de interés.
templateID Especifica el ID de configuración de la plantilla de tema de WebSphere Application Server que se va a utilizar.
topicName Especifica el nombre para asignar al tema nuevo.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
topic Especifica el nombre del tema (como un calificador del espacio de temas) que va a utilizar este tema.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 57. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
expiry Especifica el período de tiempo después del cual caducarán los mensajes enviados a este destino y se tratarán en función de sus opciones de disposición. Los valores válidos son APPLICATION_DEFINE, SPECIFIED y UNLIMITED.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['expiry', 'SPECIFIED']
persistence Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y SPECIFIED.
['priority', 'SPECIFIED']
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores específica. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myProviderType']
specifiedExpiry Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan.
['specifiedExpiry', '1000']
specifiedPriority Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere.
['specifiedPriority', '0']

Sintaxis

AdminJMS.createWASTopicUsingTemplateAtScope(scope, 
 jmsProvider, templateID, topicName, 
 jndiName, topic, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASTopicUsingTemplateAtScope("myScope", "JMSTest", 
 "Example.JMS.WAS.T1(templates/system|JMS-resource-provider-templates.xml#WASTopic_1)", 
"TopicTest", 
 "topicjndi", "mytopic")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASTopicUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "Example.JMS.WAS.T1(templates/system|JMS-resource-provider-templates.xml#WASTopic_1)", 
"My WASTopic", "JNDIName", "A WAS Topic", ” category=myCategory, description='My description', expiry=SPECIFIED, 
persistence=PERSISTENT, priority=APPLICATION_DEFINED”)
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminJMS.createWASTopicUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "Example.JMS.WAS.T1(templates/system|JMS-resource-provider-templates.xml#WASTopic_1)", 
"My WASTopic", "JNDIName", "A WAS Topic", [['category', 'myCategory'], ['description', 'My description'], 
['expiry', 'SPECIFIED'], ['persistence', 'PERSISTENT'], ['priority', 'APPLICATION_DEFINED'], ['propertySet', 
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], 
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

createSIBJMSTopic

Este script crear un nuevo tema JMS para el proveedor de mensajería predeterminado en el ámbito que especifique. El script devuelve el ID de configuración del tema SIB JMS creado.

Para ejecutar el script, especifique el ámbito, nombre, que se ha de asignar al tema, y el nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 58. Argumentos para el script createSIBJMSTopic script. Ejecute el script para crear un tema JMS.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de mensajería predeterminado.
nombre Especifica el nombre para asignar al tema nuevo.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar este objeto en la JNDI de WebSphere Application Server.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 59. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción
description Especifica una descripción del tema SIB JMS.
topicSpace Especifica el nombre del espacio de temas SIB subyacente al que apunta el tema.
topicName Especifica el tema que se utiliza dentro del espacio de temas, por ejemplo, stock/IBM.
deliveryMode Especifica la modalidad de entrega para mensajes. Los valores válidos son Application, NonPersistent y Persistent.
timeToLive Especifica el tiempo en milisegundos para la caducidad de mensajes.
priority Especifica el nivel de prioridad que se asigna a los mensajes enviados a este destino. Losvalores válidos son 0, 1, 2, 3, 4, 5, 6, 7, 8 ó 9.
readAhead Especifica el valor de lectura anticipada. Los valores válidos son AsConnection, AlwaysOn y AlwaysOff.
NombreBus El nombre del bus en el que reside el tema.

Sintaxis

AdminJMS.createSIBJMSTopic(scope, 
 name, 
 jndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createSIBJMSTopic("myScope", "myName", "myJNDIName")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createSIBJMSTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName" , 
"myJndiName9", "readAhead=AlwaysOff,timeToLive=6")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminJMS.createSIBJMSTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName" , 
"myJndiName9", [['readAhead', 'AlwaysOff'], ['timeToLive', '6']])

createWMQTopic

Este script crea un destino de tema JMS para el proveedor de mensajería de IBM MQ en el ámbito que especifique. El script devuelve el ID de configuración del tema IBM MQ creado.

Para ejecutar el script, especifique el ámbito, nombre, que se ha de asignar al tema, y el nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 60. Argumentos para el script createWMQTopic. Ejecute el script para crear un destino de tema JMS.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de mensajería de IBM MQ.
nombre Especifica el nombre para asignar al tema nuevo.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar este objeto en la JNDI de WebSphere Application Server.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 61. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción
brokerCCDurSubQueue Especifica el nombre de la cola desde la que un consumidor de conexión recibe mensajes de suscripciones duraderas.
brokerDurSubQueue Especifica el nombre desde la cola de la que un consumidor de conexión recibe mensajes de suscripciones no duraderas.
brokerPubQmgr Especifica el nombre del gestor de colas en el que se está ejecutando el intermediario.
brokerPubQueue Especifica el nombre de la cola a la que se envían los mensajes de publicación.
brokerVersion Especifica el nivel de funcionalidad necesario para las operaciones de publicación y suscripción.
ccsid Especifica el identificador del conjunto de caracteres codificado.
decimalEncoding Especifica el valor de codificación decimal para este tema. Los valores válidos son Normal y Reversed.
description Especifica una descripción administrativa que se asocia con este tipo de destino de tema JMS de IBM MQ.
expiry Especifica el período de tiempo después del cual los mensajes enviados a este destino caducarán y se manejarán en función de sus opciones de disposición. Los valores válidos son APP, UNLIM o cualquier entero positivo.
floatingPointEncoding Especifica el valor de codificación de coma flotante de este tema. Los valores válidos son IEEENormal, IEEEReversed y z/OS.
integerEncoding Especifica el valor de codificación de enteros para este tema. Los valores válidos son Normal y Reversed.
persistence Especifica el nivel de persistencia que se utiliza para almacenar los mensajes enviados a este destino. Los valores válidos son APP, TDEF, PERS, NON o HIGH.
priority Especifica el nivel de prioridad que se asigna a los mensajes enviados a este destino. Los valores válidos son APP, TDEF, 0, 1, 2, 3, 4, 5, 6, 7, 8 ó 9.
readAheadClose Especifica el comportamiento que se produce al cerrar un consumidor de mensajes que recibe mensajes asíncronamente. El consumidor de mensajes utiliza un escucha de mensajes de un destino que tiene establecido el parámetro readAhead en true. Cuando se especifica un valor DELIVERALL, la invocación del método close espera a que se entreguen al consumidor todos los mensajes de lectura anticipada antes de cerrarlo. Cuando se especifica un valor DELIVERCURRENT, el método close() sólo espera a que finalice cualquier entrega que esté en proceso antes de cerrar el consumidor. Los valores válidos son DELIVERALL y DELIVERCURRENT.
readAhead Especifica si los mensajes para los consumidores no persistentes se pueden leer de forma anticipada y guardar en la memoria caché. Los valores válidos son YES, NO o TDEF.
sendAsync Especifica si los mensajes se pueden enviar a este destino sin necesidad de que el gestor de colas reconozca que han llegado. Los valores válidos son YES, NO o TDEF.
useRFH2 Especifica si se añade una cabecera RFH versión 2 a los mensajes enviados a este destino. Los valores válidos son true o false.
useNativeEncoding Especifica los valores de codificación nativa para este tema.
wildcardFormat Especifica qué conjuntos de caracteres se interpretan como comodines de temas.

Sintaxis

AdminJMS.createWMQTopic(scope, 
 name, 
 jndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWMQTopic("myScope", "myName", "myJNDIName")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWMQTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName10", "myTopicName10", "readAhead=YES,sendAsync=NO")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminJMS.createWMQTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName10", "myTopicName10", [['readAhead', 'YES'], ['sendAsync', 'NO']])

createWASTopicConnectionFactory

Este script crea una fábrica de conexiones de tema de WebSphere Application Server en la configuración. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMSServer incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración de la fábrica de conexiones de tema de WebSphere Application Server creada en la célula respectiva.

Para ejecutar el script, especifique los argumentos de nodo, servidor, nombre de proveedor de JMS, nombre que se va a asignar a la fábrica de conexiones, nombre JNDI y puerto. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 62. Argumentos del script createWASTopicConnectionFactory. Ejecute el script para crear una fábrica de conexiones de tema.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jmsProviderName Especifica el nombre del proveedor de JMS de interés.
topicConnFactoryName Especifica el nombre para asignar a la fábrica de conexiones nueva.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
port Especifique el puerto de interés.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 63. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
XAEnabled Especifica si se ha habilitado el proceso de recuperación XA.
['XAEnabled', 'false']
authDataAlias Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Especifica el mecanismo de autenticación. Los valores válidos son BASIC_PASSWORD para autenticación básica y KERBEROS para autenticación Kerberos.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['authMechanismPreference', 
'BASIC_PASSWORD']
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
connectionPool Especifica las propiedades de agrupación de conexiones JMS de la instancia de fábrica de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
diagnoseConnectionUsage Especifica si se ha habilitado el diagnóstico de uso de la conexión.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
['logMissingTransactionContext', 'true']
manageCachedHandles Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es true.
['manageCachedHandles', 'true']
mapping Especifica la correlación del inicio de sesión de configuración con un nombre de alias de autenticación especificado.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Especifica los valores de configuración de conexión de preprueba.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties Especifica un tipo de propiedad definida o un tipo de propiedad descriptiva.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["properties",[["description","Mi descripción"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
sessionPool Especifica las propiedades de agrupación de sesiones JMS de la instancia de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
['xaRecoveryAuthAlias', 'myCellManager01/a1']
Tabla 64. Atributos opcionales (continuación). Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
clientID Especifica el ID del cliente.
['clientID', 'myClientID']
cloneSupport Especifica si la fábrica de conexiones de tema de WebSphere está admitida en los clones.
['cloneSupport', 'true']

Sintaxis

AdminJMS.createWASTopicConnectionFactory(nodeName, 
 serverName, jmsProviderName, topicConnFactoryName, 
 jndiName, port, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASTopicConnectionFactory("myNode", "myServer", 
 "JMSTest", "TopicCFTest", "topiccfjndi", "DIRECT")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASTopicConnectionFactory("IBM-F4A849C57A0Node01", "server1", 
"My JMS Provider Name1", "My WASTopicConnectionFactory", "JNDIName", "DIRECT", “XAEnabled=false, 
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory, 
clientID=myClientID, cloneSupport=true, description='My description', diagnoseConnectionUsage=false, 
logMissingTransactionContext=true, manageCachedHandles=true, providerType=myProviderType, 
xaRecoveryAuthAlias=myCellManager01/a1")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWASTopicConnectionFactory("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"My WASTopicConnectionFactory", "JNDIName", "DIRECT", [['XAEnabled', 'false'], 
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['clientID', 'myClientID'], ['cloneSupport', 'true'], 
['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], 
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'], 
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'], 
['testConnection', 'true']]], ['description', 'My description'], ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping', 
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], 
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], 
['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], ['sessionPool', 
[['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], 
['maxConnections', '12'], ['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], 
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties', 
[[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]], 
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

createWASTopicConnectionFactoryUsingTemplate

Este script utiliza una plantilla para crear una fábrica de conexiones de tema de WebSphere Application Server en la configuración. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMS Server incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración del tema de WebSphere creado mediante una plantilla en la célula respectiva.

Para ejecutar el script, especifique los argumentos de nodo, servidor, nombre de proveedor de JMS, ID de configuración de la plantilla, nombre que se va a asignar a la fábrica de conexiones, nombre JNDI y puerto. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 65. Argumentos del script createWASTopicConnectionFactoryUsingTemplate. Ejecute el script para crear una fábrica de conexiones de tema.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jmsProviderName Especifica el nombre del proveedor de JMS de interés.
templateID Especifica el ID de configuración de la fábrica de conexiones de tema de WebSphere Application Server que se debe utilizar.
topicConnFactoryName Especifica el nombre para asignar a la fábrica de conexiones nueva.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
port Especifica el puerto de interés.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 66. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
XAEnabled Especifica si se ha habilitado el proceso de recuperación XA.
['XAEnabled', 'false']
authDataAlias Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Especifica el mecanismo de autenticación. Los valores válidos son BASIC_PASSWORD para autenticación básica y KERBEROS para autenticación Kerberos.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['authMechanismPreference', 
'BASIC_PASSWORD']
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
connectionPool Especifica las propiedades de agrupación de conexiones JMS de la instancia de fábrica de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
diagnoseConnectionUsage Especifica si se ha habilitado el diagnóstico de uso de la conexión.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
['logMissingTransactionContext', 'true']
manageCachedHandles Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es true.
['manageCachedHandles', 'true']
mapping Especifica la correlación del inicio de sesión de configuración con un nombre de alias de autenticación especificado.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Especifica los valores de configuración de conexión de preprueba.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties Especifica un tipo de propiedad definida o un tipo de propiedad descriptiva.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["properties",[["description","Mi descripción"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
sessionPool Especifica las propiedades de agrupación de sesiones JMS de la instancia de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
['xaRecoveryAuthAlias', 'myCellManager01/a1']
Tabla 67. Atributos opcionales (continuación). Atributo adicional disponible para el script.
Atributos Descripción Ejemplo
type Especifica QUEUE para colas, TOPIC para temas y UNIFIED para colas y temas.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['type', 'TOPIC']

Sintaxis

AdminJMS.createWASTopicConnectionFactoryUsingTemplate(nodeName, 
 serverName, jmsProviderName, templateID, 
 topicConnFactoryName, jndiName,  port, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASTopicConnectionFactoryUsingTemplate("myNode", "myServer", 
 "JMSTest", "First Example WAS 
 TopicConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)", 
 "TopicCFTest", "topiccfjndi", "DIRECT")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASTopicConnectionFactoryUsingTemplate
("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"First Example WAS TopicConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)", 
"My WASTopicConnectionFactory", "JNDIName", "DIRECT", “XAEnabled=false, authDataAlias=myAuthDataAlias, 
authMechanismPreference=BASIC_PASSWORD, category=myCategory, clientID=myClientID, cloneSupport=true, 
description='My description', diagnoseConnectionUsage=false, logMissingTransactionContext=true, 
manageCachedHandles=true, providerType=myProviderType, xaRecoveryAuthAlias=myCellManager01/a1")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWASTopicConnectionFactoryUsingTemplate
("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"First Example WAS TopicConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)", 
"My WASTopicConnectionFactory", "JNDIName", "'DIRECT'", [['XAEnabled', 'false'], 
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['clientID', 'myClientID'], ['cloneSupport', 'true'], 
['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], 
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'], 
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'], 
['testConnection', 'true']]], ['description', 'My description'], ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping', 
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], 
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'], 
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'], 
['testConnection', 'true']]], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

createWASTopicConnectionFactoryAtScope

Este script crea una fábrica de conexiones de tema de WebSphere Application Server en la configuración en el ámbito que especifique. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMSServer incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración de la fábrica de conexiones de tema de WebSphere Application Server creada en la célula respectiva.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de JMS, nombre que se va a asignar a la fábrica de conexiones, nombre JNDI y puerto. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 68. Argumentos del script createWASTopicConnectionFactoryAtScope. Ejecute el script para crear una fábrica de conexiones de tema.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
jmsProviderName Especifica el nombre del proveedor de JMS de interés.
topicConnFactoryName Especifica el nombre para asignar a la fábrica de conexiones nueva.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
port Especifique el puerto de interés.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 69. Atributos opcionales (continuación). Atributo adicional disponible para el script.
Atributos Descripción Ejemplo
type Especifica QUEUE para colas, TOPIC para temas y UNIFIED para colas y temas.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['type', 'TOPIC']

Sintaxis

AdminJMS.createWASTopicConnectionFactoryAtScope(scope, 
 jmsProviderName, topicConnFactoryName, 
 jndiName, port, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASTopicConnectionFactoryAtScope("myScope", 
 "JMSTest", "TopicCFTest", "topiccfjndi", "DIRECT")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASTopicConnectionFactoryAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My WASTopicConnectionFactory", "JNDIName", "DIRECT", “XAEnabled=false, 
authDataAlias=myAuthDataAlias,
authMechanismPreference=BASIC_PASSWORD, category=myCategory, clientID=myClientID, cloneSupport=true, 
description='My description',
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true, 
providerType=myProviderType,
xaRecoveryAuthAlias=myCellManager01/a1")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWASTopicConnectionFactoryAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My WASTopicConnectionFactory", "JNDIName", "'DIRECT'", [['XAEnabled', 'false'], 
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference','BASIC_PASSWORD'], ['category', 'myCategory'], 
['clientID', 'myClientID'], ['cloneSupport', 'true'], ['connectionPool', [['agedTimeout', '100'], 
['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'],
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties', 
[[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'],
['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]], 
['description', 'My description'],
['diagnoseConnectionUsage', 'false'], ['logMissingTransactionContext', 'true'], 
['manageCachedHandles', 'true'], 
['mapping', [['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig',
[['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], ['properties',
[[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', 
[['resourceProperties', [[['name','databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], 
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], 
['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'],
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties', 
[[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'],
['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]], 
['xaRecoveryAuthAlias','myCellManager01/a1']] )

createWASTopicConnectionFactoryUsingTemplateAtScope

Este script utiliza una plantilla para crear una fábrica de conexiones de tema de WebSphere Application Server en la configuración en el ámbito que especifique. Sólo debe utilizar los recursos JMS para las aplicaciones que realizan la mensajería con un servidor WebSphere Application Server versión 5.1 con JMS Server incorporado en una célula de la versión 7.0. El script devuelve el ID de configuración del tema de WebSphere creado mediante una plantilla en la célula respectiva.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de JMS, ID de configuración de la plantilla, nombre que se va a asignar a la fábrica de conexiones, nombre JNDI y puerto. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 70. Argumentos del script createWASTopicConnectionFactoryUsingTemplateAtScope. Ejecute el script para crear una fábrica de conexiones de tema.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
jmsProviderName Especifica el nombre del proveedor de JMS de interés.
templateID Especifica el ID de configuración de la fábrica de conexiones de tema de WebSphere Application Server que se debe utilizar.
topicConnFactoryName Especifica el nombre para asignar a la fábrica de conexiones nueva.
jndiName Especifica el nombre JNDI que el sistema utiliza para enlazar la fábrica de conexiones con el espacio de nombres.
port Especifica el puerto de interés.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 71. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción Ejemplo
XAEnabled Especifica si se ha habilitado el proceso de recuperación XA.
['XAEnabled', 'false']
authDataAlias Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Especifica el mecanismo de autenticación. Los valores válidos son BASIC_PASSWORD para autenticación básica y KERBEROS para autenticación Kerberos.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['authMechanismPreference', 
'BASIC_PASSWORD']
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
connectionPool Especifica las propiedades de agrupación de conexiones JMS de la instancia de fábrica de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
diagnoseConnectionUsage Especifica si se ha habilitado el diagnóstico de uso de la conexión.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
['logMissingTransactionContext', 'true']
manageCachedHandles Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es true.
['manageCachedHandles', 'true']
mapping Especifica la correlación del inicio de sesión de configuración con un nombre de alias de autenticación especificado.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Especifica los valores de configuración de conexión de preprueba.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties Especifica un tipo de propiedad definida o un tipo de propiedad descriptiva.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["properties",[["description","Mi descripción"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider Especifica la clase de implementación del controlador JMS para acceder a una base de datos de proveedores. Para crear una agrupación de conexiones con esa base de datos, asocie un origen de datos con el proveedor de JMS.
['provider', 'myJMSProvider']
providerType Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS.
['providerType', 'myJMSProviderType']
sessionPool Especifica las propiedades de agrupación de sesiones JMS de la instancia de conexiones JMS padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
['xaRecoveryAuthAlias', 'myCellManager01/a1']
Tabla 72. Atributos opcionales (continuación). Atributo adicional disponible para el script.
Atributos Descripción Ejemplo
type Especifica QUEUE para colas, TOPIC para temas y UNIFIED para colas y temas.

No ponga entre comillas ninguno de los valores en el formato de serie del mandato.

['type', 'TOPIC']

Sintaxis

AdminJMS.createWASTopicConnectionFactoryUsingTemplateAtScope(scope, 
 jmsProviderName, templateID, 
 topicConnFactoryName, jndiName,  port, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWASTopicConnectionFactoryUsingTemplateAtScope("myScope", 
 "JMSTest", "First Example WAS 
 TopicConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)", 
 "TopicCFTest", "topiccfjndi", "DIRECT")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWASTopicConnectionFactoryUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "First Example WAS TopicConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)", 
"My WASTopicConnectionFactory", "JNDIName", "DIRECT", “XAEnabled=false, authDataAlias=myAuthDataAlias,
 authMechanismPreference=BASIC_PASSWORD, category=myCategory, clientID=myClientID, cloneSupport=true, description='My description',
 diagnoseConnectionUsage=false,
logMissingTransactionContext=true, manageCachedHandles=true, providerType=myProviderType, 
xaRecoveryAuthAlias=myCellManager01/a1”)

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWASTopicConnectionFactoryUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "First Example WAS TopicConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)", 
"My WASTopicConnectionFactory", "JNDIName", "'DIRECT'", [['XAEnabled', 'false'], 
['authDataAlias', 'myAuthDataAlias'],
['authMechanismPreference', 'BASIC_PASSWORD'], ['category', 'myCategory'], ['clientID', 'myClientID'], 
['cloneSupport', 'true'], 
['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], 
['maxConnections', '12'], ['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], 
['numberOfSharedPoolPartitions', '6'],
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'], 
['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeThreshold', '10'],
['testConnection', 'true']]], ['description', 'My description'], ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'],
['manageCachedHandles', 'true'], ['mapping', [['authDataAlias', 'authDataAliasValue'], 
['mappingConfigAlias', 'mappingConfigAliasValue']]],
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], 
 ['properties', [[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['propertySet',
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], 
[['name', 'driverType'],
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']],
[['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], 
['sessionPool', 
[['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], 
['maxConnections', '12'],
['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], 
['numberOfUnsharedPoolPartitions', '3'], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
 ['validationExpression', ''], 
['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'],
 ['testConnection', 'true']]],
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

createSIBJMSConnectionFactory

El script crea una nueva fábrica de conexiones SIB JMS para el proveedor de mensajería predeterminado en el ámbito que especifique. El script devuelve el ID de configuración de la fábrica de conexiones SIB JMS creada.

Para ejecutar el script, especifique los argumentos de ámbito, nombre, nombre JNDI y nombre de bus. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 73. Argumentos para el script createSIBJMSConnectionFactory. Ejecute el script para crear una fábrica de conexiones JMS.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
nombre Especifica el nombre administrativo asignado a esta fábrica de conexiones.
jndiName Especifica el nombre de JNDI que se especifica en los enlaces para los beans controlados por mensajes asociados a esta fábrica de conexiones.
NombreBus Especifica el nombre del bus de integración de servicio con el que se realizan las conexiones.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 74. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción
authDataAlias Especifica el ID de usuario y contraseña que se utilizarán para autenticar las conexiones con el proveedor de JMS para la autenticación gestionada por aplicaciones.
containerAuthAlias Especifica un alias de autenticación gestionada por contenedor, desde el que se utilizan las credenciales de seguridad para establecer una conexión con el proveedor JMS.
mappingAlias Especifica el alias de correlación de JAAS (Java Authentication and Authorization Service) a utilizar cuando se determinan las credenciales relacionadas con la seguridad. Las credenciales relacionadas con la seguridad se utilizan cuando se establece una conexión con el proveedor JMS.
xaRecoveryAuthAlias Especifica el alias de autenticación utilizado durante el proceso de recuperación XA.
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar la fábrica de conexiones.
description Especifica una descripción de la fábrica de conexiones.
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
manageCachedHandles Especifica si el contenedor realiza un seguimiento de los manejadores guardados en la caché, los cuales son manejadores de las variables de instancia de un bean.
clientID Especifica el ID de cliente que sólo es obligatorio para suscripciones duraderas.
NombreUsuario Especifica el nombre de usuario que se utiliza para crear conexiones desde la fábrica de conexiones.
contraseña Especifica la contraseña que se utiliza para crear conexiones desde la fábrica de conexiones.
nonPersistentMapping Especifica valor de correlación no persistente. Los valores válidos son BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent, ReliablePersistent, AssuredPersistent, AsSIBDestination y None.
persistentMapping Especifica un valor de correlación persistente. Los valores válidos son BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent, ReliablePersistent, AssuredPersistent, AsSIBDestination y None.
durableSubscriptionHome Especifica el valor inicial de la suscripción duradera.
readAhead Especifica el valor de lectura anticipada. Los valores válidos son Default, AlwaysOn y AlwaysOff.
target Especifica el nombre de un destino que se resuelve en un grupo de motores de mensajería.
targetType Especifica el tipo del nombre en el parámetro de destino. Los valores válidos son BusMember, Custom y ME.
targetSignificance Especifica la importancia del grupo de destino. Los valores válidos son Preferred y Required.
targetTransportChain Especifica el nombre del protocolo para conectarse a un motor de mensajería remoto.
providerEndPoints Especifica una lista separada por comas de tripletes con el formato host:puerto:cadena.
connectionProximity Especifica la proximidad de los motores de mensajería aceptables. Los valores válidos son Bus, Host, Cluster y Server.
tempQueueNamePrefix Especifica un prefijo de nombre de cola temporal.
tempTopicNamePrefix Especifica un prefijo de nombre de tema temporal.
shareDataSourceWithCMP Especifica cómo se controlan los orígenes de datos que se comparten.
shareDurableSubscriptions Especifica cómo controlar suscripciones duraderas que se comparten. Los valores válidos son InCluster, AlwaysShared y NeverShared.
consumerDoesNotModifyPayloadAfterGet Especifica que cuando una aplicación consumidora de mensajes recibe mensajes de objeto o bytes, el sistema serializa los datos de mensajes sólo cuando sea necesario. La aplicación está conectada al bus mediante esta fábrica de conexiones. Las aplicaciones que obtienen los datos de estos mensajes debe tratar los datos como datos de sólo lectura. Los valores válidos son true y false. El valor predeterminado es false.
producerDoesNotModifyPayloadAfterSet Especifica que cuando una aplicación consumidora de mensajes envía mensajes de objeto o byte, los datos no se copian y el sistema serializa los datos sólo cuando sea necesario. La aplicación está conectada al bus mediante esta fábrica de conexiones. Las aplicaciones que envían estos mensajes no deben modificar los datos hasta que se hayan establecido en un mensaje. Los valores válidos son true y false. El valor predeterminado es false.

Sintaxis

AdminJMS.createSIBJMSConnectionFactory(scope, 
 name, jndiName, 
 busName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createSIBJMSConnectionFactory("myScope", "myName", "myJNDIName", 
"MyBusName")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWMQConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName2", "readAhead=AlwaysOff,description=my description")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createSIBJMSConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName"
, "myJndiName1", "myBusName", [['readAhead', 'AlwaysOff'], ['description', 'my description']])

createWMQConnectionFactory

El script crea una fábrica de conexiones para el proveedor de mensajería de IBM MQ en el ámbito que especifique. El script devuelve el ID de configuración de la fábrica de conexiones de IBM MQ creada.

Para ejecutar el script, especifique los argumentos de ámbito, nombre y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 75. Argumentos para el script createWMQConnectionFactory. Ejecute el script para crear una fábrica de conexiones.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
nombre Especifica el nombre administrativo asignado a esta fábrica de conexiones del proveedor de mensajería de IBM MQ.
jndiName Especifica el nombre y la ubicación que se utiliza para enlazar este objeto en la JNDI de WebSphere Application Server.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 76. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción
maxBatchSize Especifica el número máximo de mensajes que se toman de una cola en un paquete cuando se utiliza la entrega de mensajería asíncrona.
brokerCCSubQueue Especifica el nombre de la cola de la que se recuperan mensajes de suscripciones no duraderas para un consumidor de conexiones. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerCtrlQueue Especifica la cola de control de intermediario que se utiliza si esta fábrica de conexiones se suscribe a un tema. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerQmgr Especifica el nombre del gestor de colas en el que se está ejecutando el gestor de colas. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerSubQueue Especifica la cola para obtener mensajes de suscripción si esta fábrica de conexiones se suscribe a un tema. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerVersion Especifica el nivel de funcionalidad necesario para las operaciones de publicación y suscripción. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerPubQueue Especifica la cola a la que se envían mensajes de publicación cuando se utilizan intermediarios basados en colas. Este parámetro sólo es válido para las fábricas de conexiones de temas.
ccdtQmgrName Especifica un nombre de gestor de colas que se utiliza para seleccionar uno o más entradas de una tabla de definición de canal cliente.
ccdtUrl Especifica un URL a una tabla de definiciones de canal de cliente. Utilice este atributo para esta fábrica de conexiones, cuando se contacta con el proveedor de mensajería de IBM MQ. Las fábricas de conexiones creadas utilizando este atributo son las fábricas de conexiones ccdtURL.
ccsid Especifica el ID de juego de caracteres codificados que se utilizará en las conexiones.
cleanupInterval Especifica el intervalo entre ejecuciones en segundo plano del programa de utilidad de limpieza de publicación y suscripción. Este parámetro sólo es válido para las fábricas de conexiones de temas.
cleanupLevel Especifica el nivel de limpieza para almacenes de suscripciones BROKER o MIGRATE. Este parámetro sólo es válido para las fábricas de conexiones de temas.
clientId Especifica el identificador de cliente utilizado para conexiones iniciadas que utilizan esta fábrica de conexiones.
clonedSubs Especifica si dos o más instancias del mismo suscriptor tema duradero se pueden ejecutar simultáneamente. Este parámetro sólo es válido para las fábricas de conexiones de temas.
compressHeaders Determina si las cabeceras de mensajes se comprimen o no.
compressPayload Determina si las cargas útiles de mensajes se comprimen o no.
containerAuthAlias Especifica un alias de autenticación gestionado por contenedor que tiene las credenciales de seguridad que se utilizan para establecer una conexión con el proveedor de mensajería de IBM MQ.
description Especifica una descripción de la fábrica de conexiones.
failIfQuiescing Especifica el comportamiento de determinadas llamadas al gestor de colas cuando el gestor de colas se coloca en un estado de reposo.
localAddress Especifica uno o los dos los elementos siguientes:
  • La interfaz de red local que se utilizará.
  • El puerto local o un rango de puertos locales que se utilizarán.
mappingAlias Especifica el alias de correlación JAAS a utilizar cuando se determinan las credenciales relacionadas con la seguridad. Las credenciales relacionadas con la seguridad se utilizan cuando se establece una conexión con IBM MQ.
modelQueue Especifica la definición de cola del modelo IBM MQ que se utilizará como base para la creación de destinos temporales JMS. Este parámetro sólo es válido para las fábricas de conexiones de cola.
msgRetention Especifica si el consumidor de conexiones mantiene los mensajes no deseados en la cola de entrada. Si el valor es true, significa que los mantiene. Si el valor es false significa que los mensajes se descartan en función de sus opciones de disposición. Este parámetro sólo es válido para las fábricas de conexiones de cola.
msgSelection Especifica dónde se produce la selección de mensaje. Este parámetro sólo es válido para las fábricas de conexiones de temas.
pollingInterval Especifica en milisegundos el tiempo máximo que transcurre durante un intervalo de sondeo. Si un escucha de mensajes de una sesión no tiene ningún mensaje apropiado en su cola, el escucha de mensajes utiliza el intervalo de sondeo para determinar con qué frecuencia sondea la cola en busca de un mensaje. Aumente el valor de esta propiedad si frecuentemente las sesiones no tienen un mensaje adecuado disponible. Este atributo sólo se puede aplicar en el contenedor de cliente.
providerVersion Especifica la versión mínima y las capacidades del gestor de colas.
pubAckInterval Especifica el número de publicaciones que se envían a un intermediario basado en cola antes de enviar una publicación que solicita un reconocimiento. Este atributo sólo es válido para las fábricas de conexiones de temas.
qmgrHostname Especifica el nombre de host que utiliza esta fábrica de conexiones cuando intenta una conexión de nodo cliente con IBM MQ.
qmgrName Especifica el nombre del gestor de colas que esta fábrica de conexiones utiliza cuando contacta con el proveedor de mensajería de IBM MQ. Las fábricas de conexiones creadas utilizando este parámetro son las fábricas de conexiones definidas por el usuario.
qmgrPortNumber Especifica el número de puerto que utiliza esta fábrica de conexiones cuando intenta una conexión de nodo cliente con IBM MQ.
qmgrSvrconnChannel Especifica el canal SVRCONN que se utiliza para la conexión con IBM MQ. Las fábricas de conexiones creadas utilizando este parámetro son las fábricas de conexiones definidas por el usuario.
rcvExitInitData Especifica los datos de inicialización que se han de pasar a la salida de recepción.
rcvExit Especifica una lista separada por comas de nombres de clase de salida de recepción.
replyWithRFH2 Especifica si se incluye en la respuesta de un mensaje, una cabecera RFH versión 2 en el mensaje de respuesta. Este parámetro sólo es válido para las fábricas de conexiones de cola.
rescanInterval Especifica en milisegundos el tiempo máximo que transcurre durante un intervalo de exploración. Cuando un consumidor de mensajes del dominio punto a punto utiliza un selector de mensajes para seleccionar qué mensajes desea recibir, el cliente JMS de IBM MQ busca en la cola IBM MQ los mensajes adecuados en la secuencia determinada por el atributo MsgDeliverySequence de la cola. Cuando el cliente encuentra un mensaje adecuado y lo entrega al consumidor, el cliente reanuda la búsqueda del siguiente mensaje adecuado desde su posición actual en la cola. El cliente continúa buscando la cola hasta que llega al final de la cola o hasta que el intervalo de tiempo especificado por esta propiedad ha caducado. En cada caso, el cliente vuelve al principio de la cola para seguir su búsqueda y se inicia un intervalo de tiempo nuevo. Este parámetro sólo es válido para las fábricas de conexiones de cola.
secExitInitData Especifica datos de inicialización que se pasan a la salida de seguridad.
secExit Especifica una lista separada por comas de nombres de clase de salida de seguridad.
sendExitInitData Especifica datos de inicialización que se pasan a la salida de envío.
sendExit Especifica una lista separada por comas de nombres de clase de salida de envío.
sparseSubs Especifica la política de recuperación de mensajes de un objeto TopicSubscriber. Este parámetro sólo es válido para las fábricas de conexiones de tema.
sslConfiguration Especifica una configuración SSL (Secure Sockets Layer) específica para proteger las conexiones de red con el gestor de colas.
sslCrl Especifica una lista de servidores LDAP que se pueden utilizar para proporcionar información de revocación de certificados si esta fábrica de conexiones establece una conexión SSL con IBM MQ.
sslPeerName Especifica un nombre de igual que coincide con el nombre distinguido en el certificado de igual. Este atributo se utiliza cuando la fábrica de conexiones establece una conexión SSL con el gestor de colas.
sslResetCount Especifica el número de bytes que se han de transferir antes de restablecer la clave de cifrado simétrica utilizada para la sesión SSL. Este atributo se utiliza cuando la fábrica de conexiones establece una conexión SSL con el gestor de colas.
sslType Especifica la configuración, si la hay, cuando la fábrica de conexiones establece una conexión SSL con el gestor de colas.
stateRefreshInt Especifica en milisegundos el tiempo máximo que transcurre entre renovaciones de la transacción de larga ejecución que detecta cuando un suscriptor pierde su conexión con el gestor de colas. Esta propiedad sólo es relevante si el atributo subStore tiene el valor QUEUE. Este atributo sólo es válido para las fábricas de conexiones de temas.
subStore Especifica que IBM MQ JMS almacena datos persistentes relacionados con las suscripciones activas. Este atributo sólo es válido para las fábricas de conexiones de temas.
support2PCProtocol Especifica si la fábrica de conexiones actúa como un recurso capaz de participar en el proceso de compromiso en dos fases distribuido.
tempQueuePrefix Especifica el prefijo que se aplica a las colas temporales de IBM MQ. Estas colas temporales representan destinos de tipo de cola temporal de JMS. Este atributo sólo es válido para las fábricas de conexiones de cola.
tempTopicPrefix Especifica el prefijo que se aplica a los temas temporales de IBM MQ. Estos temas temporales representan los destinos de tipos de temas temporales de JMS. Este atributo sólo es válido para las fábricas de conexiones de temas.
wildcardFormat Especifica qué conjuntos de caracteres se interpretan como comodines de temas. Este atributo sólo es válido para las fábricas de conexiones de temas.
wmqTransportType Especifica cómo se conecta esta fábrica de conexiones con IBM MQ. Las fábricas de conexiones creadas utilizando este atributo están definidas por el usuario. Los valores válidos son BINDINGS, BINDINGS_THEN_CLIENT y CLIENT.
xaRecoveryAuthAlias Especifica el alias de autenticación para conectarse con IBM MQ para la recuperación XA.

Sintaxis

AdminJMS.createWMQConnectionFactory(scope, 
 name, jndiName, 
 attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWMQConnectionFactory("myScope",
"myName", "myJNDIName")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWMQConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName2", "maxBatchSize=15,description=my description")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWMQConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName2", [['maxBatchSize', '15'], ['description', 'my description']])

createSIBJMSQueueConnectionFactory

El script crea una fábrica de conexiones de colas SIB JMS nueva para el proveedor de mensajería predeterminado en el ámbito que especifique. El script devuelve el ID de configuración de la fábrica de conexiones de colas SIB JMS creada.

Para ejecutar el script, especifique los argumentos de ámbito, nombre, nombre JNDI y nombre de bus. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 77. Argumentos para el script createSIBJMSQueueConnectionFactory. Ejecute el script para crear una fábrica de conexiones de cola JMS.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
nombre Especifica el nombre administrativo asignado a esta fábrica de conexiones.
jndiName Especifica el nombre de JNDI que se especifica en los enlaces para los beans controlados por mensajes asociados a esta fábrica de conexiones.
NombreBus Especifica el nombre del bus de integración de servicio con el que se realizan las conexiones.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 78. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción
authDataAlias Especifica el ID de usuario y contraseña que se utilizarán para autenticar las conexiones con el proveedor de JMS para la autenticación gestionada por aplicaciones.
containerAuthAlias Especifica un alias de autenticación gestionada por contenedor, desde el que se utilizan las credenciales de seguridad para establecer una conexión con el proveedor JMS.
mappingAlias Especifica el alias de correlación de JAAS (Java Authentication and Authorization Service) a utilizar cuando se determinan las credenciales relacionadas con la seguridad. Las credenciales relacionadas con la seguridad se utilizan cuando se establece una conexión con el proveedor JMS.
xaRecoveryAuthAlias Especifica el alias de autenticación utilizado durante el proceso de recuperación XA.
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar la fábrica de conexiones.
description Especifica una descripción de la fábrica de conexiones.
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
manageCachedHandles Especifica si el contenedor realiza un seguimiento de los manejadores guardados en la caché, los cuales son manejadores de las variables de instancia de un bean.
clientID Especifica el ID de cliente que sólo es obligatorio para suscripciones duraderas.
NombreUsuario Especifica el nombre de usuario que se utiliza para crear conexiones desde la fábrica de conexiones.
contraseña Especifica la contraseña que se utiliza para crear conexiones desde la fábrica de conexiones.
nonPersistentMapping Especifica valor de correlación no persistente. Los valores válidos son BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent, ReliablePersistent, AssuredPersistent, AsSIBDestination y None.
persistentMapping Especifica un valor de correlación persistente. Los valores válidos son BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent, ReliablePersistent, AssuredPersistent, AsSIBDestination y None.
durableSubscriptionHome Especifica el valor inicial de la suscripción duradera.
readAhead Especifica el valor de lectura anticipada. Los valores válidos son Default, AlwaysOn y AlwaysOff.
target Especifica el nombre de un destino que se resuelve en un grupo de motores de mensajería.
targetType Especifica el tipo del nombre en el parámetro de destino. Los valores válidos son BusMember, Custom y ME.
targetSignificance Especifica la importancia del grupo de destino. Los valores válidos son Preferred y Required.
targetTransportChain Especifica el nombre del protocolo para conectarse a un motor de mensajería remoto.
providerEndPoints Especifica una lista separada por comas de tripletes con el formato host:puerto:cadena.
connectionProximity Especifica la proximidad de los motores de mensajería aceptables. Los valores válidos son Bus, Host, Cluster y Server.
tempQueueNamePrefix Especifica un prefijo de nombre de cola temporal.
tempTopicNamePrefix Especifica un prefijo de nombre de tema temporal.
shareDataSourceWithCMP Especifica cómo se controlan los orígenes de datos que se comparten.
shareDurableSubscriptions Especifica cómo controlar suscripciones duraderas que se comparten. Los valores válidos son InCluster, AlwaysShared y NeverShared.
consumerDoesNotModifyPayloadAfterGet Especifica que cuando una aplicación consumidora de mensajes recibe mensajes de objeto o bytes, el sistema serializa los datos de mensajes sólo cuando sea necesario. La aplicación está conectada al bus mediante esta fábrica de conexiones. Las aplicaciones que obtienen los datos de estos mensajes debe tratar los datos como datos de sólo lectura. Los valores válidos son true y false. El valor predeterminado es false.
producerDoesNotModifyPayloadAfterSet Especifica que cuando una aplicación consumidora de mensajes envía mensajes de objeto o byte, los datos no se copian y el sistema serializa los datos sólo cuando sea necesario. La aplicación está conectada al bus mediante esta fábrica de conexiones. Las aplicaciones que envían estos mensajes no deben modificar los datos hasta que se hayan establecido en un mensaje. Los valores válidos son true y false. El valor predeterminado es false.

Sintaxis

AdminJMS.createSIBJMSQueueConnectionFactory(scope, 
 name, jndiName, 
 busName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createSIBJMSQueueConnectionFactory("myScope", "myName", "myJNDIName", 
"MyBusName")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createSIBJMSQueueConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName" , 
"myJndiName3", "myBusName", "readAhead=AlwaysOff,description=my description")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createSIBJMSQueueConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName" , 
"myJndiName3", "myBusName", [['readAhead', 'AlwaysOff'], ['description', 'my description']])

createWMQQueueConnectionFactory

El script crea una fábrica de conexiones de cola para el proveedor de mensajería de IBM MQ en el ámbito que especifique. El script devuelve el ID de configuración de la fábrica de conexiones de cola de IBM MQ creada.

Para ejecutar el script, especifique los argumentos de ámbito, nombre y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 79. Argumentos para el script createWMQQueueConnectionFactory. Ejecute el script para crear una fábrica de conexiones de cola.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
nombre Especifica el nombre administrativo asignado a esta fábrica de conexiones del proveedor de mensajería de IBM MQ.
jndiName Especifica el nombre y la ubicación que se utiliza para enlazar este objeto en la JNDI de WebSphere Application Server.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 80. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción
maxBatchSize Especifica el número máximo de mensajes que se toman de una cola en un paquete cuando se utiliza la entrega de mensajería asíncrona.
brokerCCSubQueue Especifica el nombre de la cola de la que se recuperan mensajes de suscripciones no duraderas para un consumidor de conexiones. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerCtrlQueue Especifica la cola de control de intermediario que se utiliza si esta fábrica de conexiones se suscribe a un tema. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerQmgr Especifica el nombre del gestor de colas en el que se está ejecutando el gestor de colas. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerSubQueue Especifica la cola para obtener mensajes de suscripción si esta fábrica de conexiones se suscribe a un tema. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerVersion Especifica el nivel de funcionalidad necesario para las operaciones de publicación y suscripción. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerPubQueue Especifica la cola a la que se envían mensajes de publicación cuando se utilizan intermediarios basados en colas. Este parámetro sólo es válido para las fábricas de conexiones de temas.
ccdtQmgrName Especifica un nombre de gestor de colas que se utiliza para seleccionar uno o más entradas de una tabla de definición de canal cliente.
ccdtUrl Especifica un URL a una tabla de definiciones de canal de cliente. Utilice este atributo para esta fábrica de conexiones, cuando se contacta con el proveedor de mensajería de IBM MQ. Las fábricas de conexiones creadas utilizando este atributo son las fábricas de conexiones ccdtURL.
ccsid Especifica el ID de juego de caracteres codificados que se utilizará en las conexiones.
cleanupInterval Especifica el intervalo entre ejecuciones en segundo plano del programa de utilidad de limpieza de publicación y suscripción. Este parámetro sólo es válido para las fábricas de conexiones de temas.
cleanupLevel Especifica el nivel de limpieza para almacenes de suscripciones BROKER o MIGRATE. Este parámetro sólo es válido para las fábricas de conexiones de temas.
clientId Especifica el identificador de cliente utilizado para conexiones iniciadas que utilizan esta fábrica de conexiones.
clonedSubs Especifica si dos o más instancias del mismo suscriptor tema duradero se pueden ejecutar simultáneamente. Este parámetro sólo es válido para las fábricas de conexiones de temas.
compressHeaders Determina si las cabeceras de mensajes se comprimen o no.
compressPayload Determina si las cargas útiles de mensajes se comprimen o no.
containerAuthAlias Especifica un alias de autenticación gestionado por contenedor que tiene las credenciales de seguridad que se utilizan para establecer una conexión con el proveedor de mensajería de IBM MQ.
description Especifica una descripción de la fábrica de conexiones.
failIfQuiescing Especifica el comportamiento de determinadas llamadas al gestor de colas cuando el gestor de colas se coloca en un estado de reposo.
localAddress Especifica uno o los dos los elementos siguientes:
  • La interfaz de red local que se utilizará.
  • El puerto local o un rango de puertos locales que se utilizarán.
mappingAlias Especifica el alias de correlación JAAS a utilizar cuando se determinan las credenciales relacionadas con la seguridad. Las credenciales relacionadas con la seguridad se utilizan cuando se establece una conexión con IBM MQ.
modelQueue Especifica la definición de cola del modelo IBM MQ que se utilizará como base para la creación de destinos temporales JMS. Este parámetro sólo es válido para las fábricas de conexiones de cola.
msgRetention Especifica si el consumidor de conexiones mantiene los mensajes no deseados en la cola de entrada. Si el valor es true, significa que los mantiene. Si el valor es false significa que los mensajes se descartan en función de sus opciones de disposición. Este parámetro sólo es válido para las fábricas de conexiones de cola.
msgSelection Especifica dónde se produce la selección de mensaje. Este parámetro sólo es válido para las fábricas de conexiones de temas.
pollingInterval Especifica en milisegundos el tiempo máximo que transcurre durante un intervalo de sondeo. Si un escucha de mensajes de una sesión no tiene ningún mensaje apropiado en su cola, el escucha de mensajes utiliza el intervalo de sondeo para determinar con qué frecuencia sondea la cola en busca de un mensaje. Aumente el valor de esta propiedad si frecuentemente las sesiones no tienen un mensaje adecuado disponible. Este atributo sólo se puede aplicar en el contenedor de cliente.
providerVersion Especifica la versión mínima y las capacidades del gestor de colas.
pubAckInterval Especifica el número de publicaciones que se envían a un intermediario basado en cola antes de enviar una publicación que solicita un reconocimiento. Este atributo sólo es válido para las fábricas de conexiones de temas.
qmgrHostname Especifica el nombre de host que utiliza esta fábrica de conexiones cuando intenta una conexión de nodo cliente con IBM MQ.
qmgrName Especifica el nombre del gestor de colas que esta fábrica de conexiones utiliza cuando contacta con el proveedor de mensajería de IBM MQ. Las fábricas de conexiones creadas utilizando este parámetro son las fábricas de conexiones definidas por el usuario.
qmgrPortNumber Especifica el número de puerto que utiliza esta fábrica de conexiones cuando intenta una conexión de nodo cliente con IBM MQ.
qmgrSvrconnChannel Especifica el canal SVRCONN que se utiliza para la conexión con IBM MQ. Las fábricas de conexiones creadas utilizando este parámetro son las fábricas de conexiones definidas por el usuario.
rcvExitInitData Especifica los datos de inicialización que se han de pasar a la salida de recepción.
rcvExit Especifica una lista separada por comas de nombres de clase de salida de recepción.
replyWithRFH2 Especifica si se incluye en la respuesta de un mensaje, una cabecera RFH versión 2 en el mensaje de respuesta. Este parámetro sólo es válido para las fábricas de conexiones de cola.
rescanInterval Especifica en milisegundos el tiempo máximo que transcurre durante un intervalo de exploración. Cuando un consumidor de mensajes del dominio punto a punto utiliza un selector de mensajes para seleccionar qué mensajes desea recibir, el cliente JMS de IBM MQ busca en la cola IBM MQ los mensajes adecuados en la secuencia determinada por el atributo MsgDeliverySequence de la cola. Cuando el cliente encuentra un mensaje adecuado y lo entrega al consumidor, el cliente reanuda la búsqueda del siguiente mensaje adecuado desde su posición actual en la cola. El cliente continúa buscando la cola hasta que llega al final de la cola o hasta que el intervalo de tiempo especificado por esta propiedad ha caducado. En cada caso, el cliente vuelve al principio de la cola para seguir su búsqueda y se inicia un intervalo de tiempo nuevo. Este parámetro sólo es válido para las fábricas de conexiones de cola.
secExitInitData Especifica datos de inicialización que se pasan a la salida de seguridad.
secExit Especifica una lista separada por comas de nombres de clase de salida de seguridad.
sendExitInitData Especifica datos de inicialización que se pasan a la salida de envío.
sendExit Especifica una lista separada por comas de nombres de clase de salida de envío.
sparseSubs Especifica la política de recuperación de mensajes de un objeto TopicSubscriber. Este parámetro sólo es válido para las fábricas de conexiones de tema.
sslConfiguration Especifica una configuración SSL (Secure Sockets Layer) específica para proteger las conexiones de red con el gestor de colas.
sslCrl Especifica una lista de servidores LDAP que se pueden utilizar para proporcionar información de revocación de certificados si esta fábrica de conexiones establece una conexión SSL con IBM MQ.
sslPeerName Especifica un nombre de igual que coincide con el nombre distinguido en el certificado de igual. Este atributo se utiliza cuando la fábrica de conexiones establece una conexión SSL con el gestor de colas.
sslResetCount Especifica el número de bytes que se han de transferir antes de restablecer la clave de cifrado simétrica utilizada para la sesión SSL. Este atributo se utiliza cuando la fábrica de conexiones establece una conexión SSL con el gestor de colas.
sslType Especifica la configuración, si la hay, cuando la fábrica de conexiones establece una conexión SSL con el gestor de colas.
stateRefreshInt Especifica en milisegundos el tiempo máximo que transcurre entre renovaciones de la transacción de larga ejecución que detecta cuando un suscriptor pierde su conexión con el gestor de colas. Esta propiedad sólo es relevante si el atributo subStore tiene el valor QUEUE. Este atributo sólo es válido para las fábricas de conexiones de temas.
subStore Especifica que IBM MQ JMS almacena datos persistentes relacionados con las suscripciones activas. Este atributo sólo es válido para las fábricas de conexiones de temas.
support2PCProtocol Especifica si la fábrica de conexiones actúa como un recurso capaz de participar en el proceso de compromiso en dos fases distribuido.
tempQueuePrefix Especifica el prefijo que se aplica a las colas temporales de IBM MQ. Estas colas temporales representan destinos de tipo de cola temporal de JMS. Este atributo sólo es válido para las fábricas de conexiones de cola.
tempTopicPrefix Especifica el prefijo que se aplica a los temas temporales de IBM MQ. Estos temas temporales representan los destinos de tipos de temas temporales de JMS. Este atributo sólo es válido para las fábricas de conexiones de temas.
wildcardFormat Especifica qué conjuntos de caracteres se interpretan como comodines de temas. Este atributo sólo es válido para las fábricas de conexiones de temas.
wmqTransportType Especifica cómo se conecta esta fábrica de conexiones con IBM MQ. Las fábricas de conexiones creadas utilizando este atributo están definidas por el usuario. Los valores válidos son BINDINGS, BINDINGS_THEN_CLIENT y CLIENT.
xaRecoveryAuthAlias Especifica el alias de autenticación para conectarse con IBM MQ para la recuperación XA.

Sintaxis

AdminJMS.createWMQQueueConnectionFactory(scope, 
 name, jndiName, 
 attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWMQQueueConnectionFactory("myScope",
"myName", "myJNDIName")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWMQQueueConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName
" , "myJndiName4", "maxBatchSize=15,description=my description")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWMQQueueConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName4", [['maxBatchSize', '15'], ['description', 'my description']])

createSIBJMSTopicConnectionFactory

El script crea una nueva fábrica de conexiones de temas SIB JMS para el proveedor de mensajería predeterminado en el ámbito que especifique. El script devuelve el ID de configuración de la fábrica de conexiones de temas SIB JMS creada.

Para ejecutar el script, especifique los argumentos de ámbito, nombre, nombre JNDI y nombre de bus. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 81. Argumentos para el script createSIBJMSTopicConnectionFactory. Ejecute el script para crear una fábrica de conexiones de tema JMS DE SIB.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
nombre Especifica el nombre administrativo asignado a esta fábrica de conexiones.
jndiName Especifica el nombre de JNDI que se especifica en los enlaces para los beans controlados por mensajes asociados a esta fábrica de conexiones.
NombreBus Especifica el nombre del bus de integración de servicio con el que se realizan las conexiones.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 82. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción
authDataAlias Especifica el ID de usuario y contraseña que se utilizarán para autenticar las conexiones con el proveedor de JMS para la autenticación gestionada por aplicaciones.
containerAuthAlias Especifica un alias de autenticación gestionada por contenedor, desde el que se utilizan las credenciales de seguridad para establecer una conexión con el proveedor JMS.
mappingAlias Especifica el alias de correlación de JAAS (Java Authentication and Authorization Service) a utilizar cuando se determinan las credenciales relacionadas con la seguridad. Las credenciales relacionadas con la seguridad se utilizan cuando se establece una conexión con el proveedor JMS.
xaRecoveryAuthAlias Especifica el alias de autenticación utilizado durante el proceso de recuperación XA.
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar la fábrica de conexiones.
description Especifica una descripción de la fábrica de conexiones.
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
manageCachedHandles Especifica si el contenedor realiza un seguimiento de los manejadores guardados en la caché, los cuales son manejadores de las variables de instancia de un bean.
clientID Especifica el ID de cliente que sólo es obligatorio para suscripciones duraderas.
NombreUsuario Especifica el nombre de usuario que se utiliza para crear conexiones desde la fábrica de conexiones.
contraseña Especifica la contraseña que se utiliza para crear conexiones desde la fábrica de conexiones.
nonPersistentMapping Especifica valor de correlación no persistente. Los valores válidos son BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent, ReliablePersistent, AssuredPersistent, AsSIBDestination y None.
persistentMapping Especifica un valor de correlación persistente. Los valores válidos son BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent, ReliablePersistent, AssuredPersistent, AsSIBDestination y None.
durableSubscriptionHome Especifica el valor inicial de la suscripción duradera.
readAhead Especifica el valor de lectura anticipada. Los valores válidos son Default, AlwaysOn y AlwaysOff.
target Especifica el nombre de un destino que se resuelve en un grupo de motores de mensajería.
targetType Especifica el tipo del nombre en el parámetro de destino. Los valores válidos son BusMember, Custom y ME.
targetSignificance Especifica la importancia del grupo de destino. Los valores válidos son Preferred y Required.
targetTransportChain Especifica el nombre del protocolo para conectarse a un motor de mensajería remoto.
providerEndPoints Especifica una lista separada por comas de tripletes con el formato host:puerto:cadena.
connectionProximity Especifica la proximidad de los motores de mensajería aceptables. Los valores válidos son Bus, Host, Cluster y Server.
tempQueueNamePrefix Especifica un prefijo de nombre de cola temporal.
tempTopicNamePrefix Especifica un prefijo de nombre de tema temporal.
shareDataSourceWithCMP Especifica cómo se controlan los orígenes de datos que se comparten.
shareDurableSubscriptions Especifica cómo controlar suscripciones duraderas que se comparten. Los valores válidos son InCluster, AlwaysShared y NeverShared.
consumerDoesNotModifyPayloadAfterGet Especifica que cuando una aplicación consumidora de mensajes recibe mensajes de objeto o bytes, el sistema serializa los datos de mensajes sólo cuando sea necesario. La aplicación está conectada al bus mediante esta fábrica de conexiones. Las aplicaciones que obtienen los datos de estos mensajes debe tratar los datos como datos de sólo lectura. Los valores válidos son true y false. El valor predeterminado es false.
producerDoesNotModifyPayloadAfterSet Especifica que cuando una aplicación consumidora de mensajes envía mensajes de objeto o byte, los datos no se copian y el sistema serializa los datos sólo cuando sea necesario. La aplicación está conectada al bus mediante esta fábrica de conexiones. Las aplicaciones que envían estos mensajes no deben modificar los datos hasta que se hayan establecido en un mensaje. Los valores válidos son true y false. El valor predeterminado es false.

Sintaxis

AdminJMS.createSIBJMSTopicConnectionFactory(scope, 
 name, jndiName, 
 busName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createSIBJMSTopicConnectionFactory("myScope", "myName", "myJNDIName", 
"MyBusName")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createSIBJMSTopicConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName5", "myBusName", "readAhead=AlwaysOff,description=my description")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createSIBJMSTopicConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName5", "myBusName", [['readAhead', 'AlwaysOff'], ['description', 'my description']])

createWMQTopicConnectionFactory

El script crea una fábrica de conexiones de tema para el proveedor de mensajería de IBM MQ en el ámbito que especifique. El script devuelve el ID de configuración de la fábrica de conexiones de tema de IBM MQ creada.

Para ejecutar el script, especifique los argumentos de ámbito, nombre y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 83. Argumentos para el script createWMQTopicConnectionFactory. Ejecute el script para crear una fábrica de conexiones de tema.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS.
nombre Especifica el nombre administrativo asignado a esta fábrica de conexiones del proveedor de mensajería de IBM MQ.
jndiName Especifica el nombre y la ubicación que se utiliza para enlazar este objeto en la JNDI de WebSphere Application Server.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 84. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción
maxBatchSize Especifica el número máximo de mensajes que se toman de una cola en un paquete cuando se utiliza la entrega de mensajería asíncrona.
brokerCCSubQueue Especifica el nombre de la cola de la que se recuperan mensajes de suscripciones no duraderas para un consumidor de conexiones. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerCtrlQueue Especifica la cola de control de intermediario que se utiliza si esta fábrica de conexiones se suscribe a un tema. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerQmgr Especifica el nombre del gestor de colas en el que se está ejecutando el gestor de colas. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerSubQueue Especifica la cola para obtener mensajes de suscripción si esta fábrica de conexiones se suscribe a un tema. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerVersion Especifica el nivel de funcionalidad necesario para las operaciones de publicación y suscripción. Este parámetro sólo es válido para las fábricas de conexiones de temas.
brokerPubQueue Especifica la cola a la que se envían mensajes de publicación cuando se utilizan intermediarios basados en colas. Este parámetro sólo es válido para las fábricas de conexiones de temas.
ccdtQmgrName Especifica un nombre de gestor de colas que se utiliza para seleccionar uno o más entradas de una tabla de definición de canal cliente.
ccdtUrl Especifica un URL a una tabla de definiciones de canal de cliente. Utilice este atributo para esta fábrica de conexiones, cuando se contacta con el proveedor de mensajería de IBM MQ. Las fábricas de conexiones creadas utilizando este atributo son las fábricas de conexiones ccdtURL.
ccsid Especifica el ID de juego de caracteres codificados que se utilizará en las conexiones.
cleanupInterval Especifica el intervalo entre ejecuciones en segundo plano del programa de utilidad de limpieza de publicación y suscripción. Este parámetro sólo es válido para las fábricas de conexiones de temas.
cleanupLevel Especifica el nivel de limpieza para almacenes de suscripciones BROKER o MIGRATE. Este parámetro sólo es válido para las fábricas de conexiones de temas.
clientId Especifica el identificador de cliente utilizado para conexiones iniciadas que utilizan esta fábrica de conexiones.
clonedSubs Especifica si dos o más instancias del mismo suscriptor tema duradero se pueden ejecutar simultáneamente. Este parámetro sólo es válido para las fábricas de conexiones de temas.
compressHeaders Determina si las cabeceras de mensajes se comprimen o no.
compressPayload Determina si las cargas útiles de mensajes se comprimen o no.
containerAuthAlias Especifica un alias de autenticación gestionado por contenedor que tiene las credenciales de seguridad que se utilizan para establecer una conexión con el proveedor de mensajería de IBM MQ.
description Especifica una descripción de la fábrica de conexiones.
failIfQuiescing Especifica el comportamiento de determinadas llamadas al gestor de colas cuando el gestor de colas se coloca en un estado de reposo.
localAddress Especifica uno o los dos los elementos siguientes:
  • La interfaz de red local que se utilizará.
  • El puerto local o un rango de puertos locales que se utilizarán.
mappingAlias Especifica el alias de correlación JAAS a utilizar cuando se determinan las credenciales relacionadas con la seguridad. Las credenciales relacionadas con la seguridad se utilizan cuando se establece una conexión con IBM MQ.
modelQueue Especifica la definición de cola del modelo IBM MQ que se utilizará como base para la creación de destinos temporales JMS. Este parámetro sólo es válido para las fábricas de conexiones de cola.
msgRetention Especifica si el consumidor de conexiones mantiene los mensajes no deseados en la cola de entrada. Si el valor es true, significa que los mantiene. Si el valor es false significa que los mensajes se descartan en función de sus opciones de disposición. Este parámetro sólo es válido para las fábricas de conexiones de cola.
msgSelection Especifica dónde se produce la selección de mensaje. Este parámetro sólo es válido para las fábricas de conexiones de temas.
pollingInterval Especifica en milisegundos el tiempo máximo que transcurre durante un intervalo de sondeo. Si un escucha de mensajes de una sesión no tiene ningún mensaje apropiado en su cola, el escucha de mensajes utiliza el intervalo de sondeo para determinar con qué frecuencia sondea la cola en busca de un mensaje. Aumente el valor de esta propiedad si frecuentemente las sesiones no tienen un mensaje adecuado disponible. Este atributo sólo se puede aplicar en el contenedor de cliente.
providerVersion Especifica la versión mínima y las capacidades del gestor de colas.
pubAckInterval Especifica el número de publicaciones que se envían a un intermediario basado en cola antes de enviar una publicación que solicita un reconocimiento. Este atributo sólo es válido para las fábricas de conexiones de temas.
qmgrHostname Especifica el nombre de host que utiliza esta fábrica de conexiones cuando intenta una conexión de nodo cliente con IBM MQ.
qmgrName Especifica el nombre del gestor de colas que esta fábrica de conexiones utiliza cuando contacta con el proveedor de mensajería de IBM MQ. Las fábricas de conexiones creadas utilizando este parámetro son las fábricas de conexiones definidas por el usuario.
qmgrPortNumber Especifica el número de puerto que utiliza esta fábrica de conexiones cuando intenta una conexión de nodo cliente con IBM MQ.
qmgrSvrconnChannel Especifica el canal SVRCONN que se utiliza para la conexión con IBM MQ. Las fábricas de conexiones creadas utilizando este parámetro son las fábricas de conexiones definidas por el usuario.
rcvExitInitData Especifica los datos de inicialización que se han de pasar a la salida de recepción.
rcvExit Especifica una lista separada por comas de nombres de clase de salida de recepción.
replyWithRFH2 Especifica si se incluye en la respuesta de un mensaje, una cabecera RFH versión 2 en el mensaje de respuesta. Este parámetro sólo es válido para las fábricas de conexiones de cola.
rescanInterval Especifica en milisegundos el tiempo máximo que transcurre durante un intervalo de exploración. Cuando un consumidor de mensajes del dominio punto a punto utiliza un selector de mensajes para seleccionar qué mensajes desea recibir, el cliente JMS de IBM MQ busca en la cola IBM MQ los mensajes adecuados en la secuencia determinada por el atributo MsgDeliverySequence de la cola. Cuando el cliente encuentra un mensaje adecuado y lo entrega al consumidor, el cliente reanuda la búsqueda del siguiente mensaje adecuado desde su posición actual en la cola. El cliente continúa buscando la cola hasta que llega al final de la cola o hasta que el intervalo de tiempo especificado por esta propiedad ha caducado. En cada caso, el cliente vuelve al principio de la cola para seguir su búsqueda y se inicia un intervalo de tiempo nuevo. Este parámetro sólo es válido para las fábricas de conexiones de cola.
secExitInitData Especifica datos de inicialización que se pasan a la salida de seguridad.
secExit Especifica una lista separada por comas de nombres de clase de salida de seguridad.
sendExitInitData Especifica datos de inicialización que se pasan a la salida de envío.
sendExit Especifica una lista separada por comas de nombres de clase de salida de envío.
sparseSubs Especifica la política de recuperación de mensajes de un objeto TopicSubscriber. Este parámetro sólo es válido para las fábricas de conexiones de tema.
sslConfiguration Especifica una configuración SSL (Secure Sockets Layer) específica para proteger las conexiones de red con el gestor de colas.
sslCrl Especifica una lista de servidores LDAP que se pueden utilizar para proporcionar información de revocación de certificados si esta fábrica de conexiones establece una conexión SSL con IBM MQ.
sslPeerName Especifica un nombre de igual que coincide con el nombre distinguido en el certificado de igual. Este atributo se utiliza cuando la fábrica de conexiones establece una conexión SSL con el gestor de colas.
sslResetCount Especifica el número de bytes que se han de transferir antes de restablecer la clave de cifrado simétrica utilizada para la sesión SSL. Este atributo se utiliza cuando la fábrica de conexiones establece una conexión SSL con el gestor de colas.
sslType Especifica la configuración, si la hay, cuando la fábrica de conexiones establece una conexión SSL con el gestor de colas.
stateRefreshInt Especifica en milisegundos el tiempo máximo que transcurre entre renovaciones de la transacción de larga ejecución que detecta cuando un suscriptor pierde su conexión con el gestor de colas. Esta propiedad sólo es relevante si el atributo subStore tiene el valor QUEUE. Este atributo sólo es válido para las fábricas de conexiones de temas.
subStore Especifica que IBM MQ JMS almacena datos persistentes relacionados con las suscripciones activas. Este atributo sólo es válido para las fábricas de conexiones de temas.
support2PCProtocol Especifica si la fábrica de conexiones actúa como un recurso capaz de participar en el proceso de compromiso en dos fases distribuido.
tempQueuePrefix Especifica el prefijo que se aplica a las colas temporales de IBM MQ. Estas colas temporales representan destinos de tipo de cola temporal de JMS. Este atributo sólo es válido para las fábricas de conexiones de cola.
tempTopicPrefix Especifica el prefijo que se aplica a los temas temporales de IBM MQ. Estos temas temporales representan los destinos de tipos de temas temporales de JMS. Este atributo sólo es válido para las fábricas de conexiones de temas.
wildcardFormat Especifica qué conjuntos de caracteres se interpretan como comodines de temas. Este atributo sólo es válido para las fábricas de conexiones de temas.
wmqTransportType Especifica cómo se conecta esta fábrica de conexiones con IBM MQ. Las fábricas de conexiones creadas utilizando este atributo están definidas por el usuario. Los valores válidos son BINDINGS, BINDINGS_THEN_CLIENT y CLIENT.
xaRecoveryAuthAlias Especifica el alias de autenticación para conectarse con IBM MQ para la recuperación XA.

Sintaxis

AdminJMS.createWMQTopicConnectionFactory(scope, 
 name, jndiName, 
 attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createWMQTopicConnectionFactory("myScope",
"myName", "myJNDIName")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWMQTopicConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName6", "maxBatchSize=15,description=my description")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWMQTopicConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName6", [['maxBatchSize', '15'], ['description', 'my description']])

createSIBJMSActivationSpec

Este script crear una nueva especificación de activación JMS para el proveedor de mensajería predeterminado en el ámbito que especifique. El script devuelve el ID de configuración de la especificación de activación SIB JMS creada.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de especificación de activación, nombre JNDI y destino de nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 85. Argumentos del script createSIBJMSActivationSpec. Ejecute el script para crear una especificación de activación JMS.
Argumento Descripción
scope Especifica el ámbito de célula, nodo, servidor o clúster para el proveedor de mensajería predeterminado en el que se va a crear la especificación de activación JMS.
nombre Especifica el nombre asignado a esta especificación de activación.
jndiName Especifica el nombre de JNDI que se especifica en los enlaces para los beans controlados por mensajes asociados a esta especificación de activación.
destinationJndiName Especifica el nombre JNDI de la cola o tema JMS de destino que utiliza el bean controlado por mensajes.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 86. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción
description Especifica la especificación de activación JMS que el proveedor de mensajería predeterminado utiliza para validar las propiedades de configuración de activación para un bean controlado por mensajes (MDB) JMS.
acknowledgeMode Especifica cómo reconoce la sesión los mensajes que recibe.
authenticationAlias Especifica el nombre de un alias de autenticación J2C utilizado para la autenticación gestionada por componentes de conexiones con el bus de integración de servicios.
NombreBus Especifica el nombre del bus de integración de servicio con el que se realizan las conexiones.
clientId Especifica el identificador de cliente JMS. El identificador de cliente es necesario para suscripciones de tema duraderas.
destinationType Especifica si el bean controlado por mensajes utiliza un destino de cola o de tema.
durableSubscriptionHome Especifica el nombre del inicio de suscripciones duraderas. Este atributo identifica el motor de mensajería donde se gestionan todas las suscripciones duraderas a las que se accede mediante esta especificación de activación.
maxBatchSize Especifica el número máximo de mensajes recibidos del motor de mensajería en un solo proceso por lotes.
maxConcurrency Especifica el número máximo de puntos finales a los que se entregan mensajes simultáneamente.
messageSelector Especifica el selector de mensajes JMS utilizado para determinar qué mensajes recibe el bean controlado por mensajes (MDB).
contraseña Especifica la contraseña para la seguridad del conector Java 2 que se debe utilizar.
subscriptionDurability Especifica si una suscripción de tema JMS es duradera o no.
subscriptionName Especifica el nombre de suscripción necesario para suscripciones de tema duraderas.
shareDurableSubscriptions Especifica cómo se comparten las suscripciones duraderas.
NombreUsuario Especifica la identidad de usuario que se ha utilizar para la seguridad del conector Java 2.
readAhead Especifica el valor de lectura anticipada. Los valores válidos son Default, AlwaysOn y AlwaysOff.
target Especifica el valor de destino nuevo de la especificación de activación SIB JMS.
targetType Especifica el valor de destino nuevo de la especificación de activación SIB JMS. Los valores válidos son BusMember, Custom y ME.
targetSignificance Especifica la importancia del grupo de destino.
targetTransportChain Especifica el nombre del protocolo que ha utilizado para conectarse a un motor de mensajería remoto.
providerEndPoints Especifica una lista separada por comas de tripletes con el formato host:puerto:cadena.
shareDataSourceWithCMP Especifica cómo se comparten los orígenes de datos.
consumerDoesNotModifyPayloadAfterGet Especifica que, una vez habilitada, el sistema sólo serializa los datos de los mensajes de objetos recibidos mediante esta especificación cuando es necesario. Las aplicaciones que obtienen datos de estos mensajes se deben tratar como de sólo lectura. Los valores válidos son true y false. El valor por omisión es false.
forwarderDoesNotModifyPayloadAfterSet Especifica que, cuando está habilitada, los mensajes de objetos y bytes reenviados a través de esta especificación de activación que tiene su carga útil modificada no hará que se copien los datos cuando los datos se envíen en el mensaje. El sistema serializa los datos de mensajes sólo cuando es necesario. Las aplicaciones que envían estos mensajes no deben modificar los datos una vez enviados en el mensaje. Los valores válidos son true y false. El valor por omisión es false.
alwaysActivateAllMDBs Especifica la regla de selección de servidor MDB. La regla determina qué servidores pueden dirigir los MDB desplegados en los mismos. Los valores válidos son true y false. El valor predeterminado es false. Especifique true para activar los MDB en todos los servidores. De lo contrario, sólo se utilizarán los servidores con un motor de mensajería en ejecución.
retryInterval Especifica el retardo en segundos entre intentos de conectar a un motor de mensajería, tanto en la conexión inicial como en intentos posteriores de establecer una conexión mejor. El valor predeterminado es 30. El retardo debe ser mayor que cero.
autoStopSequentialMessageFailure Especifica que el punto final se detiene cuando el número de mensajes anómalos secuenciales alcance el límite configurado. Debido a las dependencias de procesos del MDB, el número real de mensajes procesados puede superar este valor.
failingMessageDelay Especifica el período de tiempo que pasa antes de que un mensaje se pueda reintentar. Un mensaje se reintenta cuando el MDB no puede procesarlo, pero el mensaje no ha llegado a su límite máximo de entregas anómalas. Durante este periodo pueden intentarse otros mensajes, a menos que el umbral de anomalías secuenciales y la simultaneidad máxima estén establecidos en 1.

Sintaxis

AdminJMS.createSIBJMSActivationSpec(scope, 
 name, jndiName, 
 destinationJndiName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createSIBJMSActivationSpec("myScope", "myName", 
 "myJNDIName", "myDestinationName")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createSIBJMSActivationSpec(
"server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName11", "myDestinationJndiName11", "readAhead=AlwaysOff,maxBatchSize=54")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createSIBJMSActivationSpec
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName11", "myDestinationJndiName11", [['readAhead', 'AlwaysOff'], ['maxBatchSize', '54']])

createWMQActivationSpec

Este script crea una especificación de activación nueva para el proveedor de mensajería de IBM MQ en el ámbito que especifique. El script devuelve el ID de configuración de la especificación de activación IBM MQ creada.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de especificación de activación, nombre JNDI y destino de nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 87. Argumentos para el script createWMQActivationSpec. Ejecute el script para crear una especificación de activación.
Argumento Descripción
scope Especifica un ámbito de célula, nodo, servidor o clúster para la especificación de activación del proveedor de mensajería de IBM MQ.
nombre Especifica el nombre asignado a esta especificación de activación.
jndiName Especifica el nombre y la ubicación que se utiliza para enlazar este objeto en la JNDI de WebSphere Application Server.
destinationJndiName Especifica el nombre JNDI de una cola del proveedor de mensajería de IBM MQ o destino de tipo de cola. Si se despliega un MDB con esta especificación de activación, los mensajes para el MDB se consumen desde este destino.
destinationType Especifica el tipo de destino. Los valores válidos son javax.jms.Queue y javax.jms.Topic. El argumento no tiene valor predeterminado.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 88. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción
authAlias Especifica el alias de autenticación utilizado para obtener las credenciales que esta especificación de activación necesita para establecer una conexión con IBM MQ.
brokerCCDurSubQueue Especifica el nombre de la cola desde la que un consumidor de conexión recibe mensajes de suscripciones duraderas.
brokerCCSubQueue Especifica el nombre de la cola de la que se recuperan mensajes de suscripciones no duraderas para un consumidor de conexiones.
brokerCtrlQueue Especifica la cola de control de intermediario que se utiliza cuando esta especificación de activación se suscribe a un tema.
brokerQmgr Especifica el nombre del gestor de colas en el que se está ejecutando el intermediario.
brokerSubQueue Especifica la cola para obtener mensajes de suscripción si esta activación se suscribe a un tema.
brokerVersion Especifica el nivel de funcionalidad necesario para las operaciones de publicación y suscripción.
ccdtQmgrName Especifica el nombre del gestor de colas que selecciona una o más entradas de una tabla de definiciones de canales de cliente.
ccdtUrl Especifica el URL para la tabla de definiciones de canales de cliente. Utilice este atributo para esta especificación de activación cuando contacte con IBM MQ. Las especificaciones de activación creadas utilizando este atributo son las especificaciones de activación ccdtURL.
ccsid Especifica el ID del juego de caracteres codificado utilizado en las conexiones.
cleanupInterval Especifica el intervalo entre ejecuciones en segundo plano del programa de utilidad de limpieza de publicación y suscripción.
cleanupLevel Especifica el nivel de limpieza para almacenes de suscripciones de intermediarios o de migración.
clientId Especifica el identificador de cliente para conexiones iniciadas con esta especificación de activación.
clonedSubs Especifica si dos o más instancias del mismo suscriptor tema duradero se pueden ejecutar simultáneamente.
compressHeaders Especifica si las cabeceras de mensajes están comprimidas.
compressPayload Especifica si se comprimen las cargas útiles de mensajes.
description Especifica una descripción administrativa asignada a la especificación de activación.
failIfQuiescing Especifica el comportamiento de determinadas llamadas al gestor de colas cuando el gestor de colas se coloca en un estado de reposo.
failureDeliveryCount Especifica el número de anomalías de entrega secuenciales que se permiten antes de que se suspenda el punto final.
maxPoolSize Especifica el número máximo de sesiones de servidor de la agrupación de sesiones de servidor utilizado por el consumidor de conexión.
messageSelector Especifica qué mensajes se entregan.
msgRetention Especifica si el consumidor de conexiones mantiene los mensajes no deseados en la cola de entrada. Si el valor es true, significa que los mantiene. Un valor de false significa que los mensajes se descartan en función de las opciones de disposición.
msgSelection Especifica dónde se produce la selección de mensaje.
poolTimeout Especifica el período de tiempo, en milisegundos, que se mantiene abierta una sesión de servidor inactiva en la agrupación de sesiones de servidor antes de que se cierre por la inactividad.
providerVersion Especifica la versión mínima y las capacidades del gestor de colas.
qmgrHostname Especifica el nombre de host que se utilizará para esta especificación de activación cuando se intenta una conexión en modalidad de cliente con IBM MQ.
qmgrName Especifica el nombre del gestor de colas para esta especificación de activación, cuando contacta con IBM MQ. Las especificaciones de activación creadas mediante este atributo están definidas por el usuario.
qmgrPortNumber Especifica el número de puerto para esta especificación de activación cuando se intenta una conexión en modalidad de cliente con IBM MQ.
qmgrSvrconnChannel Especifica el canal SVRCONN que se utiliza para la conexión con IBM MQ. Las especificaciones de activación creadas mediante este atributo están definidas por el usuario.
rcvExitInitData Especifica los datos de inicialización que se han de pasar a la salida de recepción.
rcvExit Especifica una lista separada por comas de nombres de clase de salida de recepción.
rescanInterval Especifica en milisegundos el tiempo máximo que transcurre durante un intervalo de exploración. Cuando un consumidor de mensajes del dominio punto a punto utiliza un selector de mensajes para seleccionar qué mensajes desea recibir, el cliente JMS de IBM MQ busca en la cola IBM MQ los mensajes adecuados en la secuencia determinada por el atributo MsgDeliverySequence de la cola. Cuando el cliente encuentra un mensaje adecuado y lo entrega al consumidor, el cliente reanuda la búsqueda del siguiente mensaje adecuado desde su posición actual en la cola. El cliente continúa buscando la cola hasta que llega al final de la cola o hasta que el intervalo de tiempo especificado por esta propiedad ha caducado. En cada caso, el cliente vuelve al principio de la cola para seguir su búsqueda y se inicia un intervalo de tiempo nuevo.
secExitInitData Especifica datos de inicialización que se pasan a la salida de seguridad.
secExit Especifica un nombre de clase de salida de seguridad.
sendExitInitData Especifica datos de inicialización que se pasan a la salida de envío.
sendExit Especifica una lista separada por comas de nombres de clase para la salida de envío.
sparseSubs Especifica la política de recuperación de mensajes de un objeto de suscriptor de temas.
sslConfiguration Especifica la configuración SSL utilizada para proteger las conexiones de red con el gestor de colas.
sslCrl Especifica una lista de servidores LDAP que se pueden utilizar para proporcionar información de revocación de certificados si esta especificación de activación establece una conexión SSL con IBM MQ.
sslPeerName Especifica un valor con el que comparar el nombre distinguido del certificado de igual. Este atributo se utiliza cuando la especificación de activación establece una conexión SSL con el gestor de colas.
sslResetCount Especifica el número de bytes que se han de transferir antes de restablecer la clave de cifrado simétrica utilizada para la sesión SSL. Este atributo se utiliza cuando la especificación de activación establece una conexión SSL con el gestor de colas.
sslType Especifica la configuración SSL para la conexión de red con el gestor de colas.
startTimeout Especifica el periodo de tiempo en milisegundos en que la entrega de un mensaje a un MDB deben iniciarse una vez planificado el trabajo de entrega del mensaje. Si transcurre este periodo de tiempo, el mensaje se devuelve a la cola.
stateRefreshInt Especifica en milisegundos el intervalo entre renovaciones de la transacción de larga ejecución que detecta cuándo un suscriptor pierde su conexión con el gestor de colas. Este atributo sólo es relevante si el atributo subStore tiene el valor QUEUE.
stopEndpointIfDeliveryFails Especifica si el punto final se detiene si la entrega de mensajes falla el número de veces especificado por el atributo failureDeliveryCount.
subscriptionDurability Especifica si se utiliza una suscripción duradera o no duradera para entregar los mensajes a un MDB suscrito al tema.
subscriptionName Especifica el nombre de la suscripción duradera.
subStore Especifica donde almacena IBM MQ JMS datos persistentes relacionados con las suscripciones activas.
wildcardFormat Especifica qué conjuntos de caracteres se interpretan como comodines de temas.
wmqTransportType Especifica de qué modo se establece una conexión con IBM MQ para esta especificación de activación. Las especificaciones de activación creadas mediante este atributo están definidas por el usuario. Los valores válidos son BINDINGS, BINDINGS_THEN_CLIENT y CLIENT.
localAddress Especifica una o las dos opciones siguientes:
  • La interfaz de red local que se va a utilizar
  • El puerto local o un rango de puertos locales que se utilizará

Sintaxis

AdminJMS.createSIBJMSActivationSpec(scope,name, jndiName, 
 destinationJndiName, destinationType,attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJMS.createSIBJMSActivationSpec("myScope", "myName", 
 "myJNDIName", "myDestinationName", "myDestinationType")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJMS.createWMQActivationSpec
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName12", "myDestinationJndiName12", "javax.jms.Topic", "poolTimeout=2222,startTimeout=9999")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJMS.createWMQActivationSpec
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName12", "myDestinationJndiName12", "javax.jms.Topic", [['poolTimeout', '2222'], 
['startTimeout', '9999']])

startListenerPort

Este script inicia un puerto de escucha en el entorno. El script devuelve un valor de 1 si el sistema inicia correctamente el puerto de escucha o un valor de -1 si el sistema no inicia el puerto de escucha.

Para ejecutar el script, especifique los argumentos de nombre de nodo y nombre de servidor, como se define en la tabla siguiente:
Tabla 89. Argumentos del script startListenerPort. Ejecute el script para crear un puerto de escucha.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.

Sintaxis

AdminJMS.startListenerPort(nodeName, 
 serverName)

Ejemplo de uso

AdminJMS.startListenerPort("myNode", "myServer")

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7adminjms
File name: rxml_7adminjms.html