Grupo de mandatos de gestión de aplicaciones para el objeto AdminTask

Puede utilizar los lenguajes de script Jython o Jacl para gestionar aplicaciones con la herramienta wsadmin. Utilice los mandatos y parámetros del grupo AppManagementCommands para visualizar y procesar perfiles SQL Java™ (SQLJ) o archivos de enlace del tiempo de ejecución de IBM Optim PureQuery.

El grupo de mandatos AppManagementCommands para el objeto AdminTask incluye los mandatos siguientes:

listSqljProfiles

El mandato listSqljProfiles analiza el archivo archivador empresarial (EAR) de la aplicación especificada y devuelve una lista de archivos SQLJ. Los perfiles SQLJ tiene una extensión de nombre de archivo .ser. Si hay archivos en el archivo EAR que no sean perfiles SQLJ pero hay una extensión de nombre de archivo .ser, dichos archivos también se pueden mostrar en la lista.

Parámetros y valores de retorno

-appName
Nombre de la aplicación instalada. La aplicación debe instalarse antes de ejecutar la personalización y el enlace en la misma. Este parámetro es obligatorio.

Ejemplos

Uso del ejemplo de modalidad de proceso por lote:

  • Utilizando JACL:
    $AdminTask listSqljProfiles {-appName application_name}
  • Utilizando Jython:
    print AdminTask.listSqljProfiles('-appName application_name')
Uso del ejemplo de modalidad interactiva:
  • Utilizando JACL:
    $AdminTask listSqljProfiles -interactive
  • Utilizando Jython:
    print AdminTask.listSqljProfiles('-interactive')
La salida se muestra con sintaxis específica del sistema operativo local. La lista de perfiles disponibles puede añadirse directamente al archivo de grupo .grp.

processSqljProfiles

El mandato processSqljProfiles crea una personalización DB2 de los perfiles SQLJ. Opcionalmente, el mandato llama por omisión al enlazador de perfiles SQLJ para enlazar los paquetes DB2.
Best practice Best practice: Si está procesando una aplicación empresarial de gran tamaño, o si procesa muchos perfiles SQLJ, es posible que el proceso sea más largo que el tiempo de espera definido por omisión para la herramienta wsadmin. El tiempo de espera de conexión por omisión para la herramienta wsadmin se establece en 3 minutos. Si alcanza el tiempo de espera predeterminado y pierde la conexión con el servidor, la consola de la herramienta wsadmin emite una sentencia de tiempo de espera. Puede consultar el registro de salida del sistema para ver cuáles son los resultados finales de la personalización y del proceso de enlace, y el tiempo para dicho proceso. No inicie el mandato processSqljProfiles de nuevo hasta que el mandato anterior haya finalizado; de lo contrario, los resultados pueden ser imprevisibles.
Para evitar esta desconexión, configure el tiempo de espera de la sesión con un valor más alto. Consulte el registro de salida del sistema para ver cuál es el tiempo de proceso total y utilice dicho valor como base para el nuevo valor de tiempo de espera. Para aplicar el valor de tiempo de espera predeterminado, cambie el archivo de propiedades wsadmin que corresponde al tipo de conexión que esté utilizando:
  • Para el tipo de conexión SOAP, cambie la entrada siguiente en el archivo soap.client.props:
    com.ibm.SOAP.requestTimeout=180
  • Para los tipos de conexión JSR160RMI y RMI, cambie la entrada siguiente en el archivo sas.client.props:
    com.ibm.CORBA.requestTimeout=180
  • Para el tipo de conexión IPC, cambie la entrada siguiente en el archivo ipc.client.props:
    com.ibm.IPC.requestTimeout=180
bprac
Hay dos formas de verificar si el enlace o la personalización ha tenido lugar:
  • Si ha realizado un proceso de personalización, puede ejecutar una consulta desde la línea de mandatos para ver los archivos EAR que han cambiado:
    wsadmin>print AdminConfig.hasChanges()
    La consulta devuelve 0 si no hay cambiso y 1 si se han producido cambios en el servidor. Para ver los archivos de configuración que tienen cambios sin guardar, ejecute lo siguiente:
    wsadmin>print AdminConfig.queryChanges()
    .
  • Visualice el registro de salida del sistema para determinar si el enlace o el proceso ha sido satisfactorio.

