Groupe de commandes de gestion d'applications pour l'objet AdminTask

Vous pouvez utiliser les langages de script Jython ou Jacl pour gérer les applications à l'aide de l'outil wsadmin. Utilisez les commandes et paramètres du groupe AppManagementCommands pour afficher et traiter des profils SQL Java™ (SQLJ) ou des fichiers de liaison IBM Optim PureQuery Runtime.

Le groupe de commandes AppManagementCommands pour l'objet AdminTask inclut les commandes suivantes :

listSqljProfiles

La commande listSqljProfiles interprète le fichier EAR de l'application indiquée et renvoie une liste de fichiers SQLJ. Les profils SQLJ ont une extension de nom de fichier .ser. Si le fichier EAR contient des fichiers qui ne sont pas des profils SQLJ, mais sont malgré tout dotés d'une extension de nom de fichier .ser, ces fichiers seront probablement dans la liste aussi.

Paramètres et valeurs renvoyées

-appName
Nom de l'application installée. Votre application doit être installée avant l'exécution de la personnalisation et de la liaison. Ce paramètre est obligatoire.

Exemples

Syntaxe d'un exemple de mode différé :

  • A l'aide de JACL :
    $AdminTask listSqljProfiles {-appName application_name}
  • Avec Jython :
    print AdminTask.listSqljProfiles('-appName application_name')
Exemple d'utilisation en mode interactif :
  • A l'aide de JACL :
    $AdminTask listSqljProfiles -interactive
  • Avec Jython :
    print AdminTask.listSqljProfiles('-interactive')
La sortie est produite avec une syntaxe propre au système d'exploitation local. La liste des profils disponibles peut être ajoutée directement à un fichier de groupe .grp.

processSqljProfiles

La commande processSqljProfiles crée une personnalisation DB2 des profils SQLJ. Par défaut, la commande peut éventuellement appeler le programme de liaison de profil SQLJ afin de lier les modules DB2.
Pratiques recommandées Pratiques recommandées: Si vous traitez une application d'entreprise de grande taille ou de nombreux profils SQL pour Java, le processus peut prendre plus longtemps que le délai d'attente par défaut de l'outil wsadmin. Le délai d'attente de connexion par défaut pour l'outil wsadmin est réglé à 3 minutes. Si le délai d'attente par défaut est atteint et que vous perdez la connexion au serveur, la console wsadmin émet une instruction d'expiration. Vous pouvez vérifier le journal de sortie système pour prendre connaissance des résultats finals du processus de personnalisation et de liaison, et pour connaître la durée que le processus y a consacré. N'exécutez pas la commande processSqljProfiles à nouveau avant que la commande précédente soit terminée : vous risqueriez d'obtenir un résultat inattendu.
Pour empêcher cette déconnexion, prolongez le délai d'attente de la session. Consultez le journal de sortie du système pour connaître la durée de traitement totale, et utilisez cette durée comme base pour le nouveau délai d'attente. Pour prolonger la valeur du délai d'attente par défaut, modifiez le fichier de propriétés wsadmin correspondant au type de connexion que vous utilisez :
  • Pour le type de connexion SOAP, modifiez l'entrée suivante dans le fichier soap.client.props :
    com.ibm.SOAP.requestTimeout=180
  • Pour les types de connexion JSR160RMI et RMI, modifiez l'entrée suivante dans le fichier sas.client.props :
    com.ibm.CORBA.requestTimeout=180
  • Pour le type de connexion IPC, modifiez l'entrée suivante dans le fichier ipc.client.props :
    com.ibm.IPC.requestTimeout=180
bprac
Vous pouvez vérifier de deux manières si la liaison ou la personnalisation a eu lieu :
  • Si vous avez effectué un processus de personnalisation, vous pouvez exécuter une requête en ligne de commande pour afficher les fichiers EAR de l'application ayant été modifiés :
    wsadmin>print AdminConfig.hasChanges()
    La requête renvoie 0 s'il n'y a aucune modification et 1 si des modifications sont survenues sur le serveur. Pour afficher les fichiers de configuration contenant des modifications non enregistrées, exécutez :
    wsadmin>print AdminConfig.queryChanges()
    .
  • Consultez le journal System Out pour déterminer si les opérations de liaison ou de traitement ont réussi.

Objet cible

Profils SQLJ de l'application installée. Ces profils sont des fichiers .ser uniques ou en série, ou des profils regroupés dans un fichier de groupe .grp. Cet objet cible est obligatoire.

