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.
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')
- Utilizando JACL:
$AdminTask listSqljProfiles -interactive
- Utilizando Jython:
print AdminTask.listSqljProfiles('-interactive')
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.
- 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
- 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:
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.hasChanges()
.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')
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.
- 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
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 ]]')