-us: XUSER エントリの登録または変更 

用途

データベースマネージャのDBM オプション –us を指定して XUSER プログラムを使用すると、ユーザの新規 XUSER エントリを登録したり、既存のエントリを上書きしたりすることができます。

XUSER エントリは、ユーザキーによって定義されたユーザデータのセットです。このセットにより、XUSER をサポートするプログラムへのログオンプロセスが容易になります。XUSER キーと DBM オプション –U を同時に使用すると、データベースマネージャにログオンすることができます (ユーザログオンを参照.)。つまり、データベースマネージャ CLI では関連 XUSER エントリから必要なデータが取得されるため、DBM オペレータ名とパスワード (DBM オプション –u) を指定する必要はありません。

直接XUSER プログラムを使用して、XUSER エントリを登録または変更することをお奨めします。

参照: ユーティリティ、XUSER

XUSER エントリに保存されているユーザでデータベースインスタンスにアクセスすることができるのは、そのユーザがこのデータベースインスタンスに実際に登録されている場合のみです。DBM オペレータはデータベースマネージャを使用して登録する必要があります (user_createを参照)。
データベースユーザは、クエリツールまたはデータベースマネージャで登録することができます (db_executeを参照)。

ユーザ名とパスワードとは異なり、データベースマネージャではユーザキーは大文字と小文字が区別されます。データベースマネージャのデフォルト値のユーザキー DBMUSR と DEFAULT を定義するには、大文字でユーザキーを記述する必要があります。

XUSER エントリの登録

新規XUSER エントリを登録する場合は、XUSER プログラムに接続する必要はありません。

このエントリを保存するXUSER エントリのユーザキーを定義することができます。

データベースマネージャCLI によって、データベース名とコンピュータ名の組合せからこのユーザキーを生成することもできます。その場合は、ユーザ名とパスワードの他にデータベースインスタンスとデータベースコンピュータを指定します。

データベースマネージャで作業する場合は、ユーザキー DBMUSR と最初の DBM オペレータのユーザデータで XUSER エントリを登録することをお奨めします。ユーザキーなしで DBM オプション –U を指定すると、データベースマネージャ CLI では、このプログラムにログオンするときにこのキーへの明示的アクセスが試行されます。

その他の機能を実行するには、DEFAULT ユーザキーに保存されたユーザデータでログオンする必要があります。このため、ユーザキー DEFAULT と有効なデータベースユーザのユーザデータで XUSER エントリも登録することをお奨めします。

XUSER エントリの変更

XUSER エントリを変更するには、変更するユーザのデータ、または DEFAULTXUSER キーに保存されたデータでログオンする必要があります。

DEFAULTXUSER キーに保存されたデータでログオンすると、すべてのXUSER エントリを変更する権限が付与されます。変更する XUSER エントリを識別するには、DBM オプション –uk、またはデータベース名とコンピュータ名の組合せ (DBM オプション -d および –n) を使用します。

構文

-us <new_user_name>,<new_user_password>

オプション

オプション	内容
<new_user_name>	キー内に保存するユーザ名
<new_user_password>	キー内に保存するユーザのパスワード

 

例

新規 XUSER エントリの登録

...

       1.      データベースマネージャCLI を呼び出し、新規XUSER エントリ(例: ユーザ BORIS、パスワード PINK) を登録し、定義済ユーザキー (例: ユーザキー DEFAULT) に保存します。

>dbmcli –uk <user_key> –us <new_user_name>,<new_user_password> [options]

>dbmcli –uk DEFAULT –us BORIS,PINK

 

       2.      データベースマネージャCLI を呼び出し、新規XUSER エントリ(例: ユーザ MONA、パスワード RED) を登録し、定義済ユーザキー (例: ユーザキー MOKEY) に保存します。

>dbmcli –uk <user_key> –us <new_user_name>,<new_user_password> [options]

>dbmcli –uk MOKEY –us MONA,RED

 

       3.      データベースマネージャCLI を呼び出し、新規XUSER エントリ(例: ユーザ MONA、パスワード RED) を登録し、データベース名とコンピュータ名 (例: データベースインスタンス DEMODB、コンピュータ名 GENUA) から生成されたユーザキーに保存します。

>dbmcli –d <database_name> [-n <database_computer>] –us <new_user_name>,<new_user_password> [options]

>dbmcli –d DEMODB –n GENUA -us MONA,RED

既存の XUSER エントリの変更

...

       1.      データベースマネージャ CLI を呼び出します。変更する XUSER エントリのデータと DBM オプション -u (例: 変更ユーザ MONA、パスワード RED からユーザ DAVID、パスワード BLUE) で XUSER プログラムにログオンします。

                            a.      ユーザキー(例: ユーザキー MOKEY) を入力して変更するXUSER エントリを指定します。

>dbmcli -u <user_name>,<user_password> -uk <user_key> –us <new_user_name>,<new_user_password> [options]

>dbmcli –u DAVID,BLUE –uk DAKEY –us BORIS,PINK

 

                            b.      データベース名とコンピュータ名の組合せ(例: データベースインスタンス DEMODB、コンピュータ名 GENUA) を入力して変更する XUSER エントリを指定します。

>dbmcli -u <user_name>,<user_password> –d <database_name> [-n <database_computer>] –us <new_user_name>,<new_user_password> [options]

>dbmcli –u DAVID,BLUE –d DEMODB –n GENUA –us BORIS,PINK

 

       2.      データベースマネージャCLIを呼び出し、DEFAULT XUSER キーに保存されたデータと DBM オプション -ux(例: ユーザ BORIS、パスワード PINK) を使用してプログラムにログオンします。

                            a.      DBM オプション –uk (例: ユーザキー: DAKEY) を使用して、変更するXUSER エントリを指定します。
DBM オプション –us (例: ユーザ BORIS、パスワード PINK) を使用して、新規データを指定します。

>dbmcli -ux <default_user_name>,<default_user_password> -uk <user_key> –us <new_user_name>,<new_user_password> [options]

>dbmcli –ux BORIS,PINK –uk DAKEY –us BORIS,PINK

 

                            b.      データベース名とコンピュータ名の組合せ(例: データベースインスタンス DEMODB、コンピュータ名 GENUA) を使用して、変更するXUSER エントリを指定します。
DBM オプション –us (例: ユーザ BORIS、パスワード PINK) を使用して、新規データを指定します。

>dbmcli -ux <default_user_name>,<default_user_password> –d <database_name> [-n <database_computer>] –us <new_user_name>,<new_user_password> [options]

>dbmcli –ux MONA,RED –d DEMODB –n GENUA –us BORIS,PINK