Appel d'une commande d'administration en mode différé (traitement par lots) à l'aide de l'outil de scriptage wsadmin

Les commandes AdminTask permettent d'appeler une commande d'administration en mode de traitement par lots.

Pourquoi et quand exécuter cette tâche

Cette étapes décrivent comment appeler une commande d'administration en mode de traitement par lots à l'aide de l'outil de scriptage wsadmin.

Pour appeler une commande d'administration en mode interactif, voir la rubrique concernant l'appel d'une commande en mode interactif.

Procédure

  1. Appelez interactivement l'objet AdminTask dans un script ou utilisez la commande wsadmin -c dans une invite de commande de système d'exploitation.

    Voir la rubrique Démarrage du client de scriptage wsadmin.

  2. Entrez l'une des commandes suivantes :
    • Si une commande d'administration n'est pas associée à un objet cible et à un argument, utilisez la commande suivante :
      A l'aide de Jacl :
      $AdminTask commandName
      Avec Jython :
      AdminTask.commandName()
      Tableau 1. Description AdminTask. Appelez une commande AdminTask depuis une ligne de commande wsadmin.
      Elément Description
      $ est un opérateur Jacl permettant de remplacer un nom de variable par sa valeur
      AdminTask est un objet permettant la gestion des commandes d'administration
      nomCommande est le nom de la commande d'administration à appeler
    • Si une commande d'administration inclut un objet cible mais ni arguments ni étapes, utilisez la commande suivante :
      Avec Jacl :
      $AdminTask commandName targetObject
      Avec Jython :
      AdminTask.commandName(targetObject)
      Tableau 2. Description AdminTask targetObject. Appelez une commande AdminTask depuis une ligne de commande wsadmin.
      Elément Description
      $ est un opérateur Jacl permettant de remplacer un nom de variable par sa valeur
      AdminTask est un objet prenant en charge la gestion des commandes d'administration
      nomCommande est le nom de la commande d'administration à appeler
      objetCible est la chaîne de l'objet cible de la commande d'administration appelée. L'objet cible varie en fonction de la commande d'administration. Pour plus d'informations sur l'objet cible, consultez l'aide en ligne de la commande.
    • Si une commande d'administration inclut un argument ou une étape mais pas d'objet cible, utilisez la commande suivante :
      Avec Jacl :
      $AdminTask commandName options
      Avec Jython :
      AdminTask.commandName(options)
      Tableau 3. Description AdminTask options. Appelez une commande AdminTask depuis une ligne de commande wsadmin.
      Elément Description
      $ est un opérateur Jacl permettant de remplacer un nom de variable par sa valeur
      AdminTask est un objet prenant en charge la gestion des commandes d'administration
      nomCommande est le nom de la commande d'administration à appeler
      options est la chaîne d'options pour la commande d'administration appelée. En fonction de la commande d'administration que vous appelez, les valeurs d'options peuvent être obligatoires ou facultatives. Les chaînes d'options varient en fonction des commandes d'administration. Affichez l'aide en ligne de la commande d'administration appelée pour obtenir davantage d'informations sur les options disponibles. Les arguments et les étapes répertoriés dans l'aide en ligne de la commande d'administration sont indiquées comme des options dans la chaîne d'options.

      Chaque option comprend un tiret suivi immédiatement par un nom d'option, puis d'une valeur d'option si l'option nécessite une valeur. Si la commande d'administration appelée inclut des objets cibles, des arguments ou des étapes, l'option –interactive est alors disponible et permet d'entrer ces éléments en mode interactif. Par exemple, utilisez la sortie de l'aide en ligne suivante pour la commande listDataSource :

      WASX8006I: Aide détaillée pour la commande : exportServer
      
      Description : Exportation de la configuration d'un serveur vers une archive de configuration.
      
      Objet cible : Aucun
      
      Arguments :
      *serverName - le nom d'un serveur
      *nodeName - le nom d'un noeud. Ce paramètre 
      est facultatif lorsque le nom de serveur spécifié 
      est unique dans la cellule.
      *archive - le chemin d'accès complet 
      d'une archive de configuration.
      
      Etapes :
      Aucun

      Les noms d'option sont indiqués avec un tiret avant le nom. Trois options sont disponibles pour cette commande d'administration. Les options obligatoires sont -serverName, -nodename et -archive. L'option -interactive est également disponible. Les options sont indiquées dans la chaîne d'options placée entre accolades ({}) dans Jacl et entre crochets ([]) dans Jython.

    • Si la commande d'administration inclut un objet cible et des arguments ou des étapes, procédez comme suit :
      Avec Jacl :
      $AdminTask commandName targetObject options
      Avec Jython :
      AdminTask.commandName(targetObject, options)
      Tableau 4. Description de AdminTask targetObject options. Appelez une commande AdminTask depuis une ligne de commande wsadmin.
      Elément Description
      $ est un opérateur Jacl permettant de remplacer un nom de variable par sa valeur
      AdminTask est un objet prenant en charge la gestion des commandes d'administration
      nomCommande est le nom de la commande d'administration à appeler
      objetCible est la chaîne de l'objet cible de la commande d'administration appelée. L'objet cible varie en fonction de la commande d'administration. Pour plus d'informations sur les objets cibles, consultez l'aide en ligne de la commande. Par exemple, utilisez la sortie de l'aide en ligne suivante pour createJ2CConnectionFactory :
      WASX8006I: Aide détaillée sur la commande : 
      createJ2CConnectionFactory
      
      Description : Création d'une fabrique de connexions J2C
      
      *Objet cible : l'adaptateur de ressources J2C parent de la fabrique de connexions J2C créée.
      
      Arguments :
      *connectionFactoryInterface - Une interface de fabriquede connexions définie lors de la description du déploiement de l'adaptateur de ressources J2C parent.
      *name - Nom de la fabrique de connexions J2C.
      *jndiName - Le nom JNDI de la fabrique de connexions J2C créée.
      description - La description de la fabrique de connexions J2C créée.
      authDataAlias - L'alias des données d'authentification de la fabrique de connexions J2C créée.
      
      Etapes :
      Aucun
      L'objet cible est un nom d'objet de configuration d'un adaptateur de ressources J2C.
      options est la chaîne d'options pour la commande d'administration appelée. En fonction de la commande d'administration que vous appelez, les valeurs d'options peuvent être obligatoires ou facultatives. Les chaînes d'options varient en fonction des commandes d'administration. Affichez l'aide en ligne de la commande d'administration appelée pour obtenir davantage d'informations sur les options disponibles. Les arguments et les étapes répertoriés dans l'aide en ligne de la commande d'administration sont indiquées comme des options dans la chaîne d'options. Chaque option comprend un tiret suivi immédiatement par un nom d'option, puis d'une valeur d'option si l'option nécessite une valeur. Si la commande d'administration appelée inclut des objets cibles, des arguments ou des étapes, l'option –interactive est alors disponible et permet d'entrer ces éléments en mode interactif. Par exemple, utilisez la sortie de l'aide en ligne suivante pour listDataSource :
      WASX8006I: Aide détaillée sur la commande : 
      createJ2CConnectionFactory
      
      Description : Création d'une fabrique de connexions J2C
      
      *Objet cible : l'adaptateur de ressources J2C parent de la fabrique de connexions J2C créée.
      
      Arguments :
      *connectionFactoryInterface - Une interface de fabriquede connexions définie lors de la description du déploiement de l'adaptateur de ressources J2C parent.
      *name - Nom de la fabrique de connexions J2C.
      *jndiName - Le nom JNDI de la fabrique de connexions J2C créée.
      description - La description de la fabrique de connexions J2C créée.
      authDataAlias - L'alias des données d'authentification de la fabrique de connexions J2C créée.
      
      Etapes :
      Aucun
      Les noms d'option sont indiqués avec un tiret avant le nom. Les options obligatoires de cette commande d'administration sont -connectionFactoryInterface, -name et -jndiName. Les options facultatives sont -description et -authDataAlias. De plus, vous pouvez utiliser l'option -interactive. Les options sont indiquées dans la chaîne d'options placée entre accolades ({}) dans Jacl et entre crochets ([]) dans Jython.

