jajs_maintain

Format

jajs_maintain
     [-h logical-host-name]
     [-F scheduler-service-name]
     {-m {manager|scheduler}|-show|-r start}
     [-x degree-of-parallelism]
     [-c disconnection-status-monitoring-time]

To Page Top

Description

The jajs_maintain command performs maintenance of the JP1/AJS3 ISAM database.

To Page Top

Execution privileges

In Windows: Administrators privileges

In UNIX: Superuser privileges

To Page Top

Arguments

To Page Top

Notes

1. During maintenance of the job execution environment, you cannot execute job entry and execution commands. Using such commands causes an error message KAVU0950-E to appear in the standard error output file.

2. If you attempt to operate a unit from JP1/AJS3 - View during maintenance of scheduler service, a KAVV461-E The connection is not possible because the specified scheduler service is under maintenance. message appears in the message box.

   When you execute a command that manipulates a unit, a KAVS1717-E Maintenance is being performed, so execution is impossible message is output to the standard error output.

3. When the jajs_maintain command is executed, log data about reorganization is output to the maintenance log file.

   If maintenance processing terminates abnormally, check the maintenance log file for the cause of the abnormal termination, correct the cause, and then re-execute the maintenance processing.

   For the location of the maintenance log file, see the description of the maintenance log file in 1.2.5 List of log files and directories in the manual JP1/Automatic Job Management System 3 Troubleshooting.

4. If you stop the JP1/AJS3 service when the manager functionality is reduced, information about any jobs for which the status has changed during the reduction period will be lost. Do not stop JP1/AJS3 when the manager functionality is reduced.

5. If you execute the command in the manager functionality reduction mode when JP1/AJS3 is stopped, the command will require long time to terminate.

6. If the processing of the jajs_maintain command is canceled for whatever reason when the scheduler service to be maintained is being used, the scheduler service and the event action control manager might remain in maintenance status. To restore them, you must use the jajs_maintain -r start, ajsstart, or jajs_spmd command to start the applicable service.

   In the above situation, the job execution environment might remain in maintenance status as well. To restore it, execute jajs_maintain -r start, or restart the JP1/AJS3 service.

7. If you specify any of the following options in the jajs_maintain command, do not execute multiple instances of the command:

   • -m manager

   • -m scheduler

   • -r start

8. If you specify the -m manager option in the jajs_maintain command, do not concurrently execute the command and the following command or script:

   • The jpqdbcond command with the -x or -k option specified

   • The jpqautocond script

9. You cannot specify -m manager if any command or API for the job execution environment is still running.

10. You cannot specify -m manager while job information is being deleted in the job execution environment.

    If maintenance is performed in the manager functionality reduction mode while job information is being deleted, job information deletion processing is interrupted until the maintenance is completed. The processing is resumed when the maintenance is completed.

11. You cannot specify jajs_maintain -m manager while JP1/AJS3 is starting or finishing. You cannot start or finish JP1/AJS3 while jajs_maintain -m manager is executing.

12. If you specify the -m manager option in the jajs_maintain command, do not concurrently execute the command and the jpqexport command.

13. If you specify either of the following options in this command, do not concurrently execute the command and the ajsautocond script:

    • -m manager

    • -m scheduler

14. If the jajs_maintain -show or jajs_maintain -r start command is executed while starting or finishing JP1/ JP1/AJS3, messages KAVU2227-E, KAVU0215-E, or KAVU0220-E might be output in the integrated log. These messages, which are output when maintenance operation conflicts with start or finish processing of the JP1/AJS3 service, do not pose a problem for actual operation. However, execution of the jajs_maintain command might take more time. If the command terminates abnormally, re-execute the command.

15. When maintenance of the scheduler service is attempted, the scheduler service is stopped after all existing job execution requests are completed. Therefore, if the max number of simultaneous jobs is set as 0 and the max number of waiting jobs is set more than 1 in the queueless job execution environment settings, the jajs_maintain command cannot terminate because the scheduler service cannot start finish processing when the maintenance mode is entered while the queueless job is starting. The jajs_maintain command should be executed in a status that allows jobs to execute. If fall into this status, set the max number of simultaneous jobs more than 1 by the ajsqlalter command, and execute the jobs.

16. For notes on maintenance of the scheduler service that is executing event jobs (including jobs specified in start conditions), see 7.6.8 Notes on restarting the JP1/AJS3 service while event jobs are running in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.

To Page Top

Return values

0	Normal end
Other than 0	Abnormal end

To Page Top

Example

To perform maintenance periodically, you can define and execute the jajs_maintain command as a JP1/AJS3 job.

Suppose you reorganize the database in the manager functionality reduction mode at 23:00 on the last open day in December every year. You can use the following unit definition parameter to define a jobnet and register planned execution. The following shows examples for Windows and UNIX:

• For Windows

  unit=maintain-net;
  {
    ty=n;
    sd=1,12/*b;
    st=1,23:00;
    cy=1,(1,y);
    sh=1,ca;
    unit=maintain-job;
    {
      ty=pj;
      sc="jajs_maintain.exe";
      prm="-m manager";
    }
  }

• For UNIX

  unit=maintain-net;
  {
    ty=n;
    sd=1,12/*b;
    st=1,23:00;
    cy=1,(1,y);
    sh=1,ca;
    unit=maintain-job;
    {
      ty=j;
      te="/opt/jp1ajs2/bin/jajs_maintain -m manager";
    }
  }

To Page Top