Opciones para los mandatos install, installInteractive, edit, editInteractive, update y updateInteractive del objeto AdminApp con scripts wsadmin

En este tema se listan las opciones disponibles para los mandatos install, installInteractive, edit, editInteractive, update y updateInteractive del objeto AdminApp.

Puede utilizar los mandatos para el objeto AdminApp para instalar, editar, actualizar y gestionar las configuraciones de aplicación. En este tema se proporcionan opciones adicionales para utilizar con los mandatos install, installInteractive, edit, editInteractive, update y updateInteractive para administrar las aplicaciones. Las opciones listadas en este tema se aplican a todos estos mandatos, excepto cuando se especifique de otra forma.

Puede establecer o actualizar un valor de configuración mediante las opciones de la modalidad por lotes. Para identificar qué objeto de configuración se va a establecer o actualizar, se utilizan los valores de los campos de sólo lectura para buscar el objeto de configuración correspondiente. Todos los valores de los campos de sólo lectura tienen que coincidir con un objeto de configuración existente o, de lo contrario, el mandato no se ejecutará correctamente.

Puede utilizar la coincidencia de patrones para simplificar la tarea de suministrar los valores necesarios para determinadas opciones complejas. La coincidencia de patrones sólo se aplica a campos que son obligatorios y de solo lectura.

Atención: Si se está ejecutando una aplicación y se cambia un valor de la aplicación, ésta se reiniciará. En servidores autónomos, la aplicación se reinicia después de guardar el cambio. En productos de varios servidores, la aplicación se reinicia después de guardar el cambio y de que se hayan sincronizado los archivos en el nodo en el que está instalada la aplicación. Para controlar cuándo se produce la sincronización en productos con varios servidores, deseleccione Sincronizar cambios con nodos en la página de preferencias de la consola.
Las siguientes opciones están disponibles para los mandatos install, installInteractive, edit, editInteractive, update y updateInteractive:

ActSpecJNDI

La opción ActSpecJNDI enlaza las especificaciones de activación J2C (Java™ 2 Connector) con los nombres JNDI (Java Naming and Directory Interface) de destino. De forma opcional, enlace las especificaciones de activación J2C de la aplicación o del módulo con un nombre JNDI de destino. Puede asignar un valor a cada uno de los elementos siguientes de la opción ActSpecJNDI: campo RARModule, uri, j2cid y j2c.jndiName. El contenido de la opción después de ejecutar los enlaces predeterminados incluye:
  • RARModule: <nombre módulo rar>
  • uri: <nombre rar>,META-INF/ra.xml
  • Identificador de objeto: <Tipoescuchamensaje>
  • Nombre JNDI: null
Para utilizar esta opción, debe especificar la propiedad Destination en el archivo ra.xml y establecer el tipo de la introspección de la propiedad Destination como javax.jms.Destination

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install $embeddedEar {-ActSpecJNDI
 {{"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener jndi5}
 {"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener2 jndi6}}} 
Utilizando Jacl con coincidencia de patrones:
$AdminApp install $embeddedEar {-ActSpecJNDI
 {{.* .*.rar,.* javax.jms.MessageListener jndi5}
 {.*  .*.rar,.*  javax.jms.MessageListener2 jndi6}}} 
En Jython:
AdminApp.install(embeddedEar, ['-ActSpecJNDI',
 [["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener', 'jndi5'],
 ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener2', 'jndi6']]]) 
Utilizando Jython con coincidencia de patrones:
AdminApp.install(embeddedEar, ['-ActSpecJNDI',
 [['.*', '.*.rar,.*', 'javax.jms.MessageListener', 'jndi5'],
 ['.*', '.*.rar,.*', 'javax.jms.MessageListener2', 'jndi6']]]) 

allowDispatchRemoteInclude

La opción allowDispatchRemoteInclude habilita una aplicación de empresa para que asigne solicitudes include a recursos a través de módulos web que están en JVM (Java Virtual Machine) diferentes en un entorno de nodos gestionado a través del mecanismo del asignador de solicitudes estándar.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
set deployments [$AdminConfig getid /Deployment:RRDEnabledAppname/]
set deploymentObject [$AdminConfig showAttribute $deployments deployedObject]
set rrdAttr [list allowDispatchRemoteInclude true]
set attrs [list $rrdLocalAttr]
$AdminConfig modify $deploymentObject $attrs
En Jython:
deployments = AdminConfig.getid ('/Deployment:RRDEnabledAppname/')
deploymentObject = AdminConfig.showAttribute(deployments, 'deployedObject')
rrdAttr = ['allowDispatchRemoteInclude', 'true']
attrs = [rrdLocalAttr]
AdminConfig.modify (deploymentObject, attrs)

allowPermInFilterPolicy

La opción allowPermInFilterPolicy especifica que el servidor de aplicaciones debe continuar con el proceso del despliegue de aplicaciones, aún cuando la aplicación contenga permisos de política que están en la política de filtros. Esta opción no necesita obligatoriamente un valor.

allowServiceRemoteInclude

La opción allowServiceRemoteInclude permite que una aplicación de empresa dé servicio a una solicitud include con la opción allowDispatchRemoteInclude establecida en true.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
set deployments [$AdminConfig getid /Deployment:RRDEnabledAppname/]
set deploymentObject [$AdminConfig showAttribute $deployments deployedObject]
set rrdAttr [list allowServiceRemoteInclude true]
set attrs [list $rrdAttr]
$AdminConfig modify $deploymentObject $attrs
En Jython:
deployments = AdminConfig.getid ('/Deployment:RRDEnabledAppname/')
deploymentObject = AdminConfig.showAttribute ('deployments', 'deployedObject')
rrdAttr = ['allowServiceRemoteInclude', 'true']
attrs = [rrdAttr] 
AdminConfig.modify (deploymentObject, attrs) 

appname

La opción appname especifica el nombre de la aplicación. El valor predeterminado es el nombre de visualización de la aplicación.

BackendIdSelection

La opción BackendIdSelection especifica el ID de programa de fondo para los módulos del archivador Java de enterprise bean (JAR) que tienen beans CMP (persistencia gestionada por contenedor). Un módulo JAR de enterprise bean puede dar soporte a varias configuraciones de programa de fondo, tal como se especifica utilizando Application Assembly Tool. Utilice esta opción para cambiar el ID de programa de fondo durante la instalación.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install myapp.ear {-BackendIdSelection 
 {{Annuity20EJB Annuity20EJB.jar,META-INF/ejb-jar.xml  DB2UDBNT_V72_1}}} 
Utilizando Jacl con coincidencia de patrones:
$AdminApp install myapp.ear {-BackendIdSelection 
 {{.* Annuity20EJB.jar,.* DB2UDBNT_V72_1}}} 
En Jython:
AdminApp.install('myapp.ear', '[-BackendIdSelection 
 [[Annuity20EJB Annuity20EJB.jar,META-INF/ejb-jar.xml  DB2UDBNT_V72_1]]]')
Utilizando Jython con coincidencia de patrones:
AdminApp.install('myapp.ear', ['-BackendIdSelection',
 [['.*', 'Annuity20EJB.jar,.*', 'DB2UDBNT_V72_1']]])

BindJndiForEJBBusiness

La opción BindJndiForEJBBusiness enlaza módulos EJB con interfaces de empresa con nombres JNDI. Asegúrese de que cada módulo EJB con interfaces de empresa se enlaza con un nombre JNDI.

El contenido actual de la opción después de ejecutar los enlaces predeterminados es:
  • Módulo: Ejb1
  • Bean: MessageBean
  • URI: sample.jar,META-INF/ejb-jar.xml
  • Interfaz de empresa: com.ibm.sample.business.bnd.LocalTargetOne
  • Nombre JNDI: []: ejblocal:ejb/LocalTargetOne

Si especifica el nombre JNDI de recurso de destino con la opción BindJndiForEJBNonMessageBinding, no especifique un nombre JNDI de interfaz de empresa en la opción BindJndiForEJBBusiness. Si no especifica el nombre JNDI de recurso de destino, especifique un nombre JNDI de interfaz de empresa. Si no especifica un nombre JNDI de interfaz de empresa, el tiempo de ejecución proporciona un contenedor por omisión.

Para obtener una vista sin interfaz, el valor de interfaz de empresa debe ser una serie vacía ("").

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install $ear {-BindJndiForEJBBusiness {{ ejb_1.jar ejb1 
  ejb_1.jar,META-INF/ejb-jar.xml test.ejb1 jndi1 }}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install $ear {-BindJndiForEJBBusiness {{ .* .* .*.jar,.* test.ejb1 jndi1 }}}
En Jython:
AdminApp.install(ear, '[-BindJndiForEJBBusiness [[ejb_1.jar ejb1 
  ejb_1.jar,META-INF/ejb-jar.xml test.ejb1 jndi1 ]]]')
Utilizando Jython con coincidencia de patrones:
AdminApp.install(ear, '[-BindJndiForEJBBusiness [[.* .* .*.jar,.* test.ejb1 jndi1]]]')

BindJndiForEJBMessageBinding

La opción BindJndiForEJBMessageBinding enlaza enterprise beans controlados por mensajes con nombres de puerto de escucha o para nombres JNDI (Java Naming and Directory Interface). Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea. Cuando se enlaza un enterprise bean controlado por mensajes con un nombre JNDI de especificación de activación, también puede especificarse el nombre JNDI de destino y el alias de autenticación.

Cada elemento de la opción BindJndiForEJBMessageBinding consta de los campos siguientes: EJBModule, EJB, uri, listenerPort, JNDI, jndi.dest y actspec.auth. A algunos de estos campos se les pueden asignar valores: listenerPort, JNDI, jndi.dest y actspec.auth

El contenido actual de la opción después de ejecutar los enlaces predeterminados es:
  • Módulo: Ejb1
  • Bean: MessageBean
  • URI: ejb-jar-ic.jar,META-INF/ejb-jar.xml
  • Puerto de escucha: [null]:
  • Nombre JNDI: [eis/MessageBean]:
  • Nombre JNDI de destino: [jms/TopicName]:
  • Alias de autenticación ActivationSpec: [null]:

Si no se proporciona una propiedad de configuración de activación destinationLookup como una anotación o en el descriptor de despliegue y no hay un nombre JNDI de destino en el archivo de enlace de IBM, el nombre JNDI de destino predeterminado se recopila de la referencia del mensaje correspondiente.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install $ear {-BindJndiForEJBMessageBinding {{Ejb1 MessageBean 
 ejb-jar-ic.jar,META-INF/ejb-jar.xml myListenerPort jndi1 jndiDest1 actSpecAuth1}}} 
Utilizando Jacl con coincidencia de patrones:
$AdminApp install $ear {-BindJndiForEJBMessageBinding {{.*  .*
  .*.jar,.* myListenerPort jndi1 jndiDest1 actSpecAuth1}}}
En Jython:
AdminApp.install( ear, ['-BindJndiForEJBMessageBinding',
 [['Ejb1', 'MessageBean', 'ejb-jar-ic.jar,META-INF/ejb-jar.xml', 'myListenerPort',
 'jndi1', 'jndiDest1', 'actSpecAuth1']]]) 
Utilizando Jython con coincidencia de patrones:
AdminApp.install( ear, ['-BindJndiForEJBMessageBinding',
 [['.*', '.*', '.*.jar,.*', 'myListenerPort', 'jndi1', 'jndiDest1', 'actSpecAuth1']]])

BindJndiForEJBNonMessageBinding

La opción BindJndiForEJBNonMessageBinding enlaza los enterprise beans con los nombres JNDI (Java Naming and Directory Interface). Asegúrese de que todos los enterprise bean controlados por mensajes de la aplicación o el módulo estén enlazados a nombres de la JNDI. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

El contenido actual de la opción después de ejecutar los enlaces predeterminados es:
  • Módulo: Ejb1
  • Bean: MessageBean
  • URI: ejb-jar-ic.jar,META-INF/ejb-jar.xml
  • Nombre JNDI de recurso de destino: [com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC]
  • Nombre JNDI de inicio local: [null]
  • Nombre JNDI de inicio remoto: [null]

Existen limitaciones especiales para los módulos de Enterprise JavaBeans (EJB) 3.0 y posteriores. Si especifica el nombre JNDI de recurso de destino, no especifique los nombres JNDI de inicio local o de inicio remoto. Tampoco puede especificar el campo JNDI para interfaces de empresa en la opción BindJndiForEJBBusiness. Si no especifica el nombre JNDI de recurso de destino, los campos de nombre JNDI de inicio local y remoto son opcionales. Si no especifica nombres JNDI de inicio local y remoto, el tiempo de ejecución proporciona un contenedor predeterminado.

Si no utiliza módulos EJB 3.0, debe especificar el nombre JNDI de recurso de destino.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

En Jacl:

[Windows]
$AdminApp install c:/myapp.ear {-BindJndiForEJBNonMessageBinding {{Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC ""  ""}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install /myapp.ear {-BindJndiForEJBNonMessageBinding {{Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC ""  ""}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install raíz_servidor_aplicapps/myapps/installableApps/JobbankTargetEJBApp.ear
 {-BindJndiForEJBNonMessageBinding {{.* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
 ejb/com/app/ResumeBank/ResumeBank "" "" }}}

Utilizando Jython:

[Windows]
AdminApp.install('C:/myapp.ear', '[-BindJndiForEJBNonMessageBinding [[Ejb1 MessageBean
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""]]]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', '[-BindJndiForEJBNonMessageBinding [[Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""]]]')
Utilizando Jython con coincidencia de patrones:
AdminApp.install('raíz_servidor_aplic/apps/myapps/installableApps/JobbankTargetEJBApp.ear',
 '[ -BindJndiForEJBNonMessageBinding [[ .* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
 ejb/com/app/ResumeBank/ResumeBank "" "" ]] ]' )

blaname

Utilice la opción blaname para especificar el nombre de la aplicación de nivel de negocio en la que el sistema crea la aplicación Java EE. Esta opción es opcional. Si no especifica un valor, el sistema establece el nombre como el nombre de aplicación Java EE. Esta opción sólo está disponible con el mandato install.

buildVersion

La opción buildVersion visualiza la versión de build de un archivo EAR de la aplicación. Esta opción no se puede modificar porque es de solo lectura. Esta opción devuelve la información de la versión de compilación para un archivo EAR de la aplicación si ha especificado la versión de compilación en el archivo EAR de la aplicación MANIFEST.MF.

cell

La opción cell especifica el nombre de célula para instalar o actualizar toda una aplicación o para actualizar una aplicación con objeto de añadir un módulo nuevo. Si desea actualizar toda una aplicación, esta opción sólo se aplica si la aplicación contiene un nuevo módulo que no existe en la aplicación instalada.

Uso del ejemplo de modalidad de proceso por lotes

En Jacl:

[Windows]
$AdminApp install "C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell
nombre_célula}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install
"/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell nombre_célula}

Utilizando Jython:

[Windows]
AdminApp.install('C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell
nombre_célula]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell nombre_célula]')

clientMode

La opción clientMode especifica si se van a desplegar módulos de cliente en un destino de despliegue aislado (isolated), un nodo federado de un gestor de despliegue (federated) o un servidor de aplicaciones (server_deployed). Si especifica esta opción, instale los módulos de cliente solo en un destino de despliegue de la versión 8.0 o posterior.

El valor predeterminado es isolated.

La selección de la modalidad de despliegue del cliente afecta a cómo se manejan las búsquedas java:. Todos los espacios de nombres de URL Java (global, aplicación, módulo y componente) son locales en los procesos de cliente aislada. Los espacios de nombres residen en procesos de cliente desplegados por servidor y federados. El servidor o clúster elegido como destino para un módulo de cliente determina el lugar en el que se crean los espacios de nombres. Todas las búsquedas java: para módulos de cliente desplegados por servidor o federados se dirigen al servidor de destino o clúster. El módulo de cliente no se ejecuta realmente en el servidor de destino o clúster. Varias instancias del mismo módulo de cliente compartirán el espacio de nombres de modalidades desplegadas de servidor y federadas. Seleccionar la modalidad federada es simplemente una declaración de intención para lanzar el módulo de cliente mediante JNLP (Java Network Launching Protocol), pero los mecanismos JNDI (Java Naming and Directory Interface) de las modalidades desplegadas de servidor y federadas son los mismos.

clúster

La opción cluster especifica el nombre de clúster para instalar o actualizar toda una aplicación o para actualizar una aplicación con objeto de añadir un módulo nuevo. Esta opción sólo se aplica en el entorno de WebSphere Application Server, Network Deployment. Si desea actualizar toda una aplicación, esta opción sólo se aplica si la aplicación contiene un nuevo módulo que no existe en la aplicación instalada. Las opciones -cluster y -server no se pueden utilizar juntas.

Si desea desplegar una aplicación y especificar el servidor HTTP durante el despliegue para que la aplicación aparezca en el archivo plugin-cfg.xml generado, en primer lugar, debe instalar la aplicación con un destino de -cluster. Después de instalar la aplicación y antes de guardar, utilice el mandato edit del objeto AdminApp para añadir la correlación adicional con el servidor web.

Uso del ejemplo de modalidad de proceso por lotes

En Jacl:

[Windows]
$AdminApp install "C:/myapp.ear" {-cluster clusterName}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install "myapp.ear" {-cluster Nombreclúster}

Utilizando Jython:

[Windows]
AdminApp.install('C:/myapp/myapp.ear', '[-cluster clusterName]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('/myapp/myapp.ear', '[-cluster Nombreclúster]')

contents

La opción contents especifica el archivo que incluye el contenido que desea actualizar. Por ejemplo, dependiendo del tipo de contenido, el archivo puede ser un archivo EAR, un módulo, un zip parcial o un solo archivo. La vía de acceso del archivo debe ser local para el cliente del script. La opción contents es necesaria, a menos que haya especificado la opción delete.

contenturi

La opción contenturi especifica el URI del archivo que añade, actualiza o elimina de una aplicación. Esta opción sólo se aplica al mandato update. La opción contenturi es necesaria si el tipo de contenido es file o modulefile. Esta opción se ignora para otros tipos de contenido.

contextroot

La opción contextroot especifica el directorio raíz de contexto que se va utilizar al instalar un archivo WAR (web application archive) autónomo.

CorrectOracleIsolationLevel

La opción CorrectOracleIsolationLevel especifica el nivel de aislamiento para el proveedor tipo Oracle. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea. El último campo de cada entrada especifica el nivel de aislamiento. Los valores válidos del nivel de aislamiento son 2 o 4.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Sólo es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install myapp.ear {-CorrectOracleIsolationLevel
 {{AsyncSender jms/MyQueueConnectionFactory jms/Resource1 2}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install myapp.ear {-CorrectOracleIsolationLevel
  {{.*  jms/MyQueueConnectionFactory jms/Resource1 2}}
Utilizando Jython:
AdminApp.install('myapp.ear', '[-CorrectOracleIsolationLevel
 [[AsyncSender jms/MyQueueConnectionFactory jms/Resource1 2]]]')
Utilizando Jython con coincidencia de patrones:
AdminApp.install('myapp.ear', ['-CorrectOracleIsolationLevel',
 [['.*', 'jms/MyQueueConnectionFactory', 'jms/Resource1', 2]]])

CorrectUseSystemIdentity

La opción CorrectUseSystemIdentity sustituye RunAs System por RunAs Roles. Los enterprise beans que instala contienen una identidad del sistema RunAs. De modo opcional, puede cambiar esta identidad por un rol RunAs. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install myapp.ear {-CorrectUseSystemIdentity {{Inc "Increment Bean Jar"
 Increment.jar,META-INF/ejb-jar.xml getValue() RunAsUser2 user2 password2} 
 {Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml Increment()
 RunAsUser2 user2 password2}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install myapp.ear {-CorrectUseSystemIdentity
 {{.*  .*  .*  getValue() RunAsUser2 user2 password2}
 {.*  .*  .*  Increment() RunAsUser2 user2 password2}}}
Utilizando Jython:
AdminApp.install('myapp.ear', '[-CorrectUseSystemIdentity
 [[Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml getValue()
 RunAsUser2 user2 password2] 
 [Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml Increment()
 RunAsUser2 user2 password2]]]')
Utilizando Jython con coincidencia de patrones:
AdminApp.install('myapp.ear', ['-CorrectUseSystemIdentity',
 [['.*', '.*', '.*', 'getValue()', 'RunAsUser2', 'user2', 'password2'],
 ['.*', '.*', '.*', 'Increment()', 'RunAsUser2', 'user2', 'password2']]])

createMBeansForResources

La opción createMBeansForResources especifica que se crean MBeans para todos los recursos como, por ejemplo, servlets, archivos JSP (JavaServer Pages) y enterprise beans, que se definen en una aplicación cuando se inicia la aplicación en un destino de despliegue. Esta opción no necesita obligatoriamente un valor. El valor predeterminado es la opción nocreateMBeansForResources.

CtxRootForWebMod

La opción CtxRootForWebMod edita el directorio raíz de contexto del módulo web. Con esta opción puede editar un directorio raíz de contexto definido en el archivo application.xml. El contenido actual de esta opción después de ejecutar los enlaces predeterminados es el siguiente:
  • Módulo web: xxx
  • URI: xxx
  • ContextRoot: <raíz contexto>
Si el módulo web es un Servlet 2.5, el contenido de esta opción se llena sólo a partir del descriptor de despliegue XML. Con esta opción, no se puede obtener la información de despliegue a partir de las anotaciones.

Uso del ejemplo de modalidad de proceso por lotes

En Jacl:

$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
 {-appname ivtApp -CtxRootForWebMod
 {{"IVT Application" ivt_app.war,WEB-INF/web.xml /mycontextroot}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install myapp.ear {-appname MyApp -CtxRootForWebMod {{.* .* /mycontextroot}}}

Utilizando Jython:

AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
 ['-appname', 'ivtApp ', '-CtxRootForWebMod',
 [["IVT Application", 'ivt_app.war,WEB-INF/web.xml', '/mycontextroot']]])
Utilizando Jython con coincidencia de patrones:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-CtxRootForWebMod',
 [['.*', '.*', '/mycontextroot']]])

personalizada

La opción custom especifica un par nombre-valor utilizando el formato nombre=valor. Utilice la opción custom para pasar opciones a las extensiones de despliegue de aplicaciones. Consulte la documentación sobre extensiones de despliegue de aplicaciones para conocer las opciones custom disponibles.

CustomActivationPlan

La opción CustomActivationPlan especifica los componentes del tiempo de ejecución que se debe añadir a, o eliminar de, los componentes predeterminados del tiempo de ejecución que se utilizan para ejecutar la aplicación. Utilice esta opción sólo si el servidor de aplicaciones no puede obtener todos los componentes de tiempo de ejecución necesarios inspeccionando la aplicación.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jython:
AdminApp.install('Increment.jar','[-CustomActivationPlan [["Increment Enterprise Java Bean"
 Increment.jar,META-INF/ejb-jar.xml WebSphere:specname=WS_ComponentToAdd ""]]')
Utilizando Jython con coincidencia de patrones:
AdminApp.install('Increment.jar','[-CustomActivationPlan [[.*
 Increment.jar,META-INF/ejb-jar.xml WebSphere:specname=WS_ComponentToAdd ""]]')
Tabla 1. Componentes CustomActivationPlan a añadir. Especifique un valor para WS_ComponentToAdd en el mandato.
Component valor de WS_ComponentToAdd
contenedor EJB WS_EJBContainer
Contenedor de portlet WS_PortletContainer
JSF (JavaServer Faces) WS_JSF
Contenedor SIP WS_SipContainer
Servicio de ámbito de compensación WS_Compensation
Perfil de aplicación WS_AppProfile
Sesión de actividad WS_ActivitySession
Internacionalización WS_I18N
Beans de arranque WS_StartupService

DataSourceFor10CMPBeans

La opción DataSourceFor10CMPBeans especifica los orígenes de datos opcionales para los beans 1.x CMP (persistencia gestionada por contenedor) individuales. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

La correlación de un origen de datos específico con un bean CMP altera temporalmente el origen de datos predeterminado del módulo que contiene el enterprise bean. Cada elemento de la opción DataSourceFor10CMPBeans está formado por los siguientes campos: EJBModule, EJB, uri, JNDI, userName, password, login.config.name y auth.props. De estos campos, se pueden asignar valores a los siguientes: JNDI, userName, password, login.config.name y auth.props.

El contenido actual de la opción después de ejecutar los enlaces predeterminados es:
  • Módulo: Increment CMP 1.1 EJB
  • Bean: IncCMP11
  • URI: IncCMP11.jar,META-INF/ejb-jar.xml
  • Nombre JNDI de recurso de destino: [DefaultDatasource]:
  • Nombre de usuario: [null]:
  • Contraseña: [null]:
  • Nombre de configuración de inicio de sesión: [null]: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
  • Propiedades: [null]: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.

Si login.config.name se establece en DefaultPrincipalMapping, se crea una propiedad con el nombre com.ibm.mapping.authDataAlias. El valor de la propiedad lo establece auth.props. Si login.config.name no se establece en DefaultPrincipalMapping, auth.props puede especificar varias propiedades. El formato de la serie es websphere:name= <nombre1>,value=<valor1>,description=<descripción1>. Para especificar varias propiedades utilice el signo más (+) .

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

En Jacl:

[Windows]
$AdminApp install C:/app1.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB"
 IncCMP11 IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}} 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB" IncCMP11
 IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}} 

Utilizando Jacl con coincidencia de patrones:

[Windows]
$AdminApp install C:/myapp.ear {-DataSourceFor10CMPBeans {{.*  .*  
 IncCMP11.jar,.* myJNDI user1 password1 loginName1 authProps1}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{.*  .*  IncCMP11.jar,.*
 myJNDI user1 password1 loginName1 authProps1}}}

Utilizando Jython:

[Windows]
AdminApp.install('C:/app1.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
 'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1', 'password1',
 'loginName1', 'authProps1']]]) 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
 'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1',
 'password1', 'loginName1', 'authProps1']]]) 

