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

2.1 Setting up the system management environment

The system management environment requires different settings in the manager environment (JP1/AJS3 - Manager) and the agent environment (JP1/AJS3 - Agent).

The table below describes the environment setting parameters to be used to set the system management in the manager environment (JP1/AJS3 - Manager) and the agent environment (JP1/AJS3 - Agent).

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 - Manager) or the agent environment (JP1/AJS3 - Agent), see the Applicable product column.

Table 2-1 Environment setting parameters (system management)

No. Definition key Environment setting parameter Definition Applicable OS Applicable product

1 [{JP1_DEFAULT|logical-host-name}\JP1AJS2]^# "SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT"= Whether a JP1 event is issued when a process terminates abnormally or times out at startup (used in an ISAM configuration to ensure compatibility) Windows
UNIX M, A

2 "SEND_PROCESS_RESTART_EVENT"= Whether a JP1 event is issued when a process is restarted (used in an ISAM configuration to ensure compatibility) Windows
UNIX M, A

3 "SEND_SYSTEM_STARTSTOP_EVENT"= Whether a JP1 event is issued when JP1/AJS3 starts or stops Windows
UNIX M, A

4 "SEND_SYSTEM_CHILD_STARTSTOP_EVENT"= Whether a JP1 event is issued when a process starts or stops Windows
UNIX M

5 "SEND_SYSTEM_TERMINATED_ABNORMALLY_EVENT"= Whether a JP1 event is issued when a process terminates abnormally or times out at startup Windows
UNIX M, A

6 "SEND_SYSTEM_RESTART_EVENT"= Whether a JP1 event is issued when a process is restarted Windows
UNIX M, A

7 [{JP1_DEFAULT|logical-host-name}\JP1AJS2\HOST]^# "AJSSYSDIR"= The system folder of a host Windows
UNIX M

8 "AJSLOGDIR"= The log folder of a host Windows
UNIX M

9 "HOSTLOGSIZE"= The size of the scheduler log file of a host Windows
UNIX M

10 "HOSTLOGFILE1"= The name of the scheduler log file 1 of a host Windows
UNIX M

11 "HOSTLOGFILE2"= The name of the scheduler log file 2 of a host Windows
UNIX M

12 "HOSTLOGOUTPUTYEAR"= Setting for whether the year in the date of a host's scheduler log is to be output Windows
UNIX M

13 "HOSTLOGHEADER"= Whether a host's scheduler log history information is to be output with the process ID added Windows
UNIX M

14 "HLOGDLOG"= Setting for whether to output the start and stop history of the scheduler-log output process (ajshlogd.exe in Windows, or ajshlogd in UNIX) to the scheduler log for hosts Windows
UNIX M

15 "HLOGDSYSLOG"=

In Windows:

Setting for whether to output the start and stop history of the scheduler-log output process ajshlogd.exe to the Windows event log and the integrated trace log for hosts

In UNIX:

Setting for whether to output the start and stop history of the scheduler-log output process ajshlogd to the syslog file and the integrated trace log for hosts

Windows
UNIX M

16 [{JP1_DEFAULT|logical-host-name}\JP1AJS2\LOG_CONTROL\JAJS_SPM] "LOGSIZE"= The size of the system management log Windows
UNIX M, A

17 "LOGFILENUM"= The number of system management log files Windows
UNIX M, A

Legend:

M: JP1/AJS3 - Manager

A: JP1/AJS3 - Agent

#

Specify JP1_DEFAULT for the physical host. For logical-host-name, specify the name of a logical host.

The following describes each of the environment setting parameters:

Parameters that are not described here are used for maintenance purposes. Do not change the values of those parameters.

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

Organization of this section

(1) "SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT"=dword:Whether-to-issue-a-JP1-event-when-a-process-terminates-abnormally-or-times-out-at-startup

(2) "SEND_PROCESS_RESTART_EVENT"=dword:whether-to-issue-a-JP1-event-when-a-process-is-restarted

(3) "SEND_SYSTEM_STARTSTOP_EVENT"=dword:whether-to-issue-a-JP1-event-when-JP1/AJS3-is-started-or-stops

(4) "SEND_SYSTEM_CHILD_STARTSTOP_EVENT"=dword:Whether-to-issue-a-JP1-event-when-a-process-is-started-or-stops

(5) "SEND_SYSTEM_TERMINATED_ABNORMALLY_EVENT"=dword:Whether-to-issue-a-JP1-event-when-a-process-terminates-abnormally-or-times-out-at-startup

(6) "SEND_SYSTEM_RESTART_EVENT"=dword:Whether-to-issue-a-JP1-event-when-a-process-is-restarted

(7) "AJSSYSDIR"="name-of-system-directory"

