Grupo de mandatos RARUpdate

Utilice el asistente de actualización de archivos de adaptador de recursos (RAR) para actualizar el módulo RAR y la configuración de las propiedades de los adaptadores de recursos J2C. El servidor de aplicaciones utiliza las clases y otro código que constituyen un archivo RAR (archivador de adaptadores de recursos) para dar soporte a los adaptadores de recursos que configure.

Para evitar problemas, utilice el asistente de actualización RAR de la consola administrativa. Para obtener más información, consulte el tema Actualización de un archivo de adaptador de recursos.

El grupo de mandatos RARUpdate contiene los siguientes mandatos:

compareResourceAdapterToRAR

El mandato compareResourceAdapterToRAR determina si un adaptador de recursos es compatible con un archivo RAR nuevo. Un adaptador de recursos puede actualizarse con un RAR sólo si ambos son compatibles.

Objeto de destino

ID de objeto de adaptador de recursos - Objeto de configuración del adaptador de recursos que se comparará para la actualización.

Resultado

El mandato devuelve true si el adaptador de recursos es compatible con el RAR especificado. También muestra las versiones del adaptador de recursos y del archivo RAR. Si el adaptador de recursos no es compatible con el RAR especificado, el mandato devuelve false y proporciona un mensaje que indica el porqué de la incompatibilidad.

Parámetros necesarios

-rarPath
Vía de acceso absoluta del archivo RAR. (String, obligatorio)

Ejemplos

Uso del ejemplo de modalidad por lotes:

AdminTask.compareResourceAdapterToRAR("Test Resource Adapter(cells/cell/nodes/node|resources.xml#J2CResourceAdapter_1169157308943"),
     '[-rarPath "c:\tra\rar\TRA.rar"]')

getNewRAObjectProperties

El mandato getNewRAObjectProperties obtiene la lista de nuevas propiedades de un archivo RAR que pueden configurarse al actualizar un adaptador de recursos.

Objeto de destino

ID de objeto de adaptador de recursos - Objeto de configuración del adaptador de recursos que se actualizará.

Resultado

Se recibe la lista de nuevas propiedades que pueden configurarse en el adaptador de recursos al actualizar un archivo RAR.

Parámetros necesarios

-rarPath
Vía de acceso absoluta del archivo RAR. (String, obligatorio)
-returnType
El tipo de valor de retorno, String o Hashtable. Si el valor de returnType es String, el mandato devuelve una serie como entrada para el mandato updateRAR; si el valor de returnType es "Hashtable", el mandato devuelve una tabla java.util.Hashtable que debe utilizarse con la consola administrativa. El valor predeterminado de returnType es String. (String, opcional)

Ejemplos

Uso del ejemplo de modalidad por lotes:
  • En Jython:
    AdminTask.getNewRAObjectProperties('"Test Resource Adapter(cells/cell/nodes/node|resources.xml#J2CResourceAdapter_1169157308943)"', 
         '[-rarPath c:/tra/RAR/TRA.rar -returnType String]')

findOtherRAsToUpdate

El mandato findOtherRAsToUpdate localiza otros adaptadores de recursos en la configuración que sean parecidos al adaptador de recursos que debe actualizarse. Los adaptadores de recursos resultantes también deben actualizarse.

Objeto de destino

ID de objeto de adaptador de recursos - El objeto de configuración del adaptador de recursos que se comparará para la actualización.

Resultado

El mandato devuelve una lista de serie de ID de objeto adaptador de recursos que puede ser la entrada del objeto de destino de los mandatos RARUpdate.

Ejemplos

Uso del ejemplo de modalidad por lotes:
  • En Jython:
    AdminTask.findOtherRAsToUpdate('"Test Resource Adapter(cells/cell/nodes/node|resources.xml#J2CResourceAdapter_1169157308943)"')

updateRAR

El mandato updateRAR actualiza el archivo RAR y la configuración de un adaptador de recursos en un ámbito específico.

Objeto de destino

ID de objeto de adaptador de recursos - El objeto de configuración del adaptador de recursos que se actualizará.

Resultado

Este mandato devuelve un mensaje de ejecución satisfactoria o anómala tras la terminación.

Parámetros necesarios

-rarPath
Vía de acceso absoluta del archivo RAR nuevo. (String, obligatorio)

Parámetros opcionales

-ResourceAdapterProps
Lista de pares [nombre valor] de nuevas propiedades que se van a establecer en la clase de implementación ResourceAdapter. Puede especificar los siguientes parámetros para este paso:
-name
Nombre de la propiedad del adaptador de recursos. (String, opcional)
-value
Valor de la propiedad del adaptador de recursos. (String, opcional)
-ConnectionFactoryProps
Lista de tripletes [ID nombre valor] de las nuevas propiedades que deben establecerse en las fábricas de conexiones en la configuración del adaptador de recursos. Puede especificar los siguientes parámetros para este paso:
-id
Nombre JNDI (Java Naming and Directory Interface) de la fábrica de conexiones. (String, opcional)
-name
Nombre de la propiedad de la fábrica de conexiones. (String, opcional)
-value
Valor de la propiedad del adaptador de recursos. (String, opcional)
-ActivationSpecProps
Lista de tripletes [ID nombre valor] de las nuevas propiedades que deben establecerse en las especificaciones de activación en la configuración del adaptador de recursos. Puede especificar los siguientes parámetros para este paso:
-id
Nombre JNDI (Java Naming and Directory Interface) de la especificación de activación. (String, opcional)
-name
Nombre de la propiedad de especificación de activación. (String, opcional)
-value
Valor de la propiedad de especificación de activación. (String, opcional)
-AdminObjectProps
Lista de tripletes [ID nombre valor] de las nuevas propiedades que deben establecerse en los objetos administrados en la configuración del adaptador de recursos. Puede especificar los siguientes parámetros para este paso:
-id
Nombre JNDI (Java Naming and Directory Interface) de la especificación de activación. (String, opcional)
-name
Nombre de la propiedad de objeto administrado. (String, opcional)
-value
Valor de la propiedad de objeto administrado. (String, opcional)

Ejemplos

Uso del ejemplo de modalidad por lotes:

  • En Jython:
    AdminTask.updateRAR('"Test Resource Adapter(cells/cell/nodes/node|resources.xml#J2CResourceAdapter_1169157308943)"', 
         '[-rarPath c:/tra/RAR/TRA.rar -ResourceAdapterProps [[RAProp1 RAProp1Val] [RAProp2 RAProp2Val]] 
         -ConnectionFactoryProps [[eis/TRA_CF_1 CFProp1 CFProp1Val] [eis/TRA_CF_2 CFProp1 CFProp1Val2] [eis/TRA_DIF_CF CFProp2 CFProp2val]] 
         -ActivationSpecProps [[eis/TRA_AS_1 ASProp1 ASProp1Val] [eis/TRA_AS_1 ASProp2 ASProp2Val] [eis/TRA_AS_2 ASProp3 ASProp3val] [eis/TRA_AS_2 ASProp4 ASProp4Val]] 
         -AdminObjectProps [[eis/TRA_AO_1 AOProp1 AOProp1Val] [eis/TRA_AO_1 AOProp2 AOProp2Val] [eis/TRA_AO_2 AOProp1 AOProp1Val] [eis/TRA_AO_3 AOProp2 AOProp2Val]]]')

Ejemplo de utilización de la modalidad interactiva:

  • En Jython:
    AdminTask.updateRAR('-interactive')

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=rdat_updateRAR
File name: rdat_updateRAR.html