Utilizando Jython con coincidencia de patrones:

[Windows]
AdminApp.install('C:/myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*', 
 'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*',
 'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])

DataSourceFor20CMPBeans

La opción DataSourceFor20CMPBeans especifica los orígenes de datos opcionales para los beans 2.x CMP (persistencia gestionada por contenedor (CMP)individuales. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

La correlación de un origen de datos específico con un bean CMP altera temporalmente el origen de datos predeterminado del módulo que contiene el enterprise bean. Cada elemento de la opción DataSourceFor20CMPBeans está formado por los siguientes campos: EJBModule, EJB, uri, JNDI, resAuth, login.config.name y auth.props. De estos campos, se pueden asignar valores a los siguientes: JNDI, resAuth, login.config.name y auth.props.

El contenido actual de la opción después de ejecutar los enlaces predeterminados es:
  • Módulo: Increment enterprise bean
  • Bean: Increment
  • URI: Increment.jar,META-INF/ejb-jar.xml
  • Nombre JNDI de recurso de destino: [null]:
  • Autorización de recursos: [Por aplicación]:
  • Nombre de configuración de inicio de sesión: [null]: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
  • Propiedades: []: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.

Si login.config.name se establece en DefaultPrincipalMapping, se crea una propiedad con el nombre com.ibm.mapping.authDataAlias. El valor de la propiedad lo establece auth.props. Si login.config.name no se establece en DefaultPrincipalMapping, auth.props puede especificar varias propiedades. El formato de la serie es websphere:name= <nombre1>,value=<valor1>,description=<descripción1>. Para especificar varias propiedades utilice el signo más (+) .

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Sólo es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install Increment.jar {-DataSourceFor20CMPBeans
 {{"Increment Enterprise Java Bean" Increment
 Increment.jar,META-INF/ejb-jar.xml jndi1 container "" ""}}} 
Utilizando Jacl con coincidencia de patrones:
$AdminApp install Increment.jar {-DataSourceFor20CMPBeans {{.*  .*
 Increment.jar,.*  jndi1 container "" ""}}}
Utilizando Jython:
AdminApp.install('Increment.jar', ['-DataSourceFor20CMPBeans',
 [["Increment Enterprise Java Bean", 'Increment',
 'Increment.jar,META-INF/ejb-jar.xml', 'jndi1', 'container', '', '']]])
Utilizando Jython con coincidencia de patrones:
AdminApp.install('Increment.jar', ['-DataSourceFor20CMPBeans', [['.*', '.*',
 'Increment', 'Increment.jar,.*', 'jndi1', 'container', '', '']]])

DataSourceFor10EJBModules

La opción DataSourceFor10EJBModules especifica el origen de datos predeterminado para el módulo de enterprise bean que contiene los beans 1.x CMP (persistencia gestionada por contenedor. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

Cada elemento de la opción DataSourceFor10EJBModules está formado por los campos siguientes: EJBModule, uri, JNDI, userName, password, login.config.name y auth.props. De estos campos, se pueden asignar valores a los siguientes: JNDI, userName, password, login.config.name y auth.props.

El contenido actual de la opción después de ejecutar los enlaces predeterminados es:
  • Módulo: Increment CMP 1.1 enterprise bean
  • uri: IncCMP11.jar,META-INF/ejb-jar.xml
  • Nombre JNDI de recurso de destino: [DefaultDatasource]:
  • Nombre de usuario: [null]:
  • Contraseña: [null]:
  • Nombre de configuración de inicio de sesión: [null]: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
  • Propiedades: [null]: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.

Si login.config.name se establece en DefaultPrincipalMapping, se crea una propiedad con el nombre com.ibm.mapping.authDataAlias. El valor de la propiedad lo establece auth.props. Si login.config.name no se establece en DefaultPrincipalMapping, auth.props puede especificar varias propiedades. El formato de la serie es websphere:name= <nombre1>,value=<valor1>,description=<descripción1>. Para especificar varias propiedades utilice el signo más (+) .

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install myapp.ear {-DataSourceFor10EJBModules {{"Increment CMP 1.1 EJB"
 IncCMP11.jar,META-INF/ejb-jar.xml yourJNDI user2 password2 loginName authProps}}} 
Utilizando Jacl con coincidencia de patrones:
$AdminApp install myapp.ear {-DataSourceFor10EJBModules
 {{.* IncCMP11.jar,.* yourJNDI user2 password2 loginName authProps}}}
Utilizando Jython:
AdminApp.install('myapp.ear', ['-DataSourceFor10EJBModules', [["Increment CMP 1.1 EJB",
 'IncCMP11.jar,META-INF/ejb-jar.xml', 'yourJNDI', 'user2', 'password2', 
 'loginName', 'authProps']]]) 
Utilizando Jython con coincidencia de patrones:
AdminApp.install('myapp.ear', ['-DataSourceFor10EJBModules',
 [['.*', 'IncCMP11.jar,.*', 'yourJNDI', 'user2', 'password2', 'loginName', 'authProps']]])

DataSourceFor20EJBModules

La opción DataSourceFor20EJBModules especifica el origen de datos predeterminado para el módulo de enterprise bean 2.x que contiene los beans 2.x CMP (persistencia gestionada por contenedor). Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

Cada elemento de la opción DataSourceFor20EJBModules está formado por los siguientes campos: EJBModule, uri, JNDI, resAuth, login.config.name y auth.props. De estos campos, se pueden asignar valores a los siguientes: JNDI, resAuth, login.config.name, auth.props y propiedades del origen de datos ampliado.

El contenido actual de la opción después de ejecutar los enlaces predeterminados es:
  • Módulo: Increment enterprise bean
  • URI: Increment.jar,META-INF/ejb-jar.xml
  • Nombre JNDI de recurso de destino: [DefaultDatasource]:
  • Autorización de recursos: [Por aplicación]:
  • Nombre de configuración de inicio de sesión: [null]: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
  • Propiedades: []: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
  • Propiedades del origen de datos ampliado: []: Utilice esta opción para que un origen de datos que emplee la agrupación heterogénea pueda conectarse a una base de datos DB2. El patrón para la propiedad es property1=value1+property2=value2.

El último campo de cada entrada de esta tarea especifica el valor de la autorización de recursos. Los valores válidos para la autorización de recursos son por fábrica de conexiones o contenedor.

Si login.config.name se establece en DefaultPrincipalMapping, se crea una propiedad con el nombre com.ibm.mapping.authDataAlias. El valor de la propiedad lo establece auth.props. Si login.config.name no se establece en DefaultPrincipalMapping, auth.props puede especificar varias propiedades. El formato de la serie es websphere:name= <nombre1>,value=<valor1>,description=<descripción1>. Para especificar varias propiedades utilice el signo más (+) .

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren actualizarse.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install Increment.jar {-DataSourceFor20EJBModules
 {{"Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 jndi2 container "" "" ""}}} 
Utilizando Jacl con coincidencia de patrones:
$AdminApp install Increment.jar {-DataSourceFor20EJBModules {{.*
 Increment.jar,.* jndi2 container "" "" ""}}}
Nota: Si utiliza diversos valores para propiedades de origen de datos ampliados, tendrá que asignar los valores a una variable y utilizar esa variable para el valor de la propiedad. Por ejemplo:
set s \"value1,value2\"
En la sustitución de mandatos, refiérase a la variable tal como se muestra en el ejemplo siguiente:
"clientApplicationInformation=value1,value2" with "clientapplication=$s"
Utilizando Jython:
AdminApp.install('Increment.jar', ['-DataSourceFor20EJBModules',
 [["Increment Enterprise Java Bean", 'Increment.jar,META-INF/ejb-jar.xml',
 'jndi2', 'container', '', '', '']]])
Utilizando Jython con coincidencia de patrones:
AdminApp.install('Increment.jar', ['-DataSourceFor20EJBModules',
 [['.*', 'Increment.jar,.*', 'jndi2', 'container', '', '', '']]])
Nota: Si utiliza diversos valores para propiedades de origen de datos ampliados, escriba los dos valores entre comillas. Por ejemplo:
'property1="value1,value2"+property2="value3,value4"'

defaultbinding.cf.jndi

La opción defaultbinding.cf.jndi especifica el nombre JNDI (Java Naming and Directory Interface) para la fábrica de conexiones predeterminada.

defaultbinding.cf.resauth

La opción defaultbinding.cf.resauth especifica la autorización RESAUTH para la fábrica de conexiones.

defaultbinding.datasource.jndi

La opción defaultbinding.datasource.jndi especifica el nombre JNDI (Java Naming and Directory Interface) para el origen de datos predeterminado.

defaultbinding.datasource.password

La opción defaultbinding.datasource.password especifica la contraseña para el origen de datos predeterminado.

defaultbinding.datasource.username

La opción defaultbinding.datasource.username especifica el nombre de usuario para el origen de datos predeterminado.

defaultbinding.ee.defaults

New feature New feature:
newfeat
La opción defaultbinding.ee.defaults especifica que se utilice la opción de recursos predeterminada preconfigurada para Java EE.

defaultbinding.ejbjndi.prefix

La opción defaultbinding.ejbjndi.prefix especifica el prefijo para el nombre JNDI (Java Naming and Directory Interface) de enterprise bean.

[z/OS] Para utilizar la opción defaultbinding.ejbjndi.prefix de la plataforma z/OS, también debe especificar la opción usedefaultbindings. Si no especifica la opción usedefaultbindings, el valor predeterminado es la opción nousedefaultbindings.

defaultbinding.force

La opción defaultbinding.force especifica que los enlaces predeterminados alteran temporalmente los enlaces actuales.

defaultbinding.strategy.file

La opción defaultbinding.strategy.file especifica un archivo de estrategia de enlaces predeterminados personalizado.

defaultbinding.virtual.host

La opción defaultbinding.virtual.host especifica el nombre predeterminado para un host virtual.

depl.extension.reg (en desuso)

Deprecated feature Deprecated feature: La opción depl.extension.reg está en desuso. No hay ninguna opción de duplicación disponible.depfeat

deployejb

La opción deployejb especifica que se ejecute la herramienta EJBDeploy durante la instalación. Esta opción no necesita obligatoriamente un valor. EJBDeploy se ejecuta durante la instalación de los módulos EJB 1.x o 2.x. La herramienta de despliegue de EJB no se ejecuta durante la instalación de módulos EJB 3.x.

Esta opción se ignora cuando el EAR o módulo que debe instalarse o actualizarse contiene un descriptor de despliegue de aplicaciones Java Platform, Enterprise Edition (Java EE) 7, un descriptor de despliegue de módulos EJB 3.2 o un descriptor de despliegue de módulos Web 3.1.

Si vuelve a desplegar el archivo EAR (Application Enterprise Archive) con la utilidad EJBDeploy, el valor predeterminado es nodeployejb. Si no es así, toma el valor predeterminado deployejb.

Debe utilizar esta opción deployejb en las situaciones siguientes:
  • El archivo EAR se ha ensamblado utilizando una herramienta de ensamblaje, como Rational Application Developer y la herramienta EJBDeploy no se ha ejecutado durante el ensamblaje.
  • El archivo EAR no se ha ensamblado utilizando una herramienta de ensamblaje, como Rational Application Developer.
  • El archivo EAR se ha ensamblado utilizando las versiones de Application Assembly Tool (AAT) anteriores a la versión 5.0.

Si un módulo EJB está empaquetado en un archivador web (WAR), no es necesario que utilice esta opción deployejb.

Para esta opción, instálelos sólo en un destino de despliegue Versión 9.0.

deployejb.classpath

La opción deployejb.classpath especifica una vía de acceso de clases extra para la herramienta EJBDeploy.

deployejb.complianceLevel

La opción deployejb.complianceLevel especifica el nivel de conformidad JDK para la herramienta EJBDeploy.

Los valores posibles son:
1.4
(default) 5.0 6.0

Para obtener una lista de los niveles de conformidad de JDK soportados actualmente, ejecute el mandato ejbdeploy -?

deployejb.dbschema

La opción deployejb.dbschema especifica el esquema de base de datos para la herramienta EJBDeploy.

deployejb.dbtype

La opción deployejb.dbtype especifica el tipo de base de datos para la herramienta EJBDeploy.

Los valores posibles son:
DB2UDB_V81 DB2UDB_V82 DB2UDB_V91 DB2UDB_V95 DB2UDBOS390_V8 DB2UDBOS390_NEWFN_V8 DB2UDBOS390_V9 
 DB2UDBISERIES_V53 DB2UDBISERIES_V54 DB2UDBISERIES_V61  DERBY_V10 DERBY_V101 INFORMIX_V100 INFORMIX_V111 INFORMIX_V115 
 MSSQLSERVER_2005 ORACLE_V10G ORACLE_V11G SYBASE_V15 SYBASE_V125
Las bases de datos siguientes dan soporte a SQLJ (Structured Query Language in Java): DB2UDB_V82, DB2UDB_V81, DB2UDBOS390_V7 y DB2UDBOS390_V8.

Para obtener una lista de los tipos de proveedores de bases de datos a los que se da soporte, ejecute ejbdeploy -?

deployejb.dbaccesstype

La opción deployejb.dbaccesstype especifica el tipo de acceso de base de datos para la herramienta EJBDeploy. Los valores válidos son SQLj y JDBC. El valor predeterminado es JDBC.

deployejb.rmic

La opción deployejb.rmic especifica opciones RMIC extra para utilizar para la herramienta EJBDeploy.

deployejb.sqljclasspath

La opción deployejb.sqljclasspath especifica la ubicación de las clases del conversor SQLJ.

deployws

La opción deployws especifica que se desplieguen los servicios web durante la instalación. Esta opción no necesita obligatoriamente un valor.

El valor por omisión es: nodeployws.

deployws.classpath

La opción deployws.classpath especifica la vía de acceso de clases extra que se va a utilizar al desplegar los servicios web.

Para especificar las classpaths de varias entradas, separe las entradas con el mismo separador que se utiliza con la variable de entorno CLASSPATH.

[Windows]Utilice un punto y coma (;) para separar las entradas nativas.

[AIX][HP-UX][Linux][Solaris][z/OS]Utilice un signo de dos puntos para separar las entradas.

deployws.jardirs

La opción deployws.jardirs especifica los directorios de extensión extra que se van a utilizar al desplegar los servicios web.

distributeApp

La opción distributeApp especifica que el componente de gestión de aplicaciones distribuye los archivos binarios de la aplicación. Esta opción no necesita obligatoriamente un valor. Este es el valor por omisión.

EmbeddedRar

La opción EmbeddedRar enlaza los objetos Java 2 Connector con nombres JNDI. Debe enlazar cada objeto J2C (Java 2 Connector) en la aplicación o el módulo, como las fábricas de conexiones J2C, las especificaciones de activación J2C y los objetos administrativos J2C, con un nombre JNDI. Cada elemento de la opción EmbeddedRar contiene los siguientes pasos: RARModule, uri, j2cid, j2c.name, j2c.jndiName. Puede asignar los siguientes valores a los campos: j2c.name, j2c.jndiName.

El contenido actual de la opción después de ejecutar los enlaces predeterminados es:
Módulo de conector: <nombre módulo rar>
URI: <nombre rar>,META-INF/ra.xml 
Identificador de objeto: <identificador del objeto J2C> 
Nombre: j2cid
Nombre JNDI: eis/j2cid
donde j2cid es:
Fábrica de conexiones J2C: connectionFactoryInterface
Objeto admin J2C: adminObjectInterface
Especificación de activación J2C: tipo de escucha de mensaje

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Si el ID n es exclusivo en el archivo ra.xml, se añadirá -<number>. Por ejemplo, javax.sql.DataSource-2.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install $embeddedEar {-EmbeddedRar {{"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml 
 javax.sql.DataSource javax.sql.DataSource1 eis/javax.sql.javax.sql.DataSSource1} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml javax.sql.DataSource2 javax.sql.DataSource2 eis/javax.sql.DataSource2} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener javax.jms.MessageListener1 eis/javax.jms.MessageListener1} {"FVT Resource 
 Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageLListener2 javax.jms.MessageListener2 eis/javax.jms.MessageListener2} 
 {"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml fvt.adapter.message.FVTMessageProvider 
 fvt.adapter.message.FVTMessageProvider1 eis/fvt.adapter.message.FVTMessageProvider1} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml fvt.adapter.message.FVTMessageProvider2 fvt.adapter.message.FVTMessageProvider2 
 eis/fvt.adapter.message.FVTMessageProvider2}}} 
Utilizando Jacl con coincidencia de patrones:
$AdminApp install $embeddedEar {-EmbeddedRar {{.*  .*  .*  javax.sql.DataSource1  
 eis/javax.sql.javax.sql.DataSSource1} {.*  .*  .*  javax.sql.DataSource2  eis/javax.sql.DataSource2} {.*  .*  .*  
 javax.jms.MessageListener1  eis/javax.jms.MessageListener1} {.*  .*  .*  javax.jms.MessageListener2  
 eis/javax.jms.MessageListener2} {.*  .*  .*  fvt.adapter.message.FVTMessageProvider1  
 eis/fvt.adapter.message.FVTMessageProvider1} {.*  .*  .*  fvt.adapter.message.FVTMessageProvider2  
 eis/fvt.adapter.message.FVTMessageProvider2}}}
Utilizando Jython:
AdminApp.install(embeddedEar, ['-EmbeddedRar', [["FVT Resource Adapter", 
 'jca15cmd.rar,META-INF/ra.xml', 'javax.sql.DataSource', 'javax.sql.DataSource1', 'eis/javax.sql.javax.sql.DataSSource1'], ["FVT 
 Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml javax.sql.DataSource2', 'javax.sql.DataSource2', 'eis/javax.sql.DataSource2'], 
 ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener', 'javax.jms.MessageListener1', 
 'eis/javax.jms.MessageListener1'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageLListener2', 
 'javax.jms.MessageListener2', 'eis/javax.jms.MessageListener2'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml 
 fvt.adapter.message.FVTMessageProvider', 'fvt.adapter.message.FVTMessageProvider1', 
 'eis/fvt.adapter.message.FVTMessageProvider1'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 
 'fvt.adapter.message.FVTMessageProvider2', 'fvt.adapter.message.FVTMessageProvider2', 
 'eis/fvt.adapter.message.FVTMessageProvider2']]]) 
Utilizando Jython con coincidencia de patrones:
AdminApp.install(embeddedEar, ['-EmbeddedRar', [['.*', '.*', '.*', 'javax.sql.DataSource1', 
 'eis/javax.sql.javax.sql.DataSSource1'], ['.*', '.*', '.*', 'javax.sql.DataSource2', 'eis/javax.sql.DataSource2'], ['.*', '.*', 
 '.*', 'javax.jms.MessageListener1', 'eis/javax.jms.MessageListener1'], ['.*', '.*', '.*', 'javax.jms.MessageListener2', 
 'eis/javax.jms.MessageListener2'], ['.*', '.*', '.*', 'fvt.adapter.message.FVTMessageProvider1', 
 'eis/fvt.adapter.message.FVTMessageProvider1'], ['.*', '.*', '.*', 'fvt.adapter.message.FVTMessageProvider2', 
 'eis/fvt.adapter.message.FVTMessageProvider2']]])

enableClientModule

La opción enableClientModule especifica que se desplieguen los módulos de cliente. Seleccione esta opción si el archivo a desplegar tiene uno o varios módulos de cliente que desea desplegar. Si selecciona esta opción, instale los módulos de cliente sólo en un destino de despliegue de la versión 8.0 o posterior.

Esta opción no necesita obligatoriamente un valor. El valor predeterminado es noenableClientModule. De forma predeterminada, se pasa por alto la opción enableClientModule durante el despliegue y no se despliegan los módulos de cliente.

EnsureMethodProtectionFor10EJB

La opción EnsureMethodProtectionFor10EJB selecciona las protecciones de método para los métodos no protegidos de enterprise bean 1.x. Especifica que se deje el método sin proteger o asigna un protección que deniega todo acceso. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install Increment.jar {-EnsureMethodProtectionFor10EJB
 {{"Increment EJB Module" IncrementEJBBean.jar,META-INF/ejb-jar.xml ""}
 {"Timeout EJB Module" TimeoutEJBBean.jar,META-INF/ejb-jar.xml
 methodProtection.denyAllPermission}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install myapp.ear {-EnsureMethodProtectionFor10EJB
 {{.* IncrementEJBBean.jar,.* ""} {.* TimeoutEJBBean.jar,.*
 methodProtection.denyAllPermission}}}
Utilizando Jython:
AdminApp.install('Increment.jar', '[-EnsureMethodProtectionFor10EJB
 [["Increment EJB Module" IncrementEJBBean.jar,META-INF/ejb-jar.xml ""]
 ["Timeout EJB Module" TimeoutEJBBean.jar,META-INF/ejb-jar.xml
 methodProtection.denyAllPermission]]]')
Utilizando Jython con coincidencia de patrones:
AdminApp.install('myapp.ear', ['-EnsureMethodProtectionFor10EJB',
 [['.*', 'IncrementEJBBean.jar,.*', ""], ['.*', 'TimeoutEJBBean.jar,.*', 
 'methodProtection.denyAllPermission']]])

El último campo de cada entrada de esta tarea especifica el valor de protección. Los valores de protección válidos son: methodProtection.denyAllPermission. También puede dejar el valor en blanco si desea que el método permanezca sin protección.

EnsureMethodProtectionFor20EJB

La opción EnsureMethodProtectionFor20EJB selecciona las protecciones de método para los métodos no protegidos de enterprise bean 2.x. Especifica que se asigne un rol de seguridad al método no protegido, añade el método a la lista de exclusión o marca el método como no seleccionado. Puede asignar varios roles a un método separando sus nombres por coma. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización de los datos existentes.

Uso del ejemplo de modalidad de proceso por lotes

En Jacl:

$AdminApp install myapp.ear {-EnsureMethodProtectionFor20EJB
 {{CustmerEjbJar customerEjb.jar,META-INF/ejb-jar.xml methodProtection.uncheck}
 {SupplierEjbJar supplierEjb.jar,META-INF/ejb-jar.xml methodProtection.exclude}}}

Utilizando Jacl con coincidencia de patrones:

$AdminApp install myapp.ear {-EnsureMethodProtectionFor20EJB
 {{.* customerEjb.jar,.* methodProtection.uncheck}
 {.* supplierEjb.jar,.* methodProtection.exclude}}}
Utilizando Jython:
AdminApp.install('myapp.ear', '[-EnsureMethodProtectionFor20EJB 
 [[CustmerEjbJar customerEjb.jar,META-INF/ejb-jar.xml methodProtection.uncheck]
 [SupplierEjbJar supplierEjb.jar,META-INF/ejb-jar.xml methodProtection.exclude]]]')
Utilizando Jython con coincidencia de patrones:
AdminApp.install('myapp.ear', ['-EnsureMethodProtectionFor20EJB',
 [['.*', 'customerEjb.jar,.*', 'methodProtection.uncheck'],
 ['.*', 'supplierEjb.jar,.*', 'methodProtection.exclude']]])

El último campo de cada entrada de esta tarea especifica el valor de protección. Los valores de protección válidos son: methodProtection.uncheck, methodProtection.exclude o una lista de roles de seguridad que están separados por comas.

filepermission

La opción filepermission le permite establecer los permisos de archivo adecuados para los archivos de aplicaciones que se encuentra en el directorio de instalación. Los permisos de archivo que se pueden especificar en el nivel de aplicación deben ser un subconjunto del permiso de archivo de nivel de nodos que defina el permiso de archivo menos estricto que se pueda especificar. De lo contrario, para establecer los permisos de archivo en el destino de instalación se utilizarán los valores de permisos de nivel de nodo. El patrón de nombre de archivo es una expresión regular. El valor predeterminado es el siguiente:
.*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
 {-appname MyApp -cell myCell -node myNode -server server1
 -filepermission .*\\.jsp=777#.*\\.xml=755}
Utilizando Jython:
AdminApp.install("raíz_servidor_aplic/installableApps/DynaCacheEsi.ear",
 ["-appname", "MyApp", "-cell", "myCell", "-node", "myNode", "-server", "server1",
 "-filepermission", ".*\\.jsp=777#.*\\.xml=755"])

installdir (en desuso)

Deprecated feature Deprecated feature: La opción installdir está en desuso. Esta opción se ha sustituido por la opción installed.ear.destination.depfeat

installed.ear.destination

La opción installed.ear.destination especifica el directorio donde se colocarán los binarios de la aplicación.

JSPCompileOptions

La opción JSPCompileOptions especifica opciones de compilación de Java ServerPages (JSP) para módulos web. Esta opción sólo es válida si también se utiliza la opción preCompileJSP. El contenido actual de esta opción tras ejecutar los enlaces predeterminados es el siguiente:
  • Módulo web: xxx
  • URI: xxx
  • Vía de acceso de clases JSP: <vía acceso clases jsp>
  • Utilizar nombres de paquetes completos: Yes | No
  • Nivel de origen JDK: xx
  • Inhabilitar compilación de tiempo de ejecución JSP: Yes | No

Para utilizar nombres de paquetes completos e inhabilitar la compilación de tiempo de ejecución JSP, especifique un valor de Yes o No en el idioma específico del entorno local. El producto da soporte a los valores de AppDeploymentOption.Yes y AppDeploymentOption.No, en lugar de a Yes y No. No obstante, se recomienda que especifique Yes o No en el idioma de su entorno local.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
 {-appname MyApp -preCompileJSPs -JSPCompileOptions {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml jspcp Yes 15 No}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install ivtApp.ear {-appname MyApp -preCompileJSPs -JSPCompileOptions
 {{.* .* jspcp  15 No}}}
Utilizando Jython:
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-preCompileJSPs', '-JSPCompileOptions',
 [["IVT Application", 'ivt_app.war,WEB-INF/web.xml', 'jspcp',
 '', 15, 'No']]])
Utilizando Jython con coincidencia de patrones:
AdminApp.install('ivtApp.ear', ['-appname', 'MyApp', '-preCompileJSPs',
 '-JSPCompileOptions', [['.*', '.*', 'jspcp', 'Yes', 15, 'No']]])

JSPReloadForWebMod

La opción JSPReloadForWebMod edita los atributos de recarga JSP del módulo web. Puede especificar los atributos de recarga del servlet y JSP para cada módulo. El contenido actual de la opción después de ejecutar los enlaces predeterminados es el siguiente:
  • Módulo web: xxx
  • URI: xxx
  • Recarga de clase de habilitación de JSP: <Yes | No>
  • Intervalo de recarga JSP en segundos: <número interno recarga jsp>

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación.

Para recargar la clase de habilitación de JSP, especifique un valor o No en el idioma específico del entorno local. El producto da soporte a los valores de AppDeploymentOption.Yes y AppDeploymentOption.No, en lugar de a Yes y No. No obstante, se recomienda que especifique Yes o No en el idioma de su entorno local.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
 {-appname MyApp -JSPReloadForWebMod {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml Yes 5}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
 {-appname MyApp -JSPReloadForWebMod {{.* .* Yes 5}}}
Utilizando Jython:
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-JSPReloadForWebMod [["IVT Application"
 ivt_app.war,WEB-INF/web.xml Yes 5 ]]'])
Utilizando Jython con coincidencia de patrones:
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-JSPReloadForWebMod', [['.*', '.*', 'Yes', ‘5']]])
Supported configurations Supported configurations: Para los archivos de enlace y extensión de IBM®, la extensión del nombre de archivo .xmi o .xml es diferente en función de si se utiliza una aplicación o módulo previo a Java EE 5 o una aplicación o módulo Java EE 5 o posterior. Un archivo de enlace o extensión de IBM se denomina ibm-*-ext.xmi o ibm-*-bnd.xmi donde * es el tipo de archivo de extensión o enlace como app, application, ejb-jar o web. Se aplican las condiciones siguientes:
  • En el caso de una aplicación o módulo que utilice una Java EE anterior a la versión 5, la extensión del archivo debe ser .xmi.
  • En el caso de una aplicación que utilice Java EE versión 5 o posterior, la extensión del archivo debe ser .xml. Si los archivos .xmi se incluyen con la aplicación o el módulo, el producto ignora los archivos .xmi.

No obstante, puede existir un módulo de Java EE 5 o posterior dentro de una aplicación que incluya archivos previos a Java EE 5 y que utilice la extensión de nombre de archivo .xmi.

Los archivos ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi, y ibm-portlet-ext.xmi siguen utilizando la extensión de archivo .xmi.

sptcfg

MapEJBRefToEJB

La opción MapEJBRefToEJB correlaciona las referencias Java de enterprise con enterprise beans. Debe establecer la correlación de cada referencia de enterprise bean de la aplicación con un enterprise bean. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

Si la referencia de EJB procede de un módulo EJB 3.x, Web 2.4 o Web 2.5, el nombre JNDI es opcional. Si especifica la opción useAutoLink, el nombre JNDI es opcional. El entorno de ejecución proporciona un contenedor predeterminado. Un módulo EJB 3.0 o posterior no puede contener beans de entidad de persistencia gestionada por bean o gestionada por contenedor. La instalación falla si un bean de entidad de persistencia gestionada por bean o gestionada por contenedor se empaqueta en un módulo EJB 3.x de una aplicación Java EE. Sólo puede empaquetar los beans de persistencia gestionada por bean o gestionada por contenedor en un módulo EJB 2.1 o anterior.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Sólo tiene que proporcionar datos para las filas o entradas a las que les falte información, o aquéllas en las que desee actualizar los datos existentes.

Uso del ejemplo de modalidad de proceso por lotes

En Jacl:

$AdminApp install techapp.ear {-MapEJBRefToEJB {{"JAASLogin" "" JAASLoginWeb.war,
WEB-INF/web.xml WSsamples/JAASLogin jaasloginejb.SampleBean TechApp/JAASLogin}}
-MapWebModToVH {{"Web Application" Tech.war,WEB-INF/web.xml default_host}}}

Utilizando Jacl con coincidencia de patrones:

[Windows]
$AdminApp install C:/myapp.ear {-MapEJBRefToEJB {{.* .* .* .* .* MyBean}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-MapEJBRefToEJB {{.* .* .* .* .* MyBean}}}
Utilizando Jython:
AdminApp.install('techapp.ear','[
-MapEJBRefToEJB [["JAASLogin" "" JAASLoginWeb.war,WEB-INF/web.xml WSsamples/JAASLogin]]
-MapWebModToVH [["Web Application" tech.war,WEB-INF/web.xml default_host]]]')

Utilizando Jython con coincidencia de patrones:

[Windows]
AdminApp.install('C:/myapp.ear', ['-MapEJBRefToEJB',
 [['.*', '.*', '.*', '.*', '.*', 'MyBean']]])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear',
['-MapEJBRefToEJB', 
 [['.*', '.*', '.*', '.*', '.*', 'MyBean']]])

MapEnvEntryForApp

La opción MapEnvEntryForApp edita el valor env-entry de la aplicación. Puede utilizar esta opción para editar el valor env-entry en el archivo application.xml .

El contenido actual de esta opción tras ejecutar los enlaces predeterminados es el siguiente:
  • Nombre: xxx
  • Tipo: xxx
  • Descripción: xxx
    Avoid trouble Avoid trouble: Si después de ejecutar los enlaces predeterminados, el valor es un valor null, debe cambiar el valor por . * antes de ejecutar esta tarea. El valor .* es el valor de comodín, que permite que coincida cualquier descripción. Si deja el valor como null, las excepciones se producirán cuando ejecute la tarea MapEnvEntryForApp.gotcha
  • Valor: <valor env-entry>

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForApp {{MyApp/appEnvEntry String null newEnvEntry}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
 {-appname MyApp2 -MapEnvEntryForApp {{.* .* .* newEnvEntry}}}
Utilizando Jython:
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
 ['-appname', 'MyApp3', '-MapEnvEntryForApp', [['MyApp/appEnvEntry', 'String', 'null', 'newEnvEntry']]])
Utilizando Jython con coincidencia de patrones:
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
 ['-appname', 'MyApp4', '-MapEnvEntryForApp', [['.*', '.*', '.*', 'newEnvEntry']]])

Si hay un nuevo carácter de línea en la descripción, utilice la sintaxis siguiente:

Utilizando Jacl con coincidencia de patrones:
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
 {-appname MyApp5 -MapEnvEntryForApp {{.* .* (?s).* newEnvEntry}}}
Utilizando Jython con coincidencia de patrones:
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
 ['-appname', 'MyApp6', '-MapEnvEntryForApp',
 [['.*', '.*', '(?s).*', 'newEnvEntry']]])

