PQ79854: 7-CHARACTER JOBNAME LIMITATION WHEN USING WEBSPHERE | |||||||||||||||||||||||||||||||||||||||||||
![]() |
|||||||||||||||||||||||||||||||||||||||||||
![]() 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 JOBNAMEsProblem 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 is sysrouted FROM one or more of the following: APAR is sysrouted TO one or more of the following: Modules/Macros
Publications Referenced
|
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
(C) Copyright IBM Corporation 2000, 2009. All Rights Reserved.