12.3.4 regist_users_number.bat（購入済みユーザライセンス数の登録）
(1) 機能
JP1/DH - Serverの購入ユーザ数の登録を行います。
(2) 実行者
ビルトインAdministratorユーザまたはAdministrators権限を持つ管理者ユーザが，コマンドプロンプトから実行します。※
- 注※
-
コマンドは直接実行せず，コマンドプロンプトから実行してください。
(3) 形式
regist_users_number.bat DBパスワード 購入ユーザ数
(4) 引数
- DBパスワード
-
データベースのパスワードを指定します。
- 購入ユーザ数
-
購入ユーザ数（0〜2147483647の半角数字）を指定します。
(5) 実行結果
購入ユーザ数がシステムに登録されます。
(6) リターンコード
|
リターンコード |
意味 |
事象発生後の動作 |
発生条件 |
|---|---|---|---|
|
0 |
正常 |
− |
購入ユーザ数登録が正常に行われた |
|
4 |
警告 |
コマンドの処理を中断 |
購入ユーザ数登録確認応答で，コマンドの実行を中止した |
|
8 |
警告 |
コマンドの処理を中断 |
|
|
16 |
エラー |
コマンドの処理を中断 |
購入ユーザ数登録に失敗した |
(7) 出力メッセージ（出力先：stdout）
|
項番 |
メッセージ |
リターンコード |
事象発生後の動作 |
オペレータの取るべき処置 |
発生条件 |
|---|---|---|---|---|---|
|
1 |
登録する購入ユーザ数は ****** です。よろしいですか？(y/n) |
- |
ユーザの応答待ち |
実行を継続する場合は「y」，実行を中止する場合は「n」を選択する |
コマンドを実行した場合 |
|
2 |
購入ユーザ数の登録を開始します。 |
- |
コマンドの実行を開始 |
なし |
項番1で「y」を選択した場合 |
|
3 |
購入ユーザ数の登録が正常に終了しました。何かキーを押してください。 |
0 |
コマンドの実行を終了 |
なし |
購入ユーザ数の登録が正常に行われた場合 |
|
4 |
引数を指定してください。何かキーを押した後、再度実行してください。 |
8 |
コマンドの実行を終了 |
引数にデータベースパスワードと購入ユーザ数を指定して再実行する |
|
|
5 |
引数の数が正しくありません。何かキーを押した後、再度実行してください。 |
8 |
コマンドの実行を終了 |
引数にデータベースパスワードと購入ユーザ数を指定して再実行する |
引数の数が正しくなかった場合 |
|
6 |
購入ユーザ数の登録が正常に終了しませんでした。何かキーを押した後、再度実行してください。※ |
16 |
コマンドの実行を終了 |
出力されたエラーメッセージを確認してエラーの原因を取り除いてから再実行する |
購入ユーザ数の登録に失敗した場合 |
|
7 |
コマンドの実行を中止しました。何かキーを押してください。 |
4 |
コマンドの実行を終了 |
項番1で「n」を選択した場合は登録する購入ユーザ数を指定してから実行する |
項番1で「n」を選択した場合 |
注※ データベース内でエラーが発生した場合は，データベースが出力するエラーメッセージの後に本メッセージが出力されます。
(8) 注意事項
コマンドは直接実行せず，コマンドプロンプトから実行してください。
OSのUAC（User Account Control）を有効にしている場合は，次に示すどれかの方法でコマンドを実行してください。
-
ビルトインAdministratorユーザでログインしてコマンドプロンプトを起動し，コマンドを実行する
-
Administrators権限を持つユーザでログインしてコマンドプロンプトを「管理者として実行」し，コマンドを実行する
-
JP1/DH - Serverのインストール時に作成される権限昇格済みのコマンドプロンプトのショートカットからコマンドを実行する※
- 注※
-
Windows Server 2012，Windows Server 2012 R2またはWindows Server 2016の場合に，このコマンドプロンプトを使用するときは，Microsoft .NET Framework 3.5のインストールが必要です。Microsoft .NET Framework 3.5のインストールについては，「付録D .NET Framework 3.5のインストール」を参照してください。
同一マシン上での複数同時実行はサポートしていません。