Mandato wsdbgen

El mandato da soporte a la utilización de la característica pureQuery en aplicaciones JPA (Java™ Persistence API).

El nombre de este mandato se ha cambiado por wsdbgen para las aplicaciones de Feature Pack for OSGi y JPA 2.0 y releases posteriores. El mandato se utiliza del mismo modo que el mandato wsdb2gen. El mandato, wsdb2gen, que se aplica solamente a DB2, funciona solamente para la base de datos DB2 en WebSphere Application Server V7.0. En este release, el mandato se puede utilizar para bases de datos DB2, Informix y Oracle. Debido a ello, se ha introducido un sinónimo: el mandato wsdbgen.

Los mandatos JPA (.bat en Windows o .sh en UNIX) se ejecutan desde el directorio raíz_perfil/bin, en lugar de hacerlo desde el directorio raíz_servidor_aplicaciones/bin para asegurarse de que tiene la última versión de los mandatos para su release.

Sintaxis

La sintaxis del mandato es la siguiente:

[AIX][HP-UX][Linux][Solaris][z/OS]
wsdbgen.sh [parámetros] 
[IBM i]
wsdbgen [parámetros] 
[Windows]
wsdbgen.bat [parámetros] 

Antes de ejecutar el mandato, el archivo persistence.xml debe estar en el directorio META-INF y este debe estar en la vía de acceso de clases.

Parámetros

  • -help: este parámetro muestra la información de ayuda.
  • -pu: nombre de la unidad de persistencia definida en el archivo persistence.xml.
  • -collection: ID de colección que se asigna a los nombres de paquetes. El valor predeterminado es NULLID.
  • -url: URL de la base de datos de destino.

    Se utiliza para validar el SQL generado. Debe especificarse un URL en el archivo persistence.xml o como opción de mandato. Si se especifican ambos, se utilizará el URL especificado en la opción de mandato.

  • -user: ID de usuario.
  • -pw: la contraseña correspondiente para conectarse a la base de datos de destino.

    Si este parámetro no se especifica, se utiliza el valor encontrado en el archivo persistence.xml.

  • -package: si se especifica este parámetro, el parámetro -package toma el nombre del paquete con valor de serie y se genera un solo paquete de base de datos con el nombre especificado. Si no se especifica el parámetro -package, se genera un paquete para cada clase de entidad. El nombre de entidad se utiliza como nombre de paquete si no se especifica la opción -package. El límite de longitud del nombre es el límite de base de datos menos 1, por ejemplo: 128 - 1 = 127.

Uso

El archivo persistence.xml debe incluirse en la el archivo Java (JAR) de la aplicación y también se utiliza como entrada en el enlace DB2 para crear el paquete de DB2. El mandato requiere una conexión a una base de datos para validar el SQL generado. No es necesario que la base de datos sea la misma que la base de datos de tiempo de ejecución, pero debe ser de la misma versión y nivel de release.

Asegúrese de que los archivos JAR restantes se encuentren en la vía de acceso de clases:
  • pdq.jar
  • pdqmgmt.jar
  • db2jcc.jar
  • db2jcc_licence_cu.jar
Si el URL de la base de datos especifica una base de datos DB2 para z/OS, el siguiente archivo JAR también debe estar en la vía de acceso de clases: db2jcc_licence_cisuz.jar
Atención: Lea sobre el nivel de conformidad de JAR de DB2 para IBM® Optim PureQuery Runtime en el sitio web de soporte de IBM: Requisitos del sistema para IBM Optim PureQuery Runtime para Linux, UNIX y Windows.
Atención: Puede consultar la información acerca de pureQuery StaticBinder en el tema del centro de información de Data Studio, "El programa de utilidad pureQuery StaticBinder".

Ejemplos

DB2
[AIX][HP-UX][Linux][Solaris][z/OS]
wsdbgen.sh
-pu payroll -collection prod1 -url jdbc:db2://myhostname:50000/proddb  -user produser -pw secret 
[IBM i]
wsdbgen
-pu payroll -collection prod1 -url jdbc:db2://myhostname:50000/proddb  -user produser -pw secret 
[Windows]
wsdbgen.bat
-pu payroll -collection prod1 -url jdbc:db2:\\myhostname:50000\proddb  -user produser -pw secret 
Informix
[AIX][HP-UX][Linux][Solaris][z/OS]
wsdbgen.sh
-pu payroll -collection prod1 -url jdbc:ids://myhostname:9089/proddb  -user produser -pw secret 
[IBM i]
wsdbgen
-pu payroll -collection prod1 -url jdbc:ids://myhostname:9089/proddb  -user produser -pw secret 
[Windows]
wsdbgen.bat
-pu payroll -collection prod1 -url jdbc:ids:\\myhostname:9089\proddb  -user produser -pw secret 

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