Hitachi

uCosminexus Application Server Definition Reference Guide


4.14 Parameters applicable to the logical CTM

This section describes the parameters applicable to the logical CTM.

The following table describes the parameters applicable to the logical CTM. In the table below, Default value means the value that is assumed when the parameter is not specified.

Related information is the reference location for information related to the specified key. uCosminexus Application Server is omitted from the manual names.

Table 4‒93: Parameters applicable to the logical CTM

Value of param-name

Value of param-value

Default value

Related information

ctm.Agent

Specifies whether to use the ORB gateway functionality of the CTM regulator. Specify one of the following values:

In the systems executing batch applications, make sure that you specify '1'.

1:

Use functionality.

0:

Do not use functionality.

0

ctm.cdm

Specify the CTM domain name of the CTM domain manager to be used. Specify the CTM domain name of the CTM domain manager from the same host.

CTMDOMAIN

ctm.CreatePolicy

Chooses the CTM node selection policy for the create request. Specify one of the following values:

normalDispatch:

Chooses the CTM daemon according to the load status in the schedule queue.

priorDispatch:

Chooses the CTM daemon that has received the create request on higher priority. However, if the schedule queue registered in that CTM daemon has a high load or is locked, it chooses another CTM daemon.

normalDispatch

3.8 Load balancing of requests in the Expansion Guide

ctm.DCSendTimeOut

Specifies the timeout value for forwarding requests of the communication between CTMs as an integer in the range from 0 to 2147483647 (unit: seconds).

Indicates that 0 is not specified.

180

ctm.DispatchParallelCount

Specifies the maximum number of threads for distributing the request messages from the client to the J2EE server within CTM as an integer in the range from 0 to 32767.

255

ctm.DispatchPolicy

Chooses the policy for scheduling requests.

normalDispatch:

Schedules requests according to the load status in the schedule queue.

priorDispatch:

Schedules requests giving priority to the schedule queue registered in the CTM daemon that received the request. However, if the schedule queue registered in that CTM daemon has a high load or is locked, schedules the request to a schedule queue registered in another CTM daemon.

priorDispatch

3.8 Load balancing of requests in the Expansion Guide

ctm.EjbPort

Specifies the port number that the EJB client will use to find new CTM daemon connections as an integer in the range from 5001 to 65535. If this value is not specified, the OS automatically uses the assigned port number.

Automatically

ctm.LoadCheckInterval

Specifies the time interval for monitoring the load in the schedule queue as an integer in a range from 0 to 32767 (unit: seconds). 0 indicates that load status will not be monitored at fixed time intervals.

10

ctm.LogFileCount

Specifies the number of CTM log files.

The specifiable values are 2, 4, 8, 16, 24, and 32.

2

ctm.LogFileSize

Specifies the maximum size of one CTM log file as an integer in the range from 1 to 3 (unit: megabyte).

1

ctm.MaxRequestCount

Specifies the number of requests that can be concurrently registered in the CTM queue registered in CTM as an integer in the range from 1 to 32767.

50

ctm.ns.port

Specifies the port number of the naming service paired with CTM as an integer in the range from 1 to 65535.

20348

ctm.NsBindHost

Specifies whether to assign a specific IP address to the machine when multiple IP addresses are assigned to one machine. Specify one of the following values:

true:

Assign a specific IP address.

false:

Do not assign a specific IP address.

false

ctm.port

Specifies the port number to be used by CTM as an integer in the range from 5001 to 65535.

20138

ctm.QueueCount

Specifies the number of CTM queues that can be registered in CTM as an integer in the range from 1 to 32767.

128

ctm.QueueDeleteWait

Specifies the waiting time for reserving the CTM queue in which the abnormally terminated J2EE server was registered, and for awaiting the restart of the J2EE server as an integer in the range from 0 to 2147483647 (unit: seconds).

0

ctm.QueueInterval

Specifies the time interval for requesting the processing rate of the system termination threshold value as an integer in the range from 1 to 32767 (unit: seconds).

None

ctm.QueueRate

Specifies the threshold value of the retention rate to migrating to the queue retention monitoring state as an integer in the range from 0 to 99 (unit: %).

None

ctm.QueueRegistCount

Specifies the number of J2EE applications that can share the same CTM queue as an integer in the range from 1 to 32767.

64

ctm.RegOption

Specifies the setup file for the CTM regulator with the absolute path of the CTM active host (string of maximum 256 characters).

None

ctm.RegStart

Specifies the number of processes of the CTM regulator to be started automatically when starting CTM as an integer in the range from 0 to 32767.

1

ctm.RequestCount

Specifies how many times should a timeout occur for the lock to be set up automatically as an integer in the range from 1 to 32767.

None

ctm.RequestInterval

Specifies the time interval for requesting the timeout occurrence frequency as an integer in the range from 1 to 32767 (unit: seconds).

None

ctm.ServerCacheSize

Specifies the size of the cache table for storing the configuration information about the CTM domain as an integer in the range from 1 to 32767 (unit: kilobyte).

1024

ctm.ServerConnectCount

Specifies the maximum number of J2EE servers connected to CTM as an integer in the range from 0 to 32767.

64

ctm.StatsFileCount

Specifies the number of generations of CTM operation statistics information.

The specifiable values are 3, 4, 16, 32, 64, 128, and 256.

3

ctm.StatsFileSize

Specifies the size of the CTM operation statistics information file in megabytes.

The specifiable values are 1, 2, 3, 4, 8, 16, 32, 64, 128, 256, 512, and 1024.

3

ctm.StatsInterval

Specifies the time interval to output the CTM operation statistics information in a file as an integer in the range from 1 to 1440 (unit: minutes).

1

ctm.StatsUse

Specifies whether to acquire the CTM operation statistics information. Specify one of the following values:

Y:

Collected.

N:

Not collected.

Y

ctm.SystemDown

Specifies whether to terminate the system. Specify one of the following values:

1:

Terminate.

0:

Do not terminate.

1

ctm.SystemDownRate

Specifies the threshold value for the processing rate to migrate to system termination as an integer in the range from 1 to 100 (unit: %)

None

ctm.TSCGwOption

Specifies the setup file for the OTM gateway with the absolute path of the CTM active host (string of maximum 256 characters).

None

ctm.TSCGwStart

Specifies the number of processes of OTM gateway to be started automatically when CTM is started as an integer in the range from 0 to 32767.

0 indicates that the OTM gateway is not to be started.

0

ctm.WatchQueue

Specifies whether to perform stationary monitoring of the queue. Specify one of the following values:

true:

Perform stationary monitoring of the queue.

false:

Do not perform stationary monitoring of the queue.

false

ctm.WatchRequest

Specifies whether to lock the queue when a timeout occurs while a request is being sent to the J2EE server. Specify one of the following values:

true:

Lock the queue.

false:

Do not lock the queue.

false

ctmid

Specifies the CTM identifier as a string of maximum 31 characters. You can use alphanumeric characters, underscore (_), and period (.). (Period (.) can only be specified in IP addresses). Do not specify strings beginning with "CTM" or "ctm".

When specifying this parameter, a unique value must be specified in all the logical CTM servers within the management domain.

If an IP address is specified, period (.) is replaced by underscore (_).

Value-specified-in-the-<agent-host>-tag-in-the- host-definition#_CTM-port-number

#

If the host name is specified in the <agent-host> tag, a value converted into the IP address is specified. If an IP address is specified in the <agent-host> tag, period (.) is replaced by underscore (_).