Scripts de configuración de recursos
La biblioteca de scripts proporciona varios procedimientos de script para automatizar las configuraciones de servidor de aplicaciones. Utilice los scripts de configuración de correo, URL y entorno de recursos para crear y configurar recursos en su entorno. Puede ejecutar cada script individualmente o combinar procedimientos para crear scripts automatizados.
Los procedimientos de script de correo, URL y gestión de recursos se encuentran en un directorio raíz_servidor_aplicaciones/scriptLibraries/resources/.

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
|
createCompleteMailProvider
Este script configura atributos de configuración adicionales para su proveedor de correo. Un proveedor de correo encapsula una colección de proveedores de protocolos como SMTP, IMAP y POP3, mientras que las sesiones de correo autentican a los usuarios y controlan el acceso de los usuarios a los sistemas de mensajería. Configure sus propios proveedores y sesiones de correo para personalizar cómo se controla JavaMail. El script devuelve el ID de configuración del proveedor de correo creado.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo de interés. |
serverName | Especifica el nombre del servidor de interés. |
mailProviderName | Especifica el proveedor de correo que el servidor de aplicaciones utiliza para esta sesión de correo. |
propName | Especifica el nombre de la propiedad personalizada. |
propValue | Especifica el valor de la propiedad personalizada. |
protocolName | Especifica el nombre del proveedor de protocolo. El servidor de aplicaciones contiene proveedores de protocolo para SMTP, IMAP y POP3. |
className | Especifica el nombre de la clase de implementación para el proveedor de protocolo. |
mailSessionName | Especifica el nombre administrativo del objeto de sesión de JavaMail. |
JNDIName | Especifica el nombre de la interfaz JNDI (Java Naming and Directory Interface) correspondiente al recurso, incluido cualquier subcontexto de denominación. Este nombre proporciona el enlace entre la información de enlace de la plataforma para los recursos definidos en el descriptor de despliegue de la aplicación cliente y los recursos reales unidos a JNDI por la plataforma. |
mailStoreHost | Especifica el servidor al que se accede al recibir correo. Este valor, combinado con el ID de usuario y la contraseña del almacenamiento de correo, representa una cuenta de correo válida. Por ejemplo, si la cuenta de correo es john_william@my.company.com, el host del almacén de correo es my.company.com. |
mailStoreUser | Especifica el ID de usuario para la cuenta de correo específica. Por ejemplo, si la cuenta de correo es john_william@my.company.com, el usuario es john_william. |
mailStorePassword | Especifica la contraseña para la cuenta de correo específica. Por ejemplo, si la cuenta de correo es john_william@my.company.com, especifique la contraseña para el ID john_william. |
Sintaxis
AdminResources.createCompleteMailProvider(nodeName,
serverName, mailProviderName, propName, propValue,
protocolName, className, mailSessionName, JNDIName,
mailStoreHost, mailStoreUser, mailStorePassword)
Ejemplo de uso
AdminResources.createCompleteMailProvider("myNode",
"myServer", "myMailProvider", "myProp", "myPropValue", "myMailProtocol",
"com.ibm.mail.myMailProtocol.myMailStore", "myMailSession", "myMailSession/jndi", "server1",
"mailuser", "password")
createCompleteMailProviderAtScope
Este script configura atributos de configuración adicionales para su proveedor de correo en el ámbito que especifique. Un proveedor de correo encapsula una colección de proveedores de protocolos como SMTP, IMAP y POP3, mientras que las sesiones de correo autentican a los usuarios y controlan el acceso de los usuarios a los sistemas de mensajería. Configure sus propios proveedores y sesiones de correo para personalizar cómo se controla JavaMail. El script devuelve el ID de configuración del proveedor de correo creado para el ámbito especificado.
Argumento | Descripción |
---|---|
scope | Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de correo. |
mailProviderName | Especifica el proveedor de correo que el servidor de aplicaciones utiliza para esta sesión de correo. |
propName | Especifica el nombre de la propiedad personalizada. |
propValue | Especifica el valor de la propiedad personalizada. |
protocolName | Especifica el nombre del proveedor de protocolo. El servidor de aplicaciones contiene proveedores de protocolo para SMTP, IMAP y POP3. |
className | Especifica el nombre de la clase de implementación para el proveedor de protocolo. |
type | Especifica el tipo de proveedor de protocolos. Opciones válidas son: STORE o TRANSPORT. |
mailSessionName | Especifica el nombre administrativo del objeto de sesión de JavaMail. |
jndiName | Especifica el nombre de la interfaz JNDI (Java Naming and Directory Interface) correspondiente al recurso, incluido cualquier subcontexto de denominación. Este nombre proporciona el enlace entre la información de enlace de la plataforma para los recursos definidos en el descriptor de despliegue de la aplicación cliente y los recursos reales unidos a JNDI por la plataforma. |
otherAttributesList, mailProviderAttributesList, mailSessionAttributesList | Opcionalmente especifica atributos
adicionales en un formato determinado:
|
Atributos | Descripción |
---|---|
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 correo. |
isolatedClassLoader | Si se establece en true, especifica que el proveedor de
correo 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. Utilice un punto y coma (;) para separar las entradas de vías de acceso nativas. |
providerType | Especifica el tipo de proveedor de correo que utiliza este proveedor de correo. |
Atributos | Descripción |
---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
debug | Especifica si se utiliza una modalidad de depuración para esta sesión de correo. El valor predeterminado es off. |
description | Especifica una descripción del proveedor de correo. |
mailFrom | Especifica la dirección de correo electrónico de Internet. Si se establece en true, este proveedor de correo se carga en su
propio cargador de clases. PRECAUCIÓN: No se puede aislar un proveedor cuando se especifica una vía
de acceso de biblioteca nativa.
|
mailStoreHost | Especifica el servidor al que conectarse al recibir correo. |
mailStorePort | Especifica el puerto al que conectarse al recibir correo. |
mailStoreUser | Especifica el usuario de una cuenta de correo cuando un servidor de correo entrante requiere autenticación. |
mailStorePassword | Especifica la contraseña de una cuenta de correo cuando un servidor de correo entrante requiere autenticación. |
mailStoreProtocol | Especifica el protocolo que debe utilizarse al recibir correo. |
mailTransportHost | Especifica el servidor al que conectarse al enviar correo. |
mailTransportPort | Especifica el puerto al que conectarse al enviar correo. |
mailTransportUser | Especifica el usuario de una cuenta de correo cuando un servidor de correo saliente requiere autenticación. |
mailTransportPassword | Especifica la contraseña de una cuenta de correo cuando un servidor de correo saliente requiere autenticación. |
mailTransportProtocol | Especifica el protocolo que debe utilizarse al enviar correo. |
strict | Especifica si las direcciones del destinatario deben analizarse en cumplimiento con RFC 822. El valor por omisión es true. |
Sintaxis
AdminResources.createCompleteMailProviderAtScope(scope,
mailProviderName, propName, propValue,
protocolName, className, type, mailSessionName, JNDIName, otherAttributesList,
mailProviderAttributesList, mailSessionAttributesList)
Ejemplo de uso
El script de ejemplo siguiente sólo contiene atributos obligatorios:
AdminResources.createCompleteMailProviderAtScope("myScope",
"myMailProvider", "myProp", "myPropValue", "myMailProtocol",
"com.ibm.mail.myMailProtocol.myMailStore", "myMailSession", "myMailSession/jndi", "server1", "STORE")
AdminResources.createCompleteMailProviderAtScope("Node=AMYLIN4Node09, server=server1", "myMailProvider", "myProp",
"myPropValue", "myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore", "STORE", "myMailSession", "myMailSession/jndi",
"classpath=c:/temp, description='this is my mail', nativepath=c:/temp/nativepath, isolatedClassLoader=true",
"category=myCategory, debug=true, description='this is my mailsession', mailStoreUser=user1, mailStorePassword=password,
mailStoreHost=user1, mailStorePort=1000, mailTransportUser=user2, mailTransportPassword=password, mailTransportHost=test2,
mailTransportPort=1001, strict=true, mailFrom=test1@gmail.com")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminResources.createCompleteMailProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myMailProvider", "myProp",
"myPropValue", "myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore", "STORE", "myMailSession", "myMailSession/jndi",
[['classpath', 'c:/temp'], ['description', 'this is my mail'], ['nativepath', 'c:/temp/nativepath'],
['isolatedClassLoader', 'true']]
[['category', 'myCategory'], ['debug', 'true'], ['description', 'this is my mailsession'], ['mailStoreUser', 'user1'],
['mailStorePassword', 'password'], ['mailStoreHost', 'user1'], ['mailStorePort', 1000], ['mailTransportUser', 'user2'],
['mailTransportPassword', 'password'], ['mailTransportHost', 'test2'], ['mailTransportPort', 1001], ['strict', 'true'],
['mailFrom', 'test1@gmail.com']])
createMailProvider
Este script crea un proveedor de correo en el entorno. El servidor de aplicaciones incluye un proveedor de correo predeterminado denominado proveedor incorporado. Si utiliza el proveedor de correo predeterminado, sólo debe configurar la sesión de correo. Para utilizar el proveedor de correo personalizado debe crear primero el proveedor y la sesión de correo. El script devuelve el ID de configuración del proveedor de correo creado.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo en el que debe crearse el proveedor de correo. |
serverName | Especifica el nombre del servidor de correo para el que debe crear el proveedor de correo. |
mailProviderName | Especifica el nombre que debe asignarse al nuevo proveedor de correo. |
Sintaxis
AdminResources.createMailProvider(nodeName, serverName,
mailProviderName)
Ejemplo de uso
AdminResources.createMailProvider("myNode", "myServer",
"myMailProvider")
createMailProviderAtScope
Este script crea un proveedor de correo en su entorno en el ámbito que especifique. El servidor de aplicaciones incluye un proveedor de correo predeterminado denominado proveedor incorporado. Si utiliza el proveedor de correo predeterminado, sólo debe configurar la sesión de correo. Para utilizar el proveedor de correo personalizado debe crear primero el proveedor y la sesión de correo. El script devuelve el ID de configuración del proveedor de correo creado para el ámbito especificado.
Argumento | Descripción |
---|---|
scope | Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de correo. |
mailProviderName | Especifica el nombre que debe asignarse al nuevo proveedor de correo. |
otherAttributesList | Opcionalmente especifica atributos
adicionales en un formato determinado:
|
Atributos | Descripción |
---|---|
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 correo. |
isolatedClassLoader | Si se establece en true, especifica que el proveedor de
correo 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. Utilice un punto y coma (;) para separar las entradas de vías de acceso nativas. |
providerType | Especifica el tipo de proveedor de correo que utiliza este proveedor de correo. |
Sintaxis
AdminResources.createMailProviderAtScope(scope, mailProviderName, otherAttributesList)
Ejemplo de uso
El script de ejemplo siguiente sólo contiene atributos obligatorios:
AdminResources.createMailProviderAtScope("myScope", "myMailProvider")
AdminResources.createMailProviderAtScope("Node=AMYLIN4Node09, server=server1", "myMailProvider", "classpath=c:/temp,
description='this is my mail', nativepath=c:/temp/nativepath, isolatedClassLoader=true")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminResources.createMailProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myMailProvider",
[['classpath', 'c:/temp'],
['description', 'this ismy mail'], ['nativepath', 'c:/temp/nativepath'], ['isolatedClassLoader', 'true']])
createMailSession
Este script crea una nueva sesión de correo para su proveedor de correo. Las sesiones de correo se presentan mediante la clase javax.mail.Session. Un objeto de sesión de correo autentica usuarios y controla el acceso de estos a los sistemas de mensajería. El script devuelve el ID de configuración de la sesión de correo creada.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo de interés. |
serverName | Especifica el nombre del servidor de interés. |
mailProviderName | Especifica el proveedor de correo que el servidor de aplicaciones utiliza para esta sesión de correo. |
mailSessionName | Especifica el nombre administrativo del objeto de sesión de JavaMail. |
JNDIName | Especifica el nombre JNDI del recurso, incluidos los subcontextos del nombre. Este nombre proporciona el enlace entre la información de enlace de la plataforma para los recursos definidos en el descriptor de despliegue de la aplicación cliente y los recursos reales unidos a JNDI por la plataforma. |
Sintaxis
AdminResources.createMailSession(nodeName, serverName,
mailProviderName, mailSessionName, JNDIName)
Ejemplo de uso
AdminResources.createMailSession("myNode", "myServer", "myMailProvider",
"myMailSession", "myMailSession/jndi")
createMailSessionAtScope
Este script crea una sesión de correo nueva para el proveedor de correo en el ámbito que especifique. Las sesiones de correo se presentan mediante la clase javax.mail.Session. Un objeto de sesión de correo autentica usuarios y controla el acceso de estos a los sistemas de mensajería. El script devuelve el ID de configuración de la sesión de correo creada para el ámbito especificado.
Argumento | Descripción |
---|---|
scope | Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de correo. |
mailProviderName | Especifica el proveedor de correo que el servidor de aplicaciones utiliza para esta sesión de correo. |
mailSessionName | Especifica el nombre administrativo del objeto de sesión de JavaMail. |
JNDIName | Especifica el nombre JNDI del recurso, incluidos los subcontextos del nombre. Este nombre proporciona el enlace entre la información de enlace de la plataforma para los recursos definidos en el descriptor de despliegue de la aplicación cliente y los recursos reales unidos a JNDI por la plataforma. |
otherAttributesList | Opcionalmente especifica atributos
adicionales en un formato determinado:
|
Atributos | Descripción |
---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
debug | Especifica si se utiliza una modalidad de depuración para esta sesión de correo. El valor predeterminado es off. |
description | Especifica una descripción del proveedor de correo. |
mailFrom | Especifica la dirección de correo electrónico de Internet. Si se establece en true, este proveedor de correo se carga en su
propio cargador de clases. PRECAUCIÓN: No se puede aislar un proveedor cuando se especifica una vía
de acceso de biblioteca nativa.
|
mailStoreHost | Especifica el servidor al que conectarse al recibir correo. |
mailStorePort | Especifica el puerto al que conectarse al recibir correo. |
mailStoreUser | Especifica el usuario de una cuenta de correo cuando un servidor de correo entrante requiere autenticación. |
mailStorePassword | Especifica la contraseña de una cuenta de correo cuando un servidor de correo entrante requiere autenticación. |
mailStoreProtocol | Especifica el protocolo que debe utilizarse al recibir correo. |
mailTransportHost | Especifica el servidor al que conectarse al enviar correo. |
mailTransportPort | Especifica el puerto al que conectarse al enviar correo. |
mailTransportUser | Especifica el usuario de una cuenta de correo cuando un servidor de correo saliente requiere autenticación. |
mailTransportPassword | Especifica la contraseña de una cuenta de correo cuando un servidor de correo saliente requiere autenticación. |
mailTransportProtocol | Especifica el protocolo que debe utilizarse al enviar correo. |
strict | Especifica si las direcciones del destinatario deben analizarse en cumplimiento con RFC 822. El valor por omisión es true. |
Sintaxis
AdminResources.createMailSessionAtScope(scope,
mailProviderName, mailSessionName, JNDIName, otherAttributesList)
Ejemplo de uso
El script de ejemplo siguiente sólo contiene atributos obligatorios:
AdminResources.createMailSessionAtScope("myScope", "myMailProvider",
"myMailSession", "myMailSession/jndi", attributes")
AdminResources.createMailSessionAtScope("Node=AMYLIN4Node09, server=server1", "myMailProvider", "myMailSession",
"myMailSession/jndi", "category=myCategory, debug=true, description='this is my mailsession', mailStoreUser=user1,
mailStorePassword=password, mailStoreHost=user1, mailStorePort=1000, mailTransportUser=user2, mailTransportPassword=password,
mailTransportHost=test2, mailTransportPort=1001, strict=true, mailFrom=test1@gmail.com")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminResources.createMailSessionAtScope("/Cell:AMYLIN4Cell01/ServerClust
er:c1/", "myMailProvider", "myMailSession", "myMailSession/jndi",
[['category','myCategory'], ['description', 'this is mailsession'], ['debug', 'true'],
['mailTransportHost', 'test1'], ['mailTransportUser', 'user2'], ['mailTransportPassword', 'password'],
['mailStoreUser', 'user1'], ['mailStorePassword', 'password'], ['mailStoreHost', 'test2'], ['strict', 'true'],
['mailFrom', 'tester@mail.com']]))
createProtocolProvider
Este script crea un proveedor de protocolo en la configuración, que proporciona la clase de implementación para un protocolo determinado para dar soporte a la comunicación entre la aplicación JavaMail y los servidores de correo. El servidor de aplicaciones contiene proveedores de protocolo para SMTP, IMAP y POP3. Si requiere proveedores personalizados para protocolos diferentes, instálelos en el entorno de servicio de aplicaciones antes de configurar los proveedores. Consulte la especificación de diseño de la API JavaMail para obtener las directrices. Después de configurar los proveedores de protocolo, regrese a la página del proveedor de correo para buscar el enlace para configurar sesiones de correo. El script devuelve el ID de configuración del proveedor de protocolo creado.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo de interés. |
serverName | Especifica el nombre del servidor de interés. |
mailProviderName | Especifica el nombre del proveedor de correo que el servidor de aplicaciones utiliza en asociación con el proveedor de protocolo. |
protocolName | Especifica el nombre del proveedor de protocolo. El servidor de aplicaciones contiene proveedores de protocolo para SMTP, IMAP y POP3. |
className | Especifica el nombre de la clase de implementación para el proveedor de protocolo. |
type | Especifica el tipo de proveedor de protocolos. Opciones válidas son: STORE o TRANSPORT. |
Sintaxis
AdminResources.createProtocolProvider(nodeName,
serverName, mailProviderName, protocolName,
className, type)
Ejemplo de uso
AdminResources.createProtocolProvider("myNode", "myServer", "myMailProvider",
"myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore",
"STORE")
createProtocolProviderAtScope
Este script crea un proveedor de protocolo en la configuración en el ámbito que especifique. El proveedor de protocolo proporciona la clase de implementación para que un protocolo determinado dé soporte a la comunicación entre la aplicación JavaMail y los servidores de correo en el ámbito que especifique. El servidor de aplicaciones contiene proveedores de protocolo para SMTP, IMAP y POP3. Si requiere proveedores personalizados para protocolos diferentes, instálelos en el entorno de servicio de aplicaciones antes de configurar los proveedores. Consulte la especificación de diseño de la API JavaMail para obtener las directrices. Después de configurar los proveedores de protocolo, regrese a la página del proveedor de correo para buscar el enlace para configurar sesiones de correo. El script devuelve el ID de configuración del proveedor de protocolo creado para el ámbito especificado.
Argumento | Descripción |
---|---|
scope | Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de correo. |
mailProviderName | Especifica el nombre del proveedor de correo que el servidor de aplicaciones utiliza en asociación con el proveedor de protocolo. |
protocolName | Especifica el nombre del proveedor de protocolo. El servidor de aplicaciones contiene proveedores de protocolo para SMTP, IMAP y POP3. |
className | Especifica el nombre de la clase de implementación para el proveedor de protocolo. |
type | Especifica el tipo de proveedor de protocolos. Opciones válidas son: STORE o TRANSPORT. |
otherAttributesList | Opcionalmente especifica atributos
adicionales en un formato determinado:
|
Atributos | Descripción |
---|---|
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. |
Sintaxis
AdminResources.createProtocolProviderAtScope(nodeName,
serverName, mailProviderName, protocolName,
className, type, otherAttributesList)
Ejemplo de uso
El script de ejemplo siguiente sólo contiene atributos obligatorios:
AdminResources.createProtocolProviderAtScope("myScope", "myMailProvider",
"myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore",
"STORE")
AdminResources.createProtocolProviderAtScope("Node=AMYLIN4Node09, server=server1", "myMailProvider", "myMailProtocol",
“com.ibm.mail.myMailProtocol.myMailStore", "STORE", "classpath=c:/temp")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminResources.createProtocolProviderAtScope("/Cell:AMYLIN4Cell01/Server
Cluster:c1/", "myMailProvider", "myMailProtocol", "com.ibm.mail.myMailProtocol.m
yMailStore", "STORE", [['classpath', 'c:/temp']]))
createCompleteResourceEnvProvider
Este script configura un entorno de recursos, que encapsula los referenciables que convierten los datos de entrada del entorno de recursos en objetos de recursos de la configuración. El script devuelve el ID de configuración del proveedor de entorno de recursos creado.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo de interés. |
serverName | Especifica el nombre del servidor de interés. |
resourceEnvProviderName | Especifica el nombre que debe asignarse al proveedor del entorno de recursos. |
propName | Especifica el nombre de la propiedad personalizada que debe definirse. |
propValue | Especifica el valor de la propiedad personalizada. |
factoryClass | Especifica la fábrica que convierte los datos de entrada del entorno de recursos en una instancia de clase para un recurso físico. |
className | Especifica el nombre de clase para el referenciable. |
resourceEnvEntryName | Especifica el nombre de la entrada de recursos. |
JNDIName | Especifica el nombre JNDI para la entrada del entorno de recursos, incluidos los subcontextos de denominación. Este nombre se utiliza como enlace entre la información de enlace de la plataforma para los recursos definidos por el descriptor de despliegue de un módulo y los recursos reales enlazados en JNDI por la plataforma. |
Sintaxis
AdminResources.createCompleteResourceEnvProvider(nodeName,
serverName, resourceEnvProviderName, propName,
propValue, factoryClass, className,
resourceEnvEntryName, JNDIName)
Ejemplo de uso
AdminResources.createCompleteResourceEnvProvider("myNode", "myServer",
"myResEnvProvider", "myProp", "myPropValue", "com.ibm.resource.res1", "java.lang.String",
"myResEnvEntry", "res1/myResEnv")
createCompleteResourceEnvProviderAtScope
Este script configura un proveedor de entorno de recursos en el ámbito que especifique. El proveedor de entorno de recursos encapsula los referenciables que convierten los datos de entrada del entorno de recursos en objetos de recursos de la configuración. El script devuelve el ID de configuración del proveedor de entorno de recursos creado para el ámbito especificado.
Argumento | Descripción |
---|---|
scope | Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de correo. |
resourceEnvProviderName | Especifica el nombre que debe asignarse al proveedor del entorno de recursos. |
propName | Especifica el nombre de la propiedad personalizada que debe definirse. |
propValue | Especifica el valor de la propiedad personalizada. |
factoryClass | Especifica la fábrica que convierte los datos de entrada del entorno de recursos en una instancia de clase para un recurso físico. |
className | Especifica el nombre de clase para el referenciable. |
resourceEnvEntryName | Especifica el nombre de la entrada de recursos. |
jndiName | Especifica el nombre JNDI para la entrada del entorno de recursos, incluidos los subcontextos de denominación. Este nombre se utiliza como enlace entre la información de enlace de la plataforma para los recursos definidos por el descriptor de despliegue de un módulo y los recursos reales enlazados en JNDI por la plataforma. |
otherAttributesList, resourceEnvProviderAttributesList, resourceEnvEntryAttributesList | Opcionalmente especifica atributos
adicionales en un formato determinado:
|
Atributos | Descripción |
---|---|
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 entorno de recursos. |
isolatedClassLoader | Si se establece en true, especifica que el proveedor de
entorno 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. Utilice un punto y coma (;) para separar las entradas de vías de acceso nativas. |
providerType | Especifica el tipo de proveedor de recursos que utiliza este proveedor de entorno de recursos. |
Atributos | Descripción |
---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
description | Especifica una descripción del proveedor de recursos. |
providerType | Especifica el tipo de proveedor de correo que utiliza este proveedor de entorno de recursos. |
referenceable | Especifica el referenciable, que encapsula el nombre de clase de la fábrica que convierte los datos de entrada de entorno de recursos a una instancia de clase de un recurso físico. |
Sintaxis
AdminResources.createCompleteResourceEnvProviderAtScope(scope,
resourceEnvProviderName, propName,
propValue, factoryClass, className,
resourceEnvEntryName, JNDIName, otherAttributesList,
resourceEnvProviderAttributesList, resourceEnvProviderAttributesList)
Ejemplo de uso
El script de ejemplo siguiente sólo contiene atributos obligatorios:
AdminResources.createCompleteResourceEnvProviderAtScope("myScope",
"myResEnvProvider", "myProp", "myPropValue", "com.ibm.resource.res1", "java.lang.String",
"myResEnvEntry", "res1/myResEnv")
AdminResources.createCompleteResourceEnvProviderAtScope("Node=AMYLIN4Node09, server=server1", "myResEnvProvider", "myProp",
"myPropValue", "com.ibm.resource.res1", "java.lang.String", "myResEnvEntry", "res1/myResEnv", "classpath=c:/temp,
description='this is my resource provider', nativepath=c:/temp/nativepath,
isolatedClassLoader=false", "category=myCategory, description='this is my resource entry',
referenceable=(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09|resources.xml#Referenceable_1238331401156)")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminResources.createCompleteResourceEnvProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myResEnvProvider",
"myProp", "myPropValue", "com.ibm.resource.res1", "java.lang.String", "myResEnvEntry", "res1/myResEnv", [['classpath', 'c:/temp'],
['description', 'this is my resource provider'], ['nativepath','c:/temp/nativepath'], ['isolatedClassLoader', 'false']]
[['category', 'myCategory'], ['description', 'this is my resource entry'],
['referenceable', '(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09|resources.xml#Referenceable_1238331401156)']])
createResourceEnvEntries
Este script crea una entrada del entorno de recursos en la configuración. Dentro de un espacio de nombres de servidor de aplicaciones, los datos contenidos en una entrada del entorno de recursos se convierten en un objeto que representa un recurso físico. Este recuso suele denominarse recurso de entorno. El script devuelve el ID de configuración de la entrada del entorno de recursos creada.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo de interés. |
serverName | Especifica el nombre del servidor de interés. |
resourceEnvProviderName | Especifica el proveedor del entorno de recursos de esta entrada. El proveedor encapsula las clases que, cuando se implementan, convierten los datos de entrada del entorno de recursos a objetos de recurso. |
referenceable | Especifica el referenciable, que encapsula el nombre de clase de la fábrica que convierte los datos de entrada de entorno de recursos a una instancia de clase de un recurso físico. |
resourceEnvEntry | Especifica el nombre de la entrada de entorno de recursos que debe crearse. |
JNDIName | Especifica la serie que debe utilizare para buscar este recurso de entorno mediante JNDI. Ésta es la serie a la que se deben enlazar los descriptores de despliegue de referencia de entorno de recursos. |
Sintaxis
AdminResources.createResourceEnvEntries(nodeName,
serverName, resourceEnvProviderName, referenceable,
resourceEnvEntry, JNDIName)
Ejemplo de uso
AdminResources.createResourceEnvEntries("myNode", "myServer",
"myResEnvProvider", "com.ibm.resource.res1", "myResEnvEntry", "res1/myResEnv")
createResourceEnvEntriesAtScope
Este script crea una entrada del entorno de recursos en la configuración en el ámbito que especifique. Dentro de un espacio de nombres de servidor de aplicaciones, los datos contenidos en una entrada del entorno de recursos se convierten en un objeto que representa un recurso físico. Este recuso suele denominarse recurso de entorno. El script devuelve el ID de configuración de la entrada del entorno de recursos creada para el ámbito especificado.
Argumento | Descripción |
---|---|
scope | Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de correo. |
resourceEnvProviderName | Especifica el proveedor del entorno de recursos de esta entrada. El proveedor encapsula las clases que, cuando se implementan, convierten los datos de entrada del entorno de recursos a objetos de recurso. |
resourceEnvEntry | Especifica el nombre de la entrada de entorno de recursos que debe crearse. |
JNDIName | Especifica la serie que debe utilizare para buscar este recurso de entorno mediante JNDI. Ésta es la serie a la que se deben enlazar los descriptores de despliegue de referencia de entorno de recursos. |
otherAttributesList | Opcionalmente especifica atributos
adicionales en un formato determinado:
|
Atributos | Descripción |
---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
description | Especifica una descripción del proveedor de recursos. |
providerType | Especifica el tipo de proveedor de correo que utiliza este proveedor de entorno de recursos. |
referenceable | Especifica el referenciable, que encapsula el nombre de clase de la fábrica que convierte los datos de entrada de entorno de recursos a una instancia de clase de un recurso físico. |
Sintaxis
AdminResources.createResourceEnvEntriesAtScope(scope,
resourceEnvProviderName,
resourceEnvEntry, JNDIName, otherAttributesList)
Ejemplo de uso
El script de ejemplo siguiente sólo contiene atributos obligatorios:
AdminResources.createResourceEnvEntriesAtScope("myScope",
"myResEnvProvider", "myResEnvEntry", "res1/myResEnv")
AdminResources.createResourceEnvEntriesAtScope("Node=AMYLIN4Node09, server=server1", "myResEnvProvider",
"myResEnvEntry", "res1/myResEnv", "category=myCategory, description='this is my resource entry',
referenceable=(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09|resources.xml#Referenceable_1238331401156)")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminResources.createResourceEnvEntriesAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myResEnvProvider",
"myResEnvEntry", "res1/myResEnv", [['category', 'myCategory'], ['description', 'this is my resource entry'],
['referenceable', '(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09|resources.xml#Referenceable_1238331401156)']])
createResourceEnvProvider
Este script crea un proveedor de entorno de recursos en la configuración. El proveedor de entorno de recursos encapsula las clases que, cuando se implementan, convierten los datos de entrada del entorno de recursos a objetos de recurso. El script devuelve el ID de configuración del proveedor de entorno de recursos creado.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo de interés. |
serverName | Especifica el nombre del servidor de interés. |
resourceEnvProviderName | Especifica el proveedor de entorno de recursos que debe crearse. |
Sintaxis
AdminResources.createResourceEnvProvider(nodeName,
serverName, resourceEnvProviderName)
Ejemplo de uso
AdminResources.createResEnvProvider("myNode", "myServer",
"myResEnvProvider")
createResourceEnvProviderAtScope
Este script crea un proveedor de entorno de recursos en la configuración en el ámbito que especifique. El proveedor de entorno de recursos encapsula las clases que, cuando se implementan, convierten los datos de entrada del entorno de recursos a objetos de recurso. El script devuelve el ID de configuración del proveedor de entorno de recursos creado para el ámbito especificado.
Argumento | Descripción |
---|---|
scope | Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de correo. |
resourceEnvProviderName | Especifica el proveedor de entorno de recursos que debe crearse. |
otherAttributesList | Opcionalmente especifica atributos
adicionales en un formato determinado:
|
Atributos | Descripción |
---|---|
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 entorno de recursos. |
isolatedClassLoader | Si se establece en true, especifica que el proveedor de
entorno 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. Utilice un punto y coma (;) para separar las entradas de vías de acceso nativas. |
providerType | Especifica el tipo de proveedor de recursos que utiliza este proveedor de entorno de recursos. |
Sintaxis
AdminResources.createResourceEnvProviderAtScope(scope,
resourceEnvProviderName, otherAttributesList)
Ejemplo de uso
El script de ejemplo siguiente sólo contiene atributos obligatorios:
AdminResources.createResEnvProviderAtScope("myScope",
"myResEnvProvider")
AdminResources.createResourceEnvProviderAtScope("Node=AMYLIN4Node09, server=server1", "myResEnvProvider",
"classpath=c:/temp, description='this is my resource provider', nativepath=c:/temp/nativepath, isolatedClassLoader=false")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminResources.createResourceEnvProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/",
"myResEnvProvider", [['classpath', 'c:/temp'],
['description','this is my resource provider'], ['nativepath', 'c:/temp/nativepath'], ['isolatedClassLoader', 'false']])
createResourceEnvProviderRef
Este script crea una referencia de proveedor de entorno de recursos en la configuración. Las referencias de entorno de recursos son distintas de las referencias de recursos. Las referencias de entorno de recursos permiten al cliente de aplicaciones utilizar nombres lógicos para buscar enlaces de recursos en el espacio de nombres JNDI del servidor. Una referencia de recurso permitirá a su aplicación utilizar un nombre lógico para buscar un recurso JEE local. La especificación JEE no especifica una implementación particular de un recurso. El script devuelve el ID de configuración del ID de referencia del proveedor de entorno de recursos creado.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo de interés. |
serverName | Especifica el nombre del servidor de interés. |
resourceEnvProviderName | Especifica el proveedor del entorno de recursos de esta referencia. El proveedor encapsula las clases que, cuando se implementan, convierten los datos de entrada del entorno de recursos a objetos de recurso. |
factoryClass | Especifica la clase de la fábrica que convierte los datos de entrada del entorno de recursos en una instancia de clase para un recurso físico. |
className | Especifica el nombre de la clase que debe asociarse con el referenciable. |
Sintaxis
AdminResources.createResourceEnvProviderRef(nodeName,
serverName, resourceEnvProviderName, factoryClass,
className)
Ejemplo de uso
AdminResources.createResourceEnvProviderRef("myNode", "myServer",
"myResEnvProvider", "com.ibm.resource.res1", "java.lang.String")
createResourceEnvProviderRefAtScope
Este script crea una referencia de proveedor de entorno de recursos en la configuración en el ámbito que especifique. Las referencias de entorno de recursos son distintas de las referencias de recursos. Las referencias de entorno de recursos permiten al cliente de aplicaciones utilizar nombres lógicos para buscar enlaces de recursos en el espacio de nombres JNDI del servidor. Una referencia de recurso permitirá a su aplicación utilizar un nombre lógico para buscar un recurso JEE local. La especificación JEE no especifica una implementación particular de un recurso. El script devuelve el ID de configuración del ID de referencia de proveedor de entorno de recursos creado para el ámbito especificado.
Argumento | Descripción |
---|---|
scope | Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de correo. |
resourceEnvProviderName | Especifica el proveedor del entorno de recursos de esta referencia. El proveedor encapsula las clases que, cuando se implementan, convierten los datos de entrada del entorno de recursos a objetos de recurso. |
factoryClass | Especifica la clase de la fábrica que convierte los datos de entrada del entorno de recursos en una instancia de clase para un recurso físico. |
className | Especifica el nombre de la clase que debe asociarse con el referenciable. |
Sintaxis
AdminResources.createResourceEnvProviderRefAtScope(scope,
resourceEnvProviderName, factoryClass,
className, otherAttributesList)
Ejemplo de uso
AdminResources.createResourceEnvProviderRefAtScope("/Node:AMYLIN4Node09/Server:server1/",
"myResEnvProvider", "com.ibm.resource.res1", "java.lang.String")
configURLProvider
Este script configura un proveedor de URL, que proporciona las clases de implementación necesarias para que el servidor de aplicaciones acceda a un URL a través de un protocolo específico. El proveedor de URL predeterminado proporciona conectividad mediante protocolos a los que da soporte IBM® Developer Kit. Entre estos protocolos se incluyen HTTP y FTP (File Transfer Protocol), que funcionan con la mayoría de URL.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo de interés. |
serverName | Especifica el nombre del servidor de interés. |
URLProviderName | Especifica el nombre del proveedor de URL que debe configurarse. |
URLStreamHandlerClass | Especifica el nombre completo de una clase Java definida por el usuario que amplía la clase java.net.URLStreamHandler para un protocolo URL determinado, como FTP. |
URLProtocol | Especifica el protocolo soportado por ese manejador de corrientes de datos. Por ejemplo, NNTP, SMTP, FTP. |
propName | Especifica el nombre de la propiedad personalizada que debe definirse para el proveedor de URL. |
propValue | Especifica el valor de la propiedad personalizada que debe definirse para el proveedor de URL. |
URLName | Especifica el nombre de URL (Uniform Resource Locator) que apunta a un recurso de Internet o Intranet. Por ejemplo, http://www.ibm.com. |
JNDIName | Especifica el nombre JNDI. No asigne nombres JNDI duplicados en distintos tipos de recursos, como sesiones de correo frente a configuraciones de URL. No asignar nombres JNDI duplicados para varios recursos del mismo tipo en el mismo ámbito. |
URLSpec | Especifica la serie con la que se forma un URL. |
Sintaxis
AdminResources.configURLProvider(nodeName, serverName,
URLProviderName, URLStreamHandlerClass, URLProtocol,
propName, propValue, URLName, JNDIName,
URLSpec)
Ejemplo de uso
AdminResources.configURLProvider("myNode",
"myServer", "myURLProvider",
"com.ibm.resource.url1", "ftp", "myProp", "myPropValue", "myURL", "url1/myURL", "myURLSpec")
createCompleteURLProvider
Este script crea un proveedor de URL, que proporciona las clases de implementación necesarias para que el servidor de aplicaciones acceda a un URL a través de un protocolo específico. El proveedor de URL predeterminado proporciona conectividad mediante protocolos a los que da soporte IBM Developer Kit. Entre estos protocolos se incluyen HTTP y FTP (File Transfer Protocol), que funcionan con la mayoría de URL. El script devuelve el ID de configuración del proveedor de URL creado.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo de interés. |
serverName | Especifica el nombre del servidor de interés. |
URLProviderName | Especifica el nombre del proveedor de URL que debe configurarse. |
URLStreamHandlerClass | Especifica el nombre completo de una clase Java definida por el usuario que amplía la clase java.net.URLStreamHandler para un protocolo URL determinado, como FTP. |
URLProtocol | Especifica el protocolo soportado por ese manejador de corrientes de datos. Por ejemplo, NNTP, SMTP, FTP. |
Sintaxis
AdminResources.createCompleteURLProvider(nodeName,
serverName, URLProviderName, URLStreamHandlerClass,
URLProtocol)
Ejemplo de uso
AdminResources.createCompleteURLProvider("myNode", "myServer",
"myURLProvider", "com.ibm.resource.url1", "ftp")
createCompleteURLProviderAtScope
Este script crea un proveedor de URL en el ámbito especificado. El proveedor de URL proporciona las clases de implementación necesarias para que el servidor de aplicaciones acceda a un URL a través de un protocolo específico. El proveedor de URL predeterminado proporciona conectividad mediante protocolos a los que da soporte IBM Developer Kit. Entre estos protocolos se incluyen HTTP y FTP (File Transfer Protocol), que funcionan con la mayoría de URL. El script devuelve el ID de configuración del proveedor de URL creado para el ámbito especificado.
Argumento | Descripción |
---|---|
scope | Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de correo. |
URLProviderName | Especifica el nombre del proveedor de URL que debe configurarse. |
URLStreamHandlerClass | Especifica el nombre completo de una clase Java definida por el usuario que amplía la clase java.net.URLStreamHandler para un protocolo URL determinado, como FTP. |
URLProtocol | Especifica el protocolo soportado por ese manejador de corrientes de datos. Por ejemplo, NNTP, SMTP, FTP. |
propName | Especifica el nombre de la propiedad personalizada que debe definirse para el proveedor de URL. |
propValue | Especifica el valor de la propiedad personalizada que debe definirse para el proveedor de URL. |
URLName | Especifica el nombre de URL (Uniform Resource Locator) que apunta a un recurso de Internet o Intranet. Por ejemplo, http://www.ibm.com. |
jndiName | Especifica el nombre JNDI. No asigne nombres JNDI duplicados en distintos tipos de recursos, como sesiones de correo frente a configuraciones de URL. No asignar nombres JNDI duplicados para varios recursos del mismo tipo en el mismo ámbito. |
URLSpec | Especifica la serie con la que se forma un URL. |
otherAttributesList, urlProviderAttributesList, urlAttributesList | Opcionalmente especifica atributos
adicionales en un formato determinado:
|
Atributos | Descripción |
---|---|
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 entorno de recursos. |
isolatedClassLoader | Si se establece en true, especifica que el proveedor de
URL 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. Utilice un punto y coma (;) para separar las entradas de vías de acceso nativas. |
providerType | Especifica el tipo de proveedor de URL que utiliza este proveedor de entorno de recursos. |
Atributos | Descripción |
---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
description | Especifica una descripción del proveedor de recursos. |
providerType | Especifica el tipo de proveedor de correo que utiliza este proveedor de entorno de recursos. |
referenceable | Especifica el referenciable, que encapsula el nombre de clase de la fábrica que convierte los datos de entrada de entorno de recursos a una instancia de clase de un recurso físico. |
Sintaxis
AdminResources.createCompleteURLProviderAtScope(Scope,
URLProviderName, URLStreamHandlerClass,
URLProtocol, propName, propValue,
URLName, JNDIName, URLSpec, otherAttributesList,
urlProviderAttributesList, urlAttributesList)
Ejemplo de uso
El script de ejemplo siguiente sólo contiene atributos obligatorios:
AdminResources.createCompleteURLProviderAtScope("Scope",
"myURLProvider", "com.ibm.resource.url1", "ftp", myProp", myPropValue",
"myURL", "url1/myURL", "myURLSpec")
AdminResources.createCompleteURLProviderAtScope("Node=AMYLIN4Node09, server=server1", "myURLProvider",
"com.ibm.resource.url1",
"ftp","myProp", "myPropValue", "myURL", "url1/myURL", "myURLSpec", "classpath=c:/temp, description='this
is my url provider',
nativepath=c:/temp/nativepath, isolatedClassLoader=true", "category=myCategory, description='this is my url'")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminResources.createCompleteURLProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/",
"myURLProvider", "com.ibm.resource.url1",
"ftp","myProp", "myPropValue", "myURL", "url1/myURL", "myURLSpec", [['classpath', 'c:/temp'], ['description', 'this is my urlProvider'],
['nativepath', 'c:/temp/nativepath'], ['isolatedClassLoader', 'true']] [['category', 'myCategory'],
['description', 'this is my url']])
createURL
Este script crea un proveedor de URL, que proporciona las clases de implementación necesarias para que el servidor de aplicaciones acceda a un URL a través de un protocolo específico. El proveedor de URL predeterminado proporciona conectividad mediante protocolos a los que da soporte IBM Developer Kit. Entre estos protocolos se incluyen HTTP y FTP (File Transfer Protocol), que funcionan con la mayoría de URL. El script devuelve el ID de configuración del URL creado.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo de interés. |
serverName | Especifica el nombre del servidor de interés. |
URLProviderName | Especifica el nombre del proveedor de URL al que debe asignarse el URL. |
URLName | Especifica el nombre del URL que debe crearse. |
JNDIName | Especifica el nombre JNDI. No asigne nombres JNDI duplicados en distintos tipos de recursos, como sesiones de correo frente a configuraciones de URL. No asignar nombres JNDI duplicados para varios recursos del mismo tipo en el mismo ámbito. |
URLSpec | Especifica la serie con la que se forma un URL. |
Sintaxis
AdminResources.createURL(nodeName, serverName,
URLProviderName, URLName, JNDIName,
URLSpec)
Ejemplo de uso
AdminResources.createURL("myNode", "myServer", "myURLProvider",
"myURL", "url1/myURL", "myURLSpec")
createURLAtScope
Este script crea un proveedor de URL en el ámbito que especifique. El proveedor de URL proporciona las clases de implementación necesarias para que el servidor de aplicaciones acceda a un URL a través de un protocolo específico. El proveedor de URL predeterminado proporciona conectividad mediante protocolos a los que da soporte IBM Developer Kit. Entre estos protocolos se incluyen HTTP y FTP (File Transfer Protocol), que funcionan con la mayoría de URL. El script devuelve el ID de configuración del URL creado para el ámbito especificado.
Argumento | Descripción |
---|---|
scope | Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de correo. |
URLProviderName | Especifica el nombre del proveedor de URL al que debe asignarse el URL. |
URLName | Especifica el nombre del URL que debe crearse. |
JNDIName | Especifica el nombre JNDI. No asigne nombres JNDI duplicados en distintos tipos de recursos, como sesiones de correo frente a configuraciones de URL. No asignar nombres JNDI duplicados para varios recursos del mismo tipo en el mismo ámbito. |
URLSpec | Especifica la serie con la que se forma un URL. |
otherAttributesList | Opcionalmente especifica atributos
adicionales en un formato determinado:
|
Atributos | Descripción |
---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
description | Especifica una descripción del proveedor de URL. |
providerType | Especifica el tipo de proveedor de correo que utiliza este proveedor de URL. |
Sintaxis
AdminResources.createURLAtScope(scope,
URLProviderName, URLName, JNDIName,
URLSpec, otherAttributesList)
Ejemplo de uso
El script de ejemplo siguiente sólo contiene atributos obligatorios:
AdminResources.createURLAtScope("myScope", "myURLProvider",
"myURL", "url1/myURL", "myURLSpec")
AdminResources.createURLAtScope("Node=AMYLIN4Node09, server=server1", "myURLProvider", "myURL", "url1/myURL",
"myURLSpec", "category=myCategory, description='this is my url'")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminResources.createURLAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/",
"myURLProvider", "myURL", "url1/myURL", "myURLSpec", [['category', 'myCategory'], ['description', 'this is my url']])
createURLProvider
Este script crea un proveedor de URL, que proporciona las clases de implementación necesarias para que el servidor de aplicaciones acceda a un URL a través de un protocolo específico. El proveedor de URL predeterminado proporciona conectividad mediante protocolos a los que da soporte IBM Developer Kit. Entre estos protocolos se incluyen HTTP y FTP (File Transfer Protocol), que funcionan con la mayoría de URL. El script devuelve el ID de configuración del proveedor de URL creado.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo de interés. |
serverName | Especifica el nombre del servidor de interés. |
URLProviderName | Especifica el nombre del proveedor de URL que debe configurarse. |
URLStreamHandlerClass | Especifica el nombre completo de una clase Java definida por el usuario que amplía la clase java.net.URLStreamHandler para un protocolo URL determinado, como FTP. |
URLProtocol | Especifica el protocolo soportado por ese manejador de corrientes de datos. Por ejemplo, NNTP, SMTP, FTP. |
Sintaxis
AdminResources.createURLProvider(nodeName,
serverName, URLProviderName, URLStreamHandlerClass,
URLProtocol)
Ejemplo de uso
AdminResources.createURLProvider("myNode", "myServer",
"myURLProvider", "com.ibm.resource.url1", "ftp")
createURLProviderAtScope
Este script crea un proveedor de URL en el ámbito que especifique. El proveedor de URL proporciona las clases de implementación necesarias para que el servidor de aplicaciones acceda a un URL a través de un protocolo específico. El proveedor de URL predeterminado proporciona conectividad mediante protocolos a los que da soporte IBM Developer Kit. Entre estos protocolos se incluyen HTTP y FTP (File Transfer Protocol), que funcionan con la mayoría de URL. El script devuelve el ID de configuración del proveedor de URL creado para el ámbito especificado.
Argumento | Descripción |
---|---|
scope | Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de correo. |
URLProviderName | Especifica el nombre del proveedor de URL que debe configurarse. |
URLStreamHandlerClass | Especifica el nombre completo de una clase Java definida por el usuario que amplía la clase java.net.URLStreamHandler para un protocolo URL determinado, como FTP. |
URLProtocol | Especifica el protocolo soportado por ese manejador de corrientes de datos. Por ejemplo, NNTP, SMTP, FTP. |
otherAttributesList | Opcionalmente especifica atributos
adicionales en un formato determinado:
|
Atributos | Descripción |
---|---|
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 entorno de recursos. |
isolatedClassLoader | Si se establece en true, especifica que el proveedor de
URL 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. Utilice un punto y coma (;) para separar las entradas de vías de acceso nativas. |
providerType | Especifica el tipo de proveedor de URL que utiliza este proveedor de entorno de recursos. |
Sintaxis
AdminResources.createURLProviderAtScope(scope,
URLProviderName, URLStreamHandlerClass,
URLProtocol, otherAttributesList)
Ejemplo de uso
El script de ejemplo siguiente sólo contiene atributos obligatorios:
AdminResources.createURLProviderAtScope("myScope",
"myURLProvider", "com.ibm.resource.url1", "ftp")
AdminResources.createURLProviderAtScope("Node=AMYLIN4Node09, server=server1", "myURLProvider", "com.ibm.resource.url1",
"ftp", "classpath=c:/temp, description='this is my url provider', nativepath=c:/temp/nativepath, isolatedClassLoader=true")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminResources.createURLProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myURLProvider", "com.ibm.resource.url1",
"ftp", [['classpath', 'c:/temp'], ['description', 'this is my url provider'], ['nativepath', 'c:/temp/nativepath'], ['isolatedClassLoader', 'true']])
createJAASAuthenticationAlias
Este script crea un alias de autenticación JAAS (Java Authentication and Authorization Service). El alias identifica la entrada de datos de autenticación. Cuando se configuran adaptadores de recursos u orígenes de datos, el administrador puede especificar los datos de autenticación que se deben elegir con el alias correspondiente. El script devuelve el ID de configuración del alias de autenticación JAAS (JavaAuthentication and Authorization Service) creado.
Argumento | Descripción |
---|---|
authAliasName | Especifica el nombre del alias de autenticación que debe crearse. |
authAliasID | Una identidad de usuario del dominio de seguridad proyectado. Por ejemplo, si se utiliza una entrada de datos de autenticación determinada para abrir una conexión con DB2, dicha entrada contiene una identidad de usuario de DB2. |
authAliasPW | Especifica que la contraseña para la identidad de usuario está codificada en el repositorio de configuración. |
Sintaxis
AdminResources.createJAASAuthenticationAlias(authAliasName,
authAliasID, authAliasPW)
Ejemplo de uso
AdminResources.createJAASAuthenticationAlias("myJAAS", "user01",
"password")
createLibraryRef
Este script crea una referencia de biblioteca, que define cómo utilizar bibliotecas globales. El primer paso para hacer que un archivo de biblioteca esté disponible para varias aplicaciones desplegadas en un servidor es crear una biblioteca compartida para cada archivo de biblioteca que necesiten las aplicaciones. Cuando cree las bibliotecas compartidas, establezca las variables para los archivos de biblioteca. El script devuelve el ID de configuración de la referencia de biblioteca creada.
Argumento | Descripción |
---|---|
libraryRefName | Especifica el nombre de la referencia de biblioteca que debe crearse. |
applicationName | Especifica el nombre de la aplicación que debe asociarse con la referencia de biblioteca. |
Sintaxis
AdminResources.createLibraryRef(libraryRefName,
applicationName)
Ejemplo de uso
AdminResources.createLibraryRef("myLibrary", "myApplication")
createSharedLibrary
Este script crea una biblioteca compartida en la configuración. El primer paso para hacer que un archivo de biblioteca esté disponible para varias aplicaciones desplegadas en un servidor es crear una biblioteca compartida para cada archivo de biblioteca que necesiten las aplicaciones. Cuando cree las bibliotecas compartidas, establezca las variables para los archivos de biblioteca. El script devuelve el ID de configuración de la biblioteca creada.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo de interés. |
serverName | Especifica el nombre del servidor de interés. |
sharedLibName | Especifica el nombre que debe asignarse a la biblioteca compartida. |
sharedLibClassPath | Especifica la vía de acceso de archivo en la que el producto busca las clases y los recursos de la biblioteca compartida. Si una vía de acceso de la lista es un archivo, el producto busca el contenido de dicho archivo .jar o .zip comprimido. Si una vía de acceso de la lista es un directorio, el producto busca el contenido de los archivos .jar y .zip en dicho directorio. Por razones de rendimiento, el producto busca sólo en el directorio propiamente dicho si el directorio contiene subdirectorios o archivos distintos a los archivos .jar o .zip. |
Sintaxis
AdminResources.createSharedLibrary(nodeName,
serverName, sharedLibName, sharedLibClassPath)
Ejemplo de uso
![[Windows]](../images/windows.gif)
AdminResources.createSharedLibrary("myNode", "myServer",
"myLibrary", "c:/myLibrary.zip")
![[AIX]](../images/aixlogo.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminResources.createSharedLibrary("myNode", "myServer", "myLibrary",
"/myLibrary.zip")
createSharedLibraryAtScope
Este script crea una biblioteca compartida en la configuración en el ámbito que especifique. El primer paso para hacer que un archivo de biblioteca esté disponible para varias aplicaciones desplegadas en un servidor es crear una biblioteca compartida para cada archivo de biblioteca que necesiten las aplicaciones. Cuando cree las bibliotecas compartidas, establezca las variables para los archivos de biblioteca. El script devuelve el ID de configuración de la biblioteca creada para el ámbito especificado.
Argumento | Descripción |
---|---|
scope | Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de correo. |
sharedLibName | Especifica el nombre que debe asignarse a la biblioteca compartida. |
sharedLibClassPath | Especifica la vía de acceso de archivo en la que el producto busca las clases y los recursos de la biblioteca compartida. Si una vía de acceso de la lista es un archivo, el producto busca el contenido de dicho archivo .jar o .zip comprimido. Si una vía de acceso de la lista es un directorio, el producto busca el contenido de los archivos .jar y .zip en dicho directorio. Por razones de rendimiento, el producto busca sólo en el directorio propiamente dicho si el directorio contiene subdirectorios o archivos distintos a los archivos .jar o .zip. |
otherAttributesList | Opcionalmente especifica atributos
adicionales en un formato determinado:
|
Atributos | Descripción |
---|---|
description | Especifica una descripción de la biblioteca compartida. |
isolatedClassLoader | Si se establece en true, especifica que el proveedor de
URL se ha cargado en su propio cargador de clases. El valor predeterminado es false. 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. Utilice un punto y coma (;) para separar las entradas de vías de acceso nativas. |
Sintaxis
AdminResources.createSharedLibraryAtScope(scope,
sharedLibName, sharedLibClassPath, otherAttributesList)
Ejemplo de uso
El script de ejemplo siguiente sólo contiene atributos obligatorios:
![[Windows]](../images/windows.gif)
AdminResources.createSharedLibraryAtScope("myScope",
"myLibrary", "c:/myLibrary.zip")
![[AIX]](../images/aixlogo.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminResources.createSharedLibraryAtScope("myScope", "myLibrary",
"/myLibrary.zip")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
![[Windows]](../images/windows.gif)
AdminResources.createSharedLibraryAtScope("Node=AMYLIN4Node09, server=server1", "myLibrary",
"c:/myLibrary.zip", "description='this is my library',
nativePath=c:/nativepath, isolatedClassLoader=true")
![[AIX]](../images/aixlogo.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminResources.createSharedLibraryAtScope("Node=AMYLIN4Node09, server=server1", "myLibrary",
"c:/myLibrary.zip", "description='this is my library',
nativePath=/nativepath, isolatedClassLoader=true")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
![[Windows]](../images/windows.gif)
AdminResources.createSharedLibraryAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myLibrary",
"c:/myLibrary.zip", [['description', 'this is my library'],
['nativePath', 'c:/nativepath'], ['isolatedClassLoader', 'true']])
![[AIX]](../images/aixlogo.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminResources.createSharedLibraryAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myLibrary",
"c:/myLibrary.zip", [['description', 'this is my library'],
['nativePath', '/nativepath'], ['isolatedClassLoader', 'true']])
createScheduler
Este script crea un planificador en la configuración. Los planificadores son servicios de temporizador persistentes y transaccionales que ejecutan la lógica empresarial. Cada planificador ejecuta las tareas de forma independiente y tiene una interfaz de programa a la que se puede acceder desde la aplicaciones JEE utilizando JNDI (Java Naming and Directory Interface). También puede gestionar los planificadores con un MBean JMX (Java Management Extensions). Consulte la documentación del planificador en el Information Center para obtener información detallada acerca de cómo configurar y utilizar los planificadores. El script devuelve el ID de configuración del planificador creado.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo de interés. |
serverName | Especifica el nombre del servidor de interés. |
schedulerName | Especifica el nombre por el que se conoce este planificador para fines administrativos. |
JNDIName | Especifica el nombre JNDI que determina dónde está enlazada esta instancia del planificador en el espacio de nombres. Los clientes pueden consultar este nombre directamente, aunque se recomienda utilizar el uso de referencias de recursos. |
scheduleCategory | Especifica una serie que puede utilizarse para clasificar o agrupar este planificador. |
datasourceJNDI | Especifica el nombre del origen de datos en el que se almacenan las tareas persistentes. Con el planificador se puede utilizar cualquier origen de datos disponible en el espacio de nombres. Varios planificadores pueden compartir un solo origen de datos mientras que se utilizan distintas tablas especificando un prefijo de tabla. |
tablePrefix | Especifica el prefijo de la serie que se ha de añadir a las tablas del planificador. Varios planificadores independientes pueden compartir la misma base de datos si cada instancia especifica una serie de prefijo distinta. |
pollInterval | Especifica el intervalo en segundos en que el planificador sondea la base de datos. El valor predeterminado es suficiente para la mayor parte de aplicaciones. Cada operación de sondeo puede consumir recursos. Si el intervalo es muy pequeño y hay muchas tareas planificadas, el sondeo puede absorber una gran parte de los recursos del sistema. El valor predeterminado es 30. |
workMgmtJNDI | Especifica el nombre JNDI del gestor de trabajo, que se utiliza para gestionar el número de tareas que se pueden ejecutar de forma simultánea con el planificador. El gestor de trabajo también puede limitar la cantidad de contexto JEE que se aplica a la tarea. |
Sintaxis
AdminResources.createScheduler(nodeName, serverName,
schedulerName, JNDIName, scheduleCategory,
datasourceJNDI, tablePrefix, pollInterval, workMgmtJNDI)
Ejemplo de uso
AdminResources.createScheduler("myNode", "myServer", "myScheduler",
"myScheduleJndi", "Default", "jdbc/MyDatasource", "sch1", "30",
"myWorkManager")
createSchedulerAtScope
Este script crea un planificador en la configuración en el ámbito que especifique. Los planificadores son servicios de temporizador persistentes y transaccionales que ejecutan la lógica empresarial. Cada planificador ejecuta las tareas de forma independiente y tiene una interfaz de programa a la que se puede acceder desde la aplicaciones JEE utilizando JNDI (Java Naming and Directory Interface). También puede gestionar los planificadores con un MBean JMX (Java Management Extensions). Consulte la documentación del planificador en el Information Center para obtener información detallada acerca de cómo configurar y utilizar los planificadores. El script devuelve el ID de configuración del planificador creado para el ámbito especificado.
Argumento | Descripción |
---|---|
scope | Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS. |
schedulerName | Especifica el nombre por el que se conoce este planificador para fines administrativos. |
JNDIName | Especifica el nombre JNDI que determina dónde está enlazada esta instancia del planificador en el espacio de nombres. Los clientes pueden consultar este nombre directamente, aunque se recomienda utilizar el uso de referencias de recursos. |
datasourceJNDI | Especifica el nombre del origen de datos en el que se almacenan las tareas persistentes. Con el planificador se puede utilizar cualquier origen de datos disponible en el espacio de nombres. Varios planificadores pueden compartir un solo origen de datos mientras que se utilizan distintas tablas especificando un prefijo de tabla. |
tablePrefix | Especifica el prefijo de la serie que se ha de añadir a las tablas del planificador. Varios planificadores independientes pueden compartir la misma base de datos si cada instancia especifica una serie de prefijo distinta. |
pollInterval | Especifica el intervalo en segundos en que el planificador sondea la base de datos. El valor predeterminado es suficiente para la mayor parte de aplicaciones. Cada operación de sondeo puede consumir recursos. Si el intervalo es muy pequeño y hay muchas tareas planificadas, el sondeo puede absorber una gran parte de los recursos del sistema. El valor predeterminado es 30. |
workMgmtJNDI | Especifica el nombre JNDI del gestor de trabajo, que se utiliza para gestionar el número de tareas que se pueden ejecutar de forma simultánea con el planificador. El gestor de trabajo también puede limitar la cantidad de contexto JEE que se aplica a la tarea. |
schedulerProviderID | Especifique el ID de proveedor de este planificador. |
otherAttributesList | Opcionalmente especifica atributos
adicionales en un formato determinado:
|
Atributos | Descripción |
---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
description | Especifica una descripción del proveedor de URL. |
providerType | Especifica el tipo de proveedor de recursos que utiliza este proveedor de URL. |
datasourceAlias | Especifica el alias del nombre de usuario y contraseña que este proveedor de URL utiliza para acceder al origen de datos. |
loginConfigName | Especifica el nombre de configuración del inicio de sesión. |
securityRole | Especifica el rol de seguridad. |
useAdminRoles | Especifica que cuando están habilitadas esta opción y la seguridad administrativa, se aplican los roles de administración de usuarios. Para que se apliquen los roles de administración de usuarios, debe utilizar los mandatos JMX del planificador y las API para crear y modificar tareas. Si esta opción no está habilitada, todos los usuarios pueden crear y modificar las tareas. El valor predeterminado es false. |
referenceable | Especifica el referenciable, que encapsula el nombre de clase de la fábrica que convierte los datos de entrada de entorno de recursos a una instancia de clase de un recurso físico. |
Sintaxis
AdminResources.createSchedulerAtScope(scope,
schedulerName, JNDIName,
datasourceJNDI, tablePrefix, pollInterval, workMgmtJNDI,
ScheduleProviderID, otherAttributesList)
Ejemplo de uso
El script de ejemplo siguiente sólo contiene atributos obligatorios:
AdminResources.createSchedulerAtScope("myNode", "myScheduler",
"myScheduleJndi", "Default", "jdbc/MyDatasource", "sch1", "30",
"myWorkManager, "SchedulerProvider(cells/AMYLIN4Cell01/nodes/AMY
LIN4Node09/servers/server1|resources-pme.xml#SchedulerProvider_1)")
AdminResources.createSchedulerAtScope("Node=AMYLIN4Node09, server=server1", "myScheduler",
"myScheduleJndi", "jdbc/MyDatasource", "sch1", "30",
"myWorkManager", “SchedulerProvider(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09/servers/server1|
resources-pme.xml#SchedulerProvider_1)", "category=myCategory,
description='this is my scheduler', datasourceAlias=abc, useAdminRoles=false, loginConfigName=test, securityRole=user1")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminResources.createSchedulerAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myScheduler",
"myScheduleJndi", "jdbc/MyDatasource", "sch1", "30",
"myWorkManager", "SchedulerProvider(cells/AMYLIN4Cell01/clusters/c1|resources-pme.xml#SchedulerProvider_1)",
[['category', 'myCategory'],
['description', 'this is my scheduler'], ['datasourceAlias', 'abc'], ['useAdminRoles', 'false'],
['loginConfigName', 'test'], ['securityRole', 'user1']])
createWorkManager
Este script crea un gestor de trabajo en la configuración. Los gestores de trabajo contienen una agrupación de hebras enlazada a JNDI (Java Naming and Directory Interface). El script devuelve el ID de configuración de la biblioteca creada.
Argumento | Descripción |
---|---|
nodeName | Especifica el nombre del nodo de interés. |
serverName | Especifica el nombre del servidor de interés. |
workMgrName | Especifica el nombre por el que se conoce el gestor de trabajo para fines administrativos. |
JNDIName | Especifica el nombre JNDI (Java Naming and Directory Interface) utilizado para buscar el gestor de trabajo en el espacio de trabajo. |
workMgrCategory | Especifica una serie que puede utilizarse para clasificar o agrupar este gestor de trabajo. |
alarmThreads | Especifica el número máximo de hebras deseado que se utiliza para las alarmas. El valor predeterminado es 2. |
minThreads | Especifica el número mínimo de hebras disponible en este gestor de trabajo. |
maxThreads | Especifica el número máximo de hebras disponible en este gestor de trabajo. |
threadPriority | Especifica la prioridad de las hebras disponibles en este gestor de trabajo. Cada hebra tiene una prioridad. Las hebras con la prioridad más elevada se ejecutan antes que las hebras de menor prioridad. Para obtener más información sobre el uso de las propiedades de hebra, consulte la documentación de la API para el método setPriority de la clase java.lang.Thread en la especificación Java EE. |
isGrowable | Especifica si puede aumentarse el número de hebras de este gestor de trabajo. Especifique el valor true para indicar que el número de hebras puede aumentar. |
serviceNames | Especifica una lista de servicios que se pone a disposición del gestor de trabajo. |
Sintaxis
AdminResources.createWorkManager(nodeName, serverName,
workMgrName, JNDIName, workMgrCategory,
alarmThreads, minThreads, maxThreads, threadPriority,
isGrowable, serviceNames)
Ejemplo de uso
AdminResources.createWorkManager("myNode", "myServer", "myWorkManager",
"Work Manager", "wm/myWorkManager", "Default", 5, 1, 10, 5, "true",
"AppProfileService UserWorkArea com.ibm.ws.i18n security")
createWorkManagerAtScope
Este script crea un gestor de trabajo en la configuración en el ámbito que especifique. Los gestores de trabajo contienen una agrupación de hebras enlazada a JNDI (Java Naming and Directory Interface). El script devuelve el ID de configuración del gestor de trabajo creado para el ámbito especificado.
Argumento | Descripción |
---|---|
scope | Especifica el ámbito de célula, nodo, servidor o clúster del proveedor de JMS. |
workMgrName | Especifica el nombre por el que se conoce el gestor de trabajo para fines administrativos. |
JNDIName | Especifica el nombre JNDI (Java Naming and Directory Interface) utilizado para buscar el gestor de trabajo en el espacio de trabajo. |
alarmThreads | Especifica el número máximo de hebras deseado que se utiliza para las alarmas. El valor predeterminado es 2. |
minThreads | Especifica el número mínimo de hebras disponible en este gestor de trabajo. |
maxThreads | Especifica el número máximo de hebras disponible en este gestor de trabajo. |
threadPriority | Especifica la prioridad de las hebras disponibles en este gestor de trabajo. Cada hebra tiene una prioridad. Las hebras con la prioridad más elevada se ejecutan antes que las hebras de menor prioridad. Para obtener más información sobre el uso de las propiedades de hebra, consulte la documentación de la API para el método setPriority de la clase java.lang.Thread en la especificación Java EE. |
workManagerProviderID | Especifica el ID de configuración del proveedor de gestor
de trabajo padre. El gestor de trabajo se crea en este ID. Puede crear un
gestor de trabajo en el proveedor de gestor de trabajo existente o en uno
nuevo. El mandato wsadmin siguiente es un ejemplo de cómo recuperar el ID de
configuración del proveedor de gestor de trabajo existente en el ámbito de
servidor:
|
otherAttributesList | Opcionalmente especifica atributos
adicionales en un formato determinado:
|
Atributos | Descripción |
---|---|
categoría | Especifica la categoría que puede utilizarse para clasificar o agrupar recursos. |
description | Especifica una descripción del proveedor de URL. |
providerType | Especifica el tipo de proveedor de recursos que utiliza este proveedor de URL. |
daemonTranClass | Especifica la clase de transacción que se utiliza para la clasificación de cargas de trabajo del daemon. El trabajo del daemon es para el servicio de gestor de carga de trabajo. |
defTranClass | Especifica el nombre de clase de transacción utilizado para clasificar el trabajo ejecutado por esta instancia del gestor de trabajo cuando la información de clase del servicio de gestor de carga de trabajo de z/OS no está contenida en la información de contexto de trabajo. |
isDistributable | Especifica si este gestor de trabajo se puede distribuir. El valor predeterminado es false. |
isGrowable | Especifica si puede aumentarse el número de hebras de este gestor de trabajo. El valor predeterminado es true. |
serviceNames | Especifica una lista de servicios que se pone a disposición del gestor de trabajo. |
workReqQFullAction | Especifica la acción efectuada cuando se agota la agrupación de hebras y la cola de solicitudes de trabajo está llena. El valor predeterminado es 0. |
workReqQSize | Especifica el tamaño de la cola de solicitudes de trabajos. El valor predeterminado es 0. |
workTimeout | Especifica el número de milisegundos que se debe esperar antes de intentar liberar una unidad de trabajo. El valor predeterminado es 0. |
referenceable | Especifica el referenciable, que encapsula el nombre de clase de la fábrica que convierte los datos de entrada de entorno de recursos a una instancia de clase de un recurso físico. |
otherAttributesList | Opcionalmente especifica atributos
adicionales en un formato determinado:
|
Sintaxis
AdminResources.createWorkManagerAtScope(scope,
workMgrName, JNDIName,
alarmThreads, minThreads, maxThreads, threadPriority,
workManagerProviderID, otherAttributesList)
Ejemplo de uso
El script de ejemplo siguiente sólo contiene atributos obligatorios:
AdminResources.createWorkManagerAtScope("scope", "myWorkManager",
"Work Manager", "Default", 5, 1, 10,
"WorkManagerProvider(cells/AMYLIN4Cell01/nodes/A
MYLIN4Node09/servers/server1|resources-pme.xml#WorkManagerProvider_1)")
AdminResources.createWorkManagerAtScope("Node=AMYLIN4Node09, server=server1", "myWorkManager",
"wm/myWorkManager", "5", "1", "10", "5",
"WorkManagerProvider(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09/servers/server1|resources-pme.xml#WorkManagerProvider_1)")
El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:
AdminResources.createWorkManagerAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myWorkManager",
"wm/myWorkManager", "5", "1", "10", "5",
WorkManagerProvider(cells/AMYLIN4Cell01/clusters/c1|resources-pme.xml#WorkManagerProvider_1)",
[['category', 'myCategory'], ['description', 'this is my workmanager'],
['daemonTranClass', ''], ['defTranClass', ''], ['isDistributable', 'false'], ['isGrowable', 'true'], ['serviceNames', 'security'], ['workReqQFullAction', 0],
['workReqQSize', 0], ['workTimeout', 10]])
help
Argumento | Descripción |
---|---|
script | Especifica el nombre del script de interés. |
Sintaxis
AdminResources.help(script)
Ejemplo de uso
AdminResources.help("createWorkManager")