MapEnvEntryForClientMod

La opción MapEnvEntryForClientMod edita el valor env-entry del módulo de cliente. Puede utilizar esta opción para editar el valor de las entradas de entorno del módulo de cliente, archivo application-client.xml.

El contenido actual de esta opción tras ejecutar los enlaces predeterminados es el siguiente:
  • módulo de cliente: xxx
  • URI: xxx
  • Nombre: xxx
  • Tipo: xxx
  • Descripción: xxx
  • Valor: <valor env-entry>

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para el módulo de cliente.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install raíz_servidor_aplicaciones/installableApps/myapp.ear
 {-appname MyApp -MapEnvEntryForClientMod {{"Módulo de cliente" client.jar,META-INF/application-client.xml
  clientObject String null newValue}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.*  .*  .*
  .* .* newValue}}} 
Utilizando Jython:
AdminApp.install('app_server_root/installableApps/myapp.ear',
 ['-appname', 'MyApp', '-MapEnvEntryForClientMod', [["Módulo de cliente",
 'client.jar,META-INF/application-client.xml', 'clientObject',
 'String', 'null', 'newValue']]])
Utilizando Jython con coincidencia de patrones:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
 [['.*', '.*', '.*', '.*', '.*', 'newValue']]]) 

Si hay un nuevo carácter de línea en la descripción, utilice la sintaxis siguiente:

Utilizando Jacl con coincidencia de patrones:
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.* .* .*
 (?s).* newValue}}}
Utilizando Jython con coincidencia de patrones:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
 [['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])

MapEnvEntryForEJBMod

La opción MapEnvEntryForEJBMod edita el valor env-entry del módulo EJB. Puede utilizar esta opción para editar el valor de las entradas de entorno en el módulo EJB, ejb-jar.xml.

El contenido actual de esta opción tras ejecutar los enlaces predeterminados es el siguiente:
  • Módulo: xxx
  • URI: xxx
  • Bean: xxx
  • Nombre: xxx
  • Tipo: xxx
  • Descripción: xxx
    Avoid trouble Avoid trouble: Si después de ejecutar los enlaces predeterminados, el valor es un valor null, debe cambiar el valor por . * antes de ejecutar esta tarea. El valor .* es el valor de comodín, que permite que coincida cualquier descripción. Si deja el valor en null, se producirán excepciones WASX7017E y WASX7111E cuando ejecute la tarea MapEnvEntryForEJBMod. gotcha
  • Valor: <valor env-entry>

Si el módulo EJB utiliza EJB 3.0 o posterior, el contenido de esta opción sólo se llena a partir del descriptor de despliegue XML. Con esta opción, no se puede obtener la información de despliegue a partir de las anotaciones.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForEJBMod {{"IVT EJB Module" ivtEJB.jar,META-INF/ejb-jar.xml
  ivtEJBObject ejb/ivtEJBObject String null newValue}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install myapp.jar {-appname MyApp -MapEnvEntryForEJBMod {{.*  .*  .*
  .* .* .* newValue}}} 
Utilizando Jython:
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-MapEnvEntryForEJBMod', [["IVT EJB Module",
 'ivtEJB.jar,META-INF/ejb-jar.xml', 'ivtEJBObject', 'ejb/ivtEJBObject',
 'String', 'null', 'newValue']]])
