Skip to main content

By clicking Submit, you agree to the developerWorks terms of use.

The first time you sign into developerWorks, a profile is created for you. Select information in your developerWorks profile is displayed to the public, but you may edit the information at any time. Your first name, last name (unless you choose to hide them), and display name will accompany the content that you post.

All information submitted is secure.

  • Close [x]

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerworks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

By clicking Submit, you agree to the developerWorks terms of use.

All information submitted is secure.

  • Close [x]

Best Practice: WebSphere for zOS and OS/390 Naming Conventions

Don Bagwell (dbagwell@us.ibm.com), Senior Software Engineert, IBM
Don Bagwell is with the IBM Washing Systems Center.

Summary:  A WebSphere runtime comprises many different things, all requiring names: base servers, base server instances, J2EE servers and their instances, J2EE data resources, JCL start procedures, WLM application environments, RACF IDs, STARTED class profiles, etc. Without using a consistent naming convention, organization of the different items will be unclear and lead to problems as your system grows.

Date:  05 Apr 2002
Level:  Intermediate

Activity:  1539 views
Comments:  

Introduction

There are two restrictions in a WebSphere installation that affect naming:

  • All server control regions must connect to the same RACF Group ID.
  • Server names must match the WLM application environment names.

This best practice applies to the following product, version, and platform:

  • WebSphere Application Server for z/OS and OS/390, version 4.0.1, OS/390 and zSeries

Recommendation

There is no such thing as a universal and perfect naming convention. Each installation will have unique naming requirements. Nevertheless, there are a few things you should design into your naming convention:

  • An indication that the resource is related to WebSphere for zOS. For example, the letter "W" as part of the name.
  • An indication of the WebSphere node to which the resource belongs. For example, the letter "T" as part of the name to indicate "test" and the letter "P" for production.
  • An indication of the system (or LPAR) on which the resource belongs, if the configuration is a multi-system sysplex. Some WebSphere resources are directly related to a system and others are not. Specifically, server instances (base servers and application servers) are system-specific. The generic server names are not, nor are RACF IDs, WLM applications or JCL procs.

Important: There's an interesting topic that comes into play here. This set of recommendations assumes you'll be establishing different environments for "test" and "production" (and perhaps QA and others). There are several different ways you can configure this, and it does not always imply separate WebSphere "nodes". (See the Resource section of this document for pointer to information on "Test and Production" environments.) It might not imply separate systems or LPARs either, but the best practice is to provide space for those indicators, even if you don't actually need them based on your present configuration. You may grow later, and you will be glad that you planned for it.

Keep in mind that changing the naming scheme of a WebSphere node is almost impossible once it's been configured and initialized. It therefore makes good sense to invest time in planning the naming convention before you commit it to your server.

The following charts can be used to assist in mapping out your naming convention:


Figure 1. Common Definitions
Common Definitions

A partial example follows to illustrate the concept.


Figure 2. Example of Common Definitions
Example of Common Definitions

Important: The system and LPAR are not indicated, since these "Common Definitions" are not system-specific; they are common across the entire WebSphere node.


Figure 3. Base Server Definitions
Base Server Definitions

Using the SMS Server as an example, you might see:


Figure 4. Example of Base Server Definitions
Example of Base Server Definitions

Figure 5. LDAP Definitions
LDAP Definitions

An example of this would be:


Figure 6. Example of LDAP Definitions
Example of LDAP Definitions

Figure 7. J2EE Application Server Definitions
J2EE Application Server Definitions

Note: The CBIND and SERVER values are typically longer than 8 characters thus showing an 8-byte grid was not meaningful. They should, however, still have a meaningful name. You can carry the same naming convention used in the other resource names into those names as well.

And the example:


Figure 8. Example of J2EE Application Server Definitions
Example of J2EE Application Server Definitions

Alternative

The various components of the WebSphere installation have to be named something, there is no alternative to that.

WebSphere for zOS imposes almost no restrictions on the names you provide the various components of the WebSphere installation. The only restrictions were stated earlier: the control region RACF IDs must have a common Group ID and the server name (not instance name, but server name) must be equal to the WLM application environment name. So there is a great deal of flexibility in how the naming convention is structured.

As stated earlier, there is no universally perfect naming convention. Every installation will have a different spin on this. The key message here is to use a meaningful and consistent naming convention because changing the naming convention after the fact is very difficult. Anticipate growth and factor the ability to designate multiple nodes and multiple systems into your naming convention. You may not have a need for that initially, or ever, but it provides you with the capacity for growth.


Resources

About the author

Don Bagwell is with the IBM Washing Systems Center.

Report abuse help

Report abuse

Thank you. This entry has been flagged for moderator attention.


Report abuse help

Report abuse

Report abuse submission failed. Please try again later.


developerWorks: Sign in


Need an IBM ID?
Forgot your IBM ID?


Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.

 


The first time you sign into developerWorks, a profile is created for you. Select information in your developerWorks profile is displayed to the public, but you may edit the information at any time. Your first name, last name (unless you choose to hide them), and display name will accompany the content that you post.

Choose your display name

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.

 


Rate this article

Comments

Help: Update or add to My dW interests

What's this?

This little timesaver lets you update your My developerWorks profile with just one click! The general subject of this content (AIX and UNIX, Information Management, Lotus, Rational, Tivoli, WebSphere, Java, Linux, Open source, SOA and Web services, Web development, or XML) will be added to the interests section of your profile, if it's not there already. You only need to be logged in to My developerWorks.

And what's the point of adding your interests to your profile? That's how you find other users with the same interests as yours, and see what they're reading and contributing to the community. Your interests also help us recommend relevant developerWorks content to you.

View your My developerWorks profile

Return from help

Help: Remove from My dW interests

What's this?

Removing this interest does not alter your profile, but rather removes this piece of content from a list of all content for which you've indicated interest. In a future enhancement to My developerWorks, you'll be able to see a record of that content.

View your My developerWorks profile

Return from help

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=WebSphere
ArticleID=13213
ArticleTitle=Best Practice: WebSphere for zOS and OS/390 Naming Conventions
publish-date=04052002
author1-email=dbagwell@us.ibm.com
author1-email-cc=

Tags

Help
Use the search field to find all types of content in My developerWorks with that tag.

Use the slider bar to see more or fewer tags.

For articles in technology zones (such as Java technology, Linux, Open source, XML), Popular tags shows the top tags for all technology zones. For articles in product zones (such as Info Mgmt, Rational, WebSphere), Popular tags shows the top tags for just that product zone.

For articles in technology zones (such as Java technology, Linux, Open source, XML), My tags shows your tags for all technology zones. For articles in product zones (such as Info Mgmt, Rational, WebSphere), My tags shows your tags for just that product zone.

Use the search field to find all types of content in My developerWorks with that tag. Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere). My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).

Try IBM PureSystems. No charge.

Special offers