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.

- createGenericJMSConnectionFactory
- createGenericJMSConnectionFactoryUsingTemplate
- createGenericJMSConnectionFactoryAtScope
- createGenericJMSConnectionFactoryUsingTemplateAtScope
- createGenericJMSDestination
- createGenericJMSDestinationUsingTemplate
- createGenericJMSDestinationAtScope
- createGenericJMSDestinationUsingTemplateAtScope
- createJMSProvider
- createJMSProviderUsingTemplate
- createJMSProviderAtScope
- createJMSProviderUsingTemplateAtScope
- createWASQueue
- createWASQueueUsingTemplate
- createWASQueueAtScope
- createWASQueueUsingTemplateAtScope
- createSIBJMSQueue
- createWMQQueue
- createWASQueueConnectionFactory
- createWASQueueConnectionFactoryUsingTemplate
- createWASQueueConnectionFactoryAtScope
- createWASQueueConnectionFactoryUsingTemplateAtScope
- createWASTopic
- createWASTopicUsingTemplate
- createWASTopicAtScope
- createWASTopicUsingTemplateAtScope
- createSIBJMSTopic
- createWMQTopic
- createWASTopicConnectionFactory
- createWASTopicConnectionFactoryUsingTemplate
- createWASTopicConnectionFactoryAtScope
- createWASTopicConnectionFactoryUsingTemplateAtScope
- createSIBJMSConnectionFactory
- createWMQConnectionFactory
- createSIBJMSQueueConnectionFactory
- createWMQQueueConnectionFactory
- createSIBJMSTopicConnectionFactory
- createWMQTopicConnectionFactory
- createSIBJMSActivationSpec
- createWMQActivationSpec
- startListenerPort
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.
Ámbito | Vía de acceso de contención | ID de configuración | Tipo |
---|---|---|---|
Cell | /Cell:myCell/ |
|
Cell=myCell o cell=myCell |
Nodo | /Cell:myCell/Node:myNode/ o /Node:myNode/ |
|
o
o
|
Servidor |
o
|
|
o bien
o
bien
|
Clúster |
o
bien
|
|
o
bien
o
bien
|
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
XAEnabled | Especifica si se ha habilitado el proceso de recuperación XA. |
|
authDataAlias | Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución. |
|
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. |
|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
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. |
|
description | Especifica una descripción del adaptador de recursos. |
|
diagnoseConnectionUsage | Especifica si se ha habilitado el diagnóstico de uso de la conexión. |
|
logMissingTransactionContext | Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan. |
|
manageCachedHandles | Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es 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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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. |
|
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. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
XAEnabled | Especifica si se ha habilitado el proceso de recuperación XA. |
|
authDataAlias | Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución. |
|
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. |
|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
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. |
|
description | Especifica una descripción del adaptador de recursos. |
|
diagnoseConnectionUsage | Especifica si se ha habilitado el diagnóstico de uso de la conexión. |
|
logMissingTransactionContext | Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan. |
|
manageCachedHandles | Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es 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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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. |
|
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. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
XAEnabled | Especifica si se ha habilitado el proceso de recuperación XA. |
|
authDataAlias | Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución. |
|
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. |
|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
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. |
|
description | Especifica una descripción del adaptador de recursos. |
|
diagnoseConnectionUsage | Especifica si se ha habilitado el diagnóstico de uso de la conexión. |
|
logMissingTransactionContext | Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan. |
|
manageCachedHandles | Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es 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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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. |
|
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. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
XAEnabled | Especifica si se ha habilitado el proceso de recuperación XA. |
|
authDataAlias | Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución. |
|
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. |
|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
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. |
|
description | Especifica una descripción del adaptador de recursos. |
|
diagnoseConnectionUsage | Especifica si se ha habilitado el diagnóstico de uso de la conexión. |
|
logMissingTransactionContext | Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan. |
|
manageCachedHandles | Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es 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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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. |
|
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. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
description | Especifica una descripción del adaptador de recursos. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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")
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:
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
description | Especifica una descripción del adaptador de recursos. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
description | Especifica una descripción del adaptador de recursos. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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")
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:
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
description | Especifica una descripción del adaptador de recursos. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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")
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:
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:
|
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. |
|
description | Especifica una descripción del proveedor de JMS. |
|
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.
|
|
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 (;). |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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")
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:
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:
|
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. |
|
description | Especifica una descripción del proveedor de JMS. |
|
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.
|
|
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 (;). |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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")
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")
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:
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:
|
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. |
|
description | Especifica una descripción del proveedor de JMS. |
|
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.
|
|
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 (;). |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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")
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:
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:
|
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. |
|
description | Especifica una descripción del proveedor de JMS. |
|
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.
|
|
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 (;). |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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")
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")
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:
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
description | Especifica una descripción del adaptador de recursos. |
|
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. |
|
persistence | Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT. |
|
priority | Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y 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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
specifiedExpiry | Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan. |
|
specifiedPriority | Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
description | Especifica una descripción del adaptador de recursos. |
|
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. |
|
persistence | Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT. |
|
priority | Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y 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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
specifiedExpiry | Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan. |
|
specifiedPriority | Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere. |
|
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")
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:
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
description | Especifica una descripción del adaptador de recursos. |
|
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. |
|
persistence | Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT. |
|
priority | Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y 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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
specifiedExpiry | Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan. |
|
specifiedPriority | Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
description | Especifica una descripción del adaptador de recursos. |
|
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. |
|
persistence | Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT. |
|
priority | Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y 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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
specifiedExpiry | Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan. |
|
specifiedPriority | Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere. |
|
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")
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.
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:
|
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")
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.
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:
|
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")
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:
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
XAEnabled | Especifica si se ha habilitado el proceso de recuperación XA. |
|
authDataAlias | Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución. |
|
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. |
|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
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. |
|
description | Especifica una descripción del adaptador de recursos. |
|
diagnoseConnectionUsage | Especifica si se ha habilitado el diagnóstico de uso de la conexión. |
|
logMissingTransactionContext | Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan. |
|
manageCachedHandles | Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es 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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
XAEnabled | Especifica si se ha habilitado el proceso de recuperación XA. |
|
authDataAlias | Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución. |
|
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. |
|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
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. |
|
description | Especifica una descripción del adaptador de recursos. |
|
diagnoseConnectionUsage | Especifica si se ha habilitado el diagnóstico de uso de la conexión. |
|
logMissingTransactionContext | Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan. |
|
manageCachedHandles | Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es 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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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. |
|
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")
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:
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
XAEnabled | Especifica si se ha habilitado el proceso de recuperación XA. |
|
authDataAlias | Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución. |
|
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. |
|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
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. |
|
description | Especifica una descripción del adaptador de recursos. |
|
diagnoseConnectionUsage | Especifica si se ha habilitado el diagnóstico de uso de la conexión. |
|
logMissingTransactionContext | Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan. |
|
manageCachedHandles | Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es 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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
XAEnabled | Especifica si se ha habilitado el proceso de recuperación XA. |
|
authDataAlias | Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución. |
|
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. |
|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
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. |
|
description | Especifica una descripción del adaptador de recursos. |
|
diagnoseConnectionUsage | Especifica si se ha habilitado el diagnóstico de uso de la conexión. |
|
logMissingTransactionContext | Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan. |
|
manageCachedHandles | Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es 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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
description | Especifica una descripción del adaptador de recursos. |
|
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. |
|
persistence | Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT. |
|
priority | Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y 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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
specifiedExpiry | Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan. |
|
specifiedPriority | Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
description | Especifica una descripción del adaptador de recursos. |
|
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. |
|
persistence | Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT. |
|
priority | Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y 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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
specifiedExpiry | Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan. |
|
specifiedPriority | Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere. |
|
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")
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”)
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
description | Especifica una descripción del adaptador de recursos. |
|
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. |
|
persistence | Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT. |
|
priority | Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y 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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
specifiedExpiry | Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan. |
|
specifiedPriority | Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
description | Especifica una descripción del adaptador de recursos. |
|
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. |
|
persistence | Especifica el nivel de persistencia. Los valores válidos son APPLICATION_DEFINED, NONPERSISTENT y PERSISTENT. |
|
priority | Especifica el nivel de prioridad. Los valores válidos son APPLICATION_DEFINED y 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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
specifiedExpiry | Especifica el tiempo en milisegundos tras el cual los mensajes de esta cola se descartan. |
|
specifiedPriority | Especifica la prioridad de 0 a 9 de la cola de WASQueue de WebSphere. |
|
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")
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”)
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.
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:
|
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")
AdminJMS.createSIBJMSTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName" ,
"myJndiName9", "readAhead=AlwaysOff,timeToLive=6")
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.
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:
|
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")
AdminJMS.createWMQTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName10", "myTopicName10", "readAhead=YES,sendAsync=NO")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
XAEnabled | Especifica si se ha habilitado el proceso de recuperación XA. |
|
authDataAlias | Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución. |
|
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. |
|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
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. |
|
description | Especifica una descripción del adaptador de recursos. |
|
diagnoseConnectionUsage | Especifica si se ha habilitado el diagnóstico de uso de la conexión. |
|
logMissingTransactionContext | Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan. |
|
manageCachedHandles | Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es 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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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. |
|
Atributos | Descripción | Ejemplo |
---|---|---|
clientID | Especifica el ID del cliente. |
|
cloneSupport | Especifica si la fábrica de conexiones de tema de WebSphere está admitida en los clones. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
XAEnabled | Especifica si se ha habilitado el proceso de recuperación XA. |
|
authDataAlias | Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución. |
|
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. |
|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
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. |
|
description | Especifica una descripción del adaptador de recursos. |
|
diagnoseConnectionUsage | Especifica si se ha habilitado el diagnóstico de uso de la conexión. |
|
logMissingTransactionContext | Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan. |
|
manageCachedHandles | Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es 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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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. |
|
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. |
|
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")
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.
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:
|
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. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
XAEnabled | Especifica si se ha habilitado el proceso de recuperación XA. |
|
authDataAlias | Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución. |
|
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. |
|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
|
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. |
|
description | Especifica una descripción del adaptador de recursos. |
|
diagnoseConnectionUsage | Especifica si se ha habilitado el diagnóstico de uso de la conexión. |
|
logMissingTransactionContext | Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan. |
|
manageCachedHandles | Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es 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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Especifica el tipo de proveedor de JMS que utiliza este proveedor de JMS. |
|
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. |
|
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. |
|
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. |
|
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")
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.
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:
|
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")
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.
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:
|
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:
|
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")
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.
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:
|
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")
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.
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:
|
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:
|
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")
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.
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:
|
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")
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.
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:
|
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:
|
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")
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.
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:
|
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")
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.
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:
|
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:
|
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")
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.
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")