Utilizando Jython con coincidencia de patrones:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
 [['.*', '.*', '.*', '.*', '.*', '.*', 'newValue']]]) 

Si hay un nuevo carácter de línea en la descripción, utilice la sintaxis siguiente:

Utilizando Jacl con coincidencia de patrones:
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForEJBMod {{.*  .*  .*
 (?s).* newValue}}}
Utilizando Jython con coincidencia de patrones:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
 [['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])

MapEnvEntryForWebMod

La opción MapEnvEntryForWebMod edita el valor env-entry del módulo web. Puede utilizar esta opción para editar el valor env-entry en el archivo web.xml.

El contenido actual de esta opción tras ejecutar los enlaces predeterminados es el siguiente:
  • Módulo web: xxx
  • URI: xxx
  • Nombre: xxx
  • Tipo: xxx
  • Descripción: xxx
    Avoid trouble Avoid trouble: Si, después de ejecutar los enlaces por omisión, el valor es null, debe cambiar el valor a .* para poder ejecutar esta tarea. El valor .* es el valor de comodín, que permite que coincida cualquier descripción. Si deja el valor en null, se producirán excepciones WASX7017E y WASX7111E cuando ejecute la tarea MapEnvEntryForWebMod. gotcha
  • Valor: <valor env-entry>

Si el módulo web utiliza un Servlet 2.5, el contenido de esta opción sólo se llena a partir del descriptor de despliegue XML. Con esta opción, no se puede obtener la información de despliegue a partir de las anotaciones.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForWebMod {{"IVT Application" ivt_app.war,
 WEB-INF/web.xml ivt/ivtEJBObject String null newEnvEntry}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
 {-appname MyApp2 -MapEnvEntryForWebMod {{.* .* .* .* newEnvEntry}}}
Utilizando Jython:
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
 ['-appname', 'MyApp3', '-MapEnvEntryForWebMod', [["IVT Application",
 'ivt_app.war,WEB-INF/web.xml', 'ivt/ivtEJBObject', 'String', 'null', 'newEnvEntry']]])
Utilizando Jython con coincidencia de patrones:
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
 ['-appname', 'MyApp4', '-MapEnvEntryForWebMod', [['.*', '.*', '.*', '.*', 'newEnvEntry']]])

Si hay un nuevo carácter de línea en la descripción, utilice la sintaxis siguiente:

Utilizando Jacl con coincidencia de patrones:
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
 {-appname MyApp5 -MapEnvEntryForWebMod {{.* .* .* (?s).* newEnvEntry}}}
Utilizando Jython con coincidencia de patrones:
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
 ['-appname', 'MyApp6', '-MapEnvEntryForWebMod',
 [['.*', '.*', '.*', '(?s).*', 'newEnvEntry']]])

MapInitParamForServlet

La opción MapInitParamForServlet edita el parámetro inicial de un módulo web. Puede utilizar esta opción para editar el parámetro inicial de un servlet del archivo web.xml. El contenido actual de esta opción después de ejecutar los enlaces predeterminados es el siguiente:
  • Módulo web: xxx
  • URI: xxx
  • Servlet: xxx
  • Nombre: xxx
  • Descripción: null
  • Valor: <valor parámetro inicial>
Si el módulo web utiliza un Servlet 2.5 o posterior, el contenido de esta opción sólo se llena a partir del descriptor de despliegue XML. Con esta opción, no se puede obtener la información de despliegue a partir de las anotaciones.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
 {-appname MyApp -MapInitParamForServlet {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml  ivtservlet  pName1  null  MyInitParamValue}}} 
Utilizando Jacl con coincidencia de patrones:
$AdminApp install myapp.ear {-appname MyApp -MapInitParamForServlet
 {{.*  .*  .*  .*  .*  MyInitParamValue}}}
Utilizando Jython:
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-MapInitParamForServlet', [["IVT Application",
 'ivt_app.war,WEB-INF/web.xml', 'ivtservlet', 'pName1', 'null', 'MyInitParamValue']]])
Utilizando Jython con coincidencia de patrones:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapInitParamForServlet',
 [['.*', '.*', '.*', '.*', '.*', 'MyInitParamValue']]])

MapJaspiProvider

La opción MapJaspiProvider especifica la aplicación web o los módulos web en que desea alterar temporalmente los valores de JASPI (Java Authentication SPI) de la configuración de seguridad global o de dominio. El contenido de esta opción es el siguiente:
  • Módulo: xxx
  • URI: xxx
  • Utilice JASPI: | No | Heredar
  • Nombre de proveedor de JASPI: xxx

Para utilizar JASPI, especifique un valor , No o Heredar en el idioma específico del entorno local.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install myapp.ear {-MapJaspiProvider {{myapp META-INF/application.xml Yes Provider1} }}
Utilizando Jython:
AdminApp.install('myapp.ear', '[-appname myapp
 -MapJaspiProvider [[myapp META-INF/application.xml  Provider1] ]]')

MapMessageDestinationRefToEJB

La opción MapMessageDestinationRefToEJB correlaciona las referencia de destino de mensajes con los nombres JNDI (Java Naming and Directory Interface) de los objetos administrativos de los adaptadores de recursos instalados. Debe establecer la correlación de cada referencia de destino de mensajes de la aplicación con un objeto administrativo. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

El contenido actual de la opción después de ejecutar los enlaces predeterminados es:
  • Módulo: ejb-jar-ic.jar
  • Bean: MessageBean
  • URI: ejb-jar-ic.jar,META-INF/ejb-jar.xml
  • Objeto de destino de mensaje: jms/GSShippingQueue
  • Nombre JNDI de recurso de destino: [jms/GSShippingQueue]:
Si el origen de la referencia de destino de mensaje es un módulo EJB 3.0 o posterior, el nombre JNDI es opcional y el entorno de ejecución proporciona un contenedor predeterminado.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install BankFull.ear {-MapMessageDestinationRefToEJB {{BankCMRQLEJB
 Sender BankCMRQLEJB.jar,META-INF/ejb-jar.xml BankJSQueue BankJSQueue} }}  
Utilizando Jacl con coincidencia de patrones:
$AdminApp install $earfile {-MapMessageDestinationRefToEJB {{.*  .*  .*  MyConnection
 jndi2} {.* .*  .*  PhysicalTopic jndi3} {.*  .*  .*  jms/ABC jndi4}}} 
Utilizando Jython:
AdminApp.install('BankFull.ear', '[ -MapMessageDestinationRefToEJB [[ BankCMRQLEJB
 Sender BankCMRQLEJB.jar,META-INF/ejb-jar.xml BankJSQueue BankJSQueue ]]]' )
Utilizando Jython con coincidencia de patrones:
AdminApp.install(ear1, ['-MapMessageDestinationRefToEJB', [['.*', '.*', '.*', 'MyConnection', 
 'jndi2'], ['.*', '.*', '.*', 'PhysicalTopic', 'jndi3'], ['.*', '.*', '.*', 'jms/ABC', 'jndi4']]])

MapModulesToServers

La opción MapModulesToServers especifica el servidor de aplicaciones donde desea instalar los módulos incluidos en la aplicación. Puede instalar módulos en el mismo servidor o dispersarlos entre varios servidores. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

En el ejemplo siguiente se instala Increment.jar en un servidor:

En Jacl:
$AdminApp install Increment.jar {-MapModulesToServers
 {{"Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1}}}
Utilizando Jython:
AdminApp.install('Increment.jar', '[-MapModulesToServers
 [["Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1] ]]')

En el ejemplo siguiente se instala Increment.jar y se correlaciona con dos servidores gestionados por un gestor de despliegue:

Utilizando Jacl:
$AdminApp install Increment.jar {-MapModulesToServers
 {{ "Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1+WebSphere:cell=mycell,node=mynode,server=server2}}}
Utilizando Jython:
AdminApp.install('Increment.jar', '[ -MapModulesToServers
 [[ "Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1+WebSphere:cell=mycell,node=mynode,server=server2]]]')

En el ejemplo siguiente se añade server2 y server3 a una aplicación que está instalada:

En Jacl:
$AdminApp install myapp.ear {-MapModulesToServers {{.* .* 
 +WebSphere:cell=mycell,node=mynode,server=server2+WebSphere:cell=mycell,node=mynode,server=server3}}
 -appname myapp -update -update.ignore.old} 
Utilizando Jython:
AdminApp.install('myapp.ear', ['-MapModulesToServers', [['.*', '.*', 
 '+WebSphere:cell=mycell,node=mynode,server=server2+WebSphere:cell=mycell,node=mynode,server=server3']],
 '-appname', 'myapp', '-update', '-update.ignore.old']) 

En el siguiente ejemplo se elimina server1 de la aplicación que está instalada:

En Jacl:
$AdminApp edit myapp {-MapModulesToServers
 {{.* .* -WebSphere:cell=mycell,node=mynode,server=server1}}
 -update -update.ignore.old} 
Utilizando Jython:
AdminApp.edit('myapp', ['-MapModulesToServers',
 [['.*', '.*', '-WebSphere:cell=mycell,node=mynode,server=server1']]]) 

MapResEnvRefToRes

La opción MapResEnvRefToRes correlaciona las referencias de entorno de recursos con los recursos. Debe establecer la correlación de cada referencia de entorno de recursos definida en la aplicación con un recursos. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install raíz_servidor_aplic/installableApps/sibwsjmsepl.ear {
 -BindJndiForEJBMessageBinding {{ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml lp1 "" "" "" }}
 -MapResEnvRefToRes {{SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml jms/WebServicesReplyQCF
   javax.jms.QueueConnectionFactory jndi1}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install raíz_servidor_aplic/installableApps/sibwsjmsepl.ear {
 -MapResEnvRefToRes {{.* .* .* .* .* jndi1}}}
Utilizando Jython:
AdminApp.install('raíz_servidor_aplic/installableApps/sibwsjmsepl.ear', '[
 -BindJndiForEJBMessageBinding [[ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml lp1 "" "" "" ]]
 -MapResEnvRefToRes [[ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml jms/WebServicesReplyQCF
   javax.jms.QueueConnectionFactory jndi1 ]]]' ) 
Utilizando Jython con coincidencia de patrones:
AdminApp.install('app_server_root/installableApps/sibwsjmsepl.ear',
 ['-MapResEnvRefToRes', [['.*', '.*', '.*', '.*', '.*', 'jndi1']]])

MapResRefToEJB

La opción MapResRefToEJB correlaciona las referencias de recursos con los recursos. Debe establecer la correlación de cada referencia de recursos definida en la aplicación con un recurso. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

Los parámetros para MapResRefToEJB son los siguientes:
  • Módulo: Ejb1
  • Bean: MailEJBObject
  • URI: deplmtest.jar,META-INF/ejb-jar.xml
  • Referencia de recurso: jms/MyConnectionFactory
  • Tipo de recurso: javax.jms.ConnectionFactory
  • Nombre JNDI de recurso de destino: [jms/MyConnectionFactory]:
  • Nombre de configuración de inicio de sesión: [null]: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
  • Propiedades: []: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
  • Propiedades del origen de datos ampliado: []: Utilice esta opción para que un origen de datos que emplee la agrupación heterogénea pueda conectarse a una base de datos DB2. El patrón para la propiedad es property1=value1+property2=value 2.

La configuración de inicio de sesión DefaultPrincipalMapping la utilizan los conectores J2C (Java 2 Connectors) para correlacionar los usuarios con los principales definidos en las entradas de datos de autenticación J2C. Si login.config.name se establece en DefaultPrincipalMapping, se crea una propiedad con el nombre com.ibm.mapping.authDataAlias. El valor de la propiedad lo establece auth.props. Si login.config.name no se establece en DefaultPrincipalMapping, auth.props puede especificar varias propiedades. El formato de la serie es websphere:name= <name1>,value=<value1>,description=<desc1>. Para especificar varias propiedades utilice el signo más (+).

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp
install myapp.ear {-MapResRefToEJB 
 {{deplmtest.jar MailEJBObject deplmtest.jar,META-INF/ejb-jar.xml mail/MailSession9
 javax.mail.Session jndi1 login1 authProps1 "clientApplicationInformation=new application"}
 {"JavaMail Sample WebApp" "" mtcomps.war,WEB-INF/web.xml mail/MailSession9 
 javax.mail.Session jndi2 login2 authProps2 ""}}} 
Utilizando Jacl con coincidencia de patrones:
$AdminApp
install myapp.ear {-MapResRefToEJB 
 {{deplmtest.jar .*  .*  .*  .*  jndi1 login1 authProps1
 "clientApplicationInformation=new application"}
 {"JavaMail Sample WebApp" .*  .*  .*  .*  jndi2 login2 authProps2 ""}}}
Nota: Si utiliza diversos valores para propiedades de origen de datos ampliados, tendrá que asignar los valores a una variable y utilizar esa variable para el valor de la propiedad. Por ejemplo:
set s \"value1,value2\"
En la sustitución de mandatos, refiérase a la variable tal como se muestra en el ejemplo siguiente:
"clientApplicationInformation=value1,value2" with "clientapplication=$s"
Utilizando Jython:
AdminApp.install('myapp.ear', ['-MapResRefToEJB', 
 [['deplmtest.jar', 'MailEJBObject', 'deplmtest.jar,META-INF/ejb-jar.xml
 mail/MailSession9', 'javax.mail.Session', 'jndi1', 'login1', 'authProps1',
 'clientApplicationInformation=new application+clientWorkstation=9.10.117.65'],
 ["JavaMail Sample WebApp", "", 'mtcomps.war,WEB-INF/web.xml', 'mail/MailSession9',
 'javax.mail.Session', 'jndi2', 'login2', 'authProps2', '']]]) 
Utilizando Jython con coincidencia de patrones:
AdminApp.install('myapp.ear', ['-MapResRefToEJB', 
 [['deplmtest.jar', '.*', '.*', '.*', '.*', 'jndi1', 'login1', 'authProps1',
 'clientApplicationInformation=new application+clientWorkstation=9.10.117.65'],
 ["JavaMail Sample WebApp", '', '.*', '.*', '.*', 'jndi2', 'login2',
 'authProps2', '']]])
Nota: Si utiliza diversos valores para propiedades de origen de datos ampliados, escriba los dos valores entre comillas. Por ejemplo:
'property1="value1,value2"+property2="value3,value4"'

MapRolesToUsers

La opción MapRolesToUsers correlaciona usuarios con roles. Debe establecer la correlación de cada rol definido en la aplicación o el módulo con un usuario de grupo del registro de usuarios de dominio. Puede especificar varios usuarios o grupos para un solo rol separándolos por un símbolo |. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install myapp.ear {-MapRolesToUsers {{"All Role" No Yes "" ""}
 {"Every Role" Yes No "" ""} {DenyAllRole No No user1 group1}}}
Utilizando Jython:
AdminApp.install('myapp.ear', '[-MapRolesToUsers [["All Role" No Yes "" ""]
 ["Every Role" Yes No "" ""] [DenyAllRole No No user1 group1]]]')

donde {{"All Role" No Yes "" ""} corresponde a lo siguiente:

Tabla 2. Descripciones de la opción MapRolesToUsers. Correlacionar cada rol con un usuario o gruop.
Opción Descripción
"All Role" Representa el nombre del rol
No Indica que se permite el acceso a todos (sí/no)
Yes Indica que se permite el acceso a todos los usuarios sin autenticar (sí/no)
"" Indica los usuarios correlacionados
"" Indica los grupos correlacionados
"Todos los autenticados en reinos de confianza" Indica que se puede otorgar acceso a cualquier usuario vario del reino.
"ID de acceso de usuarios correlacionados" Indica los ID de acceso de usuarios correlacionados
"ID de acceso de grupos correlacionados" Indica los ID de acceso de grupos correlacionados

MapRunAsRolesToUsers

La opción establece la correlación de roles RunAs con usuarios. Los enterprise beans que instala contienen roles RunAs predefinidos. Los enterprise beans que deben ejecutarse como un rol determinado que debe reconocerse al interactuar con otro enterprise bean utilizan roles RunAs. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

En Jacl:

[Windows]
$AdminApp install C:/myapp.ear {-MapRunAsRolesToUsers {{UserRole user1 
 password1} {AdminRole administrator administrator}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-MapRunAsRolesToUsers {{UserRole user1
 password1} {AdminRole administrator administrator}}}

Utilizando Jython:

[Windows]
AdminApp.install('C:/myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1 
 password1] [AdminRole administrator administrator]]]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1
 password1] [AdminRole administrator administrator]]]')

MapSharedLibForMod

La opción MapSharedLibForMod asigna bibliotecas compartidas a la aplicación o a cada módulo. Puede asociar varias bibliotecas compartidas a aplicaciones y módulos. El contenido actual de esta opción tras ejecutar los enlaces predeterminados es el siguiente:
  • Módulo: xxx
  • URI: META-INF/application.xml
  • Bibliotecas compartidas: <biblioteca compartida>

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi -MapSharedLibForMod {{ DynaCacheEsi META-INF/application.xml
 sharedlib1 }{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 }}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi -MapSharedLibForMod {{ .* .* sharedlib1 }
 { .* .* sharedlib2 }}}
Utilizando Jython:
AdminApp.install('raíz_servidor_aplic/installableApps/DynaCacheEsi.ear',
 '[ -MapSharedLibForMod [[ DynaCacheEsi META-INF/application.xml sharedlib1 ]
 [ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 ]]]' )
Utilizando Jython con coincidencia de patrones:
AdminApp.install('raíz_servidor_aplic/installableApps/DynaCacheEsi.ear',
 '[ -MapSharedLibForMod [[ .* .* sharedlib1 ][ .* .* sharedlib2 ]]]' )

MapWebModToVH

La opción MapWebModToVH selecciona los hosts virtuales para los módulos web. Especifique el host virtual donde desea instalar los módulos web contenidos en la aplicación. Puede instalar módulos web en el mismo host virtual o dispersados entre varios hosts. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi
 -MapWebModToVH {{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host }}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
 {-MapWebModToVH {{ .* .* default_host }}}
Utilizando Jython:
AdminApp.install('raíz_servidor_aplic/installableApps/DynaCacheEsi.ear',
 '[-MapWebModToVH [[ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host ]]]') 
Utilizando Jython con coincidencia de patrones:
AdminApp.install('raíz_servidor_aplic/installableApps/DynaCacheEsi.ear',
 ['-MapWebModToVH', [['.*', '.*', 'default_host']]])

MetadataCompleteForModules

La opción MetadataCompleteForModules permite a cada módulo Java EE o posterior 2.5 escribir el descriptor de despliegue completo, incluida la información de despliegue de las anotaciones. A continuación, el sistema marca como completo el descriptor de despliegue para el módulo.

Avoid trouble Avoid trouble: Si la aplicación Java EE 5 o posterior utiliza anotaciones y una biblioteca compartida, no utilice esta opción. Cuando la aplicación utiliza anotaciones y una biblioteca compartida, si se establece el atributo metadata-complete en true el producto representará incorrectamente una anotación @EJB en el descriptor de despliegue como <ejb-ref> en lugar de <ejb-local-ref>. En los módulos web, establecer el atributo metadata-complete en true podría causar errores de tipo InjectionException. En el caso de que tenga que establecer atributo metadata-complete en true, puede evitar errores no usando una biblioteca compartida, colocando la biblioteca compartida en el directorio clases o en el directorio lib del servidor de la aplicación, o especificando todos los metadatos en los descriptores de despliegue.gotcha
El contenido actual de esta opción tras ejecutar los enlaces predeterminados es el siguiente:
  • Módulo: EJBDD_1.jar
  • URI: EJBDD_1.jar,META-INF/ejb-jar.xml
  • Descriptor de despliegue de bloqueo: [false]:
  • Módulo: EJBNoDD_2.jar
  • URI: EJBNoDD_2.jar,META-INF/ejb-jar.xml
  • Descriptor de despliegue de bloqueo: [false]:

Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación.

Uso del ejemplo de modalidad de proceso por lotes

En Jacl:

[Windows]
$AdminApp install c:/myapp.ear {-MetadataCompleteForModules
 {{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-MetadataCompleteForModules
 {{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}

Utilizando Jacl con coincidencia de patrones:

[Windows]
$AdminApp install c:/myapp.ear {-MetadataCompleteForModules
 {{.* EJBDD_1.jar,.* false}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp
install myapp.ear 
 {-MetadataCompleteForModules {{.* EJBDD_1.jar,.* false}}}

Utilizando Jython:

[Windows]
AdminApp.install('c:/myapp.ear', ['-MetadataCompleteForModules', 
 [['EJBDD_1,jar',  'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-MetadataCompleteForModules',
 [['EJBDD_1,jar',  'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])

Utilizando Jython con coincidencia de patrones:

[Windows]
AdminApp.install('c:/myapp.ear', ['-MetadataCompleteForModules', [['.*',
 'EJBDD_1.jar,.*', 'false']]]
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', 
 ['-MetadataCompleteForModules', [['.*',  'EJBDD_1.jar,.*', 'false']]]

ModuleBuildID

La opción ModuleBuildID muestra el identificador de compilación de un módulo en un archivo EAR de la aplicación. Esta opción no se puede modificar porque es de solo lectura. Esta opción devuelve la información de compilación para un módulo si ha especificado el identificador de compilación en el archivo MANIFEST.MF de un módulo o archivo EAR de aplicación. La información de compilación consiste en el nombre del módulo, el URI del módulo y el identificador de compilación.

El contenido actualizado de la opción después de ejecutar los enlaces predeterminados es similar a la siguiente:
  • Módulo: CacheClient
  • URI: CacheClient.jar,META-INF/application-client.xml
  • ID de compilación: alpha
  • Módulo: MailConnector
  • URI: Mail.rar,META-INF/ra.xml
  • ID de compilación: abc
  • Módulo: CacheWeb1
  • URI: CacheWeb1.war,WEB-INF/web.xml
  • ID de compilación: alpha
  • Módulo: JspWeb1
  • URI: JspWeb1.war,WEB-INF/web.xml
  • ID de compilación: v1.0
  • Módulo: Servlet
  • URI: Servlet.war,WEB-INF/web.xml
  • ID de compilación: 0.5

Uso del ejemplo de modalidad de proceso por lotes

En Jython:

[Windows]
print AdminApp.taskInfo('c:/temp/Cache2.ear', 'ModuleBuildID')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
print AdminApp.taskInfo('/temp/Cache2.ear', 'ModuleBuildID')

noallowDispatchRemoteInclude

La opción noallowDispatchRemoteInclude no permite a la aplicación de empresa que asigne solicitudes includes a recursos a través de los módulos web en distintas máquinas virtuales Java en un entorno de nodo gestionado a través del mecanismo del asignador de solicitudes estándar.

noallowPermInFilterPolicy

La opción noallowPermInFilterPolicy especifica que no se continúe con el proceso de despliegue de aplicaciones si la aplicación contiene permisos de política que están en la política de filtros. Esta opción es el valor predeterminado y no necesita ningún valor.

noallowServiceRemoteInclude

La opción noallowServiceRemoteInclude no permite a la aplicación de empresa prestar servicios a una solicitud include procedente de una aplicación de empresa que tenga la opción allowDispatchRemoteInclude establecida en true.

node

La opción node especifica el nombre de nodo para instalar o actualizar toda una aplicación o para actualizar una aplicación con objeto de añadir un módulo nuevo. Si desea actualizar toda una aplicación, esta opción sólo se aplica si la aplicación contiene un nuevo módulo que no existe en la aplicación instalada.

Uso del ejemplo de modalidad de proceso por lotes

En Jacl:

[Windows]
$AdminApp install "C:/myapp.ear" {-node nodeName}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install "/myapp.ear" {-node nodeName}

Utilizando Jython:

[Windows]
AdminApp.install('C:/myapp/myapp.ear', '[-node nodeName]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('/myapp/myapp.ear', '[-node nodeName]')

nocreateMBeansForResources

La opción nocreateMBeansForResources especifica que no se crean MBeans para todos los recursos como, por ejemplo, servlets, archivos JSP (JavaServer Pages) y enterprise beans, que se definen en una aplicación cuando se inicia la aplicación en un destino de despliegue. Esta opción es el valor predeterminado y no necesita ningún valor.

nodeployejb

La opción nodeployejb especifica que no se ejecute la herramienta EJBDeploy durante la instalación. Esta opción es el valor predeterminado y no necesita ningún valor.

nodeployws

La opción nodeployws especifica que no se desplieguen los servicios web durante la instalación. Esta opción es el valor predeterminado y no necesita ningún valor.

nodistributeApp

La opción nodistributeApp especifica que el componente de gestión de aplicaciones no distribuya los binarios de la aplicación. Esta opción no necesita obligatoriamente un valor. El valor predeterminado es la opción distributeApp.

noenableClientModule

La opción noenableClientModule especifica que no se desplieguen módulos de cliente. Esta opción no necesita obligatoriamente un valor. Es el valor predeterminado. El valor predeterminado no va a desplegar módulos de cliente. Utilice la opción enableClientModule para desplegar módulos de cliente.

noreloadEnabled

La opción noreloadEnabled inhabilita la recarga de clases. Esta opción es el valor predeterminado y no necesita ningún valor. Para especificar que el sistema de archivos de la aplicación se explorará en busca de archivos actualizados para que los cambios se recarguen de forma dinámica, utilice la opción reloadEnabled.

nopreCompileJSPs

La opción nopreCompileJSPs especifica que no se precompilen los archivos JavaServer Pages. Esta opción es el valor predeterminado y no necesita ningún valor.

noprocessEmbeddedConfig

La opción noprocessEmbeddedConfig especifica que el sistema debe ignorar los datos de configuración incorporados incluidos en la aplicación. Esta opción no necesita obligatoriamente un valor. Si el archivo EAR (enterprise archive) de la aplicación no contiene datos de configuración incorporados, la opción noprocessEmbeddedConfig es el valor predeterminado. De lo contrario, el valor predeterminado es la opción processEmbeddedConfig.

nouseAutoLink

La opción nouseAutoLink especifica que no se utilice la opción useAutoLink y que no se resuelvan automáticamente las referencias de EJB (Enterprise JavaBeans) de las versiones del módulo EJB anteriores a EJB 3.0 y de las versiones del módulo web anteriores a la versión 2.4.

nouseMetaDataFromBinary

La opción nouseMetaDataFromBinary especifica que los metadatos que se utilizan en el tiempo de ejecución, por ejemplo, los descriptores de despliegue, los enlaces, las extensiones, etc. vienen del repositorio de configuración. Esta opción es el valor predeterminado y no necesita ningún valor. Utilice esta opción para indicar que los metadatos utilizados en tiempo de ejecución provienen del archivo EAR (enterprise archive).

nousedefaultbindings

La opción nousedefaultbindings especifica no utilizar los enlaces predeterminados para la instalación. Esta opción es el valor predeterminado y no necesita ningún valor.

novalidateSchema

La opción novalidateSchema especifica que no se validen los descriptores de despliegue contra los esquemas de descriptor de despliegue Java EE publicados. Esta opción no necesita obligatoriamente un valor. Es el valor predeterminado. El valor predeterminado es no validar descriptores de despliegue.

operación

La opción operation especifica la operación que desea realizar. Esta opción sólo se aplica a los mandatos update o updateInteractive. Los valores válidos son:
  • add: añade nuevo contenido.
  • addupdate: añade o actualiza el contenido basándose en la existencia de contenido en la aplicación.
  • delete: suprime contenido.
  • update: actualiza el contenido existente.

La opción operation es necesaria si el tipo de contenido es file o modulefile. Si el valor del tipo de contenido es app, el valor de la opción operation debe ser update. La opción contenturi se pasa por alto si el tipo de contenido es app.

Uso del ejemplo de modalidad de proceso por lotes

En los siguientes ejemplos se muestra cómo utilizar las opciones del mandato update para actualizar toda la aplicación empresarial desplegada:

Utilizando Jacl:
$AdminApp update "IVT Application" app {-operation update
 -contents raíz_servidor_aplic/installableApps/ivtApp.ear}
Utilizando la serie Jython:
AdminApp.update('IVT Application', 'app', '[ -operation update
 -contents raíz_servidor_aplic/installableApps/ivtApp.ear ]' )

En los siguientes ejemplos se muestra cómo utilizar las opciones del mandato update para actualizar un solo archivo en una aplicación desplegada:

En Jacl:

[Windows]
$AdminApp update app1 file {-operation update -contents 
 C:/apps/app1/my.xml -contenturi app1.jar/my.xml}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp
update app1 file {-operation update 
 -contents /apps/app1/my.xml -contenturi app1.jar/my.xml}

Utilizando la serie Jython:

[Windows]
AdminApp.update('app1', 'file', '[-operation update -contents 
 C:/apps/app1/my.xml -contenturi app1.jar/my.xml]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.update('app1',
'file', '[-operation update 
 -contents /apps/app1/my.xml -contenturi app1.jar/my.xml]')

Utilizando la lista Jython:

[Windows]
AdminApp.update('app1', 'file', ['-operation', 'update', '-contents', 
 'C:/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.update('app1', 'file', ['-operation', 'update', '-contents',
 '/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])

donde AdminApp es el objeto de script, update es el mandato, app1 es el nombre de la aplicación que desea actualizar, file es el tipo de contenido, operation es una opción del mandato update, update es el valor de la opción operation, contents es una opción del mandato update, /apps/app1/my.xml es el valor de la opción contents, contenturi es una opción del mandato update y app1.jar/my.xml es el valor de la opción contenturi.

processEmbeddedConfig

La opción processEmbeddedConfig procesa los datos de la configuración incorporados que se incluyen en la aplicación. Esta opción no necesita obligatoriamente un valor. Si el archivo EAR (enterprise archive) de la aplicación contiene datos de configuración incorporados, esta opción es el valor predeterminado. Si no es así, el valor predeterminado es la opción nonprocessEmbeddedConfig.

Este valor afecta a la instalación de archivos EAR ampliados. Un archivo EAR ampliado se produce cuando exporta una aplicación instalada. Los archivos EAR ampliados tienen una configuración incorporada que consta de archivos como resource.xml y variables.xml. Esta opción carga una configuración incorporada en el ámbito de aplicación desde el archivo EAR.

Si ha exportado la aplicación de una célula diferente a la célula actual y no ha especificado la variable $(CELL) para la opción installed.ear.destination cuando instaló por primera vez la aplicación, utilice la opción nonprocessEmbeddedConfig para expandir el archivo EAR ampliado en el directorio raíz_perfil/installedApps/nombre_célula_actual. De lo contrario, utilice la opción processEmbeddedConfig para expandir el archivo EAR ampliado en el directorio raíz_perfil/installedApps/nombre_célula_original, donde nombre_célula_original es la célula en la que se instaló por primera vez la aplicación. Si especificó la variable $(CELL) para la opción installed.ear.destination cuando instaló por primera vez la aplicación, la instalación expandirá el archivo EAR ampliado en el directorio raíz_perfil/installedApps/nombre_célula_actual.

preCompileJSPs

La opción preCompileJSPs especifica que se deben precompilar los archivos JavaServer Pages. Esta opción no necesita obligatoriamente un valor. El valor predeterminado es nopreCompileJSPs. Si desea precompilar archivos JavaServer Pages, especifíquelo como parte de la instalación. El valor predeterminado es no precompilar archivos JSP (JavaServer Pages). La opción preCompileJSPs se ignora durante el despliegue y los archivos JSP (JavaServer Pages) no se precompilan. El distintivo se establece automáticamente con las herramientas de ensamblaje.

reloadEnabled

La opción reloadEnabled especifica que el sistema de archivos de la aplicación se explorará para los archivos actualizados para que los cambios se recarguen de forma dinámica. Si la opción está habilitada y se modifican las clases de la aplicación, entonces la aplicación se detiene y se reinicia para volver a cargar las clases actualizadas. Esta opción no es el valor predeterminado y no necesita ningún valor. El valor predeterminado es la opción noreloadEnabled.

reloadInterval

La opción reloadInterval especifica el periodo de tiempo en segundos durante los cuales el sistema de archivos de la aplicación se explorarán para los archivos actualizados. El intervalo válido es mayor que cero. El valor predeterminado es tres segundos.

SharedLibRelationship

La opción SharedLibRelationship asigna activos o ID de unidad de composición como bibliotecas compartidas para cada módulo Java EE.

El contenido actual de la opción después de ejecutar los enlaces predeterminados es:
  • Módulo: EJB3BNDBean.jar
  • URI: EJB3BNDBean.jar,META-INF/ejb-jar.xml
  • ID de relación: especifique activos o ID de unidad de composición, como [WebSphere:cuname=sharedLibCU1,cuedition=1.0] o WebSphere:assetname=sharedLibAsset1.jar
  • Nombres de unidad de composición: especifique opcionalmente nombres de unidad de composición para los ID de relación de activos. El sistema utiliza el mismo nombre que el activo si no especifica un nombre de unidad de composición. []
  • Destino de coincidencia: [Yes]:
Puede especificar activos e ID de unidad de composición en la relación, como se explica en las directrices siguientes:
  • Si especifica un activo, el sistema crea una unidad de composición con dicho activo en la misma aplicación de nivel de negocio a la que pertenece la aplicación Java EE.
  • Si especifica un valor para los nombres de unidad de composición, la posición del sistema hace coincidir cada nombre con los valores de los ID de relación correspondientes.
  • Si el ID de relación es un ID de unidad de composición, el sistema ignora el nombre de unidad de composición correspondiente.
  • Si el ID de relación es un ID de activo, el sistema crea la unidad de composición con el nombre de unidad de composición correspondiente.

Para especificar más de un activo o ID de unidad de composición, separe cada valor con el carácter de signo más (+).

Al utilizar el mandato edit para la aplicación Java EE, puede alterar temporalmente la relación con un nuevo conjunto de ID de relación de unidad de composición, o bien puede añadir o eliminar relaciones de unidad de composición existentes. No puede especificar una relación de activo si se utiliza el mandato edit. Especifique el primer carácter del ID de unidad de composición como el carácter de signo más (+) para añadirlo a la relación, o bien especifique el carácter de signo más (#) para eliminar el ID de unidad de composición de las relaciones existentes. Por ejemplo, la sintaxis de la unidad de composición +cuname=cu2.zip añade la unidad de composición cu2 a la relación. La sintaxis de la unidad de composición #cuname=cu1.zip+cuname=cu2.zip elimina las unidades de composición cu1 y cu2 de la relación.

Uso del ejemplo de modalidad de proceso por lotes

En Jacl:

$AdminApp install myapp.ear {-SharedLibRelationship {{EJB3BNDBean.jar 
 EJB3BNDBean.jar,META-INF/ejb-jar.xml WebSphere:cuname=sharedLibCU1 "" Yes}}}

Utilizando Jacl con coincidencia de patrones:

$AdminApp install myapp.ear {-SharedLibRelationship {{.*
 EJB3BNDBean.jar,.* WebSphere:cuname=sharedLibCU1 "" Yes}}}

Utilizando Jython:

AdminApp.install('myapp.ear', ['-SharedLibRelationship',
 [['EJB3BNDBean,jar', 'EJB3BNDBean.jar,META-INF/ejb-jar.xml',
 'WebSphere:cuname=sharedLibCU1,' '', 'Yes']]])

Utilizando Jython con coincidencia de patrones:

AdminApp.install('myapp.ear', ['-SharedLibRelationship', [['.*',
 'EJB3BNDBean.jar,.*', 'WebSphere:cuname=sharedLibCU1', '', 'Yes']]]

servidor

La opción server especifica el nombre del servidor en el que va a realizar una de las acciones siguientes:
  • Instalar una aplicación nueva.
  • Sustituir una aplicación existente por una versión actualizada de dicha aplicación. En este caso, la opción server es significativa sólo si la versión actualizada de la aplicación contiene un módulo nuevo que no existe en la versión ya instalada de la aplicación.
  • Añadir un módulo nuevo a una aplicación existente.

Las opciones -cluster y -server no se pueden utilizar juntas. Si desea desplegar una aplicación y especificar el servidor HTTP durante el despliegue para que la aplicación aparezca en el archivo plugin-cfg.xml generado, en primer lugar, debe instalar la aplicación con un destino de -cluster. Después de instalar la aplicación y antes de guardar, utilice el mandato edit del objeto AdminApp para añadir la correlación adicional con el servidor web.

Uso del ejemplo de modalidad de proceso por lotes

En Jacl:

$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
 {-server server1}

Utilizando Jython:

AdminApp.install('raíz_servidor_aplic/installableApps/DynaCacheEsi.ear',
 '[-server server1]')

target

La opción target especifica el destino para las funciones de instalación del objeto AdminApp. Este es un ejemplo de una opción de destino: WebSphere:cell=mycell,node=mynode,server=myserver

Puede especificar varios destinos separándolos con un signo más (+). De forma predeterminada, los destinos que especifique al instalar o editar una aplicación sustituirán las definiciones de destino existentes en la aplicación. Puede utilizar un signo más (+) inicial para añadir destinos o un signo menos (-) inicial para eliminar destinos sin tener que especificar los destinos que no se cambian.
Nota: Se debe utilizar la sintaxis completa de correlación de destino con la opción MapModulesToServers cuando se utilizan varios dominios. No puede utilizar el signo + inicial con la opción MapModulesToServers cuando se utilizan varios dominios; el tiempo de ejecución no está disponible para resolver correctamente los dominios correlacionados con los destinos de despliegue.

Uso del ejemplo de modalidad de proceso por lotes

En el siguiente ejemplo se especifica server1 como el servidor de destino para la instalación de la aplicación:

En Jacl:

$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
 {-appname MyApp -target WebSphere:cell=myCell,node=myNode,server=server1}

En Jython:

AdminApp.install("raíz_servidor_aplic/installableApps/DynaCacheEsi.ear",
 ["-appname", "MyApp", "-target", "WebSphere:cell=myCell,node=myNode,server=server1"])

En el siguiente ejemplo se especifican server1 y server2 como los servidores de destino para la instalación de la aplicación:

Utilizando Jacl:
$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
 {-appname MyApp -target
 WebSphere:cell=myCell,node=Node1,server=server1+WebSphere:cell=Cell1,node=myNode,server=server2}
Utilizando Jython:
AdminApp.install("raíz_servidor_aplic/installableApps/DynaCacheEsi.ear",
 ["-appname", "MyApp", "-target",
 "WebSphere:cell=myCell,node=Node1,server=server1+WebSphere:cell=Cell1,node=myNode,server=server2"])

En el siguiente ejemplo se elimina server3 de la aplicación que está instalada:

En Jacl:
$AdminApp install
 raíz_servidor_aplic/binaries/DefaultApplication.ear {-appname MyApp
 -target -WebSphere:cell=GooddogCell,node=BaddogNode,server=server3
 -update -update.ignore.old}
Utilizando Jython:
AdminApp.install("raíz_servidor_aplic/binaries/DefaultApplication.ear",
 ["-appname", "MyApp",
 "-target", "-WebSphere:cell=GooddogCell,node=BaddogNode,server=server3",
 "-update", "-update.ignore.old"])

En el siguiente ejemplo se añade server4 a la aplicación que está instalada:

En Jacl:
$AdminApp update app {-appname MyApp
 -target +WebSphere:cell=GooddogCell,node=GooddogNode,server=server4
 -contents raíz_servidor_aplic/binaries/DefaultApplication.ear
 -operation update -update.ignore.old}
Utilizando Jython:
AdminApp.update("app", ["-appname", "MyApp",
 "-target", "+WebSphere:cell=GooddogCell,node=GooddogNode,server=server4",
 "-contents", "raíz_servidor_aplic/binaries/DefaultApplication.ear",
 "-operation", "update", "-update.ignore.old"]) 

update

La opción update actualiza la aplicación instalada con una versión nueva del archivo EAR (Enterprise Archive). Esta opción no necesita obligatoriamente un valor.

La aplicación para actualizar, que se especifica mediante la opción appname, ya debe estar instalada en la configuración de WebSphere Application Server. La acción de actualización fusiona los enlaces de la versión nueva con los de la versión anterior, desinstala la versión anterior e instala la nueva. La información de enlaces de la versión nueva del archivo EAR o del módulo tiene preferencia sobre la información correspondiente de la versión anterior. Si en la versión nueva falta algún elemento de enlace, se utilizará el elemento correspondiente de la versión anterior.

update.ignore.new

La opción update.ignore.new especifica que durante la acción de actualización, se da preferencia a la información de enlaces de la versión anterior de la aplicación o módulo por encima de la información de enlaces correspondiente de la nueva versión. Si algún elemento de la información de enlace no existe en la versión anterior, se utiliza el elemento de la versión nueva. Es decir, los enlaces de la versión nueva de la aplicación o módulo se ignoran si ya existe un enlace en la versión anterior. De lo contrario, los nuevos enlaces se aceptan y no se ignoran. Esta opción no necesita obligatoriamente un valor.

Esta opción sólo se aplica si se especifica uno de los siguientes elementos:
  • La opción update para el mandato install.
  • Modulefile o app como tipo de contenido para el mandato update.

update.ignore.old

La opción update.ignore.old especifica que durante la acción de actualización, se da preferencia a la información de enlaces de la versión nueva de la aplicación o módulo por encima de la información de enlaces correspondiente de la versión anterior. Se ignoran los enlaces de la versión anterior de la aplicación o módulo. Esta opción no necesita obligatoriamente un valor. Esta opción sólo se aplica si se especifica uno de los siguientes elementos:
  • La opción update para el mandato install.
  • Modulefile o app como tipo de contenido para el mandato update.

useAutoLink

Utilice la opción useAutoLink para resolver automáticamente las referencias de EJB (Enterprise JavaBeans) de las versiones de módulo EJB anteriores a EJB 3.0, y de las versiones del módulo web anteriores a la versión 2.4. Si habilita la opción useAutoLink, puede especificar opcionalmente el nombre JNDI para la opción MapEJBRefToEJB. Cada módulo de la aplicación debe compartir un destino común para habilitar el soporte de enlace automático.

Uso del ejemplo de modalidad de proceso por lotes

En Jacl:

[Windows]
$AdminApp install C:/myapp.ear {-useAutoLink} 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp
install /myapp.ear {-useAutoLink} 

Utilizando Jython:

[Windows]
AdminApp.install('C:/myapp.ear','[-useAutoLink]') 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear','[-useAutoLink]') 

usedefaultbindings

La opción usedefaultbindings especifica que se deben utilizar los enlaces para la instalación. Esta opción no necesita obligatoriamente un valor. El valor predeterminado es nousedefaultbindings.

Para utilizar el puerto de escucha existente en lugar de utilizar o crear una nueva especificación de activación, determine si la versión JAR de EJB es anterior a la 2.1. El sistema crea y utiliza automáticamente una especificación de activación si especifica la opción -usedefaultbindings para desplegar una aplicación. Si existe una especificación de activación, el sistema ignora el puerto de escucha y, en su lugar, utiliza la especificación de activación. Para desplegar una aplicación con una versión JAR de EJB mayor o igual a 2.1 con los puertos de escucha definidos en lugar de una nueva especificación de activación, establezca la propiedad del sistema com.ibm.websphere.management.application.dfltbndng.mdb.preferexisting en true en el archivo wsadmin.properties del directorio de propiedades del perfil de interés.

useMetaDataFromBinary

La opción useMetaDataFromBinary especifica que los metadatos que se utilizan en el tiempo de ejecución, por ejemplo, descriptores de despliegue, enlaces, extensiones, etc. proceden del archivo EAR. Esta opción no necesita obligatoriamente un valor. El valor predeterminado nouseMetaDataFromBinary que significa que los metadatos utilizados en tiempo de ejecución vienen del repositorio de configuración.

validateinstall

La opción validateinstall especifica el nivel de validación de la instalación de la aplicación. Los valores de opción válidos son:
  • off: especifica que no se realiza la validación del despliegue de la aplicación. Este valor es el predeterminado.
  • warn: realiza la validación del despliegue de la aplicación y sigue con el proceso de despliegue de la aplicación aunque existan avisos o mensajes notificados.
  • fail: realiza la validación de despliegue de la aplicación y no sigue con el proceso de despliegue de la aplicación cuando existan avisos o mensajes de error notificados.

validateSchema

La opción validateSchema especifica que se validen los descriptores de despliegue con los esquemas de descriptor de despliegue Java EE publicados. Cuando esta opción de despliegue de aplicaciones está seleccionada, el producto analiza cada descriptor de despliegue para determinar la versión de la especificación Java EE para el descriptor de despliegue, selecciona el esquema adecuado y, a continuación, comprueba el descriptor de despliegue en el esquema de descriptor de despliegue de Java EE. Los errores de validación producen mensajes de error.

Esta opción no necesita obligatoriamente un valor. El valor predeterminado es novalidateSchema. De forma predeterminada, la opción validateSchema se pasa por alto durante el despliegue y el producto no valida los descriptores de despliegue.

verbose

La opción verbose produce que se visualicen mensajes adicionales durante la instalación. Esta opción no necesita obligatoriamente un valor.

WebServicesClientBindDeployedWSDL

La opción WebServicesClientBindDeployedWSDL identifica el servicio web cliente que está modificando. Los campos de ámbito son: Módulo, EJB y Servicio web. El único valor modificable de esta tarea es el nombre de archivo de WSDL. Indica el WSDL (Web Services Description Language) que utiliza el cliente.

El campo Módulo identifica la aplicación web o empresarial dentro de la aplicación. Si el módulo es un enterprise bean, el campo EJB identifica un determinado enterprise bean dentro del módulo. El campo Servicio web identifica el servicio web dentro del módulo de enterprise bean o de aplicación web. Este identificador se corresponde con el atributo wsdl:service del archivo WSDL, que tiene un prefijo de service/; por ejemplo, service/WSLoggerService2.

El atributo WSDL desplegado denomina a un archivo WSDL relativo al módulo de cliente. Este es un ejemplo de un WSDL desplegado para una aplicación web: WEB-wsloggerservice.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindDeployedWSDL {{AddressBookW2JE.jar 
 AddressBookW2JE service/WSLoggerService2 META-INF/wsdl/DeployedWsdl1.wsdl}}} 
Utilizando Jacl con coincidencia de patrones:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindDeployedWSDL {{.*  .*  .*  
 META-INF/wsdl/DeployedWsdl1.wsdl}}}
El ejemplo siguiente ilustra las opciones BindJndiForEJBNonMessageBinding, Hermaphrodite y WebServicesClientBindDeployedWSDL:
$AdminApp install WebServicesSamples.ear {
-WebServicesClientBindDeployedWSDL {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 META-INF/wsdl/DeployedWsdl1.wsdl}} 
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml 
jndi1 "" "" } { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }}
-MapWebModToVH {{ "nombre_módulo" servicios_web.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} } 
Utilizando Jython:
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindDeployedWSDL 
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 META-INF/wsdl/DeployedWsdl1.wsdl]]]') 
Para instalar el ejemplo webservicessamples.ear, debe especificar las opciones BindJndiForEJBNonMessageBinding y MapWebModToVH así como la opción WebServicesClientBindDeployedWSDL:
$AdminApp install WebServicesSamples.ear', '[
-WebServicesClientBindDeployedWSDL [[ AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 META-INF/wsdl/DeployedWsdl1.wsdl ]] 
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml 
jndi1 "" "" ] [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]]
-MapWebModToVH [[ "nombre_módulo" servicios_web.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' ) 
Utilizando Jython con coincidencia de patrones:
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindDeployedWSDL',
['.*', '.*', '.*',  'META-INF/wsdl/DeployedWsdl1.wsdl']]])

WebServicesClientBindPortInfo

La opción WebServicesClientBindPortInfo identifica el puerto de un servicio web cliente que se está modificando. Los campos de ámbito son: Módulo, EJB, Servicio web y Puerto. Los valores modificables de esta tarea son: Tiempo de espera de sincronización, ID de BasicAuth, Contraseña de BasicAuth, Configuración SSL y URL de punto final sobrescrito. La autenticación básica y los campos SSL (Secure Sockets Layer) afectan a la seguridad de nivel de transporte, no a la seguridad de los servicios web.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPortInfo {{AddressBookW2JE.jar 
 AddressBookW2JE service/WSLoggerService2 WSLoggerJMS 3000 newHTTP_ID newHTTP_pwd sslAliasConfig 
 http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}} 
Para instalar el ejemplo webservicessamples.ear, debe especificar las opciones BindJndiForEJBNonMessageBinding y MapWebModToVH así como la opción WebServicesClientBindPortInfo:
$AdminApp install WebServicesSamples.ear {
-WebServicesClientBindPortInfo {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 WSLoggerJMS 3000 newHTTP_ID newHTTP_pwd sslAliasConfig
 http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}} 
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml
 jndi1 "" "" }
 { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample
 EJB" com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }}
-MapWebModToVH {{ "nombre_módulo" servicios_web.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} } 
Utilizando Jacl con coincidencia de patrones:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPortInfo {{.*  .*  .*  .*  3000 
 newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}}
Utilizando Jython:
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindPortInfo
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS 3000 newHTTP_ID
 newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS]]]') 
Para instalar el ejemplo webservicessamples.ear, debe especificar las opciones BindJndiForEJBNonMessageBinding y MapWebModToVH así como la opción WebServicesClientBindPortInfo:
AdminApp.install('WebServicesSamples.ear', '[
-WebServicesClientBindPortInfo [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS
 3000 newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS ]] 
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" ]
 [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]]
-MapWebModToVH [[ "nombre_módulo" servicios_web.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' )
Utilizando Jython con coincidencia de patrones:
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindPortInfo',
 [['.*', '.*', '.*', '.*', '3000', 'newHTTP_ID', 'newHTTP_pwd', 'sslAliasConfig',
 'http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS']]])

WebServicesClientBindPreferredPort

La opción WebServicesClientBindPreferredPort asocia un puerto preferido (implementación) con un tipo de puerto (interfaz) para un servicio web cliente. Los valores inmutables identifican un tipo de puerto del servicio web cliente que se está modificando. Los campos de ámbito son: Módulo, EJB, Servicio web y Tipo de puerto. El valor modificable de esta tarea es Puerto.
  • Tipo de puerto: QName ("{espacionombres} nombrelocal") de un tipo de puerto definido por un atributo wsdl:portType en el archivo WSDL que identifica una interfaz.
  • Puerto: QName de un puerto definido por un atributo wsdl:port dentro de un atributo wsdl:service en un archivo WSDL que identifica una implementación a la que se da preferencia.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPreferredPort
 {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort}}} 
Para instalar el ejemplo webservicessamples.ear, debe especificar las opciones BindJndiForEJBNonMessageBinding y MapWebModToVH así como la opción WebServicesClientBindPreferredPort:
$AdminApp install WebServicesSamples.ear
{-WebServicesClientBindPreferredPort {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 WSLoggerJMS WSLoggerJMSPort}}
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" }
 { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }}
-MapWebModToVH {{ "nombre_módulo" servicios_web.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} } 
Utilizando Jacl con coincidencia de patrones:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPreferredPort {{.* .* .* .* 
 WSLoggerJMSPort}}}
Utilizando Jython:
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindPreferredPort 
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort]]]') 
Para instalar el ejemplo webservicessamples.ear, debe especificar las opciones BindJndiForEJBNonMessageBinding y MapWebModToVH así como la opción WebServicesClientBindPreferredPort:
AdminApp.install('WebServicesSamples.ear',
'[ -WebServicesClientBindPreferredPort
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort ]]
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" ]
 [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]]
-MapWebModToVH [[ "nombre_módulo" servicios_web.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' )
Utilizando Jython con coincidencia de patrones:
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindPreferredPort',
 [['.*', '.*', '.*', '.*', 'WSLoggerJMSPort']]])

WebServicesServerBindPort

La opción WebServicesServerBindPort establece dos atributos de un puerto de servicio web. Los valores inmutables identifican el puerto de un servicio web que se está modificando. Los campos de ámbito son: Módulo, Servicio web y Puerto. Los valores modificables son: Nombre de servicio WSDL y Ámbito.

El ámbito determina el ciclo de vida de la implementación del bean Java. Los valores válidos son: Solicitud (una nueva instancia para cada solicitud), Aplicación (una instancia para cada aplicación web) y Sesión (una nueva instancia para cada sesión HTTP).

El atributo de ámbito no se aplica a los servicios web que transporten un JMS (Java Message Service). El atributo de ámbito no se aplica a los enterprise beans.

El nombre de servicio WSDL identifica un servicio cuando hay más de uno con el mismo nombre de puerto. El nombre de servicio WSDL se representa como una serie de QName, por ejemplo, {espacionombres}nombrelocal.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp install WebServicesSamples.ear {-WebServicesServerBindPort
 {{AddressBookW2JE.jar service/WSLoggerService2 WSLoggerJMS {} Session}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install WebServicesSamples.ear {-WebServicesServerBindPort
 {{.*  WSClientTestService WSClientTest Request} {.*  StockQuoteService StockQuote Application}
 {.*  StockQuoteService StockQuote2 Session}}}
Utilizando Jython:
AdminApp.install('WebServicesSamples.ear', '[-WebServicesServerBindPort
 [[AddressBookW2JE.jar service/WSLoggerService2 WSLoggerJMS "" Session]]]')
Utilizando Jython con coincidencia de patrones:
AdminApp.install('WebServicesSamples.ear', ['-WebServicesServerBindPort',
 [['.*', 'WSClientTestService', 'WSClientTest', 'Request'],
 ['.*', 'StockQuoteService', 'StockQuote', 'Application'],
 ['.*', 'StockQuoteService', 'StockQuote2', 'Session']]])

WebServicesClientCustomProperty

La opción WebServicesClientCustomProperty soporta la configuración del parámetro de valor de nombre para la descripción del archivo de enlace del cliente de un servicio web. Los valores inmutables identifican el puerto del servicio web que se está modificando. Los campos de ámbito son: Module, Servicio web y Puerto. Los valores modificables son: nombre y valor.

El formato de los valores nombre y valor incluye una serie que representa varios pares de nombre y valor utilizando el carácter + como separador. Por ejemplo, serie de nombre = "n1+n2+n3" serie de valor = "v1+v2+v3" da como resultado pares de nombre/valor {{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}},

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp edit WebServicesSamples {-WebServicesClientCustomProperty
 {{join.jar com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest service/StockQuoteService
 STockQuote propname1 propValue1}
{ejbclientonly.jar Exchange service/STockQuoteService STockQuote propname2 propValue2}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp edit WebServicesSamples {-WebServicesClientCustomProperty
 {{join.jar com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest .* .* propname1 propValue1}
 {ejbclientonly.jar Exchange .* .* propname2 propValue2}}}
Utilizando Jython:
AdminApp.edit('WebServicesSamples', ['-WebServicesClientCustomProperty',
 [['join.jar', 'com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest',
 'service/StockQuoteService', 'STockQuote', 'propname1', 'propValue1'],
 ['ejbclientonly.jar', 'Exchange', 'service/STockQuoteService', 'STockQuote',
 'propname2', 'propValue2']]])
Utilizando Jython con coincidencia de patrones:
AdminApp.edit('WebServicesSamples', ['-WebServicesClientCustomProperty',
 [['join.jar', 'com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest',
 '.*', '.*', 'propname1', 'propValue1'],
 ['ejbclientonly.jar', 'Exchange', '.*', '.*', 'propname2', 'propValue2']]])

WebServicesServerCustomProperty

La opción WebServicesServerCustomProperty soporta la configuración del parámetro de valor de nombre para la descripción del archivo de enlace del servidor de un servicio web. Los campos de ámbito son: Módulo, EJB y Servicio web. Los valores modificables de esta tarea son: nombre y valor.

El formato de estos valores incluyen una serie que representa varios pares de nombre y valor utilizando el carácter más (+) como separador. Por ejemplo, serie de nombre= "n1+n2+n3" serie de valor = "v1+v2+v3" da como resultado pares de nombre y valor: {{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}}.

Uso del ejemplo de modalidad de proceso por lotes

Utilizando Jacl:
$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty
 {{AddressBookW2JE.jar AddressBookService AddressBook
 com.ibm.websphere.webservices.http.responseContentEncoding deflate}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty
 {{.* .* .* com.ibm.websphere.webservices.http.responseContentEncoding deflate}}}
Utilizando Jython:
AdminApp.edit ( 'WebServicesSamples', '[ -WebServicesServerCustomProperty
 [[AddressBookW2JE.jar AddressBookService AddressBook
 com.ibm.websphere.webservices.http.responseContentEncoding deflate]]]')
Utilizando Jython con coincidencia de patrones:
AdminApp.edit ( 'WebServicesSamples', ['-WebServicesServerCustomProperty', [['.*', '.*',
 '.*', 'com.ibm.websphere.webservices.http.responseContentEncoding', 'deflate']]])

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_taskoptions
File name: rxml_taskoptions.html