Notices

Summary of amendments

Preface

Part 1: Windows Host

1. Types of JP1/AJS3 System Configuration and System Setup Procedures

1.1 Overview of setting up JP1/AJS3

1.1.1 Procedure for setting up a system with JP1/AJS3 - Manager and JP1/AJS3 - View

1.1.2 Procedure for setting up a system in a manager/agent configuration that uses only one JP1/AJS3 - Manager host

1.1.3 Procedure for setting up a system in a manager/agent configuration that uses several JP1/AJS3 - Manager hosts

2. Installation

2.1 Required task before installing JP1/AJS3 series programs

2.1.1 Installing JP1/Base

2.2 Installing JP1/AJS3 series programs

2.2.1 Notes on installation

2.2.2 Installing a JP1/AJS3 series program

3. Setup

3.1 Required setup for JP1/AJS3 - Manager

3.1.1 Setting up JP1/Base

3.1.2 Setting up JP1/AJS3 - Manager

3.2 Required setup for JP1/AJS3 - Agent

3.2.1 Setting up JP1/Base

3.2.2 Setting up JP1/AJS3 - Agent

3.3 Required setup for JP1/AJS3 - View

3.4 Required setup for JP1/AJS3 Console

3.4.1 Setting up JP1/AJS3 Console Manager

3.4.2 Setting up JP1/AJS3 Console Agent

3.4.3 Setting up JP1/AJS3 Console View

3.5 Setting up the system and user environments

3.5.1 Extending trace log files

3.5.2 Specifying communication environment settings

4. Environment Settings

4.1 Execution agent settings

4.2 Environment setting parameter settings

5. JP1/AJS3 - View Environment Settings

5.1 Procedure for changing the JP1/AJS3 - View environment settings

5.2 Procedure for changing the JP1/AJS3 Console View environment settings

6. Specifying Settings Based on the Usage of JP1/AJS3

6.1 Settings for controlling the scheduler

6.1.1 Settings for starting multiple scheduler services

6.1.2 Changing the level of messages output from scheduler services to the integrated trace log

6.1.3 Changing the method for outputting the schedule rule when outputting nested-jobnet definition parameters

6.1.4 Changing the name of a scheduler trace log file

6.1.5 Enabling the suspension function

6.1.6 Changing the mode in which unregistration or generation management deletes the generations of a jobnet

6.2 Settings for controlling job execution

6.2.1 Defining variables for work paths used during job execution

6.2.2 Defining search paths for a file to be transferred

6.2.3 Customizing the execution agent or agent attribute values created by the automatic agent definition function

6.2.4 Checking the messages output at the same time by a job to the standard output and standard error output

6.2.5 Changing the interval and number of resend attempts for job result files

6.2.6 Preventing duplicated reception of job result files

6.2.7 Placing restrictions on file reception

6.2.8 Changing the interval and number of retry attempts when a TCP/IP connection error occurs

6.2.9 Setting the method for determining the agent host to which a job will be delivered

6.2.10 Setting the action to be taken if the value of a macro variable cannot be passed

6.2.11 Setting the handling of a macro variable when the value is a NULL string

6.2.12 Changing the wait time for recovery when an agent has failed

6.2.13 Outputting a message that reports that the maximum number of concurrently executable jobs has been reached

6.2.14 Changing the timeout value for the job execution control manager process

6.2.15 Executing a job by using a long file name

6.2.16 Executing a job that requires a user profile

6.2.17 Reusing access tokens for job execution

6.2.18 Executing a job whose executable file name has an extension longer than three bytes

6.2.19 Changing the settings for logon retries when a job is executed

6.2.20 Placing all running jobs in an end status when a communication error occurs

6.3 Changing the settings related to event/action control

6.3.1 Changing the settings related to the size of the log for event jobs to match operational requirements

6.3.2 Setting the event order option

6.3.3 Setting the status passing option for the file monitoring job

6.3.4 Passing event data containing double quotation marks

6.3.5 Using fully qualified domain names (FQDN) when using event jobs during DNS operation

6.3.6 Resuming event jobs that stopped when the JP1/AJS3 service stopped

6.3.7 Retrying startup notification of the event/action control agent

6.3.8 Setting the agent host name resolution option

6.3.9 Applying a timeout for receiving data in inter-process communication by event/action control

6.3.10 Setting the period of time for monitoring event jobs in the blocked status

6.3.11 Setting the binding method applied to the outgoing communication used in the execution of event jobs

6.3.12 Settings for ensuring that the sending of unreported information is retried at regular intervals

6.3.13 Changing the send retry interval and the number of retries for sending unreported information

