Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Command Reference


ajsembdbreclaim

Organization of this page

Format

ajsembdbreclaim
      -m {manager|
          scheduler [-F scheduler-service-name]|
          agent}
      [-mh logical-host-name]
      [-t {d|f}]
      [-r {1|2}]

Format 1 (for maintaining the scheduler service under the manager and agent management)

ajsembdbreclaim
      -m manager
      [-mh logical-host-name]
      -t f
      -r 2

Format 2 (for maintaining the index area for the scheduler service under the manager and agent management)

ajsembdbreclaim
      -m manager
      [-mh logical-host-name]
      -t d
      -r 2

Format 3 (for maintaining the pages for the scheduler service under the manager and agent management)

ajsembdbreclaim
      -m manager
      [-mh logical-host-name]
      -t f
      -r 1

Format 4 (for maintaining only the pages in the index area for the scheduler service under the manager and agent management)

ajsembdbreclaim
      -m manager
      [-mh logical-host-name]
      -t d
      -r 1

Format 5 (for maintaining the specified scheduler service)

ajsembdbreclaim
      -m scheduler
      [-F scheduler-service-name]
      [-mh logical-host-name]
      -t f
      -r 2

Format 6 (for maintaining the index area for the specified scheduler service)

ajsembdbreclaim
      -m scheduler
      [-F scheduler-service-name]
      [-mh logical-host-name]
      -t d
      -r 2

Format 7 (for maintaining the pages for the specified scheduler service)

ajsembdbreclaim
      -m scheduler
      [-F scheduler-service-name]
      [-mh logical-host-name]
      -t f
      -r 1

Format 8 (for maintaining only the pages in the index area for the specified scheduler service)

ajsembdbreclaim
      -m scheduler
      [-F scheduler-service-name]
      [-mh logical-host-name]
      -t d
      -r 1

Format 9 (for maintaining agent management)

ajsembdbreclaim
      -m agent
      [-mh logical-host-name]
      -t f
      -r 2

Format 10 (for maintaining the index area used for agent management)

ajsembdbreclaim
      -m agent
      [-mh logical-host-name]
      -t d
      -r 2

Format 11 (for maintaining the pages used for agent management)

ajsembdbreclaim
      -m agent
      [-mh logical-host-name]
     -t f
      -r 1

Format 12 (for maintaining only the pages in the index area used for agent management)

ajsembdbreclaim
      -m agent
      [-mh logical-host-name]
      -t d
      -r 1

Description

Maintains the areas in the embedded database used by JP1/AJS3.

You can execute this command only when the embedded database is running. You can execute the command regardless of the operating status of JP1/AJS3.

Execution privileges

In Windows: Administrators privileges

In UNIX: Superuser privileges

Storage directory

In Windows:

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

In UNIX:

/opt/jp1ajs2/tools/

Arguments

-m {manager | scheduler | agent}

Specify the range of maintenance.

  • manager

    Specify this option to maintain all scheduler services and the agent management in JP1/AJS3 - Manager.

    You can specify this option together with the -mh option.

  • scheduler

    Specify this option to maintain the areas for the specified scheduler service.

    You can specify this option together with the -mh and -F options.

  • agent

    Specify this option to maintain agent management.

    You can specify this option together with the -mh options.

-F scheduler-service-name

Specify the name of the scheduler service for which you want to maintain the areas.

If you omit this option, the system assumes the default scheduler service name.

-mh logical-host-name

Specify the target JP1 logical host name.

You can specify a character string of 1 to 32 bytes.

If you omit this option and environment variable JP1_HOSTNAME has been set, the system assumes the value set for JP1_HOSTNAME. If environment variable JP1_HOSTNAME has not been set, the system assumes the physical host name.

-t d | f

Specify the maintenance mode.

  • d

    Specify this option to maintain the area where indexes are stored.

  • f

    Specify this option to maintain the areas where indexes and data are stored.

If you omit this option, the system assumes f.

Depending on the type of operation, the data storage area might become full before the index storage area does. Execute the -db -d option of the ajsembdbstatus command and check the obtained output result. If only a few pages in the data storage area can be released, but many pages in the index storage area can be released, specify the -t d option when you execute the command so that you can maintain the areas efficiently.

-r 1 | 2

Specify the level of maintenance.

  • 1

    Specify this option to release only pages.

  • 2

    Specify this option to release pages and segments.

If you omit this option, the system assumes 2.

Execute the -db -d option of the ajsembdbstatus command and check the obtained output result. If many pages can be released, but only a few segments are being used, specify the -r l option when you execute the command so that you can maintain the areas efficiently.

Notes

Return values

0

Normal end

Values other than 0

Abnormal end

Actions to be taken if an error occurs

If a command error occurs, take the indicated action in the following table.

Message

Cause

Action to be taken

KAVS0996-E

The specified option contains an error.

Check the specification of the option.

KAVS2101-E

The embedded database is inactive.

Start the embedded database and then re-execute the command.

KAVS2102-E

The embedded database is being started or stopped.

Use the -s ust option of the ajsembdbstatus command to check whether the embedded database is running and then re-execute the command.

KAVS2104-E

The embedded database is not set up.

Set up the embedded database and then re-execute the command.

KAVS2116-E

The specified option contains an error.

Check the option output in the message and then re-execute the command.

KAVS2117-E

An error occurred during execution of the command.

Check the message output in the maintenance information.

If the ajsembdbreclaim command times out because a high-load job or jobnet is running, re-execute the job when the system load is low.

If the ajsembdbreclaim command times out because of unit operations by commands or in JP1/AJS3 - View, re-execute the command after those unit operations have finished.

KAVS2123-E

The version of the embedded database is invalid.

Update the embedded database to a version supported by JP1/AJS3.