Grupo de mandatos BLAManagement para el objeto AdminTask con scripts wsadmin

Puede utilizar el lenguaje de script Jython para configurar y administrar aplicaciones de nivel de negocio con la herramienta wsadmin. Utilice los mandatos y parámetros del grupo BLAManagement para crear, editar, exportar, suprimir y consultar aplicaciones de nivel de negocio en su configuración.

Para configurar y administrar las aplicaciones de nivel de negocio, debe utilizar el rol administrativo de configurador.

Un activo representa uno o varios archivos binarios de aplicación que se almacenan en un repositorio de activos. Los activos típicos incluyen lógica empresarial de aplicación como, por ejemplo, archivos de empresa, archivos de biblioteca y otros archivos de recursos. Utilice los mandatos siguientes para gestionar las configuraciones de los activos:
Una aplicación de nivel de negocio es un artefacto de configuración formado por cero o más unidades de composición u otras aplicaciones de nivel de negocio. Las aplicaciones de nivel de negocio son modelos administrativos que definen una aplicación, y pueden contener archivos EAR (enterprise archive), bibliotecas compartidas y aplicaciones PHP, entre otros elementos. Utilice los mandatos siguientes para configurar y administrar aplicaciones de nivel de negocio:
Una unidad de composición representa un activo en una aplicación de nivel de negocio. Una unidad de composición habilita el contenido del activo para interactuar con otros activos de la aplicación. También permite que el entorno de ejecución del producto cargue y ejecute el contenido del activo. Utilice los mandatos siguientes para gestionar la configuración de las unidades de composición:

deleteAsset

El mandato deleteAsset elimina un activo de la configuración de la aplicación de nivel empresarial. Antes de utilizar este mandato, verifique que no existe ninguna unidad de composición asociada con el activo de interés. El mandato falla si el activo está asociado a unidades de composición.

Objeto de destino

Ninguno

Parámetros necesarios

-assetID
Especifica el ID de configuración del activo que se debe suprimir. El mandato acepta ID incompletos para el parámetro assetID, siempre y cuando el sistema pueda establecer una correspondencia entre la serie y un activo único. (String, obligatorio)

Parámetros opcionales

-force
Especifica si debe forzarse al sistema para que suprima un activo, aun cuando otros activos dependan del mismo. (Boolean, opcional)

Valor de retorno

El mandato devuelve el ID de configuración del activo suprimido, como se muestra en el ejemplo siguiente:
WebSphere:assetname=activo2.zip

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.deleteAsset('-assetID activo2.zip -force true')
  • Utilizando la lista Jython:
    AdminTask.deleteAsset(['-assetID', 'activo2.zip', '-force', 'true'])

Ejemplo de utilización de la modalidad interactiva

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

editAsset

El mandato editAsset modifica opciones adicionales de configuración de activos. Puede utilizar este mandato para modificar la descripción, el URL de destino, las relaciones entre activos, los permisos de archivos y los valores de validación.

Objeto de destino

Ninguno

Parámetros necesarios

-assetID
Especifica el ID de configuración del activo que debe editarse. Este parámetro acepta un ID de configuración incompleto, siempre y cuando el sistema pueda establecer una correlación entre la serie y un ID de activo exclusivo. (String, obligatorio)

Pasos opcionales

Para conocer los pasos opcionales, utilice los caracteres .* para especificar un argumento de sólo lectura en la sintaxis de mandato. Especifique una serie vacía con los caracteres "" para conservar el valor existente del argumento. Si no especifica un valor o una serie vacía para un argumento con permisos de escritura, el mandato restablece el argumento en un valor nulo.
-AssetOptions
Utilice el paso AssetOptions y los argumentos siguientes para definir propiedades adicionales para el activo.
inputAsset (sólo lectura)
Especifica el paquete de origen del activo.
name (sólo lectura)
Especifica el nombre del activo. El valor predeterminado para este argumento es el nombre de archivo del paquete de origen.
defaultBindingProps (sólo lectura)
Especifica las propiedades de enlace predeterminadas para el activo. Este argumento sólo se aplica a los activos empresariales. Para los activos que no son empresariales, especifique el carácter de asterisco (*) para la coincidencia de patrón. Para los activos empresariales, especifique el valor .* para establecer el argumento como un valor no vacío.
descripción
Especifica una descripción del activo.
destinationUrl
Especifica el URL de los binarios de activos que deben desplegarse.
typeAspect
Especifica el aspecto del tipo de activo.
relationship
Especifica la relación del activo. Utilice el carácter de signo más (+) para añadir activos adicionales a la relación existente. Utilice el carácter del signo de número (#) para suprimir un activo existente de la relación. Para sustituir las relaciones existentes, especifique la misma sintaxis que en el mandato importAsset. Si el activo especificado en la relación no existe para la adición o actualización, el mandato devuelve una excepción.
filePermission
Especifica la configuración de los permisos de archivo.
validate
Especifica si debe validarse el activo. El valor predeterminado es false. El producto no guarda el valor especificado para su validación. Por consiguiente, si selecciona validar el activo (true) ahora y lo actualiza más adelante, cuando edite el activo debe volver a habilitar este valor para que el producto valide los archivos actualizados.
-UpdateAppContentVersions
Para un activo EBA, utilice este paso y los argumentos siguientes para seleccionar versiones de paquete para el activo.
trns : En el paquete de características de WebSphere Application Server Versión 7 para aplicaciones OSGi y Java™ Persistence API 2.0, los cambios en el paquete para el activo se aplican reiniciando la aplicación de nivel empresarial. En la Versión 8.x, estos cambios se aplican actualizando la unidad de composición. El nuevo enfoque de la versión 8.x significa que se pueden aplicar muchos cambios de paquete sin reiniciar la aplicación de nivel de empresa. Para habilitar este nuevo enfoque, el parámetro UpdateAppContentVersionsStep se ha sustituido por el parámetro UpdateAppContentVersions y, en lugar de reiniciar la aplicación de nivel empresarial, debe ejecutar el mandato editCompUnit con el parámetro CompUnitStatusStep.
nombre_paquete
Especifica el nombre del paquete.
versión_actual
Especifica un número de versión de paquete, como por ejemplo 1.0.0, o NOT_DEPLOYED para paquetes compartidos (es decir, use bundles) que se declaran en el manifiesto de aplicación pero no están desplegados por el entorno de ejecución. Este argumento describe la configuración actual del paquete y no se utiliza para cambiar la configuración.
preferencia_actualización
Especifica la nueva preferencia de versión de paquete. Puede ser un número de versión de paquete, como por ejemplo 1.0.0, o NOT_DEPLOYED para paquetes compartidos, o bien NO_PREF si desea que el sistema elija automáticamente una versión de paquete. Si no desea actualizar la versión de un paquete dado, establezca este atributo en el mismo valor que está utilizando para el atributo versión_actual.
Incluya una entrada (es decir, el nombre_paquete versión_actual y preferencia_actualización) para cada paquete que aparece en el manifiesto de aplicación entre la cabecera de contenido de la aplicación y la cabecera de paquete de uso. Incluya todos los paquetes, tanto si actualiza o no la versión del paquete.
Especifique la sintaxis del modo siguiente:
AdminTask.editAsset('[
  -assetID nombre_activo 
  -UpdateAppContentVersions [
    [nombre_paquete_1 versión_actual preferencia_actualización]
    [nombre_paquete_2 versión_actual preferencia_actualización]
    [nombre_paquete_3 versión_actual preferencia_actualización]
    [nombre_paquete_4 versión_actual preferencia_actualización]
    [nombre_paquete_5 versión_actual preferencia_actualización]
  ]]')

Valor de retorno

El mandato devuelve el ID de configuración del activo de interés.

Uso del ejemplo de modalidad de proceso por lotes

Utilice los ejemplos siguientes para editar un activo que no sea empresarial:
  • Utilizando la serie Jython:
    AdminTask.editAsset('-assetID activo3.zip – AssetOptions [[.* activo3.zip * "activo para pruebas"
       c:/installedAssets/asset3.zip/BASE/asset3.zip "" assetname=a.jar "" false]]')
  • Utilizando la lista Jython:
    AdminTask.editAsset(['-assetID', 'asset3.zip', '–AssetOptions', '[[.* asset3.zip * "activo para pruebas"
       c:/installedAssets/asset3.zip/BASE/asset3.zip "" assetname=a.jar "" false]]'])