Exemple

  • L'exemple suivant appelle une commande d'administration sans objet cible, ni argument, ni étape :
    Avec Jacl :
    $AdminTask listNodes
    Avec Jython :
    print AdminTask.listNodes()

    Exemple de sortie :

    myNode
  • L'exemple suivant appelle une commande d'administration avec une chaîne objet cible :
    Avec Jacl :
    set s1 [$AdminConfig getid /Server:server1/]
    $AdminTask showServerInfo $s1
    Avec Jython :
    s1 = AdminConfig.getid('/Server:server1/')
    print AdminTask.showServerInfo(s1)
    Exemple de sortie :
    {cell myCell}
    {serverType APPLICATION_SERVER}
    {com.ibm.websphere.baseProductVersion 6.0.0.0}
    {node myNode}
    {server server1}
  • L'exemple suivant appelle une commande d'administration avec une chaîne option :
    Avec Jacl :
    $AdminTask getNodeMajorVersion {-nodeName myNode}
    Avec Jython :
    print AdminTask.getNodeMajorVersion('[-nodeName myNode]')
    Exemple de sortie :
    6
  • L'exemple suivant appelle une commande d'administration avec des chaînes objet cible et options sans étapes :
    Avec Jacl :
    set ra [$AdminConfig getid /J2CResourceAdapter:myResourceAdapter/]
    $AdminTask createJ2CConnectionFactory $ra {-name myJ2CCF -jndiName j2c/cf -connectionFactoryInterface 
    javax.resource.cci.ConnectionFactory}
    Avec Jython :
    ra = AdminConfig.getid('/J2CResourceAdapter:myResourceAdapter/') 
    AdminTask.createJ2CConnectionFactory(ra, '[-name myJ2CCF -jndiName j2c/cf -connectionFactoryInterface 
    javax.resource.cci.ConnectionFactory]')
    Exemple de sortie :
    myJ2CCF(cells/myCell/nodes/myNode|resources.xml#J2CConnectionFactory_1069690568269)
  • L'exemple suivant appelle une commande d'administration avec un objet cible et une option avec étapes :
    Avec Jacl :
    set serverCluster [$AdminConfig getid /ServerCluster:myCluster/]
    $AdminTask createClusterMember $serverCluster {-memberConfig {{myNode myClusterMember "" "" false false}}}
    Avec Jython :
    serverCluster = AdminConfig.getid('/ServerCluster:myCluster/')
    AdminTask.createClusterMember(serverCluster, '[-memberConfig [[myNode myClusterMember "" "" false false]]]') 
    Exemple de sortie :
    myClusterMember(cells/myCell/nodes/myNode|cluster.xml#ClusterMember_3673839301876)

Icône indiquant le type de rubrique Rubrique de tâche



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