PQ79854: 7-CHARACTER JOBNAME LIMITATION WHEN USING WEBSPHERE

 A fix is available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
Customer would like to use a JOBNAME that is longer than
seven characters in length when running WebSphere.
They would like to have an 8-character JOBNAME.
Local fix
To manually lengthen the JOBNAME to eight characters,
follow the next steps from the admin console:
1. Navigate to server
2. Server short name is the JOBNAME: change this to the
   desired 8-character name
3. Navigate to server's servant process definition
   (server->process definitions->servant process)
4. Change servant's start command arguments to have the
   JOBNAME, where keyword has the desired 8-character JOBNAME
5. Omit steps 3 and 4, if you are reconfiguring a nodeagent
   or jmsserver, as neither has a servant process
6. Save configuration change (ensure you synchronize to nodes)
7. Verify the necessary RACF profiles to support these JOBNAMEs
Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V5.0 for z/OS                                *
****************************************************************
* PROBLEM DESCRIPTION: The WebSphere for z/OS server short     *
*                      names (jobnames) have been, by default, *
*                      limited to a length of 7 characters.    *
*                      Because some of our customers need to   *
*                      use 8-character short names, we will    *
*                      now start allowing this. The            *
*                      documentation needs to say this, plus   *
*                      provide instructions for converting     *
*                      current 7-character short names to 8    *
*                      characters.                             *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
WebSphere for z/OS will now start allowing 8-character
server short names (jobnames). The documentation needs to
to be updated to support this.
Problem conclusion
Changes to the WebSphere for z/OS Customization Dialog have been
made available with this APAR.

Changes to the WebSphere Application Server InfoCenter
will be made available. To access the latest online
documentation, go to the product library page at:

www.ibm.com/software/webservers/appserv/zos_os390/library/

----------------------------------
The change is to Customization Dialog files BBOWHA11, BBOWHC31
and BBOWHS31, and InfoCenter articles rins_defvar2def,
rins_defvar4def and rins_defvar5def, which will read as follows:

Server name (short)
...
Rule: Name must usually contain 7 or fewer all-uppercase
characters. If you wish to instead specify 8 characters, you
must follow the steps outlined in the WebSphere Application
Server InfoCenter article "Converting a 7-character jobname to
8 characters."
----------------------------------
The change is also to Customization Dialog files BBOWHC32 and
BBOWHS32, and InfoCenter article rins_defvar2def, which
will read as follows:

Rule: In the following, unless specified otherwise, names must
be 8 or fewer characters.
    Note: If you wish to specify jobnames with 8 instead of 7
    characters, you must follow the steps outlined in the
    WebSphere Application Server InfoCenter article "Converting
    a 7-character jobname to 8 characters."

----------------------------------
The change is also to InfoCenter article urun_rconfproc,
Start Command Args section, which will read as follows:

By default, the server short name (JOBNAME) contains
7 characters, but you can lengthen the short name to
8 characters. For more information, see
"Application server settings".

----------------------------------
The change is also to InfoCenter article urun_rappsvr
("Application server settings") in the section titled "Short
name," which will read as follows:

Converting a 7-character server short name to 8 characters

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:

o  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.

o  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.

o  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.

o  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 APLLENVs.

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

Steps for this task

1.  Change the 7-character server short name to the 8-character
    name you wish to use:

  a. Navigate to Servers > Application Servers > server_name.

  b. In the short Name field, replace the 7-character name with
     the 8-character short name you wish to use.

  c. 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.

  a. Navigate to Servers > Application Servers > server_name >
     Process Definition > Servant.

  b. 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.

  c. Click OK.


Related tasks

   Process definition settings

----------------------------------
The change is also to InfoCenter article cins_simplifyz,
"Naming servers, cells, and nodes for manageability"
section, which will read as follows:

Short names are generally 8 or fewer alphanumeric characters, ca
a numeric first character, are capitalized, and are used for MVS
The @ and # national characters are allowed, but not $.

By default, server short names are a maximum of 7 characters
in length. An "S" is automatically appended to indicate the
controller region started task jobname. If you choose to
designate an 8-character server short name, you must then
explicitly set the JOBNAME for the corresponding servant
process to the 8-character name, excluding the "S". For more
information, see "Application server settings".

Short name examples:

Server short name: V5SRV1, P5SVR1D
Node short name: V5NODEA
Cell short name: V5CELL

APAR PQ79854 is associated with SERVICE LEVEL W502002 of
WebSphere Application Server V5.0 for z/OS.
Temporary fix Comments
APAR information
APAR number PQ79854
Reported component name WEBSPHERE FOR Z
Reported component ID 5655I3500
Reported release 500
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Special Attention YesSpecatt / CST
Submitted date 2003-10-20
Closed date 2004-02-12
Last modified date 2004-04-28

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros
BBOUBINF          

Publications Referenced

Fix information
Fixed component name WEBSPHERE FOR Z
Fixed component ID 5655I3500

Applicable component levels
R500 PSY UQ85128    UP04/02/20 P F402

  Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.


Document Information


Current web document: swg1PQ79854.html
Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 500
Software edition:
Reference #: PQ79854
IBM Group: Software Group
Modified date: Apr 28, 2004