Befehle für das Objekt "AdminConfig" mit wsadmin-Scripting

attributes

Verwenden Sie den Befehl attributes, um eine Liste der Attribute der höchsten Ebene für einen bestimmten Typ zurückzugeben.

Zielobjekt

Erforderliche Parameter

Objekttyp

Gibt den Namen des Objekttyps an, der auf den XML-Konfigurationsdateien basiert. Der Objekttyp muss nicht zwangsläufig mit dem von der Administrationskonsole angezeigten Namen übereinstimmen.

Optionale Parameter

Beispielausgabe

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

Beispiele

• Mit Jacl:

  $AdminConfig attributes ApplicationServer

• Mit Jython:

  print AdminConfig.attributes('ApplicationServer')

checkin

Verwenden Sie den Befehl checkin, um eine Datei in das mit dem Dokument-URI angegebene Konfigurationsrepository einzuchecken. Diese Methode gilt nur für Konfigurationen des Deployment Manager.

Zielobjekt

Erforderliche Parameter

URI

Der Dokument-URI ist relativ zum Stammverzeichnis des Konfigurationsrepository, z. B.:

• Stammverzeichnis_des_Anwendungsservers\config
• /WebSphere/AppServer/config

Dateiname

Gibt den Namen der einzucheckenden Quellendatei an.

nicht transparentes Objekt

Gibt ein Objekt an, das vom Befehl extract des Objekts "AdminConfig" in einem früheren Aufruf zurückgegeben wurde.

Optionale Parameter

Beispielausgabe

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

Beispiele

• Mit Jacl:
  

  $AdminConfig checkin cells/MyCell/Node/MyNode/serverindex.xml /mydir/myfile $obj

  

  $AdminConfig checkin cells/MyCell/Node/MyNode/serverindex.xml c:\\mydir\myfile $obj

• Mit Jython:
  

  print AdminConfig.checkin('cells/MyCell/Node/MyNode/serverindex.xml', '/mydir/myfile',  obj)

  

  print AdminConfig.checkin('cells/MyCell/Node/MyNode/serverindex.xml', 'c:\mydir\myfile',  obj)

convertToCluster

Verwenden Sie den Befehl convertToCluster, um einen Server so zu konvertieren, dass er das erste Member eines neuen Server-Clusters ist.

Zielobjekt

Erforderliche Parameter

Server-ID

Die Konfigurations-ID des gewünschten Servers.

Clustername

Gibt den Namen des gewünschten Clusters an.

Optionale Parameter

Beispielausgabe

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

Beispiele

• Mit Jacl:

  set serverid [$AdminConfig getid /Server:myServer/]
  $AdminConfig convertToCluster $serverid myCluster

• Mit Jython:

  serverid = AdminConfig.getid('/Server:myServer/')
  print AdminConfig.convertToCluster(serverid, 'myCluster')

create

Verwenden Sie den Befehl create, um Konfigurationsobjekte zu erstellen.

Zielobjekt

Erforderliche Parameter

Typ

Gibt den Namen des Objekttyps an, der auf den XML-Konfigurationsdateien basiert. Dieser Parameterwert muss nicht zwangsläufig mit dem von der Administrationskonsole angezeigten Namen übereinstimmen.

übergeordnete ID

Gibt die Konfigurations-ID des übergeordneten Objekts an.

attributes

Gibt die Attribute an, die der Konfigurations-ID hinzugefügt werden sollen.

Optionale Parameter

Beispielausgabe

