ajsembdbaddlog

Organization of this page

Format
Description
Execution privileges
Storage directory
Arguments
Notes
Return values
Additional information
Actions to be taken if an error occurs

Format

ajsembdbaddlog
      -s embedded-database-file-system-area-size
      -r {sys|spd}
      [-id embedded-database-setup-ID]
      -d name-of-directory-where-file-to-be-expanded-stored
      [-du name-of-directory-where-file-to-be-expanded-stored]

Format 1 (for expanding the system log file)

ajsembdbaddlog
      -s embedded-database-file-system-area-size
      -r sys
      [-id embedded-database-setup-ID]
      -d name-of-directory-where-file-to-be-expanded-stored

Format 2 (for expanding the sink point dump file)

ajsembdbaddlog
      -s embedded-database-file-system-area-size
      -r spd
      [-id embedded-database-setup-ID]
      -d name-of-directory-where-file-to-be-expanded-stored

Format 3 (for expanding the duplicated system log file)

ajsembdbaddlog
      -s embedded-database-file-system-area-size
      -r sys
      [-id embedded-database-setup-ID]
      -d name-of-directory-where-file-to-be-expanded-stored
      -du name-of-directory-where-file-to-be-expanded-stored

Format 4 (for expanding the duplicated sink point dump file)

ajsembdbaddlog
      -s embedded-database-file-system-area-size
      -r spd
      [-id embedded-database-setup-ID]
      -d name-of-directory-where-file-to-be-expanded-stored
      -du name-of-directory-where-file-to-be-expanded-stored

To Page Top

Description

The ajsembdbaddlog command expands the embedded database system file (system log file or sink point dump file).

You can execute this command only while the embedded database and all the scheduler services for which the applicable embedded database was created as the scheduler database are not running.

To Page Top

Execution privileges

In Windows: Administrators privileges

In UNIX: Superuser privileges

To Page Top

Storage directory

In Windows:: JP1/AJS3 - Manager-installation-folder\tools\
In UNIX:: /opt/jp1ajs2/tools/

To Page Top

Arguments

`-s` `embedded-database-file-system-area-size`

Specify in MB the size of the file system area in the embedded database to be allocated.

The range of values that can be specified in this option varies depending on the value of the -r option.

If the -r value is sys:: 1 to 2,047
If the -r value is spd:: 1 to 1,024

`-r sys | spd`

Specify the type of system file to be expanded.

sys

The system log file is expanded.
spd

The sink point dump file is expanded.

`-id` `embedded-database-setup-ID`

Specify the setup identifier that identifies the embedded database in the _JFn format (n: 0-9 or A-Z). The value specified in this argument must be the same as the value specified in the -id option of the ajsembdbbuild command.

If you want to operate an embedded database created by using the jajs_setup, jajs_setup_cluster, and jajs_migrate commands, use the ajsembdbidlist command to check the setup identifier of the embedded database. For details on the ajsembdbidlist command, see ajsembdbidlist in 2. Commands Used during Setup.

If you omit this option, the system assumes _JF0.

`-d` `name-of-directory-where-file-to-be-expanded-stored`

Use 120 bytes or less to specify the name of the directory that stores the file to be expanded. If you specify a non-existent directory, an error occurs.

Keep the following points in mind when you specify a directory name:

Use a full path name to specify a directory name.
If you want to specify a directory whose name contains spaces, enclose the entire path in double quotation marks (").
Do not specify a disk on a network drive.
In a cluster system, specify a directory on the shared disk.
Make sure that the amount of space specified in the -s option is available to the specified directory.

`-du` `name-of-directory-where-file-to-be-expanded-stored`

Specify this option when you duplicate the system files of the embedded database.

You need to specify a different directory from the directory specified in the -d option. Other items are the same as the -d option.

To Page Top

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.
Do not execute this command more than once in quick succession. If you do so, the following problems might occur:
- The message output is invalid. For example, an invalid message is output or a message that should be output is not output.
- The command results in an error.
You can create a maximum of 30 system log files and a maximum of 30 sink point dump files. When you create the first embedded database environment, 12 system log files are created by default and you can add up to 18 system log files. Three sink point dump files are also created by default, and you can add up to 27 sink point dump files.
In a cluster system, execute this command on the executing host (host specified for the -eh option of the ajsembdbbuild command). After executing the command, copy the ajs2 files from embedded-database-practical-directory\CONF to the standby host.

To Page Top

Return values

0	Normal end
Values other than 0	Abnormal end

To Page Top

Additional information

Each time this command is executed, a file whose name is in the following format is created in the directories specified for the -d and -du options:

ajsRRRIIIIYYYYMMDDhhmmss{D}

RRRRR: Type of expanded resource (value specified for the -r option)
IIII: embedded database setup ID (value specified for the -id option)
YYYY: year
MM: month
DD: day
hh: hours
mm: minute
ss: second

Example:

The following shows an example of the command line and the files created when the command is executed at 21:57:30 on March 2, 2010:

ajsembdbaddlog -r sys -s 2000 -d L:\sysarea1 -du M:\sysarea2 -id _JF0
 
L:\sysarea1\ajssys_JF020100302215730
M:\sysarea2\ajssys_JF020100302215730D

To Page Top

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.
KAVS2102-E	The embedded database is being started or stopped.	Use the `ajsembdbstatus -s ust` 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.

To Page Top