2.8.2 Details of the environment setting parameters for JP1/AJS3 Console

Organization of this subsection

(1) "MAXSESSION" = dword:maximum-number-of-simultaneous-sessions
(2) "IPC_TIMEOUT" = dword:connection-timeout
(3) "IPCRETRYINTERVAL" = dword:retry-interval
(4) "IPCRETRYCOUNT" = dword:number-of-retries
(5) "SESSIONTIMEOUT" = dword:connection-timeout-period
(6) "CHARCODE" = "{C|SJIS|EUC|UTF-8}"
(7) "SYSLOGCODE" = "{C|LANG-environment-variable-value}"
(8) "HNTRLOGLEVEL" = "{none|error|warn|info}"
(9) "DATADIRECTORY" = "data-directory-path"
(10) "RECONNECTINTERVAL" = dword:interval-for-reconnecting-to-JP1/AJS3-Console-Agent
(11) "TRACELOGFILE" = "trace-log-file-name"
(12) "IPC_CONNECTTIMEOUT" = dword:remote-connection-timeout-value
(13) "ENABLEOPERATION" = "{yes|no}"

(1) "MAXSESSION" = dword:maximum-number-of-simultaneous-sessions

Use this parameter to specify the maximum number of JP1/AJS3 Console View connections in JP1/AJS3 Console Manager, and the maximum number of JP1/AJS3 Console Manager connections in JP1/AJS3 Console Agent.

If the maximum number of JP1/AJS3 Console View or JP1/AJS3 Console Manager connections is more than 16, specify a suitable value for the number. If resources are limited, decrease the value to limit the number of JP1/AJS3 Console View or JP1/AJS3 Console Manager connections.

An error occurs if the number of JP1/AJS3 Console View or JP1/AJS3 Console Manager connections exceeds the specified value.

Specifiable values

A hexadecimal value from 0 to 40 (0 to 64 in decimal)

Default value

dword:00000010 (16 in decimal)

Recommended value

Default value

When the setting takes effect

For JP1/AJS3 Console Manager:

After the JP1/AJS3 Console Manager service is restarted
For JP1/AJS3 Console Agent:

After the JP1/AJS3 Console Agent service is restarted

To Page Top

(2) "IPC_TIMEOUT" = dword:connection-timeout

Use this value to specify the timeout period for establishing communication with JP1/AJS3 Console Agent.

If communication cannot be established within the specified time, an error occurs. In that case, control is determined by the OS timeout period.

Specify a value other than 0 if you want to set an explicit timeout period rather than depend on the OS timeout period.

Specifiable values: A hexadecimal value (in seconds) from 0 to 258 (0 to 600 in decimal)
Default value: dword:00000000 (0 in decimal)
Recommended value: Default value
When the setting takes effect: After the JP1/AJS3 Console Manager service is restarted

To Page Top

(3) "IPCRETRYINTERVAL" = dword:retry-interval

Use this parameter to specify the retry interval when a communication error occurs.

Depending on the communication error status, change the parameter value and the value for the IPCRETRYCOUNT environment setting parameter (number of retries).

Each time a retry occurs, the specified value increases.

Specifiable values: A hexadecimal value (in seconds) from 0 to A (0 to 10 in decimal)
Default value: dword:00000001 (1 in decimal)
Recommended value: Default value
When the setting takes effect: After the JP1/AJS3 Console Manager service is restarted

To Page Top

(4) "IPCRETRYCOUNT" = dword:number-of-retries

Use this parameter to specify the number of retries to be performed when a communication error occurs.

Depending on the communication error status, change the parameter value and the value for the IPCRETRYINTERVAL environment setting parameter (retry interval).

Specifiable values: A hexadecimal value from 0 to 64 (0 to 100 in decimal)
Default value: dword:00000003 (3 in decimal)
Recommended value: Default value
When the setting takes effect: After the JP1/AJS3 Console Manager service is restarted

To Page Top

(5) "SESSIONTIMEOUT" = dword:connection-timeout-period

Use this parameter to specify how long the system waits after the last communication with JP1/AJS3 Console View before it severs the connection.

Specifiable values

In Windows:

A hexadecimal value (in minutes) from 0 to 78 (0 to 120 in decimal)
In UNIX:

A hexadecimal value (in minutes) from 1 to 78 (1 to 120 in decimal)

Default value

dword:00000078 (120 in decimal)

Recommended value