6.3.14 Setting the connection timeout for communication between the event/action control manager and agent

6.3.15 Environment setting parameters related to communication for event/action control

6.3.16 Settings for ensuring that a fixed manager host name is used when event jobs are executed

6.4 Changing the settings related to queueless job execution control

6.4.1 Executing jobs with a class specified in a queueless job environment

6.4.2 Executing a job that requires a user profile in a queueless job execution environment

6.4.3 Preventing a queueless job from ending abnormally with return value 128

6.5 Changing the settings related to the definition pre-check function

6.5.1 Setting up the JP1/AJS3 definition pre-check function

6.6 Other settings

6.6.1 Canceling and re-setting service dependencies

6.6.2 Disabling file system redirection when jobs are executed in a WOW64 environment

6.6.3 Changing the JP1/AJS3 database configuration to the standard configuration without ISAM

7. Collecting Log Data

7.1 Collecting log data

8. Setup for Operation in a Cluster System

8.1 Installation and setup required for cluster system operation

8.1.1 Installation required for cluster system operation

8.1.2 Setup required for cluster system operation

8.1.3 Monitoring in cluster system operation

8.2 Setting up the operating environment for cluster system operation

8.2.1 Environment setup items for a cluster system

8.2.2 Procedure for setting up the environment for a cluster system

8.2.3 Changing the common definition information

8.2.4 Registering the JP1/AJS3 service in the cluster software

8.2.5 Setting up the queueless job execution environment

8.2.6 Deleting logical hosts

8.2.7 Setting startup of multiple scheduler services on a logical host

8.3 Notes on cluster operation

9. Uninstallation

9.1 Uninstalling JP1/Base

9.2 Uninstalling JP1/AJS3 series programs

Part 2: UNIX Host

10. Types of JP1/AJS3 System Configuration and System Setup Procedures

10.1 Overview of setting up JP1/AJS3

10.1.1 Procedure for setting up a system with JP1/AJS3 - Manager and JP1/AJS3 - View

10.1.2 Procedure for setting up a system in a manager/agent configuration that uses only one JP1/AJS3 - Manager host

10.1.3 Procedure for setting up a system in a manager/agent configuration that uses several JP1/AJS3 - Manager hosts

11. Installation

11.1 Required task before installing JP1/AJS3 series programs

11.1.1 Installing JP1/Base

11.2 Installing JP1/AJS3 series programs

11.2.1 Notes on installation

11.2.2 Installation in HP-UX

11.2.3 Installation in Solaris

11.2.4 Installation in AIX

12. Setup

12.1 Required setup for JP1/AJS3 - Manager

12.1.1 Setting up JP1/Base

12.1.2 Setting up JP1/AJS3 - Manager

12.2 Required setup for JP1/AJS3 - Agent

12.2.1 Setting up JP1/Base

12.2.2 Setting up JP1/AJS3 - Agent

12.3 Required setup for JP1/AJS3 Console

12.3.1 Setting up JP1/AJS3 Console Manager

12.3.2 Setting up JP1/AJS3 Console Agent

12.4 Setting up the system and user environments

12.4.1 Changing the login scripts

12.4.2 Tuning kernel parameters

12.4.3 Extending trace log files

12.4.4 Specifying communication environment settings

13. Environment Settings

13.1 Execution agent settings

13.2 Environment setting parameter settings

14. Specifying Settings Based on the Usage of JP1/AJS3

14.1 Settings for controlling the scheduler

14.1.1 Settings for starting multiple scheduler services

14.1.2 Changing the level of messages output from scheduler services to the integrated trace log

14.1.3 Changing the method for outputting the schedule rule when outputting nested-jobnet definition parameters

14.1.4 Changing the name of a scheduler trace log file

14.1.5 Enabling the suspension function

14.1.6 Changing the mode in which unregistration or generation management deletes the generations of a jobnet

14.2 Settings for controlling job execution

14.2.1 Defining variables for work paths used during job execution

14.2.2 Defining search paths for a file to be transferred

14.2.3 Customizing the execution agent or agent attribute values created by the automatic agent definition function

14.2.4 Checking the messages output at the same time by a job to the standard output and standard error output

14.2.5 Changing the interval and number of resend attempts for job result files

14.2.6 Preventing duplicated reception of job result files

14.2.7 Placing restrictions on file reception

14.2.8 Changing the interval and number of retry attempts when a TCP/IP connection error occurs

14.2.9 Setting the method for determining the agent host to which a job will be delivered

14.2.10 Setting the action to be taken if the value of a macro variable cannot be passed

