Commandes de l'objet AdminConfig en utilisant les outils de script wsadmin

L'objet AdminConfig permet d'appeler des commandes de configuration et de créer ou de modifier des éléments de la configuration WebSphere Application Server. Par exemple, il permet de créer une source de données.

Vous pouvez démarrer le client de scriptage même lorsqu'aucun serveur n'est actif, si seules les opérations locales vous intéressent. Pour une exécution en mode local, démarrez le client de scriptage avec l'option -conntype NONE. Un message vous informe que vous êtes en mode local. Lorsqu'un serveur est en cours d'exécution, n'exécutez pas l'outil AdminConfig en mode local. Les modifications de configuration effectuées en mode local ne sont pas répercutées dans la configuration du serveur en cours d'exécution. Si vous sauvegardez une configuration non compatible, la configuration risque d'être endommagée.

Dans l'environnement d'un gestionnaire de déploiement, les mises à jour de la configuration sont uniquement disponibles lorsqu'un client de scriptage est connecté à un gestionnaire de déploiement.

Lorsque le client de scriptage est connecté à un agent de noeud ou à un serveur d'applications géré, vous n'êtes pas en mesure de mettre à jour la configuration car les configurations de ces processus serveur sont des copies de la configurations maîtresse qui réside sur le gestionnaire de déploiement. Cette copie est créée sur une machine noeud lorsqu'une synchronisation de la configuration du gestionnaire de déploiement et de l'agent de noeud a lieu. Pour modifier la configuration des processus de serveur, vous devez connecter un client de scriptage à un gestionnaire de déploiement. Pour cette raison, pour modifier une configuration, n'exécutez pas un client de scriptage en mode local sur une machine noeud. Cette configuration n'est pas prise en charge.

Configurations prises en charge Configurations prises en charge: Vous pouvez utiliser la liste Jython ou la syntaxe de chaîne pour transmettre les paramètres à une commande wsadmin. S'il existe un paramètre comportant une virgule en tant que caractère, vous devez utiliser la syntaxe de chaîne Jython pour transmettre les paramètres.
Pour utiliser la commande create, par exemple, entrez une commande similaire à celle-ci :
params='[[name name1] [nameInNameSpace nameSpace_Name] [string_to_bind "value, withComma"]]' 
AdminConfig.create(type, parent, params)
Vous pouvez également utiliser la commande modify :
AdminConfig.modify(type, params)
sptcfg

attributes

La commande attributes renvoie la liste des attributs de niveau supérieur d'un type donné.

Objet cible

Aucun.

Paramètres requis

type_objet
Indique le nom du type d'objet basé sur les fichiers de configuration XML. Le type d'objet ne doit pas obligatoirement être identique à celui qui s'affiche dans la console d'administration.

Paramètres facultatifs

Aucun.

Exemple de sortie

"properties Property*" "serverSecurity ServerSecurity" 
"server Server@" "id Long" "stateManagement StateManageable" 
"name String" "moduleVisibility EEnumLiteral(MODULE, 
COMPATIBILITY, SERVER, APPLICATION)" "services Service*" 
"statisticsProvider StatisticsProvider" 

Exemples

  • Avec Jacl :
    $AdminConfig attributes ApplicationServer
  • Avec Jython :
    print AdminConfig.attributes('ApplicationServer')

checkin

La commande checkin permet de restituer un fichier dans le référentiel de configuration qui est décrit par l'URI (Uniform Resource Identifier) de document. Cette méthode ne s'applique qu'aux configurations de gestionnaire de déploiement.

Objet cible

Aucun.

Paramètres requis

URI
L'URI du document est fonction de la racine du référentiel de configuration, par exemple:
  • [AIX Solaris HP-UX Linux Windows]racine_serveur_app\config
  • [IBM i]/WebSphere/AppServer/config
  • [z/OS]\WebSphere\AppServer\config
nom_fichier
Indique le nom du fichier source à restituer.
objet_opaque
Indique un objet que la commande extract de l'objet AdminConfig renvoie par un appel préalable.

Paramètres facultatifs

Aucun.

Exemple de sortie

"properties Property*" "serverSecurity ServerSecurity" 
"server Server@" "id Long" "stateManagement StateManageable" 
"name String" "moduleVisibility EEnumLiteral(MODULE, 
COMPATIBILITY, SERVER, APPLICATION)" "services Service*" 
"statisticsProvider StatisticsProvider" 

Exemples

  • Avec Jacl :
    [AIX][HP-UX][IBM i][Linux][Solaris]
    $AdminConfig checkin cells/MyCell/Node/MyNode/serverindex.xml /mydir/myfile $obj
    [Windows]
    $AdminConfig checkin cells/MyCell/Node/MyNode/serverindex.xml c:\\mydir\myfile $obj
    [z/OS]
    $AdminConfig checkin cells/MyCell/Node/MyNode/serverindex.xml \mydir\myfile $obj
  • Avec Jython :
    [AIX][HP-UX][IBM i][Linux][Solaris]
    print AdminConfig.checkin('cells/MyCell/Node/MyNode/serverindex.xml', '/mydir/myfile',  obj)
    [Windows]
    print AdminConfig.checkin('cells/MyCell/Node/MyNode/serverindex.xml', 'c:\mydir\myfile',  obj)
    [z/OS]
    print AdminConfig.checkin('cells/MyCell/Node/MyNode/serverindex.xml', '\mydir\myfile',  obj)

convertToCluster

La commande convertToCluster permet de convertir un serveur de sorte qu'il devienne le premier membre d'un groupe de serveurs (cluster).

Objet cible

Aucun.

Paramètres requis

ID_serveur
ID configuration du serveur concerné.
nom_cluster
Indique le nom du cluster concerné.

Paramètres facultatifs

Aucun.

Exemple de sortie