ds1(cells/mycell/nodes/DefaultNode/servers/server1|resources.xml#DataSource_6)

Beispiele

• Mit Jacl:

  set jdbc1 [$AdminConfig getid /JDBCProvider:jdbc1/]
  $AdminConfig create DataSource $jdbc1 {{name ds1}}

• Mit Jython unter Verwendung von Zeichenfolgeattributen:

  jdbc1 = AdminConfig.getid('/JDBCProvider:jdbc1/')
  print AdminConfig.create('DataSource', jdbc1, '[[name ds1]]')

• Mit Jython unter Verwendung von Objektattributen:

  jdbc1 = AdminConfig.getid('/JDBCProvider:jdbc1/')
  print AdminConfig.create('DataSource', jdbc1, [['name', 'ds1']])

• Verwenden Sie das folgende Beispiel zum Erstellen eines Ports:

  #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

Verwenden Sie den Befehl createClusterMember, um ein neues Serverobjekt auf dem mit dem Parameter "Knoten-ID" angegebenen Knoten zu erstellen. Der Server wird als neues Member des vorhandenen Clusters erstellt, der mit dem Parameter "Cluster-ID" angegeben wurde, und enthält Attribute, die mit dem Parameter "Memberattribute" angegeben wurden. Der Server wird anhand der Serverschablone, die mit dem Attribut "Schablonen-ID" angegeben wird, erstellt und enthält den mit dem Attribut "Membername" angegebenen Namen. Das Attribut "Membername" muss angegeben werden. Die Schablonenoptionen sind nur für das erste Cluster-Member verfügbar, das Sie erstellen. Alle Cluster-Member, die Sie nach dem ersten Member erstellen, sind identisch.

Zielobjekt

Erforderliche Parameter

Cluster-ID

Gibt die Konfigurations-ID des gewünschten Clusters an.

Knoten-ID

Gibt die Konfigurations-ID des gewünschten Knotens an.

Schablonen-ID

Gibt die zum Erstellen des Servers zu verwendende Schablonen-ID an.

Memberattribute

Gibt die Attribute an, die dem Cluster-Member hinzugefügt werden sollen. Das Attribut "memberName" ist erforderlich und definiert den Namen des zu erstellenden Cluster-Members.

Optionale Parameter

Beispielausgabe

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

Beispiele

• Mit Jacl:

  set clid [$AdminConfig getid /ServerCluster:myCluster/]
  set nodeid [$AdminConfig getid /Node:mynode/]
  $AdminConfig createClusterMember $clid $nodeid {{memberName newMem1} {weight 5}}

• Mit Jython unter Verwendung von Zeichenfolgeattributen:

  clid = AdminConfig.getid('/ServerCluster:myCluster/') 
  nodeid = AdminConfig.getid('/Node:mynode/')
  print AdminConfig.createClusterMember(clid, nodeid, '[[memberName newMem1] [weight 5]]')

• Mit Jython unter Verwendung von Objektattributen:

  clid = AdminConfig.getid('/ServerCluster:myCluster/') 
  nodeid = AdminConfig.getid('/Node:mynode/') 
  print AdminConfig.createClusterMember(clid, nodeid, [['memberName', 'newMem1'], ['weight', 5]])

createDocument

Verwenden Sie den Befehl createDocument, um ein neues Dokument im Konfigurationsrepository zu erstellen.

Zielobjekt

Erforderliche Parameter

Dokument-URI

Gibt den Namen des im Repository zu erstellenden Dokuments an.

Dateiname

Gibt einen gültigen lokalen Dateinamen für das zu erstellende Dokument an.

Optionale Parameter

Beispiele

• Mit Jacl:
  

  $AdminConfig createDocument cells/mycell/myfile.xml /mydir/myfile

  

  $AdminConfig createDocument cells/mycell/myfile.xml c:/mydir/myfile

• Mit Jython unter Verwendung von Zeichenfolgeattributen:
  

  AdminConfig.createDocument('cells/mycell/myfile.xml', 'c:/mydir/myfile')

  

  AdminConfig.createDocument('cells/mycell/myfile.xml', '/mydir/myfile')

createUsingTemplate

Verwenden Sie den Befehl createUsingTemplate, um unter Verwendung einer Schablone ein Objekt mit dem angegebenen übergeordneten Typ zu erstellen. Sie können diesen Befehl nur für die Erstellung eines Servers des Typs APPLICATION_SERVER verwenden. Wenn Sie einen Server eines anderen Typs als APPLICATION_SERVER erstellen möchten, verwenden Sie den Befehl createGenericServer oder den Befehl createWebServer.

Zielobjekt

Erforderliche Parameter

Typ

Gibt den Typ des zu erstellenden Objekts an.

Übergeordnete ID

Gibt die Konfigurations-ID des übergeordneten Objekts an.

template

Gibt die Konfigurations-ID eines vorhandenen Objekts an. Dieses Objekt kann ein Schablonenobjekt sein, das vom Befehl "listTemplates" zurückgegeben wird, oder jedes andere vorhandene Objekt des richtigen Typs.

Optionale Parameter

attributes

Gibt Attributwerte für das Objekt an. Die mit diesem Parameter angegebenen Attribute überschreiben die Einstellungen in der Schablone.

Beispielausgabe

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

Beispiele

• Mit Jacl:

  set node [$AdminConfig getid /Node:mynode/]
  set templ [$AdminConfig listTemplates JDBCProvider "DB2 JDBC Provider (XA)"]
  $AdminConfig createUsingTemplate JDBCProvider $node {{name newdriver}} $templ 
  

• Mit Jython unter Verwendung von Zeichenfolgeattributen:

  node = AdminConfig.getid('/Node:mynode/')
  templ = AdminConfig.listTemplates('JDBCProvider', "DB2 JDBC Provider (XA)")
  print AdminConfig.createUsingTemplate('JDBCProvider', node, '[[name newdriver]]', templ)

• Mit Jython unter Verwendung von Objektattributen:

  node = AdminConfig.getid('/Node:mynode/')
  templ = AdminConfig.listTemplates('JDBCProvider', "DB2 JDBC Provider (XA)")
  print AdminConfig.createUsingTemplate('JDBCProvider', node, [['name', 'newdriver']], templ)

defaults

Verwenden Sie den Befehl defaults, um die Standardwerte für die Attribute eines bestimmten Typs anzuzeigen. Diese Methode zeigt alle möglichen Attribute, die in einem Objekt eines bestimmten Typs enthalten sind, an. Wenn das Attribut einen Standardwert hat, zeigt diese Methode auch den Typ und den Standardwert für jedes Attribut an.

Zielobjekt

Erforderliche Parameter

Typ

Gibt den Typ des zu zurückzugebenden Objekts an. Der Name des angegebenen Objekttyps basiert auf den XML-Konfigurationsdateien. Dieser Name muss nicht zwangsläufig mit dem von der Administrationskonsole angezeigten Namen übereinstimmen.

Optionale Parameter

Beispielausgabe

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

Beispiele

• Mit Jacl:

  $AdminConfig defaults TuningParams

• Mit Jython:

  print AdminConfig.defaults('TuningParams')

deleteDocument

Verwenden Sie den Befehl deleteDocument, um ein Dokument aus dem Konfigurationsrepository zu löschen.

Zielobjekt

Erforderliche Parameter

documentURI

Gibt das aus dem Repository zu löschende Dokument an.

Optionale Parameter

Beispiele

• Mit Jacl:

  $AdminConfig deleteDocument cells/mycell/myfile.xml

• Mit Jython:

  AdminConfig.deleteDocument('cells/mycell/myfile.xml')

existsDocument

Verwenden Sie den Befehl existsDocument, um zu prüfen, ob ein Dokument im Konfigurationsrepository enthalten ist.

Zielobjekt

Erforderliche Parameter

documentURI

Gibt das Dokument an, nach dem im Repository gesucht werden soll.

Optionale Parameter

Beispielausgabe

1

Beispiele

• Mit Jacl:

  $AdminConfig existsDocument cells/mycell/myfile.xml

• Mit Jython:

  print AdminConfig.existsDocument('cells/mycell/myfile.xml')

extract

Verwenden Sie den Befehl extract , um eine Konfigurationsrepositorydatei zu extrahieren, die vom Dokument-URI beschrieben wird, und in die Datei mit dem Namen filenamezu stellen. Diese Methode gilt nur für Konfigurationen des Deployment Manager.

Zielobjekt

Erforderliche Parameter

documentURI

Gibt das aus dem Konfigurationsrepository zu extrahierende Dokument an. Der Dokument-URI muss im Repository vorhanden sein. Der Dokument-URI ist relativ zum Stammverzeichnis des Konfigurationsrepository, z. B.:

• /WebSphere/AppServer/config
• Stammverzeichnis_des_Anwendungsservers\config

Dateiname

Gibt den Namen der Datei an, in die das Dokument extrahiert werden soll. Der Dateiname muss der Name einer gültigen Datei sein, in die der Inhalt des Dokuments geschrieben wird. Wenn die vom Parameter "Dateiname" angegebene Datei vorhanden ist, wird sie durch die extrahierte Datei ersetzt.

Optionale Parameter

Beispielausgabe

Der Befehl gibt ein nicht transparentes "Digest"-Objekt zurück, das mit dem Befehl checkin wieder eingecheckt werden soll.

Beispiele

• Mit Jacl:
  

  set obj [$AdminConfig extract cells/MyCell/nodes/MyNode/serverindex.xml /mydir/myfile] 
  

  

  set obj [$AdminConfig extract cells/MyCell/nodes/MyNode/serverindex.xml c:\\mydir\myfile] 
  

• Mit Jython:
  

  obj = AdminConfig.extract('cells/MyCell/nodes/MyNode/serverindex.xml','/mydir/myfile')

  

  obj = AdminConfig.extract('cells/MyCell/nodes/MyNode/serverindex.xml','c:\mydir\myfile')

getCrossDocumentValidationEnabled

Verwenden Sie den Befehl getCrossDocumentValidationEnabled, um eine Nachricht mit der aktuellen Einstellung für dokumentübergreifende Aktivierung zurückzugeben. Diese Methode gibt den Wert "true" zurück, wenn die dokumentenübergreifende Validierung aktiviert ist.

Zielobjekt

Erforderliche Parameter

Ohne

Optionale Parameter

Ohne

Beispielausgabe

WASX7188I: Cross-document validation enablement set to true

Beispiele

• Mit Jacl:

  $AdminConfig getCrossDocumentValidationEnabled

• Mit Jython:

  print AdminConfig.getCrossDocumentValidationEnabled()

getid

Verwenden Sie den Befehl getid, um die Konfigurations-ID eines Objekts zurückzugeben.

Zielobjekt

Erforderliche Parameter

Optionale Parameter

Ohne

Beispielausgabe

Db2JdbcDriver(cells/testcell/nodes/testnode|resources.xml#JDBCProvider_1)

Beispiele

• Mit Jacl:

  $AdminConfig getid /Cell:testcell/Node:testNode/JDBCProvider:Db2JdbcDriver/

• Mit Jython:

  print AdminConfig.getid('/Cell:testcell/Node:testNode/JDBCProvider:Db2JdbcDriver/')

getObjectName

Verwenden Sie den Befehl getObjectName, um eine Zeichenfolgeversion des Objektnamens für die entsprechende aktive MBean zurückzugeben. Diese Methode gibt eine leere Zeichenfolge zurück, wenn keine entsprechende aktive MBean vorhanden ist.

Zielobjekt

Erforderliche Parameter

Optionale Parameter

Ohne

Beispielausgabe

WebSphere:cell=mycell,name=server1,mbeanIdentifier=cells/mycell/nodes/mynode/servers/server1/
server.xml#Server_1,type=Server,node=mynode,process=server1,processType=UnManagedProcess

Beispiele

• Mit Jacl:

  set server [$AdminConfig getid /Node:mynode/Server:server1/]
  $AdminConfig getObjectName $server

• Mit Jython:

  server = AdminConfig.getid('/Node:mynode/Server:server1/')
  print AdminConfig.getObjectName(server)

getObjectType

Der Befehl getObjectType zeigt den Objekttyp für die gewünschte Objektkonfigurations-ID an.

Zielobjekt

Erforderliche Parameter

Optionale Parameter

Ohne

Beispiele

• Mit Jacl:

  set server [$AdminConfig getid /Node:mynode/Server:server1/]
  $AdminConfig getObjectType $server

• Mit Jython:

  server = AdminConfig.getid('/Node:mynode/Server:server1/')
  print AdminConfig.getObjectType(server)

getSaveMode

Zielobjekt

Erforderliche Parameter

Ohne

Optionale Parameter

Ohne

Beispielausgabe

rollbackOnConflict

Beispiele

• Mit Jacl:

  $AdminConfig getSaveMode

• Mit Jython:

  print AdminConfig.getSaveMode()

getValidationLevel

Verwenden Sie den Befehl getValidationLevel, um die Validierung zurückzugeben, die verwendet wird, wenn Dateien aus dem Repository extrahiert werden.

Zielobjekt

Erforderliche Parameter

Ohne

Optionale Parameter

Ohne

Beispielausgabe

WASX7189I: Validation level set to HIGH

Beispiele

• Mit Jacl:

  $AdminConfig getValidationLevel

• Mit Jython:

  print AdminConfig.getValidationLevel()

getValidationSeverityResult

Verwenden Sie den Befehl getValidationSeverityResult, um die Anzahl der Validierungsnachrichten mit der angegebenen Bewertung aus der aktuellen Validierung zurückzugeben.

Zielobjekt

Erforderliche Parameter

Optionale Parameter

Ohne

Beispielausgabe

16

Beispiele

• Mit Jacl:

  $AdminConfig getValidationSeverityResult 1

• Mit Jython:

  print AdminConfig.getValidationSeverityResult(1)

hasChanges

Verwenden Sie den Befehl hasChanges, um festzustellen, ob nicht gespeicherte Konfigurationsänderungen vorhanden sind.

Zielobjekt

Erforderliche Parameter

Ohne

Optionale Parameter

Ohne

Beispielausgabe

1

Beispiele

• Mit Jacl:

  $AdminConfig hasChanges

• Mit Jython:

  print AdminConfig.hasChanges()

Hilfe

Verwenden Sie den Befehl help, um statischen Hilfetext für das Objekt "AdminConfig" anzuzeigen.

Zielobjekt

Erforderliche Parameter

Ohne

Optionale Parameter

Ohne

Beispielausgabe

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

Beispiele

• Mit Jacl:

  $AdminConfig help

• Mit Jython:

  print AdminConfig.help()

installResourceAdapter

Verwenden Sie den Befehl installResourceAdapter, um einen J2C-Ressourcenadapter (Java 2 Connector) mit dem angegebenen RAR-Dateiennamen (Resource Adapter Archive) und einer Optionszeichenfolge auf dem Knoten zu installieren. Wenn Sie die installierte Anwendung mit dem integriertem RAR editieren, werden nur die vorhandene J2C-Verbindungsfactory, die J2C-Aktivierungsspezifikationen und die J2C-Verwaltungsobjekte editiert. Es werden keine neuen J2C-Objekte erstellt.

Zielobjekt

Erforderliche Parameter

Knoten

Gibt den gewünschten Knoten an.

Name der RAR-Datei

Gibt den vollständig qualifizierten Dateinamen der RAR-Datei auf dem angegebenen Knoten an.

Optionale Parameter

Optionen

Gibt zusätzliche Optionen für die Installation eines Ressourcenadapters an. Die gültigen Optionen lauten wie folgt:

• rar.name
• rar.desc
• rar.archivePath
• rar.classpath
• rar.nativePath
• rar.threadPoolAlias
• rar.propertiesSet

Mit der Option rar.name wird der Name des J2C-Ressourcenadapters festgelegt. Wenn Sie diese Option nicht angeben, wird der Anzeigename im RAR-Implementierungsdeskriptor verwendet. Ist kein Anzeigenname definiert, wird der Name der RAR-Datei verwendet. Die Option rar.desc ist eine Beschreibung des J2C-Ressourcenadapters.

Mit rar.archivePath wird der Name des Pfades, unter dem die Datei extrahiert werden soll, angegeben. Wenn Sie diese Option nicht angeben, wird das Archiv in das Verzeichnis $\{CONNECTOR_INSTALL_ROOT\} extrahiert. Die Option rar.classpath bezeichnet den zusätzlichen Klassenpfad.

rar.propertiesSet wird aus folgenden Elementen gebildet:

name String
value String
type String
*desc String
*required true/false 
* means the item is optional

Jedes Attribut der Eigenschaft wird in einer Gruppe von {} angegeben. Eine Eigenschaft wird in einer Gruppe von {} angegeben. In {}können Sie mehrere Eigenschaften angeben.

Beispielausgabe

myResourceAdapter(cells/mycell/nodes/mynode|resources.xml#J2CResourceAdapter_1)

Beispiele

• Mit Jacl:
  

  $AdminConfig installResourceAdapter /rar/mine.rar mynode{-rar.name myResourceAdapter 
  -rar.desc "My rar file"} 

  

  $AdminConfig installResourceAdapter c:/rar/mine.rar mynode {-rar.name myResourceAdapter 
  -rar.desc "My rar file"}

• Mit Jython:
  

  print AdminConfig.installResourceAdapter('/rar/mine.rar', 'mynode', '[-rar.name myResourceAdapter 
  -rar.desc "My rar file"]')

  

  print AdminConfig.installResourceAdapter('c:/rar/mine.rar', 'mynode', '[-rar.name myResourceAdapter 
  -rar.desc "My rar file"]') 
  

resourceProperties (name=myName,value=myVal)

Liste

Verwenden Sie den Befehl list, um eine Liste mit Objekten eines bestimmten Typs zurückzugeben, oder passen Sie die Suchabfrage an, indem Sie einen Typ und ein übergeordnetes Element bzw. einen Typ und ein Platzhalterzeichen (*) oder einen regulären Java-Ausdruck (.*) in der Befehlssyntax angeben.

Zielobjekt

Erforderliche Parameter

Optionale Parameter

Beispielausgabe

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) 

Beispiele

Sie können Muster mit regulären Java-Ausdrücken und Platzhalterzeichen verwenden, um den Befehlsnamen für die $AdminConfig-Funktionen "list", "types" und "listTemplates" anzugeben.

In den folgenden Beispielbefehlen werden die Serverkonfigurationsobjekte durch Angabe eines Objekttyps und der Konfigurations-ID eines übergeordneten Elements aufgelistet:

• Mit Jacl:

  $AdminConfig list Server myNode(cells/myCell/nodes/myNode|node.xml#Node_1)

• Mit Jython:

  print AdminConfig.list("Server", "myNode(cells/myCell/nodes/myNode|node.xml#Node_1)")

listTemplates

Verwenden Sie den Befehl listTemplates, um eine Liste mit Schablonenobjekt-IDs anzuzeigen. Sie können Platzhalterzeichen (*) oder reguläre Java-Ausdrücke (.*) in der Befehlssyntax verwenden, um die Suchabfrage anzupassen.

Zielobjekt

Erforderliche Parameter

Objekttyp

Gibt den Namen des Objekttyps an. Der Name des Objekttyps basiert auf den XML-Konfigurationsdateien und muss nicht zwangsläufig mit dem Namen identisch sein, der in der Administrationskonsole angezeigt wird.

pattern

Gibt weitere Informationen für die Suchabfrage mit Platzhalterzeichen oder regulären Java-Ausdrücken an.

Optionale Parameter

Beispielausgabe

"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)" 

Beispiele

modify

Verwenden Sie den Befehl modify, um die Änderung von Objektattributen zu unterstützen.

Zielobjekt

Erforderliche Parameter

Konfigurations-ID

Gibt die Konfigurations-ID des zu ändernden Objekts an.

attributes

Gibt die für die gewünschte Konfigurations-ID zu ändernden Attribute an.

Optionale Parameter

Beispiele

• Mit Jacl:

  $AdminConfig modify ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#
  GenericJMSConnectionFactory_1) {{userID newID} {password newPW}}

• Mit Jython unter Verwendung von Zeichenfolgeattributen:

  AdminConfig.modify('ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#
  GenericJMSConnectionFactory_1)', '[[userID newID] [password newPW]]')
  

• Mit Jython unter Verwendung von Objektattributen:

  AdminConfig.modify('ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#
  GenericJMSConnectionFactory_1)', [['userID', 'newID'], ['password', 'newPW']])

parents

Verwenden Sie den Befehl parents, um Informationen zu Objekttypen abzurufen.

Zielobjekt

Erforderliche Parameter

Objekttyp

Gibt den gewünschten Objekttyp an. Der Name des Objekttyps basiert auf den XML-Konfigurationsdateien und muss nicht zwangsläufig mit dem Namen identisch sein, der in der Administrationskonsole angezeigt wird.

Optionale Parameter

Beispielausgabe

Cell
Node
Server

Beispiele

• Mit Jacl:

  $AdminConfig parents JDBCProvider

• Mit Jython:

  print AdminConfig.parents('JDBCProvider')

queryChanges

Verwenden Sie den Befehl queryChanges, um eine Liste der nicht gespeicherten Konfigurationsdateien zurückzugeben.

Zielobjekt

Erforderliche Parameter

Optionale Parameter

Beispielausgabe

WASX7146I: The following configuration files contain unsaved changes:
cells/mycell/nodes/mynode/servers/server1|resources.xml

Beispiele

• Mit Jacl:

  $AdminConfig queryChanges

• Mit Jython:

  print AdminConfig.queryChanges()

entfernen

Verwenden Sie den Befehl remove, um ein Konfigurationsobjekt zu entfernen.

Zielobjekt

Erforderliche Parameter

Konfigurations-ID

Gibt das gewünschte Konfigurationsobjekt an.

Optionale Parameter

Beispiele

• Mit Jacl:

  set ds [$AdminConfig list DataSource "Default Datasource*"]
  $AdminConfig remove $ds

• Mit Jython:

  ds = AdminConfig.list('DataSource', 'Default Datasource*')
  AdminConfig.remove(ds)

required

Verwenden Sie den Befehl required, um die erforderlichen Attribute anzuzeigen, die in einem Objekt eines bestimmten Typs enthalten sind.

Zielobjekt

Erforderliche Parameter

Typ

Gibt den Objekttyp an, für den die erforderlichen Attribute angezeigt werden sollen. Der Name des Objekttyps basiert auf den XML-Konfigurationsdateien. Der Name muss nicht zwangsläufig mit dem von der Administrationskonsole angezeigten Namen übereinstimmen.

Optionale Parameter

Beispielausgabe

Attribute                       Type
streamHandlerClassName          String
protocol                        String

Beispiele

• Mit Jacl:

  $AdminConfig required URLProvider

• Mit Jython:

  print AdminConfig.required('URLProvider')

reset

Verwenden Sie den Befehl reset, um den temporären Arbeitsbereich zurückzusetzen, der Aktualisierungen für die Konfiguration enthält.

Zielobjekt

Erforderliche Parameter

Optionale Parameter

Beispiele

• Mit Jacl:

  $AdminConfig reset

• Mit Jython:

  AdminConfig.reset()

resetAttributes

Verwenden Sie den Befehl resetAttributes, um bestimmte Attribute für das gewünschte Konfigurationsobjekt zurückzusetzen.

Zielobjekt

Erforderliche Parameter

Konfigurations-ID

Gibt die Konfigurations-ID des gewünschten Konfigurationsobjekts zurück.

attributes

Gibt das zurückzusetzende Attribut und den Wert an, auf den das Attribut zurückgesetzt werden soll.

Optionale Parameter

Beispiele

• Mit Jacl:

  set ds [$AdminConfig list DataSource "Default Datasource*"]
  $AdminConfig resetAttributes $ds {{"description" "A new description for the data source"}}

• Mit Jython:

  ds = AdminConfig.list('DataSource', 'Default Datasource*')
  AdminConfig.resetAttributes(ds, [["description", "A new description for the data source"]])

save

Verwenden Sie den Befehl save, um Änderungen am Konfigurationsrepository zu speichern.

Zielobjekt

Erforderliche Parameter

Optionale Parameter

Beispielausgabe

Der Befehl save gibt keine Ausgabe zurück.

Beispiele

• Mit Jacl:

  $AdminConfig save

• Mit Jython:

  AdminConfig.save()

setCrossDocumentValidationEnabled

Verwenden Sie den Befehl setCrossDocumentValidationEnabled, um den Modus für dokumentübergreifende Validierung zu aktivieren. Der gültigen Werte lauten true und false.

Zielobjekt

Erforderliche Parameter

Flag

Gibt an, ob die dokumentübergreifende Validierung aktiviert oder inaktiviert wird. Geben Sie true für die Aktivierung oder false für die Inaktivierung der dokumentübergreifenden Validierung an.

Optionale Parameter

Beispielausgabe

WASX7188I: Cross-document validation enablement set to true

Beispiele

• Mit Jacl:

  $AdminConfig setCrossDocumentValidationEnabled true

• Mit Jython:

  print AdminConfig.setCrossDocumentValidationEnabled('true')

setSaveMode

Verwenden Sie den Befehl setSaveMode, um das Verhalten des Befehls save zu ändern.

Zielobjekt

Erforderliche Parameter

Speichermodus

Gibt den zu verwendenden Speichermodus an. Der Standardwert ist rollbackOnConflict. Wenn das System beim Speichern einen Konflikt feststellt, werden die nicht gespeicherten Änderungen nicht festgeschrieben. Der Alternativwert, mit dem Änderungen im Konfigurationsrepository selbst bei Konflikten gespeichert werden, ist overwriteOnConflict. Wenn Sie overwriteOnConflict als Wert für diesen Befehl verwenden möchten, muss der Deployment Manager das Überschreiben der Konfiguration unterstützen.

Optionale Parameter

Beispielausgabe

Der Befehl setSaveMode gibt keine Ausgabe zurück.

Beispiele

• Mit Jacl:

  $AdminConfig setSaveMode overwriteOnConflict

• Mit Jython:

  AdminConfig.setSaveMode('overwriteOnConflict')

setValidationLevel

Verwenden Sie den Befehl setValidationLevel, um die Validierung festzulegen, die beim Extrahieren von Dateien aus dem Repository verwendet wird.

Zielobjekt

Erforderliche Parameter

level

Gibt die zu verwendende Validierung an. Es sind fünf Validierungsstufen verfügbar: none, low, medium, highoder highest.

Optionale Parameter

Beispielausgabe

WASX7189I: Validation level set to HIGH

Beispiele

• Mit Jacl:

  $AdminConfig setValidationLevel high

• Mit Jython:

  print AdminConfig.setValidationLevel('high')

show

Verwenden Sie den Befehl show, um die Attribute der obersten Ebene des angegebenen Objekts zurückzugeben.

Zielobjekt

Erforderliche Parameter

Konfigurations-ID

Gibt die Konfigurations-ID des gewünschten Objekts zurück.

Optionale Parameter

Beispielausgabe

[name "Sample Datasource"] [description "Data source for the Sample entity beans"]

Beispiele

• Mit Jacl:

  $AdminConfig show Db2JdbcDriver(cells/mycell/nodes/DefaultNode|resources.xmlJDBCProvider_1)

• Mit Jython:

  print AdminConfig.show('Db2JdbcDriver(cells/mycell/nodes/DefaultNode|resources.xmlJDBCProvider_1)')

showall

Verwenden Sie den Befehl showall, um die Attribute eines bestimmten Konfigurationsobjekts rekursiv anzuzeigen.

Zielobjekt

Erforderliche Parameter

Konfigurations-ID

Gibt die Konfigurations-ID des gewünschten Objekts zurück.

Optionale Parameter

Beispielausgabe

Der Befehl gibt eine Zeichenfolge zurück, die den Attributwert enthält. Beispiel:

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}

[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]

Beispiele

• Mit Jacl:

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

• Mit Jython:

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

showAttribute

Verwenden Sie den Befehl showAttribute, um nur den Wert für das angegebene Attribut anzuzeigen.

Zielobjekt

Erforderliche Parameter

Konfigurations-ID

Gibt die Konfigurations-ID des gewünschten Objekts zurück.

attribute

Gibt das abzufragende Attribut an.

Optionale Parameter

Beispielausgabe

mynode

Beispiele

• Mit Jacl:

  set ns [$AdminConfig getid /Node:mynode/]
  $AdminConfig showAttribute $ns hostName

• Mit Jython:

  ns = AdminConfig.getid('/Node:mynode/')
  print AdminConfig.showAttribute(ns, 'hostName')

  In den Versionen vor Version 7.0.0.5 erkennt die Scripting-Sprache Jython noch keine Sonderzeichen. Außerdem werden Kommas und einzelne Leerzeichen zwischen Attributparametern als Begrenzungszeichen behandelt und beim Speichern des Attributswerts ignoriert. Sie könnten beispielsweise den folgenden Satz an Jython-Befehlen haben:

  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] ])

  Zur Ausgabe des Werts können Sie den folgenden Befehl verwenden:

  print AdminConfig.showAttribute(nameSpace, 'stringToBind')

  Das Ergebnis ist die folgende Ausgabe:

  {"param1" "param2"}

  In Version 7.0.0.5 und höher erkennt die Scripting-Sprache Jython das Komma, wenn Sie ihm ein Backslash-Zeichen (\) voranstellen. Ändern Sie beispielsweise in der ursprünglichen Beispielgruppe von Jython-Befehlen die erste Zeile in den folgenden Befehl:

  value='{"param1"\,"param2"}'

  Wenn Sie den Wert ausgeben, wird Folgendes zurückgegeben:

  {"param1","param2"}

