Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2

2.8 Setting up the JP1/AJS3 Console environment

Setup of the JP1/AJS3 Console environment that enables centralized monitoring of jobs during automatic operation, differs between the JP1/AJS3 Console Manager environment and the JP1/AJS3 Consol Agent environment.

For JP1/AJS3 Console Manager, set the definition key [JP1_DEFAULT\JP1AJS2CONSOLEMANAGER]. Even if you use a logical host still use the value of the JP1_DEFAULT host key for all environment setting parameters other than DATADIRECTORY.

For JP1/AJS3 Console Agent, set the definition key [JP1_DEFAULT\JP1AJS2CONSOLEAGENT]. If you plan to monitor logical host objects, set environment setting parameters under the JP1_DEFAULT host key.

The table below lists the JP1/AJS3 Console Manager environment setting parameters to be set in JP1/AJS3 Console Manager environment, and the JP1/AJS3 - Console Agent environment setting parameters to be set in the JP1/AJS3 - Agent environment.

To determine whether an environment setting parameter is to be set in Windows or UNIX, see the Applicable OS column. To determine whether an environment setting parameter is to be set in the manager environment (JP1/AJS3 Console Manager) or the agent environment (JP1/AJS3 Console Agent), see the Applicable product column.

Table 2-8 Environment setting parameters (JP1/AJS3 Console environment setup)

No. Environment setting parameter Definition and default value Applicable OS Applicable product

1 "MAXSESSION"= Maximum number of simultaneous sessions Windows
UNIX M, A

2 "IPC_TIMEOUT"= Remote communication timeout period Windows
UNIX M

3 "IPCRETRYINTERVAL"= Retry interval Windows
UNIX M

4 "IPCRETRYCOUNT"= Number of retries Windows
UNIX M

5 "SESSIONTIMEOUT"= Connection timeout period Windows
UNIX M

6 "CHARCODE"= Character set used for information to be stored in user-defined data Windows
UNIX M

7 "SYSLOGCODE"= Character set used to output a log file UNIX M, A

8 "HNTRLOGLEVEL"= Level of messages to be output to the integrated trace log Windows
UNIX M, A

9 "DATADIRECTORY"= Name of the data directory for root scope Windows
UNIX M

10 "RECONNECTINTERVAL"= Interval at which reconnection to JP1/AJS3 Console Agent is attempted. Windows
UNIX M

11 "TRACELOGFILE"= Name of the trace log file for JP1/AJS3 Console Manager Windows
UNIX M, A

12 "IPC_CONNECTTIMEOUT"= Remote connection timeout value Windows
UNIX M

13 "ENABLEOPERATION"= Permission for operation functions Windows
UNIX A

Legend:

M: JP1/AJS3 Console Manager

A: JP1/AJS3 Console Agent
 
Note

If there is an error in the specification of the DATADIRECTORY environment setting parameters, a login error occurs in JP1/AJS3 Console View. If there is an error in the specification of the environment setting parameters other than DATADIRECTORY, the system assumes the standard JP1/AJS3 Console Manager setting.

The following describes each of the environment setting parameters.

Parameters that are not described here are used for maintenance purposes. Do not change their values.

The default value is used whenever a value is not specified for an environment setting parameter.

Organization of this section

(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}"

(7) "SYSLOGCODE"="{C}"

(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}"

No.	Environment setting parameter	Definition and default value	Applicable OS	Applicable product
1	"MAXSESSION"=	Maximum number of simultaneous sessions	Windows UNIX	M, A
2	"IPC_TIMEOUT"=	Remote communication timeout period	Windows UNIX	M
3	"IPCRETRYINTERVAL"=	Retry interval	Windows UNIX	M
4	"IPCRETRYCOUNT"=	Number of retries	Windows UNIX	M
5	"SESSIONTIMEOUT"=	Connection timeout period	Windows UNIX	M
6	"CHARCODE"=	Character set used for information to be stored in user-defined data	Windows UNIX	M
7	"SYSLOGCODE"=	Character set used to output a log file	UNIX	M, A
8	"HNTRLOGLEVEL"=	Level of messages to be output to the integrated trace log	Windows UNIX	M, A
9	"DATADIRECTORY"=	Name of the data directory for root scope	Windows UNIX	M
10	"RECONNECTINTERVAL"=	Interval at which reconnection to JP1/AJS3 Console Agent is attempted.	Windows UNIX	M
11	"TRACELOGFILE"=	Name of the trace log file for JP1/AJS3 Console Manager	Windows UNIX	M, A
12	"IPC_CONNECTTIMEOUT"=	Remote connection timeout value	Windows UNIX	M
13	"ENABLEOPERATION"=	Permission for operation functions	Windows UNIX	A

(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

(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

(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

(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

(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

(6) "CHARCODE"="{C}"

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

Default value

C

Recommended value

Default value

When the setting takes effect

After the JP1/AJS3 Console Manager service is restarted

(7) "SYSLOGCODE"="{C}"

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

Default value

C

Specifiable values

C

Messages are output in English ASCII character set.

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

(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

(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

In Windows Server 2008:
%ALLUSERSPROFILE%\HITACHI\JP1\JP1_DEFAULT\JP1AJS2\database (The default value of %ALLUSERSPROFILE% is system-drive\ProgramData.)

In 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

(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

(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

In Windows Server 2008:
JP1/AJS3 - Manager: %ALLUSERSPROFILE%\HITACHI\JP1\JP1_DEFAULT\JP1AJS2CM\log\tracelog.cm
JP1/AJS3 - Agent: %ALLUSERSPROFILE%\HITACHI\JP1\JP1_DEFAULT\JP1AJS2\log\tracelog.ca
(The default value of %ALLUSERSPROFILE% is system-drive\ProgramData.)

In Windows Server 2003:
JP1/AJS3 - Manager: JP1/AJS3-Console-installation-folder\log\tracelog.cm
JP1/AJS3 - Agent: JP1/AJS3-Manager-installation-folder\log\tracelog.ca

In UNIX:
JP1/AJS3 - Manager: /var/opt/jp1ajs2cm/log/tracelog.cm
JP1/AJS3 - 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

(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

(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

[Contents][Back][Next]

[Trademarks]