Objeto de destino

Perfiles SQLJ de la aplicación instalada. Estos perfiles son archivos .ser únicos o perfiles que se agrupan en un archivo de grupo .grp. Este objeto de destino es obligatorio.

Parámetros y valores de retorno

-appName
Nombre de la aplicación instalada. La aplicación debe instalarse antes de ejecutar la personalización y el enlace en la misma. Este parámetro es obligatorio.
-classpath
Vía de acceso que indica al servidor de aplicaciones dónde encontrar los archivos JAR de controlador SQLJ necesarios. Este parámetro es opcional.
-dburl
Ubicación del servidor DB2 en la red. Este parámetro es opcional.
-user
Nombre de usuario de la cuenta que realiza el acceso a la base de datos DB2. Este parámetro es opcional.
-password
Contraseña para la cuenta que accede a la base de datos DB2. Este parámetro es opcional.
-options
Las opciones adicionales que se utilizan con el mandato db2sqljcustomize pueden insertarse en el parámetro -options, exceptuando los parámetros indicados más arriba. Este parámetro es opcional. Para obtener más información sobre el mandato db2sqljcustomize, consulte el personalizador de perfiles SQLJ - db2sqljcustomize.
-profiles
Ubicación de los archivos .ser de perfiles SQLJ o del archivo .grp. Este parámetro es obligatorio.

Ejemplos

Uso del ejemplo de modalidad de proceso por lote:

  • Utilizando Jacl:

    $AdminTask processSqljProfiles {-appName FVT -classpath {C:/IBM/SQLLIB/java/db2jcc.jar } -url 
     jdbc:db2://server.domain.ibm.com:50000/JTEST1 -user dbuser1 -password ***** -options "-rootpkgname MYPKG" -profiles 
     {c:/temp/ApplicationSerNames.grp }} 

  • Utilizando Jython:

    AdminTask.processSqljProfiles('[-appName Application -classpath ["C:/IBM/SQLLIB/java/db2jcc.jar"] 
     -dbURL "jdbc:db2://server.domain.ibm.com:50000/JTEST1" -user dbuser1 -password ***** -options [-rootpkgname MYPKG] -profiles 
     ["c:/temp/ApplicationSerNames.grp"]]')

Uso del ejemplo de modalidad interactiva:

wsadmin>print AdminTask.processSqljProfiles('-interactive') Process serialized SQLJ
 . Procese los perfiles SQLJ serializados en una aplicación instalada.  Personalice los perfiles con la información de tiempo de ejecución y 
 enlace paquetes SQL estáticos en una base de datos.   Consulte la documentación de personalización y enlace de SQLJ de base de datos.    Realice sólo el proceso de enlace. 
 (bindOnly): false  *Nombre de
aplicación. (appName):
Application  Classpath para las herramientas SQLJ. (classpath): 
 C:/IBM/SQLLIB/java/db2jcc.jar  URL de conexión a la base de datos. (dbURL):  Nombre de usuario de conexión a la base de datos. (user):  Database connection 
 Contraseña (password): Opciones para las herramientas SQLJ. (options):
*Nombres de perfiles SQLJ. (profiles): c:/temp/ApplicationSerNames.grp   
 Procese perfiles SQLJ serializados.    F (Finalizar) C (Cancelar) Seleccionar
[F, C]: [F]  WASX7278I: Línea de mandatos generada: 
 AdminTask.processSqljProfiles('[-bindOnly false -appName Application -classpath [C:/IBM/SQLLIB/java/db2jcc.jar] -profiles 
 [c:/temp/ApplicationSerNames.grp ]]') 

listPureQueryBindFiles

