(zos)

Converting a 7-character server short name to 8 characters

By default, the product assumes you are using a 7-character short name (JOBNAME) for the application servers and deployment managers. If the naming standards require 8 characters, we can lengthen the 7-character server short name to 8 characters.

You should consider the following before performing this task:

• 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 the 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 the 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, we need to review the COMMNDxx PARMLIB member, as well as any other form of automation you use that issues a start command to start a server.

• Review the start parameters of the Workload Management (WLM) static APPLENV definitions. These are the parameters used to start the servant process (server region). If we are using static APPLENVs, the start parm string used by the WLM for the server looks similar to JOBNAME=BBOS001S,ENV=... You will need to decide to keep this JOBNAME or change to the new JOBNAME specified in the following steps. The original JOBNAME is sufficient.

  This consideration does not apply 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 the information about RACF server class profiles.

To lengthen a 7-character server short name to 8 characters:

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

   1. Navigate to the appropriate application server or deployment manager.

      For an application server, in the console, click Servers > Server Types > WebSphere application servers > server_name.

      For a deployment manager, in the console, click System Administration > dmgr.

   2. In the Short name field, replace the 7-character name with the 8-character short name to use.

   3. Click OK.

2. Update the start command arguments for the servant to use the new 8-character name. If you are reconfiguring a node agent, we can skip this step because it does not have an associated servant process.

   1. Navigate to the servant process.

      For an application server, in the console, click Servers > Server Types > WebSphere application servers > server_name > Java and process management > Process definition > Servant.

      For a deployment manager, in the console, click System Administration > Deployment manager, and then under Server Infrastructure, click Java and process management > Process definition.

   2. In the startCommandArgs field, replace the 7-character name, designated by the JOBNAME argument, with the 8-character name 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.

3. Click Save to save the configuration changes.

Related tasks

Controlling application environments with RACF server class profiles

Process definition settings

Application server settings