[Version 5.0.2 and later]Application server settings

Use this page to view or change the settings of an application server instance.

To view this administrative console page, click Servers > Application Servers > server_name.

On the Configuration tab, you can edit fields. On the Runtime tab, you can look at read-only information. The Runtime tab is available only when the server is running.

Configuration tab

Name
Specifies a logical name for the server. Server names must be unique within a node. However, for multiple nodes within a cluster, you may have different servers with the same server name as long as the server and node pair are unique. For example, a server named server1 in a node named node1 in the same cluster with a server named server1 in a node named node2 is allowed. Configuring two servers named server1 in the same node is not allowed. WebSphere uses the server name for administrative actions, such as referencing the server in scripting. For WebSphere Application Server for z/OS, this property is sometimes called the long name.
Data type String
Default server1
Application Class loader Policy
Specifies whether to use a single class loader to load all applications or to use a different class loader for each application.

The options are SINGLE and MULTIPLE. The default is to use a separate class loader for each application (MULTIPLE).

Data type String
Default MULTIPLE
Application Classloading Mode
Specifies whether the class loader should search in the parent class loader or in the application class loader first to load a class. The standard for Developer Kit class loaders and WebSphere class loaders is PARENT_FIRST. By specifying PARENT_LAST, your application can override classes contained in the parent class loader, but this action can potentially result in ClassCastException or LinkageErrors if you have mixed use of overridden classes and non-overridden classes.

The options are PARENT_FIRST and PARENT_LAST. The default is to search in the parent class loader before searching in the application class loader to load a class.

Data type String
Default PARENT_FIRST
Short name  
Specifies the short name of the server. For WebSphere Application Server for z/OS, the server short name must be unique within a cell. The short name is also the default z/OS job name, which identifies the server to the native facilities of the operating system, such as Workload Manager (WLM), Automatic Restart Manager, SAF (for example, RACF), started task control, and others.

The name is 1-8 characters, alpha-numeric or national language. It cannot start with a number.

The system assigns a default short name that is automatically unique within the cell. You can change the generated short name to conform with your naming conventions.

[Version 5.0.2]Converting a 7-character server short name to 8 characters:

[Version 5.0.2]By default, WebSphere Application Server for z/OS assumes you will be using a 7-character server short name (JOBNAME). If your naming standards require 8 characters, you can lengthen the 7-character server short name to 8 characters by performing the tasks below. Before doing this, it is important to consider the following:

  • The Resource Recovery Services (RRS) log names are based on the server short name. When you change the server short name, you are changing the server's identity to the RRS. This means that the previously existing transaction and partner logs will be abandoned, or will not match the new name, and either of these situations will result in restart problems. To prevent this from happening, ensure that there are no outstanding RRS units of recovery (URs) for your server before changing its name. See z/OS MVS Programming: Resource Recovery for instructions on using the RRS panels to view information about URs.

    Note that the only safe way to provide an 8-character short name for a server is to do so before it is initially started.

  • Converting your 7-character server short name to 8 characters requires you to change the JOBNAME used by the servant's start command. This means that the System Authorization Facility (SAF) started class that previously matched this job may no longer match. Review your SAF STARTED class profile and, if necessary, define a new class.
  • Because the JOBNAME appears as part of a start command's arguments, you need to review your COMMNDxx PARMLIB member, as well as any other form of automation you use that issues a start command to start a WebSphere server.
  • Review the start parameters of your Workload Management (WLM) static APPLENV definitions. These are the parameters that are used to start the servant process (server region). If you are using static APPLENVs, the start parm string used by the WLM for your server looks similar to JOBNAME=BBOS001S,ENV=... You will need to decide if you want to keep this JOBNAME or change to the new JOBNAME that you specify in the steps below. The original JOBNAME should be sufficient.

    Note that this consideration does not apply to you if you are using WLM dynamic APPLENVs.

  • Review and update the necessary Resource Access Control Facility (RACF) profiles to support these server short names. See RACF server class profiles

[Version 5.0.2]Steps for this task:

  1. Change the 7-character server short name to the 8-character name you wish to use:
    1. Navigate to Servers > Application Servers > server_name.
    2. In the short Name field, replace the 7-character name with the 8-character short name you wish to use.
    3. Click OK.
  2. Update the servant's start command arguments to use the new 8-character name. Note that if you are reconfiguring a nodeagent or jmsserver, you can skip this step because neither has an associated servant process.
    1. Navigate to Servers > Application Servers > server_name > Process Definition > Servant.
    2. In the startCommandArgs field, replace the 7-character name, designated by the JOBNAME argument, with the 8-character name you wish to use. Do not include the S character at the end of the JOBNAME. For example, JOBNAME=P5SVR1D,ENV=P5CELL.P5NODED.P5SVR1D .
    3. Click OK.

Unique Id  
Specifies the unique ID of this server.

The unique ID property is read only. The system automatically generates the value.


Related concepts
Application servers
Class loaders
Related tasks
Configuring application servers
Related reference
Administrative console buttons
Administrative console page features
Object names
Administration service settings
Class loader collection
Enterprise application collection
Custom service collection
Debugging Service details
Dynamic cache service settings
EJB container settings
Web container advanced settings
End point collection
Message listener port collection
Object Request Broker service settings in administrative console
Process definition settings
Custom property collection
Native processes
Server component collection
Server security settings
Diagnostic trace service settings
Transaction service settings
Web container settings
Server Instance Settings



Searchable topic ID:   urun_rappsvr
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/urun_rappsvr.html

Library | Support | Terms of Use | Feedback