types

Verwenden Sie den Befehl types, um eine Liste mit Konfigurationsobjekten eines bestimmten Typs zurückzugeben, die Sie bearbeiten können, oder passen Sie die Suchabfrage an, indem Sie ein Muster mit zusätzlichen Platzhalterzeichen (*) oder regulären Java-Ausdrücken (.*) in der Befehlssyntax angeben.

Zielobjekt

Erforderliche Parameter

Optionale Parameter

Beispielausgabe

AdminService
Agent
ApplicationConfig
ApplicationDeployment
ApplicationServer
AuthMechanism
AuthenticationTarget
AuthorizationConfig
AuthorizationProvider
AuthorizationTableImpl
BackupCluster
CMPConnectionFactory
CORBAObjectNameSpaceBinding
Cell
CellManager
Classloader
ClusterMember
ClusteredTarget
CommonSecureInteropComponent

Beispiele

uninstallResourceAdapter

Verwenden Sie den Befehl uninstallResourceAdapter, um einen J2C-Ressourcenadapter (Java 2 Connector) mit der angegebenen Konfigurations-ID und einer Optionsliste zu deinstallieren. Wenn Sie ein J2CResourceAdapter-Objekt aus dem Konfigurationsrepository entfernen, wird das installierte Verzeichnis während der Synchronisation entfernt. Es wird eine Stoppanforderung an die MBean J2CResourceAdapter gesendet, die entfernt wurde.