Utilice los ejemplos siguientes para editar un activo empresarial:
  • Utilizando la serie Jython:
    AdminTask.editAsset('-assetID defaultapp.ear – AssetOptions 
      [[.* defaultapp.ear .* "asset for testing" "" "" "" "" false]]')
  • Utilizando la lista Jython:
    AdminTask.editAsset(['-assetID', 'defaultapp.ear', '–AssetOptions', 
       '[[.* defaultapp.ear .* "activo para pruebas" "" "" "" "" false]]'])

Ejemplo de utilización de la modalidad interactiva

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

exportAsset

El mandato exportAsset exporta una configuración de activo a un archivo.

Objeto de destino

Ninguno

Parámetros necesarios

-assetID
Especifica el ID de configuración del activo que debe exportarse. Este parámetro acepta un ID de configuración incompleto siempre y cuando el ID coincida con un activo único. (String, obligatorio)
-filename
Especifica el nombre de archivo al que el sistema exporta la configuración del activo. (DownloadFile, obligatorio)

Valor de retorno

El mandato no devuelve ninguna salida.

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.exportAsset('-assetID asset2.zip – filename c:/temp/a2.zip')
  • Utilizando la lista Jython:
    AdminTask.exportAsset(['-assetID', 'asset2.zip', '–filename', 'c:/temp/a2.zip'])

Ejemplo de utilización de la modalidad interactiva

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

importAsset

El mandato importAsset importa una configuración de activo al repositorio de activos. Una vez que se han importado los archivos, pueden añadirse a las aplicaciones de nivel empresarial como unidades de composición.

Objeto de destino

Ninguno

Parámetros necesarios

-source
Especifica el nombre del archivo de origen que debe importarse. (UploadFile, obligatorio)

Parámetros opcionales

-storageType
Especifica el modo en que el sistema guarda el activo en el repositorio de activos. El repositorio de activos por omisión almacena binarios completos, metadatos de binarios o ningún binario. Especifique FULL para almacenar binarios completos. Especifique METADATA para almacenar la parte de metadatos de los binarios. Especifique NONE para no almacenar binarios en el repositorio. El valor predeterminado es FULL. (String, opcional)

Pasos opcionales

Para conocer los pasos opcionales, utilice los caracteres .* para especificar un argumento de sólo lectura en la sintaxis de mandato. Especifique una serie vacía con los caracteres "" para conservar el valor existente del argumento. Si no especifica un valor o una serie vacía para un argumento con permisos de escritura, el mandato restablece el argumento en un valor nulo.
-AssetOptions
Utilice el paso AssetOptions y los argumentos siguientes para definir propiedades adicionales para el activo.
inputAsset (sólo lectura)
Especifica el paquete de origen del activo.
nombre
Especifica el nombre del activo. El nombre del archivo de extensiones del activo debe coincidir con el nombre del archivo de extensiones del paquete de origen. El valor predeterminado para este argumento es el nombre de archivo del paquete de origen.
defaultBindingProps (sólo lectura)
Especifica las propiedades de enlace predeterminadas para el activo. Este argumento sólo se aplica a los activos empresariales. Para los activos que no son empresariales, especifique el carácter de asterisco (*) para la coincidencia de patrón. Para los activos empresariales, especifique el valor .* para establecer el argumento como un valor no vacío.
descripción
Especifica una descripción del activo.
destinationUrl
Especifica el URL de los binarios de activos que deben desplegarse.
typeAspect
Especifica el aspecto del tipo de activo. Especifique la opción typeAspect en el formato de nombre de objeto, como se muestra en la sintaxis siguiente: spec=xxx
relationship
Especifica la relación del activo. Utilice el carácter de signo más (+) para especificar varias relaciones de activos. El mandato devuelve una excepción si en la relación se especifican activos que no existen.
filePermission
Especifica la configuración de los permisos de archivo.

Las aplicaciones OSGi no utilizan un valor filePermission.

validate
Especifica si debe validarse el activo. El valor predeterminado es false. El producto no guarda el valor especificado para su validación. Por consiguiente, si selecciona validar el activo (true) ahora y lo actualiza más adelante, cuando edite el activo debe volver a habilitar este valor para que el producto valide los archivos actualizados.

Las aplicaciones OSGi no utilizan un valor validate.

Valor de retorno

El mandato devuelve el ID de configuración del activo que el sistema crea, como se muestra en el ejemplo siguiente:
WebSphere:assetname=activo2.zip

Uso del ejemplo de modalidad de proceso por lotes

Utilice los ejemplos siguientes para importar un activo que no sea empresarial:
  • Utilizando la serie Jython:
    AdminTask.importAsset('-source c:\ears\asset1.zip -storageType NONE')
  • Utilizando la lista Jython:
    AdminTask.importAsset(['-source', 'c:\ears\asset1.zip', '-storageType', 'NONE'])
Utilice los ejemplos siguientes para importar un activo que no sea empresarial, establezca asset2.zip como nombre del activo, guardar los binarios de metadatos en el repositorio de activos y definir el directorio de destino de los binarios que se van a desplegar:
  • Utilizando la serie Jython:
    AdminTask.importAsset('-source c:\ears\asset1.zip -storageType METADATA – AssetOptions 
      [[.* asset2.zip .* "asset for testing" c:/installedAssets/asset2.zip/BASE/asset2.zip "" "" "" "" false]]')
  • Utilizando la lista Jython:
    AdminTask.importAsset(['-source', 'c:\ears\asset1.zip', '-storageType', 'METADATA', '–AssetOptions',
       '[[.* asset2.zip .* "asset for testing" c:/installedAssets/asset2.zip/BASE/asset2.zip "" "" "" "" false]]')
Utilice los siguientes ejemplos para importar un activo que no sea empresarial y especifique las relaciones de los activos con los activos a.jar y b.jar:
  • Utilizando la serie Jython:
    AdminTask.importAsset('[-source c:\ears\asset3.zip -storageType FULL – AssetOptions
       [[.* asset3.zip .* "asset for testing" "" spec=zip assetname=a.jar+assetname=b.jar "" false]]]')
  • Utilizando la lista Jython:
    AdminTask.importAsset(['-source', 'c:\ears\asset3.zip', '-storageType', 'FULL', '–AssetOptions', 
      '[[.* asset3.zip .* "asset for testing" "" spec=zip assetname=a.jar+assetname=b.jar "" false]]'])
Utilice los ejemplos siguientes para importar un activo empresarial:
  • Utilizando la serie Jython:
    AdminTask.importAsset('-source c:\ears\defaultapplication.ear – storageType FULL – AssetOptions
       [[.* defaultapp.ear .* "desc" "" "" "" false]]')
  • Utilizando la lista Jython:
    AdminTask.importAsset(['-source', 'c:\ears\defaultapplication.ear', '–storageType', 
      'FULL', '–AssetOptions', '[[.* defaultapp.ear .* "desc" "" "" "" false]]'])

Ejemplo de utilización de la modalidad interactiva

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

listAssets

El mandato listAssets muestra el ID de configuración de cada activo dentro de la célula.

Objeto de destino

Ninguno

Parámetros opcionales

-assetID
Especifica el ID de configuración del activo de interés. Este parámetro acepta un ID de configuración incompleto siempre y cuando el ID coincida con un activo único. (String, opcional)
-includeDescription
Especifica si debe incluirse una descripción de cada uno de los activos que devuelve el mandato. Especifique true para visualizar las descripciones de los activos. (String, opcional)
-includeDeplUnit
Especifica si deben visualizarse unidades desplegables para cada uno de los activos que devuelve el mandato. Especifique true para visualizar unidades desplegables. (String, opcional)

Valor de retorno

El mandato devuelve una lista de ID de configuración para los activos de interés. En función de los valores de parámetro especificados, es posible que el mandato devuelva la descripción y las unidades desplegables de cada activo, como se muestra en el ejemplo siguiente:
WebSphere:assetname=asset1.zip
"activo para pruebas"

WebSphere:assetname=asset2.zip
"segundo activo para pruebas"
a.jar

WebSphere:aasetname=asset3.zip
"tercer activo para pruebas"
a1.jar+a2.jar

WebSphere:assetname=a.jar0
"a.jar para sharedlib"

WebSphere:assetname=b.jar
"b.jar para sharedlib"

WebSphere:assetname=defaultapp.ear
"aplic. predeterminada"

Uso del ejemplo de modalidad de proceso por lotes

Utilice los siguientes ejemplos para listar cada uno de los activos de la célula:
  • Utilizando Jython:
    AdminTask.listAssets()
Utilice los siguientes ejemplos para listar cada uno de los activos de la célula:
  • Utilizando la serie Jython:
    AdminTask.listAssets('-assetID asset1.zip')
  • Utilizando la lista Jython:
    AdminTask.listAssets(['-assetID asset1.zip'])
Utilice los ejemplos siguientes para listar cada activo, su descripción y las unidades de composición desplegables de la célula:
  • Utilizando la serie Jython:
    AdminTask.listAssets('-includeDescription true – includeDeplUnit true')
  • Utilizando la lista Jython:
    AdminTask.listAssets(['-includeDescription', 'true', '–includeDeplUnit', 'true')

Ejemplo de utilización de la modalidad interactiva

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

updateAsset

El mandato updateAsset modifica uno o varios archivos o archivos de módulo de un activo. El mandato actualiza el archivo binario del activo, pero no actualiza las unidades de composición que el sistema despliega con el activo como objeto de respaldo.

Objeto de destino

Ninguno

Parámetros necesarios

-assetID
Especifica el ID de configuración del activo que debe actualizarse. Este parámetro acepta un ID de configuración incompleto siempre y cuando el ID coincida con un activo único. (String, obligatorio)
-operation
Especifica la operación que debe invocarse en el activo ce interés. (String, obligatorio)
La tabla siguiente muestra las operaciones que se pueden invocar en el activo:
Tabla 1. Operaciones admitidas de updateAsset. Especifique una de las operaciones.
Operación Descripción
replace La operación replace sustituye el contenido del activo de interés.
merge La operación merge actualiza varios archivos del activo, pero no los actualiza todos.
add La operación add añade un archivo o un archivo de módulo nuevo.
addupdate La operación addupdate añade o actualiza un archivo o un archivo de módulo. Si el archivo no existe, el sistema añade el contenido. Si el archivo existe, el sistema lo actualiza.
update La operación update actualiza un archivo o un archivo de módulo.
delete La operación delete suprime un archivo o un archivo de módulo.
-contents
Especifica el archivo que contiene el contenido que debe añadirse o actualizarse. Este parámetro no es obligatorio para la operación delete. (UploadFile, opcional)

Parámetros opcionales

-contenturi
Especifica el URI (Uniform Resource Identifier) del archivo que debe añadirse, actualizarse o eliminarse del activo. Este parámetro no es obligatorio para las operaciones merge o replace. (String, opcional)

Pasos opcionales

Para conocer los pasos opcionales, utilice los caracteres .* para especificar un argumento de sólo lectura en la sintaxis de mandato. Especifique una serie vacía con los caracteres "" para conservar el valor existente del argumento. Si no especifica un valor o una serie vacía para un argumento con permisos de escritura, el mandato restablece el argumento en un valor nulo.
-AssetOptions
Utilice el paso AssetOptions y los argumentos siguientes para definir propiedades adicionales para el activo.
name (sólo lectura)
Especifica el nombre del activo. El valor predeterminado para este argumento es el nombre de archivo del paquete de origen.
defaultBindingProps (sólo lectura)
Especifica las propiedades de enlace predeterminadas para el activo. Este argumento sólo se aplica a los activos empresariales. Para los activos que no son empresariales, especifique el carácter de asterisco (*) para la coincidencia de patrón. Para los activos empresariales, especifique el valor .* para establecer el argumento como un valor no vacío.
descripción
Especifica una descripción del activo.
destinationUrl
Especifica el URL de los binarios de activos que deben desplegarse.
typeAspect
Especifica el aspecto del tipo de activo.
relationship
Especifica la relación del activo. Utilice el carácter de signo más (+) para añadir activos adicionales a la relación existente. Utilice el carácter del signo de número (#) para suprimir un activo existente de la relación. Para sustituir las relaciones existentes, especifique la misma sintaxis que en el mandato importAsset. Si el activo especificado en la relación no existe para la adición o actualización, el mandato devuelve una excepción.
filePermission
Especifica la configuración de los permisos de archivo.
validate
Especifica si debe validarse el activo. El valor predeterminado es false. El producto no guarda el valor especificado para su validación. Por consiguiente, si selecciona validar el activo (true) ahora y lo actualiza más adelante, cuando edite el activo debe volver a habilitar este valor para que el producto valide los archivos actualizados.
updateAssociatedCUs
Especifica si se deben actualizar las unidades de composición que están asociadas con un activo empresarial (Java EE). Este argumento sólo se aplica a los activos empresariales. El valor predeterminado es none. Especifique all para actualizar todas las unidades de composición asociadas con el activo empresarial.

En la operación replace, especifique valores para los argumentos de nombre de AssetOptions, defaultBindingProps, description, destinationUrl, typeAspect, relationship, filePermission, validate y updateAssociatedCUs. En operaciones que no son de replace, especifique los argumentos de nombre de AssetOptions y updateAssociatedCUs.

Valor de retorno

El mandato devuelve el ID de configuración del activo de interés.

Uso del ejemplo de modalidad de proceso por lotes

El ejemplo siguiente sustituye el contenido de un activo no empresarial:
  • Utilizando la serie Jython:
    AdminTask.updateAsset('-assetID asset1.zip -operation
    replace -contents c:/temp/a.zip')
  • Utilizando la lista Jython:
    AdminTask.updateAsset(['-assetID', 'asset1.zip', '-operation',
    'replace', '-contents', 'c:/temp/a.zip'])
En el ejemplo siguiente se actualizan de manera parcial los archivos de un activo que no es empresarial:
  • Utilizando la serie Jython:
    AdminTask.updateAsset('-assetID asset1.zip – operation merge – contents c:/temp/p.zip')
  • Utilizando la lista Jython:
    AdminTask.updateAsset(['-assetID', 'asset1.zip', '–operation', 'merge', '–contents', 'c:/temp/p.zip'])
En el ejemplo siguiente se actualiza un activo empresarial con un archivo de módulo EJB (Enterprise JavaBeans):
  • Utilizando la serie Jython:
    AdminTask.updateAsset('-assetID defaultapp.ear – operation add – contents 
      c:/temp/filename.jar – contenturi filename.jar')
  • Utilizando la lista Jython:
    AdminTask.updateAsset(['-assetID', 'defaultapp.ear', '–operation', 'add', '–contents', 
      'c:/temp/filename.jar', '–contenturi', 'filename.jar'])
En el ejemplo siguiente se sustituyen un activo empresarial y sus unidades de composición asociadas mediante una operación de sustitución:
  • Utilizando la serie Jython:
    AdminTask.updateAsset('-assetID defaultapp.ear –operation replace –contents 
      c:/temp/newapp.ear – AssetOptions [[defaultapp.ear .* newdesc "" "" "" "" false all]]')
  • Utilizando la lista Jython:
    AdminTask.updateAsset(['-assetID', 'defaultapp.ear', '–operation', 'replace', '–contents',
      'c:/temp/newapp.ear', '–AssetOptions [[defaultapp.ear .* newdesc "" "" "" "" false all]]'])
En el ejemplo siguiente se actualizan un activo empresarial y sus unidades de composición asociadas mediante una operación de fusión:
  • Utilizando la serie Jython:
    AdminTask.updateAsset('-assetID defaultapp.ear –operation merge –contents 
      c:/temp/newapp.ear – AssetOptions [[defaultapp.ear all]]')
  • Utilizando la lista Jython:
    AdminTask.updateAsset(['-assetID', 'defaultapp.ear', '–operation', 'merge', '–contents',
      'c:/temp/newapp.ear', '–AssetOptions [[defaultapp.ear all]]'])

Ejemplo de utilización de la modalidad interactiva

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

viewAsset

El mandato viewAsset muestra opciones adicionales de configuración de activos y los valores configurados.

Objeto de destino

Ninguno

Parámetros necesarios

-assetID
Especifica el ID de configuración del activo de interés. Este parámetro acepta un ID de configuración incompleto siempre y cuando el ID coincida con un activo único. (String, obligatorio)

Parámetros opcionales

Ninguno

Valor de retorno

El mandato devuelve datos de configuración para el activo de interés, como se muestra en el siguiente ejemplo:
Especificar las opciones del
activo (AssetOptions)

Especifique las opciones para el activo.

*Nombre de activo (name): [defaultapp.ear]
Default Binding Properties (defaultBindingProps): 
 [defaultbinding.ejbjndi.prefix#defaultbinding.datasource.jndi#defaultbinding.datasource.username
#defaultbinding.datasource.password#defaultbinding.cf.jndi
#defaultbinding.cf.resauth#defaultbinding.virtual.host#defaultbinding.force]
Asset Description (description): []
Asset Binaries Destination Url (destination): [${USER_INSTALL_ROOT}/installedAssets/defaultapp.ear/BASE/defaultapp.ear]
Aspectos de tipo del activo (typeAspect): [WebSphere:spec=j2ee_ear]
Relaciones del activo (relationship): []File Permission (filePermission): [.*\\.dll=755#.*\\.so=755#.*\\.a=755#.*\\.sl=755]
Validar activo (validate): [false]

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.viewAsset('-assetID asset3.zip')
  • Utilizando la lista Jython:
    AdminTask.viewAsset(['-assetID', 'asset3.zip'])

Ejemplo de utilización de la modalidad interactiva

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

addCompUnit

EL mandato addCompUnit añade una unidad de composición a una aplicación de nivel de negocio específica. Una unidad de composición representa un activo en una aplicación de nivel de negocio Y habilita el contenido del activo para que interactúe con otros activos de la aplicación. También permite que el entorno de ejecución del producto cargue y ejecute el contenido del activo.

Objeto de destino

Ninguno

Parámetros necesarios

-blaID
Especifica el ID de configuración de la aplicación de nivel de negocio de interés. (String, obligatorio)
-cuSourceID
Especifica el ID de configuración de origen para la unidad de composición que debe añadirse. Puede especificar un ID de activo o un ID de aplicación de nivel de negocio. (String, obligatorio)

Parámetros opcionales

-deplUnits
Especifica las unidades desplegables que deben desplegarse para el activo. Puede especificar un subconjunto de unidades desplegables, todas las unidades desplegables, o utilizar el valor predeterminado como biblioteca compartida. Si no especifica este parámetro, el sistema despliega todas las unidades desplegables. (String, opcional)
En el caso de activos Java EE, el sistema ignora este parámetro -deplunits e, independientemente del valor especificado, puede añadir activos Java EE como parte de este mandato.
-cuConfigStrategyFile
Especifica la vía de acceso completa del archivo para las propiedades de enlace predeterminadas. Este parámetro sólo se aplica a los activos empresariales. (String, opcional)
-defaultBindingOptions
Especifica propiedades de enlace JNDI (Java Naming and Directory Interface) opcionales para un activo empresarial. Las propiedades de enlace disponibles dependen del tipo de activo empresarial. Utilice el formato propiedad=valor para especificar una propiedad de enlace predeterminado. Para especificar más de una propiedad, separe cada sentencia propiedad=valor mediante el delimitador #.
Puede especificar ahora las propiedades de enlace, al crear el activo, o más adelante, al añadir el activo como unidad de composición a una aplicación de nivel de negocio. Si especifica las propiedades de enlace más adelante cuando añada el activo a una aplicación de unidad de negocio, puede utilizar un archivo de estrategia para especificarlas. (String, opcional)
Utilice las opciones siguientes con el parámetro defaultBindingOptions:
Tabla 2. Propiedades de enlaces addCompUnit -defaultBindingOptions admitidas. Especifique una propiedad de enlace que el tipo de activo admita.
Tipo de activo empresarial Propiedades de enlace soportadas
Enterprise bean (EJB)

defaultbinding.ejbjndi.prefix

defaultbinding.force

Origen de datos

defaultbinding.datasource.jndi

defaultbinding.datasource.username

defaultbinding.datasource.password

defaultbinding.force

Fábrica de conexiones

defaultbinding.cf.jndi

defaultbinding.cf.resauth

defaultbinding.force

Host virtual

defaultbinding.virtual.host

defaultbinding.force

Pasos opcionales

También puede especificar valores para pasos opcionales para definir propiedades adicionales para la nueva unidad de composición. Estos pasos no se aplican a los activos empresariales. Para conocer los pasos opcionales, utilice los caracteres .* para especificar un argumento de sólo lectura en la sintaxis de mandato. Especifique una serie vacía con los caracteres "" para conservar el valor existente del argumento. Si no especifica un valor o una serie vacía para un argumento con permisos de escritura, el mandato restablece el argumento en un valor nulo.
-CUOptions
Especifica propiedades adicionales para la unidad de composición. Especifique las opciones siguientes con el paso CUOptions:
parentBLA (sólo lectura)
Especifica la aplicación de nivel de negocio para la nueva unidad de composición.
backingID (sólo lectura)
Especifica el ID de origen de la unidad de composición.
nombre
Especifica el nombre de la unidad de composición.
descripción
Especifica una descripción de la unidad de composición.
startingWeight
Especifica el peso inicial de la unidad de composición. Los valores admitidos son del 1 al 2147483647, el valor Integer máximo.
startedOnDistributed
Especifica si debe iniciarse la unidad de composición después de distribuir los cambios a los nodos de destino. El valor predeterminado es false.
restartBehaviorOnUpdate
Especifica los nodos que deben reiniciarse después de editar la unidad de composición. Especifique ALL para reiniciar todos los nodos de destino. Especifique DEFAULT para reiniciar los nodos controlados por los plug-ins de sincronización. Especifique NONE para evitar que el sistema reinicie los nodos.
Por ejemplo, especifique la sintaxis de este paso como -CUOptions [[.* .* cu4 "cu4 desc" 0 false DEFAULT]]
-MapTargets
Especifica propiedades adicionales para la correlación de destino de la unidad de composición. Especifique las opciones siguientes con el paso MapTargets:
deplUnit (sólo lectura)
Especifica el URI (Uniform Resource Identifier) de la unidad desplegable.
Para un activo EBA (Enterprise Bundle Archive), este URI es ebaDeploymentUnit.
servidor
Especifica el destino o los destinos para desplegar las unidades de composición. El valor predeterminado es el servidor server1. Utilice el carácter de signo más (+) para especificar varios destinos. Utilice el carácter de signo más (+) como prefijo para añadir un destino adicional. Especifique el formato del nombre del objeto completo para cada servidor que no sea un servidor de WebSphere Application Server.
Por ejemplo, especifique la sintaxis de este paso como -MapTargets [[a1.jar cluster1+cluster2] [a2.jar +server2]]
-ActivationPlanOptions
Especifica propiedades adicionales para el plan de activación de unidades de composición. Especifique las opciones siguientes con el paso ActivationPlanOptions:
deplUnit (sólo lectura)
Especifica el URI (Uniform Resource Identifier) de la unidad desplegable.
activationPlan
Especifica una lista de componentes de tiempo de ejecución como plan de activación. Especifique cada plan de activación en el formato specName=xxx,specVersion=yyy, donde specName representa el nombre de la especificación y es obligatorio. Utilice el carácter de signo más (+) para especificar varios planes de activación.
Por ejemplo, especifique la sintaxis de este paso como -ActivationPlanOptions [[a1.jar specname=actplan0+specname=actplan1] [a2.jar specname=actplan1+specname=actplan2]]
Para un activo EBA, utilice los valores predeterminados siguientes: -ActivationPlanOptions [[default ""]]
-CreateAuxCUOptions
Especifica propiedades adicionales para una unidad de composición auxiliar. Utilice este paso si el origen de la unidad de composición es un activo que corresponde a un activo que no tiene la unidad de composición correspondiente en la aplicación de nivel de negocio. Especifique las opciones siguientes con el paso CreateAuxCUOptions:
deplUnit (sólo lectura)
Especifica el URI (Uniform Resource Identifier) de la unidad desplegable.
inputAsset (sólo lectura)
Especifica el ID de origen de la unidad de composición.
cuID
Especifica el ID de la unidad de composición que el sistema crea para el activo. No especifique este argumento si no desea crear ninguna unidad de composición nueva.
matchTarget
Especifica si debe establecerse una coincidencia entre los destinos de la unidad de composición auxiliar y los destinos de la unidad de composición nueva. El valor predeterminado es true.
El producto no guarda el valor especificado para matchTarget. Por consiguiente, si selecciona que no coincida con el destino (false) ahora y más tarde edita la unidad de composición, cuando la edite, debe volver a inhabilitar este valor para que el producto no coincida con los destinos.
Por ejemplo, especifique la sintaxis de este paso como –CreateAuxCUOptions [[a1.jar a.jar auxCU true] [a2.jar a.jar defaultCU false]]
-RelationshipOptions
Especifica propiedades adicionales para las relaciones entre activos, unidades de composición y aplicaciones de nivel de negocio. Utilice este paso si el ID de origen de la unidad de composición es un activo que tenga una unidad de composición coincidente en la aplicación de nivel de negocio. Especifique las opciones siguientes con el paso RelationshipOptions:
deplUnit (sólo lectura)
Especifica el URI (Uniform Resource Identifier) de la unidad desplegable.
relationship
Define las relaciones de las unidades de composición. Especifique el nombre de objeto de la unidad de composición en este formato: cuName=xxx. Utilice el carácter de signo más (+) si desea especificar varios nombres de objetos de unidades de composición. Si la unidad de composición especificada en la relación no existe en la misma aplicación de nivel empresarial, el sistema devuelve un error.
matchTarget
Especifica si debe establecerse una coincidencia entre los destinos de la relación de la unidad de composición y los destinos de la nueva unidad de composición. El valor predeterminado es true.
El producto no guarda el valor especificado para matchTarget. Por consiguiente, si selecciona que no coincida con el destino (false) ahora y más tarde edita la unidad de composición, cuando la edite, debe volver a inhabilitar este valor para que el producto no coincida con los destinos.
Por ejemplo, especifique la sintaxis de este paso como –RelationshipOptions [[a1.jar a.jar auxCU true] [a2.jar a.jar defaultCU false]]
-ContextRootStep
Para un activo EBA, las raíces de contexto determinan dónde se encuentran las páginas web de un WAB (Web Application Bundle) concreto en tiempo de ejecución.
La raíz de contexto que especifique aquí combinada con la correlación de servidor definida para crear el URL completo que especifica para acceder a las páginas del WAB. Por ejemplo, si el host predeterminado del servidor de aplicaciones es www.example.com:8080 y la raíz de contexto del WAB es /sample, las páginas web estarán disponibles en www.example.com:8080/sample.
Debe listar las raíces de contexto para todos los módulos WAB que están incluidos en la aplicación OSGi.
Especifique la sintaxis de este paso del modo siguiente:
  -ContextRootStep [
    [nombre_simbólico_paquete_1 versión_paquete_1
raíz_contexto_1]
    [nombre_simbólico_paquete_2 versión_paquete_2
raíz_contexto_2]
Por ejemplo, para un archivo EBA que contiene dos WAB (com.ibm.ws.eba.helloWorldService.web en la versión 1.0.0, que se ha de correlacionar con /hello/web y com.ibm.ws.eba.helloWorldService.withContextRoot en la versión 0.9.0, que se ha de correlacionar con /hello/service), el mandato será similar al siguiente:
  -ContextRootStep [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 "/hello/web"]
    [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "/hello/service"]]
-VirtualHostMappingStep
Para un activo EBA, utilice un host virtual para asociar un puerto exclusivo con un módulo o aplicación. Los alias de un host virtual identifican los números de puerto definidos para ese host virtual. Se utiliza un número de puerto especificado en un alias de host virtual en el URL utilizado para acceder a artefactos como servlets y archivos JSP (JavaServer Page) en un módulo web. Por ejemplo, el alias myhost:8080 es la parte nombre_host:número_puerto del URL http://myhost:8080/sample.
Cada WAB contenido en un activo desplegado debe correlacionarse con un host virtual. Los módulos WAB se pueden instalar en el mismo host virtual o dispersarse entre varios hosts virtuales.
Si especifica un host virtual existente en el archivo ibm-web-bnd o .xmi para un WAB dado, el host virtual especificado se establece de forma predeterminada. De lo contrario, el valor de host virtual predeterminado es default_host, que proporciona varios números de puerto a través de sus alias:
80
Puerto interno no seguro que se utiliza cuando no se especifica ningún número de puerto.
9080
Puerto interno.
9443
Puerto externo seguro.
A menos que desee aislar el módulo WAB de otros módulos o recursos del mismo nodo (máquina física), default_host es un host virtual adecuado. Además de default_host, WebSphere Application Server proporciona admin_host, que es el host virtual de la aplicación del sistema de la consola administrativa. admin_host está en el puerto 9060. Su puerto seguro es 9043. No seleccione admin_host a menos que el módulo WAB esté relacionado con la administración del sistema.
Especifique la sintaxis de este paso del modo siguiente:
-VirtualHostMappingStep [
    [nombre_simbólico_paquete_1 versión_paquete_1
    nombre_módulo_web_1 host_virtual_1]
    [nombre_simbólico_paquete_2 versión_paquete_2
     nombre_módulo_web_2 host_virtual_2]]
Por ejemplo, para un archivo EBA que contiene dos WAB (com.ibm.ws.eba.helloWorldService.web en la versión 1.0.0, que se ha de correlacionar con default_host y com.ibm.ws.eba.helloWorldService.withContextRoot en la versión 0.9.0, que se ha de correlacionar con test_host), el mandato será similar al siguiente:
-VirtualHostMappingStep [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 "HelloWorld service" default_host]
    [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "HelloWorld second service" test_host]]
-MapRolesToUsersStep
Para un activo EBA, utilice este paso para correlacionar roles de seguridad con usuarios o grupos.
Especifique la sintaxis de este paso del modo siguiente:
-MapRolesToUsersStep [
    [role_name everyone?
    all_authenticated_in_realm?
    usernames
groups]]
Clave:
  • role_name es un nombre de rol definido en la aplicación.
  • everyone? se establece en o No, para especificar si todos están o no en el rol.
  • all_authenticated_in_realm? se establece en o No, para especificar si todos los usuarios autenticados pueden acceder al dominio de aplicación.
  • nombres_usuario es una lista de nombres de usuario de WebSphere Application Server, separados por el carácter "|".
  • grupos es una lista de grupos de WebSphere Application Server, separados por el carácter "|".
Nota: Para nombres_usuario y grupos, la serie vacía "" significa "el uso del valor predeterminado o existente". El valor predeterminado normalmente es que no hay ningún usuario o grupo enlazado al rol. Sin embargo, cuando una aplicación contiene un archivo ibm-application-bnd.xmi, el valor predeterminado de usernames se obtiene de este archivo. Si está desplegando una aplicación que contiene un archivo ibm-application-bnd.xmi y desea eliminar los usuarios enlazados, especifique sólo el carácter "|" (que es el separador de varios nombres de usuario). Esto especifica explícitamente "ningún usuario" y, por lo tanto, garantiza que no hay ningún usuario enlazado al rol.
Por ejemplo:
-MapRolesToUsersStep [
    [ROLE1 No Yes "" ""]
    [ROLE2 No No WABTestUser1 ""]
    [ROLE3 No No "" WABTestGroup1]
    [ROLE4 Yes No "" ""]]
-BlueprintResourceRefBindingStep
Para un activo EBA, los componentes BluePrint pueden acceder a lasa referencias de recursos de WebSphere Application Server. Cada referencia se declara en un archivo XML Blueprint y se puede proteger mediante un alias de autenticación Java Platform, Enterprise Edition (Java EE) Connector Architecture (JCA). Cada paquete de una aplicación OSGi puede contener cualquier número de declaraciones de referencia de recurso en sus diferentes archivos XML Blueprint.
Cuando se hace referencia a recursos seguros, esas referencias de recursos se pueden enlazar sólo a un alias de autenticación JCA que existe en cada servidor o clúster en el que se despliega la aplicación OSGi. Una aplicación OSGi se puede desplegar en varios servidores y clústeres que están en el mismo dominio de seguridad. Por lo tanto, cada alias de autenticación JCA debe existir en cualquier el dominio de seguridad de los servidores de destino y los clústeres, o en el dominio de seguridad global.
Especifique la sintaxis de este paso del modo siguiente:
-BlueprintResourceRefBindingStep [
    [
    nombre_simbólico_paquete
    versión_paquete
    id_referencia_recurso_blueprint
    nombre_interfaz
    nombre_jndi
    tipo_autenticación
    valor_compartimiento
    nombre_alias_autenticación
    ]]
Nota: El valor de nombre_jndi debe coincidir con el nombre jndi que se declara en el atributo filter del elemento de referencia de recursos en el archivo XML de Blueprint.
Por ejemplo, para un archivo EBA que contiene un paquete com.ibm.ws.eba.helloWorldService.properties.bundle.jar de la Versión 1.0.0, que se va a enlazar con el alias de autenticación de alias1, el mandato es el siguiente:
-BlueprintResourceRefBindingStep[
    [com.ibm.ws.eba.helloWorldService.properties.bundle 1.0.0 resourceRef
    javax.sql.DataSource jdbc/Account Container Shareable alias1]]
-WebModuleMsgDestRefs
Para un activo EBA, enlazar una referencia de recurso correlaciona una dependencia de recurso de la aplicación web con un recurso real disponible en el entorno de ejecución del servidor. Como mínimo, esto se puede conseguir utilizando una correlación que especifica el nombre JNDI con el que se conoce el recurso en el entorno de ejecución. De forma predeterminada, el nombre JNDI es el ID de recurso que ha especificado en el archivo web.xml durante el desarrollo del paquete de aplicaciones web (WAB). Utilice esta opción para enlazar recursos de tipo message-destination-ref (referencia de destino de mensaje) o resource-env-ref (referencia de entorno de recursos), como se define en la especificación Java JSR-250: Common Annotations para la Plataforma Java.
Especifique la sintaxis de este paso del modo siguiente:
-WebModuleMsgDestRefs [
    [
    nombre_simbólico_paquete
    versión_paquete
    id_referencia_recurso
    tipo_recurso
    nombre_jndi_destino
	   ]]
Por ejemplo:
-WebModuleMsgDestRefs [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 
    jms/myQ javax.jms.Queue jms/workQ] 
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 
    jms/myT javax.jms.Topic jms/notificationTopic]]
-WebModuleResourceRefs
Para un activo EBA, enlazar una referencia de recurso correlaciona una dependencia de recurso de la aplicación web con un recurso real disponible en el entorno de ejecución del servidor. Como mínimo, esto se puede conseguir utilizando una correlación que especifica el nombre JNDI con el que se conoce el recurso en el entorno de ejecución. De forma predeterminada, el nombre JNDI es el ID de recurso que ha especificado en el archivo web.xml durante el desarrollo del paquete de aplicaciones web (WAB). Utilice esta opción para enlazar recursos de tipo resource-ref (referencia de recurso), como se define en la especificación Java JSR-250: Common Annotations para la Plataforma Java.
Especifique la sintaxis de este paso del modo siguiente:
-WebModuleResourceRefs [
    [
    nombre_simbólico_paquete
    versión_paquete
    id_referencia_recurso
    tipo_recurso
    nombre_jndi_destino
    configuración_inicio_sesión
    propiedades_inicio_sesión
    propiedades_ampliadas
	   ]]
Por ejemplo:
-WebModuleResourceRefs [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/jtaDs javax.sql.DataSource
    jdbc/helloDs "" "" ""]
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/nonJtaDs javax.sql.DataSource
    jdbc/helloDsNonJta "" "" "extprop1=extval1"]]
Nota: Si utiliza varias propiedades ampliadas, la sintaxis jython es "extprop1=extval1,extprop2=extval2".

Valor de retorno

El mandato devuelve los ID de configuración de la unidad de composición y la nueva unidad de composición creada para el activo en la relación de activos, como se muestra en el siguiente ejemplo:
WebSphere:cuname=cu4
WebSphere:cuname=cua
WebSphere:cuname=cud

Uso del ejemplo de modalidad de proceso por lotes

Utilice los siguientes ejemplos para añadir un activo que no sea empresarial:
  • Utilizando la serie Jython:
    AdminTask.addCompUnit('-blaID myBLA – cuSourceID assetname=asset1.zip -CUOptions 
      [[.* .* cu1 "cu1 desc1" 0 false DEFAULT]] -MapTargets [[.* server1]] –ActivationPlanOptions 
      [.* specname=actplan0+specname=actplan1]')
  • Utilizando la lista Jython:
    AdminTask.addCompUnit(['-blaID', 'myBLA', '–cuSourceID', 'assetname=asset1.zip', '-CUOptions', 
      '[[.* .* cu1 "cu1 desc1" 0 false DEFAULT]]', '-MapTargets', '[[.* server1]]', '–ActivationPlanOptions',
       '[.* specname=actplan0+specname=actplan1]'])
Utilice los siguientes ejemplos para añadir una unidad de composición de aplicaciones que no sea empresarial:
  • Utilizando la serie Jython:
    AdminTask.addCompUnit('-blaID myBLA -cuSourceID yourBLA
    -CUOptions [[.* .* cu3 "cu3 desc3" 0 false DEFAULT]]')
  • Utilizando la lista Jython:
    AdminTask.addCompUnit(['-blaID', 'myBLA', '-cuSourceID', 'yourBLA', '-CUOptions', 
      '[[.* .* cu3 "cu3 desc3" 0 false DEFAULT]]'])
Utilice el ejemplo siguiente para crear una unidad de composición EBA y añádalo a una aplicación de nivel empresarial.
AdminTask.addCompUnit('[
  -blaID WebSphere:blaname=helloWorldService
  -cuSourceID WebSphere:assetname=com.ibm.ws.eba.helloWorldService.eba
  -CUOptions [
    [WebSphere:blaname=helloWorldService.eba
    WebSphere:assetname=com.ibm.ws.eba.helloWorldService.eba
    com.ibm.ws.eba.helloWorldService_0001.eba "" 1 false DEFAULT]]
  -MapTargets [[ebaDeploymentUnit WebSphere:node=node01,server=server1]]
  -ActivationPlanOptions [[default ""]]
  -ContextRootStep [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 "/hello/web"]
    [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "/hello/service"]]
  -VirtualHostMappingStep [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 
    "HelloWorld service" default_host]
    [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0
    "HelloWorld second service" test_host]]
  -MapRolesToUsersStep [
    [ROLE1 No Yes "" ""]
    [ROLE2 No No WABTestUser1 ""]
    [ROLE3 No No "" WABTestGroup1]
    [ROLE4 Yes No "" ""]]
  -BlueprintResourceRefBindingStep[
    [com.ibm.ws.eba.helloWorldService.properties.bundle 1.0.0 resourceRef
    javax.sql.DataSource jdbc/Account Container Shareable alias1]]
  -WebModuleMsgDestRefs [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 
    jms/myQ javax.jms.Queue jms/workQ] 
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 
    jms/myT javax.jms.Topic jms/notificationTopic]]
  -WebModuleResourceRefs [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/jtaDs javax.sql.DataSource
    jdbc/helloDs "" "" ""]
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/nonJtaDs javax.sql.DataSource
    jdbc/helloDsNonJta "" "" "extprop1=extval1"]]
]')
Utilice los ejemplos siguientes para añadir una unidad de composición para un activo no empresarial y desplegar la unidad de composición en varios destinos:
  • Utilizando la serie Jython:
    AdminTask.addCompUnit('-blaID theirBLA – cuSourceID asset2.zip – CUOptions 
      [[.* .* cu2 "cu2 desc" 0 false DEFAULT]] -MapTargets [[.* server1+server2]]')
  • Utilizando la lista Jython:
    AdminTask.addCompUnit(['-blaID', 'theirBLA', '–cuSourceID', 'asset2.zip', '–CUOptions', 
      '[[.* .* cu2 "cu2 desc" 0 false DEFAULT]]', '-MapTargets', '[[.* server1+server2]]'])
Utilice los ejemplos siguientes para añadir una unidad de composición que sea un activo no empresarial con una unidad desplegable:
  • Utilizando la serie Jython:
    AdminTask.addCompUnit('-blaID yourBLA – cuSourceID asset2.zip – deplUnits a.jar – CUOptions 
      [[.* .* cu3 "cu3 desc" 0 false DEFAULT]] –MapTargets [[a.jar server1]] –ActivationPlanOptions 
      [[a.jar specname=actplan1]]')
  • Utilizando la lista Jython:
    AdminTask.addCompUnit(['-blaID', 'yourBLA', '–cuSourceID', 'asset2.zip', '–deplUnits', 'a.jar', '–CUOptions', 
      '[[.* .* cu3 "cu3 desc" 0 false DEFAULT]]', '–MapTargets', '[[a.jar server1]]', '–ActivationPlanOptions',
       '[[a.jar specname=actplan1]]'])
Utilice los ejemplos siguientes para añadir una unidad de composición para un activo no empresarial como biblioteca compartida:
  • Utilizando la serie Jython:
    AdminTask.addCompUnit('-blaID ourBLA – cuSourceID b.jar – deplUnits default – CUOptions 
      [[.* .* cub "cub desc" 0 false DEFAULT]] –MapTargets [[default server1]]')
  • Utilizando la lista Jython:
    AdminTask.addCompUnit(['-blaID', 'ourBLA', '–cuSourceID', 'b.jar', '–deplUnits', 'default', '–CUOptions', 
      '[[.* .* cub "cub desc" 0 false DEFAULT]]', '–MapTargets', '[[default server1]]'])
Utilice los siguientes ejemplos para añadir una unidad de composición para un activo no empresarial con una dependencia. Para este ejemplo, la unidad de composición cub existe como biblioteca compartida de la aplicación de nivel empresarial ourBLA:
  • Utilizando la serie Jython:
    AdminTask.addCompUnit('-blaID ourBLA – cuSourceID asset3.zip – deplUnits a1.jar – CUOptions 
      [[.* .* cu4 "cu4 desc" 0 false DEFAULT]] –MapTargets [[a1.jar cluster1+cluster2]] –CreateAuxCUOptions 
      [[a1.jar a.jar cua true]] –RelationshipOptions [[a1.jar cuname=cub true]]')
  • Utilizando la lista Jython:
    AdminTask.addCompUnit(['-blaID', 'ourBLA', '–cuSourceID', 'asset3.zip', '–deplUnits', 'a1.jar', '–CUOptions',
     '[[.* .* cu4 "cu4 desc" 0 false DEFAULT]]', '–MapTargets', '[[a1.jar cluster1+cluster2]]', '–CreateAuxCUOptions', 
      '[[a1.jar a.jar cua true]]', '–RelationshipOptions', '[[a1.jar cuname=cub true]]'])
Utilice los siguientes ejemplos para añadir un activo empresarial:
  • Utilizando la serie Jython:
    AdminTask.addCompUnit('[-blaID yourBLA – cuSourceID defaultapp.ear – defaultBindingOptions
      defaultbinding.ejbjndi.prefix=ejb# defaultbinding.virtual.host=default_host#
      defaultbinding.force=yes – AppDeploymentOptions [-appname defaultapp -installed.ear.destination
      application_root/myCell/defaultapp.ear] –MapModulesToServers 
      [[defaultapp.war .* WebSphere:cell=cellName,node=nodeName,server=server1]
      [Increment.jar .* Websphere:cell=cellName,node=nodeName,server=server2]] -CtxRootForWebMod
      [[defaultapp.war .* myctx/]]]')
  • Utilizando la lista Jython:
    AdminTask.addCompUnit(['-blaID', 'yourBLA', '–cuSourceID', 'defaultapp.ear', '–defaultBindingOptions',
       'defaultbinding.ejbjndi.prefix=ejb# defaultbinding.virtual.host=default_host# defaultbinding.force=yes', 
       '–AppDeploymentOptions', '[-appname defaultapp -installed.ear.destination application_root/myCell/defaultapp.ear]',
       '–MapModulesToServers', '[[defaultapp.war .* WebSphere:cell=cellName,node=nodeName,server=server1]
       [Increment.jar .* Websphere:cell=cellName,node=nodeName,server=server2]]', '-CtxRootForWebMod', 
       '[[defaultapp.war .* myctx/]]'])

Ejemplo de utilización de la modalidad interactiva

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

deleteCompUnit

El mandato deleteCompUnit elimina una unidad de composición. Los dos parámetros para este mandato aceptan ID de configuración incompletos, siempre y cuando el sistema pueda establecer una coincidencia entre la serie especificada y un ID exclusivo.

Objeto de destino

Ninguno

Parámetros necesarios

-blaID
Especifica el ID de configuración de la aplicación de nivel de negocio de interés. (String, obligatorio)
-cuID
Especifica el ID de configuración de la unidad de composición que debe suprimirse. (String, obligatorio)

Parámetros opcionales

-force
Especifica si debe forzarse al sistema para que suprima una unidad de composición, aun cuando otras unidades de composición dependan de ella. (Boolean, opcional)

Valor de retorno

El mandato devuelve el ID de configuración de la unidad de composición que ha suprimido el sistema, como se muestra en el siguiente ejemplo:
WebSphere:cuname=cu1

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.deleteCompUnit('-blaID myBLA – cuID cu1 -force true')
  • Utilizando la lista Jython:
    AdminTask.deleteCompUnit(['-blaID', 'myBLA', '–cuID', 'cu1', '-force', 'true'])

Ejemplo de utilización de la modalidad interactiva

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

editCompUnit

El mandato editCompUnit modifica opciones adicionales de la unidad de composición. Puede utilizar este mandato para modificar el peso inicial de la unidad de composición, los destinos de despliegue, las opciones del plan de activación y los valores de relación.

Objeto de destino

Ninguno

Parámetros necesarios

-blaID
Especifica el ID de configuración de la aplicación de nivel de negocio de interés. (String, obligatorio)
-cuID
Especifica el ID de configuración de la unidad de composición que debe editarse. (String, obligatorio)

Pasos opcionales

También puede especificar valores para los pasos opcionales para editar las propiedades de la unidad de composición. Estos pasos no se aplican a los activos empresariales. Para conocer los pasos opcionales, utilice los caracteres .* para especificar un argumento de sólo lectura en la sintaxis de mandato. Especifique una serie vacía con los caracteres "" para conservar el valor existente del argumento. Si no especifica un valor o una serie vacía para un argumento con permisos de escritura, el mandato restablece el argumento en un valor nulo.
-CUOptions
Especifica propiedades adicionales para la unidad de composición. Especifique las opciones siguientes con el paso CUOptions:
parentBLA (sólo lectura)
Especifica la aplicación de nivel de negocio para la unidad de composición.
backingID (sólo lectura)
Especifica el ID de origen de la unidad de composición.
name (sólo lectura)
Especifica el nombre de la unidad de composición.
descripción
Especifica una descripción de la unidad de composición.
startingWeight
Especifica el peso inicial de la unidad de composición. Los valores admitidos son del 1 al 2147483647, el valor Integer máximo.
startedOnDistributed
Especifica si debe iniciarse la unidad de composición después de distribuir los cambios a los nodos de destino. El valor predeterminado es false.
restartBehaviorOnUpdate
Especifica los nodos que deben reiniciarse después de editar la unidad de composición. Especifique ALL para reiniciar todos los nodos de destino. Especifique DEFAULT para reiniciar los nodos controlados por los plug-ins de sincronización. Especifique NONE para evitar que el sistema reinicie los nodos.
Por ejemplo, especifique la sintaxis para este paso de este modo: -CUOptions [[.* .* cu4 "descripción de cu4" 0 false DEFAULT]]
-MapTargets
Especifica propiedades adicionales para la correlación de destino de la unidad de composición. Especifique las opciones siguientes con el paso MapTargets:
deplUnit (sólo lectura)
Especifica el URI (Uniform Resource Identifier) de la unidad desplegable.
Para un activo EBA (Enterprise Bundle Archive), este URI es ebaDeploymentUnit.
servidor
Especifica el destino o los destinos para desplegar las unidades de composición. El valor predeterminado es el servidor server1. Utilice el carácter de signo más (+) para especificar varios destinos. Utilice el carácter de signo más (+) como prefijo para añadir un destino adicional. Especifique el formato del nombre del objeto completo para cada servidor que no sea un servidor de WebSphere Application Server.
Por ejemplo, especifique la sintaxis de este paso de este modo: -MapTargets [[a1.jar cluster1+cluster2] [a2.jar server1+server2]]
-ActivationPlanOptions
Especifica propiedades adicionales para el plan de activación de unidades de composición. Especifique las opciones siguientes con el paso ActivationPlanOptions:
deplUnit (sólo lectura)
Especifica el URI (Uniform Resource Identifier) de la unidad desplegable.
activationPlan
Especifica una lista de componentes de tiempo de ejecución como plan de activación. Especifique cada plan de activación en el formato specName=xxx,specVersion=yyy, donde specName representa el nombre de la especificación y es obligatorio. Utilice el carácter de signo más (+) para especificar varios planes de activación.
Por ejemplo, especifique la sintaxis de este paso de este modo: -ActivationPlanOptions [[a1.jar specname=actplan0+actplan1] [a2.jar specname=actplan1+specname=actplan2]]
Para un activo EBA, no modifique el plan de activación. Mantenga los valores predeterminados siguientes que se establecieron al añadir la unidad de composición: -ActivationPlanOptions [[default ""]]
-RelationshipOptions
Especifica propiedades adicionales para las relaciones entre activos, unidades de composición y aplicaciones de nivel de negocio. Utilice este paso si el ID de origen de la unidad de composición es un activo que tenga una unidad de composición coincidente en la aplicación de nivel de negocio. Especifique las opciones siguientes con el paso RelationshipOptions:
deplUnit (sólo lectura)
Especifica el URI (Uniform Resource Identifier) de la unidad desplegable.
relationship
Define las relaciones de las unidades de composición. Especifique el nombre de objeto de la unidad de composición en este formato: cuName=xxx. Utilice el carácter de signo más (+) si desea especificar varios nombres de objetos de unidades de composición. Si la unidad de composición especificada en la relación no existe en la misma aplicación de nivel empresarial, el sistema devuelve un error.
matchTarget
Especifica si debe establecerse una coincidencia entre los destinos de la relación de la unidad de composición y los destinos de la nueva unidad de composición. El valor predeterminado es true.
El producto no guarda el valor especificado para matchTarget. Por consiguiente, si selecciona que no coincida con el destino (false) ahora y más tarde edita la unidad de composición, cuando la edite, debe volver a inhabilitar este valor para que el producto no coincida con los destinos.
Por ejemplo, especifique la sintaxis de este paso como –RelationshipOptions [[a1.jar a.jar auxCU true] [a2.jar a.jar defaultCU false]]
-ContextRootStep
Para un activo EBA, las raíces de contexto determinan dónde se encuentran las páginas web de un WAB (Web Application Bundle) concreto en tiempo de ejecución.
La raíz de contexto que especifique aquí combinada con la correlación de servidor definida para crear el URL completo que especifica para acceder a las páginas del WAB. Por ejemplo, si el host predeterminado del servidor de aplicaciones es www.example.com:8080 y la raíz de contexto del WAB es /sample, las páginas web estarán disponibles en www.example.com:8080/sample.
Debe listar las raíces de contexto para todos los módulos WAB que están incluidos en la aplicación OSGi.
Especifique la sintaxis de este paso del modo siguiente:
  -ContextRootStep [
    [nombre_simbólico_paquete_1 versión_paquete_1
raíz_contexto_1]
    [nombre_simbólico_paquete_2 versión_paquete_2
raíz_contexto_2]
Por ejemplo, para un archivo EBA que contiene dos WAB (com.ibm.ws.eba.helloWorldService.web en la versión 1.0.0, que se ha de correlacionar con /hello/web y com.ibm.ws.eba.helloWorldService.withContextRoot en la versión 0.9.0, que se ha de correlacionar con /hello/service), el mandato será similar al siguiente:
  -ContextRootStep [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 "/hello/web"]
    [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "/hello/service"]]
-VirtualHostMappingStep
Para un activo EBA, utilice un host virtual para asociar un puerto exclusivo con un módulo o aplicación. Los alias de un host virtual identifican los números de puerto definidos para ese host virtual. Se utiliza un número de puerto especificado en un alias de host virtual en el URL utilizado para acceder a artefactos como servlets y archivos JSP (JavaServer Page) en un módulo web. Por ejemplo, el alias myhost:8080 es la parte nombre_host:número_puerto del URL http://myhost:8080/sample.
Cada WAB contenido en un activo desplegado debe correlacionarse con un host virtual. Los módulos WAB se pueden instalar en el mismo host virtual o dispersarse entre varios hosts virtuales.
Si especifica un host virtual existente en el archivo ibm-web-bnd o .xmi para un WAB dado, el host virtual especificado se establece de forma predeterminada. De lo contrario, el valor de host virtual predeterminado es default_host, que proporciona varios números de puerto a través de sus alias:
80
Puerto interno no seguro que se utiliza cuando no se especifica ningún número de puerto.
9080
Puerto interno.
9443
Puerto externo seguro.
A menos que desee aislar el módulo WAB de otros módulos o recursos del mismo nodo (máquina física), default_host es un host virtual adecuado. Además de default_host, WebSphere Application Server proporciona admin_host, que es el host virtual de la aplicación del sistema de la consola administrativa. admin_host está en el puerto 9060. Su puerto seguro es 9043. No seleccione admin_host a menos que el módulo WAB esté relacionado con la administración del sistema.
Especifique la sintaxis de este paso del modo siguiente:
-VirtualHostMappingStep [
    [nombre_simbólico_paquete_1 versión_paquete_1
    nombre_módulo_web_1 host_virtual_1]
    [nombre_simbólico_paquete_2 versión_paquete_2
     nombre_módulo_web_2 host_virtual_2]]
Por ejemplo, para un archivo EBA que contiene dos WAB (com.ibm.ws.eba.helloWorldService.web en la versión 1.0.0, que se ha de correlacionar con default_host y com.ibm.ws.eba.helloWorldService.withContextRoot en la versión 0.9.0, que se ha de correlacionar con test_host), el mandato será similar al siguiente:
-VirtualHostMappingStep [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 "HelloWorld service" default_host]
    [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "HelloWorld second service" test_host]]
-MapRolesToUsersStep
Para un activo EBA, utilice este paso para correlacionar roles de seguridad con usuarios o grupos.
Especifique la sintaxis de este paso del modo siguiente:
-MapRolesToUsersStep [
    [role_name everyone?
    all_authenticated_in_realm?
    usernames
groups]]
Clave:
  • role_name es un nombre de rol definido en la aplicación.
  • everyone? se establece en o No, para especificar si todos están o no en el rol.
  • all_authenticated_in_realm? se establece en o No, para especificar si todos los usuarios autenticados pueden acceder al dominio de aplicación.
  • nombres_usuario es una lista de nombres de usuario de WebSphere Application Server, separados por el carácter "|".
  • grupos es una lista de grupos de WebSphere Application Server, separados por el carácter "|".
Nota: Para nombres_usuario y grupos, la serie vacía "" significa "el uso del valor predeterminado o existente". El valor predeterminado normalmente es que no hay ningún usuario o grupo enlazado al rol. Sin embargo, cuando una aplicación contiene un archivo ibm-application-bnd.xmi, el valor predeterminado de usernames se obtiene de este archivo. Si está desplegando una aplicación que contiene un archivo ibm-application-bnd.xmi y desea eliminar los usuarios enlazados, especifique sólo el carácter "|" (que es el separador de varios nombres de usuario). Esto especifica explícitamente "ningún usuario" y, por lo tanto, garantiza que no hay ningún usuario enlazado al rol.
Por ejemplo:
-MapRolesToUsersStep [
    [ROLE1 No Yes "" ""]
    [ROLE2 No No WABTestUser1 ""]
    [ROLE3 No No "" WABTestGroup1]
    [ROLE4 Yes No "" ""]]
-BlueprintResourceRefPostDeployStep
Para un activo EBA, los componentes BluePrint pueden acceder a lasa referencias de recursos de WebSphere Application Server. Cada referencia se declara en un archivo XML Blueprint y se puede proteger mediante un alias de autenticación Java Platform, Enterprise Edition (Java EE) Connector Architecture (JCA). Cada paquete de una aplicación OSGi puede contener cualquier número de declaraciones de referencia de recurso en sus diferentes archivos XML Blueprint.
Cuando se hace referencia a recursos seguros, esas referencias de recursos se pueden enlazar sólo a un alias de autenticación JCA que existe en cada servidor o clúster en el que se despliega la aplicación OSGi. Una aplicación OSGi se puede desplegar en varios servidores y clústeres que están en el mismo dominio de seguridad. Por lo tanto, cada alias de autenticación JCA debe existir en cualquier el dominio de seguridad de los servidores de destino y los clústeres, o en el dominio de seguridad global.
Especifique la sintaxis de este paso del modo siguiente:
-BlueprintResourceRefPostDeployStep [
    [
    nombre_simbólico_paquete
    versión_paquete
    id_referencia_recurso_blueprint
    nombre_interfaz
    nombre_jndi
    tipo_autenticación
    valor_compartimiento
    nombre_alias_autenticación
    ]]
Nota: El valor de nombre_jndi debe coincidir con el nombre jndi que se declara en el atributo filter del elemento de referencia de recursos en el archivo XML de Blueprint.
Por ejemplo, para un archivo EBA que contiene un paquete com.ibm.ws.eba.helloWorldService.properties.bundle.jar de la Versión 1.0.0, que se va a enlazar con el alias de autenticación de alias1, el mandato es el siguiente:
-BlueprintResourceRefPostDeployStep[
    [com.ibm.ws.eba.helloWorldService.properties.bundle 1.0.0 resourceRef
    javax.sql.DataSource jdbc/Account Container Shareable alias1]]
-WebModuleResourceRefs
Para un activo EBA, al enlazar una referencia de recurso se correlaciona una dependencia de recurso del módulo web con un recurso real disponible en el entorno de ejecución del servidor. Como mínimo, esto se puede conseguir utilizando una correlación que especifica el nombre JNDI con el que se conoce el recurso en el entorno de ejecución. De forma predeterminada, el nombre JNDI es el ID de recurso que ha especificado en el archivo web.xml durante el desarrollo del paquete de aplicaciones web (WAB).
Especifique la sintaxis de este paso del modo siguiente:
-WebModuleResourceRefs [
    [
    nombre_simbólico_paquete
    versión_paquete
    id_referencia_recurso
    tipo_recurso
    nombre_jndi_destino
    configuración_inicio_sesión
    propiedades_inicio_sesión
    propiedades_ampliadas
	   ]]
Por ejemplo:
-WebModuleResourceRefs [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/jtaDs javax.sql.DataSource
    jdbc/helloDs "" "" ""]
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/nonJtaDs javax.sql.DataSource
    jdbc/helloDsNonJta "" "" "extprop1=extval1"]]
Nota: Si utiliza varias propiedades ampliadas, la sintaxis jython es "extprop1=extval1,extprop2=extval2".

Valor de retorno

El mandato devuelve el ID de configuración de la unidad de composición que el sistema edita.

Uso del ejemplo de modalidad de proceso por lotes

Utilice los ejemplos siguientes para editar una unidad de composición de un activo y sustituir el destino de los destinos existentes:
  • Utilizando la serie Jython:
    AdminTask.editCompUnit('-blaID myBLA – cuID cu1 – CUOptions [[.* .* cu1 cudesc 1 false DEFAULT]] -MapTargets 
      [[.* server2]] -ActivationPlanOptions [.* #specname=actplan0+specname=actplan2]')
  • Utilizando la lista Jython:
    AdminTask.editCompUnit(['-blaID', 'myBLA', '–cuID', 'cu1', '–CUOptions', 
      '[[.* .* cu1 cudesc 1 false DEFAULT]]', '-MapTargets', '
      [[.* server2]]', '-ActivationPlanOptions', '[.* #specname=actplan0+specname=actplan2]'])
Utilice los ejemplos siguientes para editar la unidad de composición de un activo y sus relaciones:
  • Utilizando la serie Jython:
    AdminTask.editCompUnit('-blaID ourBLA – cuID cu4 – CUOptions [[.* .* cu4 "new cu desc" 1 false DEFAULT]]
       –MapTargets [[a1.jar server1+server2]] –RelationshipOptions [[a1.jar cuname=cub true]]')
  • Utilizando la lista Jython:
    AdminTask.editCompUnit(['-blaID', 'ourBLA', '–cuID', 'cu4', '–CUOptions', '
      [[.* .* cu4 "new cu desc" 1 false DEFAULT]]', '–MapTargets', '[[a1.jar server1+server2]]', '–RelationshipOptions', 
      '[[a1.jar cuname=cub true]]'])
Utilice los siguientes ejemplos para editar una unidad de composición añadiendo una nueva relación a la relación existente:
  • Utilizando la serie Jython:
    AdminTask.editCompUnit('[-blaID ourBLA – cuID cu4 – CUOptions [[.* .* cu4 "new cu desc" 1 false DEFAULT]]
       –MapTargets [[a1.jar server1+server2]] –RelationshipOptions [[a1.jar +cuname=cuc true]] -ActivationPlanOptions 
      [a1.jar +specname=actplan2#specname=actplan1]]')
  • Utilizando la lista Jython:
    AdminTask.editCompUnit(['-blaID', 'ourBLA', '–cuID', 'cu4', '–CUOptions', '
      [[.* .* cu4 "new cu desc" 1 false DEFAULT]]', '–MapTargets', '[[a1.jar server1+server2]]', '–RelationshipOptions',
       '[[a1.jar +cuname=cuc true]]', '-ActivationPlanOptions', '[a1.jar +specname=actplan2#specname=actplan1]'])
Utilice los ejemplos siguientes para editar la configuración de una unidad de composición empresarial:
  • Utilizando la serie Jython:
    AdminTask.editCompUnit('-blaID yourBLA – cuID defaultapp – MapModulesToServers 
      [[defaultapp.war .* WebSphere:cluster=cluster1][Increment.jar .* Websphere:cluster=cluster2]]
       –CtxRootForWebMod [[defaultapp.war .* /]] –MapWebModToVH [[defaultapp.war .* vh1]]')
  • Utilizando la lista Jython:
    AdminTask.editCompUnit(['-blaID', 'yourBLA', '–cuID', 'defaultapp', '–MapModulesToServers', 
     '[[defaultapp.war .* WebSphere:cluster=cluster1][Increment.jar .* Websphere:cluster=cluster2]]', '–CtxRootForWebMod', 
     '[[defaultapp.war .* /]]', '–MapWebModToVH', '[[defaultapp.war .* vh1]]'])

Ejemplo de utilización de la modalidad interactiva

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

listCompUnits

El mandato listCompUnits muestra cada una de las unidades de composición asociada con una aplicación de nivel de negocio específica.

Objeto de destino

Ninguno

Parámetros necesarios

-blaID
Especifica el ID de configuración de la aplicación de nivel de negocio de interés. (String, obligatorio)

Parámetros opcionales

-includeDescription
Especifica si incluir una descripción de cada uno de los activos que devuelve el mandato. (String, opcional)
-includeType
Especifica si debe incluirse el tipo para cada activo que devuelve el mandato. (String, opcional)

Valor de retorno

El mandato devuelve una lista de los ID de configuración y el tipo para cada unidad de composición, como se muestra en el siguiente ejemplo:
Websphere:cuname=cu1
asset
"descripción de cu1"
Websphere:cuname=cu4
bla
"descripción de cu4"
WebSphere:cuname=defaultapp
Java EE
"descripción de defaultapp"

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.listCompUnits('-blaID blaname=theirBLA')
  • Utilizando la lista Jython:
    AdminTask.listCompUnits(['-blaID', 'blaname=theirBLA'])

Ejemplo de utilización de la modalidad interactiva

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

setCompUnitTargetAutoStart

El mandato setCompUnitTargetAutoStart habilita o inhabilita el inicio automático de las unidades de composición. Si habilita esta opción, el sistema inicia automáticamente la unidad de composición cuando se inicia el destino de la misma.

Objeto de destino

Ninguno

Parámetros necesarios

-blaID
Especifica el ID de configuración de la aplicación de nivel de negocio de interés. El mandato acepta un ID de configuración incompleto si el sistema establece una coincidencia del mismo con un ID exclusivo de aplicación de nivel de negocio. (String, obligatorio)
-cuID
Especifica la unidad de composición de interés. El mandato acepta un ID de configuración exclusivo si el sistema establece una coincidencia del mismo con un ID de unidad de composición exclusivo. (String, obligatorio)
-targetID
Especifica el nombre del destino de interés. Por ejemplo, especifique el nombre de servidor para establecer el destino en un servidor específico. (String, obligatorio)
-enable
Especifica si debe iniciarse automáticamente la unidad de composición de interés cuando se inicia el destino especificado. Especifique true para iniciar la unidad de composición automáticamente. Si no especifica true, el sistema no iniciará la unidad de composición cuando se inicie el destino. El valor predeterminado es true. (String, obligatorio)

Valor de retorno

El mandato no devuelve ninguna salida.

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.setCompUnitTargetAutoStart('-blaID bla1 – cuID cu1 – targetID server1 – enable true')
  • Utilizando la lista Jython:
    AdminTask.setCompUnitTargetAutoStart(['-blaID', 'bla1', '–cuID', 'cu1', '–targetID',
       'server1', '–enable', 'true'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando serie de Jython:
    AdminTask.setCompUnitTargetAutoStart('-interactive')

viewCompUnit

El mandato viewCompUnit muestra información sobre la configuración de una unidad de composición que pertenece a una aplicación de nivel de negocio específica.

Objeto de destino

Ninguno

Parámetros necesarios

-blaID
Especifica el ID de configuración de la aplicación de nivel de negocio de interés. Este parámetro acepta un ID de configuración incompleto si el sistema establece una coincidencia del mismo con un ID exclusivo de aplicación de nivel de negocio. (String, obligatorio)
-cuID
Especifica el ID de configuración de la unidad de composición. Este parámetro acepta un ID de configuración exclusivo si el sistema establece una coincidencia del mismo con un ID de unidad de composición exclusivo. (String, obligatorio)

Parámetros opcionales

Ninguno

Valor de retorno

El mandato devuelve información sobre la configuración de la unidad de composición de interés, como se muestra en el siguiente ejemplo:
Especificar las opciones de la unidad de composición (CUOptions)

Especifique el nombre y las opciones de descripción para la unidad de composición.

Parent BLA (parentBLA): [WebSphere:blaname=myBLA]
Backing Id (backingId): [WebSphere:assetname=asset1.zip]
Nombre (name): [cu1]
Descripción (description): [cuDesc]
Peso inicial (startingWeight): [0]
Iniciado al distribuido (startedOnDistributed): [false]
Comportamiento de reinicio en la actualización (restartBehaviorOnUpdate): [DEFAULT]

Especificar servidor (MapTargets)

Especifique los destinos, como servidores de aplicaciones o clústeres
de servidores de aplicaciones, en los que desea desplegar la unidad
de composición de la aplicación.

Unidad desplegable (deplUnit): [default]
*Servidores (server): [WebSphere:node=miNodo,server=servidor1]

Especificar las opciones del plan de activación de la unidad de composición (ActivationPlanOptions)

Especificar el nombre de optionsDeployableUnit del plan de activación de unidades de composición (deplUnit): [default]
Plan de activación (activationPlan): [WebSphere:specname=actplan0+WebSphere:specname=actplan1] 
Si la unidad de composición contiene un activo EBA (archivo de paquetes empresariales), también se visualiza el estado de la unidad de composición. Este estado es uno de los valores siguientes:
  • Utilización del despliegue más reciente de la aplicación OSGi.
  • El despliegue de la aplicación OSGi aún no está disponible porque requiere paquetes que continúan bajándose.
  • Nuevo despliegue de la aplicación OSGi disponible.
  • El nuevo despliegue de la aplicación OSGi no se puede aplicar porque las descargas de paquete han fallado.

Uso del ejemplo de modalidad de proceso por lotes

El ejemplo siguiente muestra la información de configuración de un activo no empresarial:
  • Utilizando la serie Jython:
    AdminTask.viewCompUnit('-blaID myBLA -cuID myCompUnit')
  • Utilizando la lista Jython:
    AdminTask.viewCompUnit(['-blaID', 'myBLA', '-cuID',
    'myCompUnit'])
En el ejemplo siguiente se muestra la información de configuración de un activo empresarial:
  • Utilizando la serie Jython:
    AdminTask.viewCompUnit('-blaID myBLA -cuID
    defaultApplication')
  • Utilizando la lista Jython:
    AdminTask.viewCompUnit(['-blaID', 'myBLA', '-cuID',
    'defaultApplication'])

Ejemplo de utilización de la modalidad interactiva

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

createEmptyBLA

Utilice mandato createEmptyBLA para crear una aplicación de nivel de negocio vacía. Una vez que haya creado la aplicación de nivel de negocio, puede añadirle activos u otras aplicaciones de nivel de negocio como unidades de composición.

Objeto de destino

Ninguno

Parámetros necesarios

-name
Especifica un nombre exclusivo para la aplicación de nivel de negocio. (String, obligatorio)

Parámetros opcionales

-description
Especifica una descripción para la aplicación de nivel de negocio. (String, opcional)

Valor de retorno

El mandato devuelve el ID de configuración de la nueva aplicación de nivel de negocio, como se muestra en el ejemplo siguiente:
WebSphere:blaname=myBLA

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.createEmptyBLA('-name myBLA -description "mi descripción de BLA"')
  • Utilizando la lista Jython:
    AdminTask.createEmptyBLA(['-name', 'myBLA', '-description', '"mi descripción de BLA"'])

Ejemplo de utilización de la modalidad interactiva

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

deleteBLA

El mandato deleteBLA elimina una aplicación de nivel de negocio de la configuración. Antes de suprimir una aplicación de nivel de negocio, utilice el mandato deleteCompUnit para eliminar todas las unidades de composición asociadas a la aplicación de nivel de negocio. Asimismo, verifique que ninguna otra aplicación de nivel de negocio hace referencia a la aplicación de nivel de negocio que se debe suprimir.

Objeto de destino

Ninguno

Parámetros necesarios

-blaID
Especifica el ID de configuración de la aplicación de nivel de negocio de interés. El mandato acepta un ID incompleto para el parámetro blaID, siempre y cuando el sistema pueda establecer una coincidencia entre la serie especificada y un identificador exclusivo. Por ejemplo, puede especificar el ID parcial myBLA para identificar el ID de configuración WebSphere:blaname=myBLA. (String, obligatorio)

Parámetros opcionales

Ninguno

Valor de retorno

El mandato devuelve el ID de configuración de la aplicación de nivel de negocio, como se muestra en el ejemplo siguiente:
WebSphere:blaname=myBLA

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.deleteBLA('-blaID myBLA')
  • Utilizando la lista Jython:
    AdminTask.deleteBLA(['-blaID', 'myBLA'])

Ejemplo de utilización de la modalidad interactiva

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

editBLA

El mandato editBLA modifica la descripción de una aplicación de nivel de negocio.

Objeto de destino

Ninguno

Parámetros necesarios

-blaID
Especifica el ID de configuración de la aplicación de nivel de negocio de interés. (String, obligatorio)

Pasos opcionales

Para conocer los pasos opcionales, utilice los caracteres .* para especificar un argumento de sólo lectura en la sintaxis de mandato. Especifique una serie vacía con los caracteres "" para conservar el valor existente del argumento. Si no especifica un valor o una serie vacía para un argumento con permisos de escritura, el mandato restablece el argumento en un valor nulo.
-BLAOptions
Utilice el paso BLAOptions para especificar una nueva descripción para la aplicación de nivel de negocio de interés.
name (sólo lectura)
Especifica el nombre de la aplicación de nivel de negocio.
descripción
Especifica una descripción de la aplicación de nivel de negocio.

Valor de retorno

El mandato no devuelve ninguna salida.

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.editBLA('-blaID DefaultApplication – BLAOptions [[.* "my new description"]]')
  • Utilizando la lista Jython:
    AdminTask.editBLA(['-blaID', 'DefaultApplication', '–BLAOptions', '[[.* "my new description"]]'])

Ejemplo de utilización de la modalidad interactiva

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

getBLAStatus

El mandato getBLAStatus indica si la aplicación de nivel de negocio o la unidad de composición está ejecutándose o detenida.

Objeto de destino

Ninguno

Parámetros necesarios

-blaID
Especifica el ID de configuración de la aplicación de nivel de negocio de interés. Utilice el mandato listBLAs para visualizar una lista de los ID de configuración e las aplicaciones de nivel de negocio. (String, obligatorio)

Parámetros opcionales

-cuID
Especifica el ID de configuración de la unidad de composición. Utilice el mandato listCompUnits para visualizar una lista de los ID de configuración de las unidades de composición. (String, opcional)

Valor de retorno

El mandato devuelve el estado de la aplicación de nivel de negocio o de la unidad de composición.

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.getBLAStatus('-blaID WebSphere:blaname=myBLA -cuID Websphere:cuname=cu1')
  • Utilizando la lista Jython:
    AdminTask.getBLAStatus(['-blaID', 'WebSphere:blaname=myBLA', '-cuID', 'Websphere:cuname=cu1'])

Ejemplo de utilización de la modalidad interactiva

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

listBLAs

El mandato listBLAs muestra las aplicaciones de nivel de negocio de la configuración.

Objeto de destino

Ninguno

Parámetros opcionales

-blaID
Especifica el ID de configuración de la aplicación de nivel de negocio de interés. (String, opcional)
-includeDescription
Especifica si se debe incluir una descripción de cada aplicación de nivel de negocio que devuelva el mandato. Especifique true para mostrar las descripciones de aplicaciones de nivel de negocio. (String, opcional)

Valor de retorno

El mandato devuelve una lista de los ID de configuración de cada una de las aplicaciones de nivel de negocio de la configuración, como se muestra en el ejemplo siguiente:
WebSphere:blaname=myBLA
WebSphere:blaname=yourBLA

Uso del ejemplo de modalidad de proceso por lotes

El ejemplo siguiente muestra cada una de las aplicaciones de nivel de negocio de la configuración:
  • En Jython:
    AdminTask.listBLAs()
Utilice los siguientes ejemplos para listar cada aplicación de nivel de negocio en la configuración:
  • Utilizando la serie Jython:
    AdminTask.listBLAs('-blaID myBLA')
  • Utilizando la lista Jython:
    AdminTask.listBLAs(['-blaID', 'myBLA'])
Utilice los siguientes ejemplos para listar cada aplicación de nivel de negocio y las descripciones correspondientes:
  • Utilizando la serie Jython:
    AdminTask.listBLAs('-includeDescription true')
  • Utilizando la lista Jython:
    AdminTask.listBLAs(['-includeDescription', 'true'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando serie de Jython:
    AdminTask.listBLAs('-interactive')

listControlOps

El mandato listControlOps muestra las operaciones de control para una aplicación de nivel de negocio y las unidades de composición correspondientes.

Objeto de destino

Ninguno

Parámetros necesarios

-blaID
Especifica el ID de configuración de la aplicación de nivel de negocio de interés. (String, obligatorio)

Parámetros opcionales

-cuID
Especifica la unidad de composición de interés. (String, opcional)
-opName
Especifica el nombre de la operación de interés. (String, opcional)
-long
Especifica si debe incluirse información adicional sobre la configuración en la salida del mandato. (String, opcional)

Valor de retorno

El mandato devuelve una lista de operaciones, descripciones de operaciones y descripciones de parámetros para el ámbito de consulta, como se muestra en el siguiente ejemplo:
"Operación: start"
   "Descripción: iniciar la operación"
   "ID de manejador de operaciones: com.mycompany.myasset.ControlOpHandler"
   "URI de datos de manejador de operaciones: ninguno"
"Operación: detener"
   "Descripción: detener la operación"
   "ID de manejador de operaciones: com.mycompany.myasset.ControlOpHandler"
   "URI de datos de manejador de operaciones: ninguno"
"Operación: clearCache"
   "Descripción: borra la memoria caché especificada o todas las memorias caché"
   "ID de manejador de operaciones: com.mycompany.myasset.ControlOpHandler"
   "URI de datos de manejador de operaciones: ninguno"
   "Parámetro: cacheName"
      "Descripción: nombre de la memoria caché que debe borrarse. Si no se especifica, se borran todas las memorias caché."

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.listControlOps('-blaID myBLA – cuID myservice.jar – long true')
  • Utilizando la lista Jython:
    AdminTask.listControlOps(['-blaID', 'myBLA', '–cuID', 'myservice.jar', '–long true'])

Ejemplo de utilización de la modalidad interactiva

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

startBLA

El mandato startBLA inicia la aplicación de nivel de negocio de interés.

Objeto de destino

Ninguno

Parámetros necesarios

-blaID
Especifica el ID de configuración de la aplicación de nivel de negocio que se ha de iniciar. El mandato acepta un ID de configuración incompleto si el sistema establece una coincidencia entre la serie especificada y un ID exclusivo de la configuración. (String, obligatorio)

Valor de retorno

El mandato devuelve un mensaje de estado si la aplicación de nivel de negocio se inicia. Si la aplicación de nivel de negocio no se inicia, el mandato no devuelve ninguna salida. El ejemplo siguiente muestra la salida del mensaje de estado:
ID
de BLA de la BLA iniciada si la BLA no se había iniciado todavía.  

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.startBLA('-blaID myBLA')
  • Utilizando la lista Jython:
    AdminTask.startBLA(['-blaID', 'myBLA'])

Ejemplo de utilización de la modalidad interactiva

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

stopBLA

El mandato stopBLA detiene la aplicación de nivel de negocio de interés.

Objeto de destino

Ninguno

Parámetros necesarios

-blaID
Especifica el ID de configuración de la aplicación de nivel de negocio que se ha de detener. El mandato acepta un ID de configuración incompleto si el sistema establece una coincidencia entre la serie especificada y un ID exclusivo de la configuración. (String, obligatorio)

Valor de retorno

El mandato devuelve un mensaje de estado si la aplicación de nivel de negocio se detiene. Si la aplicación de nivel de negocio no se detiene, el mandato no devuelve ninguna salida. El ejemplo siguiente muestra la salida del mensaje de estado:
ID de la BLA detenida si la BLA todavía no estaba detenida. 

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.stopBLA('-blaID myBLA')
  • Utilizando la lista Jython:
    AdminTask.stopBLA(['-blaID', 'myBLA'])

Ejemplo de utilización de la modalidad interactiva

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

viewBLA

El mandato viewBLA muestra el nombre y la descripción de la aplicación de nivel de negocio de interés.

Objeto de destino

Ninguno

Parámetros necesarios

-blaID
Especifica el ID de configuración de la aplicación de nivel de negocio de interés. El mandato acepta un ID de configuración incompleto si el sistema coincide con la serie de una única aplicación de nivel de negocio. (String, obligatorio)

Parámetros opcionales

Ninguno

Valor de retorno

El mandato devuelve información sobre la configuración de la aplicación de nivel de negocio de interés, como se muestra en el siguiente ejemplo:
Especificar opciones para la BLA (BLAOptions)

Especificar las opciones para la BLA

*Nombre de BLA (name): [DefaultApplication]
Descripción de BLA (description): []

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.viewBLA('-blaID DefaultApplication')
  • Utilizando la lista Jython:
    AdminTask.viewBLA(['-blaID', 'DefaultApplication'])

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.viewBLA('-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=rxml_7blamgmt
File name: rxml_7blamgmt.html