14.2.11 Setting the handling of a macro variable when the value is a NULL string

14.2.12 Changing the wait time for recovery when an agent has failed

14.2.13 Outputting a message that reports that the maximum number of concurrently executable jobs has been reached

14.2.14 Changing the timeout value for the job execution control manager process

14.2.15 Changing the timeout value for pipe communication of the agent

14.2.16 Setting the timeout value for receiving notification from the job process that execution is ready

14.2.17 Applying SIG_DFL (setting for receiving the SIGCHLD signal) to a child process started from JP1/AJS3

14.2.18 Enabling the file access permission check for the ACL and secondary group settings during job execution

14.2.19 Placing all running jobs in an end status when a communication error occurs

14.3 Changing the settings related to event/action control

14.3.1 Changing the settings related to the size of the log for event jobs to match operational requirements

14.3.2 Setting the event order option

14.3.3 Setting the status passing option for the file monitoring job

14.3.4 Passing event data containing double quotation marks

14.3.5 Using fully qualified domain names (FQDN) when using event jobs during DNS operation

14.3.6 Resuming event jobs that stopped when the JP1/AJS3 service stopped

14.3.7 Retrying startup notification of the event/action control agent

14.3.8 Setting the agent host name resolution option

14.3.9 Applying a timeout for receiving data in inter-process communication by event/action control

14.3.10 Setting the period of time for monitoring event jobs in the blocked status

14.3.11 Setting the binding method applied to the outgoing communication used in the execution of event jobs

14.3.12 Enabling monitoring of a large file

14.3.13 Settings for ensuring that the sending of unreported information is retried at regular intervals

14.3.14 Changing the send retry interval and the number of retries for sending unreported information

14.3.15 Setting the connection timeout for communication between the event/action control manager and agent

14.3.16 Environment setting parameters related to communication for event/action control

14.3.17 Settings for ensuring that a fixed manager host name is used when event jobs are executed

14.4 Changing the settings related to queueless job execution control

14.4.1 Executing jobs with a class specified in a queueless job environment

14.5 Changing the settings related to the definition pre-check function

14.5.1 Setting up the JP1/AJS3 definition pre-check function

14.6 Settings common to all control processes

14.6.1 Settings for outputting error messages for jobs to syslog

14.7 Other settings

14.7.1 Setting automatic startup and termination of the JP1/AJS3 service

14.7.2 Changing the JP1/AJS3 database configuration to the standard configuration without ISAM

15. Collecting Log Data

15.1 Collecting log data

16. Setup for Operation in a Cluster System

16.1 Installation and setup required for cluster system operation

16.1.1 Installation required for cluster system operation

16.1.2 Setup required for cluster system operation

16.1.3 Monitoring in cluster system operation

16.2 Setting up the operating environment for cluster system operation

16.2.1 Environment setup items for a cluster system

16.2.2 Procedure for setting up the environment for a cluster system

16.2.3 Changing the common definition information

16.2.4 Registering the JP1/AJS3 service in the cluster software

16.2.5 Setting up the queueless job execution environment

16.2.6 Deleting logical hosts

16.2.7 Setting startup of multiple scheduler services on a logical host

16.2.8 Specifying the settings that control startup and termination of JP1/AJS3 in a logical host environment

16.3 Notes on cluster operation

17. Uninstallation

17.1 Uninstalling JP1/Base

17.2 Uninstalling JP1/AJS3 series programs

17.2.1 Uninstallation in HP-UX

17.2.2 Uninstallation in Solaris

17.2.3 Uninstallation in AIX

Appendixes

A. Checking the Installation and Setup

A.1 Installation and setup checklists (Windows host)

A.2 Installation and setup checklists (UNIX host)

B. Scheduler Database Estimates

B.1 Estimating the amount of required database area

C. Advanced Setup of an Embedded Database

C.1 Preparation for using an embedded database

C.2 Setting up an embedded database

D. Advanced Setup for the Embedded Database (in a Cluster Configuration)

D.1 Preparation for using an embedded database

D.2 Setting up an embedded database (on the primary node)

D.3 Setting up an embedded database (on the secondary node)

D.4 Changing the settings of an embedded database in a cluster configuration

E. Recovery Procedure Used When An Incorrect Environment Settings Parameter Is Set

E.1 For Windows

E.2 For UNIX

F. Values Recommended for the Environment Settings Set in JP1/AJS3

G. Version Revisions

G.1 Revisions in 09-00

G.2 Revisions in 08-00

G.3 Revisions in 07-50

G.4 Revisions in 07-00

H. Changes in 3020-3-S05-04(E)

I. Glossary

Index

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