Zielobjekt

Erforderliche Parameter

Konfigurations-ID

Gibt die Konfigurations-ID des zu entfernenden Ressourcenadapters an.

Optionale Parameter

Optionsliste

Gibt die Deinstallationsoptionen für den Befehl an. Die gültige Option ist force. Diese Option erzwingt die Deinstallation des Ressourcenadapters, ohne dass geprüft wird, ob der Ressourcenadapter von einer Anwendung geprüft wird. Die Anwendung, die den Ressourcenadapter verwendet, wird nicht deinstalliert. Wenn Sie die Option force nicht angeben und der angegebene Ressourcenadapter noch verwendet wird, wird der Ressourcenadapter nicht deinstalliert.

Beispielausgabe

WASX7397I: The following J2CResourceAdapter objects are removed: 
MyJ2CRA(cells/juniarti/nodes/juniarti|resources.xml#J2CResourceAdapter_1069433028609)

Beispiele

• Mit Jacl:

  set j2cra [$AdminConfig getid /J2CResourceAdapter:MyJ2CRA/]
  $AdminConfig uninstallResourceAdapter $j2cra {-force}

• Mit Jython:

  j2cra = AdminConfig.getid('/J2CResourceAdapter:MyJ2CRA/')
  print AdminConfig.uninstallResourceAdapter(j2cra, '[-force]')

unsetAttributes

Verwenden Sie den Befehl unsetAttributes, um bestimmte Attribute für ein Konfigurationsobjekt auf die Standardwerte zurückzusetzen.

Zielobjekt

Erforderliche Parameter

Konfigurations-ID

Gibt die Konfigurations-ID des gewünschten Konfigurationsobjekts zurück.

attributes

Gibt die Attribute an, die auf die Standardwerte zurückgesetzt werden sollen.

Optionale Parameter

Beispiele

• Mit Jacl:

  set cluster [$AdminConfig getid /ServerCluster:myCluster]
  $AdminConfig unsetAttributes $cluster {"enableHA", "preferLocal"}

• Mit Jython:

  cluster = AdminConfig.getid("/ServerCluster:myCluster")
  AdminConfig.unsetAttributes(cluster, ["enableHA", "preferLocal"])

validate

Verwenden Sie den Befehl validate, um die Ergebnisse der Konfigurationsvalidierung, die auf den Dateien im Arbeitsbereich, dem Wert des Flags für die Aktivierung der dokumentübergreifenden Validierung und der Einstellung für die Validierungsstufe basieren, anzufordern. Optional können Sie eine Konfigurations-ID angeben, um den Geltungsbereich festzulegen. Wenn Sie eine Konfigurations-ID angeben, ist der Geltungsbereich dieser Anforderung das für den Parameter "Konfigurations-ID" angegebene Objekt.

Zielobjekt

Erforderliche Parameter

Optionale Parameter

Konfigurations-ID

Gibt die Konfigurations-ID des gewünschten Objekts zurück.

Beispielausgabe

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

Beispiele

• Mit Jacl:

  $AdminConfig validate

• Mit Jython:

  print AdminConfig.validate()