Utilitaire DataVersion

Utilisez cet utilitaire pour vérifier si votre système est correctement configuré pour utiliser pureQuery.
Cette rubrique contient les sections suivantes :

Syntaxe de la commande

Lire le diagrammeSauter le diagramme
    (1)                                       
>>-------java com.ibm.pdq.tools.DataVersion--------------------->

>--+-----------------------------------------------------------------------------------------------------------------------+-->
   '- -configuration--+--------------------------------------------------------------------------------------------------+-'   
                      '- -url--URL_JDBC-- -userName--ID_utilisateur-- -password--mot_de_passe-- -driverName--pilote_JDBC-'     

>--+------------+--+------------+--+-----------+--+--------+---><
   '- -features-'  '- -validate-'  '- -version-'  '- -help-'   

Remarques:
  1. Vous pouvez spécifier les options dans n'importe quel ordre.

Pour comprendre les conventions utilisées dans le diagramme, voir Lecture des diagrammes de syntaxe.

Descriptions des options

-configuration
Affiche les informations suivantes pour le système sur lequel vous exécutez la commande :
  • La version de pureQuery Runtime installée
  • Le fournisseur, la version et le nom de la machine virtuelle Java installée
  • Le fournisseur, la version et le nom de Java Runtime Environment installé
  • Le chemin d'accès aux classes en cours
  • Le nom, l'architecture et la version du système d'exploitation installé
  • La version d'IBM® Data Server Driver for JDBC and SQLJ installée
  • Une liste des fonctions pureQuery sous licence activées
  • Une liste des valeurs de propriété pureQuery résolues basée sur le chemin d'accès aux classes et les options de la machine virtuelle Java actuels.
Si vous spécifiez les options suivantes, l'option -configuration affiche également les informations pour le système sur lequel est installée une base de données :
-url URL-JDBC
Indique l'adresse URL JDBC à utiliser pour établir une connexion avec la base de données.
-userName ID-utilisateur
Indique l'ID utilisateur permettant de procéder à une authentification avec la base de données. Si l'option -url est définie, -userName doit également être spécifié.
-password mot_de_passe
Indique le mot de passe permettant de procéder à une authentification avec la base de données.
-driverName pilote-JDBC
Indique le nom qualifié complet du pilote JDBC à utiliser pour établir une connexion avec la base de données. Par exemple, si vous utilisez IBM Data Server Driver for JDBC and SQLJ, le nom du pilote est com.ibm.db2.jcc.DB2Driver.
Si vous spécifiez ces options de connexion à une base de données, l'utilitaire DataVersion affiche les informations supplémentaires suivantes :
  • Version principale de la base de données
  • Version secondaire de la base de données
  • Nom de produit de la base de données
  • Version du produit de la base de données
  • Nom d'utilisateur tel que le connaît la base de données
Si vous utilisez IBM Data Server Driver for JDBC and SQLJ pour vous connecter à la base de données, l'utilitaire DataVersion affiche les informations supplémentaires suivantes :
  • ClientUser
  • ClientWorkstation
  • ClientApplicationInformation
  • ClientAccountinginformation
  • ClientProgramId
  • CurrentPackageSet
  • CurrentPackagePath
  • isDB2GatewayConnection
-fonctions
Affiche une liste des fonctions pureQuery sous licence activées.
-validate
Vérifie si une version prise en charge d'IBM Data Server Driver for JDBC and SQLJ figure CLASSPATH. Vérifie également si une version prise en charge d'une machine virtuelle Java figure dans CLASSPATH.
-version
Affiche la version et le niveau de génération de pureQuery Runtime.
-help
Affiche des informations sur l'utilisation.

Le format de la sortie de ces options peut faire l'objet de modifications.

Exécution de l'utilitaire DataVersion à partir d'une application

Vous pouvez extraire des informations de l'utilitaire DataVersion en appelant les méthodes suivantes à partir d'une application Java :

public static String com.ibm.pdq.tools.DataVersion.getVersion();
public static String com.ibm.pdq.tools.DataVersion.getConfiguration();
public static String com.ibm.pdq.tools.DataVersion.getConfiguration(String url, String user, String password, String driverName);
public static String com.ibm.pdq.tools.DataVersion.getConfiguration(java.sql.Connection connection);
public static String com.ibm.pdq.tools.DataVersion.getFeatures();
public static String com.ibm.pdq.tools.DataVersion.validate(); 

Ces méthodes renvoient la même sortie que les options de ligne de commande correspondante, mais dans un objet String renvoyé. String contient des caractères de retour à la ligne.

Voici un exemple d'appel de la méthode getVersion() :

String versionInfo = com.ibm.pdq.tools.DataVersion.getVersion();
System.out.println (versionInfo);

La sortie de ces méthodes peut faire l'objet de modifications.


Commentaires