Systemwalker Centric Manager リファレンスマニュアル - UNIX/Windows(R)共通 -

1.2.55.2 ユーザ資源の取り出し

■機能説明

ユーザ資源を取り出します。

■記述形式

drmsrcv

-a rsc -F add -K -g 資源グループ名 [-v バージョン・レベル] [-e 世代識別名] -n 取り出し先ノード名 [-W] [-L 分割量 -T 時間間隔] [-G quick | apply]

■オプション

-a rsc：

本コマンドの機能を指定します。本オプションでは"rsc"と指定します。

-F add：

登録済資源の取り出しを依頼することを指定します。本オプションでは"add"と指定します。

-K：

登録資源の適用情報にかかわらず、すべての世代を取り出します。本オプションを指定した場合は、取り出し資源の適用情報(適用種別/適用予定日時)は、登録資源の各世代の値となります。

-g 資源グループ名：

取り出すユーザ資源が所属する資源グループ名を指定します。資源グループ名は、ASCII(12文字以内)の英数字で指定します。

-v バージョン・レベル：

取り出すユーザ資源が所属する資源グループのバージョン・レベルを指定します。バージョン・レベルは、ASCII(8文字以内)の英数字で指定します。本オプションを省略した場合は、空白のバージョン・レベルを指定したものとみなされます。

-e 世代識別名：

取り出す資源グループ世代識別名を指定します。世代識別名は、ASCII(8文字以内)の英数字で指定します。本オプションを省略した場合は、取り出し先システムの最新世代名を指定したものとみなします。

-n 取り出し先ノード名：

取り出し先システムのノード名を指定します。ノード名は、ASCII(128文字以内)、EUC(64文字以内)またはシフトJIS(64文字以内)の全角文字列で指定します。ノード名は、DRMS編集ファイルに記述したnametypeオプションに合わせて、IPアドレスまたはホスト名を指定します。

-W：

本コマンドが取り出し処理を完了するまで、待ち合わせたい場合に指定します。本オプションが省略された場合、取り出し処理の完了を待ち合わせず、即座に復帰します。

-L 分割量：

資源グループを分割して取り出すときの分割量をMバイト単位で指定します。0.1〜2000の範囲で0.1単位で指定してください。-Tオプションを指定した場合は、必ず本オプションを指定してください。

-T 時間間隔：

資源グループを分割して取り出すときの送信間隔を分単位で指定します。1〜1440の範囲で指定してください。-Lオプションを指定した場合は、必ず本オプションを指定してください。

-G quick|apply：

クライアント資源のダウンロード種別を指定します。本オプションを省略した場合は、登録資源の各世代の値となります。

quick：

指定された世代の資源グループを事前配付する場合に指定します。

apply：

指定された世代の資源グループを通常配付する場合に指定します。

■復帰値

0：正常終了

取り出し処理が正常に終了しました。

1：正常終了

取り出し可能な資源グループがありません。

3：処理継続不可能な使用者エラー

通信処理でエラーが発生しました。詳細はイベントログを参照してください。

二重に取り出されました。取り出し処理ができません。

指定した取り出し先のシステムがありません。

指定した資源グループがありません。

オプションの指定に誤りがあります。取り出し処理ができません。

4：プログラムエラー

システムエラーが発生しました。取り出し処理ができません。

■コマンド格納場所

Windows	Systemwalkerインストールディレクトリ\mpwalker.dm\drmssv\bin
UNIX	/opt/systemwalker/bin

■実行に必要な権限／実行環境

【Windows】

• DistributionOperation権限が必要です。
• 運用管理サーバ、部門管理サーバ、および業務サーバで使用できます。

【UNIX】

• システム管理者(スーパーユーザ)権限が必要です。
• 運用管理サーバ、部門管理サーバ、および業務サーバで使用できます。

■注意事項

• 取り出し先サーバ上に、取り出し元のシステム定義および配付履歴のステータス情報が作成されます。なお、システム定義に関して、システム定義済であれば、そのシステムを使用し、未定義であれば隣接サーバとして自動定義します。
• 上位サーバからのダウンロードと下位サーバからの取り出し要求を同時に実施した場合、最初に動作した方が優先されて処理されます。したがって、あとで動作した処理は、ダウンロード対象資源が存在しない(配付済)という事象となる場合があります。
• 複数サーバからの取り出し要求が同時に行われた場合は、取り出し先サーバのDRMS編集ファイルに指定している、servnum値のサーバ数で制限されます。(servnum値を超えた要求は待たされます。)

■使用例1

取り出し先システムのノード名“SERV”から、登録済最新世代までの資源グループ“RSG01”を取り出し、取り出し処理を待ち合わせます。

drmsrcv -arsc -Fadd -K -nSERV -gRSG01 -W

■使用例2

取り出し先システムのノード名“SERV”から、登録済最新世代までの資源グループ“RSG02”、バージョン・レベル“V01L01”を取り出します。

drmsrcv -arsc -Fadd -K -nSERV -gRSG01 -vV01L01