Paramètres et valeurs renvoyées

-appName
Nom de l'application installée. Votre application doit être installée avant l'exécution de la personnalisation et de la liaison. Ce paramètre est obligatoire.
-classpath
Chemin d'accès qui indique au serveur d'applications l'emplacement des fichiers JAR du pilote de périphérique SQLJ requis. Ce paramètre est facultatif.
-dburl
Emplacement du serveur DB2 sur ce réseau. Ce paramètre est facultatif.
-user
Nom d'utilisateur correspondant au compte qui accède à la base de données DB2. Ce paramètre est facultatif.
-password
Mot de passe du compte qui accède à la base de données DB2. Ce paramètre est facultatif.
-options
Des options supplémentaires utilisées avec la commande db2sqljcustomize peuvent être insérées dans le paramètre -options, hormis les paramètres listés précédemment. Ce paramètre est facultatif. Pour plus d'informations sur la commande db2sqljcustomize, consultez db2sqljcustomize - Personnaliseur de profil SQLJ.
-profiles
Emplacement des fichiers .ser ou du fichier .grp contenant les profils SQLJ. Ce paramètre est obligatoire.

Exemples

Exemple d'utilisation en mode de traitement par lots :

  • A l'aide de 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 }} 

  • Avec 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"]]')

Exemple d'utilisation en mode interactif :

wsadmin>print AdminTask.processSqljProfiles('-interactive') Process serialized SQLJ 
 profiles. Process the serialized SQLJ profiles in an installed application.  Customize the profiles with run time information and 
 bind static SQL packages in a database.   Refer to the Database SQLJ customize and bind documentation.    Do only bind 
 processing. (bindOnly): false  *Application name. (appName): Application  Classpath to SQLJ tools. (classpath): 
 C:/IBM/SQLLIB/java/db2jcc.jar  Database connection URL. (dbURL):  Database connection user name. (user):  Database connection 
 password. (password):  Options for SQLJ tools. (options):  *SQLJ profile names. (profiles): c:/temp/ApplicationSerNames.grp   
 Process serialized SQLJ profiles.    F (Finish) C (Cancel)   Select [F, C]: [F]  WASX7278I: Generated command line: 
 AdminTask.processSqljProfiles('[-bindOnly false -appName Application -classpath [C:/IBM/SQLLIB/java/db2jcc.jar] -profiles 
 [c:/temp/ApplicationSerNames.grp ]]') 

listPureQueryBindFiles

La commande listPureQueryBindFiles interprète le fichier EAR de l'application indiquée et renvoie la liste des fichiers .bindprops et .pdqxml trouvés. Les fichiers d'options de liaison PureQuery ont une extension de nom de fichier .bindprops. Les fichiers des liaisons proprement dites ont une extension de nom de fichier .pdqxml. Si un fichier EAR contient des fichiers qui ne sont pas des fichiers de liaison pureQuery, mais ont malgré tout une extension de nom de fichier .bindprops ou .pdqxml, ces fichiers seront probablement dans la liste aussi.

Paramètres et valeurs renvoyées

-appName
Nom de l'application installée. Ce paramètre est obligatoire.

Exemples

Exemple d'utilisation en mode de traitement par lots :

  • A l'aide de JACL :

    $AdminTask listPureQueryBindFiles {-appName application_name}
  • Avec Jython :

    print AdminTask.listPureQueryBindFiles('-appName application_name')
Exemple d'utilisation en mode interactif :
  • A l'aide de JACL :

    $AdminTask listPureQueryBindFiles -interactive
  • Avec Jython :

    print AdminTask.listPureQueryBindFiles('-interactive')

La sortie est produite avec une syntaxe propre au système d'exploitation local.

processPureQueryBindFiles

