Job Management Partner 1/Automatic Job Management System 3 Command Reference 1

ajsembdbreclaim

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

This command is implemented by a script. If you specify an excessively long character string or an invalid character string or value for an option, an unexpected error might occur. You must use the number of characters allowed for a character string or a value in the option as specified in the DBMS and JP1/AJS3 specifications.

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

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 command times out because a high-load job or jobnet is running, re-execute the job when the system load is low.

KAVS2123-E The version of the embedded database is invalid. Update the embedded database to a version supported by JP1/AJS3.

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 command times out because a high-load job or jobnet is running, re-execute the job when the system load is low.
KAVS2123-E	The version of the embedded database is invalid.	Update the embedded database to a version supported by JP1/AJS3.

[Contents][Back][Next]

[Trademarks]