Default value

When the setting takes effect

After the JP1/AJS3 Console Manager service is restarted

To Page Top

(6) "CHARCODE" = "{C|SJIS|EUC|UTF-8}"

Use this parameter to specify only one character set that is to be used for the name and definitions of the nested application scope or monitored objects.

Specifiable values

C: The ASCII character set
SJIS: The Shift JIS character set
EUC: The EUC character set
UTF-8: The UTF-8 character set

Note: UTF-8 is enabled for UNIX only.

Default value

C

When you execute setup, the following value is automatically set.

In Windows

SJIS
In UNIX

Solaris: EUC

Linux: UTF-8

Other OSs: SJIS

Recommended value

Default value

When the setting takes effect

After the JP1/AJS3 Console Manager service is restarted

Cautionary note

If you change the CHARCODE environment setting parameter in the environment settings of JP1/AJS3 Console Manager, and the value you are changing is SJIS or EUC, make sure that the definition data does not contain any Japanese characters (characters other than ASCII characters).

If the definition data contains Japanese characters (characters other than ASCII characters), do not change the CHARCODE environment setting parameter.

To Page Top

(7) "SYSLOGCODE" = "{C|LANG-environment-variable-value}"

Use this parameter to specify the language type of the messages that are output to the syslog file.

Specifiable values

C

Messages are output in English ASCII character set.

LANG-environment-variable-value (character string other than C)

Operation depends on the settings of the LANG environment variable at the time the JP1/AJS3 Console Manager service for JP1/AJS3 Console Manager or the JP1/AJS3 Console Agent service for JP1/AJS3 Console Agent starts. However, in some systems, a message in the language type corresponding to the LANG environment variable for the JP1/AJS3 Console Manager service or the JP1/AJS3 Console Agent service might not be output to syslog. In such a system, make sure that this parameter is set to C. Check whether Japanese can be output in the system you are using by executing the logger command to output a message in Japanese and then confirming that the message is correctly output to syslog.

The LANG environment variable value differs depending on the OS.

The following table describes the values that can be specified for the LANG environment variable.

Table 2‒10: Specifiable values of the LANG environment variable
OS	Environment variable value for setting Shift JIS	Environment variable value for setting EUC	Environment variable value for setting UTF-8^#1
HP-UX	ja_JP.SJIS japanese	ja_JP.eucJP japanese.euc	ja_JP.utf8
Solaris	ja_JP.PCK	ja^#2 ja_JP.eucJP^#2	ja_JP.UTF-8
AIX	Ja_JP Ja_JP.IBM-932	ja_JP ja_JP.IBM-eucJP	JA_JP JA_JP.UTF-8
Linux	Not available	Not available	ja_JP.UTF-8 ja_JP.utf8

#1

In compatible ISAM configuration, UTF-8 can be used in Linux only.

#2

In Solaris 11, ja and ja_JP.eucJP can be used.

In Solaris 10, only ja can be used.

Default value

C

Recommended value

Default value

When the setting takes effect

For JP1/AJS3 Console Manager:

After the JP1/AJS3 Console Manager service is restarted
For JP1/AJS3 Console Agent:

After the JP1/AJS3 Console Agent service is restarted

To Page Top

(8) "HNTRLOGLEVEL" = "{none|error|warn|info}"

Use this parameter to specify the level of messages that are output to the integrated trace log.

Specify this parameter if you want to output detailed log information to the integrated trace log.

Specifiable values

none: No messages are output.
error: Error messages are output.
warn: Warning messages are output.
info: Information messages are output.

Default value

error

Recommended value

Default value

When the setting takes effect

For JP1/AJS3 Console Manager:

After the JP1/AJS3 Console Manager service is restarted
For JP1/AJS3 Console Agent:

After the JP1/AJS3 Console Agent service is restarted

To Page Top

(9) "DATADIRECTORY" = "data-directory-path"

Use this parameter to specify the name of the directory used to store the definition information of the root scope. Specify a full path name.

Specify this parameter if you want to change location where the definition data is saved to a location other than the default directory.

To change the location, specify an existing directory. If you want to specify a new data directory, create the directory first and then specify the name. Specifying a directory that does not exist results in an error when you log in to JP1/AJS3 Console View.

Do not delete the files in the directory specified in this parameter.

Specifiable values

A character string of no more than 191 bytes

Default value

