Hitachi

Hitachi Advanced Database Command Reference


10.2.1 Explanation of the specification format and options

Organization of this subsection

(1) Specification format

adbclientdefmang -u authorization-identifier
               [-p password]
               {--update |[-i output-target-authorization-identifier]}

(2) Explanation of options

-u authorization-identifier

~<character string>((1 to 100 bytes))

Specifies the authorization identifier of the HADB user who executes the adbclientdefmang command. To execute the adbclientdefmang command, the user must have the following two privileges:

  • DBA privilege

  • CONNECT privilege

For this option, specify an authorization identifier in the range from 1 to 100 bytes. Note that the byte count (1 to 100 bytes) does not include the double quotation marks used to enclose the authorization identifier.

Important

If the character string used as the authorization identifier includes any lowercase letter or a backslash (\), make sure that you check the rules for specifying authorization identifiers. For the rules for specifying authorization identifiers, see 1.4.2 Rules for specifying authorization identifiers and passwords.

-p password

~<character string>((1 to 255 bytes))

Specifies the password for the authorization identifier that was specified in the -u option.

Important

If the password includes a character that has a special meaning in the OS or shell, such as a double quotation mark (") or vertical bar (|), make sure that you check the rules for specifying passwords. For the rules for specifying passwords, see 1.4.2 Rules for specifying authorization identifiers and passwords.

If the adbclientdefmang command is executed with this option omitted, a message prompting the user to enter a password is displayed. In an environment in which a password cannot be entered from the standard input, such as when the command is executed in the background, make sure that you do not omit this option.

--update

Specify this when you want to change the way the function for centrally managing client definitions is applied, while the HADB server is running.

When you execute the adbclientdefmang command with the --update option specified, the content of the client definition file used by the function for centrally managing client definitions is applied to each HADB client according to the content of the client management definition file ($ADBDIR/conf/adbclientdefmang.def).

However, if the adbclientdefmang command is executed with the --update option specified in the following situations, the function for centrally managing client definitions is disabled:

  • The client management definition file does not exist.

  • The client management definition file is empty.

  • The content of the client management definition file consists entirely of comments.

-i output-target-authorization-identifier

~<character string>((1 to 100 bytes))

Specify this when you want to check the name of the client definition file used by the function for centrally managing client definitions applied to the authorization identifier of a specific HADB client.

When you execute the adbclientdefmang command with the -i option specified, the authorization identifier of the HADB client specified in the -i option, and the name of the client definition file used by the function for centrally managing client definitions applied to that authorization identifier are displayed.

In this option, specify an authorization identifier for the output target in the range from 1 to 100 bytes. Note that the byte count (1 to 100 bytes) does not include the double quotation marks used to enclose the authorization identifier of the output target.

Specifying a character string that violates the rules for specifying authorization identifiers results in an error.

Important

If the character string used as the authorization identifier includes any lowercase letter or a backslash (\), make sure that you check the rules for specifying authorization identifiers. For the rules for specifying authorization identifiers, see 1.4.2 Rules for specifying authorization identifiers and passwords.

The following is an example of displaying the name of the client definition file used by the function for centrally managing client definitions applied to the HADB client authorization identifier ADBUSER02:

Example execution (when the -i option is specified)

adbclientdefmang -u ADBUSER01 -p '#HelloHADB_01' -i ADBUSER02

Output example

authorization-identifier client-definition-file
ADBUSER02                client01.def

Note that if you omit the -i option, the authorization identifiers of HADB clients to be centrally managed, and the list of names of client definition files used by the function for centrally managing client definitions are output.

Example execution (when the -i option is omitted)

adbclientdefmang -u ADBUSER01 -p '#HelloHADB_01'

Output example

authorization-identifier client-definition-file
ADBUSER01                client01.def
ADBUSER02                client01.def
ADBUSER03                client02.def