Job Management Partner 1/Automatic Job Management System 3 Troubleshooting

2.12 Troubleshooting problems related to invalid ISAM files

This section describes how to check the status of invalid ISAM files and how to re-create ISAM files.

If the ISAM files for the execution environment database for JP1/AJS3 QUEUE jobs and submit jobs become invalid, problems such as failure to start a job that uses a queue might occur. In such cases, perform the procedure described in (2) Procedure for re-creating the execution environment database for QUEUE jobs and submit jobs.

Organization of this section

(1) Procedure for checking the status of ISAM files

(2) Procedure for re-creating the execution environment database for QUEUE jobs and submit jobs

(1) Procedure for checking the status of ISAM files

The following describes the procedure for checking the status of ISAM files.

If ISAM files are invalid, re-create them.

To check the status of ISAM files:

Stop the JP1/AJS3 service.

Execute the Jischk command to check whether the ISAM files are valid.

For Windows hosts:

Jischk -l 3 job-execution-environment-database-storage-directory-name\JPQ*

Cautionary note

As the database storage directory for the job execution environment, specify the directory name specified in the DatabasePath environment setting parameter.

The default directory name is as follows:

For Windows Server 2008:

%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\database\queue

(The default value for %ALLUSERSPROFILE% is system-drive\ProgramData.)

For Windows Server 2003:

JP1/AJS3 - Manager-installation-folder\database\queue

For UNIX hosts:

/opt/jp1base/bin/Jischk -l 3 /var/opt/jp1ajs2/database/queue/JPQ*

Cautionary note

For logical hosts, the default is shared-directory-name/jp1ajs2/database/queue/JPQ*.

Check the output messages.
If one of the following messages is output, the corresponding ISAM file is invalid:

KAIU013-E Invalid key definition file detected.

KAIU014-E Invalid key file detected.

KAIU015-E Invalid data file detected.

For details about the Jischk command and the messages it outputs, see the Job Management Partner 1/Base User's Guide.

(2) Procedure for re-creating the execution environment database for QUEUE jobs and submit jobs

To re-create the database used by the execution environment for QUEUE jobs and submit jobs:

Make sure that the JP1/AJS3 service is not running.

Use the jpqexport command to back up the definition of the execution environment for QUEUE jobs and submit jobs.

In Windows:

jpqexport [-mh logical-host-name] -dt isam -co jpqsetup.conf^#

In UNIX:

/opt/jp1ajs2/bin/jpqexport [-mh logical-host-name] -dt isam -co jpqsetup.conf^#

Although you can use any file name, for management purposes, we recommend that you use jpqsetup.conf.

#

Specify -mh logical-host-name to match the operating environment.

Depending on how an ISAM file is corrupted, attempts by the jpqexport command to access the file might result in an error. If you created a backup of the configuration definition file for the execution environment for QUEUE jobs and submit jobs (jpqsetup.conf), use it. If you do not have a backup, see jpqimport in 3. Commands Used for Special Operation in the manual Job Management Partner 1/Automatic Job Management System 3 Command Reference 2, and create the configuration definition file for the execution environment for QUEUE jobs and submit jobs.

Delete the files and temporary files in the database storage directory for the execution environment for QUEUE jobs and submit jobs.

In Windows:

del execution-environment-database-storage-directory-for-QUEUE-jobs-and-submit-jobs\*^#1

del work-directory-when-execution-environment-manager-process-for-QUEUE-jobs-and-submit-jobs-is-executing\M_JPQ*^#2

#1:

The directory containing the execution environment database for QUEUE jobs and submit jobs is the folder specified in the DatabasePath environment setting parameter in [{JP1_DEFAULT|logical-host-name}\JP1NBQMANAGER\Database].

The default storage directory is as follows:

- Windows Server 2008

For the physical host, the default storage directory is %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\\database\queue. For logical hosts, the default storage directory is shared-folder\jp1ajs2\database\queue.

The default value for %ALLUSERSPROFILE% is system-drive\ProgramData.

- Windows Server 2003

For the physical host, the default storage directory is JP1/AJS3 - Manager-installation-folder\database\queue. For logical hosts, the default storage directory is shared-folder\jp1ajs2\database\queue.

#2:

When the execution environment manager process for QUEUE jobs and submit jobs is executed, the work directory is the folder specified in the WorkPath environment setting parameter in [{JP1_DEFAULT|logical-host-name}\JP1AJSMANAGER\SCHEDULER\scheduler-service-name\QUEUE\MANAGER\PROCESS].

For the physical host, the default work directory is JP1/AJS3 - Manager-installation-folder\tmp. For logical hosts, the default work directory is shared-folder\jp1ajs2\tmp.

In UNIX:

rm execution-environment-database-storage-directory-for-QUEUE-jobs-and-submit-jobs/*^#1

rm work-directory-when-execution-environment-manager-process-for-QUEUE-jobs-and-submit-jobs-is-executing/M_JPQ*^#2

#1: The directory containing the execution environment database for QUEUE jobs and submit jobs is the directory specified in the DatabasePath environment setting parameter in [{JP1_DEFAULT|logical-host-name}\JP1NBQMANAGER\Database].

For the physical host, the default storage directory is /var/opt/jp1ajs2/database/queue. For logical hosts, the default storage directory is shared-directory/jp1ajs2/database/queue.

#2: When the execution environment manager process for QUEUE jobs and submit jobs is executed, the work directory is the directory specified in the WorkPath environment setting parameter in [{JP1_DEFAULT|logical-host-name}\JP1AJSMANAGER\SCHEDULER\scheduler-service-name\QUEUE\MANAGER\PROCESS].

For the physical host, the default work directory is /var/opt/jp1ajs2/tmp. For logical hosts, the default work directory is shared-directory/jp1ajs2/tmp.

Use the jpqimport command to re-create the ISAM files by using the file you backed up in step 2 as the execution environment definition for QUEUE jobs and submit jobs.

In Windows:

jpqimport [-mh logical-host-name] -dt isam -ci jpqsetup.conf^#

In UNIX:

/opt/jp1ajs2/bin/jpqimport [-mh logical-host-name] -dt isam -ci jpqsetup.conf^#

#

Specify -mh logical-host-name to match the operating environment.

Check the messages that are output when you execute the jpqimport command, and check whether the ISAM files are created successfully.
If the jpqimport command did not terminate normally, you will not be able to start the JP1/AJS3 service. If you are unsure as to whether the command was executed successfully, use the jpqexport command as described in step 2 to output the definition again. Then check whether the agent definition and queue definition in the definition output before re-creation of the ISAM files matches those in the definition after re-creation.

Restart the JP1/AJS3 service.

For details about the jpqexport and jpqimport commands, see 2. Commands Used during Setup in the manual Job Management Partner 1/Automatic Job Management System 3 Command Reference 2 or 3. Commands Used for Special Operation in the manual Job Management Partner 1/Automatic Job Management System 3 Command Reference 2.

For details about the jbsgetcnf command, see the Job Management Partner 1/Base User's Guide.

[Contents][Back][Next]

[Trademarks]