Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Administration Guide


9.2.2 Executing the ajsembdbreclaim command

This subsection describes how to use the ajsembdbreclaim command for maintenance.

Organization of this subsection

(1) Executing the ajsembdbreclaim command automatically

By defining the ajsembdbreclaim command as a JP1/AJS3 job, you can execute the ajsembdbreclaim command automatically according to a schedule. We recommend that you set a schedule to execute the ajsembdbreclaim command as a job once a day.

The following shows an operation example for executing the ajsembdbreclaim command automatically.

(a) Definition method

The following shows an example definition that executes the ajsembdbreclaim command at 23:00 on the fifth open day of every week.

  1. Create a unit definition file with the following contents.

    In Windows:

    unit= ajsembdbreclaim-netwin,,jp1admin,;
    {
        ty=n;
        sd=1,*5;
        st=1,23:00;
        cy=1,(5,d);
        sh=1,ca;
        unit= ajsembdbreclaim-jobwin;
        {
            ty=pj;
            sc="C:\Program Files\HITACHI\JP1AJS2\tools\ajsembdbreclaim";
            prm="-m manager";
        }
    }

    In UNIX:

    unit= ajsembdbreclaim-netunix,,jp1admin,;
    {
        ty=n;
        sd=1,*5;
        st=1,23:00;
        cy=1,(5,d);
        sh=1,ca;
        unit= ajsembdbreclaim-jobunix;
        {
            ty=j;
            sc="/opt/jp1ajs2/tools/ajsembdbreclaim";
            prm="-m manager";
        }
    }
  2. Execute the following command to define the unit:

    ajsdefine unit-definition-file-name

    The following is an example command for creating a unit definition file named ajsembdbreclaim.txt:

    ajsdefine ajsembdbreclaim.txt
  3. Execute the following command to register the unit for planned execution:

    ajsentry -s unit-name

    The following is an example command:

    ajsentry -s /ajsembdbreclaim-netwin

    Empty pages will be automatically reclaimed according to the defined schedule.

    Note that you can also use JP1/AJS3 - View to register the unit for planned execution.

(2) Executing the ajsembdbreclaim command manually

The following describes how to execute the ajsembdbreclaim command manually. For details about the ajsembdbreclaim command, see ajsembdbreclaim in 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference.

Note that if you execute the ajsembdbreclaim command while the embedded database is online, the database server waits for transactions to complete before the ajsembdbreclaim command is executed. Therefore, do not execute the ajsembdbreclaim command at a time when the execution of jobs and jobnets creates a heavy load or when a command or JP1/AJS3 - View is operating on a unit.

For Windows hosts:

JP1/AJS3-Manager-installation-folder\tools\ajsembdbreclaim

For UNIX hosts:

/opt/jp1ajs2/tools/ajsembdbreclaim

Command examples
  • To run the command for all the scheduler services on the manager (JP1/AJS3 - Manager), enter the following command:

    ajsembdbreclaim -m manager

  • To run the command for the scheduler service, enter the following command:

    ajsembdbreclaim -m scheduler -F AJSROOT1