El mandato listPureQueryBindFiles analiza el archivo EAR de la aplicación especificada y devuelve una lista con los archivos .bindprops y .pdqxml que se encuentren. Los archivos de las opciones de enlace PureQuery tienen una extensión de nombre de archivo .bindprops. Los archivos de enlace tienen una extensión de nombre de archivo .pdqxml. Si el archivo EAR contiene archivos que no son archivos de enlace pureQuery, pero tiene una extensión de nombre de archivo .bindprops o .pdqxml, dichos archivos también aparecen en la lista.

Parámetros y valores de retorno

-appName
Nombre de la aplicación instalada. Este parámetro es obligatorio.

Ejemplos

Uso del ejemplo de modalidad de proceso por lote:

  • Utilizando JACL:

    $AdminTask listPureQueryBindFiles {-appName nombre_aplicación}
  • Utilizando Jython:

    print AdminTask.listPureQueryBindFiles('-appName nombre_aplicación')
Uso del ejemplo de modalidad interactiva:
  • Utilizando JACL:

    $AdminTask listPureQueryBindFiles -interactive
  • Utilizando Jython:

    print AdminTask.listPureQueryBindFiles('-interactive')

La salida se muestra con sintaxis específica del sistema operativo local.

processPureQueryBindFiles

El mandato processPureQueryBindFiles invoca el programa de utilidad del enlace DB2 pureQuery en una lista de archivos de enlace pureQuery.
Best practice Best practice: Si está procesando una aplicación empresarial de gran tamaño, o si procesa muchos archivos de enlace pureQuery mediante wsadmin, es posible que el proceso sea más largo que el tiempo de espera definido por omisión para la herramienta wsadmin. El tiempo de espera de conexión por omisión para la herramienta wsadmin se establece en 3 minutos. Si se alcanza el tiempo de espera predeterminado y el proceso que se ejecuta en el servidor todavía no ha finalizado, la consola wsadmin emite una sentencia de tiempo de espera. Puede consultar el registro de salida del sistema del servidor para ver los resultados finales del proceso de enlace y la hora de finalización del proceso. No inicie el mandato processPureQueryBindFiles de nuevo hasta que el mandato anterior haya finalizado; de lo contrario, los resultados pueden ser imprevisibles.
Para evitar este tiempo de espera, configure el tiempo de espera de solicitud de wsadmin en un período de tiempo más largo. Una vez que haya realizado correctamente el proceso de personalización y enlace, utilice el registro de salida del sistema para estimar el tiempo de proceso total. Utilice este período de tiempo como base para el nuevo valor de tiempo de espera. Para aplicar el valor de tiempo de espera predeterminado, cambie el archivo de propiedades wsadmin que corresponde al tipo de conexión que esté utilizando:
  • Para el tipo de conexión SOAP, cambie la entrada siguiente en el archivo soap.client.props:
    com.ibm.SOAP.requestTimeout=180
  • Para los tipos de conexión JSR160RMI y RMI, cambie la entrada siguiente en el archivo sas.client.props:
    com.ibm.CORBA.requestTimeout=180
  • Para el tipo de conexión IPC, cambie la entrada siguiente en el archivo ipc.client.props:
    com.ibm.IPC.requestTimeout=180
bprac

Para verificar si el enlace ha tenido lugar, visualice el registro de salida del sistema para determinar si el proceso de enlace ha sido satisfactorio.

Parámetros y valores de retorno

