Hitachi

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


ajsembdbidlist

Organization of this page

Format

ajsembdbidlist
     [-v | -a | -e]

Description

Displays information that is required by commands for operating on the embedded database. The information is registered in the configuration definition.

The information to be displayed is as follows:

Note that this command can be executed regardless of the operating status of JP1/AJS3 and the embedded database.

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

-v

Specify this option to display the version of the embedded database.

-a

Specify this option to display the location of the embedded database where the agent management database is stored.

-e

Specify this option to check the behavior of the installed embedded database.

Example 1

The command in this example displays the following types of information registered in the configuration definition:

ajsembdbidlist

Example 2

The command in this example displays the following types of information registered in the configuration definition:

ajsembdbidlist -v

Example 3

The command in this example displays the following types of information registered in the configuration definition:

ajsembdbidlist -a

Example 4

The command in this example displays the following types of information registered in the configuration definition:

ajsembdbidlist -e

Output example 1

The following output example shows that the ajsembdbsetup command (embedded database setup) has been completed for _JF0 to _JF2 on hosts AJSROOT1, AJSROOT2, and ROOT3, respectively. For _JF3, the ajsembdbbuild command (embedded database environment creation) has been completed.

(1) *** Embeddb setup-id list 20XX/04/18 08:15:00
  (2)             (3)
  _JF0 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF0
  _JF1 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF1
  _JF2 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF2
  _JF3 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF3
 
(4) Host-Name:JP1_DEFAULT
   (5)    (6)      (7)
  AJSROOT1 _JF0 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF0
 
  Host-Name:LHOST1
  AJSROOT2 _JF1 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF1
  ROOT3 _JF2 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF2
(8)--

Explanation of output items

(1) The title and the time that the command was executed (in YYYY/MM/DD hh:mm:ss format)

(2) Setup identifiers

(3) Embedded database practical directories

(4) Logical host name. For a physical host, JP1_DEFAULT is output.

(5) Scheduler service name

(6) Setup identifiers

(7) Embedded database practical directories

(8) End of output

Output example 2

The following output example shows the ajsembdbidlist command executed with the -v option specified when _JF0 and _JF1 have been installed on a physical host and _JF2 has been installed on the LHOST1 logical host.

(1) *** Embeddb setup-id list 20XX/04/18 08:15:00
 
(2) Host-Name:JP1_DEFAULT
   (3)   (4)              (5)
  _JF0 08-05-/N C:\Program Files\HITACHI\JP1AJS2\embdb\_JF0
  _JF1 08-05-/N C:\Program Files\HITACHI\JP1AJS2\embdb\_JF1
 
  Host-Name:LHOST1
  _JF2 08-05-/N C:\Program Files\HITACHI\JP1AJS2\embdb\_JF2
(6)--

Explanation of output items

(1) The title and the time that the command was executed (in YYYY/MM/DD hh:mm:ss format)

(2) Logical host name. For a physical host, JP1_DEFAULT is output.

(3) Setup identifiers

(4) Versions of embedded databases

(5) Installation directories for embedded databases

(6) End of output

Output example 3

The following output example shows the ajsembdbidlist command executed with the -a option specified when the agent management database of the physical host is stored in _JF0, and the agent management database of the LHOST1 logical host is stored in _JF2.

(1) *** Embeddb setup-id list 20XX/04/18 08:15:00
(2)      (3)
_JF0 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF0
_JF1 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF1
_JF2 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF2
_JF3 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF3
(4) Host-Name:JP1_DEFAULT
(5)        (6)     (7)
AJSROOT1 _JF0 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF0
Host-Name:LHOST1
AJSROOT2 _JF1 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF1
ROOT3 _JF2 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF2
(8) Agent DB
(9) Host-Name:JP1_DEFAULT
(10)      (11)
_JF0 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF0
Host-Name:LHOST1
_JF2 C:\Program Files\HITACHI\JP1AJS2\embdb\_JF2
(12)--

Explanation of output items

(1) The title and the time that the command was executed (in YYYY/MM/DD hh:mm:ss format)

(2) Setup identifiers

(3) Embedded database practical directories

(4) Logical host name. For a physical host, JP1_DEFAULT is output.

(5) Scheduler service name

(6) Setup identifiers

(7) Embedded database practical directories

(8) Start of output for the association between agent management databases

(9) Logical host name. For a physical host, JP1_DEFAULT is output.

(10) Setup identifier of the embedded database where the agent management database for each logical host is stored

(11) Installation directories for embedded databases

(12) End of output

Output example 4

The following output example shows the ajsembdbidlist command executed with the -e option specified when _JF0 and _JF1 have been installed on a physical host and _JF2 and _JF3 have been installed on the LHOST1 logical host. Note that _JF0 and _JF1 were installed by using JP1/AJS3 - Manager version 09-50, and _JF2 and _JF3 were installed by using JP1/AJS3 - Manager version 10-00 or later.

(1) *** Embeddb setup-id list 20XX/04/01 08:15:00
 
(2) Host-Name:JP1_DEFAULT
   (3)     (4)     (5)         (6)
  _JF0 08-05-DA OS_CONTROL  C:\Program Files\HITACHI\JP1AJS2\embdb\_JF0
  _JF1 08-05-DA OS_CONTROL  C:\Program Files\HITACHI\JP1AJS2\embdb\_JF1
 
  Host-Name:LHOST1
  _JF2 08-05-DA AJS_CONTROL C:\Program Files\HITACHI\JP1AJS2\embdb\_JF2
  _JF3 08-05-DA AJS_CONTROL C:\Program Files\HITACHI\JP1AJS2\embdb\_JF3
(7)--

Explanation of output items

(1) The title and the time that the command was executed (in YYYY/MM/DD hh:mm:ss format)

(2) Logical host name. For a physical host, JP1_DEFAULT is output.

(3) Setup identifiers

(4) Versions of embedded databases

(5) Behavior of the embedded database

OS_CONTROL

Indicates that the embedded database has been installed under either of the following circumstances:

  • JP1/AJS3 - Manager is upgraded from a version earlier than 10-00 to version 10-00 or later, and the setting to strengthen the embedded database management functionality is not specified for the embedded database.

  • When the ajsembdbinstl command is executed with the -v9standard option specified.

For UNIX, the pdprcd process starts from inittab.

For Windows, the JP1/AJS3 Database ClusterService service is created. The startup type of the JP1/AJS3 Database service is automatic.

For details about the settings for enhancing the embedded DB management function, see 3.6.1 Settings for enhancing the embedded database management function in the JP1/Automatic Job Management System 3 Configuration Guide.

AJS_CONTROL

Indicates that the embedded database was installed by using JP1/AJS3 - Manager version 10-00 or later.

For UNIX, the pdprcd process starts from pdmgrd.

For Windows, the JP1/AJS3 Database ClusterService service is not created. The startup type of the JP1/AJS3 Database service is manual.

(6) Installation directories for embedded databases

(7) End of output

Actions to be taken if an error occurs

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

Message ID and message

Cause

Action taken

KAVS2116-E There is an error in the specified option. Illegal option (option) exists.

The specified option is incorrect. An invalid option has been specified.

Check the option and re-execute the command.

KAVS0903-E System error occurred. : Get Conf NG

An attempt to read the configuration definition failed.

Check the execution permission for the command, and re-execute the command. If this error occurs again, contact the system administrator.

Return values

0

Normal end

Registered information is displayed (this value is also returned when there is no information to be displayed).

4

Abnormal end

An option is invalid.

8

Abnormal end

An attempt to read the configuration definition failed.