For Windows Server 2012 or Windows Server 2008, if the installation folder is in the default folder or a folder protected by the system:

%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\database

The default value of %ALLUSERSPROFILE% is system-drive\ProgramData.

A folder protected by the system is the path to a folder in any of the following:

- system-drive\Windows

- system-drive\Program Files

- system-drive\Program Files (x86) (for 64-bit Windows)
For Windows Server 2012 or Windows Server 2008 in which an installation folder other than the above is used:

JP1/AJS3-Console-installation-folder\database
For Windows Server 2003:

JP1/AJS3-Console-installation-folder\database
In UNIX:

/var/opt/jp1ajs2cm/database

Recommended value

Default value

When the setting takes effect

After the JP1/AJS3 Console Manager service is restarted

To Page Top

(10) "RECONNECTINTERVAL" = dword:interval-for-reconnecting-to-JP1/AJS3-Console-Agent

Use this parameter to specify the interval at which connection to JP1/AJS3 Console Agent is retried when connection to the agent fails.

Specify this parameter if you want to change the interval until the next connection when you cannot connect to the JP1/AJS3 Console Agent to be monitored.

Specifiable values: A hexadecimal value (in seconds) from 1E to E10 (30 to 3,600 in decimal)
Default value: dword:0000012C (300 in decimal)
Recommended value: Default value
When the setting takes effect: After the JP1/AJS3 Console Manager service is restarted

To Page Top

(11) "TRACELOGFILE" = "trace-log-file-name"

Use this parameter to specify the trace log file name. Specify a full path name.

Specify the name of a trace log file on the local disk so that trace information will be recorded reliably.

Because the system creates a new file whenever trace information is output, do not specify the name of an existing file.

Specifiable values

A character string of no more than 255 bytes

Default value

For Windows Server 2012 or Windows Server 2008, if the installation folder is in the default folder or a folder protected by the system:

For JP1/AJS3 Console Manager:

%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2CM\log\tracelog.cm
For JP1/AJS3 Console Agent:

%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\log\tracelog.ca

The default value of %ALLUSERSPROFILE% is system-drive\ProgramData.

A folder protected by the system is the path to a folder in any of the following:

- system-drive\Windows

- system-drive\Program Files

- system-drive\Program Files (x86) (for 64-bit Windows)

For Windows Server 2012 or Windows Server 2008 in which an installation folder other than the above is used:

For JP1/AJS3 Console Manager:

JP1/AJS3-Console-installation-folder\log\tracelog.cm
For JP1/AJS3 Console Agent:

JP1/AJS3-Manager-installation-folder\log\tracelog.ca

In Windows Server 2003:

For JP1/AJS3 Console Manager:

JP1/AJS3-Console-installation-folder\log\tracelog.cm
For JP1/AJS3 Console Agent:

JP1/AJS3-Manager-installation-folder\log\tracelog.ca

In UNIX:

For JP1/AJS3 Console Manager:

/var/opt/jp1ajs2cm/log/tracelog.cm
For JP1/AJS3 Console Agent:

/var/opt/jp1ajs2/log/tracelog.ca

Recommended value

Default value

When the setting takes effect

For JP1/AJS3 Console Manager

After the JP1/AJS3 Console Manager service is restarted
For JP1/AJS3 Console Agent

After the JP1/AJS3 Console Agent service is restarted

To Page Top

(12) "IPC_CONNECTTIMEOUT" = dword:remote-connection-timeout-value

Use this parameter to specify the connection timeout period for remote communication with JP1/AJS3 Console Agent.

If the timeout period for TCP/IP connection set in the OS is shorter than the value specified in this parameter, the OS setting is used.

Specifiable values: A hexadecimal value (in seconds) from 0 to 258 (0 to 600 in decimal)
Default value: dword:00000014 (20 in decimal)
Recommended value: Default value
When the setting takes effect: After the JP1/AJS3 Console Manager service is restarted

To Page Top

(13) "ENABLEOPERATION" = "{yes|no}"

Use this parameter to specify whether to enable operation form of JP1/AJS3 Console View.

Specifiable values

yes

Operation from JP1/AJS3 Console View is enabled.

no

Operation from JP1/AJS3 Console View is disabled.

Specify this value if you do not want operations to be performed from JP1/AJS3 Console View for a jobnet on the target host.

Default value

yes

Recommended value

Default value

When the setting takes effect

After the JP1/AJS3 Console Agent service is restarted

To Page Top