Job Management Partner 1/Automatic Job Management System 3 - Web Operation Assistant Description, Operator's Guide and Reference

3.3.1 How to define the configuration file (environment settings parameters)

The configuration file (ajs2woa.conf) used for setting up the JP1/AJS3 - Web Operation Assistant environment contains information necessary for environment settings. To change this information, replace the appropriate contents in the configuration file.

Organization of this subsection

(1) Procedures for defining the configuration file

(2) Items set in the configuration file

(1) Procedures for defining the configuration file

The configuration file contains several default values, which you can change to suit the JP1/AJS3 - Web Operation Assistant environment.

To define the configuration file:

1. Stop the HTTP server.
   On the JP1/AJS3 - Web Operation Assistant host, from Windows Control Panel, choose Administrative Tools and Services, and then stop the following service:
   JP1/AJS3 WOA HTTP Server
   
2. Stop the application server.
   On the JP1/AJS3 - Web Operation Assistant host, from Windows Control Panel, choose Administrative Tools and Services, and then stop the following service:
   JP1/AJS3 WOA Web Application Server
   
3. Open the following file in a text editor, such as Notepad:
   

    
   JP1/AJS3 - Web-Operation-Assistant-installation-folder\conf\ajs2woa.conf
    

4. Edit the definition contents as necessary.
5. Save the file, and execute the following command:
   

    
   jbssetcnf file-name
    

   Note that the path of the jbssetcnf command is JP1/Base-installation-folder\bin\jbssetcnf.
   
   For details about the jbssetcnf command, see the manual Job Management Partner 1/Base User's Guide.
   
6. Start the application server.
   On the JP1/AJS3 - Web Operation Assistant host, from Windows Control Panel, choose Administrative Tools and Services, and then start the following service you stopped in step 2:
   JP1/AJS3 WOA Web Application Server
   
7. Start the HTTP server.
   On the JP1/AJS3 - Web Operation Assistant host, from Windows Control Panel, choose Administrative Tools and Services, and then start the following service you stopped in step 1:
   JP1/AJS3 WOA HTTP Server
   The contents of the settings file are applied to configuration file.
   

Note

Before executing the jbssetcnf command, terminate any running JP1 series programs that require JP1/Base.

(2) Items set in the configuration file

(a) List of environment settings parameters in the configuration file

Configuration information for JP1/AJS3 - Web Operation Assistant can be set in the definition key JP1_DEFAULT\JP1AJS2WOA.

The following table lists the environment settings parameters to be defined in the JP1/AJS3 - Web Operation Assistant configuration file.

Table 3-1 List of environment settings parameters (ajs2woa.conf)

Environment settings parameter	Description and default value
"HNTRLOGLEVEL"=	The level of the log output to HNTR, error by default.
"IPC_TIMEOUT"=	The transmission timeout time, dword:00000000 by default.
"IPCRETRYINTERVAL"=	The transmission retry interval, dword:00000001 by default.
"IPCRETRYCOUNT"=	The transmission retry count, dword:00000003 by default.

(b) Details about environment settings parameters

The following describes the environment settings parameters in detail.

"HNTRLOGLEVEL"="{none|error|warn|info}"

Specifies one of the following message levels to be output to the integrated trace log.

none

No messages are output.

error

Error messages are output.

warn

Error messages and warning messages are output.

info

Error messages, warning messages, and notifications are output.

The default is error.

"IPC_TIMEOUT"=dword:transmission-timeout-time

Specifies the number of seconds to wait for transmissions with JP1/AJS3 - Manager or JP1/AJS2 - Manager (timeout time), in hexadecimal notation, from 0 to 258 (0 to 600 in decimal notation). The default is dword:00000000. An error occurs when transmission cannot take place within the specified time. When dword:00000000 is specified, the timeout time for the OS will take effect.

"IPCRETRYINTERVAL"=dword:transmission-retry-interval

Specifies the number of seconds after which transmission is attempted after a transmission error occurs, in hexadecimal notation, from 0 to A (0 to 10 in decimal notation). The default is dword:00000001. The value specified here is added to the interval for each retry that occurs.

"IPCRETRYCOUNT"=dword:transmission-retry-count

Specifies the number of retries to take place after a transmission error, in hexadecimal notation, from 0 to 64 (0 to 100 in decimal notation). The default is dword:00000003.

[Contents][Back][Next]

Copyright (C) 2010, Hitachi, Ltd.
Copyright (C) 2010, Hitachi Software Engineering Co., Ltd.