myCluster(cells/mycell/clusters/myCluster|cluster.xml#ClusterMember_2)

Exemples

  • Avec Jacl :
    set serverid [$AdminConfig getid /Server:myServer/]
    $AdminConfig convertToCluster $serverid myCluster
  • Avec Jython :
    serverid = AdminConfig.getid('/Server:myServer/')
    print AdminConfig.convertToCluster(serverid, 'myCluster')

Créer

La commande create permet de créer des objets de configuration.

Objet cible

Aucun.

Paramètres requis

type
Indique le nom du type d'objet basé sur les fichiers de configuration XML. Il ne doit pas obligatoirement être identique à celui qui s'affiche dans la console d'administration.
ID_parent
Indique l'ID configuration de l'objet parent.
attributes
Indique tous les attributs à ajouter à l'ID configuration.

Paramètres facultatifs

Aucun.

Exemple de sortie

Cette commande renvoie une chaîne du nom d'objet de configuration, comme illustré dans l'exemple de sortie suivant :
ds1(cells/mycell/nodes/DefaultNode/servers/server1|resources.xml#DataSource_6)

Exemples

  • Avec Jacl :
    set jdbc1 [$AdminConfig getid /JDBCProvider:jdbc1/]
    $AdminConfig create DataSource $jdbc1 {{name ds1}}
  • A l'aide des attributs de chaîne Jython :
    jdbc1 = AdminConfig.getid('/JDBCProvider:jdbc1/')
    print AdminConfig.create('DataSource', jdbc1, '[[name ds1]]')
  • A l'aide de Jython avec des attributs d'objet :
    jdbc1 = AdminConfig.getid('/JDBCProvider:jdbc1/')
    print AdminConfig.create('DataSource', jdbc1, [['name', 'ds1']])
  • Utilisez l'exemple suivant pour créer un port :
    #replace server1 with your server name                                       
    serverName = 'server1'                                                       
                                                                                 
    #replace smtitant24Node03 with your node name                                
    node = AdminConfig.getid('/Node:smtitan24Node03')                            
    #print node                                                                  
    serverEntries = AdminConfig.list('ServerEntry',                              
    node).split(java.lang.System.getProperty('line.separator'))                  
                                                                                 
    for serverEntry in serverEntries:                                            
      sName = AdminConfig.showAttribute(serverEntry, "serverName")               
      if sName == serverName:                                                    
        #print serverEntry                                                       
        #replace OVERLAY_TEST with the value you want for your endPointName      
        id = AdminConfig.create('NamedEndPoint', serverEntry,                    
    '[[endPointName "OVERLAY_TEST"]]')                                           
        #print id                                                                
        start = id.find('#')                                                     
        #print start                                                             
        end = id.find(')',start)                                                 
        #print end                                                               
        str = id[start:end]                                                      
        server = id[0:start]                                                     
        #print server                                                            
        #print str                                                               
        #replace 8888 with the value you want for your port                      
        AdminConfig.create('EndPoint', server+str+')', '[[port "8888"] [host     
    "*"]]')                                                                      
        AdminConfig.save()                                                       
        #AdminConfig.reset() 

createClusterMember

La commande createClusterMember permet de créer un objet serveur sur le noeud indiqué par le paramètre d'ID noeud. Ce serveur est créé en tant que membre du cluster existant indiqué par le paramètre d'ID cluster et contient les attributs indiqués dans le paramètre d'attributs de membre. Le serveur est créé à l'aide du modèle de serveur indiqué par l'attribut d'ID modèle, et qui contient le nom spécifié par l'attribut memberName. L'attribut memberName est obligatoire. Les options du modèle sont uniquement disponibles pour le premier membre de cluster créé. Tous les membres de cluster créés après le premier membre sont identiques.

Objet cible

Aucun.

Paramètres requis

ID_cluster
Indique l'ID configuration du cluster en question.
ID noeud
Indique l'ID configuration de l'objet en question.
ID modèle
Indique l'ID modèle à utiliser pour créer le serveur.
attributs_membre
Indique tous les attributs à ajouter au membre de cluster. L'attribut memberName est obligatoire et définit le nom du membre de cluster à créer.

Paramètres facultatifs

Aucun.

Exemple de sortie

Cette commande renvoie l'ID configuration du membre de cluster nouvellement créé, comme dans l'exemple suivant :
myCluster(cells/mycell/clusters/myCluster|cluster.xml#ClusterMember_2)

Exemples

  • Avec Jacl :
    set clid [$AdminConfig getid /ServerCluster:myCluster/]
    set nodeid [$AdminConfig getid /Node:mynode/]
    $AdminConfig createClusterMember $clid $nodeid {{memberName newMem1} {weight 5}}
  • A l'aide des attributs de chaîne Jython :
    clid = AdminConfig.getid('/ServerCluster:myCluster/') 
    nodeid = AdminConfig.getid('/Node:mynode/')
    print AdminConfig.createClusterMember(clid, nodeid, '[[memberName newMem1] [weight 5]]')
  • A l'aide de Jython avec des attributs d'objet :
    clid = AdminConfig.getid('/ServerCluster:myCluster/') 
    nodeid = AdminConfig.getid('/Node:mynode/') 
    print AdminConfig.createClusterMember(clid, nodeid, [['memberName', 'newMem1'], ['weight', 5]])

createDocument

La commande createDocument permet de créer un document dans le référentiel de configuration.

Objet cible

Aucun.

Paramètres requis

URI_document
Indique le nom du document à créer dans le référentiel.
nom_fichier
Indique un nom de fichier local valide du document à créer.

Paramètres facultatifs

Aucun.

Exemples

  • Avec Jacl :
    [AIX][HP-UX][IBM i][Linux][Solaris]
    $AdminConfig createDocument cells/mycell/myfile.xml /mydir/myfile
    [Windows]
    $AdminConfig createDocument cells/mycell/myfile.xml c:/mydir/myfile
    [z/OS]
    $AdminConfig createDocument cells/mycell/myfile.xml /mydir/myfile
  • A l'aide de Jython avec des attributs de chaîne :
    [AIX Solaris HP-UX Linux Windows]
    AdminConfig.createDocument('cells/mycell/myfile.xml', 'c:/mydir/myfile')
    [IBM i]
    AdminConfig.createDocument('cells/mycell/myfile.xml', '/mydir/myfile')
    [z/OS]
    AdminConfig.createDocument('cells/mycell/myfile.xml', '/mydir/myfile')

createUsingTemplate

La commande createUsingTemplate permet de créer un type d'objet avec le parent donné, en utilisant un modèle. Vous ne pouvez utiliser cette commande que pour la création d'un serveur avec le type APPLICATION_SERVER. Si vous souhaitez créer un serveur avec un autre type que APPLICATION_SERVER, utilisez la commande createGenericServer ou createWebServer.

Objet cible

Aucun.

Paramètres requis

type
Indique le type d'objet à créer.
parent
Indique l'ID configuration du parent.
modèle
Indique l'ID configuration d'un objet existant. Cet objet peut correspond à un objet modèle renvoyé à l'aide de la commande listTemplates ou à tout autre objet existant du type correct.

Paramètres facultatifs

attributes
Indique des valeurs d'attributs pour l'objet. Les attributs spécifiés à l'aide de ce paramètre remplacent les valeurs paramétrées dans le modèle.

Exemple de sortie

Cette commande renvoie l'ID configuration du nouvel objet, comme dans l'exemple suivant :
myCluster(cells/mycell/clusters/myCluster|cluster.xml#ClusterMember_2)

Exemples

  • Avec Jacl :
    set node [$AdminConfig getid /Node:mynode/]
    set templ [$AdminConfig listTemplates JDBCProvider "DB2 JDBC Provider (XA)"]
    $AdminConfig createUsingTemplate JDBCProvider $node {{name newdriver}} $templ 
  • A l'aide de Jython avec des attributs de chaîne :
    node = AdminConfig.getid('/Node:mynode/')
    templ = AdminConfig.listTemplates('JDBCProvider', "DB2 JDBC Provider (XA)")
    print AdminConfig.createUsingTemplate('JDBCProvider', node, '[[name newdriver]]', templ)
  • A l'aide de Jython avec des attributs d'objet :
    node = AdminConfig.getid('/Node:mynode/')
    templ = AdminConfig.listTemplates('JDBCProvider', "DB2 JDBC Provider (XA)")
    print AdminConfig.createUsingTemplate('JDBCProvider', node, [['name', 'newdriver']], templ)

defaults

La commande defaults permet d'afficher les valeurs par défaut des attributs d'un type donné. Cette méthode affiche tous les attributs que peut contenir un objet d'un type spécifique. Si l'attribut a une valeur par défaut, cette méthode affiche également le type et la valeur par défaut de chaque attribut.

Objet cible

Aucun.

Paramètres requis

type
Indique le type d'objet à renvoyer. Le nom du type d'objet indiqué est basé sur les fichiers de configuration XML. Il ne doit pas obligatoirement être identique à celui qui s'affiche dans la console d'administration.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande renvoie une chaîne contenant la liste des attributs accompagnés de leur type et de leur valeur, comme dans l'exemple suivant :
Attribute               Type   	 Default

usingMultiRowSchema     Boolean  false
maxInMemorySessionCount Integer  1000
allowOverflow           Boolean  true
scheduleInvalidation    Boolean  false
writeFrequency          ENUM
writeInterval           Integer  120
writeContents           ENUM
invalidationTimeout     Integer  30
invalidationSchedule    InvalidationSchedule

Exemples

  • Avec Jacl :
    $AdminConfig defaults TuningParams
  • Avec Jython :
    print AdminConfig.defaults('TuningParams')

deleteDocument

La commande deleteDocument permet de supprimer un document du référentiel de configuration.

Objet cible

Aucun.

Paramètres requis

URI_document
Indique le document à supprimer du référentiel.

Paramètres facultatifs

Aucun.

Exemples

  • Avec Jacl :
    $AdminConfig deleteDocument cells/mycell/myfile.xml
  • Avec Jython :
    AdminConfig.deleteDocument('cells/mycell/myfile.xml')

existsDocument

La commande existsDocument permet de vérifier la présente d'un document dans le référentiel de configuration.

Objet cible

Aucun.

Paramètres requis

URI_document
Indique le document à vérifier dans le référentiel.

Paramètres facultatifs

Aucun.

Exemple de sortie

Cette commande renvoie une valeur true si le document existe, comme dans l'exemple suivant :
1

Exemples

  • Avec Jacl :
    $AdminConfig existsDocument cells/mycell/myfile.xml
  • Avec Jython :
    print AdminConfig.existsDocument('cells/mycell/myfile.xml')

extract

La commande extract permet d'extraire du référentiel de configuration le fichier décrit par le paramètre d'URI de document et le place dans le fichier désigné par filename. Cette méthode ne s'applique qu'aux configurations de gestionnaire de déploiement.

Objet cible

Aucun.

Paramètres requis

URI_document
Indique le document à extraire du référentiel de configuration. L'URI du document doit exister dans le référentiel. L'URI du document est fonction de la racine du référentiel de configuration, par exemple:
  • [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]/WebSphere/AppServer/config
  • [Windows]racine_serveur_app\config
nom_fichier
Indique le nom du fichier dans lequel extraire le document. Ce paramètre doit indiquer un nom de fichier local correct dans lequel se trouve le document. Si le fichier désigné par le paramètre nom_fichier existe, le fichier extrait le remplace.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande renvoie un objet "digest" opaque qui doit servir à restituer le fichier à l'aide de la commande checkin.

Exemples

  • Avec Jacl :
    [AIX][HP-UX][IBM i][Linux][Solaris]
    set obj [$AdminConfig extract cells/MyCell/nodes/MyNode/serverindex.xml /mydir/myfile] 
    [Windows]
    set obj [$AdminConfig extract cells/MyCell/nodes/MyNode/serverindex.xml c:\\mydir\myfile] 
    [z/OS]
    set obj [$AdminConfig extract cells/MyCell/nodes/MyNode/serverindex.xml \mydir\myfile] 
  • Avec Jython :
    [AIX][HP-UX][IBM i][Linux][Solaris]
    obj = AdminConfig.extract('cells/MyCell/nodes/MyNode/serverindex.xml','/mydir/myfile')
    [Windows]
    obj = AdminConfig.extract('cells/MyCell/nodes/MyNode/serverindex.xml','c:\mydir\myfile')
    [z/OS]
    obj = AdminConfig.extract('cells/MyCell/nodes/MyNode/serverindex.xml','\mydir\myfile')

getCrossDocumentValidationEnabled

La commande getCrossDocumentValidationEnabled permet de renvoyer un message indiquant le paramétrage d'activation de la validation interdocuments. Cette méthode renvoie la valeur true si la validation interdocuments est activée.

Objet cible

Aucun.

Paramètres requis

Aucun.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande renvoie une chaîne contenant le message qui indique le paramétrage de la validation interdocuments, comme dans l'exemple suivant :
WASX7188I: Cross-document validation enablement set to true

Exemples

  • Avec Jacl :
    $AdminConfig getCrossDocumentValidationEnabled
  • Avec Jython :
    print AdminConfig.getCrossDocumentValidationEnabled()

getid

La commande getid permet de renvoyer l'ID configuration d'un objet.

Objet cible

Aucun.

Paramètres requis

chemin_imbrication
Indique le chemin d'imbrication concerné.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande renvoie l'ID configuration de l'objet décrit par l'argument de chemin d'imbrication, comme dans l'exemple suivant :
Db2JdbcDriver(cells/testcell/nodes/testnode|resources.xml#JDBCProvider_1)

Exemples

  • Avec Jacl :
    $AdminConfig getid /Cell:testcell/Node:testNode/JDBCProvider:Db2JdbcDriver/
  • Avec Jython :
    print AdminConfig.getid('/Cell:testcell/Node:testNode/JDBCProvider:Db2JdbcDriver/')

getObjectName

La commande getObjectName permet de renvoyer une version chaîne du nom d'objet du MBean correspondant en cours d'exécution. Cette méthode renvoie une chaîne vide lorsqu'il n'existe pas de MBean correspondant en cours d'exécution.

Objet cible

Aucun.

Paramètres requis

ID_configuration
Indique l'ID configuration du nom d'objet à renvoyer.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande renvoie une chaîne contenant le nom d'objet, comme dans l'exemple suivant :
WebSphere:cell=mycell,name=server1,mbeanIdentifier=cells/mycell/nodes/mynode/servers/server1/
server.xml#Server_1,type=Server,node=mynode,process=server1,processType=UnManagedProcess

Exemples

  • Avec Jacl :
    set server [$AdminConfig getid /Node:mynode/Server:server1/]
    $AdminConfig getObjectName $server
  • Avec Jython :
    server = AdminConfig.getid('/Node:mynode/Server:server1/')
    print AdminConfig.getObjectName(server)

getObjectType

Utilisez la commande getObjectType pour afficher le type d'objet de l'ID configuration de l'objet impliqué.

Objet cible

Aucun.

Paramètres requis

ID_configuration
Indique l'ID configuration du nom d'objet à renvoyer.

Paramètres facultatifs

Aucun.

Exemples

  • Avec Jacl :
    set server [$AdminConfig getid /Node:mynode/Server:server1/]
    $AdminConfig getObjectType $server
  • Avec Jython :
    server = AdminConfig.getid('/Node:mynode/Server:server1/')
    print AdminConfig.getObjectType(server)

getSaveMode

La commande getSaveMode renvoie le mode utilisé à l'appel d'une commande save. Cette commande renvoie une des valeurs possibles suivantes :
  • overwriteOnConflict - Sauvegarde les modifications même si elles sont en conflit avec d'autres modifications de configuration.
  • rollbackOnConflict - Provoque l'échec de l'opération de sauvegarde si les modifications sont en conflit avec d'autres modifications de configuration. Il s'agit de la valeur par défaut.

Objet cible

Aucun.

Paramètres requis

Aucun.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande renvoie une chaîne contenant le paramètre de mode de sauvegarde en cours, comme dans l'exemple suivant :
rollbackOnConflict

Exemples

  • Avec Jacl :
    $AdminConfig getSaveMode
  • Avec Jython :
    print AdminConfig.getSaveMode()

getValidationLevel

La commande getValidationLevel permet de renvoyer la validation utilisée lorsque des fichiers sont extraits du référentiel.

Objet cible

Aucun.

Paramètres requis

Aucun.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande renvoie une chaîne contenant le niveau de validation, comme dans l'exemple suivant :
WASX7189I: Validation level set to HIGH

Exemples

  • Avec Jacl :
    $AdminConfig getValidationLevel
  • Avec Jython :
    print AdminConfig.getValidationLevel()

getValidationSeverityResult

La commande getValidationSeverityResult permet de renvoyer le nombre de messages de validation ayant la gravité donnée de la dernière validation.

Objet cible

Aucun.

Paramètres requis

severity
Indique le niveau de gravité pour lequel renvoyer le nombre de messages de validation. Spécifiez un entier compris entre 0 et 9.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande renvoie une chaîne indiquant le nombre de messages de validation du niveau de gravité donné, comme dans l'exemple suivant :
16

Exemples

  • Avec Jacl :
    $AdminConfig getValidationSeverityResult 1
  • Avec Jython :
    print AdminConfig.getValidationSeverityResult(1)

hasChanges

La commande hasChanges permet de déterminer s'il existe des modifications de configuration non sauvegardées.

Objet cible

Aucun.

Paramètres requis

Aucun.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande renvoie 1 si des modifications de configuration non sauvegardées existent, ou 0 s'il n'existe aucune modification de configuration non sauvegardée, comme dans l'exemple suivant :
1

Exemples

  • Avec Jacl :
    $AdminConfig hasChanges
  • Avec Jython :
    print AdminConfig.hasChanges()

help

La commande help permet d'afficher des informations d'aide statiques relatives à l'objet AdminConfig.

Objet cible

Aucun.

Paramètres requis

Aucun.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande renvoie une liste d'options pour la commande help, comme dans l'exemple suivant :
WASX7053I: The AdminConfig object communicates with the configuration service in a product to manipulate 
configuration data for an Application Server installation.  The AdminConfig object has commands to list, 
create, remove, display, and modify configuration data, as well as commands to display information about 
configuration data types.

Most of the commands supported by the AdminConfig object operate in two modes: the default mode is one in which 
the AdminConfig object communicates with the Application Server to accomplish its tasks. A local mode is also 
possible, in which no server communication takes place.  The local mode of operation is invoked by bringing up 
the scripting client without a server connected using the command line "-conntype NONE" option or setting the 
"com.ibm.ws.scripting.connectionType=NONE" property in the wsadmin.properties file.

The following commands are supported by the AdminConfig object; more detailed information about each of these commands is 
available by using the help command of the AdminConfig object and by supplying the name of the command as an argument.

attributes      									Shows the attributes for a given type
checkin         									Checks a file into the configuration repository.
convertToCluster									Converts a server to be the first member of a new server cluster
create          									Creates a configuration object, given a type, a parent, and a list of attributes, and 
																optionally an attribute name for the new object
createClusterMember 							Creates a new server that is a member of an existing cluster.
createDocument  									Creates a new document in the configuration repository.
installResourceAdapter							Installs a J2C resource adapter with the given RAR file name and an option string in the node.
createUsingTemplate 							Creates an object using a particular template type.
defaults        									Displays the default values for the attributes of a given type.
deleteDocument  									Deletes a document from the configuration repository.
existsDocument  									Tests for the existence of a document in the configuration repository.
extract         									Extracts a file from the configuration repository.
getCrossDocumentValidationEnabled		Returns true if cross-document validation is enabled.
getid           									Show the configuration ID of an object, given a string version of its containment
getObjectName   									Given a configuration ID, returns a string version of the ObjectName 
																for the corresponding running MBean, if any.
getSaveMode     									Returns the mode used when "save" is invoked
getValidationLevel								Returns the validation that is used when files are extracted from the repository.
getValidationSeverityResult				Returns the number of messages of a given severity from the most recent validation.
hasChanges      									Returns true if unsaved configuration changes exist
help            									Shows help information
list            									Lists all the configuration objects of a given type
listTemplates   									Lists all the available configuration templates of a given type.
modify          									Changes the specified attributes of a given configuration object
parents         									Shows the objects which contain a given type
queryChanges    									Returns a list of unsaved files
remove          									Removes the specified configuration object
required        									Displays the required attributes of a given type.
reset           									Discards the unsaved configuration changes
save            									Commits the unsaved changes to the configuration repository
setCrossDocumentValidationEnabled		Sets the cross-document validation enabled mode.
setSaveMode     									Changes the mode used when "save" is invoked
setValidationLevel								Sets the validation used when files are extracted from the repository.
show            									Shows the attributes of a given configuration object
showall         									Recursively shows the attributes of a given configuration
                									object, and all the objects that are contained within each attribute.
showAttribute   									Displays only the value for the single attribute that is specified.
types           									Shows the possible types for configuration
validate        									Invokes validation

Exemples

  • Avec Jacl :
    $AdminConfig help
  • Avec Jython :
    print AdminConfig.help()

installResourceAdapter

La commande installResourceAdapter permet d'installer dans le noeud un adaptateur de ressource J2C (Java 2 Connector) avec le nom de fichier RAR (Resource Adapter Archive) donné et une chaîne d'option. Lorsque vous éditez l'application installée avec le fichier RAR intégré, seuls la fabrique de connexions J2C, les spécifications d'activation J2C et les objets d'administration J2C existants sont édités. Aucun nouvel objet J2C n'est créé.

Objet cible

Aucun.

Paramètres requis

node
Indique le noeud en question.
nom_fichier_RAR
Indique le nom qualifié complet du fichier RAR qui réside dans le noeud désigné.

Paramètres facultatifs

options
Indique d'autres options permettant d'installer un adaptateur de ressources. Les options admises sont les suivantes :
  • rar.name
  • rar.desc
  • rar.archivePath
  • rar.classpath
  • rar.nativePath
  • rar.threadPoolAlias
  • rar.propertiesSet
L'option rar.name est le nom de l'adaptateur de ressource J2C. Si vous ne précisez pas cette option, le nom affiché est celui du descripteur de déploiement RAR. S'il n'est pas spécifié non plus, le nom du fichier RAR est utilisé. L'option rar.desc et une description de J2CResourceAdapter.

L'option rar.archivePath indique le chemin où le fichier est extrait. Si vous ne précisez pas cette option, l'archive est extraite dans le répertoire $\{CONNECTOR_INSTALL_ROOT\}. L'option rar.classpath indique un autre chemin d'accès aux classes.

L'option rar.propertiesSet est construite de la manière suivante :
name String
value String
type String
*desc String
*required true/false 
* means the item is optional
Chaque attribut de la propriété est indiqué entre accolades. Une propriété est indiquée entre accolades {}. Vous pouvez spécifier plusieurs propriétés entre accolades {}.

Exemple de sortie

La commande renvoie l'ID configuration du nouvel objet J2CResourceAdapter, comme dans l'exemple suivant :
myResourceAdapter(cells/mycell/nodes/mynode|resources.xml#J2CResourceAdapter_1)

Exemples

  • Avec Jacl :
    [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    $AdminConfig installResourceAdapter /rar/mine.rar mynode{-rar.name myResourceAdapter 
    -rar.desc "My rar file"} 
    [Windows]
    $AdminConfig installResourceAdapter c:/rar/mine.rar mynode {-rar.name myResourceAdapter 
    -rar.desc "My rar file"}
  • Avec Jython :
    [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    print AdminConfig.installResourceAdapter('/rar/mine.rar', 'mynode', '[-rar.name myResourceAdapter 
    -rar.desc "My rar file"]')
    [Windows]
    print AdminConfig.installResourceAdapter('c:/rar/mine.rar', 'mynode', '[-rar.name myResourceAdapter 
    -rar.desc "My rar file"]') 
Pour ajouter une chaîne
resourceProperties (name=myName,value=myVal)
dans la configuration de l'adaptateur de ressources, exécutez les commandes suivantes :
  1. pSet = [['propertySet',[['resourceProperties',[[['name','myName'], ['type', 'String'], 
    ['value','myVal']]]]]]]
  2. [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    myRA =AdminConfig.installResourceAdapter('/query.rar','mynodeCellManager05',
    ['-rar.desc','mydesc'])
    [Windows]
    myRA =AdminConfig.installResourceAdapter('c:\query.rar','mynodeCellManager05',
    ['-rar.desc','mydesc'])
  3. AdminConfig.modify(myRA,pSet)

list

La commande list permet de renvoyer une liste d'objets d'un type donné ou d'affiner la requête de recherche en affectant un type et un parent sectorisé ou en affectant un type et un modèle de caractère générique (*) ou d'expression régulière Java (.*) dans la syntaxe de la commande afin de personnaliser la requête de recherche.

Objet cible

Aucun.

Paramètres requis

type_objet
Indique le nom du type d'objet. Le nom du type d'objet est basé sur les fichiers de configuration XML et ne doit pas obligatoirement être identique à celui qui s'affiche dans la console d'administration.

Paramètres facultatifs

scope
Indique des informations de requête de recherche supplémentaires à l'aide d'un parent sectorisé.
pattern
Indique des informations de requête de recherche supplémentaires à l'aide d'un modèle de caractère générique (*) ou d'expression Java régulière (.*).

Exemple de sortie

La commande renvoie une liste d'objets :
Db2JdbcDriver(cells/mycell/nodes/DefaultNode|resources.xml#JDBCProvider_1) 
Db2JdbcDriver(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#JDBCProvider_1) 
Db2JdbcDriver(cells/mycell/nodes/DefaultNode/servers/nodeAgent|resources.xml#JDBCProvider_1) 

Exemples

Les exemples suivants illustrent chaque objet de configuration du fournisseur JDBC :
  • Avec Jacl :
    $AdminConfig list JDBCProvider
  • Avec Jython :
    print AdminConfig.list('JDBCProvider')
    Remarque : Utilisez des guillemets simples ou doubles.
Les exemples suivants illustrent chaque objet de configuration du fournisseur JDBC en affectant un type d'objet et un modèle de caractère générique qui commencent par la chaîne derby :
  • Avec Jacl :
    $AdminConfig list JDBCProvider derby*
  • Avec Jython :
    print AdminConfig.list('JDBCProvider', 'derby*')

Vous pouvez utiliser des modèles d'expressions Java régulières et des modèles de caractères génériques pour préciser le nom de la commande pour la liste $AdminConfig, les types et les fonctions listTemplates.

Les exemples suivants illustrent chaque objet de configuration de serveur en affectant un type d'objet et un modèle d'expression Java qui commencent par la chaîne server1 :
  • Avec Jacl :
    $AdminConfig list Server server1.*
  • Avec Jython :
    print AdminConfig.list("Server", "server1.*")

Les exemples suivants illustrent chaque objet de configuration de serveur en affectant un type d'objet et un ID de configuration de portée parent :

  • Avec Jacl :
    $AdminConfig list Server myNode(cells/myCell/nodes/myNode|node.xml#Node_1)
  • Avec Jython :
    print AdminConfig.list("Server", "myNode(cells/myCell/nodes/myNode|node.xml#Node_1)")
Les exemples suivants illustrent chaque objet de configuration trouvé qui commence par SSLConfig:
  • Avec Jacl et des modèles d'expression Java régulières :
    $AdminConfig types SSLConfig.*
  • Ave Jacl et des modèles de caractères génériques :
    $AdminConfig types SSLConfig*
  • Avec Jython et des modèles d'expressions Java régulières :
    print AdminConfig.types("SSLConfig.*")
  • Avec Jython et des modèles de caractères génériques :
    print AdminConfig.types("SSLConfig*")

listTemplates

La commande listTemplates affiche la liste des ID objet modèle. Vous pouvez utiliser les caractères génériques (*) ou les expressions Java régulières (.*) dans la syntaxe de commande pour personnaliser la requête de recherche.

Objet cible

Aucun.

Paramètres requis

type_objet
Indique le nom du type d'objet. Le nom du type d'objet est basé sur les fichiers de configuration XML et ne doit pas obligatoirement être identique à celui qui s'affiche dans la console d'administration.
pattern
Indique d'autres informations de requête de recherche à l'aide de caractères génériques ou d'expressions Java régulières.

Paramètres facultatifs

Aucun.

Exemple de sortie

L'exemple suivant affiche la liste de tous les modèles de fournisseur JDBC disponibles sur le système :
"Derby JDBC Provider (XA)(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#builtin_jdbcprovider)"
"Derby JDBC Provider (XA)(templates/servertypes/APPLICATION_SERVER/servers/defaultZOS|resources.xml#builtin_jdbcprovider)"
"Derby JDBC Provider (XA)(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jdbcprovider)"
"Derby JDBC Provider (XA)(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)"
"Derby JDBC Provider 40 (XA)(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_2)"
"Derby JDBC Provider 40 Only (XA)(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_2)"
"Derby JDBC Provider 40 Only(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_1)"
"Derby JDBC Provider 40(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_1)"
"Derby JDBC Provider Only (XA)(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_4)"
"Derby JDBC Provider Only(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_3)"
"Derby JDBC Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#JDBCProvider_1124467079638)"
"Derby JDBC Provider(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_derby_3)" 

Exemples

Les exemples suivants renvoient chaque modèle de fournisseur JDBC :
  • Avec Jacl :
    $AdminConfig listTemplates JDBCProvider
  • Avec Jython :
    print AdminConfig.listTemplates('JDBCProvider')
Les exemples suivants renvoie chaque modèle de fournisseur JDBC qui commence par la chaîne sybase :
  • Avec Jacl :
    $AdminConfig listTemplates JDBCProvider sybase*
  • Avec Jython :
    print AdminConfig.listTemplates('JDBCProvider', 'sybase*')

modify

La commande modify permet de prendre en charge la modification des attributs d'objet.

Objet cible

Aucun.

Paramètres requis

ID_configuration
Indique l'ID configuration de l'objet à modifier.
attributes
Indique les attributs à modifier pour l'ID configuration concerné.

Paramètres facultatifs

Aucun.

Exemples

  • Avec Jacl :
    $AdminConfig modify ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#
    GenericJMSConnectionFactory_1) {{userID newID} {password newPW}}
  • A l'aide de Jython avec des attributs de chaîne :
    AdminConfig.modify('ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#
    GenericJMSConnectionFactory_1)', '[[userID newID] [password newPW]]')
  • A l'aide de Jython avec des attributs d'objet :
    AdminConfig.modify('ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#
    GenericJMSConnectionFactory_1)', [['userID', 'newID'], ['password', 'newPW']])

parents

La commande parents permet d'obtenir des informations relatives aux types d'objet.

Objet cible

Aucun.

Paramètres requis

type_objet
Indique le type d'objet qui vous intéresse. Le nom du type d'objet est basé sur les fichiers de configuration XML et ne doit pas obligatoirement être identique à celui qui s'affiche dans la console d'administration.

Paramètres facultatifs

Aucun.

Exemple de sortie

L'exemple suivant affiche une liste de types d'objet :
Cell
Node
Server

Exemples

  • Avec Jacl :
    $AdminConfig parents JDBCProvider
  • Avec Jython :
    print AdminConfig.parents('JDBCProvider')

queryChanges

La commande queryChanges renvoie la liste des fichiers de configuration non sauvegardés.

Objet cible

Aucun.

Paramètres requis

Aucun.

Paramètres facultatifs

Aucun.

Exemple de sortie

L'exemple suivant affiche une chaîne contenant la liste des fichiers ayant des modifications non sauvegardées :
WASX7146I: The following configuration files contain unsaved changes:
cells/mycell/nodes/mynode/servers/server1|resources.xml

Exemples

  • Avec Jacl :
    $AdminConfig queryChanges
  • Avec Jython :
    print AdminConfig.queryChanges()

remove

La commande remove permet de supprimer un objet de configuration.

Objet cible

Aucun.

Paramètres requis

ID_configuration
Indique l'objet de configuration qui vous intéresse.

Paramètres facultatifs

Aucun.

Exemples

  • Avec Jacl :
    set ds [$AdminConfig list DataSource "Default Datasource*"]
    $AdminConfig remove $ds
  • Avec Jython :
    ds = AdminConfig.list('DataSource', 'Default Datasource*')
    AdminConfig.remove(ds)

required

La commande required affiche les attributs obligatoires que contient un objet d'un type spécifique.

Objet cible

Aucun.

Paramètres requis

type
Indique le type d'objet pour lequel afficher les attributs obligatoires. Le nom du type d'objet est basé sur les fichiers de configuration XML. Ce n'est pas obligatoirement celui qu'affiche la console d'administration.

Paramètres facultatifs

Aucun.

Exemple de sortie

L'exemple suivant présente une chaîne contenant la liste des attributs obligatoires accompagnés de leur type :
Attribute                       Type
streamHandlerClassName          String
protocol                        String

Exemples

  • Avec Jacl :
    $AdminConfig required URLProvider
  • Avec Jython :
    print AdminConfig.required('URLProvider')

reset

La commande reset permet de réinitialiser l'espace de travail temporaire qui contient la configuration.

Objet cible

Aucun.

Paramètres requis

Aucun.

Paramètres facultatifs

Aucun.

Exemples

  • Avec Jacl :
    $AdminConfig reset
  • Avec Jython :
    AdminConfig.reset()

resetAttributes

Utilisez la commande resetAttributes pour réinitialiser des attributs spécifiques de l'objet de configuration impliqué.

Objet cible

Aucun.

Paramètres requis

ID_configuration
Précise l'ID configuration de l'objet de configuration impliqué.
attributes
Précise l'attribut à réinitialiser et la nouvelle valeur à lui accorder.

Paramètres facultatifs

Aucun.

Exemples

  • Avec Jacl :
    set ds [$AdminConfig list DataSource "Default Datasource*"]
    $AdminConfig resetAttributes $ds {{"description" "A new description for the data source"}}
  • Avec Jython :
    ds = AdminConfig.list('DataSource', 'Default Datasource*')
    AdminConfig.resetAttributes(ds, [["description", "A new description for the data source"]])

save

La commande save permet d'enregistrer les modifications apportées à la configuration.

Objet cible

Aucun.

Paramètres requis

Aucun.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande save ne renvoie pas de sortie.

Exemples

  • Avec Jacl :
    $AdminConfig save
  • Avec Jython :
    AdminConfig.save()

setCrossDocumentValidationEnabled

La commande setCrossDocumentValidationEnabled active le mode de validation interdocuments. Les valeurs incluent true ou false.

Objet cible

Aucun.

Paramètres requis

flag
Indique si la validation interdocuments est activée ou désactivée. Indiquez true pour activer la validation interdocuments, ou false pour la désactiver.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande renvoie une instruction d'état pour la validation interdocuments, comme dans l'exemple suivant :
WASX7188I: Cross-document validation enablement set to true

Exemples

  • Avec Jacl :
    $AdminConfig setCrossDocumentValidationEnabled true
  • Avec Jython :
    print AdminConfig.setCrossDocumentValidationEnabled('true')

setSaveMode

La commande setSaveMode permet de modifier le comportement de la commande save.

Objet cible

Aucun.

Paramètres requis

mode_sauvegarde
Indique le mode de sauvegarde à utiliser. La valeur par défaut est rollbackOnConflict. En cas de conflit lors d'une opération de sauvegarde, les modifications non sauvegardées ne sont pas validées. L'autre valeur est overwriteOnConflict, qui sauvegarde les modifications dans le référentiel de configuration même en cas de conflit. Pour utiliser overwriteOnConflict comme valeur de cette commande, la fonction de remplacement de la configuration du gestionnaire de déploiement doit être activée.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande setSaveMode ne renvoie pas de sortie.

Exemples

  • Avec Jacl :
    $AdminConfig setSaveMode overwriteOnConflict
  • Avec Jython :
    AdminConfig.setSaveMode('overwriteOnConflict')

setValidationLevel

La commande setValidationLevel permet de définir la validation utilisée lorsque des fichiers sont extraits du référentiel.

Objet cible

Aucun.

Paramètres requis

niveau
Indique le niveau de validation à utiliser. Il existe cinq niveaux de validation : none, low, medium, high ou highest.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande renvoie une chaîne contenant le niveau de validation, comme dans l'exemple suivant :
WASX7189I: Validation level set to HIGH

Exemples

  • Avec Jacl :
    $AdminConfig setValidationLevel high
  • Avec Jython :
    print AdminConfig.setValidationLevel('high')

show

La commande show renvoie les attributs de niveau supérieur de l'objet désigné.

Objet cible

Aucun.

Paramètres requis

ID_configuration
Indique l'ID configuration de l'objet en question.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande renvoie une chaîne contenant la valeur d'attribut, comme dans l'exemple suivant :
[name "Sample Datasource"] [description "Data source for the Sample entity beans"]

Exemples

  • Avec Jacl :
    $AdminConfig show Db2JdbcDriver(cells/mycell/nodes/DefaultNode|resources.xmlJDBCProvider_1)
  • Avec Jython :
    print AdminConfig.show('Db2JdbcDriver(cells/mycell/nodes/DefaultNode|resources.xmlJDBCProvider_1)')

showall

La commande showall permet l'affichage récursif des attributs d'un objet de configuration donné.

Objet cible

Aucun.

Paramètres requis

ID_configuration
Indique l'ID configuration de l'objet en question.

Paramètres facultatifs

Aucun.

Exemple de sortie

La commande renvoie une chaîne contenant la valeur d'attribut, comme dans les exemples suivants :

Avec Jacl :
tcpNoDelay: null
SoTimeout: 0
bytesRead: 6669
{authMechanismPreference BASIC_PASSWORD}
{connectionPool {{agedTimeout 0}
{connectionTimeout 180}
{freePoolDistributionTableSize 0}
{maxConnections 10}
{minConnections 1}
{numberOfFreePoolPartitions 0}
{numberOfSharedPoolPartitions 0}
{numberOfUnsharedPoolPartitions 0}
{properties {}}
{purgePolicy EntirePool}
{reapTime 180}
{stuckThreshold 0}
{stuckTime 0}
{stuckTimerTime 0}
{surgeCreationInterval 0}
{surgeThreshold -1}
{testConnection false}
{testConnectionInterval 0}
{unusedTimeout 1800}}}
{datasourceHelperClassname com.ibm.websphere.rsadapter.DerbyDataStoreHelper}
{description "Datasource for the WebSphere Default Application"}
{diagnoseConnectionUsage false}
{jndiName DefaultDatasource}
{logMissingTransactionContext true}
{manageCachedHandles false}
{name "Default Datasource"}
{properties {}}
{propertySet {{resourceProperties {{{name databaseName}
{required false}
{type java.lang.String}
{value ${APP_INSTALL_ROOT}/${CELL}/DefaultApplication.ear/DefaultDB}} {{name shu
tdownDatabase}
{required false}
{type java.lang.String}
{value {}}} {{name dataSourceName}
{required false}
{type java.lang.String}
{value {}}} {{name description}
{required false}
{type java.lang.String}
{value {}}} {{name connectionAttributes}
{required false}
{type java.lang.String}
{value upgrade=true}} {{name createDatabase}
{required false}
{type java.lang.String}
{value {}}}}}}}
{provider "Derby JDBC Provider(cells/isthmusCell04/nodes/isthmusNode14/servers/s
erver1|resources.xml#JDBCProvider_1183122153343)"}
{providerType "Derby JDBC Provider"}
{relationalResourceAdapter "WebSphere Relational Resource Adapter(cells/isthmusC
ell04/nodes/isthmusNode14/servers/server1|resources.xml#builtin_rra)"}
{statementCacheSize 10}
Avec Jython :
[datasourceHelperClassname com.ibm.websphere.rsadapter.DerbyDataStoreHelper]
[description "Datasource for the WebSphere Default Application"]
[jndiName DefaultDatasource]
[name "Default Datasource"]
[propertySet [[resourceProperties [[[description "Location of Apache Derby default database."]
[name databaseName]
[type string]
[value ${WAS_INSTALL_ROOT}/bin/DefaultDB]] [[name remoteDataSourceProtocol]
[type string]
[value []]] [[name shutdownDatabase]
[type string]
[value []]] [[name dataSourceName]
[type string]
[value []]] [[name description]
[type string]
[value []]] [[name connectionAttributes]
[type string]
[value []]] [[name createDatabase]
[type string]
[value []]]]]]]
[provider "Apache Derby JDBC Driver(cells/pongo/nodes/pongo/servers/server1|resources.xml#JDBCProvider_1)"]
[relationalResourceAdapter "WebSphere Relational Resource Adapter(cells/pongo/nodes/pongo/servers/server1|
resources.xml#builtin_rra)"]
[statementCacheSize 0]
Vous devrez convertir la chaîne de la sortie Jython en liste pour la suite du traitement.

Exemples

  • Avec Jacl :
    $AdminConfig showall "Default Datasource(cells/mycell/nodes/DefaultNode/servers/server1:resources.xml#DataSource_1)"
  • Avec Jython :
    print AdminConfig.showall
      ("Default Datasource(cells/mycell/nodes/DefaultNode/servers/server1:resources.xml#DataSource_1)")

showAttribute

La commande showAttribute affiche uniquement la valeur de l'unique attribut indiqué.

Objet cible

Aucun.

Paramètres requis

ID_configuration
Indique l'ID configuration de l'objet en question.
attribute
Indique l'attribut à interroger.

Paramètres facultatifs

Aucun.

Exemple de sortie

Le résultat de cette commande est différent de celui de la commande show avec spécification d'un unique attribut. La commande showAttribute n'affiche pas de liste contenant le nom et la valeur de l'attribut. Elle n'affiche que la valeur d'attribut, comme illustré dans l'exemple suivant :
mynode

Exemples

  • Avec Jacl :
    set ns [$AdminConfig getid /Node:mynode/]
    $AdminConfig showAttribute $ns hostName
  • Avec Jython :
    ns = AdminConfig.getid('/Node:mynode/')
    print AdminConfig.showAttribute(ns, 'hostName')
    Dans les versions antérieures à la version 7.0.0.5, le langage de script Jython ne reconnaît pas les caractères spéciaux. De plus, si une virgule ou un espace apparaît entre des paramètres d'attribut, ces caractères sont traités comme des délimiteurs, et ignorés lors de la sauvegarde de la valeur de l'attribut. Vous pouvez par exemple trouver la série de commandes Jython suivante :
    value='{"param1","param2"}'
    serverId=AdminConfig.getid('/Cell:cell_name/Node:node_name/Server:server_name')
    nameSpace=AdminConfig.create('StringNameSpaceBinding',serverId,[['name','TestName'],
    ['nameInSpace','TestNameSpace'],['stringToBind',value] ])
    vous pouvez utiliser la commande suivante pour afficher la valeur :
    print AdminConfig.showAttribute(nameSpace, 'stringToBind')
    ce qui produit le résultat suivant :
    {"param1" "param2"}
    Dans la version 7.0.0.5 et suivantes, le langage de script Jython reconnaît la virgule si elle est précédée d'une barre oblique inversée (\). Par exemple, dans la série de commandes Jython précédente, remplacez la première ligne par la commande suivante :
    value='{"param1"\,"param2"}'
    Quand vous affichez la valeur avec print, vous obtenez :
    {"param1","param2"}

types

Utilisez la commande types pour obtenir une liste de types d'objet de configuration que vous pouvez manipuler, ou personnalisez la requête de recherche en ajoutant un modèle de caractères génériques (*) ou d'expressions régulières Java (.*) supplémentaire dans la syntaxe de la commande.

Objet cible

Aucun.

Paramètres requis

Aucun.

Paramètres facultatifs

pattern
Indique des informations de requête de recherche supplémentaires à l'aide d'un modèle de caractère générique (*) ou d'expression Java régulière (.*).

Exemple de sortie

La commande renvoie une liste de types d'objet, comme dans l'exemple suivant :
AdminService
Agent
ApplicationConfig
ApplicationDeployment
ApplicationServer
AuthMechanism
AuthenticationTarget
AuthorizationConfig
AuthorizationProvider
AuthorizationTableImpl
BackupCluster
CMPConnectionFactory
CORBAObjectNameSpaceBinding
Cell
CellManager
Classloader
ClusterMember
ClusteredTarget
CommonSecureInteropComponent

Exemples

Les exemples suivants renvoient chaque type d'objet dans votre configuration :
  • Avec Jacl :
    $AdminConfig types
  • Avec Jython :
    print AdminConfig.types()
Les exemples suivants renvoient chaque type d'objet dans votre configuration qui contient un modèle de chaîne security supplémentaire :
  • Avec Jacl :
    $AdminConfig types *security*
  • Avec Jython :
    print AdminConfig.types('*security*')

uninstallResourceAdapter

La commande uninstallResourceAdapter permet de désinstaller un adaptateur de ressource J2C (Java 2 Connector) comportant un ID configuration d'adaptateur de ressource J2C et une liste d'options. Lorsque vous retirez un objet J2CResourceAdapter du référentiel de configuration, le répertoire installé est retiré au moment de la synchronisation. Une demande d'arrêt est envoyée au bean géré J2CResourceAdapter qui a été retiré.

Objet cible

Aucun.

Paramètres requis

ID_configuration
Indique l'ID configuration de l'adaptateur de ressource à supprimer.

Paramètres facultatifs

liste_options
Indique les options de désinstallation pour la commande. L'option admise est force. Cette option force la désinstallation de l'adaptateur de ressource sans vérifier si celui-ci est utilisé par une application. L'application qui l'utilise n'est pas désinstallée. Si vous n'indiquez pas l'option force et que l'adaptateur de ressource indiqué est toujours en cours d'utilisation, l'adaptateur de ressource n'est pas désinstallé.

Exemple de sortie

La commande renvoie l'ID configuration de l'adaptateur de ressources J2C qui est supprimé, comme dans l'exemple suivant :
WASX7397I: The following J2CResourceAdapter objects are removed: 
MyJ2CRA(cells/juniarti/nodes/juniarti|resources.xml#J2CResourceAdapter_1069433028609)

Exemples

  • Avec Jacl :
    set j2cra [$AdminConfig getid /J2CResourceAdapter:MyJ2CRA/]
    $AdminConfig uninstallResourceAdapter $j2cra {-force}
  • Avec Jython :
    j2cra = AdminConfig.getid('/J2CResourceAdapter:MyJ2CRA/')
    print AdminConfig.uninstallResourceAdapter(j2cra, '[-force]')

unsetAttributes

Utilisez la commande unsetAttributes pour réinitialiser des attributs spécifiques d'un objet de configuration à leurs valeurs par défaut.

Objet cible

Aucun.

Paramètres requis

ID_configuration
Précise l'ID configuration de l'objet de configuration impliqué.
attributes
Spécifie les attributs à réinitialiser à leurs valeurs par défaut.

Paramètres facultatifs

Aucun.

Exemples

  • Avec Jacl :
    set cluster [$AdminConfig getid /ServerCluster:myCluster]
    $AdminConfig unsetAttributes $cluster {"enableHA", "preferLocal"}
  • Avec Jython :
    cluster = AdminConfig.getid("/ServerCluster:myCluster")
    AdminConfig.unsetAttributes(cluster, ["enableHA", "preferLocal"])

validate

La commande validate demande les résultats de la validation de la configuration d'après les fichiers de l'espace de travail, la valeur de l'indicateur d'activation de la validation interdocuments et le niveau de validation fixé. Vous pouvez éventuellement spécifier un ID configuration pour définir la portée. Dans ce cas, la portée de cette demande est définie par l'objet désigné par le paramètre d'ID configuration.

Objet cible

Aucun.

Paramètres requis

Aucun.

Paramètres facultatifs

ID_configuration
Indique l'ID configuration de l'objet en question.

Exemple de sortie

La commande renvoie une chaîne contenant les résultats de la validation, comme dans l'exemple suivant :
WASX7193I: Validation results are logged in c:\WebSphere5\AppServer\logs\wsadmin.valout: Total number of messages: 16
WASX7194I: Number of messages of severity 1: 16

Exemples

  • Avec Jacl :
    $AdminConfig validate
  • Avec Jython :
    print AdminConfig.validate()

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_adminconfig1
Nom du fichier : rxml_adminconfig1.html