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/.

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

Formato del argumento scope

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

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

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

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

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

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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 2. Argumentos de createCompleteMailProvider. Ejecute el script para crear un proveedor de correo.
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.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de correo, nombre de propiedad, valor de propiedad, nombre de protocolo, nombre de clase, tipo, nombre de sesión de correo y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 3. Argumentos de createCompleteMailProviderAtScope. Ejecute el script para crear un proveedor de correo.
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:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
La tabla siguiente contiene atributos opcionales de un proveedor de correo:
Tabla 4. Atributos opcionales. Atributos adicionales disponibles para el script.
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.
La tabla siguiente contiene atributos opcionales de una sesión de correo:
Tabla 5. Atributos opcionales. Atributos adicionales disponibles para el script.
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")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
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.

Para ejecutar el script, especifique los nombres de nodo, servidor y proveedor de correo, como se define en la tabla siguiente:
Tabla 6. Argumentos de createMailProvider. Ejecutar el script para crear un proveedor de correo.
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.

Para ejecutar el script, especifique los argumentos de ámbito y de nombre del proveedor de correo. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 7. Argumentos de createMailProviderAtScope. Ejecutar el script para crear un proveedor de correo.
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:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 8. Atributos opcionales. Atributos adicionales disponibles para el script.
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")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
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.

Para ejecutar el script, especifique los argumentos de nombre de nodo, nombre de servidor, nombre de proveedor de correo, nombre de sesión de correo y nombre JNDI (Java Naming and Directory Interface), como se define en la tabla siguiente:
Tabla 9. Argumentos de createMailSession. Ejecute el script para crear una sesión de correo.
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.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de correo, nombre de sesión de correo y nombre JNDI (Java Naming and Directory Interface). Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 10. Argumentos de createMailSessionAtScope. Ejecute el script para crear una sesión de correo.
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:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 11. Atributos opcionales. Atributos adicionales disponibles para el script.
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")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 12. Argumentos de createProtocolProvider. Ejecute el script para crear un proveedor de protocolos.
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.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de correo, nombre de protocolo, nombre de clase y tipo. También puede especificar el atributo classpath. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 13. Argumentos de createProtocolProviderAtScope. Ejecute el script para crear un proveedor de protocolos.
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:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 14. Atributos opcionales. El atributo classpath también está disponible para el script.
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")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 15. Argumentos de createCompleteResourceEnvProvider. Ejecute el script para configurar un proveedor de entorno de recursos.
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.

Para ejecutar el script, especifique los argumentos de ámbito, proveedor de entorno de recursos, nombre de propiedad personalizada, valor de propiedad personalizada, clase de fábrica, nombre de clase, entrada del entorno de recursos y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 16. Argumentos de createCompleteResourceEnvProviderAtScope. Ejecute el script para configurar un proveedor de entorno de recursos.
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:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
La tabla siguiente contiene atributos opcionales de un proveedor de entorno de recursos:
Tabla 17. Atributos opcionales. Atributos adicionales disponibles para el script.
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.
La tabla siguiente contiene atributos opcionales de la entrada del entorno de recursos:
Tabla 18. Atributos opcionales. Atributos adicionales disponibles para el script.
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")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 19. Argumentos de createResourceEnvEntries. Ejecute el script para crear una entrada de entorno de recursos.
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.

Para ejecutar el script, especifique los argumentos de ámbito, proveedor de entorno de recursos, entrada del entorno de recursos y nombre JNDI. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 20. Argumentos de createResourceEnvEntriesAtScope. Ejecute el script para crear una entrada de entorno de recursos.
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:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 21. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción
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")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
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.

Para ejecutar el script, especifique los argumentos de nombre de nodo, nombre de servidor y nombre de proveedor de entorno de recursos, como se define en la tabla siguiente:
Tabla 22. Argumentos de createResourceEnvProvider. Ejecute el script para crear un proveedor de entorno de recursos.
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.

