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.
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')
- A l'aide de JACL :
$AdminTask listSqljProfiles -interactive
- Avec Jython :
print AdminTask.listSqljProfiles('-interactive')
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.
- 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
- 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 :
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.hasChanges()
.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')
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.
- 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
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 ]]')