-appName
Nombre de la aplicación instalada que contiene los archivos de enlace pureQuery que deben procesarse. La aplicación debe instalarse antes de ejecutar el enlace en la misma.
-classpath
La lista de las vías de acceso a los archivos Java (Java archive) que contienen el programa de utilidad de enlace del tiempo de ejecución de IBM Optim PureQuery y sus dependencias: pdq.jar, pdqmgmt.jar, db2jcc4.jar o db2jcc.jar, db2jcc_license_cisuz.jar o db2jcc_license_cu.jar. Utilice / o \\\\ como separador de archivos. Utilice un espacio en blanco para separar las vías de acceso para los archivos JAR.
-dburl
URL para conectarse a la base de datos. El formato es jdbc:db2://nombre_servidor:puerto/nombre_base_datos.
-user
Nombre de usuario de la cuenta que realiza el acceso a la base de datos DB2.
-password
Contraseña para la cuenta que accede a la base de datos DB2.
-options
Cualquier opción adicional necesaria para el programa de utilidad de enlace del tiempo de ejecución de IBM Optim PureQuery. Proporcione las opciones de enlace como -bindoptions "bind_options_string". Para obtener información adicional sobre el programa de utilidad de enlace del tiempo de ejecución de IBM Optim PureQuery, consulte el tema dedicado a este programa de utilidad.
-files
Lista de nombres de los archivos de enlace pureQuery que deben procesarse. Los nombres de vía de acceso de los archivos de enlace deben ser relativos al archivo EAR de aplicación que los contiene. Utilice / o \\\\ como separador de archivos. Si especifica varias vías de acceso de perfil, utilice un espacio en blanco para separarlos.

Ejemplos

Uso del ejemplo de modalidad de proceso por lote:

  • Utilizando Jacl:

    $AdminTask processPureQueryBindFiles {-appName MyApp -classpath {/pdq_home/pdq.jar 
     /pdq_home/pdqmgmt.jar /db2_home/SQLLIB/java/db2jcc4.jar /db2_home/SQLLIB/java/db2jcc_license_cu.jar } -url 
     jdbc:db2://hostname:50000/databasename -user dbuser1 -password dbpswrd1 -options {-bindoptions "BLOCKING NO"} -files 
     {META-INF/xyz.bindprops META-INF/abc.bindprops }}
  • Utilizando Jython:

    print AdminTask.processPureQueryBindFiles('[-appName MyApp -classpath [/pdq_home/pdq.jar 
     /pdq_home/pdqmgmt.jar /db2_home/SQLLIB/java/db2jcc4.jar /db2_home/SQLLIB/java/db2jcc_license_cu.jar ] -url 
     jdbc:db2://hostname:50000/databasename -user dbuser1 -password dbpswrd1 -options [-bindoptions "BLOCKING NO"] -files 
     [META-INF/xyz.bindprops META-INF/abc.bindprops ]]')

Uso del ejemplo de modalidad interactiva:

print AdminTask.processPureQueryBindFiles('-interactive') Process pureQuery bind files.
 Procese los archivos de enlace pureQuery en una aplicación instalada.  Enlace los paquetes SQL estáticos en una base de datos.  Consulte pureQuery
 Enlazar documentación del programa de utilidad. *Nombre de aplicación. (appName):
MyApp Classpath para el programa de utilidad de enlace pureQuery. (classpath): 
 /pdq_home/pdq.jar /pdq_home/pdqmgmt.jar /db2_home/SQLLIB/java/db2jcc4.jar
/db2_home/SQLLIB/java/db2jcc_license_cu.jar *URL de conexión de base de datos. (url): jdbc:db2://hostname:50000/databasename Nombre de usuario de conexión de base de datos. (user): dbuser1 Database connection 
 Contraseña (password):
dbpswrd1 Opciones para el programa de utilidad de enlace pureQuery. (options):
-bindoptions "BLOCKING NO" *Nombres de archivo de enlace pureQuery. (files):
META-INF/xyz.bindprops META-INF/abc.bindprops  Procese archivos de enlace
pureQuery.  F (Finalizar) C (Cancelar)  Seleccionar [F, 
 C]: [F] WASX7278I: Línea de mandatos generada:
AdminTask.processPureQueryBindFiles('[-appName MyApp -classpath [/pdq_home/pdq.jar 
 /pdq_home/pdqmgmt.jar /db2_home/SQLLIB/java/db2jcc4.jar /db2_home/SQLLIB/java/db2jcc_license_cu.jar ] -url 
 jdbc:db2://hostname:50000/databasename -user dbuser1 -password ***** -options [-bindoptions "BLOCKING NO"] -files 
 [META-INF/xyz.bindprops META-INF/abc.bindprops ]]')

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_atappmancommandsgroup
File name: rxml_atappmancommandsgroup.html