Para ejecutar el script, especifique los argumentos de ámbito y de nombre de proveedor de entorno de recursos. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 23. Argumentos de createResourceEnvProviderAtScope. Ejecute el script para crear un proveedor de entorno de recursos.
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:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 24. Atributos opcionales. Atributos adicionales disponibles para el script.
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")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 25. Argumentos de createResourceEnvProviderRef. Ejecute el script para crear una referencia de proveedor de entorno de recursos.
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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 26. Argumentos de createResourceEnvProviderRefAtScope. Ejecute el script para crear una referencia de proveedor de entorno de recursos.
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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 27. Argumentos de configURLProvider. Ejecute el script para configurar un proveedor 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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 28. Argumentos de createCompleteURLProvider. Ejecute el script para crear un proveedor 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.

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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 29. Argumentos de createCompleteURLProviderAtScope. Ejecute el script para crear un proveedor de URL.
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:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
La tabla siguiente contiene atributos opcionales de un proveedor de URL:
Tabla 30. Atributos opcionales. Atributos adicionales disponibles para el script.
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.
La tabla siguiente contiene atributos opcionales del URL:
Tabla 31. Atributos opcionales. Atributos adicionales disponibles para el script.
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")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 32. Argumentos de createURL. Ejecute el script para crear un proveedor 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 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.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de URL, nombre del URL, nombre JNDI y especificación del URL. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 33. Argumentos de createURLAtScope. Ejecute el script para crear un proveedor de URL.
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:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 34. Atributos opcionales. Atributos adicionales disponibles para el script.
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")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 35. Argumentos de createURLProvider. Ejecute el script para crear un proveedor 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.

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.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de proveedor de URL, clase de manejador de corrientes de datos URL y protocolo URL. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 36. Argumentos de createURLProviderAtScope. Ejecute el script para crear un proveedor de URL.
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:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 37. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción
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")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 38. Argumentos de createJAASAuthenticationAlias. Ejecute el script para crear un alias de autenticación JAAS.
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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 39. Argumentos de createLibraryRef. Ejecute el script para crear una referencia de biblioteca.
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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 40. Argumentos de createSharedLibrary. Ejecute el script para crear una biblioteca compartida.
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]
AdminResources.createSharedLibrary("myNode", "myServer", 
 "myLibrary", "c:/myLibrary.zip")
[AIX][Solaris][Linux][HP-UX][IBM i][z/OS]
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.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de biblioteca compartida y vía de acceso de clases de biblioteca compartida. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 41. Argumentos de createSharedLibraryAtScope. Ejecute el script para crear una biblioteca compartida.
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:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 42. Atributos opcionales. Atributos adicionales disponibles para el script.
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]
AdminResources.createSharedLibraryAtScope("myScope", 
 "myLibrary", "c:/myLibrary.zip")
[AIX][Solaris][Linux][HP-UX][IBM i][z/OS]
AdminResources.createSharedLibraryAtScope("myScope", "myLibrary", 
 "/myLibrary.zip")

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

[Windows]
 AdminResources.createSharedLibraryAtScope("Node=AMYLIN4Node09, server=server1", "myLibrary", 
"c:/myLibrary.zip", "description='this is my library', 
nativePath=c:/nativepath, isolatedClassLoader=true")
[AIX][Solaris][Linux][HP-UX][IBM i][z/OS]
 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]
AdminResources.createSharedLibraryAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myLibrary", 
"c:/myLibrary.zip", [['description', 'this is my library'], 
['nativePath', 'c:/nativepath'], ['isolatedClassLoader', 'true']])
[AIX][Solaris][Linux][HP-UX][IBM i][z/OS]
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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 43. Argumentos de createScheduler. Ejecute el script para crear un planificador.
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.

Para ejecutar el script, especifique los argumentos de ámbito, nombre de planificador, nombre JNDI, origen de datos JNDI, prefijo de tabla, intervalo de sondeo, nombre JNDI del gestor de trabajo e ID del proveedor del planificador. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 44. Argumentos de createSchedulerAtScope. Ejecute el script para crear un planificador.
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:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 45. Atributos opcionales. Atributos adicionales disponibles para el script.
Atributos Descripción
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)")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
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.

Para ejecutar el script, especifique los argumentos siguientes:
Tabla 46. Argumentos de createWorkManager. Ejecutar el script para crear un gestor de trabajo.
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.

Para ejecutar el script, especifique los argumentos de ámbito, nombre del gestor de trabajo, nombre JNDI, hebras de alarma, número mínimo de hebras, número máximo de hebras, prioridad de hebras e ID de proveedor del gestor de trabajo. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 47. Argumentos de createWorkManageratScope. Ejecutar el script para crear un gestor de trabajo.
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:
workManagerProviderID = AdminConfig.getid
(“/Cell:myCell/Node:myNode/Server:myServer
/WorkManagerProvider:/”)
otherAttributesList
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 48. Atributos opcionales. Atributos adicionales disponibles para el script.
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:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"

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)")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
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

Este script muestra los procedimientos de script a los que la biblioteca de scripts AdminResources da soporte. Para visualizar ayuda detallada para un script determinado, especifique el nombre del script de interés, como se define en la tabla siguiente:
Tabla 49. Argumentos de help. Ejecute el script para mostrar la ayuda.
Argumento Descripción
script Especifica el nombre del script de interés.

Sintaxis

AdminResources.help(script)

Ejemplo de uso

AdminResources.help("createWorkManager")

Icon that indicates the type of topic Reference topic



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