La commande processPureQueryBindFiles appelle l'outil de liaison DB2 pureQuery sur une liste de fichiers de liaison pureQuery.
Pratiques recommandées Pratiques recommandées: Si vous traitez une application d'entreprise de grande taille ou de nombreux fichiers de liaison pureQuery à l'aide de wsadmin, le processus peut prendre plus longtemps que le délai d'attente par défaut de l'outil wsadmin. Le délai d'attente de connexion par défaut pour l'outil wsadmin est réglé à 3 minutes. Si le délai d'attente par défaut est atteint et que le processus en cours d'exécution sur le serveur n'est pas encore terminé, la console wsadmin émet une instruction d'expiration. Vous pouvez vérifier le journal de sortie système du serveur pour prendre connaissance des résultats finals du processus de liaison et de l'heure à laquelle ce processus s'est terminé. N'exécutez pas la commande processPureQueryBindFiles à nouveau avant que la commande précédente soit terminée : vous risqueriez d'obtenir un résultat inattendu.
Pour empêcher ce problème, allongez le délai d'attente de la demande wsadmin. Après une liaison et une personnalisation réussies, utilisez le journal de sortie système pour évaluer le temps de traitement total. Utilisez cette durée comme base pour le nouveau délai d'attente. Pour prolonger la valeur du délai d'attente par défaut, modifiez le fichier de propriétés wsadmin correspondant au type de connexion que vous utilisez :
  • Pour le type de connexion SOAP, modifiez l'entrée suivante dans le fichier soap.client.props :
    com.ibm.SOAP.requestTimeout=180
  • Pour les types de connexion JSR160RMI et RMI, modifiez l'entrée suivante dans le fichier sas.client.props :
    com.ibm.CORBA.requestTimeout=180
  • Pour le type de connexion IPC, modifiez l'entrée suivante dans le fichier ipc.client.props :
    com.ibm.IPC.requestTimeout=180
bprac

Pour vérifier si la liaison a été effectuée, consultez le journal System Out pour déterminer si le processus de liaison a réussi.

Paramètres et valeurs renvoyées

-appName
Nom d'une application installée qui contient les fichiers de liaison pureQuery à traiter. Votre application doit être installée avant l'exécution de la liaison dessus.
-classpath
Liste des chemins d'accès aux fichiers d'archive Java (JAR) qui contiennent l'outil de liaison IBM Optim PureQuery Runtime et ses dépendances : pdq.jar, pdqmgmt.jar, db2jcc4.jar ou db2jcc.jar, db2jcc_license_cisuz.jar ou db2jcc_license_cu.jar. Utilisez les caractères / ou \\\\ comme séparateur de fichiers. Utilisez un espace blanc pour séparer les chemins d'accès aux fichiers JAR.
-dburl
Adresse URL de connexion à la base de données. Le format est le suivant : jdbc:db2://nom_serveur:port/nom_basededonnées.
-user
Nom d'utilisateur correspondant au compte qui accède à la base de données DB2.
-password
Mot de passe du compte qui accède à la base de données DB2.
-options
Options supplémentaires nécessaires à l'outil de liaison IBM Optim PureQuery Runtime. Définissez les option de liaison au format suivant : -bindoptions "chaîne_options_liaison". Pour plus d'informations sur l'outil de liaison IBM Optim PureQuery Runtime, consultez la rubrique correspondante.
-files
Liste des noms des fichiers de liaison pureQuery à traiter. Les chemins d'accès aux fichiers de liaison doivent être définis relativement au fichier EAR d'application qui les contient. Utilisez les caractères / ou \\\\ comme séparateur de fichiers. Si vous indiquez plusieurs chemins d'accès aux profils, utilisez un espace blanc pour les séparer.

Exemples

Exemple d'utilisation en mode de traitement par lots :

  • A l'aide de 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 }}
  • Avec 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 ]]')

Exemple d'utilisation en mode interactif :

print AdminTask.processPureQueryBindFiles('-interactive') Process pureQuery bind files.  
 Process the pureQuery bind files in an installed application.  Bind static SQL packages in a database.  Refer to the pureQuery 
 Bind utility documentation.  *Application name. (appName): MyApp Classpath to pureQuery Bind utility. (classpath): 
 /pdq_home/pdq.jar /pdq_home/pdqmgmt.jar /db2_home/SQLLIB/java/db2jcc4.jar /db2_home/SQLLIB/java/db2jcc_license_cu.jar *Database 
 connection URL. (url): jdbc:db2://hostname:50000/databasename Database connection user name. (user): dbuser1 Database connection 
 password. (password): dbpswrd1 Options for the pureQuery Bind utility. (options): -bindoptions "BLOCKING NO" *pureQuery bind file 
 names. (files): META-INF/xyz.bindprops META-INF/abc.bindprops  Process pureQuery bind files.  F (Finish) C (Cancel)  Select [F, 
 C]: [F] WASX7278I: Generated command line: 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 ]]')

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=rxml_atappmancommandsgroup
Nom du fichier : rxml_atappmancommandsgroup.html