(8) "AJSLOGDIR"="directory-name-for-log"

(9) "HOSTLOGSIZE"=dword:size-of-scheduler-log-file-for-a-host

(10) "HOSTLOGFILE1"="name-of-scheduler-log-file-1-for-a-host"

(11) "HOSTLOGFILE2"="name-of-scheduler-log-file-2-for-a-host"

(12) "HOSTLOGOUTPUTYEAR"="{yes|no}"

(13) "HOSTLOGHEADER"="{none|PID}"

(14) "HLOGDLOG"="{none|all}"

(15) "HLOGDSYSLOG"="{none|all}"

(16) "LOGSIZE"=dword:size-of-the-system-management-log

(17) "LOGFILENUM"=dword:Number-of-system-management-log-files

No.	Definition key	Environment setting parameter	Definition	Applicable OS	Applicable product
1	[{JP1_DEFAULT\|logical-host-name}\JP1AJS2]^#	"SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT"=	Whether a JP1 event is issued when a process terminates abnormally or times out at startup (used in an ISAM configuration to ensure compatibility)	Windows UNIX	M, A
2	"SEND_PROCESS_RESTART_EVENT"=	Whether a JP1 event is issued when a process is restarted (used in an ISAM configuration to ensure compatibility)	Windows UNIX	M, A
3	"SEND_SYSTEM_STARTSTOP_EVENT"=	Whether a JP1 event is issued when JP1/AJS3 starts or stops	Windows UNIX	M, A
4	"SEND_SYSTEM_CHILD_STARTSTOP_EVENT"=	Whether a JP1 event is issued when a process starts or stops	Windows UNIX	M
5	"SEND_SYSTEM_TERMINATED_ABNORMALLY_EVENT"=	Whether a JP1 event is issued when a process terminates abnormally or times out at startup	Windows UNIX	M, A
6	"SEND_SYSTEM_RESTART_EVENT"=	Whether a JP1 event is issued when a process is restarted	Windows UNIX	M, A
7	[{JP1_DEFAULT\|logical-host-name}\JP1AJS2\HOST]^#	"AJSSYSDIR"=	The system folder of a host	Windows UNIX	M
8	"AJSLOGDIR"=	The log folder of a host	Windows UNIX	M
9	"HOSTLOGSIZE"=	The size of the scheduler log file of a host	Windows UNIX	M
10	"HOSTLOGFILE1"=	The name of the scheduler log file 1 of a host	Windows UNIX	M
11	"HOSTLOGFILE2"=	The name of the scheduler log file 2 of a host	Windows UNIX	M
12	"HOSTLOGOUTPUTYEAR"=	Setting for whether the year in the date of a host's scheduler log is to be output	Windows UNIX	M
13	"HOSTLOGHEADER"=	Whether a host's scheduler log history information is to be output with the process ID added	Windows UNIX	M
14	"HLOGDLOG"=	Setting for whether to output the start and stop history of the scheduler-log output process (ajshlogd.exe in Windows, or ajshlogd in UNIX) to the scheduler log for hosts	Windows UNIX	M
15	"HLOGDSYSLOG"=	In Windows: Setting for whether to output the start and stop history of the scheduler-log output process ajshlogd.exe to the Windows event log and the integrated trace log for hosts In UNIX: Setting for whether to output the start and stop history of the scheduler-log output process ajshlogd to the syslog file and the integrated trace log for hosts	Windows UNIX	M
16	[{JP1_DEFAULT\|logical-host-name}\JP1AJS2\LOG_CONTROL\JAJS_SPM]	"LOGSIZE"=	The size of the system management log	Windows UNIX	M, A
17	"LOGFILENUM"=	The number of system management log files	Windows UNIX	M, A

(1) "SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT"=dword:Whether-to-issue-a-JP1-event-when-a-process-terminates-abnormally-or-times-out-at-startup

Use this parameter to specify whether to issue a JP1 event when a process terminates abnormally or times out at startup.

This parameter is valid only in an ISAM configuration to ensure compatibility. If you upgrade from an old version, the setting for this parameter is inherited.

Specifiable values

0

A JP1 event is not issued.

1

A JP1 event is issued.

Default value

dword:00000000 (0 in decimal)

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

(2) "SEND_PROCESS_RESTART_EVENT"=dword:whether-to-issue-a-JP1-event-when-a-process-is-restarted

Use this parameter to specify whether to issue a JP1 event when the process is restarted.

This parameter is valid only in an ISAM configuration to ensure compatibility. If you upgrade from an old version, the setting for this parameter is inherited.

Specifiable values

0

A JP1 event is not issued.

1

A JP1 event is issued.

Default value

dword:00000000 (0 in decimal)

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

