Commande wsdbgen

Cette commande permet d'utiliser la fonction pureQuery dans des applications JPA (Java™ Persistence API).

Cette commande a été renommée wsdbgen pour le module de fonctions Feature Pack for OSGi Applications and JPA 2.0 et les éditions ultérieures. Cette commande est utilisée de la même manière que la commande wsdb2gen. La commande, wsdb2gen, qui implique une utilisation uniquement sous DB2, fonctionne uniquement pour les bases de données DB2 dans WebSphere Application Server V7.0. Dans cette édition, la commande peut être utilisée pour les bases de données DB2, Informix et Oracle. Pour cette raison, un synonyme, la commande wsdbgen, est introduite.

Les commandes JPA (.bat sous Windows ou .sh sous UNIX) sont exécutées à partir du répertoire racine_profil/bin et non à partir du répertoire racine_serveur_app/bin. Ainsi, vous êtes sûr d'avoir la dernière version des commandes correspondant à votre édition.

Syntaxe

La syntaxe de la commande est la suivante :

[AIX][HP-UX][Linux][Solaris][z/OS]
wsdbgen.sh [paramètres]
[IBM i]
wsdbgen [paramètres]
[Windows]
wsdbgen.bat [paramètres]

Avant d'exécuter la commande, le fichier persistence.xml doit se trouver dans le répertoire META-INF qui doit lui-même se trouver dans le chemin d'accès aux classes.

Paramètres

  • -help : Ce paramètre affiche l'aide.
  • -pu : Nom de l'unité de persistance définie dans le fichier persistence.xml.
  • -collection : ID collection affecté aux noms des modules. La valeur par défaut est NULLID.
  • -url : URL de la base de données cible.

    L'URL est utilisée pour valider le langage SQL généré. Une URL doit être indiquée soit dans le fichier persistence.xml soit comme une option de commande. Si les deux sont indiqués, l'URL utilisée sera celle spécifiée dans l'option de commande.

  • -user : ID utilisateur.
  • -pw : Mot de passe de connexion à la base de données cible.

    Si ce paramètre n'est pas indiqué, la valeur utilisée est celle indiquée dans le fichier persistence.xml.

  • -package : si ce paramètre est indiqué, le paramètre -package prend le nom du module de valeur de chaîne et un module de base de données unique avec le nom spécifié est généré. Si le paramètre -package n'est pas indiqué, un module est alors généré pour chaque classe d'entité. Le nom d'entité est utilisé en tant que nom de package si l'option -package n'est pas spécifiée. La limite de longueur du nom est la limite du nom de la base de données moins 1, par exemple, 128 - 1 = 127.

Utilisation

Le fichier persistence.xml doit être inclus dans le fichier JAR (Java archive) et doit également être utilisé comme entrée dans la liaisonDB2 pour créer le package DB2. La commande nécessite une connexion à la base de données pour valider le code SQL généré. La base de données n'est pas nécessairement identique à celle de la phase d'exécution mais doit être de la même version et du même niveau d'édition.

Vérifiez que les fichiers JAR suivants sont dans le chemin de classes :
  • pdq.jar
  • pdqmgmt.jar
  • db2jcc.jar
  • db2jcc_licence_cu.jar
Si l'URL de la base de données indique une base de données z/OS, le fichier JAR suivant doit également être compris dans le chemin d'accès aux classes : db2jcc_licence_cisuz.jar
Avertissement : Des informations supplémentaires sur la conformité de niveau DB2 JAR pour IBM® Optim PureQuery Runtime sont disponibles sur le site Web de support IBM : System requirements for IBM Optim PureQuery Runtime for Linux, UNIX, and Windows.
Avertissement : Vous pouvez consulter des informations sur pureQuery StaticBinder dans le centre de documentation Data Studio en lisant la rubrique "The pureQuery StaticBinder utility".

Exemples

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 

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rejb_wsdbgen
Nom du fichier : rejb_wsdbgen.html