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

[Contents][Glossary][Index][Back][Next]

2.5 Setting for the JP1/AJS3 definition pre-check function

The JP1/AJS3 definition pre-check function requires different settings in the manager environment (JP1/AJS3 - Manager) and the agent environment (JP1/AJS3 - Agent).

For details about the JP1/AJS3 definition pre-check function, see 6.5.1 Setting up the JP1/AJS3 definition pre-check function in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for Windows) or 14.5.1 Setting up the JP1/AJS3 definition pre-check function in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for UNIX).

The table below lists the environment setting parameters to be used to set the definition pre-check function in the manager environment (JP1/AJS3 - Manager) and 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-5 Environment setting parameters (settings for the JP1/AJS3 definition pre-check function)

No. Definition key Environment setting parameter Definition Applicable OS Applicable product
1 [JP1_DEFAULT\JP1AJS2\CHECK] "AJSCHK_CHECKFILE"= Name of the file that contains the definition pre-check result Windows
UNIX		 M
2 "AJSCHK_LOGDIR"= Name of the directory for the definition check log Windows
UNIX		 M, A
3 "AJSCHK_LOGSIZE"= Size of the definition check log file Windows
UNIX		 M, A
4 "AJSCHK_TRACELOGFILE"= Name of the trace log file for the definition pre-check function Windows
UNIX		 M, A
5 "AJSCHK_CHARCODE"= Character set used for displaying job information or the definition pre-check result Windows
UNIX		 M, A

Legend:
M: JP1/AJS3 - Manager
A: JP1/AJS3 - Agent

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) "AJSCHK_CHECKFILE"="name-of-the-file-used-to-store-the-definition-pre-check-result"
(2) "AJSCHK_LOGDIR"="name-of-the-directory-for-the-definition-check-log"
(3) "AJSCHK_LOGSIZE"=dword:log-file-size
(4) "AJSCHK_TRACELOGFILE"="name-of-the-trace-log-file"
(5) "AJSCHK_CHARCODE"="{none|C}"

(1) "AJSCHK_CHECKFILE"="name-of-the-file-used-to-store-the-definition-pre-check-result"

Use this parameter to specify the name of the file used to the definition pre-check result. Specify a full path name.

If the directory specified for name-of-file-used-to-store-definition-pre-check-result does not exist, the file used to store the definition pre-check result will not be output.

Specifiable values
A character string of no more than 255 bytes

Default value
  • In Windows Server 2008:
    %ALLUSERSPROFILE%\HITACHI\JP1\JP1_DEFAULT\JP1AJS2\log\ajscheckfile.txt
    (The default value of %ALLUSERSPROFILE% is system-drive\ProgramData.)
  • In Windows Server 2003:
    JP1/AJS3-Manager-installation-folder\log\ajscheckfile.txt
  • In UNIX:
    /var/opt/jp1ajs2/log/ajscheckfile.txt

Recommended value
Set the value appropriate for the operating environment.

When the setting takes effect
After the JP1/AJS3 Check Manager service is restarted

(2) "AJSCHK_LOGDIR"="name-of-the-directory-for-the-definition-check-log"

Use this parameter to specify the name of the directory to which the log for the definition pre-check process is output. Specify a full path name.

If the directory specified for name-of-directory-for-definition-check-log does not exist, the definition check log will not be output.

Log data is written to the ajscheck1.log file under the directory specified in this parameter. If the log data written to the ajscheck1.log reaches the size limit specified in the AJSCHK_LOGSIZE environment setting parameter, the writing of log data continues to the ajscheck2.log file.

Specifiable values
A character string of no more than 180 bytes

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 or JP1/AJS3-Agent-installation-folder\log
  • In UNIX:
    /var/opt/jp1ajs2/log

Recommended value
Set the value appropriate for the operating environment.

When the setting takes effect
After the JP1/AJS3 Check Manager service or the JP1/AJS3 Check Agent service is restarted

(3) "AJSCHK_LOGSIZE"=dword:log-file-size

Use this parameter to specify the size of the log file to which log data is output by the definition pre-check process.

The specified size is to the size definition check log file 1 (ajscheck1.log) and of definition check log file 2 (ajscheck2.log).

Specifiable values
0, or a value (in kilobytes) from 4 to 1E8480 in hexadecimal (0, or a value from 4 to 2,000,000 in decimal)

Default value
dword:00001000 (4,096 in decimal)

Recommended value
Set the value appropriate for the operating environment.

When the setting takes effect
After the JP1/AJS3 Check Manager service or the JP1/AJS3 Check Agent service is restarted

Cautionary note
When the information written to file 1 reaches the limit specified in this parameter, the writing of information switches to file 2. When the information written to file 2 reaches the limit, the writing of information switches back to file 1 and existing information is overwritten. Because the repeated switching between files 1 and 2 continually overwrites older information, you must be especially careful when specifying the file size.

(4) "AJSCHK_TRACELOGFILE"="name-of-the-trace-log-file"

Use this parameter to specify the name of the trace log file for the definition pre-check function. Specify a full path name.

If the directory specified for name-of-trace-log-file does not exist, the trace log will not be output.

Specifiable values
A character string of no more than 255 bytes

Default value
The setup processing assumes the following file name:
  • In Windows Server 2008:
    %ALLUSERSPROFILE%\HITACHI\JP1\JP1_DEFAULT\JP1AJS2\log\tracelog.ch
    (The default value of %ALLUSERSPROFILE% is system-drive\ProgramData.)
  • In Windows Server 2003:
    JP1/AJS3-Manager-installation-folder\log\tracelog.ch or JP1/AJS3-Agent-installation-folder\log\tracelog.ch
  • In UNIX:
    /var/opt/jp1ajs2/log/tracelog.ch
If you do not specify a file name, a trace log is not output.

Recommended value
Set the value appropriate for the operating environment.

When the setting takes effect
After the JP1/AJS3 Check Manager service or the JP1/AJS3 Check Agent service is restarted

(5) "AJSCHK_CHARCODE"="{none|C}"

Use this parameter to specify the character set used to display the job information or the results of the definition pre-check.

Note that the LANG environment variable used during the definition pre-check is the same as the LANG environment variable used when the JP1/AJS3 Check Agent service is started.

Specifiable values

none
The 7-bit ASCII character set is used. There is no code conversion between JP1/AJS3 - Manager and JP1/AJS3 - Agent.
none cannot be specified by using the jajs_config command. To specify this value, use the jbssetcnf command. For details on the jbssetcnf command, see the Job Management Partner 1/Base User's Guide.

C
The 7-bit ASCII character set is used. There is no code conversion between JP1/AJS3 - Manager and JP1/AJS3 - Agent.

Default value
none

Recommended value
Set the value appropriate for the operating environment.

When the setting takes effect
After the JP1/AJS3 Check Manager service or the JP1/AJS3 Check Agent service is restarted

Cautionary note
In the following cases, the job information and the definition pre-check results are displayed by using the character set specified in the AJSCHARCODE environment setting parameter.
  • C is specified for the AJSCHARCODE environment setting parameter.

[Contents][Back][Next]

[Trademarks]

Copyright (C) 2009, 2010, Hitachi, Ltd.
Copyright (C) 2009, 2010, Hitachi Solutions, Ltd.