Java properties of wsadmin

The wsadmin scripting client uses the Java properties listed below. These properties are specified in the wsadmin.properties file, which is located in this directory:

• WebSphere Application Server: /QIBM/UserData/WebAS5/Base/instance/properties
• WebSphere Application Server Network Deployment: /QIBM/ProdData/WebAS5/ND/instance/properties

where instance is the name of your instance.

You can also specify a properties file for wsadmin when you run the wsadmin script. There are three levels of default properies files that load before any properties file specified on the command line. These properties files load in the order that is shown below. Each properties file overrides settings from previously loaded files.

1. The first level, located in the WebSphere Application Server instance's properties directory is called wsadmin.properties. For the default instance, this file is located in the /QIBM/UserData/WebAS5/Base/default/properties directory for WebSphere Application Server, and in the /QIBM/UserData/WebAS5/ND/default/properties directory for WebSphere Application Server Network Deployment.
2. The second level is in /home/QEJBSVR/wsadmin.properties. This file and the directories that contain it are not shipped with WebSphere Application Server. You must create the directories and files, and assign appropriate authorities.
3. The third level is a file specified by the WSADMIN_PROPERTIES environment variable. This environment variable is defined in the environment where the wsadmin tool starts. Generally, this is the QShell session in which you run the wsadmin script. WebSphere Application Server does not define this environment variable.
4. Lastly, properties specified on the command line are processed. This mean that command line properties override values specified in any of the properties files.

Note: Some of these properties have two default values.

• iSeries default value
  This value is set in the wsadmin.properties file when you create an instance. Values specified in this file override the wsadmin tool default.

• wsadmin tool default value
  These values are hardcoded in the tool. If no other values are specified, the tool uses these default values.

These are the Java properties contained in the wsadmin.properties file:

• com.ibm.ws.scripting.connectionType
  This value determines the type of connection to use. Possible values are SOAP (Simple Object Access Protocal), RMI (Remote Method Invocation), or NONE. The iSeries default is SOAP.

• com.ibm.ws.scripting.port
  This property specifies the port that the connector uses. The default value is the SOAP port for your instance.

• com.ibm.ws.scipting.host
  The host to which the scripting process attempts to connect. The default is localhost.

• com.ibm.ws.scripting.defaultLang
  This property specifies the language to use when executing scripts. Jacl is the only supported language. If you specify the -f parameter, wsadmin checks to see if the file extension maps to a know value. For example, if the file name is test.jacl it will set the language to JACL. If the -f parameter is not specified or the file type is unknown, wsadmin generates an error.

  • iSeries default value: jacl.
  • Tool default value: none

• com.ibm.ws.scripting.traceFile
  This property specifies the file to which the scripting process writes trace and logging information.

  • iSeries default value: the wsadmin.traceout file in this directory:
    • WebSphere Application Server: /QIBM/UserData/WebAS5/Base/instance/logs/wsadmin.traceout
    • WebSphere Application Server Network Deployment: /QIBM/UserData/WebAS5/ND/instance/logs/wsadmin.traceout

    where instance is the name of your instance.

  • Tool default value: Print trace output to the display.

• com.ibm.ws.scripting.validationOutput
  This property specifies where validation reports are directed. If multiple users simultaneously administer an instance with wsadmin, it is recommended that you specify different validationOutput properties in user properties files.

  • iSeries default value: The wsadmin.valout file in this directory:
    • WebSphere Application Server: /QIBM/UserData/WebAS5/Base/instance/logs/wsadmin.valout
    • WebSphere Application Server Network Deployment: /QIBM/UserData/WebAS5/ND/instance/logs/wsadmin.valout

    where instance is the name of your instance.

  • Tool default value: wsadmin.valout in the current directory.

• com.ibm.ws.scripting.traceString
  This property is used to turn on tracing for the scripting process. For example, use com.ibm.ws.scripting.*=all=enabled to turn on all tracing for the the scripting code. The default is to not use tracing.

• com.ibm.ws.scripting.profiles
  The profiles property is a list of profiles that wsadmin runs before it runs user commands, scripts, or an interactive shell.

  • The iSeries default value includes /QIBM/ProdData/WebAS5/Base/bin/securityProcs.jacl and /QIBM/ProdData/WebAS5/Base/bin/LTPA_LDAPSecurityProcs.jacl. These profile scripts make it easier to configure security.
  • Tool default value: none

• com.ibm.ws.scripting.emitWarningForCustomSecurityPolicy
  This property specifes whether message WASX7207W is emitted when custom permissions are found. The possible values are TRUE and FALSE.

  • iSeries default value: none
  • Tool default value: TRUE

• com.ibm.ws.scripting.tempdir
  This property specifies the directory to use for temporary files when installing applications.

  • iSeries default value: none
  • Tool default value: the value of Java system property java.io.tempdir

• com.ibm.ws.scripting.validationLevel
  This property specifies the level of validation to use when configuration changes are made from the scripting interface. Possible values are NONE, LOW, MEDIUM, HIGH, HIGHEST.

  • iSeries default value: none
  • Tool default value: HIGHEST

• com.ibm.ws.scripting.crossDocumentValidationEnabled
  This property specifies whether the validation mechanism examines other documents when changes are made to one document. Possible values are TRUE and FALSE.

  • iSeries default value: none
  • Tool default value: TRUE

• com.ibm.ws.scripting.classpath
  The classpath property is appended to the list of paths to search for classes and resources. There is no default value for iSeries or the wsadmin tool.