12.3.4 regist_users_number.bat (registering the number of purchased user licenses)
- Organization of this subsection
(1) Function
Registers the number of purchased users of JP1/DH - Server.
(2) Executor
A user with a built-in Administrator account or with Administrator permissions executes the command from the command prompt.#
- #
-
Do not execute a command directly. Use the command prompt to execute a command.
(3) Format
regist_users_number.bat DB-password number-of-purchased-users
(4) Arguments
- DB-password
-
Specify the database password.
- number-of-purchased-users
-
Specify the number of purchased users (a number from 0 to 2,147,483,647).
(5) Execution results
The number of purchased users is registered in the system.
(6) Return codes
|
Return code |
Description |
Operation after an event occurrence |
Occurrence condition |
|---|---|---|---|
|
0 |
Normal |
-- |
The number of purchased users is registered successfully. |
|
4 |
Warning |
Interrupts command processing. |
Execution of the command is canceled during confirmation response for registering the number of purchased users. |
|
8 |
Warning |
Interrupts command processing. |
|
|
16 |
Error |
Interrupts command processing. |
The registration of the number of purchased users failed. |
(7) Output message (Output destination: stdout)
|
No. |
Message |
Return code |
Operation after an event occurrence |
Action to be taken by the operator |
Occurrence condition |
|---|---|---|---|---|---|
|
1 |
The number of purchased users to be registered is ******. Are you sure? (y/n) |
-- |
Waits for user response. |
Select y to continue execution, or n to cancel execution. |
When a command is executed |
|
2 |
The number of purchased users will be registered. |
-- |
Starts command execution. |
None |
When y is selected in No. 1 |
|
3 |
Successfully registered the number of purchased users. Press any key. |
0 |
Terminates command execution. |
None |
When the number of purchased users is registered successfully |
|
4 |
Specify an argument. Press any key and try again. |
8 |
Terminates command execution. |
Specify the database password and the number of purchased users as the arguments, and then re-execute the command. |
|
|
5 |
The number of arguments is invalid. Press any key and try again. |
8 |
Terminates command execution. |
Specify the database password and the number of purchased users as the arguments, and then re-execute the command. |
When the number of specified arguments is incorrect |
|
6 |
Did not successfully register the number of purchased users. Press any key and try again.# |
16 |
Terminates command execution. |
Check the content of the output error message, remove the cause of the error, and then re-execute the command. |
When the registration of the number of purchased users failed |
|
7 |
Canceled command execution. Press any key. |
4 |
Terminates command execution. |
If you selected n in No. 1, specify the number of purchased users to be registered, and then execute the command. |
When n is selected in No. 1 |
#: If an error occurs within the database, this error message is output after an error message is output by the database.
(8) Notes on using the command
Do not execute a command directly. Use the command prompt to execute a command.
If you have enabled UAC (User Account Control) in the operating system, use one of the following ways to execute a command:
-
Log in as a built-in Administrator user, start the command prompt, and then execute a command.
-
Log in as a user with Administrator permissions, start the command prompt by clicking Run as Administrator, and then execute a command.
-
Execute a command from a shortcut for the command prompt with the elevated privileges created at the time of JP1/DH - Server installation.#
- #
-
If you use a command prompt in this way in Windows Server 2012, Windows Server 2012 R2 or Windows Server 2016, you need to install Microsoft .NET Framework 3.5. For details about how to install Microsoft .NET Framework 3.5, see D. Installing .NET Framework 3.5.
Simultaneous executions of commands on the same machine are not supported.