(3) "SEND_SYSTEM_STARTSTOP_EVENT"=dword:whether-to-issue-a-JP1-event-when-JP1/AJS3-is-started-or-stops

Use this parameter to specify whether to issue a JP1 event when the JP1/AJS3 service starts or stops.

Specifiable values

0

A JP1 event is not issued.

1

A JP1 event is issued.

Default value

dword:00000000 (0 in decimal)

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

(4) "SEND_SYSTEM_CHILD_STARTSTOP_EVENT"=dword:Whether-to-issue-a-JP1-event-when-a-process-is-started-or-stops

Use this parameter to specify whether to issue a JP1 event when a process starts or stops.

The applicable processes are as follows:

In Windows:

Child process of jajs_spmd.exe

Child process of jajs_dbmd.exe, jajs_hstd.exe, jajs_agtd.exe, and jajs_schd.exe

In UNIX:

Child process of jajs_spmd

Child process of jajs_dbmd, jajs_hstd, jajs_agtd, and jajs_schd

For details about processes, see the B.2 Processes (for Windows) in the manual Job Management Partner 1/Automatic Job Management System 3 Troubleshooting or B.3 Processes (for UNIX) in the manual Job Management Partner 1/Automatic Job Management System 3 Troubleshooting.

Specifiable values

0

A JP1 event is not issued.

1

A JP1 event is issued.

Default value

dword:00000000 (0 in decimal)

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

(5) "SEND_SYSTEM_TERMINATED_ABNORMALLY_EVENT"=dword:Whether-to-issue-a-JP1-event-when-a-process-terminates-abnormally-or-times-out-at-startup

Use this parameter to specify whether to issue a JP1 event when a process terminates abnormally or times out at startup.

The applicable processes are as follows:

In Windows:

Child process of jajs_spmd.exe

Child process of jajs_dbmd.exe, jajs_hstd.exe, jajs_agtd.exe, and jajs_schd.exe

In UNIX:

Child process of jajs_spmd

Child process of jajs_dbmd, jajs_hstd, jajs_agtd, and jajs_schd

For details about the processes, see B.2 Processes (for Windows) in the manual Job Management Partner 1/Automatic Job Management System 3 Troubleshooting or B.3 Processes (for UNIX) in the manual Job Management Partner 1/Automatic Job Management System 3 Troubleshooting.

Specifiable values

0

A JP1 event is not issued.

1

A JP1 event is issued.

Default value

dword:00000000 (0 in decimal)

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

(6) "SEND_SYSTEM_RESTART_EVENT"=dword:Whether-to-issue-a-JP1-event-when-a-process-is-restarted

Use this parameter to specify whether to issue a JP1 event when a process is restarted.

Specifiable values

0

A JP1 event is not issued.

1

A JP1 event is issued.

Default value

dword:00000000 (0 in decimal)

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

(7) "AJSSYSDIR"="name-of-system-directory"

Use this parameter to specify the name of the directory in which the JP1/AJS3 system files are to be created. Specify a full path name.

Determine the name based on operating requirements and an estimate of required disk space.

Specifiable values

In Windows:
A character string of no more than 180 bytes

In UNIX:
A character string of no more than 191 bytes

Do not use either semicolons (;) or spaces ( ).

Default value

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

In Windows Server 2003:
JP1/AJS3-Manager-installation-folder\sys

In UNIX:
/var/opt/jp1ajs2/sys/

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service starts

(8) "AJSLOGDIR"="directory-name-for-log"

Use this parameter to specify the name of the directory in which JP1/AJS3 log files are to be created. Specify a full path name.

Determine the name based on operating requirements and an estimate of the required disk space.

Specifiable values

In Windows:
A character string of no more than 180 bytes

In UNIX:
A character string of no more than 191 bytes

Do not use either semicolons (;) or spaces ( ).

Default value

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

In Windows Server 2003:
JP1/AJS3-Manager-installation-folder\log

In UNIX:
/var/opt/jp1ajs2/log

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service starts

(9) "HOSTLOGSIZE"=dword:size-of-scheduler-log-file-for-a-host

Use this parameter to specify the size of log files.

The ajsinetd authentication error log (KAVS1009-W) and the log data when ajshlogd starts (KAVS0220-I) and when it stops (KAVS0221-I), are output to log files. However, if host is output to AJSLOGOUTPUTDEST, which is an environment setting parameter in scheduler service environment settings, the scheduler log of the appropriate scheduler service is output. Accordingly, specify a size sufficient for storing the data of at least one day so that you can check the execution status of a job or jobnet.

For details about how to estimate the log file size when specifying the settings for outputting the scheduler log of a scheduler service, see 3.4.1 Estimating the size of scheduler log files in the Job Management Partner 1/Automatic Job Management System 3 System Design (Configuration) Guide.

