1.4 Precautions for using commands

This section describes the precautions you must take for using commands.

Organization of this section
(1) Precautions for using Application Server commands in Windows Server 2012, Windows Server 2008, Windows 8, Windows 7, or Windows Vista
(2) Precautions for using server management commands
(3) Precautions for using commands with the Smart Composer functionality
(4) Precautions for enabling the functionality for omitting the admin user account
(5) Precautions for using the virtual server manager commands
(6) Display name containing characters other than single-byte alphanumeric characters
(7) File and directory name to be specified in command arguments
(8) Precautions related to the commands used with JavaVM (In Windows)
(9) Precautions related to the commands used with CTM (In Windows)
(10) Precautions related to the commands used with the performance analysis trace (In Windows)

(1) Precautions for using Application Server commands in Windows Server 2012, Windows Server 2008, Windows 8, Windows 7, or Windows Vista

The commands provided with the Application Server must be executed with administrator privileges. You open Administrator, and choose Command Prompt to execute commands provided with the Application Server.

To open Administrator, and choose Command Prompt, use the functionality provided with Windows Server 2012, Windows Server 2008, Windows 8, Windows 7, or Windows Vista. An example describing the start method is given below:

  1. Click Start.
  2. Choose All Programs, and then Accessories.
  3. Right-click Command Prompt and then click Execute As Administrator.

If the administrator password or confirmation is requested, enter the password or specify the confirmation information as per the instructions in the window.

(2) Precautions for using server management commands

(3) Precautions for using commands with the Smart Composer functionality

For using the following commands, you enable the monitoring of J2EE server operations (specify true in the ejbserver.instrumentation.enabled parameter) in the configuration settings of the J2EE server with the physical tier:

You use the Easy Setup definition file to specify the settings for physical tier. For details on the Easy Setup definition file, see 4.6 Easy Setup definition file in the uCosminexus Application Server Definition Reference Guide.

(4) Precautions for enabling the functionality for omitting the admin user account

Among the commands used with the Manager Server and Smart Composer, there are some commands that operate differently when the functionality for omitting the admin user account is enabled. The following table lists and describes the commands:

Table 1-8 Commands that operate differently when the functionality for omitting the admin user account is enabled

FunctionCommand nameOperation when the functionality for omitting the admin user account is enabled
Commands used with Manager Servermngsvrctl commandThe following setup of the argument setup is disabled:
  • -u admin-user-ID
  • -p admin-password
  • -nu admin-user-ID
  • -np admin-password
Even the message is output, the setup process is executed as usual. The setup of the arguments start and stop is disabled.
You cannot set up or change the admin user account and the password.
mngsvrutil commandThe setup of the following arguments is disabled:
  • -u admin-user-ID
  • -p admin-password
Commands used with Smart ComposerOther than the cmx_admin_passwd command
cmx_admin_passwd commandThe setup value is disabled and the message is output.
You cannot set up or change the admin user account and the password.

You can set up the default value for the options of the command as common definition files. These files operate differently when the functionality for omitting the admin user account is enabled. The following table lists and describes the files in which the operations are different:

Table 1-9 Files in which the operations are different when enabling the functionality for omitting the admin user account

File nameCommand definition file typeOperation when the functionality for omitting the admin user account is enabled
.mngsvrutilrcmngsvrutil command definition fileThe settings of the following properties are disabled:
  • mngsvrutil.connect.userid
  • mngsvrutil.connect.password
mngsvrutilcl.properties
.cmxrcCommand definition file used with Smart ComposerThe settings of the following properties are disabled:
  • cmx.connect.userid
  • cmx.connect.passwd
cmxclient.properties
.mngsvrmonitorrcmngsvrmonitor command definition fileThe settings of the following properties are disabled:
  • mngsvrmonitor.connect.userid
  • mngsvrmonitor.connect.password

(5) Precautions for using the virtual server manager commands

(6) Display name containing characters other than single-byte alphanumeric characters

The J2EE servers use the display names set up for J2EE applications or resources (value of the <display-name> tag of DD) as identifiers. If the display name contains a character other than universal characters and single-byte alphanumeric characters (0 to 9, A to Z, and a to z), the character is converted to an underscore (_), and an identifier is generated. Depending on the set value, the identifier generated during the conversion might be repeated and the operation might fail. Do not use the characters other than single byte alphanumeric characters or underscores, in the display name.

If the display name contains characters other than single byte alphanumeric characters, the J2EE server outputs a warning message (KDJE42374-W).

(7) File and directory name to be specified in command arguments

Do not use a hash mark (#), percent mark (%), or question mark (?), in the file name and the name of the directory that stores that file that is to be specified in the arguments of the command used with the Smart Composer functionality or Management Server.

If you use a hash mark, percent mark, or question mark, the following message is output and the command processing is aborted:

KEOS24007-E The definition file is invalid. file name = file-name line number = 1 column number = 1 details = KECX01024-E Content is not allowed in prolog.

(8) Precautions related to the commands used with JavaVM (In Windows)

The following commands provided with Application Server create temporary files in a directory acquired by the GetTempPath() functionality of Windows API:

You must have write permission for the directory acquired using the GetTempPath() functionality to operate the commands properly. Also, do not delete this directory when the JavaVM process is being executed.

In Windows Server 2012, Windows Server 2008, Windows 8, Windows 7, and Windows Vista, do not specify the system directory of Windows, in this directory.

(9) Precautions related to the commands used with CTM (In Windows)

A user, belonging to the Administrators group, must execute the commands used with CTM.

(10) Precautions related to the commands used with the performance analysis trace (In Windows)

A user who executes the cprfstart command must execute the commands used with the performance analysis trace.