Specifiable values

A hexadecimal value (in kilobytes) from 0 to 1E8480 (0 to 2,000,000 in decimal).

If you specify dword:00000000, the system does not create a log file.

Default value

dword:00000000 (0 in decimal)

During a new installation and setup of JP1/AJS3, dword:00002800 (10,240 in decimal) is specified.

Recommended value

Set a value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

(10) "HOSTLOGFILE1"="name-of-scheduler-log-file-1-for-a-host"

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

Specify a file name that is different from the name of the scheduler log file 2 on any other host.

When the amount of information written to this log file equals or is greater than the specified size, the system writes subsequent information to log file 2.

Specify a unique file name that is not used on any other logical host.

In UNIX, you cannot omit this parameter if you use a scheduler log file for a host.

Specifiable values

A character string of no more than 255 bytes

Default value

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

In Windows Server 2003:
JP1/AJS3-Manager-installation-folder\log\ajs-host-log1.log

In UNIX:
/var/opt/jp1ajs2/log/ajs-host-log1.log

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service starts

(11) "HOSTLOGFILE2"="name-of-scheduler-log-file-2-for-a-host"

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

Specify a unique file name that is not used on any other logical host.

In UNIX, you cannot omit this parameter when you use a scheduler log file for a host.

Specifiable values

A character string of no more than 255 bytes

Default value

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

In Windows Server 2003:
JP1/AJS3-Manager-installation-folder\log\ajs-host-log2.log

In UNIX:
/var/opt/jp1ajs2/log/ajs-host-log2.log

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service starts

(12) "HOSTLOGOUTPUTYEAR"="{yes|no}"

Use this parameter to specify whether to output the year as part of the date of a host's scheduler log. The scheduler log is specified when you specify the HOSTLOGFILE1 and HOSTLOGFILE2 environment setting parameters.

Change the parameter value if you use the year to manage scheduler log information.

Specifiable values

yes

The year is output. The system outputs the year, month, and day in the date section.

no

The year is not output. The system outputs only the month and day in the date section.

Default value

no

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

(13) "HOSTLOGHEADER"="{none|PID}"

Use this parameter value to specify whether to output the history information with the process ID added in a host's scheduler log file.

Change the parameter value to output history information without adding process ID information.

Specifiable values

none

A process ID is not added to the history information to be output.

PID

A process ID is added to the history information to be output.

Default value

none

During a new installation and setup of JP1/AJS3, PID is set.

Recommended value

PID

When the setting takes effect

The next time the JP1/AJS3 service starts

(14) "HLOGDLOG"="{none|all}"

Use this parameter value to specify whether to output the start and stop messages related to the scheduler-log output process (ajshlogd.exe in Windows, or ajshlogd in UNIX) to the scheduler log for hosts.

Specifiable values

none

Does not output messages related to starting and stopping the scheduler-log output process for hosts.

all

Outputs messages KAVS0220-I and KAVS0221-I, which are the messages related to starting and stopping the scheduler-log output process for hosts.

Default value

none

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts or stops

(15) "HLOGDSYSLOG"="{none|all}"

In Windows:

Use this parameter value to specify whether to output the start and stop messages related to the scheduler-log output process ajshlogd.exe to the Windows event log and the integrated trace log for hosts.

In UNIX:

Use this parameter value to specify whether to output the start and stop messages related to the scheduler-log output process ajshlogd to the syslog and the integrated trace log for hosts.

Specifiable values

none

Does not output messages related to starting and stopping the scheduler-log output process for hosts.

all

Outputs messages KAVS0220-I and KAVS0221-I, which are the messages related to starting and stopping the scheduler-log output process for hosts.

Default value

none

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts or stops

(16) "LOGSIZE"=dword:size-of-the-system-management-log

Use this parameter to specify the size of the system management log.

Specifiable values

A hexadecimal value (in bytes) from 1000 to 7FFFFFFF (4,096 to 2,147,483,647 in decimal)

Default value

dword:1F400 (128,000 in decimal)

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service starts

Cautionary note

If the value specified for the log file size and the number of log files are too small, you might not be able to identify the cause of an error. When you change the log file size, do not specify a log file size smaller than the default value.

(17) "LOGFILENUM"=dword:Number-of-system-management-log-files

Use this parameter to specify the number of system management log files.

Specifiable values

A hexadecimal value from 1 to 10 (1 to 16 in decimal)

Default value

dword:00000003 (3 in decimal)

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service starts

Cautionary note

If the value specified for the log file size and the number of log files are too small, you might not be able to identify the cause of an error. When you change the number of log files, do not specify a value smaller than the default value.

[Contents][Back][Next]

[Trademarks]