Upload
others
View
0
Download
0
Embed Size (px)
Citation preview
Tivoli Management Framework
リファレンス・マニュアル
バージョン 4.1.1
SC88-9296-01
(英文原典:SC32-0806-01)
���
Tivoli Management Framework
リファレンス・マニュアル
バージョン 4.1.1
SC88-9296-01
(英文原典:SC32-0806-01)
���
お願い本書および本書で紹介する製品をご使用になる前に、 541ページの『特記事項』に記載されている情報をお読みください。
本マニュアルに関するご意見やご感想は、次の URL からお送りください。今後の参考にさせていただきます。
http://www.ibm.com/jp/manuals/main/mail.html
なお、日本 IBM 発行のマニュアルはインターネット経由でもご購入いただけます。詳しくは
http://www.ibm.com/jp/manuals/ の「ご注文について」をご覧ください。
(URL は、変更になる場合があります)
お客様の環境によっては、資料中の円記号がバックスラッシュと表示されたり、バックスラッシュが円記号と表示されたりする場合があります。
原 典: SC32–0806–01
Tivoli Management Framework
Reference Manual
Version 4.1.1
発 行: 日本アイ・ビー・エム株式会社
担 当: ナショナル・ランゲージ・サポート
第1刷 2004.1
この文書では、平成明朝体™W3、平成明朝体™W9、平成角ゴシック体™W3、平成角ゴシック体™W5、および平成角ゴシック体™W7を使用しています。この(書体*)は、(財)日本規格協会と使用契約を締結し使用しているものです。フォントとして無断複製することは禁止されています。
注* 平成明朝体™W3、平成明朝体™W9、平成角ゴシック体™W3、平成角ゴシック体™W5、平成角ゴシック体™W7
© Copyright International Business Machines Corporation 2004. All rights reserved.
© Copyright IBM Japan 2004
目次はじめに . . . . . . . . . . . . . . vii本書の対象読者 . . . . . . . . . . . . . vii前提条件および関連資料 . . . . . . . . . . viii本書の構成 . . . . . . . . . . . . . . viiiオンライン資料へのアクセス . . . . . . . . . ixアクセシビリティー . . . . . . . . . . . . ixお客様サポートへの問い合わせ . . . . . . . . ix書体の規則 . . . . . . . . . . . . . . . ix
第 1 部 各プラットフォームのコマンド . . . . . . . . . . . . . . . . . 1
第 1 章 Tivoli コマンドの概要 . . . . . 5Tivoli 環境の確立 . . . . . . . . . . . . . 5コマンドの構文 . . . . . . . . . . . . . 6オブジェクト参照子 . . . . . . . . . . . . 7登録名 . . . . . . . . . . . . . . . 7オブジェクト・パス . . . . . . . . . . . 7
Tivoli トランザクション . . . . . . . . . . 8
第 2 章 コンポーネント別コマンド . . . 11アドミニストレーター・コマンド . . . . . . . 11構成管理コマンド . . . . . . . . . . . . 11エンドポイント・コマンドとゲートウェイ・コマンド . . . . . . . . . . . . . . . . . 12httpd コマンド . . . . . . . . . . . . . 13インストール・コマンド . . . . . . . . . . 13リージョン間コマンド . . . . . . . . . . . 14低レベル保守コマンド . . . . . . . . . . . 14管理対象ノード・コマンド . . . . . . . . . 15多重化配布コマンド . . . . . . . . . . . 15通知コマンド . . . . . . . . . . . . . . 16ポリシー・コマンド . . . . . . . . . . . 16照会コマンド . . . . . . . . . . . . . . 17RDBMS Interface Module (RIM) コマンド . . . . 17Revision Control System (RCS) コマンド . . . . . 17スケジューラー・コマンド . . . . . . . . . 18タスク・ライブラリー・コマンド . . . . . . . 18その他のコマンド . . . . . . . . . . . . 18
第 3 章 コマンド (アルファベット順) . . 21idlarg . . . . . . . . . . . . . . . . 22idlattr . . . . . . . . . . . . . . . . 23idlcall . . . . . . . . . . . . . . . . 25idlexception . . . . . . . . . . . . . . 27idlinput . . . . . . . . . . . . . . . . 29idlresult . . . . . . . . . . . . . . . . 30lcfd . . . . . . . . . . . . . . . . . 31lcfd.sh . . . . . . . . . . . . . . . . 43logls . . . . . . . . . . . . . . . . . 44
objcall . . . . . . . . . . . . . . . . 46odadmin. . . . . . . . . . . . . . . . 49odbls. . . . . . . . . . . . . . . . . 64odstat . . . . . . . . . . . . . . . . 66oinstall . . . . . . . . . . . . . . . . 71oserv. . . . . . . . . . . . . . . . . 73tivoli . . . . . . . . . . . . . . . . . 78tmcmd . . . . . . . . . . . . . . . . 80tmstat . . . . . . . . . . . . . . . . 81vdisp. . . . . . . . . . . . . . . . . 84w4inslcf.pl . . . . . . . . . . . . . . . 86waddicon . . . . . . . . . . . . . . . 89waddpath . . . . . . . . . . . . . . . 91wadminep . . . . . . . . . . . . . . . 92wauthadmin . . . . . . . . . . . . . . 93wbkupdb . . . . . . . . . . . . . . . 95wbindmsg . . . . . . . . . . . . . . . 99wbroadcast . . . . . . . . . . . . . . 101wcatcher . . . . . . . . . . . . . . . 102wcd. . . . . . . . . . . . . . . . . 104wchdep . . . . . . . . . . . . . . . 105wchkdb . . . . . . . . . . . . . . . 107wchknode . . . . . . . . . . . . . . . 109wchkpol . . . . . . . . . . . . . . . 111wci . . . . . . . . . . . . . . . . . 113wclient . . . . . . . . . . . . . . . . 121wclrblk. . . . . . . . . . . . . . . . 127wclrline . . . . . . . . . . . . . . . 129wco. . . . . . . . . . . . . . . . . 130wconnect . . . . . . . . . . . . . . . 136wcpcdrom . . . . . . . . . . . . . . . 140wcpyfile . . . . . . . . . . . . . . . 142wcrtadmin . . . . . . . . . . . . . . . 143wcrtgate . . . . . . . . . . . . . . . 145wcrtjob. . . . . . . . . . . . . . . . 147wcrtpol. . . . . . . . . . . . . . . . 150wcrtpr . . . . . . . . . . . . . . . . 151wcrtprf . . . . . . . . . . . . . . . . 153wcrtprfmgr . . . . . . . . . . . . . . 155wcrtqlib . . . . . . . . . . . . . . . 156wcrtquery . . . . . . . . . . . . . . . 157wcrtrim . . . . . . . . . . . . . . . 159wcrttask . . . . . . . . . . . . . . . 163wcrttlib . . . . . . . . . . . . . . . 165wdate . . . . . . . . . . . . . . . . 166wdel . . . . . . . . . . . . . . . . 167wdelep . . . . . . . . . . . . . . . . 169wdelgate . . . . . . . . . . . . . . . 170wdeljob . . . . . . . . . . . . . . . 171wdelpol . . . . . . . . . . . . . . . 172wdelpr . . . . . . . . . . . . . . . . 173
© Copyright IBM Corp. 2004 iii
wdelsched . . . . . . . . . . . . . . . 174wdeltask . . . . . . . . . . . . . . . 175wdepot . . . . . . . . . . . . . . . . 176wdepset . . . . . . . . . . . . . . . 180wdisconn . . . . . . . . . . . . . . . 183wdiskspace . . . . . . . . . . . . . . 185wdistrib . . . . . . . . . . . . . . . 186wdisttask . . . . . . . . . . . . . . . 188wdskspc . . . . . . . . . . . . . . . 190wdtmsg . . . . . . . . . . . . . . . 192weditini . . . . . . . . . . . . . . . 193wedsched . . . . . . . . . . . . . . . 195wenblsched . . . . . . . . . . . . . . 199wep. . . . . . . . . . . . . . . . . 201wepmgr . . . . . . . . . . . . . . . 213wepstatus . . . . . . . . . . . . . . . 219wepupgd . . . . . . . . . . . . . . . 223wexpnotif . . . . . . . . . . . . . . . 225wgateway . . . . . . . . . . . . . . . 226wgetadmin . . . . . . . . . . . . . . 237wgetallinst. . . . . . . . . . . . . . . 239wgetdfpol . . . . . . . . . . . . . . . 240wgeteppol . . . . . . . . . . . . . . . 241wgetjob . . . . . . . . . . . . . . . 243wgetkey . . . . . . . . . . . . . . . 244wgetpolm . . . . . . . . . . . . . . . 245wgetpr . . . . . . . . . . . . . . . . 247wgetprf . . . . . . . . . . . . . . . 248wgetquery . . . . . . . . . . . . . . . 250wgetrim . . . . . . . . . . . . . . . 251wgetsched . . . . . . . . . . . . . . . 253wgetsub . . . . . . . . . . . . . . . 255wgettask . . . . . . . . . . . . . . . 256wgetval . . . . . . . . . . . . . . . 257whostid . . . . . . . . . . . . . . . 258whttpd . . . . . . . . . . . . . . . . 259wiconv . . . . . . . . . . . . . . . . 261wident . . . . . . . . . . . . . . . . 262widmap . . . . . . . . . . . . . . . 263wifconfig . . . . . . . . . . . . . . . 265winsblk . . . . . . . . . . . . . . . 267winsline . . . . . . . . . . . . . . . 269winstall . . . . . . . . . . . . . . . 271winstdir . . . . . . . . . . . . . . . 274winstendpt. . . . . . . . . . . . . . . 275winstlcf . . . . . . . . . . . . . . . 276winterp. . . . . . . . . . . . . . . . 283wlcftap. . . . . . . . . . . . . . . . 284wln . . . . . . . . . . . . . . . . . 286wlocalhost. . . . . . . . . . . . . . . 288wlocktmr . . . . . . . . . . . . . . . 289wlocpath . . . . . . . . . . . . . . . 290wlookup . . . . . . . . . . . . . . . 292wls . . . . . . . . . . . . . . . . . 294wlsconn . . . . . . . . . . . . . . . 295wlsendpts . . . . . . . . . . . . . . . 297
wlsinst . . . . . . . . . . . . . . . . 298wlsnotif . . . . . . . . . . . . . . . 300wlspol . . . . . . . . . . . . . . . . 302wlspolm . . . . . . . . . . . . . . . 303wlssub . . . . . . . . . . . . . . . . 305wlstlib . . . . . . . . . . . . . . . . 306wmailhost . . . . . . . . . . . . . . . 307wmannode. . . . . . . . . . . . . . . 308wmcast. . . . . . . . . . . . . . . . 309wmdist . . . . . . . . . . . . . . . . 313wmdistgui . . . . . . . . . . . . . . . 323wmemsize . . . . . . . . . . . . . . . 324wmerge . . . . . . . . . . . . . . . 325wmrgaef . . . . . . . . . . . . . . . 326wmrgini . . . . . . . . . . . . . . . 328wmv . . . . . . . . . . . . . . . . 329wmvrim . . . . . . . . . . . . . . . 331wpatch . . . . . . . . . . . . . . . . 333wping . . . . . . . . . . . . . . . . 335wpopulate . . . . . . . . . . . . . . . 336wputeppol . . . . . . . . . . . . . . . 337wputpolm . . . . . . . . . . . . . . . 338wpwd . . . . . . . . . . . . . . . . 341wrcs . . . . . . . . . . . . . . . . 342wrcsdiff . . . . . . . . . . . . . . . 347wrcsmerge. . . . . . . . . . . . . . . 349wrefresh . . . . . . . . . . . . . . . 351wregister . . . . . . . . . . . . . . . 352wrestart . . . . . . . . . . . . . . . 354wrimtest . . . . . . . . . . . . . . . 355wrimtrace . . . . . . . . . . . . . . . 356wrlog . . . . . . . . . . . . . . . . 358wrm . . . . . . . . . . . . . . . . 361wrmnode . . . . . . . . . . . . . . . 362wrplblk . . . . . . . . . . . . . . . 364wrplline . . . . . . . . . . . . . . . 365wrpt . . . . . . . . . . . . . . . . 366wrunas . . . . . . . . . . . . . . . . 373wruninvquery . . . . . . . . . . . . . . 374wrunjob . . . . . . . . . . . . . . . 376wrunquery. . . . . . . . . . . . . . . 378wruntask . . . . . . . . . . . . . . . 380wschedjob . . . . . . . . . . . . . . . 384wserver . . . . . . . . . . . . . . . 388wsetadmin. . . . . . . . . . . . . . . 394wsetdfpol . . . . . . . . . . . . . . . 396wseterr . . . . . . . . . . . . . . . . 397wsetjob . . . . . . . . . . . . . . . 398wsetlang . . . . . . . . . . . . . . . 400wsetpkey . . . . . . . . . . . . . . . 402wsetpm . . . . . . . . . . . . . . . 403wsetpr . . . . . . . . . . . . . . . . 404wsetquery . . . . . . . . . . . . . . . 406wsetrim . . . . . . . . . . . . . . . 408wsetrimpw . . . . . . . . . . . . . . 411wsettap. . . . . . . . . . . . . . . . 412
iv Tivoli Management Framework: リファレンス・マニュアル
wsettask . . . . . . . . . . . . . . . 414wsetval. . . . . . . . . . . . . . . . 415wsndnotif . . . . . . . . . . . . . . . 417wstandalone . . . . . . . . . . . . . . 419wstartsched . . . . . . . . . . . . . . 421wsub . . . . . . . . . . . . . . . . 422wsupport . . . . . . . . . . . . . . . 423wtailnotif . . . . . . . . . . . . . . . 425wtaskabort. . . . . . . . . . . . . . . 426wtimezone. . . . . . . . . . . . . . . 428wtemp . . . . . . . . . . . . . . . . 429wtll . . . . . . . . . . . . . . . . . 430wtmrname . . . . . . . . . . . . . . . 433wtrace . . . . . . . . . . . . . . . . 434wuname . . . . . . . . . . . . . . . 438wuninst . . . . . . . . . . . . . . . 439wunstmn . . . . . . . . . . . . . . . 441wunsub . . . . . . . . . . . . . . . 443wupdate . . . . . . . . . . . . . . . 445wvalidate . . . . . . . . . . . . . . . 447wxterm. . . . . . . . . . . . . . . . 448
第 2 部 ポリシー・メソッド . . . . 449
第 4 章 エンドポイント・ポリシー・スクリプト. . . . . . . . . . . . . . 451エンドポイント・ポリシー・メソッド . . . . . 451allow_install_policy . . . . . . . . . . . . 452after_install_policy . . . . . . . . . . . . 456login_policy . . . . . . . . . . . . . . 459select_gateway_policy . . . . . . . . . . . 462
第 5 章 プロファイル・マネージャー・ポリシー・スクリプト . . . . . . . . 467プロファイル・マネージャーのデフォルト・ポリシー・メソッド . . . . . . . . . . . . . 467プロファイル・マネージャーの検証ポリシー・メソッド . . . . . . . . . . . . . . . . 467プロファイル・マネージャーのポリシー・メソッド 468pm_def_profile_managers . . . . . . . . . . 469pm_def_profile_types . . . . . . . . . . . 470pm_def_subscribers . . . . . . . . . . . . 471pm_val_remove_subscribers . . . . . . . . . 472pm_val_remove_subscription . . . . . . . . . 473pm_val_subscribers . . . . . . . . . . . . 474pm_val_subscription. . . . . . . . . . . . 475
第 6 章 タスク・ライブラリー・ポリシー・スクリプト . . . . . . . . . . . 477タスク・ライブラリーのデフォルト・ポリシー・メソッド . . . . . . . . . . . . . . . . 477タスク・ライブラリーの検証ポリシー・メソッド 477タスク・ライブラリー・ポリシー・メソッド . . . 478tl_def_dist_mode. . . . . . . . . . . . . 479tl_def_man_nodes . . . . . . . . . . . . 480
tl_def_prof_mgrs. . . . . . . . . . . . . 481tl_def_set_gid. . . . . . . . . . . . . . 482tl_def_set_uid. . . . . . . . . . . . . . 483tl_val_man_nodes . . . . . . . . . . . . 484tl_val_prof_mgrs . . . . . . . . . . . . . 485tl_val_set_gid. . . . . . . . . . . . . . 486tl_val_set_uid. . . . . . . . . . . . . . 487
第 7 章 ポリシー・スクリプトの編集 489エンドポイント・ポリシー・スクリプトの編集 . . 489プロファイル・マネージャーおよびタスク・ライブラリー・ポリシー・スクリプトの編集 . . . . . 490
第 3 部 タスク・ライブラリー言語 493
第 8 章 タスク・ライブラリー言語の概要 . . . . . . . . . . . . . . . . 495wtll コマンドの使用 . . . . . . . . . . . 495タスク・ライブラリーでのメッセージ・カタログの使用 . . . . . . . . . . . . . . . . 497エンドポイントでタスクを実行可能にする . . . . 498
第 9 章 タスク・ライブラリー言語の構文 . . . . . . . . . . . . . . . . 501ライブラリー特性の設定 . . . . . . . . . . 501引き数レイアウトの定義 . . . . . . . . . . 503
Text および CryptoText . . . . . . . . . 504Choice および TextChoice . . . . . . . . 505例 — Resource キーワードが指定されたChoice レイアウト . . . . . . . . . . 507例 — File キーワードが指定されたTextChoice レイアウト . . . . . . . . 509例 — 選択リストが組み込まれた TextChoiceレイアウト . . . . . . . . . . . . 510
ChoiceButton . . . . . . . . . . . . . 510例 — Program キーワード . . . . . . . 511例 — Resource キーワード . . . . . . . 511
RadioButton . . . . . . . . . . . . . 512例 — File キーワード . . . . . . . . 513例 — ラジオ・ボタンの組み込みリスト . . 513
タスク定義の作成 . . . . . . . . . . . . 514タスク・ヘッダーの定義 . . . . . . . . . 514Implementation 文節の定義 . . . . . . . . 515Argument 文節の定義 . . . . . . . . . . 517
タスク・ライブラリーへのコメントの追加 . . . . 519TLL 構成ファイルの編集 . . . . . . . . . 520
第 10 章 サンプル・タスク・ライブラリー . . . . . . . . . . . . . . . 521
付録. 特記事項 . . . . . . . . . . . 541商標 . . . . . . . . . . . . . . . . 542
索引 . . . . . . . . . . . . . . . 545
目次 v
vi Tivoli Management Framework: リファレンス・マニュアル
はじめに
Tivoli® Management Framework は、Tivoli 製品の基本コンポーネントです。 Tivoli
Management Framework と、Tivoli Enterprise アプリケーションの組み合わせを使用すると、複数のオペレーティング・システム、さまざまなネットワーク・サービス、多様なシステム・タスク、そして絶えず変化するノードやユーザーを含む大規模な分散ネットワークを管理できます。
Tivoli Management Framework は Tivoli Management Framework 上にインストールされている Tivoli Enterprise アプリケーションが使用する、一連の共通サービスまたは機能を提供します。 Tivoli Management Framework が提供するサービスには以下のものがありますが、ここに記載されているものに限定されるわけではありません。
v DHCP (動的ホスト構成プロトコル) を使用するインストール・システムで動的IP アドレッシングを使用可能にする DHCP サービス。
v タスクを作成し、複数の Tivoli リソースでタスクを実行するためのタスク・ライブラリー。
v Tivoli タスク・ライブラリー内で作成されたタスクの実行も含めて、すべてのTivoli 操作をスケジュールできるようにするスケジューラー。
v 一部の Tivoli Enterprise アプリケーションがリレーショナル・データベースにアプリケーション特有の情報を書き込むことができるようにするための RDBMS
Interface Module (RIM)。
v リレーショナル・データベースから情報を検索または取り出すための照会機能。
Tivoli Management Framework 上にインストールされている Tivoli アプリケーションは、Tivoli Management Framework が提供するサービスを使用できます。
このマニュアルには、Tivoli Management Framework コマンドについての詳細な情報が載せられています。また、Tivoli タスクとして実行するスクリプトを作成する場合にも役立ちます。さらに、Tivoli に付属するポリシー・スクリプトについても説明されています。
本書には随所に、特定のクライアント用のインタープリター・タイプに言及した箇所があります。マシン・タイプごとのインタープリター・タイプについては、「Tivoli Management Framework リリース情報」で説明されています。
本書の対象読者本書は、コマンド行を使用して Tivoli 操作を実行するシステム管理者を対象としています。また、本書は、Tivoli タスクとして実行するスクリプトを作成する場合にも役立ちます。本書の読者は、以下の事項に関する知識が必要です。
v UNIX® または Microsoft® Windows® オペレーティング・システム
v シェル・プログラミング
v Motif または Windows 環境
© Copyright IBM Corp. 2004 vii
前提条件および関連資料以下の関連資料が用意されています。
v Tivoli Management Framework デプロイメントの計画ガイド
Tivoli 環境を展開するときのプラン方法を説明しています。 Tivoli Management
Framework とそのサービスについても説明しています。
v Tivoli Enterprise インストール・ガイド
Tivoli Software Installation Service および Tivoli Management Framework で提供されていて利用可能なインストール・メカニズムを使用して、Tivoli リージョン内の Tivoli Enterprise™ソフトウェアをインストールおよびアップグレードする方法を説明しています。 Tivoli Enterprise ソフトウェアには、Tivoli サーバー、管理対象ノード、ゲートウェイ、エンドポイント、および RDBMS Interface Module
(RIM) オブジェクトが含まれます。このマニュアルには、インストール問題のトラブルシューティングについての情報も記載しています。
v Tivoli Management Framework ユーザーズ・ガイド
Tivoli Management Framework サービスを使用するときの概念と手順を説明しています。 Tivoli デスクトップとコマンド行からタスクを実行するときの指示を記載しています。
v Tivoli Management Framework 保守およびトラブルシューティング・ガイド
Tivoli 環境を保守する方法と、通常の操作で生じる可能性のある問題をトラブルシューティングする方法を説明しています。
本書の構成「Tivoli Management Framework リファレンス・マニュアル」には、以下のセクションがあります。
v 1ページの『第 1 部 各プラットフォームのコマンド』
Tivoli Management Framework が提供する Tivoli コマンドについての詳細な情報を記載しています。
Tivoli コマンドを使用すると、Tivoli デスクトップを使用せずに、UNIX のコマンド行からシステム操作を実行できます。モデム回線を使ってログインする場合など、グラフィック表示にアクセスできないときには、Tivoli コマンドが便利です。
v 449ページの『第 2 部 ポリシー・メソッド』
Tivoli Management Framework が提供するデフォルトおよび検証ポリシーのスクリプトとメソッドについての詳細が記載されています。
Tivoli Management Framework では、タスク・ライブラリーとプロファイル・マネージャーでデフォルト・ポリシーと検証ポリシーを使用します。これらのサービスでは、デフォルト・メソッドと検証メソッドを使用して、データの設定や検証を行うシェル・スクリプトを呼び出します。呼び出されるシェル・スクリプトを編集することにより、組織独自のカスタム・ポリシーを作成できます。
Tivoli ゲートウェイおよびエンドポイント・マネージャーでもポリシー・スクリプトを使用します。エンドポイントのスクリプトは、ポリシー・オブジェクトと関連付けられている点において、デフォルト・ポリシーおよび検証ポリシーとは異なります。
viii Tivoli Management Framework: リファレンス・マニュアル
v 493ページの『第 3 部 タスク・ライブラリー言語』
Tivoli タスク・ライブラリー言語を使用したタスク・ライブラリーの作成の詳細情報を説明します。
オンライン資料へのアクセス文書 CD には、製品ライブラリーに入っている資料が収められています。資料のフォーマットは PDF または HTML、あるいはその両方です。
この製品および他のすべての Tivoli 製品の資料が完成した場合および更新された場合、それらの資料は Tivoli Software Information Center の Web サイトにアップロードされます。まず最初に以下の Web アドレスの Tivoli ソフトウェア・ライブラリーにアクセスした後、Tivoli Software Information Center にアクセスしてください。
http://publib.boulder.ibm.com/tividd/td/tdprodlist.html
注: レターサイズ以外の用紙に PDF 文書を印刷する場合は、「ファイル」→「印刷」ウィンドウで、Adobe Reader でローカル用紙にレターサイズのページを印刷できるようにするオプションを設定してください。
アクセシビリティーアクセシビリティー機能は、体の動きが制限されている方や視力の弱い方など、何らかの身体的な障害のあるユーザーがソフトウェア製品を使用できるように支援する機能です。この製品では、インターフェースから音声による指示が提供され、インターフェースをナビゲートできるようにする補助テクノロジーを利用できます。また、マウスの代わりにキーボードを使用してグラフィカル・ユーザー・インターフェースのすべての機能を操作できます。
お客様サポートへの問い合わせ製品に関する情報、マニュアルに関する情報については、日本アイ・ビー・エムの担当者にご連絡ください。
書体の規則本書では、以下のような書体の規則を使用しています。
太字
v 前後のテキストと見分けにくい小文字のコマンドおよび大文字小文字が混合しているコマンド
v インターフェース・コントロール
v テキスト中のキーワードおよびパラメーター
イタリック
v テキスト中の定義されたワード
v ワードの強調 (ワードを表記どおり入力する必要がある場合)
v テキスト中の新規用語 (定義リストの場合を除く)
はじめに ix
v 入力しなければならない変数および値
モノスペース
v 例およびコード例
v ユーザーに向けて表示されるメッセージ・テキストおよびプロンプト
v ユーザーが入力しなければならないテキスト
v 引き数またはコマンド・オプションの値
このガイドは、環境変数の指定やディレクトリー表記に関しては UNIX 規則を使用しています。
v Windows コマンド行を使用する場合には、環境変数に関しては $ 変数を % 変数% に置換し、ディレクトリー・パスの各スラッシュ (/) を円記号 (¥) に置換します。
v Windows オペレーティング・システム 上で bash シェルを使用する場合には、UNIX 規則を使用してください。
x Tivoli Management Framework: リファレンス・マニュアル
第 1 部 各プラットフォームのコマンド第 1 章 Tivoli コマンドの概要 . . . . . . . . 5Tivoli 環境の確立 . . . . . . . . . . . . . 5コマンドの構文 . . . . . . . . . . . . . 6オブジェクト参照子 . . . . . . . . . . . . 7登録名 . . . . . . . . . . . . . . . 7オブジェクト・パス . . . . . . . . . . . 7
Tivoli トランザクション . . . . . . . . . . 8
第 2 章 コンポーネント別コマンド . . . . . . 11アドミニストレーター・コマンド . . . . . . . 11構成管理コマンド . . . . . . . . . . . . 11エンドポイント・コマンドとゲートウェイ・コマンド . . . . . . . . . . . . . . . . . 12httpd コマンド . . . . . . . . . . . . . 13インストール・コマンド . . . . . . . . . . 13リージョン間コマンド . . . . . . . . . . . 14低レベル保守コマンド . . . . . . . . . . . 14管理対象ノード・コマンド . . . . . . . . . 15多重化配布コマンド . . . . . . . . . . . 15通知コマンド . . . . . . . . . . . . . . 16ポリシー・コマンド . . . . . . . . . . . 16照会コマンド . . . . . . . . . . . . . . 17RDBMS Interface Module (RIM) コマンド . . . . 17Revision Control System (RCS) コマンド . . . . . 17スケジューラー・コマンド . . . . . . . . . 18タスク・ライブラリー・コマンド . . . . . . . 18その他のコマンド . . . . . . . . . . . . 18
第 3 章 コマンド (アルファベット順) . . . . . 21idlarg . . . . . . . . . . . . . . . . 22idlattr . . . . . . . . . . . . . . . . 23idlcall . . . . . . . . . . . . . . . . 25idlexception . . . . . . . . . . . . . . 27idlinput . . . . . . . . . . . . . . . . 29idlresult . . . . . . . . . . . . . . . . 30lcfd . . . . . . . . . . . . . . . . . 31lcfd.sh . . . . . . . . . . . . . . . . 43logls . . . . . . . . . . . . . . . . . 44objcall . . . . . . . . . . . . . . . . 46odadmin. . . . . . . . . . . . . . . . 49odbls. . . . . . . . . . . . . . . . . 64odstat . . . . . . . . . . . . . . . . 66oinstall . . . . . . . . . . . . . . . . 71oserv. . . . . . . . . . . . . . . . . 73tivoli . . . . . . . . . . . . . . . . . 78tmcmd . . . . . . . . . . . . . . . . 80tmstat . . . . . . . . . . . . . . . . 81vdisp. . . . . . . . . . . . . . . . . 84w4inslcf.pl . . . . . . . . . . . . . . . 86waddicon . . . . . . . . . . . . . . . 89waddpath . . . . . . . . . . . . . . . 91
wadminep . . . . . . . . . . . . . . . 92wauthadmin . . . . . . . . . . . . . . 93wbkupdb . . . . . . . . . . . . . . . 95wbindmsg . . . . . . . . . . . . . . . 99wbroadcast . . . . . . . . . . . . . . 101wcatcher . . . . . . . . . . . . . . . 102wcd. . . . . . . . . . . . . . . . . 104wchdep . . . . . . . . . . . . . . . 105wchkdb . . . . . . . . . . . . . . . 107wchknode . . . . . . . . . . . . . . . 109wchkpol . . . . . . . . . . . . . . . 111wci . . . . . . . . . . . . . . . . . 113wclient . . . . . . . . . . . . . . . . 121wclrblk. . . . . . . . . . . . . . . . 127wclrline . . . . . . . . . . . . . . . 129wco. . . . . . . . . . . . . . . . . 130wconnect . . . . . . . . . . . . . . . 136wcpcdrom . . . . . . . . . . . . . . . 140wcpyfile . . . . . . . . . . . . . . . 142wcrtadmin . . . . . . . . . . . . . . . 143wcrtgate . . . . . . . . . . . . . . . 145wcrtjob. . . . . . . . . . . . . . . . 147wcrtpol. . . . . . . . . . . . . . . . 150wcrtpr . . . . . . . . . . . . . . . . 151wcrtprf . . . . . . . . . . . . . . . . 153wcrtprfmgr . . . . . . . . . . . . . . 155wcrtqlib . . . . . . . . . . . . . . . 156wcrtquery . . . . . . . . . . . . . . . 157wcrtrim . . . . . . . . . . . . . . . 159wcrttask . . . . . . . . . . . . . . . 163wcrttlib . . . . . . . . . . . . . . . 165wdate . . . . . . . . . . . . . . . . 166wdel . . . . . . . . . . . . . . . . 167wdelep . . . . . . . . . . . . . . . . 169wdelgate . . . . . . . . . . . . . . . 170wdeljob . . . . . . . . . . . . . . . 171wdelpol . . . . . . . . . . . . . . . 172wdelpr . . . . . . . . . . . . . . . . 173wdelsched . . . . . . . . . . . . . . . 174wdeltask . . . . . . . . . . . . . . . 175wdepot . . . . . . . . . . . . . . . . 176wdepset . . . . . . . . . . . . . . . 180wdisconn . . . . . . . . . . . . . . . 183wdiskspace . . . . . . . . . . . . . . 185wdistrib . . . . . . . . . . . . . . . 186wdisttask . . . . . . . . . . . . . . . 188wdskspc . . . . . . . . . . . . . . . 190wdtmsg . . . . . . . . . . . . . . . 192weditini . . . . . . . . . . . . . . . 193wedsched . . . . . . . . . . . . . . . 195wenblsched . . . . . . . . . . . . . . 199
© Copyright IBM Corp. 2004 1
wep. . . . . . . . . . . . . . . . . 201wepmgr . . . . . . . . . . . . . . . 213wepstatus . . . . . . . . . . . . . . . 219wepupgd . . . . . . . . . . . . . . . 223wexpnotif . . . . . . . . . . . . . . . 225wgateway . . . . . . . . . . . . . . . 226wgetadmin . . . . . . . . . . . . . . 237wgetallinst. . . . . . . . . . . . . . . 239wgetdfpol . . . . . . . . . . . . . . . 240wgeteppol . . . . . . . . . . . . . . . 241wgetjob . . . . . . . . . . . . . . . 243wgetkey . . . . . . . . . . . . . . . 244wgetpolm . . . . . . . . . . . . . . . 245wgetpr . . . . . . . . . . . . . . . . 247wgetprf . . . . . . . . . . . . . . . 248wgetquery . . . . . . . . . . . . . . . 250wgetrim . . . . . . . . . . . . . . . 251wgetsched . . . . . . . . . . . . . . . 253wgetsub . . . . . . . . . . . . . . . 255wgettask . . . . . . . . . . . . . . . 256wgetval . . . . . . . . . . . . . . . 257whostid . . . . . . . . . . . . . . . 258whttpd . . . . . . . . . . . . . . . . 259wiconv . . . . . . . . . . . . . . . . 261wident . . . . . . . . . . . . . . . . 262widmap . . . . . . . . . . . . . . . 263wifconfig . . . . . . . . . . . . . . . 265winsblk . . . . . . . . . . . . . . . 267winsline . . . . . . . . . . . . . . . 269winstall . . . . . . . . . . . . . . . 271winstdir . . . . . . . . . . . . . . . 274winstendpt. . . . . . . . . . . . . . . 275winstlcf . . . . . . . . . . . . . . . 276winterp. . . . . . . . . . . . . . . . 283wlcftap. . . . . . . . . . . . . . . . 284wln . . . . . . . . . . . . . . . . . 286wlocalhost. . . . . . . . . . . . . . . 288wlocktmr . . . . . . . . . . . . . . . 289wlocpath . . . . . . . . . . . . . . . 290wlookup . . . . . . . . . . . . . . . 292wls . . . . . . . . . . . . . . . . . 294wlsconn . . . . . . . . . . . . . . . 295wlsendpts . . . . . . . . . . . . . . . 297wlsinst . . . . . . . . . . . . . . . . 298wlsnotif . . . . . . . . . . . . . . . 300wlspol . . . . . . . . . . . . . . . . 302wlspolm . . . . . . . . . . . . . . . 303wlssub . . . . . . . . . . . . . . . . 305wlstlib . . . . . . . . . . . . . . . . 306wmailhost . . . . . . . . . . . . . . . 307wmannode. . . . . . . . . . . . . . . 308wmcast. . . . . . . . . . . . . . . . 309wmdist . . . . . . . . . . . . . . . . 313wmdistgui . . . . . . . . . . . . . . . 323wmemsize . . . . . . . . . . . . . . . 324wmerge . . . . . . . . . . . . . . . 325
wmrgaef . . . . . . . . . . . . . . . 326wmrgini . . . . . . . . . . . . . . . 328wmv . . . . . . . . . . . . . . . . 329wmvrim . . . . . . . . . . . . . . . 331wpatch . . . . . . . . . . . . . . . . 333wping . . . . . . . . . . . . . . . . 335wpopulate . . . . . . . . . . . . . . . 336wputeppol . . . . . . . . . . . . . . . 337wputpolm . . . . . . . . . . . . . . . 338wpwd . . . . . . . . . . . . . . . . 341wrcs . . . . . . . . . . . . . . . . 342wrcsdiff . . . . . . . . . . . . . . . 347wrcsmerge. . . . . . . . . . . . . . . 349wrefresh . . . . . . . . . . . . . . . 351wregister . . . . . . . . . . . . . . . 352wrestart . . . . . . . . . . . . . . . 354wrimtest . . . . . . . . . . . . . . . 355wrimtrace . . . . . . . . . . . . . . . 356wrlog . . . . . . . . . . . . . . . . 358wrm . . . . . . . . . . . . . . . . 361wrmnode . . . . . . . . . . . . . . . 362wrplblk . . . . . . . . . . . . . . . 364wrplline . . . . . . . . . . . . . . . 365wrpt . . . . . . . . . . . . . . . . 366wrunas . . . . . . . . . . . . . . . . 373wruninvquery . . . . . . . . . . . . . . 374wrunjob . . . . . . . . . . . . . . . 376wrunquery. . . . . . . . . . . . . . . 378wruntask . . . . . . . . . . . . . . . 380wschedjob . . . . . . . . . . . . . . . 384wserver . . . . . . . . . . . . . . . 388wsetadmin. . . . . . . . . . . . . . . 394wsetdfpol . . . . . . . . . . . . . . . 396wseterr . . . . . . . . . . . . . . . . 397wsetjob . . . . . . . . . . . . . . . 398wsetlang . . . . . . . . . . . . . . . 400wsetpkey . . . . . . . . . . . . . . . 402wsetpm . . . . . . . . . . . . . . . 403wsetpr . . . . . . . . . . . . . . . . 404wsetquery . . . . . . . . . . . . . . . 406wsetrim . . . . . . . . . . . . . . . 408wsetrimpw . . . . . . . . . . . . . . 411wsettap. . . . . . . . . . . . . . . . 412wsettask . . . . . . . . . . . . . . . 414wsetval. . . . . . . . . . . . . . . . 415wsndnotif . . . . . . . . . . . . . . . 417wstandalone . . . . . . . . . . . . . . 419wstartsched . . . . . . . . . . . . . . 421wsub . . . . . . . . . . . . . . . . 422wsupport . . . . . . . . . . . . . . . 423wtailnotif . . . . . . . . . . . . . . . 425wtaskabort. . . . . . . . . . . . . . . 426wtimezone. . . . . . . . . . . . . . . 428wtemp . . . . . . . . . . . . . . . . 429wtll . . . . . . . . . . . . . . . . . 430wtmrname . . . . . . . . . . . . . . . 433
2 Tivoli Management Framework: リファレンス・マニュアル
wtrace . . . . . . . . . . . . . . . . 434wuname . . . . . . . . . . . . . . . 438wuninst . . . . . . . . . . . . . . . 439wunstmn . . . . . . . . . . . . . . . 441wunsub . . . . . . . . . . . . . . . 443wupdate . . . . . . . . . . . . . . . 445wvalidate . . . . . . . . . . . . . . . 447wxterm. . . . . . . . . . . . . . . . 448
第 1 部 各プラットフォームのコマンド 3
4 Tivoli Management Framework: リファレンス・マニュアル
第 1 章 Tivoli コマンドの概要
Tivoli コマンドを使用すると、Tivoli デスクトップを使用せずに、UNIX のコマンド行からシステム操作を実行できます。モデム回線を使ってログインする場合など、グラフィック表示にアクセスできないときには、Tivoli コマンドが便利です。
Tivoli のエンド・ユーザー・コマンドはすべて、Tivoli コマンドであることを示すために w で始まります。コマンドは w + 動詞 + オブジェクトという構文で開発されています。この構文は、そのコマンドの働きを示すものです。たとえば、タスクを作成する場合は、wcrttask というコマンドを使用します。また、ジョブを削除する場合は、 wdeljob というコマンドを使用します。
Tivoli 管理アプリケーションの操作は、グラフィカル・ユーザー・インターフェースから呼び出すよりもコマンド行から呼び出す方が便利な場合や適切な場合があります。たとえば、次のような構文があるとします。
v モデムを使ってダイヤル接続しているために、グラフィカル・ユーザー・インターフェースにアクセスできない場合
v いくつかの操作を、まとめてシェル・スクリプトに入れる必要がある場合
v コマンドをシェルから呼び出す場合
Tivoli 環境の確立Tivoli Management Framework には、setup_env.sh および setup_env.csh スクリプトが組み込まれています。これらを使用すれば、検索パスと環境変数を正しく設定することができます。これらのセットアップ・スクリプトは、Tivoli リージョン内のどのサーバーまたは管理対象ノードでも使用できます。
Tivoli 環境変数をセットアップするには、以下のステップを実行します。
1. 管理対象ノードまたは Tivoli サーバーにログインします。
2. 次のいずれかを実行します。
UNIX オペレーティング・システムでのみ、次のいずれかを実行します。
v Bourne シェルを使用している場合には、次のスクリプトを入力します。
. /etc/Tivoli/setup_env.sh
v C シェルを使用している場合には、次のスクリプトを入力します。
source /etc/Tivoli/setup_env.csh
Windows オペレーティング・システムでのみ、次のいずれかを実行します。
v bash シェルから、次のコマンドを入力します。
%SystemRoot%/system32/drivers/etc/Tivoli/setup_env.sh
v コマンド・プロンプトから、次のコマンドを入力します。
%SystemRoot%¥system32¥drivers¥etc¥Tivoli¥setup_env.cmd
v 自動的に Tivoli 環境 に読み込むように Windows コマンド行を構成するには、次のステップを実行します。
© Copyright IBM Corp. 2004 5
a. Tivoli デスクトップ へのコマンド・プロンプト (MS-DOS) ショートカットを右マウス・ボタン・クリックします。
b. 「プロパティー」をクリックします。
c. 「ショートカット」 タブをクリックします。
d. 「リンク先」テキスト・ボックスに、次のコマンドを 1 行で入力します。
%SystemRoot%¥system32¥cmd.exe /kc:¥%SystemRoot%¥system32¥drivers¥etc¥Tivoli¥setup_env.cmd
これで Tivoli の保守操作を実行するための環境が整いました。
コマンドの構文本書では、コマンド構文の定義に次の特殊文字を使用します。
[ ] 任意のオプションであることを示します。大括弧で囲まれていないオプションは、必須です。
... 直前のオプションに複数の値を指定できることを示します。
| 相互に排他的な情報を示します。区切り文字の左側のオプションまたは区切り文字の右側のオプションの、どちらか一方を使用できます。 1 つのコマンドで両方のオプションを使用することはできません。
{ } 相互に排他的な一連のオプションを示します。その中のどれか 1 つを指定する必要があります。オプションが任意の場合は、それらのオプションは大括弧 ([]) で囲まれています。
¥ コマンド行が次の行に折り返すことを示します。これは継続文字です。
たとえば、次のような構文があるとします。
logls [-Dofls] [-k dir] [-m maxdlen] log_name...
logls コマンドの必須オプションは log_name だけです。 log_name オプションの後の省略符号は、複数のログ・ファイル名を指定できることを示します。また、[] (大括弧) で囲まれているオプションは、それらのオプションが任意であることを示しています。
もう 1 つの例として、wchkdb コマンドを取り上げます。
wchkdb [-o outfile] [-u] [-x] {-f infile | -i | object...}
この例では、-f infile、-i、object の各オプションは、それぞれ相互に排他的です。中括弧 ({}) で囲まれているオプションのうち、どれか 1 つを指定する必要があります。 object 引き数を指定する場合は、必要に応じて複数のオブジェクト名またはオブジェクト ID を指定できます。
コマンドを実装するためにオプションを特定の順序で使用する必要がある場合以外は、それぞれのコマンドのオプションは、「オプション」のセクションにアルファベット順にリスト表示します。
6 Tivoli Management Framework: リファレンス・マニュアル
オブジェクト参照子コマンド行でオブジェクトを参照する場合の参照子は、プログラミングで使用するような絶対的なオブジェクト参照子 ではありません。そうしたオブジェクト参照子の代わりに、使いやすい名前が使用されます。この使いやすい名前は、ポリシー・リージョンの作成時などにアプリケーションのユーザーがオブジェクトに付けた名前から引用するように設定されます。
コマンドで使用できる名前には、次の 2 つの形式があります。
v 登録名
v オブジェクト・パス
コマンド行インターフェースを使用する Tivoli プログラムは、両方の命名方式をサポートしています。形式は、どちらか一方のほうが便利な場合もあります。リソースが見つからないことを示すエラー・メッセージを受け取った場合は、もう一方の命名規則を使用してみてください。
登録名ネーム・レジストリーの背景にあるキー概念が、登録名 です。登録名とは、リソースの作成時にネーム・レジストリーに登録されるリソースのインスタンスです。すべてのリソースは名前を持ち、ある特定のタイプに属しています。たとえば、lp01
と呼ばれるプリンターは、lp01 という名前を持ち、タイプは printer です。 wls および wmv コマンドのオプションとして登録名を使用した例を次に示します。
wls @PolicyRegion:Serverswmv @ManagedNode:ayers-rock @PolicyRegion:Servers
登録名機能を使ってリソースを指定する場合は、@type:name という構文を使用します。 type には、リソース・タイプを指定し、name には操作の対象となるリソースのインスタンスを指定します。
ネーム・レジストリーでは、1 つの Tivoli リージョンの中に同じタイプで同じ名前のリソースを複数登録することはできません。ただし、2 つ (またはそれ以上) の接続されたリージョンの間では、リソース名が重複しても構いません。重複する名前を持つリソースに対してアクションを実行しようとすると、エラー・メッセージが戻り、アクションは実行されません。
このような状況を回避するには、どちらか一方のリソース名を変更するか、次のようにリソース名にリージョン名を追加してリソースを区別できるようにします。
wls @ManagedNode:moria#moria-Region
オブジェクト・パスオブジェクト・パス はファイル・システムのパスに似たもので相対パスを指定することも絶対パスを指定することもできます。絶対パスはスラッシュ (/) 文字で始めます。相対パスは、任意の文字で始まり、特殊なパス・コンポーネントであるピリオド (.) または二重ピリオド (..) を含みます。 wls および wmv コマンドのオプションとしてオブジェクト・パス名を使用した例を次に示します。
wls /Regions/Serverswmv ../Servers/ayers-rock /Regions/Servers
第 1 章 Tivoli コマンドの概要 7
オブジェクト・パス名のスタイルを使ってリソースを指定する場合は、/distinguished/parent/[type:] name 構文を使用します。distinguished にはソース・タイプを、parent にはオブジェクト・パス名の開始点を指定します。type はさらにリソースを指定する必要がある場合に使用します。name には操作の対象となる特定のインスタンスを指定します。 オプションの type 修飾子は、同じ名前でタイプの異なるリソースがある場合によく使用します。
たとえば、ポリシー・リージョン Engineering に Servers という名前のプロファイル・マネージャーと Servers という名前のポリシー・サブリージョンがあるとします。オブジェクト・パス名を使ってこのプロファイル・マネージャーを指定した例を、次に示します。
wls /Regions/Engineering/ProfileManager:Servers
絶対パスを使ってリソースを指定した場合、接続されたリージョンの中でリソースの位置があいまいになることはありません。一方、相対パスを使用した場合は、ホーム・コレクションと現行のアドミニストレーター・コレクションの両方の位置がわからないと、リソースを見付けることはできません。アドミニストレーターごとのホーム・コレクションは、/Administrators/name です (name はTivoli アドミニストレーターの名前)。
wcd コマンドを発行した直後は、現行のアドミニストレーター・コレクションの位置を指定するレコードが Tivoli Management Framework に保存されています。それ以外の場合はそのようなレコードは存在しないので、複数の Tivoli リージョンが接続されている場合は現行のアドミニストレーター・コレクションの位置があいまいになる恐れがあります。たとえば、John という名前のアドミニストレーター (ログイン名 johnc) がリージョン A に存在し、リージョン B にも John という名前のアドミニストレーター (ログイン名 jsmith) が存在するとします。リソース上でアクションを実行するよう指定すると、Tivoli Management Framework は/Administrators/John というコレクションを検索します。この検索では、johnc とjsmith に属するコレクションが検出されます。 Tivoli Management Framework は、指定されたホーム・コレクションがどちらなのかを判別できないので、エラー・メッセージを戻し、処理は実行しません。このような問題の発生を避けるには、wcdコマンドを実行してください。
Tivoli トランザクションTivoli 製品の分散環境では、プログラム・エラー条件が発生すると Tivoli オブジェクト・データベースと実作業環境の間の整合性エラーが生じることがあります。たとえば、Tivoli Enterprise アプリケーションの管理対象ノード上で新規ユーザーを作成する場合、そのアプリケーションは新規ユーザー・オブジェクトを作成して、そのノードのパスワード・ファイルに項目を追加しなければなりません。パスワード・ファイルの書き込み中にエラーが発生した場合、アプリケーションはユーザー・オブジェクトも削除できなければなりません。ユーザー・オブジェクトを削除しないと、Tivoli データベースは不整合状態のままです。
この問題を解決するために、Tivoli には トランザクション・システム が用意されています。トランザクションとは一連の操作で、トランザクションに属する操作はすべて正常に終了する必要があります。トランザクション内の操作のいずれかが失敗すると、他の操作による変更はすべて中止されます。
8 Tivoli Management Framework: リファレンス・マニュアル
Tivoli トランザクションでは、トランザクションの階層を形成するネストされたトランザクションを作成できます。メソッドの呼び出しには、次のいずれかの方法があります。
v メソッドがトランザクションに含まれていない場合。
v メソッドがトランザクション階層の最上位トランザクションである場合。
v メソッドが最上位トランザクションのサブトランザクションである場合。
v メソッドが取り消し可能サブトランザクションである場合。
最上位トランザクションは、サブトランザクションが正常終了した場合にだけ正常に終了します。最上位トランザクションが失敗した場合、Tivoli はその最上位トランザクションおよびサブトランザクションが行った変更をすべて取り消します。サブトランザクションに、さらにサブトランザクションを設定することもできます。
取り消し可能なサブトランザクションは、親トランザクションを強制的に打ち切ることなく中止できます。親トランザクションは、その障害がトランザクション全体を打ち切る必要があるほど重大なものかどうかを判別します。例として、取り消し可能サブトランザクションを呼び出して一連のデータベース・レコードを書き込むトランザクションを考えてみましょう。 99 % のレコードを書き込んだ後でサブトランザクションが異常終了した場合、親トランザクションは必ず正常終了することを選びます。一方、5 % しか書き込んでいないときにメソッドに障害が発生した場合、親トランザクションは異常終了して、書き込んだレコードを取り消します。
Tivoli タスク・ライブラリーは、このトランザクション・モデルを使ってジョブを実行します。 Tivoli デスクトップから実行されるタスクは最上位トランザクションとして実行されます。ただし、シェル・スクリプトを実行するタスクを作成することもできます。このようなタスクは、サブトランザクションまたは取り消し可能サブトランザクションとして、さらに別の Tivoli タスクを実行します。
第 1 章 Tivoli コマンドの概要 9
10 Tivoli Management Framework: リファレンス・マニュアル
第 2 章 コンポーネント別コマンド
以下のセクションでは、コンポーネントごとの Tivoli Management Framework コマンドのリストを示します。各セクションごとに、コマンド名と目的をまとめた表を示します。
アドミニストレーター・コマンド
コマンド 目的
wauthadmin Tivoli リージョン内の Tivoli アドミニストレーターの root 権限を追加、削除、または表示する。
wcrtadmin 新規の Tivoli アドミニストレーターを作成する。
wgetadmin Tivoli アドミニストレーターに関する情報をリスト表示する。
widmap ユーザー・ログイン・マップのリスト表示と変更を行う。
wsetadmin Tivoli アドミニストレーターに関する情報を変更する。
wsetlang Tivoli サーバーまたは管理対象ノードに使用するオペレーティング・システム・ロケールを判別する。
構成管理コマンド
コマンド 目的
wcrtprf 新しいプロファイルの作成、または既存のプロファイルの複製を行う。
wcrtprfmgr プロファイル・マネージャーを作成する。
wdistrib 1 つまたは複数のプロファイル・コピーを配布する。
wgetprf 1 つまたは複数のプロファイルのサブスクリプション・コピーを検索する。
wgetsub プロファイル・マネージャーのサブスクリプションをリスト表示する。
wlssub ホスト、NIS ドメイン、またはプロファイル・マネージャーのサブスクリプション先のプロファイル・マネージャーをリスト表示する。
wpopulate システム・ファイルからプロファイルに情報を取り込む。
wsetpm プロファイル・マネージャーのデータレス・モードでの運用を使用可能または使用禁止にする。
wsub Tivoli リソースをプロファイル・マネージャーにサブスクライブする。
wuninst 指定のノードまたは Tivoli リージョン全体から Tivoli アプリケーションをアンインストールする。
wunsub Tivoli リソースを、プロファイル・マネージャーのサブスクリプション・リストから削除する。
© Copyright IBM Corp. 2004 11
コマンド 目的
wvalidate プロファイルをその検証ポリシーと比較して検証する。
エンドポイント・コマンドとゲートウェイ・コマンド
コマンド 目的
lcfd エンドポイント上のエンドポイント・デーモン (lcfd) の始動、Windows オペレーティング・システム上のサービスとしてのエンドポイント・デーモンのインストールまたは削除を行う。
lcfd.sh UNIX および Linux エンドポイントでエンドポイント・デーモン(lcfd) を始動または停止する。
w4inslcf.pl iSeries システムに AS/400 エンドポイントをインストールする。
waddpath 現行コントロール・セットのレジストリー・ハイブ内のパス・ステートメントに項目を追加する。(Windows のみ)
wadminep エンドポイント自動的にアップグレードする。
wclrblk ファイルからステートメントのブロックを削除する。
wclrline ファイルから 1 行を削除する。
wcpyfile .NCF 構成プログラムでファイルをコピーできるようにする。(NetWare のみ)
wcrtgate ゲートウェイを作成する。
wdelep エンドポイントを削除する。
wdelgate ゲートウェイを削除する。
wdskspc 使用可能なディスク・スペースの量を検査する。(Windows およびNetWare のみ)
weditini .ini ファイル内のグループ、変数、および値を変更する。
wep エンドポイント・リストに入っているエンドポイント情報に関してアクションを実行する。
wepmgr エンドポイント・マネージャー用のコントロールおよび構成機能を提供する。
wepstatus エンドポイントの状況を戻す。
wepupgd エンドポイントを最新のソフトウェアにアップグレードする。注: wadminep upgrade コマンドを置き換える。
wgateway エンドポイント・ゲートウェイの起動、停止、またはプロパティーの表示を実行する。
wgetkey レジストリー・ハイブ内のサブキーのリストを検索する。(Windows
のみ)
wgetval レジストリー・サブキーを検索する。(Windows のみ)
winsblk ステートメントのブロックをファイルに挿入する。
winsline ファイルに 1 行挿入する。
winstlcf エンドポイントをインストールする。(Linux、UNIX、およびWindows のみ)
wlsendpts プロファイル・マネージャーにサブスクライブされているエンドポイントをすべて表示する。
12 Tivoli Management Framework: リファレンス・マニュアル
コマンド 目的
wmrgini ある .INI ファイルのグループおよび変数を、別の .INI ファイルのグループおよび変数にマージする。
wrestart システムの再始動やオプションの再始動を開始する。 (Windows のみ)
wrplblk ファイル内のステートメントのブロックを置換する。
wrplline ファイル内の 1 行を置換する。
wseterr 構成プログラム用のバッチ・ファイルからの戻りコードを設定する。
wsetval レジストリーのキー値を設定する。 (Windows のみ)
wstandalone rsh または rexec を使用せずに管理対象ノードまたはエンドポイントをインストールする。
httpd コマンド
コマンド 目的
whttpd Tivoli HTTP サービスをアンインストールするか、 HTTP 要求をサード・パーティーの HTTP サーバーに転送する。
インストール・コマンド
コマンド 目的
oinstall Tivoli オブジェクト・ディスパッチャー・サービスの Windows
サービス・マネージャーへのインストール、更新、または削除を行う。
wclient Tivoli クライアントをインストールする。
wcpcdrom CD からシステム・ディレクトリーへインストール・イメージをコピーする。
winstall Tivoli Enterprise 製品をインストールする。
winstlcf エンドポイントを、Linux、UNIX、および Windows ワークステーションにインストールする。
wmailhost Windows 管理対象ノードが使用するメール・サーバーを指定する。
wpatch Tivoli パッチをインストールする。
wserver Tivoli サーバーをインストールする。(Linux および UNIX のみ)
wsettap Tivoli 認証パッケージのプロパティーを設定する。 (Windows
のみ)
wstandalone rsh または rexec を使用せずに管理対象ノードまたはエンドポイントをインストールする。
第 2 章 コンポーネント別コマンド 13
リージョン間コマンド
コマンド 目的
wconnect 2 つの Tivoli リージョンを接続する。
wdisconn 2 つの Tivoli リージョンの接続を切断する。
wlookup リソースのオブジェクト参照子を検索する。
wlsconn 現行の Tivoli リージョン接続をリスト表示するか、あるいは単一の接続に関する情報をリスト表示する。
wregister ネーム・レジストリーにリソースを登録する。
wtmrname ローカルの Tivoli リージョンの名前を表示または変更する。
wupdate ローカル・ネーム・レジストリー内のリソースを更新する。
低レベル保守コマンド
コマンド 目的
idlarg idlinput コマンドで戻るオプション・リストから、個々のオプションを抽出する。
idlattr インプリメンテーション属性を取得または設定する。
idlcall シェル・コマンド行からインターフェース定義言語 (IDL) 操作を呼び出すメソッドを提供する。
idlexception シェル・メソッドの例外を発生させる。
idlinput シェル・メソッドに対する入力オプションまたは入出力オプションのリストを取得する。
idlresult シェル・メソッドの入出力オプション、出力オプション、または結果 (ある場合) を形式設定する。
logls トランザクション・ログ・ファイルの読み取り可能バージョンを作成する。
objcall シェルからオブジェクト呼び出しを実行する。
odadmin オブジェクト・ディスパッチャーを管理する。
odbls オブジェクト・データベースの内容をリスト表示する。
odstat 現在および最近のオブジェクト呼び出しの状況をリスト表示する。
oserv オブジェクト・ディスパッチャーのコントロールおよび設定のための操作を提供する。
tmcmd 実行中のトランザクションの状態を強制的に変更する。
tmstat 現行トランザクションの状況を表示し、ロックする。
wlocalhost ローカル・ホストの名前を Windows レジストリー内に設定する。 (Windows 管理対象ノードのみ)
wlocktmr 現行の Tivoli リージョンを保守モードに設定する。
wmailhost Windows 管理対象ノードが使用するメール・サーバーを指定する。
14 Tivoli Management Framework: リファレンス・マニュアル
管理対象ノード・コマンド
コマンド 目的
wclient 管理対象ノードを作成する。
wdate 管理対象ノードの現在の日付と時刻を出力する。
wdiskspace 指定された管理対象ノードの指定のディレクトリー (ファイル・システム) 内にある使用可能空きキロバイト数を出力する。
whostid 指定された管理対象ノードのホスト ID を出力する。
wifconfig 管理対象ノード上の IP インターフェースの照会または変更を行う。
winstdir 指定された管理対象ノードのインストール・ディレクトリーのパスを出力する。
winterp 指定された管理対象ノードのインタープリター・タイプを表示する。
wmannode 管理対象ノードのプロパティーを返す。
wmemsize 管理対象ノードの物理メモリーの量を報告する。
wrmnode Tivoli 環境から管理対象ノードを削除する。
wstandalone rsh または rexec を使用せずに管理対象ノードまたはエンドポイントをインストールする。
wtimezone 指定したシステムの時間帯の値を出力する。
wuname オペレーティング・システムの情報をリスト表示する。
wunstmn 管理対象ノードから Tivoli Management Framework ファイルを削除する。
wxterm UNIX 管理対象ノードで X 端末セッションを始動する。
多重化配布コマンド
コマンド 目的
lcfd エンドポイント上の Wake-On-LAN 機能の使用可能化などの構成情報を、エンドポイント・デーモン (lcfd) に提供する。
wadminep エンドポイント・デーモンのアップグレード、 Wake-On-LAN
操作用のエンドポイント・ウェイクアップ・パケットの生成など、エンドポイント上での管理操作を実行する。
wdepot MDist 2 リピーター・デポを管理する。
wep エンドポイント・リストに含まれるエンドポイント情報に対するアクションを実行する (Windows エンドポイントを設定して、 Tivoli モバイル・コンピューティング・コンソールを介して MDist 2 配布を受け取ったりコントロールするなど)。
wmdist MDist 2 リピーターを構成して、配布を管理する。
wmdistgui このコマンドを実行する管理対象ノードから、配布状況コンソールを開始する。
第 2 章 コンポーネント別コマンド 15
コマンド 目的
wrpt 管理対象ノード上にリピーターを作成し (MDist および MDist
2 の両方について)、MDist リピーターを構成し、MDist 配布を管理する。
通知コマンド
コマンド 目的
wbroadcast すべての Tivoli デスクトップにメッセージをブロードキャストする。
wexpnotif 通知グループの通知を期限切れにする。
wlsnotif アドミニストレーターの掲示板上の通知を表示する。
wsndnotif 標準入力をメッセージ構造に変換して、通知サーバーに送信する。
wtailnotif 通知サーバーに接続して、新しい通知がポストされると、これを表示する。
ポリシー・コマンド
コマンド 目的
wchkpol ポリシーと比較して、ポリシー・リージョンのメンバーをチェックする。
wcrtpol クラスの新規ポリシー・オブジェクトを作成する。
wcrtpr ポリシー・リージョンを作成する。
wdelpol デフォルトのポリシー・オブジェクトを削除する。
wdelpr ポリシー・リージョンを削除する。
wgetdfpol デフォルトのポリシー・オブジェクトをリスト表示する。
wgeteppol エンドポイント・ポリシー・スクリプトの本体と定数値を表示する。
wgetpolm デフォルト・ポリシー・メソッドまたは検証ポリシー・メソッドの本体あるいは定数値を表示する。
wgetpr ポリシー・リージョンのプロパティーをリスト表示する。
wlspol Tivoli リソースの使用可能なポリシー・デフォルト・オブジェクトおよび検証オブジェクトをリスト表示する。
wlspolm Tivoli リソースのポリシー・メソッドをリスト表示する。
wputeppol 変更したエンドポイント・ポリシー・スクリプトを置換する。
wputpolm ポリシー・メソッドの本体を置換する。
wsetdfpol クラスのデフォルト・ポリシーを設定する。
wsetpr ポリシー・リージョンで使用するポリシーを割り当てて、ポリシーの検証を使用可能または使用禁止にする。ポリシー・リージョン内の管理対象リソースの追加または削除も行う。
16 Tivoli Management Framework: リファレンス・マニュアル
照会コマンド
コマンド 目的
wcrtqlib 照会ライブラリーを作成する。
wcrtquery 照会を作成する。
wgetquery 照会に関する情報をリスト表示する。
wruninvquery インベントリー情報のデータベースを照会して、照会基準に一致するオブジェクト ID とオブジェクト・ラベルのリストを返す。
wrunquery 照会を実行して、結果を標準出力とファイルのどちらかに戻す。
wsetquery 照会のプロパティーを編集する。
RDBMS Interface Module (RIM) コマンド
コマンド 目的
wcrtrim RIM オブジェクトを作成する。
wgetrim RIM オブジェクトに関する情報をリスト表示する。
wmvrim RIM オブジェクトを別の管理対象ノードに移動する。
wrimtest RIM オブジェクトの接続性と機能性を検査する。
wrimtrace RIM オブジェクトのトレースを使用可能または使用禁止にする。
wsetrim RIM オブジェクトのデータベース情報を変更する。
wsetrimpw RIM オブジェクト・データベースの RIM パスワードを設定する。
Revision Control System (RCS) コマンド
コマンド 目的
wci RCS リビジョンをチェックインする。
wco RCS リビジョンをチェックアウトする。
wident ファイルを識別する。
wrcs RCS ファイル属性を変更する。
wrcsdiff RCS リビジョンを比較する。
wrcsmerge RCS リビジョンをマージする。
wrlog ログ・メッセージおよび RCS ファイルに関するその他の情報を出力する。
第 2 章 コンポーネント別コマンド 17
スケジューラー・コマンド
コマンド 目的
wdelsched スケジューラーからジョブを削除する。
wedsched スケジューラーに現存するジョブを編集する。
wenblsched スケジュールされているジョブを無効または有効にする。
wgetsched スケジューラーに現存するジョブについての情報を検索する。
wschedjob タスク・ライブラリーに入っているジョブをスケジューリングする。
wstartsched Tivoli スケジューラーを始動する。
タスク・ライブラリー・コマンド
コマンド 目的
wcrtjob タスク・ライブラリー内にジョブを作成する。
wcrttask タスク・ライブラリー内にタスクを作成する。
wcrttlib タスク・ライブラリーを作成する。
wdeljob タスク・ライブラリーからジョブを削除する。
wdeltask タスク・ライブラリーからタスクを削除する。
wdisttask タスク・ライブラリー用のタスク・ バイナリーの配布をコントロールする。
wgetjob ジョブのプロパティーをリスト表示する。
wgettask タスクのプロパティーをリスト表示する。
wlstlib タスク・ライブラリーのプロパティーをリスト表示する。
wrunjob タスク・ライブラリー内のジョブを実行する。
wruntask タスク・ライブラリーのタスクを実行する。
wsetjob ジョブのプロパティーを設定する。
wsettask タスクのプロパティーを設定する。
wtaskabort タスクのトランザクションを中止して、コミットされていない変更をロールバックする。
wtll タスク・ライブラリーの定義をインポートおよびエクスポートする。
その他のコマンド
コマンド 目的
tivoli Tivoli デスクトップを始動する。
vdisp すべての管理対象ノードの状況を検査する。
waddicon Windows Program Manager グループにアイコンを追加する。(Windows のみ)
wbindmsg ローカル・メッセージ・カタログから変換済みストリングを検索し、変数をバインドする。
18 Tivoli Management Framework: リファレンス・マニュアル
コマンド 目的
wbkupdb Tivoli データベースのバックアップと復元を行います。
wcatcher Tivoli Management Framework または Tivoli アプリケーションの新バージョンにアップグレードする前に、Tivoli Management
Framework または Tivoli アプリケーションのカスタム・ダイアログを保存する。
wcd 現行の作業コレクションを変更する。
wchdep 依存関係セットをメソッド・ヘッダーに関連付ける。
wchkdb Tivoli データベースを検証し修復する。
wchknode Tivoli データベースの各部からの特定のディスパッチャー番号への参照を検査し、更新する。
wdel Tivoli データベースからオブジェクトを削除する。
wdtmsg Tivoli デスクトップを開始する際に表示されるメッセージを設定する。
wdepset 実行する必要のあるメソッドの依存関係を指定する。
wgetallinst あるリソース・タイプのすべてのインスタンスを表示する。
wiconv 1 つのファイル内の文字または文字シーケンスを、現在のコード・セットから別のコード・セットに変換する。
winstendpt あるエンドポイント・リソース・タイプの振る舞いをインストールする。
wlcftap Windows クライアント上の Tivoli 認証パッケージ (TAP) のプロパティーを設定する。
wln オブジェクトをコレクションにリンクする。
wlocpath ローカライズされたファイルまたはディレクトリーのパスを戻す。
wls コレクションのメンバー・オブジェクトをリスト表示する。
wlsinst Tivoli リージョンにインストールされている製品とパッチを表示する。
wmerge 3 つのファイル・マージを実行する。
wmrgaef アップグレード後に、カスタム・ダイアログを Tivoli
Management Framework または Tivoli アプリケーションにマージする。
wmv コレクション間でオブジェクトを移動する。
wping ホスト上のオブジェクト・ディスパッチャーへの接続を試みる。
wpwd 現行の作業コレクションを出力する。
wrefresh Tivoli コレクション・ウィンドウを最新表示する。
wrm コレクションからオブジェクトを削除する。
wrmnode Tivoli 環境から管理対象ノードを削除する。
wrunas パスワードを検索し、コマンドを立ち上げる。
wsetpkey パスワードを暗号化し、格納する。
wsupport ユーザーから問題情報を収集して、お客様サポート担当者に送信する。
第 2 章 コンポーネント別コマンド 19
コマンド 目的
wtemp Tivoli 製品で作成される一時ファイルが入るディレクトリーの名前を表示する。
wtrace メソッドをデバッグするための情報を提供する。
20 Tivoli Management Framework: リファレンス・マニュアル
第 3 章 コマンド (アルファベット順)
© Copyright IBM Corp. 2004 21
idlarg
idlinput コマンドで戻るオプション・リストから、個々のオプションを抽出します。
構文idlarg element_offset [option_list]
説明idlarg コマンドは、idlinput コマンドで戻されたオプション・リストから、個々のオプションを抽出します。また、このコマンドを使用して、構成タイプのメンバーを取得することもできます。このコマンドは、成功した場合は終了コード 0 を戻します。エラーが発生した場合は、ゼロ以外の終了コードを戻して終了します。
オプションelement_offset
オプション・リスト内の、抽出対象エレメントのオフセットを指定します。最初のエレメントのオフセットは 1、2 番目のエレメントのオフセットは2、というように指定します。指定する値は正の整数でなくてはなりません。
option_list
平文形式のオプションのリストを指定します。省略すると、コマンドはEOF が検出されるまで標準入力からオプションを読み取ります。
例次の例では、入力オプションと入出力オプションを抽出します。
interface test {exception ex { long code; string reason; };struct s { long l; char c; };s op(in s a, inout s b, out s c) raises (ex);attribute long attr;
};
#! /bin/sh# shell implementation of test::op# Get the input/inout optionsinargs=`idlinput`# $inargs may look like: "{1 ’z’} {2 ’w’}".# Now separate the in and inout options.arg_a=`idlarg 1 $inargs`arg_b=`idlarg 2 $inargs`# We can get to the fields of arg_a as followsarg_a_l=`idlarg 1 $arg_a`arg_a_c=`idlarg 2 $arg_a`# This will set arg_a_l to 1 and arg_a_c to# ’z’ respectively.
参照idlattr, idlcall, idlexception, idlinput, idlresult
22 Tivoli Management Framework: リファレンス・マニュアル
idlattr
インプリメンテーション属性を取得または設定します。
構文idlattr -t [-a] [-v] target_object attribute type_name
idlattr -t [-g] [-v] target_object attribute type_name
idlattr -t [-s] [-v] target_object attribute type_name [value]
説明idlattr コマンドは、インプリメンテーション (オブジェクト) 属性を取得または設定します。 -t オプションは、オプション・リストに属性タイプ名が含まれていることを示します。このオプションは必須です。 -s オプションは設定操作を表し、-gオプションは取得操作を表します。 -s と -g のどちらも指定しないと、デフォルトでは設定操作が実行されます。 attribute オプションには、範囲指定のない属性名を指定します。これは、対応するインプリメンテーション構成内と同じ範囲指定のない属性です。 type_name オプションには、完全に範囲指定された属性タイプを指定します。設定操作を実行する場合は、value オプションに、その属性の設定値とするクリア・テキスト値を指定します。このオプションを省略すると、クリア・テキスト値は標準入力から読み取られます。
オプション-t オプション・リストに属性のタイプ名が含まれていることを示します。この
オプションは必須です。
-a ターゲット・オブジェクトに属性を追加します。
-g 取得操作を実行する場合に指定します。
-s 設定操作を実行する場合に指定します。これはデフォルトです。
-v 冗長モードを指定します。冗長モードでは、例外がメッセージとともに標準出力に出力されます。デフォルトでは、例外はクリア・テキスト形式で標準出力に書き込まれます。
target_object
操作のターゲット・オブジェクトを指定します。ターゲット・オブジェクトはストリング・フォーマットで指定してください。
attribute
範囲指定のない属性名を指定します。この引き数には、対応するインプリメンテーション構成内の範囲指定のない属性名を指定します。
type_name
完全に範囲指定された属性タイプを指定します。
value 属性の設定値とするクリア・テキスト値を指定します。このオプションは、設定操作 (-s) の場合にだけ有効です。
第 3 章 コマンド (アルファベット順) 23
権限属性の値を取得する場合: user、admin、senior、または super。
属性の値を設定する、もしくは属性を追加する場合: senior または super。
例次の例では、インプリメンテーション属性にアクセスします。
interface test {exception ex { long code; string reason; };struct s { long l; char c; };s op(in s a, inout s b, out s c) raises (ex);attribute long attr;
};
次に示すような、インターフェース・テストのインプリメンテーションがあるとします。
implementation class imp_test honors test {struct t { long l; };
attribute s attr1; // refers to test::sattribute t attr2;attribute unsigned long attr3; // define methods here
};
ここで imp_test インプリメンテーション・オブジェクト のインスタンスのオブジェクト参照子ストリングが 2001.1.15 だとします。このインスタンスの物理属性は、次のようにしてアクセスまたは変更できます。
idlattr -t -g 2001.1.15 attr1 test::s// may print {1 ’z’}idlattr -t -s 2001.1.15 attr2 imp_test::t ’{20}’idlattr -t 2001.1.15 attr3 ulong 10
参照idlcall
idlattr
24 Tivoli Management Framework: リファレンス・マニュアル
idlcall
シェル・コマンド行から インターフェース定義言語 (IDL) 操作を呼び出すメソッドを提供します。
構文idlcall [-T transaction_type] [-v] target_object operation_id [options]
説明idlcall コマンドは、シェル・コマンド行から IDL 操作を呼び出します。transaction_type オプションには、最上位トランザクション、サブトランザクション、取り消し可能トランザクション、トランザクションなしのいずれかを指定できます。 target_object オプションには、平文ストリング表現のターゲット・オブジェクト参照子を指定します。 operation_id オプションには、操作名を指定します。操作名は、2 つのコロンで区切った完全範囲指定名 (共通オブジェクト・リクエスト・ブローカー・アーキテクチャー (CORBA) RepositoryId) として指定することも、操作名だけ (IDL 記述と同じ) を指定することもできます。 options オプションには、任意の入力オプションまたは入出力オプションを指定します。これらのオプションは、IDL 記述と同じ順序でリスト表示します。このコマンドは、入出力オプションまたは出力オプションと、結果がある場合は結果を、クリア・テキスト形式で標準出力に書き込みます。 idlcall の呼び出しで例外が発生した場合は、例外が標準出力に書き込まれます。操作に入力オプションまたは入出力オプションが必要な場合にコマンド行で指定されていないと、このコマンドは EOF が検出されるまで標準入力から入力を読み取ります。
オプション-T transaction_type
トランザクション・タイプを指定します。このオプションは、次のいずれかです。
none トランザクションなし
revoke取り消し可能トランザクション
sub サブトランザクション
top 最上位トランザクション
-v 冗長モードを指定します。冗長モードでは、例外がメッセージとともに標準出力に出力されます。デフォルトでは、例外は平文フォーマットで標準出力に書き込まれます。
target_object
ターゲット・オブジェクトの平文ストリング・フォーマットのオブジェクト参照子を指定します。
operation_id
操作名を指定します。このオプションには、2 つのコロンで区切った完全範囲指定名 (CORBA RepositoryId) を指定することも、操作名 (IDL 記述と同じ) を指定することもできます。前者の方がリモート呼び出しの回数が少な
第 3 章 コマンド (アルファベット順) 25
くてすむので効率的ですが、使いやすさでは後者の方が優れています。 IDL
属性では、操作名は、取得操作の場合は _get_、設定操作の場合は _set_のプレフィックスを持つ属性名です。
options 入力オプションまたは入出力オプションを指定します。入力オプションまたは入出力オプションが必要な場合にコマンド行で指定されていないと、idlcall コマンドは EOF が検出されるまで標準入力から入力を読み取ります。
診断idlcall コマンドは、(呼び出しのディスパッチングで、あるいはメソッドのインプリメンテーションの結果) 呼び出しで例外が発生した場合、ゼロ以外の状況コードを戻して終了します。例外が発生しなかった場合は、状況コード 0 を戻して終了します。終了状況により、クリア・テキスト出力の内容を判断できます。
例interface test {
exception ex { long code; string reason; };struct s { long l; char c; };s op(in s a, inout s b, out s c) raises (ex);attribute long attr;
};
インターフェース・テストをサポートするオブジェクトに対するオブジェクト参照子の平文ストリング表現が、2001.1.15 であるとします。その操作は、次のようにして呼び出すことができます。
idlcall -T top 2001.1.15 test::op "{1’z’}" "{2 ’w’}"idlcall -T top 2001.1.15 op <<!EOF{1 ’z’} {2 ’w’}!EOFidlcall 2001.1.15 _get_attridlcall -T top 2001.1.15 _set_attr 20
参照idlattr
idlcall
26 Tivoli Management Framework: リファレンス・マニュアル
idlexception
シェル・メソッドの例外を発生させます。
構文idlexception exception_type scoped_exception_name
idlexception exception_type scoped_exception_name exception_data
説明idlexception コマンドは、例外を発生させる場合に使用します。このスクリプトは、例外が発生するとゼロ以外の終了コードで終了します。正常に終了した場合は終了コード 0 を戻します。Tivoli Extended Interface Definition Language (EIDL) コマンド・メソッドから例外を発生させる場合、idlexception を使用しないでください。信号によってコマンドが終了した場合、Tivoli ランタイムがコマンド・メソッドから自動的に例外を発生させます。 コマンド・メソッドが明示的に例外を発生させることはありません。このため、このマニュアル・ページでは、シェル・メソッドとは EIDL シェル結合だけを指しています。
オプションexception_type
例外タイプを指定します。この引き数には、USER_EXCEPTION またはSYSTEM_EXCEPTION を指定します。
scoped_exception_name
IDL 例外の完全修飾名を指定します。
exception_data
クリア・テキスト形式の例外構造フィールドを指定します。例外が空の場合は、内側の括弧の中には何も指定しません。コマンド行オプションを指定しないでこのメソッドを呼び出すと、標準入力から平文例外が読み取られます。
例interface test {
exception ex { long code; string reason; };struct s { long l; char c; };s op(in s a, inout s b, out s c) raises (ex);attribute long attr;
};
#! /bin/sh# shell implementation of test::op# In doing some work, say we failed, and now# want to raise the test::ex exception.excep=`idlexception ’{USER_EXCEPTION test::ex {"failed" 99}}’`# the exception must be written to stdout.echo $excep# must exit with a nonzero statusexit 1
システム例外を発生させるには、次のように入力します。
第 3 章 コマンド (アルファベット順) 27
# Raise a standard exception (also let idlexception read# from stdin)excp=`idlexception <<!EOF{SYSTEM_EXCEPTION StExcep::BAD_PARAM {999 NO }}!EOF`echo $excpexit 1
参照idlattr, idlcall, idlinput, idlresult
idlexception
28 Tivoli Management Framework: リファレンス・マニュアル
idlinput
シェル・メソッドに対する入力オプションまたは入出力オプションのリストを取得します。
構文idlinput
説明idlinput コマンドは、シェル・メソッドに対する入力オプションまたは入出力オプションのリスト (平文フォーマット) を取得します。オプションの順序は、インターフェース定義言語 (IDL) シグニチャーと同じです。このコマンドを Tivoli Extended
Interface Definition Language (EIDL) コマンド・スタイルのメソッドで使用しないでください。コマンド・メソッドは、オプション・リストまたは標準入力から入力を取得します。このため、このマニュアル・ページでは、シェル・メソッドとは EIDL
シェル結合だけを指しています。
例次の例では、EIDL シェルの入出力オプションにアクセスします。
interface test {exception ex { long code; string reason; };struct s { long l; char c; };s op(in s a, inout s b, out s c) raises (ex);attribute long attr;
};
#! /bin/sh# shell implementation of test::op# Get the input/inout optionsinargs=`idlinput`# $inargs may look like: "{1 ’z’} {2 ’w’}",# the first and the second pair of curly braces# contain the in option (a) and the inout option# (b) respectively. The method can now access each# individual option or their fields using idlarg.# rest of the method goes here.
参照idlattr, idlcall, idlexception, idlresult
第 3 章 コマンド (アルファベット順) 29
idlresult
シェル・メソッドの出力オプションをフォーマット設定します。
構文idlresult [options]
説明idlresult コマンドは、入出力オプション、出力オプション、または戻り結果をフォーマット設定します。入出力オプションと出力オプションは平文フォーマットでなければならず、インターフェース定義言語 (IDL) シグニチャーと同じ順序で渡す必要があります。結果がある場合は、その後に続けて指定します。フォーマット設定する options は、コマンド行オプションとして指定するか、もしくはEOF に達するまで標準入力から読み取ることができます。このコマンドを Tivoli Extended
Interface Definition Language (EIDL) コマンド・スタイルのメソッドで使用しないでください。コマンド・メソッドは出力を標準出力または標準エラーに書き込むので、形式設定は不要です。このため、このマニュアル・ページでは、シェル・メソッドとは EIDL シェル結合だけを指しています。
例次の例では、EIDL シェルの入出力オプションの形式を設定します。
interface test {exception ex { long code; string reason; };struct s { long l; char c; };s op(in s a, inout s b, out s c) raises (ex);attribute long attr;
};
#! /bin/sh# shell implementation of test::op# do some work# return some hard coded values.b="{1 ’a’}"c="{2 ’b’}"retval="{3 ’c’}"# the order of options is inout(b), out(c) and# the return result. We could have also said:## all=`idlresult <<!EOF# $b# $c# $retval# !EOF# `#all=`idlresult $b $c $retval`# The results must be written to stdout.echo $all# A 0 exit code means a successful return from# a EIDL shell method.exit 0
参照idlattr, idlcall, idlexception, idlinput
30 Tivoli Management Framework: リファレンス・マニュアル
lcfd
ログイン・オプション、ポート番号、およびデバッグ情報を含め、構成情報をエンドポイント・サービス (lcfd) に提供します。
構文lcfd [-b library_dir] [-C directory_name] [-d level] [-D option=value] [-e] [-gaddress[+port][:address[+port]...]] [-H] [-i] [-l file_name] [-n endpoint_label] [-pgateway_port] [-P endpoint_port] [-r service_name] [-s] [-S [service_name:]dependency
| dependency_group[,dependency | dependency_group,...]] [-w 0 | 1] [-x protocol]
説明lcfd コマンドは、ログイン・オプション、ポート番号、およびデバッグ情報を含め、構成情報をエンドポイント・サービスに提供します。エンドポイントにインストールされているエンドポイント・サービスを始動することもできます。 UNIX エンドポイントでは、lcfd.sh コマンドを使用して、エンドポイントの始動と停止ができます。 -i オプションは、エンドポイント・サービスを Windows オペレーティング・システム・サービスとしてインストールする際に使用できます。 -r オプションを指定すると、既存のサービスが Windows NT サービス・マネージャーから削除されます。 Internetwork Packet Exchange (IPX) は、 NetWare および Windows オペレーティング・システム上のエンドポイントに接続する場合にのみ使用できます。
-S オプションを winstlcf コマンドの -Lオプションと共に使用することで、エンドポイント・サービスをインストールする際にそのエンドポイント用のサービスの依存関係を作成できるようにします。しかし、-S オプションを -L オプションと共に使用すると、インストールされるサービスの名前が使用されるため、 service_name
オプションが存在しても無視されます。 -S オプションは、エンドポイントがインストールされた後に新しいサービスの依存関係を定義するのにも使用できます。
-S オプションは、-i オプションと共に使用して、新しいエンドポイント・サービスをインストールする際にサービスの依存関係を作成できます。しかしこれにより、1
つは依存関係のない、もう 1 つは依存関係のある、 2 つのエンドポイント・サービスが作成されることになります。さらに、-i オプションを使用すると、作成されたサービスの名前が使用されるため service_name は無視されます。
-S オプションは、既にインストール済みのエンドポイントの依存関係を削除するのにも使用できます。 -S オプションはサブオプションなしでは使用できないため、既存のエンドポイント・サービスからすべての依存関係を削除するには、service_name または空ストリング (″ ″) が必要です。
オプション-b library_dir
エンドポイントに必要な共用ライブラリーが入っている構成ライブラリーのパスを指定します。このオプションは、NetWare には適用されません。
第 3 章 コマンド (アルファベット順) 31
-C directory_name
エンドポイントの現行作業ディレクトリーの名前を指定します。現行作業ディレクトリーには、始動に必要な構成ファイルとメソッド・キャッシュが入っています。
-d level
lcfd.log ファイルに書き込まれるデバッグ・メッセージのレベルを定義します。デフォルト値は 1 です。有効なエントリーは次のとおりです。
0 メッセージのログ記録なし
1 最小のログ記録 (デフォルト)
2 トレースおよび適度な出力
3 詳細情報とタイト・ループ
4 データ
注: レベル 1 がデフォルト値です。レベル 4 のメッセージ・ログを指定すると、大量のメッセージが生成されます。トラブルシューティングについてはレベル 2 または 3 が推奨されます。
-D option=value
以下に示すオプション (1 つまたは複数) を使って、始動時にエンドポイントを再構成します。構成情報は、エンドポイントの Last.cfg ファイルに格納されます。これらのオプションの中には、コマンド行オプションを使用して設定できるオプションもあります。
? このコマンドの使用方法を表示します。
address_notif_interval=seconds
動的ホスト構成プロトコル (DHCP) 環境では、アイドル状態からウェイクアップしてゲートウェイに現行 IP アドレスを通知するための、エンドポイントのタイムアウト・インターバルを指定します。このオプションは、エンドポイント・デーモンを再始動しないで IP
アドレスを変更する可能性のあるエンドポイントのみに使用します。このオプションの推奨値は 300 秒です。このオプションのデフォルト値は 0 で、エンドポイント・デーモンはゲートウェイへの通知をしません。
address_notif_retry_count=count
エンドポイントがゲートウェイへの IP アドレス送信を再試行する回数を指定します。エンドポイントは、ログイン・インターフェース・リスト内の別のゲートウェイへの通信を試行する前に、address_notif_interval で指定した秒間隔で再試行します。デフォルトは 0 です。
allow_proxy_upcalls=true | false
エンドポイントとその割り当てられたゲートウェイ間のすべての通信が、エンドポイント上の構成済みターゲット・ポートを使用するかどうかを指定します。 true に設定すると、エンドポイントとゲートウェイはターゲット・ポートのみを使用して通信します。エンドポイントがプロキシー・アップコールを使用できるようになる前に、エンドポイントはプロキシー対応のゲートウェイへの接続を確
lcfd
32 Tivoli Management Framework: リファレンス・マニュアル
立していなければなりません。 false に設定される場合には、エンドポイントとその割り当てられたゲートウェイは通常の仕方で通信します。このオプションを使用すると、last.cfg ファイル内のallow_proxy_upcalls の値が変更されます。デフォルトは false
です。
bcast_disable=1 | 0ブロードキャスト (1) を使用不可にします。ブロードキャストを使用不可にするする場合、lcs.login_interfaces オプションを使用して優先ゲートウェイを定義する必要があります。エンドポイント・プロトコルに IPX を使用している場合には、拡張ブロードキャストはルーティング情報プロトコル (RIP) プロトコルを使用し、ホップ数が 5 以内でログイン・パケットを送信できます。デフォルトは0 です。
cache_limit=max_size
メソッド・キャッシュの最大サイズを指定します。このオプションで指定した最大サイズに達すると、最も古いメソッドが削除されて、現行メソッドのための領域が作られます。
cache_loc=cache
エンドポイントで作成、保守されるメソッド・キャッシュの名前を指定または変更します。このオプションに完全パス名を指定することにより、メソッド・キャッシュの位置を変更することもできます。
config_path=full_path
Last.cfg 構成ファイルに絶対パスを指定します。このオプションの編集は避けてください。
debug_flags=debug_level
ユーザーが実行メソッドにデバッグ・ツールを付加できるようにします。 このオプションの編集は避けてください。
depot_dir=path
マルチキャスト配布がインストールされるまで、それらが保管されるエンドポイント上のディレクトリーを指定します。 このオプションを使用すると、 last.cfg ファイル内の depot_dir の値が変更されます。 デフォルト・ディレクトリーは、$LCF_DATDIR/depot です。相対パスを指定すると、保管庫ディレクトリーは$LCF_DATDIR 変数に対して相対になります。
detect_address_change=TRUE | FALSE
エンドポイントがネットワーク・インターフェース構成の変更を検出して、必要な場合は修正アクションを実行するかどうかを指定します。このオプションを TRUE に設定すると、エンドポイントはアドレス変更に対してネットワーク・インターフェース構成をモニターします。エンドポイントの listen アドレスに変更があった場合、エンドポイントはゲートウェイへのログ・バックを試みます。(このlisten アドレスは、local_ip_interface オプションを使用して設定します。) このオプションは Windows 2000、Windows XP、およびWindows Server 2003 システムでのみ適用できます。デフォルトはFALSE です。
lcfd
第 3 章 コマンド (アルファベット順) 33
diag_interval=seconds
エンドポイントは、エンドポイントが一連の自己診断機能のテストを実行する間待機する間隔を秒で指定します。これらのテストは、エンドポイントのタスクとメソッドを実行する能力を判断するのに役立ちます。テストには、一時ファイル・スペースと許可、およびキャッシュ・スペースと許可の検査が含まれています。 Windows
オペレーティング・システムでは、テストにはトークンの作成およびプロセス作成の検査も含まれます。テストが完了すると、その結果は lcfd.log ファイルに保管されます。エンドポイントがログインしている場合、結果は現行ゲートウェイに送られます。この値をゼロに設定すると、テストはゲートウェイが要求した場合にのみ実行されます。デフォルトはゼロです。値の許容範囲は 900 秒 (15 分)
~ 86400 秒 (1 日) です。
diag_temp_space=bytes
diag_interval オプションでコントロールされた自己診断機能のテストの実行用の望ましい最小一時スペースをバイトで設定します。この値をゼロに設定すると、テストは実行されません。デフォルトはゼロです。最小値は 1024 です。
fail_if_pref_port_busy=1 | 0
優先エンドポイント・ポートがアクセス不能な場合、エンドポイントを始動しなかどうかを指定します。 1 に設定すると、ポートが使用不可の場合、エンドポイントは始動しません。 0 に設定すると、優先ポートが使用不可な場合、エンドポイントは代替ポートを試行します。 このオプションを使用すると、last.cfg ファイル内のfail_if_pref_port_busy の値が変更されます。デフォルトは 0 です。
filefree_upcalls=TRUE | FALSE
統合アップコールがアップコール・データをディスクに書き込むかどうかを指定します。この設定は、allow_proxy_upcalls が TRUE
に設定されている場合にのみ有効です。この場合、デフォルトではアップコール・データはディスクに書き込まれます。アップコール・データがディスクに書き込まれないようにするには、filefree_upcalls を TRUE に設定すると、すべてのアップコール・データは転送されます。 このオプションを使用すると、 last.cfg ファイル内の filefree_upcalls の値が変更されます。 デフォルトはFALSE です。
gateway_port=port_number
エンドポイント通信をモニターするゲートウェイ・ポートを指定します。デフォルト値は 9494 です。このオプションは、-P オプションを使って設定することもできます。
http_disable=value
エンドポイントでアクセス可能な Web ブラウザーの機能のレベルを指定します。
0 誰でも、ブラウザーを使用してエンドポイントを再構成できます。これがデフォルト値です。
lcfd
34 Tivoli Management Framework: リファレンス・マニュアル
1 誰でもブラウザーを使用して構成データを表示できますが、ブラウザーを使用してエンドポイントを再構成することは誰もできません。
2 誰も、ブラウザーを使用してエンドポイントを表示または再構成することはできません。
3 全利用者が、エンドポイントの表示または再構成には認証(ユーザー ID およびパスワード) を必要とします。
httpd_pw=password
エンドポイント構成ファイルへのセキュリティー上の侵入を防ぐパスワードを指定します。このパスワードは、エンドポイント・マネージャーによって保管されます。このパスワードを変更するには、wep コマンドを使用します。
interp=interpreter_type
エンドポイントのインタープリター・タイプを指定します。このオプションの編集は避けてください。
lcfd_alternate_port=port_number
エンドポイント・サービスがデフォルトのポート (始動時に -P で指定されるポート) に接続できなかった場合に、エンドポイント・サービスがゲートウェイ通信をモニターするために使用する代替ポートを指定します。デフォルト値は 9496 です。
lcfd_autostart=TRUE | FALSE
Windows エンドポイントがエンドポイント・サービスの自動開始を設定するかどうかを指定します。この値を TRUE に設定すると、Windows エンドポイントは、エンドポイントの始動時とエンドポイントのシャットダウン時に 1 回ずつ Windows エンドポイント・サービスを検査します。エンドポイント・サービスが手動 (Manual)
に設定されている場合、エンドポイントはサービスを自動(Automatic) にリセットします。この値を FALSE に設定すると、エンドポイントは Windows エンドポイント・サービスの設定を検査しません。デフォルト値は FALSE です。
lcfd_port=port_number
エンドポイント・サービスがゲートウェイ通信をモニターするポートを指定します。デフォルト値は 9495 です。このオプションは、-P オプションを使って設定することもできます。
lcs.gateway_address=IP_address | IPX_address
エンドポイントの正常なログイン後に、ログイン・ゲートウェイを変更します。ゲートウェイがまだログインしていない場合は、lcs.login_interfaces オプションを使って、エンドポイントがログインするためのゲートウェイを指定してください。 NetWare および Windows 上で IPX を使用しているエンドポイントでは、ホップ数が 5 を超える位置にあるゲートウェイにログインするには、IPX
アドレス (ホスト名でなく) を指定する必要があります。
lcs.login_interfaces=address[+port][:address[+port]]...
エンドポイントのログイン・パケットの送信先ゲートウェイ (1 つまたは複数) の IP アドレスまたはホスト名 (もしくは、 IPX アド
lcfd
第 3 章 コマンド (アルファベット順) 35
レスまたはサーバー名) とポート番号を指定します。このオプションは、エンドポイントが別のサブネット上のゲートウェイにログインする場合や、サブネット上に存在する複数のゲートウェイのうちの特定のゲートウェイにログインする場合に必要です。使用しているゲートウェイとエンドポイントがネットワーク・アドレス変換(NAT) デバイスで分けられている場合、IP アドレスではなく、ホスト名を指定します。複数のアドレスを指定するときは、コロンで区切ってください。 -g オプションを使用してゲートウェイを指定することもできます。
注: このオプションは、エンドポイントが最終的に割り当てられるゲートウェイを指定するものではありません。ゲートウェイの選択と割り当てを決定するのはエンドポイント・マネージャーです。エンドポイントがゲートウェイに正常にログインしている場合、ゲートウェイを変更するには lcs.gateway_addressオプションを使用します。
lcs.machine_name=endpoint_label
wlookup または wep で表示されるエンドポイント・ラベルを指定します。また、-n オプションを使って、エンドポイント・ラベルを指定することもできます。
lcs.machine_unique_id=ID_string
エンドポイントの固有の ID を指定します。 ID_string の値は、Tivoli 環境内で固有のストリングでなくてはなりません。ストリングの長さは 36 文字以下でなくてはなりません。この値は$LCF_DATDIR/lcf.id ファイルに保管されます。
local_ip_interface=IP_address
複数の IP アドレスを持つエンドポイントの場合、指定した IP アドレスで接続できるようにします。 local_ip_address オプションを指定すると、エンドポイントは 0.0.0.0 の代わりに、指定したアドレスにバインドされ、そのインターフェース上でのみ接続が受け入れられます。
log_threshold=integer
識別済みのエンドポイント用のファイルをトレースするための、詳細な書き込みのレベルを指定します。このオプションを使用すると、 last.cfg ファイル内の log_threshold の値が変更されます。指定できる整数値の範囲は、1 ~ 4 で、 1 は詳細レベルが最も低く、4 は最も高いレベルとなります。 デフォルトは 1 です。
logfile=full_path
状況メッセージが記録されるファイルに絶対パスを指定します。デフォルトのログ・ファイルは lcfd.log です。このオプションの編集は避けてください。ログ・ファイルの名前を変更するには -l オプションを使用します。
login_attempts=value
エンドポイントがリスト内の次のゲートウェイに対して試行を開始するまでの、ゲートウェイに対する指定ログイン試行回数。指定ロ
lcfd
36 Tivoli Management Framework: リファレンス・マニュアル
グイン試行とは、最終既知ゲートウェイまたはログイン・インターフェース・リスト内のゲートウェイへのログイン試行です。デフォルトは 3 です。
login_interval=seconds
初期ログインを試行する間隔 (秒数) を指定します。デフォルトは1800 秒 (30 分) です。
login_mode=mobile | non_mobileWindows エンドポイントの場合にのみ、指定されたエンドポイントのユーザーは、 Tivoli モバイル・コンピューティング・コンソールを介して、MDist 2 配布の受信とコントロールを行うことができます。 non_mobile オプションを指定して、エンドポイント上のコンソール機能を使用不可にします。
注: これが機能するためには、まず最初に Tivoli アドミニストレーターは set login_mode -s variable オプションを指定したwep コマンドを使用する必要があります。
wep コマンドで set login_mode -m mobile オプションを指定して、モバイル・サポートを使用可能にすることもできます。
login_timeout=seconds
エンドポイントが指定ログイン試行への応答を待つ時間 (秒) を指定します。指定ログイン試行とは、最終既知ゲートウェイまたはログイン・インターフェース・リスト内のゲートウェイへのログイン試行です。デフォルト値は 300 秒 (5 分) です。
log_queue_size=max_size
ログ・キューに使われるメモリーの最大サイズ (バイト数) を指定します。ログ・キューに送られるのは LogQ メッセージだけです。例外が発生した場合は、キュー全体が画面に表示されます。有効な値は、1024 ~ 102400 です。
log_size=max_size
ログ・ファイルの最大サイズ (バイト数) を指定します。有効な値は、10240 ~ 10240000 です。
log_threshold=debug_level
デバッグ・ログ記録のレベルを指定します。このオプションは、-dオプションを使って設定することもできます。
preload_loc=location
S/390 エンドポイント上の、プリロードされたメソッド・ソースが保管されるロケーションを指定します。 このオプションを使用すると、 last.cfg ファイル内の preload_loc の値が変更されます。
protocol=TCPIP | IPXゲートウェイ通信をモニターするエンドポイント・サービスのプロトコルを指定します。サポートされるプロトコルは次のとおりです。
TCPIP TCP/IP プロトコルを指定します。これはデフォルトです。TCP/IP を使用不可にはできません。
lcfd
第 3 章 コマンド (アルファベット順) 37
IPX Internetwork Packet Exchange (IPX) を指定します。
TCP/IP と IPX の両方のプロトコルを指定するには、オプションをprotocol=TCPIP、IPX として指定します。また、このオプションを
-x オプションを使用して設定することもできます。ゲートウェイの場合には、TCP/IP プロトコルをオフにできないことに注意してください。
recvDataNumAttempts=count
接続をクローズする前に、現行の接続でデータを受信するまたは受信を試行する回数を指定します。デフォルトは 10 です。
recvDataQMaxNum=connections
保留中の接続キューに保持する接続の数を指定します。データを待機中の接続は、保留中の接続と見なされてキューに追加されます。この限度に達すると、保留中の接続がクローズするまでは、さらに接続しようとするすべての試行は拒否されます。デフォルトは 50
です。
recvDataTimeout=seconds
接続を再びキューに追加するまでに、新しい接続がデータの受信を待つ時間 (秒単位) を指定します。保留中の接続キューが満杯だと、接続要求は拒否されます。デフォルトは 2 です。
repair_accts=TRUE | FALSE
エンドポイントが tmersrvd アカウントおよびTivoli_Admin_Privileges グループのインストールと構成をテストして、必要な場合は修理を行うかどうかを指定します。このオプションを TRUE に設定すると、エンドポイントは始動の際に 1 回この検査を行い、lcfd.log ファイルに記述されている修正アクションを実行します。このオプションを FALSE に設定すると、この検査は実行されません。デフォルト値は FALSE です。
repair_tap=TRUE | FALSE
エンドポイントが Tivoli 認証パッケージのインストールと構成をテストして、必要な場合は修理を行うかどうかを指定します。このオプションを TRUE に設定すると、エンドポイントは始動の際に 1 回この検査を行い、lcfd.log ファイルに記述されている修正アクションを実行します。このオプションを FALSE に設定すると、この検査は実行されません。デフォルト値は FALSE です。
run_dir=directory_name
エンドポイント・デーモンの実行先ディレクトリーを指定します。このオプションの編集は避けてください。
run_timeout=seconds
このオプションは使用すべきではありません。正常なログイン後、udp_interval オプションを使って、通信タイムアウトが発生するまでの待ち時間を指定します (秒単位)。
start_delayエンドポイントとゲートウェイが同じマシン上に共存している場合に、エンドポイント・サービスの始動を遅らせます。このような共
lcfd
38 Tivoli Management Framework: リファレンス・マニュアル
存状態のときに、このオプションを使用しなかった場合は、エンドポイント・ログインに長時間を要するか、またはまったくログインできないこともあります。
start_timeout=seconds
ログイン中に通信タイムアウトが発生するまでの待ち時間 (秒数)
を指定します。デフォルト値は 120 です。
udp_attempts=number
ブロードキャスト・ログイン試行の際、エンドポイントがゲートウェイへの接続を試行する回数を指定します。デフォルト値は 6 です。ログイン試行数がこの回数を超えると、エンドポイントはlogin_interval に指定された秒数だけ待って、ログイン・インターフェース・リストに指定されたゲートウェイへのログインを試行してログイン・サイクルを再開します。
udp_interval=seconds
エンドポイントが別のブロードキャスト・ログインを試行するまでの、ゲートウェイからの応答を待つ時間 (秒) を指定します。デフォルト値は 300 秒 (5 分) です。
upcall_retry_count=count
アップコールが失敗した後、再試行する回数を指定します。 このオプションを使用すると、last.cfg ファイル内の upcall_retry_countの値が変更されます。デフォルトは 0 です。
web_post_interval=seconds
エンドポイントが、イベントおよび状態変更情報を Web サーバーに通知する間隔 (秒) を指定します。情報が送られるのは、この間隔内でイベントまたは状態変更が生じた場合のみです。最小値は300 秒 (5 分) です。最大値は 86,400 秒 (1 日) です。デフォルト値はゼロです。このオプションをゼロに設定すると、エンドポイント Web 通知は使用不可になります。
web_post_url=URL
エンドポイントがイベントおよび状態変更情報を通知する宛先 URL
を指定します。以下の URL の構文例を参考にして入力してください。
http://web_server_name:port/relative_path_to_cgi_script/script_name
注: デフォルト・ポート 80 を使用している場合は、ポート番号を指定する必要はありません。
wol_enable= 0 | 1 (OS/2 および Windows オペレーティング・システムのみ) ボックス上のネットワーク・インターフェース・カード (NIC) が
Wake on LAN をサポートするかどうかを指定します。このオプションを使用すると、 last.cfg ファイル内の wol_enable の値が変更されます。 デフォルトは 0 です。
-g address[+port][:address [+port]]...
エンドポイントで TCP/IP を使用している場合は、このオプションに、エンドポイントがログイン・パケットを送信する宛先ゲートウェイ (1 つまたは複数) の IP アドレスまたはホスト名、およびポート番号 (オプションで)
lcfd
第 3 章 コマンド (アルファベット順) 39
を指定します。エンドポイントで Internetwork Packet Exchange/Sequenced
Packet Exchange (IPX/SPX) を使用している場合は、このオプションに、エンドポイントがログイン・パケットを送信する宛先ゲートウェイ (1 つまたは複数) の IPX アドレスまたはサーバー名とポート番号を指定します。デフォルトのポート番号は 9495 です。このオプションは、エンドポイントが別のサブネット上のゲートウェイにログインする場合や、サブネット上に存在する複数のゲートウェイのうちの特定のゲートウェイにログインする場合に必要です。
注:
v 使用しているゲートウェイとエンドポイントがネットワーク・アドレス変換 (NAT) デバイスで分けられている場合、IP アドレスではなく、ホスト名を指定します。複数のアドレスを指定するときは、コロンで区切ってください。
v NetWare および Windows 上のエンドポイントでは、ホップ数が 5
を超える位置にあるゲートウェイにログインするには、IPX アドレス(サーバー名でなく) を指定する必要があります。
-H OS/2 の場合のみ、OS/2 システム上でエンドポイントを切断モードで開始することができます。このオプションは、ユーザーが誤ってエンドポイント・サービスを強制終了しないように、lcfd.exe をタスク・リストから除去します。このオプションは、config.sys ファイル内にあるその他の検出方法(PSPM2、pstat、または KILLFEATUREENABLE=YES など) からプロセスを隠すものではありません。
-i 指定されたエンドポイントに、エンドポイント・ソフトウェアを Windows
サービスとしてインストールします。このオプションは、Windows オペレーティング・システムでのみ有効です。
-l file_name
状況メッセージとエラー・メッセージの書き込み先ログ・ファイルの名前を指定します。デフォルトのファイル名は lcfd.log です。
-n endpoint_label
wlookup または wep で表示されるエンドポイント・ラベルを指定します。 TCP/IP を介して通信している Netware、Windows、および OS/2 のエンドポイントでは、マシンのホスト名がデフォルトとして使用されます。IPX を使用している NetWare エンドポイントでは、サーバー名がデフォルトとして使用されます。IPX を使用している Windows エンドポイントでは、コンピューター名がデフォルトとして使用されます。
-p gateway_port
エンドポイント通信をモニターするゲートウェイ・ポート番号を指定します。
-P endpoint_port
エンドポイントがゲートウェイ通信をモニターするポート番号を設定します。
-r service_name
指定されたエンドポイント・サービスを停止します。このオプションは、Windows オペレーティング・システム でのみ有効です。
lcfd
40 Tivoli Management Framework: リファレンス・マニュアル
-s エンドポイントをコンソール・アプリケーションとして始動し、すべてのメッセージを画面およびエンドポイントのログ・ファイルに出力します。OS/2 および NetWare エンドポイントでは、このオプションは無視されます。
-S [service_name:]dependency | dependency_group
エンドポイント・サービスがインストールされる際に、サービスの依存関係が作成されることを指定します。サービスの依存関係を指定するには、以下のオプションを使用します。
service_name
エンドポイント・サービスの名前です。
dependency
エンドポイント・サービスが依存することになるサービスの名前です。
dependency_group
エンドポイント・サービスが依存することになるサービスのグループの名前です。
このオプションは、winstlcf コマンドの -L オプションと併用できます。
-w 0 | 1エンドポイントの Wake on LAN 機能を使用可能にします (1)。 Wake on
LAN が使用可能になったエンドポイントが通常ログインを実行すると、エンドポイントはゲートウェイに、ウェイクアップ・パケットを生成するために必要な情報を送信します。デフォルトでは、Wake on LAN は使用不可(0) です。Wake on LAN の詳細については、「Tivoli Management
Framework デプロイメントの計画ガイド」を参照してください。
-x TCPIP | IPXエンドポイントで使用するプロトコルを指定します。サポートされるプロトコルは次のとおりです。
TCPIP TCP/IP プロトコルを指定します。これはデフォルトです。-x オプションを指定しない場合、エンドポイントはTCP/IP を使用します。
IPX Internetwork Packet Exchange (IPX) を指定します。
TCP/IP と IPX の両方のプロトコルを指定するには、オプションを-x=TCPIP、IPX として指定します。また、このオプションを protocol オプションを使用して設定することもできます。ゲートウェイの場合には、TCP/IP プロトコルをオフにできないことに注意してください。
権限Tivoli の許可の役割は不要です。
例1. 次の例では、コマンドの使用法情報が戻されます。
lcfd -s -D?
lcfd
第 3 章 コマンド (アルファベット順) 41
2. 次に示す例は、last.cfg ファイル内の構成情報を使ってローカル・エンドポイントを始動します。
lcfd
3. 次に示す例は、エンドポイントをローカル・マシン上のサービスとして始動し、デバッグ・レベルを 3 に設定します。すべてのメッセージがエンドポイントのlcfd.log ファイルに記録されます。
lcfd -i -d 3
4. 次に示す例は、Windows ローカル・エンドポイントを再始動します。エンドポイントは、ポート 27246 上の別のサブネットのゲートウェイ (ホスト名 zeus)
にログインします。 -p オプションが指定されているので、エンドポイントとゲートウェイの両方がポート 27246 を使用します。
lcfd -p 27246 -g zeus+9494
5. 次の例では、ローカル・エンドポイントをサービスとして始動し、SPX/IPX をプロトコルとして使用することを指定しています。またエンドポイントが、指定した IPX アドレスを使用してゲートウェイにログインし、指定したポートを listen
することも指定しています。
lcfd -x IPX -g 4132AF12.000000000001+41204 -i
6. 次の例は、Windows オペレーティング・システム上のエンドポイント・サービスを開始し、それが log_threshold オプションを更新してレベル 3 をデバッグすることを指定します。ここでは、オプションの前にはダッシュではなく、スラッシュが付くことに注意してください。
net start lcfd /d3
参照lcfd.sh
lcfd
42 Tivoli Management Framework: リファレンス・マニュアル
lcfd.sh
UNIX エンドポイント上の lcfd エンドポイント・デーモンを開始または停止します。
構文lcfd.sh start [lcfd_options]
lcfd.sh stop [lcfd_options]
説明lcfd.sh コマンドは、 lcfd コマンドのラッパーです。lcfd.sh コマンドには、UNIX
エンドポイントに必要なプラットフォーム固有の共用ライブラリーへのリンクが含まれています。 lcfd.sh コマンドは、lcfd コマンドと同じオプションをとり、$LCF_DATDIR ディレクトリーに常駐します。これらのコマンドは、lcfd コマンドの呼び出し時に lcfd に渡されます。コマンド・オプションの詳細については、lcfdコマンドを参照してください。
lcfd.sh コマンドは UNIX エンドポイントでローカルに実行され、$LCF_DATDIR
ディレクトリーから呼び出されます。
オプションstart lcfd エンドポイント・デーモンを始動します。
stop lcfd エンドポイント・デーモンを停止します。
lcfd_options
コマンド・オプションの詳細については、lcfd コマンドを参照してください。
権限必要な Tivoli 権限はありません。
例次の例では、UNIX エンドポイントでローカルに実行され、そのマシン上のエンドポイント・デーモンが停止されます。
lcfd.sh stop
参照lcfd
第 3 章 コマンド (アルファベット順) 43
logls
トランザクション・ログ・ファイルの読み取り可能バージョンを作成します。
構文logls [-D] [-o] [-f] [-l] [-s] [-k directory] [-m max_dump_data] log_name...
説明logls コマンドは、指定されたトランザクション・ログ・ファイルの読み取り可能バージョンを作成します。このコマンドは主に、トランザクション・マネージャーのデバッグのための診断ツールです。問題が起こった場合にデバッグに役立つこのコマンドを実行するようサポート・プロバイダーから要求される場合があります。
注: トランザクションの変更は、問題判別のルーチン・メソッドとして使用しないでください。トランザクション・データの変更は、Tivoli リージョンのオペレーションに深刻かつ取り返しができない影響を及ぼす可能性があります。Tivoli
リージョンで起こっている問題を詳しく知るにはトランザクション情報を利用し、問題の修正には他のメソッドを使用してください。
オブジェクト・ディスパッチャー・サービス用のトランザクション・ログは、odb.log トランザクション・ログです。このファイルはデータベース・ディレクトリーにあります。
オブジェクト・ディスパッチャー・サービスの実行中に、デーモンのシャットダウンやデータベースの同期化の必要が生じることがあります。現在トランザクションを実行中のため、ログ・ファイルは不完全である可能性があります。
トランザクション・ログ・ファイルをフラッシュするには、db_sync オプションもしくは odadmin コマンドを使用します。
オプション-D ログ・レコード内のデータを出力します。
-f 「順方向の」ログ・レコードだけを出力します。
-k directory
各ログ・ファイル名の前に付けるディレクトリーを指定します。
-l ログ・ヘッダーを出力します。
-m max_dump_data
ダンプ対象データの最大量を指定します。このオプションを使用するときは、-D オプションも指定してください。 max_dump_data オプションを指定しないと、最大量はデフォルト値の 64 バイトになります。
-o 「古いページの」ログ・レコードだけを出力します。
-s ログ・ヘッダーだけを出力します。「順方向の」ログ・レコードも「古いページの」ログ・レコードも出力しません。
44 Tivoli Management Framework: リファレンス・マニュアル
log_name...
処理対象ログ・ファイルの名前を指定します。複数のログ・ファイルを指定できます。
権限表示するログ・ファイルの読み取り許可が必要です。
例次の例では、指定したトランザクション・ログ・ファイルの読み取り可能バージョンを作成します。
logls -k /var/spool/Tivoli/myhost.db odb.log
Database update records:old page 0 8248insert "0.0.0"insert <0.0.0¥x00.attr._bootcount¥x00>{0:0,0:0,1:0} replace <0.0.0¥x00.attr._ids¥x00>Database transaction state transitions:prepare transaction {0:0,0:0,1:0}complete transaction {0:0,0:0,1:0}abort transaction {202020:1,202020:1,1:75}Database event and undo callbacks registered:{2020201,202020:1,1:61} undo [1:0:286748945] 2000.1.3 undo_callback{2020201,202020:1,1:61} Event-prepare 2000.1.3 prepare_callback{2020201,202020:1,1:61} Event-complete 2000.1.3 commit_callback{2020201,202020:1,1:61} Event-abort 2000.1.3 abort_callback
参照tmcmd, tmstat
logls
第 3 章 コマンド (アルファベット順) 45
objcall
シェルからオブジェクト呼び出しを実行します。
構文objcall [-a] [-b] [-c group:role:...] [-e] [-F file_descriptor] [-k length] [-n] [-p port]
[-s] [-T transaction_type] object_id method [argument...]
説明objcall コマンドは、指定オブジェクトに対して、0 個および 1 以上のオプションを指定されたメソッドの実行を要求します。メソッドの標準出力と標準エラーは、objcall コマンドの標準出力と標準エラーに送られます。このコマンドは、メソッドの終了コードを戻して終了します。このコマンドは、インターフェース定義言語(IDL) 以外のメソッドにだけ使用します。
オプション-a オブジェクト呼び出しを非同期に実行します。
-b objcall コマンド標準入力をメソッド標準入力に渡します。このオプションを指定しないと、メソッドは空の標準入力を取得します。
-c group:role:...
指定グループおよび指定された役割を使ってオブジェクト呼び出しを実行します。呼び出し元が指定できるのは、そのユーザーが持っている役割だけです。省略すると、メソッドは呼び出し元のすべての役割を使用して実行されます。
-e objcall コマンドの環境をメソッドの環境として渡します。このオプションを指定しないと、メソッドにはデフォルトのミニ環境が渡されます。
-F file_descriptor
状況情報の書き込み先のファイル記述子番号を指定します。
-k length
標準入力から、length オプションで指定したバイト数をキー値として読み取ります。省略すると、キーは使用されません。
-n メソッドの始動と objcall コマンドの終了を、メソッドが結果を戻すのを待たずに非同期に行います。
-p port
ローカル・オブジェクト・ディスパッチャーのポート番号を指定します。
-s メソッドとの間で入出力をやりとりするための Inter-Object Messaging
(IOM) キーを作成します。このオプションは、これらのキーを呼び出し先メソッドに入力として渡す必要がある場合にだけ指定してください。
-T transaction_type
トランザクション・タイプを指定します。このオプションは、次のいずれかです。
none トランザクションなし
46 Tivoli Management Framework: リファレンス・マニュアル
revoke取り消し可能トランザクション
sub サブトランザクション
top 最上位トランザクション
argument...
メソッドの引き数を 1 つまたは複数指定します。このオプションを指定しないと、メソッドに引き数は渡されません。
method 実行するメソッドを指定します。
object_id
メソッドの実行元オブジェクトのオブジェクト ID を指定します。
注: -b オプションと -k オプションの両方を指定すると、キー (-k) が最初に読み取られます。
権限コマンドそのものの実行には役割は不要ですが、コマンドにオプションとして指定するメソッドに必要な役割を持っていなければなりません。
例1. 次の例は、Tivoli サーバー管理リージョン・サーバーが戻す基本オブジェクトに対して、 get_oserv メソッドを呼び出します。
objcall 0.0.0 get_oserv 2248904349.1.2
2. すべての Tivoli リージョンには、固有の 10 桁の数値があります。これは、どのオブジェクトにもある 3 つの部分から成る OID の最初の部分です。例 1 で照会される Tivoli リージョンには、固有の ID 番号 2248904349 があります。その 10 桁の数値をコマンドに入力する代わりに、変数 $TMR で置換することができます (Tivoli 環境を初期化した後)。
次の例の OID の中央の部分では、この場合は 1 が、 OID の 3 番目の部分 (2)
によって参照されるオブジェクトが含まれる管理対象ノードを指定します。作成される最初の管理対象ノードは、Tivoli サーバーで、これは必ず 1 の中央の数字を受け取ります。 OID の 3 番目の部分は、管理対象ノードに属するオブジェクトのタイプを指定します。この場合は、2 が oserv プロセス自体の数値指定です。
次の例は、$TMR.1.2 として参照されるオブジェクトに対して、boot_methodメソッドを、引き数 list を指定して呼び出します。この objcall は oserv オブジェクトに、 Tivoli サーバー (ディスパッチャー 1) のブート時に自動的に始動されるすべてのメソッドをリストするように要求します。
objcall $TMR.1.2 boot_method list
SchedulerEndpointManagerHTTPdActiveDesktopList
3. 次のコマンドは、固有の ID 番号 2248904349 をもつリージョン内の Tivoli サーバー (OID の 1 の部分) 上で、oserv プロセス (OID の 2 の部分) に対してquery メソッドを呼び出します。 query メソッドに提供される引き数は
objcall
第 3 章 コマンド (アルファベット順) 47
install_dir で、これによって、パス名をインストール・ディレクトリーに戻すデータベース呼び出しが実行されます。この場合、Tivoli サーバーは UNIX オペレーティング・システムを実行しています。
objcall 2248904349.1.2 query install_dir/usr/local/Tivoli/bin
このコマンドを、固有の 10 桁の数値に置換する $TMR 変数を使用して呼び出し、作成された 5 番目の管理対象ノード (OID の 5 の部分) に対して照会を実行するには、次のコマンドを入力します。この例では、照会される管理対象ノードは、Windows オペレーティング・システムを実行しているマシンです。
objcall $TMR.5.2 query install_dir
C:¥tivoli¥program files¥bin
参照idlcall
objcall
48 Tivoli Management Framework: リファレンス・マニュアル
odadmin
オブジェクト・ディスパッチャーを管理します。
構文odadmin [option [suboption]]
説明odadmin コマンドは、オブジェクト・ディスパッチャーの多数の実行時環境設定および管理操作に対するコマンド行インターフェースを提供します。サポートされる機能のリストには、次の機能が含まれています。
v クライアント・インストールの許可または禁止
v オブジェクト・データベースの同期
v オブジェクト・ディスパッチャー環境の取得または設定
v オブジェクト・ディスパッチャーに関する情報のリスト
v オブジェクト・ディスパッチャーのリサイクル
v リモート Tivoli リージョン操作の実行
v 暗号化レベルおよびパスワードの設定
v ネットワーク・セキュリティーの設定
v ダウン・ホスト検査オプションの設定
v オブジェクト・ディスパッチャーの始動とシャットダウン
v プラットフォームおよびアプリケーションのライセンス・キーの追加または変更
odadmin コマンドを使って Tivoli リージョンの下位レベル構成を変更する前に、すべてのオブジェクト・データベースのバックアップをとることをお勧めします。odadmin コマンドで実行できる操作の中には、他の方法 (Tivoli デスクトップやodadmin コマンド以外の Tivoli コマンド) を使用した方がよいものもあります。odadmin コマンドの含意が不明な場合は、 odadmin 操作を実行する前にサポート提供者にご相談ください。
オプションallow_client_install TRUE | FALSE
ローカル・リージョンに対するオブジェクト・ディスパッチャーの追加を許可または禁止するインストール・フラグを設定します。このオプションの実行には、役割 super または senior が必要です。
allow_dynamic_ipaddr TRUE | FALSEローカル Tivoli リージョン内の動的インターネット・プロトコル (IP) アドレス割り当てサポート (動的ホスト構成プロトコル [DHCP]) を使用可能または使用不可にします。デフォルト値は FALSE です。
db_sync [object_dispatcher... | clients | all]オブジェクト・データベースの状態をディスクにフラッシュします。ディスクにフラッシュする対象として、特定のオブジェクト・データベース(object_dispatcher)、管理対象ノードのすべてのオブジェクト・データベース
第 3 章 コマンド (アルファベット順) 49
(clients)、またはすべてのオブジェクト・データベース (all) を指定できます。 super または senior の役割が必要です。
environ特定のオブジェクト・ディスパッチャーのメソッド環境を取得または設定します。メソッド環境とは、メソッドの実行時にメソッドのプロセス内部で設定される環境変数です。このオプションを使用したときに表示されるユーザー指定の変数のほかに、デフォルトの環境変数が設定されます。 super または senior の役割が必要です。
environ オプションには、以下のサブオプションを使用できます。
get [object_dispatcher... | clients | all]1 つまたは複数の特定のオブジェクト・ディスパッチャー(object...)、管理対象ノードのすべてのオブジェクト・ディスパッチャー (clients)、またはすべてのオブジェクト・ディスパッチャー(all) のメソッド環境を取得します。
set [object_dispatcher... | clients | all]1 つまたは複数の特定のオブジェクト・ディスパッチャー(object...)、管理対象ノードのすべてのオブジェクト・ディスパッチャー (clients)、またはすべてのオブジェクト・ディスパッチャー(all) のメソッド環境を設定します。メソッド環境は標準入力から読み取られます。
get_allow_NATset_allow_NAT オプションの値を表示します。このオプションは、ネットワーク・アドレス変換 (NAT) サポートを使用可能にしたり、使用不可にしたりします。
get_port_rangeInter-Object Messaging (IOM) チャネル通信ポートおよび管理対象ノード間の Tivoli 通信のためのポート範囲設定を取得します。ポート範囲を設定するには、set_port_range オプションを使用します。
get_rpc_max_threadsディスパッチャーが同時に処理するリモート・プロシージャー・コール・スレッドの最大数を取り出します。 set_rpc_max_threads オプションによってこの数をリセットすることができます。
help [suboption]
オプションを指定せずに呼び出すと、コマンドで使用できるオプションについての最上位ヘルプが表示されます。オプションを指定して呼び出すと、指定したオプションのヘルプが表示されます。指定したオプションにヘルプがない場合は、最上位ヘルプ・メニューが表示されます。このオプションは、特定の役割を必要としません。
odinfo [object_dispatcher... | clients | all]インストールにおける特定のオブジェクト・ディスパッチャー (object...) 、管理対象ノードのすべてのオブジェクト・ディスパッチャー (clients)、またはすべてのオブジェクト・ディスパッチャー (all) の情報を提供します。odinfo は、オプションを指定せずに odadmin コマンドを呼び出した場合のデフォルト・オプションです。オブジェクト・ディスパッチャー番号、clients オプション、all オプションのいずれも指定せずに odinfo オプシ
odadmin
50 Tivoli Management Framework: リファレンス・マニュアル
ョンを使用すると、ローカル・オブジェクト・ディスパッチャーについての情報が戻ります。このオプションの実行には、役割 super、senior、admin、または user が必要です。
odinfo オプションを指定すると、以下のオブジェクト・ディスパッチャー情報が表示されます。
著作権情報IBM 著作権情報を示します。
Region (リージョン)Tivoli リージョン番号を示します。これは、ライセンス・キー内にエンコードされた固有の番号です。
Dispatcher (ディスパッチャー)Tivoli リージョン内のサーバーまたはディスパッチャーの番号を示します。ディスパッチャー番号 1 は、Tivoli サーバーを示します。Tivoli ディスパッチャー番号は、インストール順に基づいています。
Interpreter Type (インタープリター・タイプ)マシンのインタープリター・タイプを示します。
Database directory (データベース・ディレクトリー)ローカル Tivoli オブジェクト・データベースのパスを示します。
Install directory (インストール・ディレクトリー)オブジェクト・ディスパッチャーのインストール・ディレクトリーのパス、およびバイナリーのロケーションを示します。
Inter-dispatcher encryption level (ディスパッチャー間暗号化レベル)管理対象ノード間でメッセージを渡すときに使用する暗号化タイプを示します。
Remote client login allowed (許可されたリモート・クライアント・ログイン) Tivoli デスクトップ for Windows を使用して、リモート・デスクト
ップ接続を確立できるようにします。
Force socket bind to a single address (ソケットを強制的に単一アドレスにバインドする)
ソケットを強制的に単一アドレスにバインドするかどうかを示します。たとえば、このステートメントが FALSE で、複数のネットワーク・インターフェース・カード (NIC) を持っている場合は、 oserv
がポート 94 を開いて、すべての IP アドレスに、それぞれの NIC
に対して 1 つずつバインドします。 (TCP/IP は oserv に、すべての IP アドレスのポート 94 を listen させます。) このステートメントが TRUE の場合には、oserv が 1 つの IP アドレス上のポート94 だけにバインドすることを示します。
Perform local hostname lookup for IOM connections (IOM 接続に対しローカル・ホスト名検索を実施する)
Inter-ORB Messaging (IOM) が、接続を IOM 要求のイニシエーターに戻すために渡された IP アドレスを使用することを示します。IP アドレスを検索するために渡されたホスト名は使用しません。
odadmin
第 3 章 コマンド (アルファベット順) 51
Use Single Port BDT (単一ポート BDT の使用)このノードについて、単一ポート大量データ転送プログラム (BDT)
が使用可能 (TRUE) または使用不可 (FALSE) であることを示します。
Use communication channel check (通信チャネル・チェックの使用)このノードについて、通信チャネル・チェックが使用可能 (TRUE)
か、もしくは使用不可 (FALSE) かを示します。
Communication check timeout (通信チェックのタイムアウト)アイドル状態の IPC チャネルが終了したかどうかを判別するためにプロセスが ping メッセージを送信するまでの秒数を示します。
Communication check response timeout (通信チェックの応答タイムアウト) Tivoli が IPC チャネルが終了したと判断するまでの秒数を示しま
す。
Oserv connection validation timeout (oserv 接続検証のタイムアウト)接続をリジェクトするまでの、オブジェクト・ディスパッチャーが着信接続の検証を行う秒数を示します。
Port range (ポート範囲)Tivoli 環境が使用を許可されるポートの範囲を示します。
Single Port BDT service port number (単一ポート BDT サービス・ポート番号)
このノード上で BDT サービスが使用するポートを示します。
Network Security (ネットワーク・セキュリティー)管理対象ノードのネットワーク・セキュリティー・レベルを示します。 none は、それが SSL 対応であり FORCE_SSL 管理対象ノードと通信している場合を除いて、 Secure Sockets Layer (SSL) が管理対象ノードによって使用されないことを指定します。SSL は、他の SSL 管理対象ノードとの通信時に、管理対象ノードが SSL を使用することを指定します。 FORCE_SSL は、管理対象ノードがSSL を使用してのみ通信することを指定します。
SSL Ciphers (SSL 暗号)SSL ネットワーク・セキュリティーで使用される暗号リスト (設定順) を示します。キーワード default は、デフォルトの Tivoli 暗号リスト 05040A030609 を示します。
ALLOW_NATネットワーク・アドレス変換 (NAT) サポートが使用可能 (TRUE) または使用不可 (FALSE) であることを示します。
注: UNIX オペレーティング・システムでは、odadmin コマンドは、Tivoli
操作に有効なライブラリー・パスも表示します。 Windows オペレーティング・システムでは、ダイナミック・リンク・ライブラリー (DLL)
が、別のライブラリー・ディレクトリーではなく、binary ディレクトリーに保管されます。
Tivoli サーバーの場合は、以下の情報も戻されます。
odadmin
52 Tivoli Management Framework: リファレンス・マニュアル
State flags in use (使用中の状態フラグ)oserv ping キャッシュが参照されるかどうかを示します。管理対象ノード間の通信に関する詳細は、「Tivoli Management Framework
保守およびトラブルシューティング・ガイド」を参照してください。
State checking in use (使用中の情報検査)ホスト状態情報が、ポーリングによって最新情報に保たれる(TRUE) か、暗黙的に収集される (FALSE) かを示します。
State checking every x seconds (x 秒ごとの状態検査)状態検査が実行される間隔を示します。
Dynamic IP addressing allowed (許可された動的 IP アドレス)管理対象ノード上の動的ホスト構成プロトコル (DHCP) サポートが使用可能かどうかを示します。
Transaction manager will retry messages x times (トランザクション・マネージャーはメッセージを x 回再試行する)
他の oserv との通信の内部 ORB 再試行数を示します。
odlist [suboption]
インストール環境内のディスパッチャーに関する情報をリスト表示または編集します。このオプションの実行には、役割 super または senior が必要です。 odlist 情報がキャッシュに入れられることと、Flags 列出力が、管理対象ノードの最新の接続または通信の状態を正確に反映していない場合があることに注意してください。状態の新規ポーリングを強制するには、当該の管理対象ノードに実際に接触するコマンド (wping コマンドなど) を呼び出し、odlist オプションを指定した odadmin コマンドをもう一度呼び出してください。サブオプションを指定せずに odlist オプションを使用すると、現在接続されている各オブジェクト・ディスパッチャーについて、縦欄の形式で以下の情報が戻されます。
Disp (ディスパッチャー)オブジェクト・ディスパッチャー番号。
Flags xyz (フラグ xyz)3 つのフラグがあります。最初のフラグ (x) が c の場合は、そのオブジェクト・ディスパッチャーが、ディスプレイに表示されたリモート・ディスパッチャーに接続されていることを示します。
最初のフラグが ? の場合は、キャッシュに入っている状態情報が古いため、リモート・ディスパッチャーへの接続の状態が不明であることを示します。 この状態が更新されるのは、特定の状況が発生した場合だけです (詳細は、「Tivoli Management Framework 保守およびトラブルシューティング・ガイド」を参照してください。)
最初のフラグが - の場合は、リモート・ディスパッチャーがダウンしていることを示します。
2 番目のフラグ (y) は常に t です。これは、そのオブジェクト・ディスパッチャーが承認されていることを示します。
3 番目のフラグ (z) は常に - です。これは、ディスパッチャーが特別なディスパッチャーではないことを示します。
odadmin
第 3 章 コマンド (アルファベット順) 53
Hostname(s) (ホスト名)オブジェクト・ディスパッチャーの位置するクライアントのホスト名と別名。
IPaddr (IP アドレス)オブジェクト・ディスパッチャーの位置するクライアントの IP アドレス。
Port (ポート)オブジェクト・ディスパッチャーの listen ポート。
Region (リージョン)オブジェクト・ディスパッチャーの位置するインストール環境を識別する番号。
odlist オプションには、以下のサブオプションを使用できます。
list_odリージョンのメンバーをリスト表示します。
add_ip_alias object_dispatcher {IP_address | host_name}
オブジェクト・ディスパッチャーの IP アドレス別名を追加します。新規の IP アドレスおよびオブジェクト・ディスパッチャー・ポート番号が別のオブジェクト・ディスパッチャーの IP アドレスおよびポート番号と一致していると、要求は失敗します。このサブオプションは、Tivoli サーバーから呼び出す必要があります。
delete_ip_alias object_dispatcher IP_address
オブジェクト・ディスパッチャーの IP アドレス別名を削除します。このサブオプションは、Tivoli サーバーから呼び出す必要があります。
add_hostname_alias object_dispatcher IP_address host_name
オブジェクト・ディスパッチャーに関連付けられた IP アドレスにホスト名別名を追加します。このサブオプションは、Tivoli サーバーから呼び出す必要があります。
delete_hostname_alias object_dispatcher IP_address host_name
オブジェクト・ディスパッチャーに関連付けられた IP アドレスのホスト名別名を削除します。このサブオプションは、Tivoli サーバーから呼び出す必要があります。
change_ip object_dispatcher IP_address [TRUE | FALSE]
オブジェクト・ディスパッチャーに関連付けられた 1 次 IP アドレスを変更します。新規の IP アドレスおよびオブジェクト・ディスパッチャー・ポート番号が別のオブジェクト・ディスパッチャーのIP アドレスおよびポート番号と一致していると、要求は失敗します。このサブオプションは、Tivoli サーバーから呼び出す必要があります。
rm_od object_dispatcher
インストール環境からオブジェクト・ディスパッチャーを削除します。削除する前に、指定したオブジェクト・ディスパッチャーをシャットダウンしておく必要があります。そのディスパッチャーが所有していたオブジェクトのオブジェクト ID リストが表示されま
odadmin
54 Tivoli Management Framework: リファレンス・マニュアル
す。これらのオブジェクトは削除されますが、オブジェクトへの参照は残ります。このサブオプションは、Tivoli サーバーから呼び出す必要があります。
rm_od オプションは、クライアントのインストールが失敗して回復できない場合にのみ、サポート提供者の指示に従って実行してください。クライアントの削除には、通常は wrmnode コマンドを使用します。
objects object_dispatcher
オブジェクト・ディスパッチャーが所有しているオブジェクトのオブジェクト ID リストを表示します。
reexec [object_dispatcher... | clients | all]ローカル・オブジェクト・ディスパッチャーをリサイクル (停止して再始動)
します。指定したオブジェクト・ディスパッチャー (object_dispatcher)、管理対象ノード上のすべてのオブジェクト・ディスパッチャー (clients)、またはすべてのオブジェクト・ディスパッチャー (all) をリサイクルできます。Tivoli サーバー・オブジェクト・ディスパッチャーは、別のシステムからはリサイクルできません。 super または senior の役割が必要です。
region [suboption]
リモート Tivoli リージョンの操作を指定します。このオプションの実行には、役割 super または senior が必要です。以下のサブオプションは、Tivoli デスクトップやリージョン間コマンドでは処理できない低レベルの問題を解決する場合にのみ、サポート提供者の指示に従って実行してください。
add_alias region IP_address [host_name...]
リモート Tivoli サーバーのホスト名または IP 別名を追加します。
add_group_map region remote_group local_group
Tivoli リージョン 間のオブジェクト・グループ・マップを追加します。
add_group_id_map region remote_name local_name
リモート Tivoli リージョンのユーザー・グループ名からローカルTivoli リージョンのグループ名へのマッピングを追加します。
add_region region host port [crypt]
追加のリージョンを統合します。パスワードは標準入力から読み取られます。このコマンドを端末装置 (tty) から実行した場合は、パスワードの入力を求めるプロンプトが表示されます。
add_role_map region remote_group remote_role local_role
グループ・マップ内に役割マップを追加します。
add_user_id_map region remote_name local_name
リモート Tivoli リージョンのユーザー・ログイン名からローカルTivoli リージョンのログイン名へのマッピングを追加します。
change_region region host port [crypt]
リモート Tivoli リージョンの構成情報を変更します。パスワードは
odadmin
第 3 章 コマンド (アルファベット順) 55
標準入力から読み取られます。このコマンドを端末装置 (tty) から実行した場合は、パスワードの入力を求めるプロンプトが表示されます。
注: リージョン・パスワードを指定しない場合には、リージョン・パスワードは削除されます。リージョン・パスワードが削除されると、 odlist.dat ファイルはリージョンの変更のために破壊されます。
delete_alias region IP_address [name...]
リモート Tivoli サーバーのホスト名または IP 別名を削除します。
delete_group_map region remote_group
リージョン間のオブジェクト・グループ・マップを削除します。
delete_group_id_map region remote_name
ユーザー・グループ名のマッピングを削除します。
delete_region region
リモート・リージョンを切断します。
delete_role_map region remote_group remote_role
グループ・マップ内の役割マップを削除します。
delete_user_id_map region remote_name
ログイン名のマッピングを削除します。
list_group_id_map region
リモート・リージョンのユーザー・グループ名からローカル・リージョンのグループ名へのマッピングを表示します。
list_map region
リージョン間のオブジェクト・グループと役割のマップをリスト表示します。
list_region [region]
接続されたリージョンをリスト表示します。省略すると、ローカル・リージョンに接続されたリージョンが表示されます。
list_user_id_map region
リモート・リージョンのユーザー・ログイン名からローカル・リージョンのログイン名へのマッピングを表示します。
set_install_pw管理対象ノードの作成用にインストール・パスワードを設定します。旧パスワードと新規パスワードは標準入力から読み取られます。このコマンドを端末装置 (tty) から実行した場合は、旧パスワードと新規パスワードの入力を求めるプロンプトが表示されます。
注: インストール・パスワードを変更しても、リージョン・パスワードは変更されません。
set_region_crypt_level crypt
他の Tivoli サーバーがこのリージョンに接続する場合に使用する暗号化レベルを設定します。 crypt オプションには、none、simple、または DES のいずれかを指定できます。
odadmin
56 Tivoli Management Framework: リファレンス・マニュアル
set_region_pw他の Tivoli サーバーがこのリージョンに接続するための暗号化パスワードを設定します。 旧パスワードと新規パスワードは標準入力から読み取られます。このコマンドを端末装置 (tty) から実行した場合は、旧パスワードと新規パスワードの入力を求めるプロンプトが表示されます。
注: リージョン・パスワードを変更しても、インストール・パスワードは変更されません。
set_allow_rconnect TRUE | FALSE | version_2 [object_dispatcher... | clients |
all] Tivoli デスクトップを使用可能にして、リモートの管理対象ノードに接続します。 TRUE および version_2 を使用すると、リモート接続できます。TRUE は秘密鍵を使用し、 version_2 は公開鍵を使用します。デフォルトは version_2 で、こちらの方がより安全です。
set_allow_NAT TRUE | FALSEネットワーク・アドレス変換 (NAT) サポートを使用可能にします。変更を有効にするには、エンドポイント・マネージャーおよびゲートウェイを再始動する必要があります。デフォルト値は FALSE です。NAT サポートの詳細については、「Tivoli Management Framework デプロイメントの計画ガイド」を参照してください。
set_bdt_port port_value [object_dispatcher... | clients | all]大量データ転送プログラム (BDT) サービスを使用するポートを設定します。ポート値には 1023 より大きい値を指定する必要があります。サービスが、指定したオブジェクト・ディスパッチャー (object_dispatcher)、管理対象ノード上のすべてのオブジェクト・ディスパッチャー (clients)、またはすべてのオブジェクト・ディスパッチャー (all) 用に使用するポートを設定できます。このオプションの実行には、役割 super または senior が必要です。
注: このオプションを使用できるのは、single_port_bdt オプションがTRUE に設定されている場合だけです。 FALSE (デフォルト) に設定されている場合には、この BDT ポートは使用されず、他のノード操作に適用されません。
set_comm_check TRUE | FALSE [object_dispatcher... | clients | all]ネットワーク接続がまだアクティブかどうかを判別するための通信チャネル検査を設定します。デフォルト値は FALSE です。このオプションをTRUE に設定すると、データを送信する Tivoli プロセスは、2 つのプロセス間の IPC (プロセス間通信) チャネルがアクティブかを検証するために受信プロセスに ping メッセージも送信してください。受信プロセスへの IPC
チャネルが終了している場合、送信プロセスが使用していたリソースは解放されます。このオプションは、システムがファイアウォールを介して通信する環境で使用します。セキュリティー上の理由から、ファイアウォールはいずれのシステムにも通知せずにシステム間のネットワーク接続を終了することができます。このオプションの実行には、役割 super または senior が必要です。
set_comm_check_response_timeout timeout_value [object_dispatcher... | clients |
all] Tivoli が IPC チャネルが終了したと判断するまでの秒数を設定します。
odadmin
第 3 章 コマンド (アルファベット順) 57
odadmin set_comm_check オプションを TRUE に設定すると、データを送信する Tivoli プロセスは、2 つのプロセス間の IPC チャネルがアクティブかを確認するために受信プロセスに ping メッセージも送信します。送信プロセスは、set_comm_check_response_timeout の値に達するまでデータの送信を続けます。受信プロセスがこのタイムアウト時間内に ping に応答しないと、送信プロセスは IPC チャネルが終了していると判断します。このオプションのデフォルト値は 180 秒で、最小値は 60 秒です。このオプションの実行には、役割 super または senior が必要です。
set_comm_check_timeout timeout_value [object_dispatcher... | clients | all]アイドル状態の IPC チャネルが終了したかどうかを判別するためにプロセスが ping メッセージを送信するまでの秒数を設定します。 odadminset_comm_check オプションを TRUE に設定すると、データを送信するTivoli プロセスは、2 つのプロセス間の IPC チャネルがアクティブかを確認するために受信プロセスに ping メッセージも送信します。このオプションは、プロセスが送信する ping の間隔を設定します。プロセスが ping を送信するには、この間隔中に IPC チャネルが非アクティブになった場合のみです。このオプションのデフォルト値は 180 秒で、最小値は 60 秒です。このオプションの実行には、役割 super または senior が必要です。
set_conn_validation_timeout timeout_value [object_dispatcher... | clients | all]オブジェクト・ディスパッチャーが着信接続の検証を行う秒数を設定します。 クライアントがこの間隔内で正しい接続情報を送信しない場合、接続はリジェクトされます。 デフォルト値は 300 秒です。この値をゼロに設定すると、着信接続はタイムアウトなしで行われます。このオプションの実行には、役割 super または senior が必要です。
set_crypt_level crypt
ローカル・リージョン内のオブジェクト・ディスパッチャー間の通信に使用する暗号化レベルを設定します。暗号化レベルを設定するには、一般に、次の手順を実行する必要があります。
1. odadmin shutdown clients を入力します。
2. odadmin set_crypt_level crypt を入力します。
crypt には、暗号化レベル (none、simple、または DESであることが可能) を指定することができます。
3. odadmin start clients を入力します。
このオプションを使用するには、役割 super または senior が必要です。
set_force_bind TRUE | FALSE {object_dispatcher... | clients | all}Tivoli 通信接続を強制して、単一の IP アドレスにバインドします。このオプションは、特定の高可用性またはフェイルオーバー構成で使用されます。この場合、多重オブジェクト・ディスパッチャーは 1 つの物理システム上の異なる IP アドレスにあります。
set_install_pw今後のクライアント・インストールに使用するインストール・パスワードを設定します。 旧パスワードと新規パスワードは標準入力から読み取られます。このコマンドを端末装置 (tty) から実行した場合は、旧パスワードと新規パスワードの入力を求めるプロンプトが表示されます。このオプションの実行には、役割 super または senior が必要です。
odadmin
58 Tivoli Management Framework: リファレンス・マニュアル
set_iom_by_name TRUE | FALSE {object_dispatcher... | clients | all}IOM キーを解釈して接続を行う時に、Tivoli サーバーの IP アドレスでなくホスト名を使用して、通信を使用可能にしたり不可能にしたりします。異なるサブネット上の異なる IP アドレスによって知られているマルチホーム・サーバーにこのオプションを使用します。
set_keep_alive {on | off | poll | nopoll | time...}
ダウン・ホストの検査のためのオプションを設定します。デフォルトはoff、つまりホストがまだダウンしているかを 180 秒ごとに検査します。コマンド出力の "State checking every 180 seconds" と表示されている行で、参照されている値を確認してください。このオプションの実行には、役割 super または senior が必要です。サブスクリプションは次のとおりです。
on | offキャッシュに入っているダウン・ホスト情報を承認する (on) か、毎回ホストを試す (off) かを指定します。
poll | nopollディスパッチャーをポーリングする (poll) か、情報を暗黙的に収集する (nopoll) かを指定します。ポーリング・アルゴリズムにより、ネットワーク・トラフィックが最小化されます。
time 最小ポーリング間隔を秒数で指定します。ほとんどのディスパッチャーは、この間隔ごとにポーリングされるわけではありません。
現行の keep_alive オプションを調べるには、odadmin odinfo 1 を実行します。
set_network_security {none | SSL | FORCE_SSL} [object_dispatcher... | clients| all] 管理対象ノードのネットワーク・セキュリティー・レベルを設定します。指
定したオブジェクト・ディスパッチャー (object_dispatcher)、管理対象ノード上のすべてのオブジェクト・ディスパッチャー (clients)、またはすべてのオブジェクト・ディスパッチャー (all) に対してネットワーク・セキュリティー・レベルを設定できます。オプションは次のとおりです。
none それが SSL 対応であり FORCE_SSL 管理対象ノードと通信している場合を除いて、 Secure Sockets Layer (SSL) が管理対象ノードによって使用されないことを指定します。これがデフォルトの設定です。
SSL 他の SSL 管理対象ノードとの通信時に、管理対象ノードが SSL を使用することを指定します。 none を設定されたノードとの通信時には、SSL は使用されません。
FORCE_SSL管理対象ノードが SSL を使用してのみ通信することを指定します。非 SSL 接続は管理対象ノードによって受け入れられません。
注: 変更を有効にするには、管理対象ノードを再始動します。 SSL の詳細については、「Tivoli Management Framework デプロイメントの計画ガイド」を参照してください。
odadmin
第 3 章 コマンド (アルファベット順) 59
set_ORB_pw object_dispatcher
Tivoli サーバーのオブジェクト・ディスパッチャーと、管理対象ノード上の指定されたオブジェクト・ディスパッチャーの間の通信に使用するパスワードを設定します。パスワードは標準入力から読み取られます。このコマンドを端末装置 (tty) から実行した場合は、パスワードの入力を求めるプロンプトが表示されます。役割 super または senior が必要です。また、Tivoli
サーバーおよび指定したオブジェクト・ディスパッチャーに対する root 特権も必要です。
一般に、クライアントを Tivoli サーバーに追加すると、その Tivoli クライアントが Tivoli サーバーとの通信に使用するパスワードが Tivoli サーバーによって設定されます。このパスワードは、ファイルに格納されたり、非暗号化テキストの形でネットワーク上で送信されたりすることはありません。ただし、インストール・プロセス中にネットワークが外部から侵入を受けたり、インストール後にデータベースが外部から侵入を受けた場合は、暗号化された状態のパスワードのコピーを侵入者が手に入れてデコードする恐れがないとは言えません。
クライアント用の Tivoli パスワードを変更するには、以下のようにします。
1. パスワード変更の影響を受けるクライアントをシャットダウンします。
2. Tivoli サーバーで odadmin set_ORB_pw object_dispatcher を実行します。
3. Tivoli データベース・ディレクトリー内のファイルhost_name-object_dispatcher-odb.adj を、クライアント・データベース・ディレクトリー内の odb.adj というファイルにコピーします。このときファイルのコピーには、セキュアなコピー手段を使用してください。odb.adj のファイル許可は、ユーザーは読み取り/書き込み許可、グループは許可なし、その他も許可なしに設定してください。また、このファイルは root が所有するようにしてください。
4. オブジェクト・ディスパッチャーを再始動します。
set_platform_license license_key
プラットフォーム・ライセンス・キーを追加または変更します。このオプションの実行には、役割 super または senior が必要です。
set_port_range [range]
IOM チャネル通信ポートと管理対象ノード間の Tivoli Management
Framework 通信を指定されたポート範囲に限定します。このオプションは特に、ポートの可用性を制御しているファイアウォール・アドミニストレーターにとって役立ちます。オブジェクト・ディスパッチャーおよびゲートウェイのデフォルト・ポートはこのオプションの影響を受けません。ポート範囲は 1023 より大きくしてください。ポート範囲をヌルに設定するには、次の構文を使用します。
odadmin set_port_range ""
set_rpc_max_threads num_threads
ディスパッチャーに並行リモート・プロシージャー・コール・スレッドの制限を設定するか、並行オブジェクト呼び出しスレッド数を設定します。デフォルトは 250 です。
odadmin
60 Tivoli Management Framework: リファレンス・マニュアル
set_ssl_ciphers cipher... [object_dispatcher... | clients | all ]
チャネルを保護するための管理対象ノード用の暗号を設定します。指定したオブジェクト・ディスパッチャー (object_dispatcher)、管理対象ノード上のすべてのオブジェクト・ディスパッチャー (clients)、またはすべてのオブジェクト・ディスパッチャー (all) に対して暗号を設定できます。cipher
オプションは次のとおりです。
defaultデフォルトの Tivoli リスト 05040A030609 を指定します。そのSSL 機能にかかわりなく、ノードはデフォルトに設定することができます。
cipher 暗号リストを設定順に指定します (たとえば 0A09)。ユーザー定義の暗号リストを変更する前に、ノードを SSL 対応にする必要があります。暗号値について、および管理対象ノードで SSL を使用可能にする方法については、「Tivoli Management Framework デプロイメントの計画ガイド」を参照してください。
注: 変更を有効にするには、管理対象ノードを再始動します。
set_tmgr_retriesトランザクション・マネージャーのデフォルトのタイムアウト値を調整します。トランザクション・マネージャーは、1 分あたり 1 回メッセージの送信を再試行し、これによって再試行回数が、トランザクションを中止するまでに待機する分数と等しくなるようにします。
注: この値は、Tivoli リージョンをベースに調整されます。リージョン内のすべてのディスパッチャーは、同じ値を持ちます。新規の値が有効となるのは、次回ディスパッチャーが再始動するときです。
shutdown [object_dispatcher... | clients | all]ローカル・オブジェクト・ディスパッチャーをシャットダウンします。指定したオブジェクト・ディスパッチャー (object_dispatcher)、管理対象ノード上のすべてのオブジェクト・ディスパッチャー (clients)、またはすべてのオブジェクト・ディスパッチャー (all) をシャットダウンできます。このオプションの実行には、役割 super または senior が必要です。リモート・システムから Tivoli サーバーをシャットダウンすることはできません。 このオプションは NetWare クライアントには使用できません。NetWare クライアントを停止するには、 oservend コマンドを使用する必要があります。
single_port_bdt {TRUE | FALSE} {object_dispatcher... | clients | all}単一ポートの大量データ転送プログラム (BDT) - Inter-Object Messaging
(IOM) および他の大規模データ転送の基礎となるサポート - を使用可能または使用不可にします。 TRUE が指定されると、ポートの使用が、選択されたポートに統合されます。デフォルトは FALSE です。指定したオブジェクト・ディスパッチャー (object_dispatcher)、管理対象ノード上のすべてのオブジェクト・ディスパッチャー (clients)、またはすべてのオブジェクト・ディスパッチャー (all) 用のサービスを使用可能/使用不可にすることができます。このオプションの実行には、役割 super または senior が必要です。
odadmin
第 3 章 コマンド (アルファベット順) 61
注:
v BDT サービスを使用可能にした後、reexec オプションを使用してオブジェクト・ディスパッチャーをリサイクル行します。
v single_port_bdt を使用可能にすると、 set_bdt_port オプションを使用することによってデフォルトのポート (9401) を別のポートに変更することができます。
start [object_dispatcher... | clients | all]ローカル・オブジェクト・ディスパッチャーを始動します。指定したオブジェクト・ディスパッチャー (object_dispatcher)、管理対象ノード上のすべてのオブジェクト・ディスパッチャー (clients)、またはすべてのオブジェクト・ディスパッチャー (all) を始動できます。このオプションの実行には、役割 super または senior が必要です。 このオプションは NetWare クライアントには使用できません。NetWare クライアントを始動するには、oservrun コマンドを使用する必要があります。
trace objcalls | services | errors | off [object_dispatcher... | clients | all]デバッグ・トレースを開始または停止します。オブジェクト呼び出し、サービス、またはエラーのトレースを指定でき、デバッグ・トレースをオフにすることもできます。オブジェクト呼び出し、サービス、およびエラーをトレースしたい場合には、まず最初に trace errors オプションを指定したodadmin コマンドを使用して、エラーのトレースをオンにする必要があります。エラー・トレースをオンにすると、オブジェクト呼び出しとサービスのトレースがオフになることに注意してください。したがって、エラー・トレースの呼び出し後、必ずオブジェクト呼び出しおよびサービスのトレースをオンにしてください。
指定したオブジェクト・ディスパッチャー (object_dispatcher)、管理対象ノード上のすべてのオブジェクト・ディスパッチャー (clients)、またはすべてのオブジェクト・ディスパッチャー (all) のトレースを開始/停止できます。特定のクライアント、clients オプション、または all オプションのいずれも指定しないと、ローカル・オブジェクト・ディスパッチャーのデバッグ・トレースが開始または停止されます。トレース情報は、データベース・ディレクトリーの odtrace.log ファイルに収集されます。トレース情報を表示するには、wtrace コマンドを使用します。 trace オプションを指定したodadmin コマンドの実行には、役割 super または senior が必要です。
Tivoliでは、デフォルトでエラー・トレースを無効にすることをお勧めします。すべてのオブジェクト呼び出しおよびサービスをトレースすると、ディスパッチャーのパフォーマンスに影響します。すべてのオブジェクト呼び出しおよびサービスのトレースを使用するのは、特定の問題を診断する場合だけにしてください。
例1. 次の例は、Tivoli サーバーの状況を取得します。
odadmin odinfo 1
Tivoli Management Framework (tmpbuild) #1 Wed Sep 17 14:07:45 CDT 2003(c) Copyright IBM Corp. 1990, 2003. All Rights Reserved.
Region = 1849216852
odadmin
62 Tivoli Management Framework: リファレンス・マニュアル
Dispatcher = 1Interpreter type = aix4-r1Database directory = /data/lorozco/Tivoli-1234/db/liliana.dbInstall directory = /data/lorozco/Tivoli-1234/binInter-dispatcher encryption level = simpleKerberos in use = FALSERemote client login allowed = TRUEInstall library path = /data/lorozco/Tivoli-1234/lib/aix4-r1:/usr/lib:/data/lorozco/tmp_install/iblib/aix4-r1:/usr/libForce socket bind to a single address = FALSEPerform local hostname lookup for IOM connections = FALSEUse Single Port BDT = FALSEUse communication channel check = FALSECommunication check timeout = default (180 secs)Communication check response timeout = default (180 secs)Oserv connection validation timeout = 300Port range = (not restricted)Single Port BDT service port number = default (9401)Network Security = noneSSL Ciphers = defaultALLOW_NAT = FALSEState flags in use = TRUEState checking in use = TRUEState checking every 180 secondsDynamic IP addressing allowed = FALSETransaction manager will retry messages 4 times.
2. 次の例を実行すると、shutdown オプションについてのヘルプが表示されます。
odadmin help shutdown
3. 次の例を実行すると、すべてのディスパッチャーのデータベース・ファイルがフラッシュされます。
odadmin db_sync all
4. 次の例では、すべての管理対象ノードがポート範囲 60000 ~ 60100 を使用するよう指定します。
odadmin set_port_range 60000-60100
5. 次の例は、Tivoli リージョン内のすべてのオブジェクト・ディスパッチャーに関する情報をリストします。
odadmin odlist
Region Disp Flags Port IPaddr Hostname(s)1248901349 1 ct- 94 10.69.9.42 la.tivoli.com,la
2 ct- 94 10.69.9.73 ten.tivoli.com
参照odbls, odstat, oserv, wconnect, wdisconn, wlsconn, wrmnode, wtrace,
wupdate
odadmin
第 3 章 コマンド (アルファベット順) 63
odbls
オブジェクト・データベースの内容をリスト表示します。
構文odbls [-a] [-I] [-i] [-l] [-m] [-O] [-s] [-k directory] [-M method_name] [oid]
説明odbls コマンドは、オブジェクト・データベースの内容をリスト表示します。
オプション-a オブジェクト・データベース内の属性を表示します。
-i オブジェクト・データベース内の継承ツリーを表示します。このオプションを使用するには、Tivoli サーバー のデータベースを使用する必要があります。
-I オブジェクト・データベース継承リストを表示します。
-k directory
リスト表示するオブジェクト・データベースの位置するディレクトリーを指定します。省略すると、現行ディレクトリー内のデータベースがリスト表示されます。
-l 要求された情報の冗長なリストを表示します。
-m メソッド・ヘッダーを表示し、すべてのエントリーをダンプ出力します。このオプションを使用するには、Tivoli サーバー のデータベースを使用する必要があります。
-M method_name
メソッド・ヘッダーを走査し、method_name のエントリーのダンプを出力します。このオプションを使用するには、Tivoli サーバー のデータベースを使用する必要があります。
-O オブジェクト・データベースの内容を走査します。これはデフォルトです。
-s リスト表示の前に、該当するオブジェクト・ディスパッチャーのデータベースを強制的に更新します。この同期化により、コマンドで報告されるデータとオブジェクト・ディスパッチャーが使用するデータが同じになります。省略すると、オブジェクト・データベースの内容をリスト表示する前に同期化は実行されません。
oid リストの範囲を指定したオブジェクトのみに限定します。
権限odbls コマンドを使用するには、データベースの読み取り許可が必要です。
-s オプションを使用する場合: super
64 Tivoli Management Framework: リファレンス・マニュアル
例次の例を実行すると、オブジェクト・データベース内のすべてのオブジェクトがリスト表示されます。
odbls -k /var/spool/tivoli/myhost.db
<bootstrap>200003.0.0200003.1.0200003.1.1200003.1.10200003.1.100200003.1.101200003.1.102200003.1.103200003.1.104
...
参照odadmin
odbls
第 3 章 コマンド (アルファベット順) 65
odstat
現在および最近のオブジェクト呼び出しの状況をリスト表示します。
構文odstat [?] [-a] [-c] [-d] [-h] [-l] [-s] [-v] [-o baseoid] [-p port_no]
(UNIX only) odstat [?] [-a] [-c] [-d] [-h] [-l] [-s] [-v] -k dbdir [pid]
説明odstat コマンドは、指定されたオブジェクト・ディスパッチャーの現在および最近のオブジェクト呼び出しの状況をリスト表示します。このコマンドにより、実行中のディスパッチャーのオブジェクト呼び出しをリスト表示できます。
上段の形式のコマンドは、メソッドを呼び出すことによってオブジェクト・ディスパッチャーのヒストリーを収集します。必要であれば、リモート・オブジェクト・ディスパッチャーを指定できます。下段の形式のコマンドは、オブジェクト・ディスパッチャーに信号を送ることによって情報を収集します。
-k オプションでデータベース・ディレクトリーを指定します。オブジェクト・ディスパッチャーはこのディレクトリーの一時ファイルに情報をダンプ出力します。 pid
オプションには、信号の送信先のオブジェクト・ディスパッチャーを指定します。下段の形式のコマンドは、なんらかの理由で通信が輻そうしている場合に便利ですが、上段の形式よりも特殊です。下段の形式では、ローカル・プロセスにしか信号を送ることができません。また、オブジェクト・ディスパッチャーの所有者は、Administrator または root なので、この形式を使用できるのは Administrator またはroot としてログインしている場合だけです。
コマンドは、次の列に出力を戻します。
tid スレッド ID をリストします。オブジェクト呼び出しを開始すると、オブジェクト呼び出し用と呼び出し対象のメソッド用に、2 つのスレッドが生成されます。
type スレッド・タイプをリストします。スレッド・タイプのフラグには次のものがあります。
O オブジェクト呼び出しスレッド (オブジェクト要求に付加される)
を指定します。これは、メソッドがここで呼び出されたが、別の場所で実行中であることを示します。
M メソッド・スレッド (メソッドに生成されます) をリストします。オブジェクト呼び出しは別のシステムで実行されたが、オブジェクトはローカル・システムにあることを示します。
O+ オブジェクト呼び出しスレッドとメソッド・スレッドが同じであることを示します。これは、呼び出し元とメソッドが両方ともローカルであることを示します。
メソッド・タイプのフラグには次のものがあります。
a 非同期オブジェクト呼び出し
66 Tivoli Management Framework: リファレンス・マニュアル
b 片方向オブジェクト呼び出し
d デーモン・メソッド
h 援助機能なしのメソッド
o オブジェクトごとのメソッド
q キューイング・メソッド
ptid そのメソッドが現在のオブジェクト呼び出しを行った、オブジェクト呼び出しの親スレッド ID またはスレッド ID をリストします。このフィールドがブランクの場合は、オブジェクト呼び出しは外部で実行されたものです。ダッシュ (-) の前の数字は、親スレッドのあるディスパッチャーの番号です。ダッシュの後の数字は、親オブジェクト・ディスパッチャー内のスレッドID です。
State 以下に示すオブジェクト呼び出しスレッドの状態をリストします。
ali スレッドが、Tivoli オブジェクト・データベースに対して参照を実行しています。
coord メソッドはトランザクション・コーディネーターの役割を果たしています。
done オブジェクト呼び出しは完了しました。
err スレッドは、内部エラーのために終了しました。
init スレッドは初期化されました。
mwait スレッドは、関連付けられたメソッド・スレッドが完了するのを待っています。
rwait スレッドは、呼び出し元が非同期オブジェクト呼び出しの結果を収集するのを待っています。
メソッド・スレッドの状態には、以下のものがあります。
done メソッドは完了しました。
gmeth スレッドは、別のディスパッチャーからメソッド・コードを取得しています。
hdwt スレッドは、デーモン・メソッド・プロセス (キュー以外のデーモン) の要求受け入れ準備ができるのを待っています。
init スレッドは初期化されました。
run メソッドは実行中です。
serv スレッドは、オブジェクト・サービス呼び出しを実行しています。
twait メソッドは、トランザクション状況のコミットまたは打ち切りを待っています。
StdO メソッドによって標準出力に書き込まれたバイト数をリストします。
StdE メソッドによって標準エラーに書き込まれたバイト数をリストします。大部分のスレッドは、標準エラーへの書き込みは行いません。
Start スレッドが開始された時刻をリストします。スレッドの存続期間によって、次のいずれか 1 つが項目となります。
odstat
第 3 章 コマンド (アルファベット順) 67
v 時刻 - 当日開始されたスレッド。v 日時 - 前日以前 (ただし、現在の週以内) に開始されたスレッド。v 月日 (UNIX オペレーティング・システムのみ) - 前の週以前に開始されたスレッド。
v 月 (Windows オペレーティング・システムのみ) - 前の週以前に開始されたスレッド。
Err スレッドのエラー状況をリストします。このフィールドがブランクの場合、エラーが発生しなかったことを示します。エラー・タイプは次のとおりです。
e=n メソッドは、終了コードとして n を戻しました。エラー・コード 0
~ 21 はシステム定義エラー用に予約されています。 アプリケーション・エラー・コードは 22 以降です。
s=n メソッドは、信号 n が原因で失敗しました。
S=n メソッドは、信号 n のために失敗し、コア・ファイルが生成されました。このコア・ファイルを使ってデバッグしたい場合には、サポート・プロバイダーまでご連絡ください。
XXX 英大文字の語は、オブジェクト・ディスパッチャーのエラーを示します。
終了コード (e=) は、Tivoli デスクトップが実行しているシステム、Tivoli
Management Framework、またはアプリケーションから送られる場合があります。どれが終了コードの生成元かを特定するには、それぞれのエラーの資料を調べることが必要になる場合もあります。システム生成のエラーについてのヘルプを参照するには、システムの資料を使用することができます。たいていの UNIX オペレーティング・システムには、システム・エラー・コードと短い説明をリストしたエラー・ファイルがあります。 OS/2 オペレーティング・システムでは、help n と入力します。ここで n は、エラー・メッセージの番号です (たとえば help 5)。 Windows オペレーティング・システムでは、net helpmsg n コマンドを入力します (たとえば net helpmsg
5)。
Methodメソッド呼び出しのテキストをリストします。最初の値は、メソッドがどのオブジェクトのコンテキストで呼び出されたかを示すオブジェクト ID です。これは、ピリオドで区切った 3 つの数字の形式をとる場合と、ピリオドで区切った 3 つの数字の直後にシャープ記号 (#) とクラス名が続き、最後にもう 1 つシャープ記号が続く形式をとる場合があります。次のエントリーは、メソッド名とそれに続くメソッドのオプションです。
次に、odstat 出力にリストされたメソッドの例を示します。
1242184237.1.516#TMF_SysAdmin::InstanceManager# _get_interfaces
コマンド出力および他の問題判別コマンドの詳細については、「Tivoli Management
Framework 保守およびトラブルシューティング・ガイド」を参照してください。
オプション? このコマンドのヘルプを表示します。
odstat
68 Tivoli Management Framework: リファレンス・マニュアル
-a すべてのスレッドのリストを表示します。デフォルトでは、システム・スレッドは省略されます。
-c 現在実行中のスレッドをリスト表示します。
-d アクティブなメソッド・デーモン・プロセスをリスト表示します。
-h スレッドのヒストリー (終了したスレッド) だけをリスト表示します。
-k dbdir (UNIX オペレーティング・システムのみ)
指定されたディレクトリー内のデータベースを使用しているディスパッチャーからの情報を戻します。-k オプションを指定する場合は、オブジェクト・ディスパッチャーのプロセス ID (PID) を指定してください。 これを指定しないと、コマンドにより、ディスパッチャーのプロセス ID 用のオブジェクトが無作為に選出されます。
-l 長いリストを戻します。
-o baseoid
別のシステムのオブジェクト・ディスパッチャーの状況を戻します。
-p port_no
ポート番号を設定します。
-s 短いリストを戻します。
-v 冗長モードを指定します。メソッドまたはスレッドが最後に実行したオブジェクト・サービス要求、その要求の戻りコード、メソッドに関連付けられたプロセス ID、およびデーモン・スレッドで最後に呼び出されたメソッドがリスト表示されます。
pid ディスパッチャーのプロセス ID を指定します。このオプションを指定する場合は、-k オプションも指定する必要があります。
オプションを 1 つも指定しないと、コマンドはデフォルトでは odstat -c -h -l
-o 0.0.0 になります。
権限このコマンドの実行には、役割 super、 senior、admin、または user が必要です。 -k オプションを実行するには、Administrator または root としてログインしている必要があります。
例1. 以下に、オプションを 1 つも指定しなかった場合のコマンド出力の例を示します。出力についての説明も含まれています。
odstat
出力には、現在実行中のメソッドが表示されます。
n_active = 5 n_free = 195tid type ptid State StdO StdE Start Err Method83 O+bhdoq run 0 0 Sat16:00 200003.1.163#TMF_Scheduler::scheduler# start
前述の出力で、メソッド・スレッド ID 83 は「片方向」呼び出しで、呼び出したメソッドは、援助機能なし、キューイング、デーモン、オブジェクトごとのメソッドです。これは現在 run (実行) 状態で、開始時刻は土曜日の 16:00 です。
odstat
第 3 章 コマンド (アルファベット順) 69
オブジェクト ID は 200003.1.163#TMF_Scheduler::scheduler# (ローカル・スケジューラー・オブジェクト)、メソッド名は start です。
(... output deleted for brevity ...)---- history ----855 O+ 1-854 done 11 0 Sun16:16 0.0.0 get_name_registry856 O+hdoq 1-854 done 106 0 Sun16:16 200003.1.26 lookup857 O+hd 1-854 done 6 0 Sun16:16 200003.1.128
#TMF_UI::ActiveDesktopList# add_entry
history の行は、すでに完了したメソッドの先頭を示します。メソッド 855、856、および 857 はカスケード式のメソッドです。これらのメソッドは、このoserv でメソッド 854 によって呼び出されました。 (この例では、ディスパッチャー 1 を使用しています。) メソッド 855 は 11 バイトの標準出力を生成し、メソッド 856 は 106 バイト、メソッド 857 は 6 バイトを生成しました。
(... more output deleted ...)* 918 O+hdoq 1-917 done 488 0 Sun16:27 e=12 200003.1.26 lookup
メソッド 918 ではエラーが発生しました。最初の欄にアスタリスクは、異常事態が発生した恐れがあることを示します。e=12 は、例外が発生したことを示しています。wtrace コマンドを使って、例外の詳しい情報を調べることができます。
950 O 1-949 done 0 0 Sun16:28 <batch-mgr>¥add_backref_optimized951 O+hdq 1-949 done 117 0 Sun16:28 200003.1.378
#TMF_Install::ProductInfo# add_backref_optimized
メソッド・スレッド 950 は、バッチ・オブジェクト呼び出しマネージャーです。これは、複数のオブジェクトに対して同じメソッドの複数の呼び出しが同時に行われたことを示しています。行 951 は、950 が管理するバッチ・メソッド呼び出しの 1 つです。
* 1029 O+ 1-1026 done 0 0 Sun17:06 UNAUTHORIZED 200003.0.0get_principal_roles Root_PI-sluggo
メソッド 1029 は、例外機能の下のコア・サービス・レベルで実行され、失敗したメソッドを示しています。この場合、odstat は可能であればエラー・コードをエラー名に変換します。このメソッドでは例外が発生したわけではないので、wtrace を使用してもエラー・コードに関する詳細情報は取得できません。
2. 次に示す例は、リモート・マシン上のメソッドのヒストリーを照会するものです。まずネーム・レジストリーの wlookup コマンドを使ってマシン名をオブジェクト参照子に変換し、次にそのオブジェクト参照子を使って odstat を呼び出します。
wlookup -r ManagedNode -a
pokey 200003.2.7#TMF_ManagedNode::Managed_Node#sluggo 200003.1.285#TMF_ManagedNode::Managed_Node#
odstat -o 200003.2.7#TMF_ManagedNode::Managed_Node#
参照odadmin, tmstat, wtrace
odstat
70 Tivoli Management Framework: リファレンス・マニュアル
oinstall
Tivoli オブジェクト・ディスパッチャー・サービスの Windows サービス・マネージャーへのインストール、更新、または除去を行います。
構文oinstall -install path
oinstall -query
oinstall -remove
oinstall -update {[+auto | -auto] [+depend | -depend service] [+interactive |
-interactive] [path]}
説明oinstall コマンドは、Tivoli オブジェクト・ディスパッチャー を Windows サービス・マネージャーにインストールする場合に使用します。また、オブジェクト・ディスパッチャーを更新する場合や、 Windows サービス・マネージャーからオブジェクト・ディスパッチャーを削除する場合にもこのコマンドを使用します。 Tivoli
Management Framework を Windows オペレーティング・システム上にインストールすると、インストール・プロセス中にこのコマンドが自動的に実行されます。
オプション-install
Windows サービス・マネージャーにオブジェクト・ディスパッチャー・サービスをインストールします。サービスは、非対話式モード、手動再始動モードでインストールされます。
-query現行のオブジェクト・ディスパッチャー・サービスに関連した依存関係を参照できるようになります。また、このオプションはオブジェクト・ディスパッチャーのインストール状況も戻します。
-removeWindows サービス・マネージャーからオブジェクト・ディスパッチャー・サービスを除去します。
-updateオブジェクト・ディスパッチャーを、以下の 1 つ以上のオプションを使って更新します。
+auto | -autoシステムの再始動時の自動再始動を、使用可能または使用不可にします。デフォルトでは、自動再始動は使用不可になっています。
+depend | -depend service
Windows オペレーティング・システム上でのオブジェクト・ディスパッチャーの開始を、指定されたサービスが開始するまで遅らせます。そのようなサービスには、TCPIP、 TRIP などが含まれます。指定されたサービスがダウンしたときにオブジェクト・ディスパッ
第 3 章 コマンド (アルファベット順) 71
チャーを開始しようとすると、システムはオブジェクト・ディスパッチャーを開始する前に、そのサービスを開始しようとします。指定されたサービスを停止しようとすると、オブジェクト・ディスパッチャーがこのサービスに依存していることを伝えるダイアログでプロンプトが出されます。それでもサービスを停止すると、オブジェクト・ディスパッチャーも停止します。このオプションを使用して、オブジェクト・ディスパッチャー・サービスの依存関係を除去することもできます。更新の発行時にサービスが実行中ならば、サービスは停止します。変更を有効にするには、それを再始動する必要があります。次に、依存関係にあるサービスが、オブジェクト・ディスパッチャー・サービスの停止についてのプロンプトを戻します。
+interactive | -interactiveオブジェクト・ディスパッチャー・サービスと Tivoli デスクトップとの間の対話モードを有効または無効にします。 Tivoli ADE (アプリケーション開発環境) の開発を行っている場合以外は、対話モードを有効にしないでください。
path ローカルの New Technology File System (NTFS) 上の oserv.exe実行可能ファイルまでのパスを指定します。同じライブラリーにlibuthreads.dll ファイルがあるものと見なされます。
注: 更新コマンドの発行時にサービスを実行中であるならば、そのサービスを停止して再始動し、変更を有効にする必要があります。
権限Log on as service 特権
例1. 次に示す例では、サービス・マネージャーにオブジェクト・ディスパッチャー・サービスをインストールします。 oserv.exe および libuthreads.dll ファイルはc:¥Tivoli にあります。
oinstall -install c:¥Tivoli¥oserv.exe
2. 次に示す例では、サービス・マネージャー内のオブジェクト・ディスパッチャー・サービスを更新します。 oserv.exe および libuthreads.dll ファイルの場所は c:¥Tivoli¥bin に変更され、自動再始動モードが有効になります。
oinstall -update +auto c:¥Tivoli¥bin¥oserv.exe
3. 次の例では、Windows オペレーティング・システムでのオブジェクト・ディスパッチャーの開始を、TCP/IP が開始するまで遅らせます。
oinstall -update +depend TCPIP
4. 次の例では、オブジェクト・ディスパッチャー・サービスの依存関係を除去します。
oinstall -update -depend
5. 次の例では、現行サービスに関連した依存関係を参照できるようにします。
oinstall -query
oinstall
72 Tivoli Management Framework: リファレンス・マニュアル
oserv
オブジェクト・ディスパッチャーのコントロールおよび設定のための操作を提供します。
構文oserv -k dbdir [-a TRUE | FALSE] [-b install_dir] [-B libpath] [-c crypt] [-Ccrypt] [-d] [-E {default | cipher...}] [-l log_file] [-m swap_size] [-n {none | SSL |
FORCE_SSL}] [-N ali [-r region]] [-N {by_addr | by_name}] [-p local_port] [-Rirkey] [-S] [-s install_key] [-t max_trace_size] [-v] [-z TRUE | FALSE]
oserv -kdbdir [-b install_dir] [-B libpath] [-d] [-E {default | cipher...}] [-hTivoli_server] [-l log_file] [-m swap-size] [-n {none | SSL | FORCE_SSL}] [-plocal_port] [-S] [-t max_trace_size] [-v] [-z TRUE | FALSE]
oserv -b install_dir -k dbdir [-f TRUE | FALSE] -i -r region [-a TRUE | FALSE]
[-B libpath] [-c crypt] [-C crypt] [-d] [-E {default | cipher...}] [-l log_file] [-mswap_size] [-n {none | SSL | FORCE_SSL}] [-N {by_addr | by_name | ali}]
[-p local_port] [-R irkey] [-S] [-s install_key] [-t max_trace_size] [-v] [-z TRUE |
FALSE]
oserv -k dbdir [-f TRUE | FALSE] -i -h Tivoli_server -b install_dir [-B libpath]
[-d] [-E {default | cipher...}] [-l log_file] [-m swap_size] [-n {none | SSL |
FORCE_SSL}] [-p local_port] [-S] [-s install_key] [-t max_trace_size] [-v] [-zTRUE | FALSE]
Windows システムのみnet start oserv /-option...
oserv コマンドはサービス・マネージャー以外からは呼び出せません。コマンド行から呼び出す場合は、oserv コマンドの前に net start と入力する必要があります。
オプションはすべて、UNIX で使用する単一のダッシュ (-) の代わりにスラッシュとダッシュ (/-) を前に付けて指定します。値を指定する必要のある文字オプションでは、文字と値の間にスペースを入れないでください (例 : net start oserv
/-Nbyaddr)。
-k オプションは必須ではありません。この引き数を指定しない場合は、データベース・ディレクトリーの場所はレジストリーから取得されます。
説明oserv コマンドは、Tivoli オブジェクト・ディスパッチャーを始動します。Tivoli
オブジェクト・ディスパッチャーには多数の機能があります。たとえば、Tivoli がインストールされている各システムの Tivoli オブジェクト・データベースの保守、適切なシステムおよびオブジェクトへのオブジェクト呼び出しの送信、ローカル・システムに存在するオブジェクトのコンテキストで呼び出されたメソッドの実行の調整などです。
第 3 章 コマンド (アルファベット順) 73
最初の形式の oserv コマンドは、Tivoli サーバー上のオブジェクト・ディスパッチャーを再始動する場合に使用します。
2 番目の形式の oserv コマンドは、管理対象ノード上のオブジェクト・ディスパッチャーを再始動する場合に使用します。
3 番目の形式の oserv コマンドは、Tivoli サーバー上のオブジェクト・ディスパッチャーを初期化する場合に使用します。
4 番目の形式の oserv コマンドは、管理対象ノード上のオブジェクト・ディスパッチャーを初期化する場合に使用します。
3 番目と 4 番目の形式の oserv コマンドは、インストール・プログラムを使用しているときにのみ実行されます。
オブジェクト・ディスパッチャーは、再始動時に以前の設定で再開できるように、構成オプションをそのデータベースに保管しています。オブジェクト・ディスパッチャーを再始動するときは一般に、 -k オプションと、変更する必要がある設定のオプションを指定します。オブジェクト・ディスパッチャーをシャットダウンせずにオブジェクト・ディスパッチャーの設定を変更するには、odadmin コマンドを使用します。
オプション-a TRUE | FALSE
クライアント・インストールをコントロールするフラグを設定します。クライアント・インストールを許可 (TRUE) または禁止 (FALSE) に設定できます。このオプションは、Tivoli サーバーでのみ有効です。
-b install_dir
メソッド・バイナリーのインストール・ディレクトリーのパス名を指定します。 -i オプションを指定する場合は、このオプションは必須です。$BINDIR/.. および %BINDIR%¥.. はリテラルのパス名の値であり、スラッシュの後の 2 つのドットは名前の一部であることに注意してください。ドットは省略符号 (...) ではなく、パス名の継続を示します。これは、$BINDIR/.. によって参照されるのと同じディレクトリーです(UNIX オペレーティング・システム) および %BINDIR%¥.. (Windows オペレーティング・システム)。
-B libpath
共用ライブラリーの検索パスを指定します。 -i オプションを指定してこのオプションを指定しないと、ローカル環境からライブラリー検索パスが読み取られます。これは、$LIBDIR (UNIX オペレーティング・システム または%LIBDIR% (Windows オペレーティング・システム) によって参照されるのと同じディレクトリーです。
-c crypt
リージョン内暗号化レベルを指定します。crypt オプションには、des、simple、または none を指定できます。
oserv
74 Tivoli Management Framework: リファレンス・マニュアル
-C crypt
リージョン間暗号化レベルを指定します。crypt オプションには、des、simple、または none を指定できます。
-d オブジェクト・ディスパッチャーをコントロール端末から切り離しません。このオプションは、オブジェクト・ディスパッチャーをデバッガーで実行する場合に使用します。標準出力は /dev/null ディレクトリーにはマップされません。
-E {default | cipher...}
管理対象ノードの暗号リストを 1 つかそれ以上、設定順に指定します (たとえば 0A09)。このオプションは、管理対象ノードから Tivoli サーバーに初期接続する際に暗号を設定します。ノードが接続した後、デフォルトで、サーバーに保管された値に戻ります。また、管理対象ノードが default 設定を持つよう指定することもできます。これはつまり、管理対象ノードが、デフォルトの Tivoli 暗号リスト 05040A030609 を持つことを意味します。暗号値のリストについては、「Tivoli Management Framework ユーザーズ・ガイド」を参照してください。
-f TRUE | FALSEオブジェクト・ディスパッチャーにすべての管理対象ノード接続を 1 つのソケットにバインドさせます。複数のインターネット・プロトコル (IP) アドレスを持つマシン上で複数のディスパッチャーが実行されているときに、このオプションを使用します。これによって、クライアントと通信するときに各ディスパッチャーに同じ IP アドレスを使用させるようにします。
-h Tivoli_server
新規 Tivoli サーバーの名前を指定します。このオプションは、管理対象ノード上でオブジェクト・ディスパッチャーを始動するときに使用します。
-i オブジェクト・ディスパッチャーを初期化します。このオプションは、システムでオブジェクト・ディスパッチャーを初めて始動するときに使用します。お客様サポートの指示なしに -i オプションを使用しないでください。
-I オブジェクト・ディスパッチャーが inetd サービスによって始動されることを、オブジェクト・ディスパッチャーに通知します。このオプションは、inetd 構成ファイル内でだけ指定します。コマンド行には指定しないでください。
-k dbdir
オブジェクト・データベース・ディレクトリーのパス名を指定します。これは、$DBDIR (UNIX オペレーティング・システム または %DBDIR%
(Windows オペレーティング・システム) によって参照されるのと同じディレクトリーです。
-l log_file
メッセージのログ記録に使用するファイルを指定します。このオプションを指定しないと、メッセージは oservlog ファイルに記録されます。
-m swap_size
mmap コマンドによって割り振られるスワップ・スペースのサイズを指定します。
oserv
第 3 章 コマンド (アルファベット順) 75
-n {none | SSL | FORCE_SSL}
管理対象ノードの、Tivoli サーバー への初期接続のネットワーク・セキュリティー・レベルを設定します。ノードが接続した後、デフォルトで、サーバーに保管された値に戻ります。オプションは次のとおりです。
none それが SSL 対応であり FORCE_SSL 管理対象ノードと通信している場合を除いて、 SSL が管理対象ノードによって使用されないことを指定します。これがデフォルトの設定です。
SSL 他の SSL 管理対象ノードとの通信時に、管理対象ノードが SSL を使用することを指定します。 none を設定されたノードとの通信時には、SSL は使用されません。
FORCE_SSL管理対象ノードが SSL を使用してのみ通信することを指定します。非 SSL 接続は管理対象ノードによって受け入れられません。
-N {by_addr | by_name | ali}gethostbyaddr (by_addr)、gethostbyname (by_name) を使用するか、もしくは Tivoli サーバーのodlist エントリーをこのシステムの名前とアドレスに置き換えて (ali)、odlist エントリーの IP アドレスを再度取り出します。 ali オプションを使って Tivoli サーバー を新しいシステムに移動する場合は、最初に必ずお客様サポートから手順についての説明を受けてください。
-p local_port
他のプロセスとの通信に使用するポートの番号を指定します。ポート番号には 1024 より小さい値を指定してください。このオプションを指定すると、/etc/services ファイルのポート指定は変更されます。このオプションを指定しないと、デフォルトでは /etc/services ファイルのポート指定が使用されます。
-P ali_port
Tivoli サーバーとの通信に使用するポートの番号を指定します。ポート番号には 1024 より小さい値を指定してください。このオプションが必要なのは、-i オプションが指定されており、Tivoli サーバー・ポートがローカル・オブジェクト・ディスパッチャーのポートとは異なる場合のみです。このオプションは、管理対象ノードにのみ有効です。
注: このオプションは、開発環境とテスト環境での使用だけを目的としています。実稼働環境では使用しないでください。
-r region
Tivoli リージョン番号を設定します。このオプションは、-i オプションまたは -N ali オプションを指定する場合にだけ使用できます。
-R irkey
リージョン間暗号鍵を指定します。irkey オプションを指定しないと、リージョン間暗号鍵は標準入力から読み取られます。-s オプションを指定する場合、-R オプションは指定できません。
-s install_key
インストール鍵を指定します。install_key オプションを指定しないと、イン
oserv
76 Tivoli Management Framework: リファレンス・マニュアル
ストール鍵は標準入力から読み取られます。-R オプションを指定する場合、-s オプションは指定できません。
-S syslogd サービスへのエラーの出力を抑制します。
-t max_trace_size
wtrace コマンドで使用するために作成する odtrace.log ファイルの最大サイズを設定します。
-v オブジェクト・ディスパッチャーに、UNIX オペレーティング・システムで fork() メソッドの代わりに vfork() メソッドを使用してサブプロセスを作成させます。 Windows オペレーティング・システム では、このフラグを指定しても効果はありません。
権限root
例1. 次に示す例は、すべて現行のデフォルト値を使って oserv を始動します。
oserv -k /var/spool/Tivoli/myhost.db
2. 次に示す例は、バイナリー・ディレクトリーおよびライブラリー・ディレクトリーのパスを変更します。これらのディレクトリーのマウント・ポイントが変更された場合に実行します。
oserv -b /mnt/local/Tivoli/bin -B ¥/mnt/local/Tivoli/lib:/usr/lib ¥-k /var/spool/Tivoli/myhost.db
参照odadmin, odstat, idlcall, objcall, oinstall, wsettap, wtrace
oserv
第 3 章 コマンド (アルファベット順) 77
tivoli
Tivoli デスクトップ を始動して、新規ダイアログをプレビューします。
構文tivoli [-debug] [-display display] [-help] [-host host_name] [-port port_number]
[-preview file.d variable_name variable_value...] [-user user_name] [x_options]
説明tivoli コマンドは、使用されるオプションに応じて、2 種類の機能を実行します。1
つは、Tivoli アドミニストレーター用の Tivoli デスクトップ を始動する機能です。もう 1 つは、DSL プログラム言語で作成したダイアログをプレビューすることができます。
-display オプションでは、デスクトップの表示またはダイアログのプレビューを行う X Window ディスプレイを指定します。このオプションを省略すると、tivoli コマンドは DISPLAY 環境変数に定義された値をデフォルトとして使用します。 X
Window リソースの詳細については、「Tivoli Enterprise インストール・ガイド」を参照してください。
x_options オプションの値は、X リソース設定として解釈されるストリングです。たとえば、-background blue と指定すると、すべてのダイアログのデフォルトの背景色が青に設定されます。
-preview スイッチが指定されない場合は、tivoli コマンドによりアドミニストレーターのデスクトップが始動されます。
-display オプションと x_options オプションは、Windows システムでは使用しません。
Tivoli アプリケーション開発環境 (ADE) を開発している場合、-preview オプションを指定すると、file.d に入っているダイアログのプレビューをユーザー・インターフェース (UI) サーバーに指示することになります。このダイアログにダイアログ変数が含まれている場合は、ダイアログ・ファイル名に続けて各ダイアログ変数の名前と値を指定する必要があります。たとえば、ダイアログに var1 と var2 という 2
つのダイアログ変数がある場合は、次のように指定します。
tivoli -preview file.d var1 value-of-var-1 var2 value-of-var-2
ブランクがある値は、次のように、二重引用符と単一引用符で囲む必要があります。
tivoli -preview file.d var1 "’value of var 1’"
オプション-debug
ADE 開発者のためのデバッグ情報を提供する追加のダイアログを表示します。
-display display
display に指定されたホストの画面にデスクトップを表示します。
78 Tivoli Management Framework: リファレンス・マニュアル
-help 使用法を示すメッセージを出力します。
-host host_name
Tivoli デスクトップの接続先の Tivoli サーバーも含めて、管理対象ノードを指定します。
-port port_number
オブジェクト・ディスパッチャーが使用するポート番号を指定します。
-preview file.d variable_name variable_value
file.d に指定したファイルのプレビューを UI サーバーに指示します。ADE
開発者は、このオプションを使用して、新しいダイアログを製品に組み込む前にプレビューできます。サブオプションは次のとおりです。
file.d ADE 開発者の .d ファイルの名前を指定します。
variable_name
ダイアログ指定言語 (DSL) 変数名を指定します。
variable_value
variable_name に関連付ける値を指定します。
-user user_name
管理対象ノードへのログイン名を指定します。
x_options
そのセッションに設定する X リソースを指定します。
権限user、admin、senior、super
tivoli
第 3 章 コマンド (アルファベット順) 79
tmcmd
実行中のトランザクションの状態を強制的に変更します。
構文tmcmd [-p port] state transaction_id...
説明tmcmd コマンドは、トランザクションの状態を強制的に変更します。このコマンドは、ローカル・トランザクション・マネージャーにメッセージを送って、トランザクションを指定された状態に強制的に変更します。
tmcmd コマンドは主に、トランザクション・マネージャーのテストとデバッグに使用します。トランザクション・マネージャーは、oserv サービス (デーモン) の内部でリンクされています。重大な問題や異常な状態から回復するための最後の手段として、お客様サポートからこのコマンドの実行を求められることがあります。このコマンドが適切に実行されないと oserv デーモンが破壊されたりデータベースが壊れたりする恐れがあります。このためこのコマンドは必ずお客様サポートの指示と援助のもとで実行してください。
オプション-p port
ローカル・ポート番号を指定します。
state トランザクションをどの状態に変更するかを指定します。このオプションには、abort、commit、prepare 、complete、prepared、またはcompleted のいずれかを指定できます。
transaction_id
強制的に状態が変更されるトランザクションの ID を指定します。複数のトランザクション ID を指定できます。
権限senior、super
診断トランザクション・マネージャーに送ったコマンドが 2 フェーズ・コミット・プロトコルに違反していると、oserv デーモンが打ち切られたり、データベースが壊れたりすることがあります。
参照odstat, tmstat
80 Tivoli Management Framework: リファレンス・マニュアル
tmstat
現行トランザクションおよびロックの状況を表示します。
構文tmstat [-k dbdir] [-p port] [-r region] [-v] [-a] [base_object_id...]
説明tmstat コマンドは、現在実行中のトランザクションとロック、およびそれらの現在の状態を表示します。このコマンドは主に、トランザクション・ベースのアプリケーションを開発するユーザーのためのデバッグ・ツールです。このコマンドを使用することにより、トランザクションの階層を監視できます。
表示される各トランザクション ID には、暗黙的にトランザクション階層が含まれています。たとえば、{transA}{transB} は {transA} の子と解釈できます。
オプション-a -r オプションで指定されたローカル Tivoli リージョンまたはリモート
Tivoli リージョンの基本リスト内のすべてのオブジェクト ID を表示します。
-k dbdir
データベース・ディレクトリーを指定します。
-p port
ローカル・ポート番号を指定します。
-r region
別の Tivoli リージョンを照会します。このオプションは、リモート Tivoli
サーバー上の基本オブジェクト ID を指定します。
-v 冗長モードを指定します。サブトランザクションのリストがダンプ出力されます。
base_object_id...
照会先オブジェクト・ディスパッチャーを指定します。 base_object_id オプションは複数指定できます。
権限user、admin、senior、super
例1. オプションを指定しなかった場合の出力例を次に示します。例の後に、出力についての説明を記載します。
tmstatTransactions for 0.0.0
Trid Type State Resources Polling Coord Parent MTid----------------------------------------------------------{202020:1,202020:1,2:3}
Top-T running Yes No running running 40{202020:1,202020:1,2:3},{202020:1,202020:1,2:4}
第 3 章 コマンド (アルファベット順) 81
Sub-T commit Yes Yes running running 44{202020:1,202020:1,2:3},{202020:1,202020:1,2:5}
Sub-T commit Yes Yes running running 45{202020:1,202020:1,2:3},{202020:1,202020:1,2:6}
Sub-T commit Yes Yes running running 46{202020:1,202020:1,2:3},{202020:1,202020:1,2:7}
Sub-T commit Yes Yes running running 47----------------------------------------------------------Cannot truncate log file:
Undo information pendingRedo information pendingTransaction event callback information pending
tmstat の出力は、現行トランザクションを示す表、コーディネーターを示すセクション、transactionlog ファイルを削除できない理由を示すセクション、ローカル・リソースを持つリモート・トランザクションを示すセクション、という 4
つのセクションから構成されます。
前述の例には、この 4 つのセクションのうち 2 つだけが表示されています。上の表には、全ローカル・トランザクションのトランザクション ID、トランザクション・タイプ、トランザクションの状態、トランザクションがリソースを保持しているかどうか、トランザクションがその親またはコーディネーターをポーリングするかどうか、およびトランザクションがその親またはコーディネーターの状態をどう認識しているかが表示されています。MTid エントリーは、トランザクション ID と odstat コマンドのメソッド・スレッド ID との突き合わせに使用できます。
コーディネーターを示す 2 番目のセクションは空なので、省略されています。
3 番目のセクションには、トランザクション・ログ・ファイルを削除できない理由が現在ある場合に、その理由が表示されます。このセクションが空の場合は、odadmin db_sync コマンドを使って即時にログ・ファイルを切り捨てることができます。
ローカル・リソースを持つリモート・トランザクションを示す 4 番目のセクションは空なので、省略されています。
2. 次の例では、リモート管理対象ノード上で tmstat コマンドを呼び出します。たとえば、次のステップを実行すれば、Tivoli サーバー から、トランザクションの状況を表示し、“dispatcher 2” をロックすることができます。
a. 操作対象の管理対象ノードの OID を判別するには、次のコマンドを入力します。
wlookup -ar ManagedNode
次のような出力が表示されます。
bushido 1248901349.1.348#TMF_ManagedNode::Managed_Node#tengu 1248901349.2.7 #TMF_ManagedNode::Managed_Node#
b. 管理対象ノードの明示的 OID を使用して tmstat コマンドを呼び出すには、次のコマンドを入力します (ここで 1248901349.2.7 はオブジェクト ID です)。
tmstat 1248901349.2.7
tmstat
82 Tivoli Management Framework: リファレンス・マニュアル
または次のように、固有の Tivoli リージョンの ID 番号に置換される $TMR
変数を使用することができます。
tmstat $TMR.2.7
参照odstat, tmcmd
tmstat
第 3 章 コマンド (アルファベット順) 83
vdisp
すべての管理対象ノードの状況を検査します。
構文vdisp [-v] [-h] [-i] [-q]
vdisp [-v] [-h] [-i] [-t time]
説明vdisp コマンドは、オブジェクト・ディスパッチャーにリストされているすべての管理対象ノードの状況を検査します。またオプションで、簡単なパフォーマンス・テストを実行します。
注: このコマンドは、サポート提供者から指示があった場合にのみ使用してください。
オプション-h Tivoli リージョン内のホストおよび各管理対象ノードの状況情報を表示しま
す。
-i オブジェクト・ディスパッチャーと通信していない管理対象ノードを無視します。このオプションが指定されず、ダウンしている管理対象ノードが存在する場合には、コマンドは処理を停止します。
-q 簡単なパフォーマンス検査を実行しません。 このオプションは、-t オプションをオーバーライドします。
-t time パフォーマンス・テストを実行する合計時間 (秒単位) です。デフォルト値は 30 秒です。 -q オプションを指定すると、このオプションは無視されます。
-v オブジェクト・ディスパッチャー・リスト内のすべての管理対象ノードに対して、 PING およびパフォーマンス・テストを実行します。
例1. 以下の例では、オブジェクト・ディスパッチャー・リスト内のすべての管理対象ノードに PING を送信し、それぞれのホスト状況を表示します。オフラインの管理対象ノードは無視します。パフォーマンス検査を実行しません。
vdisp -vhiq
ping:1234567890.1.0 alive1234567890.2.0 alive
ORB ServConn Host Type1 UP paper.tivoli.com solaris22 UP vellum.tivoli.com solaris2
2. 以下の例では、オブジェクト・ディスパッチャー・リストのすべての管理対象ノードに PING を送信します。オフラインの管理対象ノードは無視します。パフォーマンス・テストを 5 秒間実行します。
84 Tivoli Management Framework: リファレンス・マニュアル
vdisp -vit5
ping:1234567890.1.0 alive1234567890.2.0 aliveRunning performance test for 5 seconds
ORB Ncalls Secs/Call Calls/Min1234567890.1.0 2020 0.05 1218.061234567890.2.0 2013 0.05 1214.07
vdisp
第 3 章 コマンド (アルファベット順) 85
w4inslcf.pl
iSeries システムに AS/400 エンドポイントをインストールする。
構文w4inslcf.pl [-a] [-F] [-g gateway_label[+port]] [-I] [-l endpoint_port] [-Lconfig_options] [-N code] [-P] [-s dir_name] [-v] [-T ip_address] [-Y] {endpoint... | -ffile_name}
説明w4inslcf.pl コマンドは、1 つ以上の iSeries システムに AS/400 エンドポイント・デーモン・ジョブをインストールして、(オプションで) 始動します。マシン名をコマンド行でリストするか、マシン名が入っているファイルを指定することによって、複数のエンドポイントをインストールできます。ファイルには、1 行当たり 1
つのシステム名が入っている必要があります。
このコマンドは、前提条件を検査し、FTP を使用してコードをインストール先のエンドポイントに送信した後で、RSTLICPGM コマンドを使用して、AS/400 にプロダクト 1TMELCF を復元します。要求により、AS/400 の STRTMEEPT コマンドを発行してエンドポイントを開始することもできます。
オプション-a エンドポイントの非同期インストールを指定します。デフォルトでは、この
コマンドは、エンドポイントがゲートウェイにログインするまで待ってから、次のエンドポイントをインストールします。
-f file_name
エンドポイントのインストール先のシステムのリストが入っているファイルを指定します。このファイルには、1 行に 1 つずつのシステム名が含まれていて、使用するユーザー ID とパスワードが指定されています。このファイルの各行の形式は次のとおりです。
host [userID [password]]
-F 既存のインストールへの上書きを強制実行します。
-g gateway_label[+port]
IP アドレスあるいはホスト名を指定します。また、任意で、エンドポイントがログインするゲートウェイのポート番号を指定します。
-I エンドポイントをインストールするが、始動はしないことを指定します。
-l endpoint_port
エンドポイントのポート番号を指定します。デフォルトのポート番号は9495 です。
-L config_options
エンドポイントを起動するための構成オプションをデーモンに渡します。複数のオプションを渡すには、それらのオプションを引用符で囲みます。有効なオプションのリストについては、lcfd コマンドを参照してください。
86 Tivoli Management Framework: リファレンス・マニュアル
-N code
サポートする追加言語を AS/400 コードで指定します。該当のコードは、2980 (ブラジル・ポルトガル語)、2989 (中国語 (簡体字))、2924 (英語、大文字および小文字)、2938 (英語大文字)、2928 (フランス語)、2929 (ドイツ語)、2932 (イタリア語)、2962 (日本語)、2986 (韓国語)、および 2931 (スペイン語) です。複数の言語を指定するには、それらの言語を引用符で囲みます。デフォルト値は 2924 と 2938です。
-P ユーザーにパスワードの入力を求めるプロンプトを出すことを指定します。このオプションは、自動ログインのために使用される $HOME/.netrc ファイルの既存エントリーを指定変更します。
-s dir_name
エンドポイント・インストール・イメージが入っているディレクトリーを指定します。このディレクトリーは、コンパクト・ディスク (CD)、Tivoli サーバー、ゲートウェイ、ネットワーク・ドライブのいずれでも構いません。
-T ip_address
管理対象ノードのインストールの際に使用する IP アドレスを指定します。このオプションは、コマンドを実行するマシンが複数のネットワーク・インターフェース・カード (NIC) を使用していて、なおかつデフォルト以外のネットワーク・インターフェース・カードを使用してインストールしたい場合にのみ必要となります。
-v 詳細メッセージを標準出力に書き込みます。エラー・メッセージは、これまで同様、標準エラー出力に書き込まれます。
-Y 確認をせずにインストールを進めることを指定します。デフォルトでは、確認を要求するメッセージが表示されます。
endpoint...
エンドポイントのインストール先の iSeries システムの名前または IP アドレスを指定します。
権限エンドポイントをインストールするには root アクセスが必要ですが、Tivoli の許可の役割は不要です。 iSeries システムでは、RSTOBJ コマンドと RSTLICPGM コマンドの使用権限、および *SAVSYS 特殊権限が必要です。
戻り値次のいずれかを戻します。
0 正常に終了したことを示します。
-1 エラーが原因で障害が発生したことを示します。
注: インストールが失敗した場合は、ホスト名は os4LcfH.err に書き込まれます。これらのホスト名は、コマンドに -f os4LcfH.err コマンド・オプションを指定して実行することにより、このコマンドで再試行できます。
w4inslcf.pl
第 3 章 コマンド (アルファベット順) 87
例1. 次の例では、AS/400 エンドポイントを iSeries システム as41.tivoli.com および
as42.tivoli.com にインストールし、ポート 9494 を使用してゲートウェイsmithers.tivoli.com に接続します。インストール・イメージは /cdrom/1tmelcf ディレクトリーにあります。
w4inslcf.pl -v -g smithers.tivoli.com+9494 as41.tivoli.comas42.tivoli.com -s /cdrom/1tmelcf
2. 次の例では、AS/400 エンドポイントを iSeries システム as 42.tivoli.com にインストールし、ポート 9494 を使用してゲートウェイ smithers.tivoli.com に接続し、フランス語およびドイツ語の言語サポートをインストールします。
w4inslcf.pl -v -g smithers.tivoli.com+9494 -N ’2928 2929’as42.tivoli.com
3. 以下の例では、インストールされているコンピューター・システムが iSeries システム cheese.dev.tivoli.com 上にエンドポイントをインストールする際に、IP アドレス 146.84.36.37 のネットワーク・インターフェース・カードを使用し、そのAS/400 エンドポイントが IP アドレス 146.84.36.42 とポート番号 8752 を使用してゲートウェイにログインし、ゲートウェイが IP アドレス 146.84.39.126 とポート番号 18752 を使用してエンドポイントと通信するようにします。エンドポイント・ラベルは、queso です。
w4inslcf.pl -T 146.84.36.37 -g 146.84.36.42+8752 -l 18752-L ’local_ip_interface=146.84.39.126 lcs.machine_name=queso’cheese.dev.tivoli.com
w4inslcf.pl
88 Tivoli Management Framework: リファレンス・マニュアル
waddicon
Windows Program Manager グループにアイコンを追加します。
構文waddicon -g group_name [-a] [-c ″command_line″] [-i icon_file] [-m ″message″] [-r]
[-t icon_title]
説明waddicon コマンドは、Windows Program Manager グループに新しいアイコンを追加します。グループが存在しない場合は、作成されます。このコマンドが Windows
サービス・エージェントからのバッチとして立ち上げられる場合は、作成されたプログラム・グループは共通プログラム・グループとなります。このコマンドがWindows コンソール・エージェントからの立ち上げられる場合は、作成されたプログラム・グループはユーザー・プログラム・グループとなります。
オプション-a ユーザーがログインしていないコンピューターに配布されるバッチ・ファイ
ルの場合のように、このコマンドを非同期で使用することができます。このコマンドが実際に実行されるのは、ユーザーがコンピューターにログインするときです。このオプションを指定する場合は、このコマンドをバッチ・ファイルで使用する必要があります。このオプションは、Windows オペレーティング・システム でサポートされます。
-c ″command_line″アイコンで呼び出すコマンド行を指定します。
-g group_name
アイコンを追加するプログラム・グループ名を指定します。
-i icon_fileアイコンを含むファイルを指定します。このオプションを指定しないと、Program Manager は -c オプションで指定された実行可能ファイルを調べます。
-m ″message″-a オプションと共にこのコマンドを使用する時エラーが発生した場合には、メッセージを waddicon.err ファイルに書き込むように指定します。このオプションは、Windows オペレーティング・システムでのみサポートされます。
-r 指定したアイコンを削除します。アイコンを指定しないと、そのプログラム・グループ全体を削除しようとします。
-t icon_title
Program Manager のアイコンの下に表題 (説明) を指定します。
戻り値次のいずれかを戻します。
0 アイコンが正常に追加されたことを示します。
第 3 章 コマンド (アルファベット順) 89
non-zero
アイコンの追加に失敗したことを示します。
例1. 以下の例は、ワード・プロセッサー・アプリケーションの「Word Processor
(ワード・プロセッサー)」アイコンを「 Applications (アプリケーション)」プログラム・マネージャー・グループに追加します。
waddicon -g "Applications" -c ¥WP¥WPROCESS.EXE -t "Word Processor"
2. 以下の例は、「Applications (アプリケーション)」グループから「WordProcessor (ワード・プロセッサー)」アイコンを除去します。
waddicon -g "Applications" -c ¥WP¥WPROCESS.EXE -t "Word Processor" -r
3. 以下の例は、「Applications (アプリケーション)」グループを除去します。
waddicon -g "Applications" -r
4. 以下の例は、ユーザーのデスクトップ (Windows ワークステーション上の) にアイコンを追加して、バッチ・ファイルに次のコマンドを組み込み、そのファイルをコンピューターに配布します。エラーが発生すると、-m オプションの後に続くメッセージが WADDICON.ERR ファイルに書き込まれます。
c:¥tivoli¥tmeagent¥win32¥cli¥waddicon -c "C:¥FILES¥MY_PROG.EXE" ¥-t "My Program" -m "Call #1 of waddicon" -a
waddicon
90 Tivoli Management Framework: リファレンス・マニュアル
waddpath
現行コントロール・セットのレジストリー・ハイブ内のパス・ステートメントにエントリーを追加します。このコマンドはエンドポイントから実行する必要があります。(Windows 2000 のみ)
構文waddpath path_value
説明waddpath コマンドは、HKEY_LOCAL_MACHINE レジストリー・ハイブ内のWindows の ¥SYSTEM¥CurrentControlSet¥Control¥SessionManager¥ Environment キー・パスにエントリーを追加します。エントリーを追加すると、他のアプリケーションがそのアプリケーションの検索パスを使用できるようになります。
このコマンドは、正常に完了したか、エラーが発生したかを示すメッセージを戻します。
オプションpath_value
現行コントロール・セットのレジストリー・ハイブに追加するパス項目を指定します。
権限admin
例¥APPS¥MISC¥EXEC ディレクトリー・パスをレジストリー・ハイブに追加する場合は、次のコマンドを入力します。
waddpath ¥APPS¥MISC¥EXEC
第 3 章 コマンド (アルファベット順) 91
wadminep
エンドポイントに対する管理操作を実行します。
構文wadminep -h
wadminep endpoint_name wake_up
説明wadminep コマンドは管理対象ノードから実行されますが、サポートされるすべてのエンドポイント・プラットフォームを管理します。このコマンドを使用して、Wake-On-LAN 操作のためのエンドポイント・ウェイクアップ・パケットを生成します。 Wake-On-LAN サポートを使用可能にするには、lcfd コマンドで-w オプションを使用します。デフォルトでは、Wake-On-LAN はエンドポイント上では使用可能ではありません。
オプション-h 使用できるすべてのコマンド・オプションをリスト表示した詳しい使用方法
を表示します。
wake_upネットワークの wake-up パケットを、指定したエンドポイントにブロードキャストします。
endpoint_name
コマンドを実行するエンドポイントの名前を指定します。
権限エンドポイントの root または Administrator の特権で super の役割が必要です。リソースがポリシー・リージョンであり、エンドポイントがそのポリシー・リージョンに属する場合にのみ、役割をリソースに固有なものにすることができます。
例以下の例は、エンドポイント pine 用のエンドポイント・ウェイクアップ・パケットを生成します。
wadminep pine wake_up
参照lcfd, winstlcf
92 Tivoli Management Framework: リファレンス・マニュアル
wauthadmin
Tivoli リージョン内の Tivoli root アドミニストレーターを追加、取り消し、または表示します。
構文wauthadmin -a administrator
wauthadmin -r administrator
wauthadmin -l [-v]
説明wauthadmin コマンドは、Tivoli アドミニストレーター・アカウントの管理において次の 2 つの役割を果たします。
v Tivoli リージョン内のすべての root アドミニストレーターをリストします。
v 既存の root アドミニストレーターは、root 権限の付与および取り消しを許可します。
Tivoli サーバー をインストールすると、root アドミニストレーターという名前の初期の Tivoli アカウントが作成されます。このアカウントは、システムのアクセスおよび管理について、完全で制限のない特権を持ちます。 UNIX オペレーティング・システムでは、Tivoli root アドミニストレーター・アカウントは UNIX root アクセス権を持ち、Windows オペレーティング・システムでは Tivoli root アドミニストレーター・アカウントはアドミニストレーター・アクセス権を持ちます。wauthadmin コマンドにより、root アドミニストレーターに、既存の Tivoli アドミニストレーターを root アドミニストレーターにプロモートする権限を与えることができます。
プロモート対象のアドミニストレーターは、ローカル Tivoli リージョンで少なくとも 1 つのグローバルな許可の役割をもっていなくてはなりません。root アドミニストレーターからすべてのグローバル役割を除去すると、このアドミニストレーターの root 権限は取り消されます。
また、wauthadmin コマンドは、root アドミニストレーター・アカウントから root
権限を削除します。ただし、Tivoli リージョンごとに少なくとも 1 つの root アドミニストレーターを保持していなければなりません。
-l オプションを指定すると、コマンドは、ローカル Tivoli リージョンで root 権限を所有する Tivoli アドミニストレーターのリストを表示します。
オプション-a administrator
指定したアドミニストレーターに root 権限を追加します。
-l ローカル Tivoli リージョン内の root アドミニストレーターであるアドミニストレーターをリストします。
第 3 章 コマンド (アルファベット順) 93
-r administrator
指定されたアドミニストレーターから root 権限を取り消します。
-v リストされた root アドミニストレーターに関する詳細情報を提供します。このオプションは、-l オプションとともに指定してください。
権限root アドミニストレーターだけが root 権限を付与または取り消せますが、 root アドミニストレーターのリストを表示するには user が必要です。
例1. 次の例は、ローカル Tivoli リージョン内のアドミニストレーター kimiko@ohio
に root 権限を付与します。
wauthadmin -a kimiko@ohio
2. 次の例は、ローカル Tivoli リージョン 内の root アドミニストレーターの冗長で、詳細なリストを表示します。
wauthadmin -l -v
参照wgetadmin, wsetadmin
wauthadmin
94 Tivoli Management Framework: リファレンス・マニュアル
wbkupdb
Tivoli オブジェクト・データベースのバックアップと復元を行います。
構文wbkupdb -e [node_name...]
wbkupdb -e -l [object node_name...]
wbkupdb [-b] [-d device] [-f] [-h node_name] [node_name...]
wbkupdb -l [-d device] [-f] [-h node_name] [object node_name...]
wbkupdb -d device -r [-R] [node_name...]
wbkupdb -d device -r -l [-R] [object node_name...]
wbkupdb -s
説明wbkupdb コマンドは、Tivoli オブジェクト・データベースのバックアップおよび復元を行います。 wbkupdb コマンドには、オプションとして、管理対象ノード名のリストを指定できます。ノード・オプションを指定しないと、wbkupdb コマンドは Tivoli リージョン内のすべての管理対象ノードについて Tivoli オブジェクト・データベースのバックアップまたは復元を行います。
注: ご使用の Tivoli リージョンの活動レベルが高いために、全バックアップをとれない場合には、 wlocktmr コマンドを使用して、Tivoli リージョンを保守モードにおき、それからもう一度 wbkupdb コマンドを実行することができます。Tivoli リージョンを保守モードにすることの詳細については、「Tivoli
Management Framework 保守およびトラブルシューティング・ガイド」を参照してください。
-e オプションを使用すると、バックアップ・アーカイブの合計サイズの見積もりがでます。 wbkupdb -e コマンドは、各管理対象ノードのバックアップのサイズと、アーカイブの合計サイズを見積もります。このレポートは見積もりですが、バックアップ・イメージの実際のサイズに非常に近い値です。
このコマンドの (構文中に示されている) 3 番目の形式と 4 番目の形式は、データベースのバックアップを作成して、指定されたファイルまたは指定されたシステム上の装置に格納します。バックアップ・ファイルがすでに存在し、それがディスク・ファイルの場合は、 -f オプションを指定して古いバックアップ・ファイルを上書きする必要があります。
-r オプションを使用すると、Tivoli オブジェクト・データベースが復元されます。これは主に、バックアップした Tivoli オブジェクト・データベースの、以前保管したコピーを戻す場合に使用します。復元する Tivoli サーバーまたは管理対象ノードは、 Tivoli Management Framework が動作可能でなければなりません。 Tivoli サーバー以外のシステムから復元を実行する場合は、-R オプションを指定しないと、Tivoli サーバーとローカル・データベースの両方を復元することはできません。ロ
第 3 章 コマンド (アルファベット順) 95
ーカル・データベースを復元する場合は、明示的な node_name 構文を使って最後にローカル・ノードを指定するか、 -R オプションを指定する必要があります。
復元するオブジェクト・ディスパッチャーが実行されていない (おそらく、データベースが破壊されているか欠落しているために実行できない) 場合には、データベースを手動で抽出し、データベース・ディレクトリーの正しい場所にファイルを書き込むことができます。
wbkupdb コマンドでは、ファイルの旧バージョンと通知データベースの保管も行われます。一度読んだ通知をもう一度読む必要があることは少ないので、一般的にはこれらの復元は行われません。なんらかの理由でファイルが破壊された場合は、復元できます。¥files_versions ディレクトリーは復元されません。システム・ファイルの古いリビジョンを見る必要がある場合は、必要に応じて ¥files_versions.restore
ディレクトリーからファイルを移動できます。
次のリストは、UNIX および Windows 管理対象ノードおよび Tivoli サーバー上の一時ディレクトリーにバックアップされたファイルおよびデータベースを詳細にリスト表示します。
v UNIX 管理対象ノードの場合、回復されるファイルは次のものです。
– odb.bdb.restore
– odb.adj.restore
– odb.log.restore
– ¥file_versions.restore (ディレクトリー)
v UNIX Tivoli サーバー の場合、回復されるファイルは次のものです。
– odb.bdb.restore
– odb.log.restore
– imdb.bdb.restore
– notice.bdb.restore
– notice.log.restore
– odlist.dat.restore
– ¥epmgr.bdb.restore (ディレクトリー)
– ¥file_versions.restore (ディレクトリー)
v Windows 管理対象ノードの場合、回復されるファイルは次のものです。
– odb.bdb
– odb.adj
– odb.log
– ¥file_versions (ディレクトリー)
v Windows Tivoli サーバー の場合、回復されるファイルは次のものです。
– odb.bdb
– odb.log
– imdb.bdb
– notice.log
– odlist.dat
wbkupdb
96 Tivoli Management Framework: リファレンス・マニュアル
– ¥epmgr.db (ディレクトリー)
– ¥file_versions (ディレクトリー)
オプション-b バックアップ最中の、Tivoli オブジェクト・データベースへのデータの書き
込みをブロックします。このオプションを指定した場合、オブジェクト・ディスパッチャーはデータベースのバックアップ中にデータを Tivoli オブジェクト・データベースに書き込みません。バックアップ操作の完了後、バックアップ操作中にキューに入れられたすべての書き込み操作の対象データは、データベースに書き込まれます。たとえば、非常にビジーな Tivoli 環境などで、バックアップの最中に Tivoli オブジェクト・データベースが変更されないようにしたい場合は、-b オプションを利用します。 -b オプションを利用して、この機能が含まれている Tivoli Management Framework
のバージョンにアップグレードされていないノードをバックアップする場合、そのノードには標準のバックアップ・メソッドが使用されます。
-b オプションを指定すると、バックアップ操作はバックアップを実行する前に、必要なディスク・スペースを検査します。使用可能なディスク・スペースが十分に無い場合、警告メッセージが表示されます。
注: 必要なディスク・スペースは、odb.bdb と imdb.bdb の合計サイズの 2
倍を算出することで推定します。環境によっては、この推定量が少なすぎる場合があります。このような場合、TIVBACKUPSIZE 環境変数を設定することで、-b オプションによって算出された推定量を指定変更することができます。 TIVBACKUPSIZE の値は KB で設定してください。Windows オペレーティング・システムでは、TIVBACKUPSIZE はシステム環境変数でなくてはなりません。
このオプションを指定すると、オブジェクト・ディスパッチャーはバックアップの結果のエラー・メッセージを oservlog ファイルに書き込みます。
-d device
バックアップ・ファイルの保管先のファイルまたは装置、あるいはバックアップ・ファイルの取り出し元のファイルまたは装置を指定します。ファイル名を指定する場合は、%t 変数を追加することによって、ファイル名の任意の位置にファイルの日時を挿入できます。この変数は、Mondd-hhmm 形式のタイム・スタンプによって置き換えられます。たとえば、-d
/usr/backups/TMR1%t.bk と指定すると、生成されるファイルの名前はTMR1Dec21-0955.bk になります。時刻は 24 時間制で表示されます。
-e バックアップのサイズを見積もります。
-f 同じ名前の古いバックアップ・ファイルを上書きします。
-h node_name
wbkupdb コマンドによって作成された .tarファイルが格納されているシステムを指定します。デフォルトは Tivoli サーバーです。
-l コマンド行のオプションがオブジェクトおよびラベルの対であることを指定します。このオプションは、内部使用専用です。
-r 指定したノードのデータベースを復元します。
wbkupdb
第 3 章 コマンド (アルファベット順) 97
-R データベース・ファイルを復元した後、オブジェクト・ディスパッチャーを再始動しません。 .restore という名前のいくつかのファイルがデータベース・ディレクトリーに格納されます。変更内容を有効にするには、odadminコマンドの reexec オプションまたはその派生コマンドのうちのひとつを使用してオブジェクト・ディスパッチャーを再始動し、データベースの復元されたコピーをディスパッチャーが取得できるようにします。
-s バックアップするそれぞれの管理対象ノードで、初期デスクトップ・メッセージを表示しません。
node_name
バックアップ対象のノードを指定します。ノードは複数指定できます。
object バックアップ・オブジェクト ID を指定します。
権限バックアップを作成するには Tivoli リージョン内の backup 役割が必要です。
バックアップから復元するには、Tivoli リージョン内の restore 役割が必要です
デフォルトのバックアップ・ディレクトリーは、root 書き込み権限を必要とします。root アドミニストレーターとしてログインするか、バックアップ・ファイルの位置を変更してください。「レスキュー」操作を実行する場合は、破損したデータベースが配置されているマシンに root としてログインしている必要があります。
例1. 以下の例は、Tivoli リージョン内のすべての管理対象ノードについて Tivoli オブジェクト・データベースをバックアップし、そのバックアップを/usr/backups/TMR1.bk ファイルに書き込みます。
wbkupdb -d /usr/backups/TMR1.bk
2. 次に示す例は、管理対象ノード sherman のデータベースをバックアップします。バックアップを指定しなかったので、バックアップは $DBDIR/backups ディレクトリーに書き込まれます。
wbkupdb sherman
3. 以下の例は、/usr/backups/TMR1.bk バックアップ・ファイルを使用してデータベースを管理対象ノード sherman に復元します。
wbkupdb -r -d /usr/backups/TMR1.bk sherman
参照wchkdb, wclient, winstall, wpatch, wserver
wbkupdb
98 Tivoli Management Framework: リファレンス・マニュアル
wbindmsg
ローカル・メッセージ・カタログから変換されたストリングを検索し、変数をバインドします。
構文wbindmsg catalog_name message_number default_string [options...]
説明wbindmsg コマンドは、指定されたメッセージ・カタログから、指定のメッセージ番号に対応するメッセージを検索します。現行言語環境で指定されたメッセージ・カタログから指定のメッセージを検索できない場合は、default_string を使用されます。 wbindmsg は必ず、指定のメッセージ・カタログのセット 2 の中で、指定のメッセージを探します。
wbindmsg コマンドは、LANG 環境変数と NLSPATH 環境変数を使用して、現行言語環境に適したメッセージ・カタログを検索します。たとえば、LANG が fr_FR
に等しく、NLSPATH が/tivoli/msg_cat/%L/%N.cat;/tivoli/msg_cat/%1%N.cat;/tivoli/msg_cat/C/%N.cat
に等しい場合、wbindmsg コマンドは以下のパス名を使用してメッセージ・カタログを検索しようとします。
/tivoli/msg_cat/fr_FR/catalog_name.cat
/tivoli/msg_cat/fr/catalog_name.cat
/tivoli/msg_cat/C/catalog_name.cat
メッセージの検索とバインドが終わったあとで、結果のストリングが標準出力に書き込まれます。
オプションcatalog_name
メッセージ・カタログのベース名を指定します。
message_number
メッセージ・カタログ内のメッセージ番号を指定します。
default_string
メッセージ・カタログからメッセージを検索できなかった場合に使用するストリングを指定します。
[options...]
メッセージのフォーマット・ディレクティブの位置にバインドするオプションを指定します。
例次の例では、my_catalog.cat というメッセージ・カタログから 2 番目のメッセージを検索します。デフォルト・ストリングは、英語バージョンのメッセージと同じで、2 つのオプション jross および polyglot が含まれています。
第 3 章 コマンド (アルファベット順) 99
wbindmsg my_catalog 2 ¥"User %1¥$s does not have an account on %2¥$s" jross polyglot
User jross does not have an account on polyglot.
wbindmsg
100 Tivoli Management Framework: リファレンス・マニュアル
wbroadcast
すべての Tivoli デスクトップにメッセージをブロードキャストします。
構文wbroadcast [optional_text]
説明wbroadcast コマンドは、標準入力からメッセージを読み取って、それを Tivoli 環境内の各 Tivoli デスクトップにブロードキャストします。 optional_text オプションを使用すると、標準入力ではなく、指定したテキストがすべてのデスクトップにブロードキャストされます。
オプションoptional_text
ブロードキャストの対象テキストを指定します。
権限admin、senior、super
例次の例は、典型的なブロードキャスト・メッセージです。
wbroadcast << EOFRestoring database in 5 minutes. Exit your desktop.EOF
第 3 章 コマンド (アルファベット順) 101
wcatcher
Tivoli Enterprise アプリケーションをアップグレードする前にカスタム・ダイアログを保管します。
構文wcatcher -a [-d parent_dir] [-s sub_dir] [-v]
wcatcher -r resource... [-d parent_dir] [-s sub_dir] [-v]
説明wcatcher コマンドは、Tivoli Enterprise アプリケーションをアップグレードする前にカスタム・ダイアログを保管します。カスタム・ダイアログの例として、テキスト・フィールドやボタンを追加したダイアログなどがあります。
たとえば、Tivoli Enterprise の新バージョンへのアップグレードを準備している場合、このコマンドを使ってカスタム・ダイアログを保管します。アップグレード後に、wmrgaef コマンドを使用して、カスタム・ダイアログを新バージョンに再適用してください。
wcatcher コマンドは、各カスタム・ダイアログとそれに対応するオリジナルのダイアログを、-d オプションで指定されたディレクトリー構造に格納します。wcatcher コマンドは、custom.sav というディレクトリーを作成し (ただし、-s オプションで別の名前を指定した場合は除く)、指定されたそれぞれのリソース・タイプを検索してカスタム・ダイアログを探します。各ダイアログのカスタム・バージョンとオリジナル・バージョンが、custom.sav ディレクトリーの下のサブディレクトリー (名前はリソースと同じ) に保管されます。インスタンスごとにカスタマイズされたダイアログは、ラベル・インスタンスの名前を付けたディレクトリーに保管されます。
オプション-a 登録されたすべてのリソースでカスタム・ダイアログを検索します。
-d parent_dir
各カスタム・ダイアログとそれの対応するオリジナル・バージョンの保管先である親ディレクトリーへのパスを指定します。パスを指定しないと、コマンドは、情報を現行作業ディレクトリーに書き込みます。
-r resource
特定のリソース・タイプを検索します。コマンド行には複数のリソース・タイプを指定できます。それぞれのリソース・タイプごとに -r を指定する必要があります。
-s sub_dir
各カスタム・ダイアログとそのオリジナル・バージョンの保管先ディレクトリー名を指定します。ディレクトリー名を指定しないと、コマンドはcustom.sav ディレクトリーを作成します。
-v 冗長出力を指定します。
102 Tivoli Management Framework: リファレンス・マニュアル
権限super
例次のコマンドは、すべてのカスタム・ダイアログを検索して、ファイルを/tmp/aef/my.dir ディレクトリーに保管します。
wcatcher -d /tmp/aef -s my.dir
参照wmrgaef
wcatcher
第 3 章 コマンド (アルファベット順) 103
wcd
現行の作業コレクションを変更します。
構文wcd [label]
説明wcd コマンドは、現行の作業コレクション・オブジェクトを、ラベル・パスで指定されたコレクション・オブジェクトに変更します。各アドミニストレーターは、親プロセス ID ごとに現在の作業コレクションをもっています。
オプションlabel 新しい作業コレクションを指定します。指定するオブジェクトは、コレクシ
ョン・オブジェクトまたはポリシー・リージョンでなければなりません。このオプションには、完全ラベル・パス (‘/’ コレクションで始まる) または部分ラベル・パス (現行の作業コレクションを基準とする) のいずれかを指定できます。このオプションを省略すると、作業コレクションはホーム・コレクションに変更されます。アドミニストレーターごとのホーム・コレクションは、/Administrators/name です (name はアドミニストレーターのプリンシパル名)。
権限user、admin、senior、super
例1. 次に示す例は、現行の作業コレクションをポリシー・リージョン ceridwen-region
に変更する例です。
wcd /Regions/ceridwen-region
2. 次に示す例は、現行の作業コレクションをオブジェクト・データベース・ディレクトリーに変更する例です。
wcd $DBDIR
参照wls, wpwd
104 Tivoli Management Framework: リファレンス・マニュアル
wchdep
依存関係セットをメソッド・ヘッダーに関連付けます。
構文wchdep @Classes:class_name dependency_set method_name ...
wchdep -g @Classes:class_name method_name
説明wchdep コマンドは、依存関係セットを特定のメソッド・ヘッダーに関連付けます。 wchdep コマンドを使用してメソッド・ヘッダーを依存関係セットに関連付ける前に、 wdepset コマンドの -c オプションを使用して依存関係を作成する必要があります。
1 つの依存関係セットのみを各メソッドに関連付けられますが、さらに依存関係セットをネストさせたり、wdepset コマンドの -e オプションを使用して既存の依存関係セットに追加することができます。
wchdep コマンドの -g オプションは、依存関係セットのオブジェクト ID (OID)
を戻します。 OID は wdepset コマンドと共に使用できるので、依存関係セットのラベルを検索する必要はありません。
wchdep コマンドは、オブジェクト・データベースの afterscript 内またはアプリケーションの .ist ファイル内に通常置かれます。
オプション-g 依存関係セットの OID を戻します。
@Classes:class_name
依存関係クラス・オブジェクトの名前です。
dependency_set
wdepset コマンドと関連付けられたラベルです。依存関係は、@DependencyMgr:label というフォーマットのラベルとして、または OID
として指定できます。
method_name
依存関係メソッドがサポートするメソッドの名前です。
権限user
例次の例は、hello_dependency 依存関係セットを、Hello 依存関係クラス・オブジェクト内の hello_method メソッドに関連付けます。
wchdep @Classes:Hello hello_dependency hello_method
第 3 章 コマンド (アルファベット順) 105
参照wdepset
wchdep
106 Tivoli Management Framework: リファレンス・マニュアル
wchkdb
Tivoli データベースを検証して修復します。
構文wchkdb [-o outfile] [-t] [-u] [-x] -f infile
wchkdb [-o outfile] [-t] [-u] [-x] -i
wchkdb [-o outfile] [-t] [-u] [-x] object...
説明wchkdb コマンドは、Tivoli データベースの問題を検査し、修復します。このコマンドは Tivoli リージョン環境内のリソースを変更するだけなので、システム・ファイルには影響しません。
-u オプションを指定しないと、wchkdb は、データベースの検査と、標準出力 (-oオプションを指定した場合は出力ファイル) への矛盾個所の書き込みだけを行います。その後、この出力ファイルを -u および -f オプションを使って wchkdb に渡し、矛盾を修正することができます。
-u オプションはデータベースの矛盾を検索して修正しようとします。 -f オプションを指定すると、以前に実行した wchkdb によって生成された出力ファイルから、入力が読み取られます。 infile 内のすべてのオブジェクトが検査されます。 -i オプションを指定すると、標準入力からオブジェクトのリストが読み取られます。また、コマンド行にオブジェクトのリストを指定することもできます。入力オプションもオブジェクト参照子も指定しないと、データベース内のすべてのオブジェクトが検査されます。
-x オプションを指定すると、Tivoli リージョンの境界を越えて検査することができます。このオプションを指定しないと、現行のリージョン内のリソースだけが検査、修復されます。
高活動の Tivoli 環境では、Tivoli 管理リージョン (TMR) を保守モードに置き、すべてのアクティブな Tivoli プロセスを停止するほうが利点があることがあります。Tivoli リージョンを保守モードにすることの詳細については、「Tivoli Management
Framework 保守およびトラブルシューティング・ガイド」を参照してください。
オプション-f infile
指定された入力ファイル (前のデータベース検査で作成されたファイル) を読み取って、そのファイル内にリストされているオブジェクトだけを検査します。このファイルには、以前の実行時に矛盾が検出されたオブジェクトだけが記録されています。
-i 標準入力からオブジェクトのリストを読み取ります。このリストは、オブジェクト ID、オブジェクト名、あるいはその両方 (スペースで区切る) から成ります。
第 3 章 コマンド (アルファベット順) 107
-o outfile
表示した出力のバイナリー・バージョンを、指定されたファイル名に書き込みます。
-t Tivoli サーバー・データベース内にあるオブジェクト参照子のみを検査して修復します。
-u データベースを更新し、Tivoli リソース・データベースで検出された矛盾をすべて修正します。
-x リージョンの境界を越えて、オブジェクト参照子の検査と修復を行います。
object...
検査、修復対象のオブジェクト ID またはオブジェクト名を指定します。
権限senior または super
戻り値0 操作が正常に開始されたことを示します。
ゼロ以外構文エラーがあるかまたはオブジェクト・ディスパッチャーが使用可能でないために、操作が正常に開始されなかったことを示します。
例1. 次に示す例は、Tivoli データベースを検査し、必要に応じて修復を行う例です。オブジェクト参照子の検査は、Tivoli リージョンの境界を越えて行われます。
wchkdb -u -x
2. 次に示す例は、現行の Tivoli リージョンだけでオブジェクト参照子を検査する例です。 Tivoli データベースの変更は行われません。ただし、問題は標準出力に表示され、バイナリー出力ファイル /tmp/check.out に書き込まれます。
wchkdb -o /tmp/check.out
3. 次に示す例は、以前に実行した wchkdb の呼び出しの結果 (/tmp/check.out) を読み取って、必要に応じて Tivoli データベースを更新します。
wchkdb -u -f /tmp/check.out
wchkdb
108 Tivoli Management Framework: リファレンス・マニュアル
wchknode
Tivoli データベースの各部からの特定のディスパッチャー番号への参照を検証して、更新します。
構文wchknode [-c] [-n] [-s] [-u] [-v] [-x] [dispatcher_num]
説明wchknode コマンドは、Tivoli サーバー上のオブジェクト・データベースを、オブジェクト・ディスパッチャー番号で指定された管理対象ノードのデータベースと同期化します。このコマンドは -n オプションによって Tivoli ネーム・レジストリーを、-c オプションによって Tivoli コレクションを、-s オプションによってサブスクリプション・リストをそれぞれ検証します。これらのオプションのいずれも指定されないと、wchknode コマンドはこれらすべてのデータベースを検査します。
-u オプションが指定されると、wchknode コマンドは dispatcher_num へのすべての参照を更新します。このオプションを省略すると、wchknode はすべての参照を検索して、矛盾個所を画面に表示します。ディスパッチャー番号が指定されないと、wchknode コマンドは Tivoli リージョン上のすべての管理対象ノードを検証します。
wchknode コマンドは Tivoli サーバーから実行されます。デフォルトでは、このコマンドはローカル Tivoli リージョンでのみ実行されます。接続された Tivoli リージョン内のリソースを検査するには、-x オプションを使用します。
wchkdb 全体を実行する時間がない場合は、管理対象ノードまたはディスパッチャーのデータベースを復元した後で、wchknode を実行してディスパッチャー番号への参照を検証してください。
注: wchknode コマンドは、接続されて通信状態にある管理対象ノードでのみ呼び出してください。ダウンしている管理対象ノードでこのコマンドを呼び出すと、管理対象ノードは Tivoli データベースから削除されます。またこのコマンドを、管理対象ノードのターゲット・ディスパッチャー番号を指定せずに呼び出さないでください。このコマンドをターゲットを指定せずに発行すると、ダウンした oserv がある管理対象ノードは、Tivoli データベースから削除されます。
オプション-c Tivoli コレクション内の dispatcher_num への参照を検証します。
-n Tivoli ネーム・レジストリー内の dispatcher_num への参照を検証します。
-s サブスクリプション・リスト内の dispatcher_num への参照を検証します。
-u 検証中に見つかった矛盾個所をすべて更新します。省略すると、コマンドは、すべての矛盾個所を画面に表示します。
-v 冗長メッセージを画面に表示します。
-x Tivoli リージョンの境界を越えて dispatcher_num への参照を検証します。
第 3 章 コマンド (アルファベット順) 109
dispatcher_num
検証対象の管理対象ノードのディスパッチャー番号を指定します。正しいディスパッチャー番号を確認するには、odadmin odlist コマンドを使用します。
権限Tivoli リージョン内の senior または super
例1. 次に示す例は、Tivoli ネーム・レジストリー、Tivoli コレクション、およびサブスクリプション・リスト内で、管理対象ノード yellow (ディスパッチャー 7) に対するすべての参照を検証し、更新する例です。この操作は、ローカル Tivoli
リージョンおよび接続されているすべての Tivoli リージョンを検索します。
wchknode -u -x 7
2. 次に示す例は、Tivoli ネーム・レジストリー で管理対象ノード thor (ディスパッチャー 5) への参照を検証する例です。参照は除去されず、画面に表示されます。
wchknode -n 5
参照wchkdb, wrmnode
wchknode
110 Tivoli Management Framework: リファレンス・マニュアル
wchkpol
ポリシーと比較して、ポリシー・リージョンのメンバーを検証します。
構文wchkpol -a [-c collection] [-f file] policy_region_name
wchkpol [-c collection] [-f file] -l label policy_region_name
wchkpol [-c collection] [-f file] -r resource_type policy_region_name
説明wchkpol コマンドは、ポリシー・リージョンのメンバーの全部または一部が、そのリージョンで有効なポリシーに適合しているかどうかを検証します。ポリシー検証に合格しなかった各メンバーについて、標準出力にメッセージが送信されます。 -fオプションを指定すると、出力はログ・ファイルに送信されます。 -c オプションを使用して、ポリシー検証にパスしなかったメンバーのコレクションを作成することができます。
オプション-a ポリシー・リージョンのすべてのメンバーを検証します。
-c collection
ポリシー検証にパスしなかったメンバー用のコレクションを作成します。
-f file ポリシー・チェックにパスしなかったメンバーのリストを保存するログ・ファイルを作成します。
-l label
label で指定されたリソースを検証します。
-r resource_type
ポリシー・リージョンのメンバーのうち、指定されたリソース・タイプのメンバーを検証します。
policy_region_name
検証対象のメンバーが位置するポリシー・リージョンを指定します。
権限admin、senior、super
例1. 次に示す例は、ceridwen-region ポリシー・リージョンのすべてのメンバーについてポリシーの検証を行います。
wchkpol -a /Regions/ceridwen-region
2. 次に示す例は、ceridwen-region ポリシー・リージョン内のすべての管理対象ノードについてポリシー検証を行い、ポリシー検証にパスしなかった管理対象ノードを入れる failures というコレクションを作成します。
wchkpol -c failures -r ManagedNode ceridwen-region
第 3 章 コマンド (アルファベット順) 111
参照wcrtpol, wcrtpr, wdelpr, wgetdfpol, wgetpolm, wlspol, wlspolm, wputpolm
wchkpol
112 Tivoli Management Framework: リファレンス・マニュアル
wci
Revision Control System (RCS) のリビジョンをチェックインします。
構文wci [options] file...
説明wci コマンドは、新しいリビジョンを RCS ファイルに保管します。 RCS サフィックスと一致するパス名は RCS ファイルと見なされます。それ以外はすべて、新しいリビジョンが入っている作業ファイルと見なされます。このコマンドは、各作業ファイルの内容を対応する RCS ファイルに入れます。作業ファイルのみを指定した場合、コマンドは対応する RCS ファイルを RCS サブディレクトリーで検索します。ここで見付からないと、作業ファイルのディレクトリーで検索されます。詳細については、 119ページの『ファイル名』を参照してください。
wci コマンドを実行するには、呼び出し元のログインがアクセス・リストに登録されている必要があります。ただし、アクセス・リストが空の場合や、呼び出し元がスーパーユーザーまたはファイルの所有者である場合は例外です。新規リビジョンを既存のブランチに付加する場合、呼び出し元はそのブランチの先端のリビジョンをロックする必要があります。これを行わないと、新しいブランチを作成することしかできません。 non-strict (非厳密) ロックを使用している場合、ファイルの所有者にはこの制限は適用されません (wrcs を参照)。 wrcs コマンドでは、他のユーザーが保持しているロックを破壊できます。
-f オプションを指定しないと、wci コマンドは格納対象のリビジョンが前のリビジョンと異なるかどうかを調べます。格納対象のリビジョンが前のリビジョンと同じ場合は、新しいリビジョンを作成する代わりに、コマンドは前のリビジョンに戻ります。前のリビジョンに戻る方法は、次のとおりです。
v オプションを指定しないで wci コマンドを使用すると、作業ファイルとすべてのロックが除去されます。
v -l オプションを指定して wci コマンドを実行すると、ロックは保持されて、前のリビジョンで wco コマンドを使用したかのように新規の作業ファイルが生成されます。
v -u オプションを指定して wci コマンドを実行すると、ロックは除去されて、前のリビジョンで wco コマンドを使用したかのように新規の作業ファイルが生成されます。
前のリビジョンに戻るときは、-n オプションと -s オプションが前のリビジョンに適用されます。
wci コマンドは、格納対象のリビジョンごとにログ・メッセージの入力を求めるプロンプトを表示します。ログ・メッセージは、変更内容を要約したもので、EOF またはピリオド (.) だけの行で終わる必要があります。複数のファイルをチェックインする場合は、前のログ・メッセージを再利用するかどうかを確認するプロンプトが表示されます。標準入力が端末でない場合はこのプロンプトは表示されず、すべてのファイルに同じログ・メッセージが使用されます (後述の -m を参照)。
第 3 章 コマンド (アルファベット順) 113
RCS ファイルがない場合、wci コマンドは RCS ファイルを作成し、作業ファイルの内容を最初のリビジョン (デフォルト番号: 1.1) として格納します。アクセス・リストは初期化され、空になります。この場合は、ログ・メッセージの代わりに記述テキストの入力が求められます (後述の -t を参照)。
オプション -f、-I、-k、-l、-M、-q、-r、または -u では、格納対象のリビジョンの番号 rev を指定できます。rev オプションは記号でも数字でもよく、記号と数字を組み合わせて使用することもできます。
v rev に $ を指定すると、作業ファイル内のキーワード値からリビジョン番号が判別されます。
v rev にリビジョン番号を指定する場合は、追加先のブランチの最後の番号より大きい番号を指定するか、新しいブランチを開始してください。
v rev にリビジョン番号ではなくブランチを指定すると、そのブランチに新しいリビジョンが追加されます。レベル番号は、そのブランチの先端のリビジョン番号を増分した値に設定されます。まだ存在しないブランチを rev に指定すると、新たにブランチが作成され、最初のリビジョン番号は rev.1 に設定されます。
v rev を省略すると、wci コマンドは、呼び出し元の最終ロックから新しいリビジョン番号を派生させます。呼び出し元がブランチの先端のリビジョンをロックしていると、新しいリビジョンはそのブランチに追加されます。新しいリビジョン番号は、先端のリビジョン番号を増分した値に設定されます。呼び出し元が先端以外のリビジョンをロックしていると、そのリビジョンから新しいブランチが開始されます。ブランチ番号は、ロックされているリビジョンの最も大きいブランチ番号を増分した値に設定されます。最初のブランチ番号とレベル番号は、デフォルトでは 1 です。
v 呼び出し元がロックを設定していないがファイルは所有しており、ロックがstrict に設定されていない場合に rev を省略すると、リビジョンはデフォルトのブランチ (一般的にはトランク。 wrcs コマンドの -b オプションを参照) に追加されます。
次の例外がトランクにあてはまります。リビジョンを最後に追加することはできますが、挿入することはできません。
wci コマンドで作成された RCS ファイルは、読み取り許可と実行許可を作業ファイルから継承します。すでに存在する RCS ファイルについては、その読み取り許可と実行許可は保持されます。このコマンドでは、RCS ファイルの書き込み許可はどのような場合もすべて無効になります。
オプション-l [rev]
-r と同じ働きをしますが、格納されたリビジョンに対してさらに wco -lも実行する点が異なります。このため、格納されたリビジョンはすぐに再チェックアウトされ、ロックされます。これは、リビジョンを保管し、チェックイン後も編集を続ける場合に便利です。
-r [rev]
リビジョンをチェックインし、対応するロックを解放して、作業ファイルを削除します。これはデフォルトです。
wci
114 Tivoli Management Framework: リファレンス・マニュアル
-r オプションは、wci では通常とは異なる意味を持っています。他の RCS
コマンドでは、-r にはリビジョン番号を指定するだけですが、wci ではロックの除去と作業ファイルの削除も行います。例については、-u のセクションを参照してください。
-u [rev]
-l と同じ働きをしますが、格納されたリビジョンがロックされない点が異なります。このため、チェックイン後ただちに作業ファイルを読み取ることができます。
オプション -l、-r、および -u は相互に排他的で、暗黙的に互いを指定変更します。たとえば、wci -u -r と指定した場合、-r によって -u が指定変更されるので、wci
-r と同じになります。
-d ″[date]″チェックイン日時に date を使用します。date は、wco コマンドの説明にあるとおり、フリー・フォーマットで指定します。これは、チェックイン日付に実際の日付と異なる日付を指定する場合や、-k で日付が分からない場合に便利です。 date を省略すると、作業ファイルを最後に変更した時刻が使用されます。
-f [rev]
強制的に格納します。新しいリビジョンが前のリビジョンと同じ場合でも、新しいリビジョンが格納されます。
-k [rev]
リビジョン番号、作成日、状態、および作成者をローカルに計算するのではなく、作業ファイルでキーワード値を検索して判別し (wco を参照)、格納されたリビジョンに割り当てます。また、呼び出し元のログインと実際のチェックイン日付を示すデフォルトのログイン・メッセージも生成します。このオプションは、ソフトウェアの配布に便利です。複数のサイトにリビジョンを送信する場合は、各サイトで -k オプションを指定してチェックインし、元の番号、日付、作成者、および状態を保存してください。抽出されたキーワード値とデフォルトのログ・メッセージは、オプション-d、-m、-s、-w、および改訂番号を設定するオプションを指定すると、指定変更されます。
-I [rev]
対話モード。標準入力が端末でない場合も、ユーザーに対するプロンプトや質問が出力されます。
-m message
ストリング message を、チェックインしたすべてのリビジョンのログ・メッセージとして使用します。
-M [rev]
新しい作業ファイルの変更時刻を、検索されたリビジョンの日付に設定します。たとえば、wci -d -M -u file と指定した場合、キーワードの置換によって file の内容が変更された場合でもその時刻は変更されません。 makeコマンドで混乱が生じることがあるので、このオプションの使用には注意が必要です。
wci
第 3 章 コマンド (アルファベット順) 115
-n name
記号名 name を、チェックインしたリビジョンの番号に割り当てます。name がすでに別の番号に割り当てられている場合は、エラー・メッセージが出力されます。
-N name
-n と同じ働きをしますが、name の以前の割り当てを指定変更する点が異なります。
-q [rev]
静止モード。診断出力は表示されません。前のリビジョンと同じリビジョンは、-f を指定しない限り、格納されません。
-s state
チェックインしたリビジョンの状態を、ID state に設定します。デフォルトの状態は Exp です。
-t file file の内容から、記述テキストを取り出して RCS ファイルに書き込みます。既存のテキストは削除されます。 file はダッシュ (-) で始めることはできません。
-t string
string から RCS ファイルに記述テキストを書き込みます。既存のテキストは削除されます。
-t オプションは、どちらの形式も、最初のチェックイン時にのみ有効です。それ以外の場合は無視されます。
最初のチェックイン時に -t を指定しないと、 wci コマンドは EOF またはピリオド (.) だけの行で終わるテキストを標準入力から取得します。対話が可能な場合は、テキストの入力を求めるプロンプトがユーザーに対して表示されます。-I を参照してください。
RCS の旧バージョンとの下位互換性を保つ必要があるので、string を指定していない -t は無視されます。
-V n RCS バージョン n をエミュレートします。詳細については、wco コマンドを参照してください。
-w login
格納したリビジョンの作成者フィールドに login を使用します。これは、実際の作成者とは別の作成者を指定する場合や、作成者不明の場合に -k を使用したいときに便利です。
-x suffixes
RCS ファイルのサフィックスを指定します。空でないサフィックスは、そのサフィックスで終わるすべてのパス名と一致します。空のサフィックスは、RCS/file または path/RCS/file という形式のすべてのパス名と一致します。 -x オプションでは、複数のサフィックスをスラッシュ (/) で区切って指定できます。たとえば、,v と空のサフィックスの 2 つを指定する場合は、-x,v/a のように入力します。複数のサフィックスを指定すると、RCS
ファイルの検索時にそれらのサフィックスが順に検索され、最初に適合したサフィックスがそのファイルに使用されます。RCS ファイルが見つからない場合、RCS ファイルが作成可能であれば、サフィックスが順に試され、新しい RCS ファイルの名前が決定されます。 suffixes のデフォルト値はイ
wci
116 Tivoli Management Framework: リファレンス・マニュアル
ンストール環境によって異なります。一般的に、ファイル名にコンマを使用できる UNIX ホストのようなホストの場合は ,v/、それ以外のホストの場合は空 (たとえば、空のサフィックスだけ) です。
UNIX での SETUID の使用RCS アドミニストレーター以外のメンバーによるリビジョンの削除を禁止するため、次のようにして、ユーザー・グループに setuid 特権を設定できます。
v ホストが RCS の setuid の使用をサポートしていることを確認します。不明な点がある場合は、信頼できる専門家に相談してください。 setuid() システム・コールが Posix 1003.1a Draft 5 の記述どおりに機能するのが最善です。この場合、RCS は、実ユーザーが root の場合でも、実ユーザーと有効ユーザーの間の切り換えを簡単に実行できます。次に望ましいのは、setuid() システム・コールが保管された setuid をサポートすることです (Posix 1003.1-1990 の{_POSIX_SAVED_IDS} の動作)。この場合、実ユーザーが root のときだけ異常終了します。 setuid にエラーを検出すると、RCS はただちに終了します。
v ユーザー・グループで RCS アドミニストレーターの役割を果たすユーザーとして、ユーザー Ali を選択します。そのグループのユーザーの RCS ファイルに対して wrcs コマンドを呼び出せるのは、Ali だけになります。 Ali には、root ユーザーや特別な機能を持つユーザーは選択しないでください。また、相互に機密を保持する必要のあるグループで同じユーザーをアドミニストレーターとして選択することのないように、注意してください。
v そのグループのユーザーが実行するファイルのディレクトリーとして、パス名bronte を選択します。
v Ali に bronte をセットアップさせます。このセットアップでは、wci コマンドとwco コマンドの標準インストール・ディレクトリー D からこの 2 つのコマンドをコピーすることにより、Ali の setuid である wci と wco のコピーを bronte
に入れます。
mkdir brontecp D/wc[io] brontechmod go-w,u+s bronte/wc[io]
v 個々のユーザーが、各自のパスの前に bronte を追加するようにします。
PATH=bronte:$PATH; export PATH # ordinary shellset path=(bronte $path) # C shell
v Ali だけが書き込みアクセス権を持つ各 RCS ディレクトリー rambault を Ali に作成させます。
mkdir rambaultchmod go-w rambault
v 特定のユーザーだけに RCS ファイルの読み取りを許可する場合は、それらのユーザーをゲーミング・グループに入れ、次のようにして Ali にさらに RCS ディレクトリーを保護させます。
chgrp gaming rambaultchmod g-w,o-rwx rambault
v Ali に古い RCS ファイル (存在する場合) を rambault にコピーさせて、Ali が確実にこれらのファイルを所有するようにします。
v RCS ファイルのアクセス・リストにより、リビジョンのチェックインとロックが可能なユーザーが制限されます。デフォルトのアクセス・リストは空です。この場合、RCS ファイルを読み取ることができるユーザーすべてにチェックイン・ア
wci
第 3 章 コマンド (アルファベット順) 117
クセス権が与えられます。チェックイン・アクセスを制限する場合は、Ali に、そのファイルに対して wrcs -a Ali を実行させてください。 wrcs を参照してください。たとえば、wrcs -e -a Ali を指定すると、アクセスはを Ali のみに制限されます。
v 新しい RCS ファイルは、最初のチェックインの前に Ali に wrcs -i で初期化させます。チェックイン・アクセスを制限する場合は、-a オプションも指定する必要があります。
v setuid 特権を wci と wco だけに与えます。
v RCS コマンドの呼び出しには、他の setuid コマンドは使用しないでください。
診断wci コマンドは、各リビジョンについて、RCS ファイル、作業ファイル、および格納されたリビジョンと前のリビジョンの両方の番号を表示します。すべての処理が成功した場合にだけ、終了状況が 0 になります。
ファイル作業ファイルが入っているディレクトリーや一時ディレクトリー ( 119ページの『環境変数』の TMPDIR のセクションを参照) に、いくつかの一時ファイルが作成される場合があります。セマフォー・ファイルは、RCS ファイルが入っているディレクトリーに作成されます。サフィックスが空でない場合、セマフォー名はサフィックスの先頭文字で始まります。このため¤先頭文字が作業ファイル名の先頭文字になるようなサフィックスは指定しないでください。サフィックスが空の場合、セマフォー名は下線 (_) で終わります。このため、作業ファイル名の最後には下線を使用しないでください。
wci コマンドで RCS ファイルや作業ファイルが変更されることはありません。一般的に、このコマンドはファイルのリンクを解除して新しいリンクを作成しますが、RCS ファイルへのシンボリック・リンクのチェーンを壊すのではなく、宛先ファイルのリンクを解除します。したがって、このコマンドでは変更対象の作業ファイルへのハード・リンクやシンボリック・リンクはすべて解除されます。RCS ファイルへのハード・リンクは無効になりますが、RCS ファイルへのシンボリック・リンクは保持されます。
有効ユーザーは、RCS ファイルが入っているディレクトリーの検索と書き込みができなければなりません。一般的に、実ユーザーは RCS ファイルと作業ファイルを読み取ることができ、作業ファイルが入っているディレクトリーの検索と書き込みができなければなりません。ただし、旧型のホストの中には、実ユーザーと有効ユーザーを簡単に切り替えられないものもあります。このようなホストでは、すべてのアクセスに有効ユーザーが使用されます。 wci と wco のコピーに setuid 特権が設定されていなければ、有効ユーザーは実ユーザーと同じです。次のセクションで説明するように、有効ユーザーが RCS のファイルとディレクトリーをすべて所有していて、RCS ディレクトリーに書き込むことができるのが有効ユーザーだけの場合には、setuid 特権によってセキュリティーの度合いが高まります。
ユーザーは、RCS ファイルが入っているディレクトリーの許可を設定することによって、RCS ファイルへのアクセスをコントロールできます。そのディレクトリーへの書き込みアクセス権を持っているユーザーだけが、RCS コマンドを使ってそのRCS ファイルを変更できます。たとえば、1 人のユーザーが複数のグループに所属
wci
118 Tivoli Management Framework: リファレンス・マニュアル
できるホストでは、あるグループだけが書き込める RCS ディレクトリーを作成することがあります。この方法は非公式のプロジェクトでは問題ありませんが、グループのメンバーは誰でもそのグループの RCS ファイルを任意に変更でき、ファイル全体を削除することさえ可能です。このため、正式なプロジェクトでは、RCS ファイルを任意に変更できる RCS アドミニストレーターと、新しいリビジョンをチェックインすることはできるがそれ以外の RCS ファイルの変更はできないその他のプロジェクト・メンバーとを区別することがよくあります。
ファイル名RCS ファイルと作業ファイルの組を指定する方法は 3 つあります。
v RCS ファイルと作業ファイルの両方を指定します。 RCS ファイルのパス名の形式は path1/workfileX、作業パス名の形式は path2/workfile です。path1 とpath2 はパス (異なる場合や空の場合もあります)、workfile はファイル名、X はRCS サフィックスです。X が空の場合、path1/ には RCS/ を指定するか、 /RCS/
で終わらなければなりません。
v RCS ファイルだけを指定します。作業ファイルは現行ディレクトリーに作成され、RCS ファイルの名前から path1 とサフィックス X をとった名前が付けられます。
v 作業ファイルだけを指定します。次に wci コマンドは各 RCS サフィックス X
を順に調べて、path2/RCS/workfileXa または (この形式が見付からず、X が空でない場合は) path2/workfileX という形式の RCS ファイルを探します。
1 および 2 でパスを指定せずに RCS ファイルを指定すると、wci コマンドはまずディレクトリー ./RCS で RCS ファイルを探し、次に現行ディレクトリーで探します。
wci コマンドは、特殊な理由で RCS ファイルのオープンに失敗すると、エラーを報告します。RCS ファイルのパス名がエラーの原因になることもあります。たとえば、ディレクトリー dave での RCS コマンドの使用を抑制するには、dave/RCS という名前の通常のファイルを作成します。こうしておくと、dave で RCS コマンドを使用しようとしても dave/RCS がディレクトリーでないため、失敗します。
環境変数RCSINIT
オプション・リストに付加されたオプションで、各引き数はスペースで区切られています。円記号 (¥) を使用すると、オプション内のスペースを拡張できます。 RCSINIT オプションは、ほとんどの RCS コマンドのオプション・リストの前に追加されます。有効な RCSINIT オプションには、-q、-V、および -x があります。
TMPDIR一時ディレクトリーの名前。これを指定しないと、環境変数 TMP およびTEMP が代わりに調べられ、最初に見つかった値が使用されます。どちらも設定されていない場合は、ホストに依存するデフォルト値 (通常は /tmp) が使用されます。
wci
第 3 章 コマンド (アルファベット順) 119
例1. ,v が RCS サフィックスで、現行ディレクトリーのサブディレクトリー RCS に
RCSファイル io.c,v が入っているとします。以下のコマンドはどれも io.ca のコピーを最新のリビジョンとして RCS/io.c,v にチェックインし、io.c を削除します。
wci io.c; wci RCS/io.c,v; wci io.c,v;wci io.c RCS/io.c,v; wci io.c io.c,v;wci RCS/io.c,v io.c; wci io.c,v io.c;
2. また、RCS サフィックスが空のサフィックスで、現行ディレクトリーのサブディレクトリー RCS に RCS ファイル io.c が入っているとします。以下のコマンドはどれも、新しいリビジョンをチェックインします。
wci io.c; wci RCS/io.c;wci io.c RCS/io.c;wci RCS/io.c io.c;
作成者作成者: Walter F. Tichy リビジョン番号: 5.9; リリース日: 1991/11/07 Copyright ©
1982, 1988, 1989 by Walter F. Tichy. Copyright © 1990, 1991 by Paul Eggert.
参照wco、wident、wrcs、wrcsdiff、wrcsmerge、wrlog; Walter F. Tichy 著、RCS—A System for Version Control, Software—Practice & Experience 15, 7 (July
1985), 637-654.
wci
120 Tivoli Management Framework: リファレンス・マニュアル
wclient
管理対象ノードを作成する。
構文wclient [-c source_dir] [-d] [-f file_name] [-I] [-j] [-p policy_region] [-P] [-t | -Ttraa] [-U user_account] [-y] [install_variables] [managed_node...]
説明wclient コマンドは、管理対象ノードで呼び出されると、管理対象ノードを作成します。
オプション-c source_dir
インストール・イメージ が入っているディレクトリーへの完全パスを指定します。 source_dir には、完全修飾パス (たとえば、/cdrom)、もしくはソース・ホストと source_host:path (たとえば、oak:/cdrom) フォーマットでのパスのどちらかを指定できます。
-d install_variables を、最後に設定された値に設定します。一般に、インストールされた管理対象ノードはすべて同じインストール変数セットを使用します。このオプションを使用すると、変数を簡単に設定できます。
-f file_name
インストール対象のマシンのリストが入っているテキスト・ファイルを指定します。 host_name,user,password (user および password はオプション)
というフォーマットで、1 行に 1 台のマシンが記述されているファイルを指定してください。指定しないと、デフォルト・ユーザーとして root または Administrator が使用されます。エントリーとエントリーの間にスペースを入れてはなりません。デフォルトのメソッドは、各行の内容に応じて決まります。
v デフォルトでは、各エントリーにマシン名だけが含まれます。
v アカウント・アクセスの場合は、マシン名、コンマ (,)、ユーザー ID、コンマ (,)、パスワードが、この順序で各エントリーに含まれます。
注: パスワードは暗号化されません。このファイルへのアクセス権を持つユーザーは誰でも、パスワードを見ることができます。
v トラステッド・ホスト・アクセスの場合は、マシン名とそれに続くコンマ(,) が各エントリーに含まれます。
次に、マシン・ファイルの例を示します。
elm,oak,chris,&rewsliveoak,
-I インストール・パスワードの入力を求めるプロンプトが表示されるようにします。このオプションを使用しなかった場合は、パスワード・プロンプトは表示されません。
第 3 章 コマンド (アルファベット順) 121
-j Tivoli サーバーがマシンに接続している場合に、暗号化されたセキュア・シェル (SSH) 接続を使用して管理対象ノードが作成されるようにします。
注: Windows ターゲットへのインストールに、SSH は使用できません。
-p policy_region
管理対象ノードのインストール先ポリシー・リージョンの名前を指定します。
-P マシンの root パスワードの入力を求めるプロンプトが表示されるようにします。複数のマシンを指定すると、すべてのクライアントが同じ root パスワードを持っているものと見なされます。
-t -U のオプションで指定したアカウントとパスワードを Tivoli リモート・アクセス・アカウントとして使用するように指定します。
-T traa
Tivoli リモート・アクセス・アカウントに使用するアカウント名を指定します。このオプションを使用すると、パスワードの入力を求めるプロンプトが表示されます。
-U user_account
各管理対象ノードをインストールするための、root 以外のアカウントとパスワードを指定します。このオプションを使用すると、パスワードの入力を求めるプロンプトが表示されます。
-y 確認をせずにインストールを進めることを指定します。デフォルトでは、このコマンドは、インストールを実行するための処理内容を明示し、その確認を受けてからインストールを開始します。このオプションを使用すると、コマンドはアクションを示し、確認を要求することなくインストールを実行します。
install_variables
インストールをコントロールするキーと値の対を指定します。インストールをコントロールする変数には、コマンド行で値を設定できるものやデフォルト値を使用できるものがあります。これらの変数により必須情報を指定したり、デフォルト情報を変更することができます。
注: インストール・オプションの名前は、製品の資料に示されているとおり正確に入力してください。インストール・オプションは、大文字小文字を区別します。
インストール変数のいくつかは、管理対象ノードのインストール先ディレクトリーを指定するためのものです。直前のインストールで使用されたファイルがすでにディレクトリーに入っている場合、コマンドは、それらのファイルを再インストールしません。ただし、このようなディレクトリーの場合でも、変数の値として感嘆符 (!) 文字を入力することによって、強制的に再インストールすることができます。
インストール・ディレクトリーに関連するインストール変数を次に示します。
wclient
122 Tivoli Management Framework: リファレンス・マニュアル
BIN=binaries
バイナリーのデフォルトのインストール・パス (/usr/local/Tivoli/bin)
を変更します。
LIB=libraries
ライブラリーのデフォルトのインストール・パス(/usr/local/Tivoli/lib) を変更します。
DB=client_database
オブジェクト・データベースのデフォルトのインストール・パス(/var/spool/Tivoli) を変更します。
MAN=manpage
マニュアル・ページのデフォルトのインストール・パス (
/usr/local/Tivoli/man) を変更します。
APPD=X11_defaults
X11 アプリケーション・デフォルトのデフォルトのインストール・パス (/usr/lib/X11/app-defaults) を変更します。
CAT=message_catalog
メッセージ・カタログのデフォルトのインストール・パス(/usr/local/Tivoli/msg_cat) を変更します。
その他のインストール変数を次に示します。
@AutoStart@=0 | 1システムのブート時に Tivoli デーモンを開始する (1) かどうかを指定します。デフォルトでは、デーモンは開始されません (0)。
@SetPort@=0 | 1Tivoli デーモンのリモート開始機能を設定するか設定しない (0) かを指定します。リモート開始を使用可能にすると、/etc/inetd.conf および /etc/services (Linux および UNIX システム上) などのシステム・ファイルに変更を加えることが必要です。デフォルトでは、この機能が構成されます (1)。
@CreatePaths@=0 | 1指定したディレクトリーがない場合に、このディレクトリーを作成するかどうかを指定します。デフォルトでは、ディレクトリーは作成されます (1)。 install_variables で指定したディレクトリーが存在しないと、エラーが発生します。
@ClientAddNoTrans@=yes | no管理対象ノードを追加する際、トランザクションを使用するかどうかを指定します。トランザクションを使用しないで管理対象ノードを追加すると、低速リンクを介してインストールするときは大幅に時間を節約できます。ただし、エラーが起きた場合は、wchkdb コマンドを実行してデータベースの状態を検査することが必要になります。
@ForceBind@=yes | no通信接続を強制的に単一のインターネット・プロトコル (IP) アドレスにバインドするかどうかを指定します。このオプションは、特定の高可用性またはフェイルオーバー構成で使用されます。この場
wclient
第 3 章 コマンド (アルファベット順) 123
合、多重オブジェクト・ディスパッチャーは 1 つの物理システム上の異なる IP アドレスにあります。
managed_node
管理対象ノードのインストール先のマシンを指定します。 -f オプションを使用する場合には、このオプションで指定されたファイルにリストされたマシンを組み込まないでください。
権限install_client または super
ファイル
Linux および UNIX ファイル
/tmp/tivoli.cinstallこのファイルは TMR サーバーに置かれていて、管理対象ノードおよび製品のすべてのインストールに関する冗長なデバッグ情報が入っています。
/tmp/install2.cfg.error /tmp/install2.cfg.outputこの一時ファイルは、オブジェクト・データベースの初期化時に、管理対象ノード上に作成されます。初期化が成功したあとで、これらのファイルは除去されます。
/tmp/client.cfg.error /tmp/client.cfg.outputこの一時ファイルは、オブジェクト・データベースの構成時に、管理対象ノード上に作成されます。初期化が成功したあとで、これらのファイルは除去されます。
/etc/Tivoli/setup_env.shこのファイルには、有効な Bourne シェル環境変数が入っています。このファイルは、インストール後に Bourne シェルと互換性のあるシェルから読み込ませることができます。
/etc/Tivoli/setup_env.cshこのファイルには、有効な C シェル環境変数が入っています。このファイルは、インストール後に C シェルと互換性のあるシェルから読み込ませることができます。
注: Tivoli Management Framework を UNIX オペレーティング・システム上にインストールすると、 /tmp/.tivoli ディレクトリーが作成されます。 このディレクトリーには、オブジェクト・ディスパッチャーのプロセスで必要なファイルが含まれます。 Tivoli サポート提供者からはっきりとした指示がない限りは、このディレクトリーまたディレクトリーのいかなる内容も削除しないでください。一定の間隔でスケジュールされたディスクのクリーンアップ・ジョブ (cron
または Tivoli ジョブ) が、このディレクトリーやその内容を除去することのないようにしなければなりません。
別のディレクトリーを使用するには、オブジェクト・ディスパッチャーおよびシェル内の両方の環境変数を設定する必要があります。 Tivoli Management
Framework をインストールしてから、以下のステップを実行して必要な環境変数を設定します。
wclient
124 Tivoli Management Framework: リファレンス・マニュアル
1. ディレクトリーの作成。このディレクトリーには、少なくともパブリックの読み取り許可および書き込み許可が必要です。しかし、完全な許可を定義し、スティッキー・ビットを設定して、他のユーザーが自分の所有していないファイルを変更できないようにしてください。
2. ディスパッチャー内の環境変数を設定します。
a. 次のコマンドを入力してください。
odadmin environ get > envfile
b. 次の行を envfile ファイルに追加して保管します。
TIVOLI_COMM_DIR=new_directory_name
c. 次のコマンドを入力してください。
odadmin environ set < envfile
3. Tivoli 提供の /etc/Tivoli ディレクトリー内の setup_env.csh、setup_env.sh、および oserv.rc ファイルを編集して、TIVOLI_COMM_DIR 変数を設定します。
4. HP-UX および Solaris システムの場合には、オブジェクト・ディスパッチャーを開始するファイルに以下の行を追加します。
TIVOLI_COMM_DIR=new_directory_name
この行を、オブジェクト・ディスパッチャーを開始する前に実行する部分で、他の環境変数が設定されている近辺の行に挿入します。 以下のリストには、各オペレーティング・システムで変更が必要なファイルが示されています。
v HP-UX オペレーティング・システム: /sbin/init.d/Tivoli
v Solaris オペレーティング環境: /etc/rc3.d/S99Tivoli
5. 以下のコマンドを入力して、オブジェクト・ディスパッチャーをシャットダウンします。
odadmin shutdown all
6. 以下のコマンドを入力して、Tivoli サーバー上のオブジェクト・ディスパッチャーを再始動します。
odadmin reexec 1
7. 以下のコマンドを入力して、管理対象ノード上のオブジェクト・ディスパッチャーを再始動します。
odadmin reexec clients
Windows ファイル
%TMPDIR%¥tivoli.cinstallこのファイルは Tivoli サーバー にあり、管理対象ノードおよび製品のすべてのインストールに関する冗長なデバッグ情報が入っています。
%TMPDIR%¥install2.cfg.error %TMPDIR%¥install2.cfg.outputこの一時ファイルは、オブジェクト・データベースの初期化時に、管理対象ノード上に作成されます。初期化が成功したあとで、これらのファイルは除去されます。
wclient
第 3 章 コマンド (アルファベット順) 125
%TMPDIR%¥client.cfg.error %TMPDIR%¥client.cfg.outputこの一時ファイルは、オブジェクト・データベースの構成時に管理対象ノード上に作成されます。初期化が成功したあとで、これらのファイルは除去されます。
例1. 次に示す例は、管理対象ノード dan および barney をポリシー・リージョン
bedrock のデフォルトの位置にインストールする例です。ユーザーには、これらの管理対象ノードのインストール・パスワードと root パスワードの入力を求めるプロンプトが表示されます。インストール・イメージへの完全パスは /cdrom
です。この例では、オブジェクト・データベース・ディレクトリーのデフォルトの位置が変更され、データベースは /var/spool/database にインストールされます。
wclient -dIP -c /cdrom -p bedrock DB=/var/spool/database dan barney
2. 次に示す例は、管理対象ノード sherman および sulphur をポリシー・リージョン austin にインストールする例です。
wclient -d -c /cdrom -p austin sherman sulphur
参照wchkdb, winstall, wrmnode, wserver, wstandalone
wclient
126 Tivoli Management Framework: リファレンス・マニュアル
wclrblk
ファイルからステートメントのブロックを削除します。このコマンドはエンドポイントから実行する必要があります。
構文wclrblk [-r] -s ″start_string″ -e ″end_string″ [-o output_file] file_name
説明wclrblk コマンドは、ファイルからステートメント・ブロックを削除します。このコマンドは、先頭と終わりが明確に区切られているステートメント・ブロック(winsblk や wrplblk コマンドを使用して追加されたブロックなど) の削除を目的としています。このコマンドを実行する際には、実際のステートメント・ブロックに合わせて区切り行を挿入する必要があります。
オプション-e ″end_string″
ファイル内の、ステートメント・ブロックの終わりを表すストリングを指定します。ストリングは二重引用符で囲んでください。
-o output_file
処理後のファイルを書き込むファイルの名前を指定します。このオプションを指定しないと、出力は標準出力に書き込まれます。 処理済みのファイルを、これから変更するファイルにリダイレクトすることはできません。
-r この引き数を指定すると、ステートメントのブロックだけでなく、区切り行も削除されます。
-s ″start_string″ファイル内の、ステートメント・ブロックの先頭を表すストリングを指定します。ストリングは二重引用符で囲んでください。
file_name
ブロックを削除するファイルを指定します。
戻り値0 コマンドが指定されたステートメント・ブロックの削除に成功したことを示
します。
ゼロ以外コマンドが指定されたステートメント・ブロックの削除に失敗したことを示します。
例以下の例は、c:¥windows¥system.ini ファイルから [keyboard] で始まり type=4 で終わる区切り行とステートメント・ブロックを除去して、c:¥temp¥output.fil ファイルに書き込みます。
wclrblk -r -s "[keyboard]" -e "type=4" ¥-o c:¥temp¥output.fil c:¥windows¥system.ini
第 3 章 コマンド (アルファベット順) 127
参照winsblk, wrplblk
wclrblk
128 Tivoli Management Framework: リファレンス・マニュアル
wclrline
ファイルから 1 行を削除します。このコマンドはエンドポイントから実行する必要があります。
構文wclrline [-f] -s ″search_string″ [-o output_file] file_name
説明wclrline コマンドは、検索ストリングの指定に従って、テキスト・ファイルから行を削除します。デフォルトでは、このコマンドの出力は標準出力に書き込まれます。
オプション-f 検索ストリングを含む最初の行だけを処理します。このオプションを指定し
ないと、検索ストリングの入っている行がすべて削除されます。
-o output_file
処理後のファイルを書き込むファイルの名前を指定します。このオプションを指定しないと、出力は標準出力に書き込まれます。
-s ″search_string″ファイル内で検索するストリングを指定します。検索ストリングが含まれている行がファイルから削除されます。ストリングは二重引用符で囲んでください。
file_name
読み取り対象ファイルの名前を指定します。
戻り値0 コマンドが指定された行の削除に成功したことを示します。
ゼロ以外コマンドが指定された行の削除に失敗したことを示します。
例1. 以下の例は、c:¥windows¥system.ini ファイルから [boot] で始まる行の最初のオカレンスを削除して、出力をc:¥temp¥output.fil ファイルに書き込みます。
wclrline -f -s "[boot]" -o c:¥temp¥output.fil ¥c:¥windows¥system.ini
2. 以下の例は、c:¥windows¥myapp.ini ファイルから device= が含まれるすべての行を削除して、出力を c:¥temp¥output.fil ファイルに書き込みます。
wclrline -s "device=" -o c:¥temp¥output.fil c:¥windows¥myapp.ini
参照winsline, wrplline
第 3 章 コマンド (アルファベット順) 129
wco
Revision Control System (RCS) のリビジョンをチェックアウトします。
構文wco [options] file
説明wco コマンドは、各 RCS ファイルからリビジョンを取り出し、それを対応する作業ファイルに格納します。
RCS サフィックスに一致するパスは、RCS ファイルを表します。その他のパスは、作業ファイルを表します。名前は、wci コマンドで説明されているとおりに対になっています。
RCS ファイルのリビジョンは、ロックしてチェックアウトすることも、アンロックしてチェックアウトすることもできます。リビジョンをロックすると、更新の重複を避けることができます。読み取りや処理 (コンパイルなど) のためにチェックアウトするリビジョンは、ロックする必要はありません。チェックアウト後に編集し、その後再びチェックインするリビジョンは、通常、ロックする必要があります。別のユーザーによってロックされているリビジョンをロックしてチェックアウトしようとすると、失敗します。 (ロックは wrcs コマンドで解除できます。) また、ロックしてチェックアウトするには、呼び出し元がその RCS ファイルのアクセス・リストに登録されている必要があります。ただし、呼び出し元がその RCS ファイルの所有者またはスーパーユーザーの場合や、アクセス・リストが空の場合は例外です。ロックしないでチェックアウトする場合はアクセス・リストによる制限を受けず、他のユーザーにあるロックの影響も受けません。
リビジョン番号またはブランチ番号、チェックイン日時、作成者、または状態を示すオプションによってリビジョンが選択されます。 wco コマンドに選択オプションを組み合わせて指定すると、すべてのオプションを満たす最新のリビジョンが取り出されます。選択オプションを 1 つも指定しないと、デフォルトのブランチ (通常はトランク。 wrcs コマンドの -b オプションを参照) の最新のリビジョンが取り出されます。 -f、-I、-l、-M、-p、-q、-r、または -u のどのオプションにもリビジョン番号またはブランチ番号を指定できます。オプション -d (日付)、-s (状態)、および -w (作成者) を指定すると、選択した単一ブランチ (-f、...、-u のいずれかのオプションで指定) またはデフォルト・ブランチから取り出されます。
リビジョンのない RCS ファイルに対して wco を発行すると、長さゼロの作業ファイルが作成されます。 wco コマンドは、キーワードの置換を行います。
作業ファイルは、読み取り許可と実行許可を RCS ファイルから継承します。また、所有者書き込み許可が有効になります。ただし、-k v が設定されている場合や、アンロックしてファイルがチェックアウトされ、ロックが厳密に設定されている場合は例外です (wrcs コマンドを参照)。
作業ファイルと同じ名前のファイルがすでに存在していて、書き込み許可が設定されている場合、wco コマンドはチェックアウトを中止し、可能であれば前もって確
130 Tivoli Management Framework: リファレンス・マニュアル
認メッセージを出します。既存の作業ファイルが書き込み不可の場合や、-f を指定した場合は、その作業ファイルは確認なしに削除されます。
オプション-d date
選択されたブランチ上で、チェックイン日時が date 以前の最新のリビジョンを取り出します。日時はフリー・フォーマットで指定できます。時間帯LT は現地時間を表します。その他の一般的な時間帯も認識されます。
日時フィールドの大部分には、デフォルト値が設定されています。デフォルトの時間帯は UTC です。その他のデフォルトは、(上位から下位に) 年、月、日、時、分、秒の順で判別されます。日時フィールドのうち少なくとも1 つを指定する必要があります。指定した最も上位のフィールドより上位の省略フィールドについては、現行の時間帯値が想定されます。その他の省略フィールドについては、可能性のある最も小さい値が想定されます。たとえば、日付に 20, 10:30 と指定すると、デフォルトでは、 UTC 時間帯の現在の年月の 20 日の 10:30:00 と見なされます。日時にスペースを使用する場合は、日時を引用符で囲んでください。
-j joinlist
joinlist 上のリビジョンを結合して新しいリビジョンを生成します。このオプションの機能は、wrcsmerge コマンドに置き換えられていますが、下位互換性のために保持されています。
-M [rev]
新しい作業ファイルの変更時刻を、取り出されたリビジョンの日付に設定します。 make コマンドで混乱が生じることがあるので、このオプションの使用には注意が必要です。
-s state
選択されたブランチ上で、状態が state に設定されている最新のリビジョンを取り出します。
-w [login]
選択されたブランチ上で、ログイン名 login のユーザーによりチェックインされた最新のリビジョンを取り出します。オプション login
を省略すると、呼び出し元のログインが使用されます。
joinlist は、rev2:rev3 という形式の組をコンマで区切ったリストです (rev2
と rev3 は、記号または数値のリビジョン番号)。最初の組では、rev1 は前述のオプション -f、...、-w で選択されたリビジョンを示します。その他のすべての組では、rev1 は直前の組で生成されたリビジョンを示します。(このように、ある結合の出力が次の結合の入力になります。)
各組について、wco コマンドは rev2 を基準にしてリビジョン rev1 とrev3 を結合します。これは、rev2 を rev1 に変換するために必要な変更をすべて、rev3 のコピーに適用するということです。これは、rev1 と rev3
が rev2 を共通の祖先として持つ 2 つのブランチの終わりである場合に、特に便利です。同じブランチ上で rev1<rev2<rev3 という関係の場合は、結合によって rev3 に似た新しいリビジョンが作成されますが、rev1 から
wco
第 3 章 コマンド (アルファベット順) 131
rev2 に変換するために必要な変更はすべて取り消されます。rev2 から rev1
への変更が rev2 から rev3 への変更と重複する場合、wco は merge の説明にあるように、重複を報告します。
最初の組では、rev2 を省略できます。デフォルトは共通の祖先です。ブランチを示すオプションがある場合は、それらのブランチ上の最新のリビジョンと見なされます。オプション -l および -u は、rev1 のロックおよびアンロックを行います。
-f [rev]
強制的に作業ファイルを上書きします。これは、-q と組み合わせて使用すると便利です。『ファイル・モード』のセクションも参照してください。
-I [rev]
対話モード。標準入力が端末でない場合も、ユーザーに対するプロンプトや質問が出力されます。
-k k キーワード・ストリング内のキーワード名だけを生成します。キーワード値は生成されません。『キーワードの置換』セクションを参照してください。たとえば、Revision キーワードの場合は、$Revision: 5.7 $ ではなく、ストリング $Revision$ が生成されます。キーワードの置換による差を無視してファイルのさまざまなリビジョンを比較するには、このオプションが便利です。
-k o チェックインする直前に作業ファイルに存在していた古いキーワード・ストリングを生成します。たとえば、Revision キーワードの場合、ファイルをチェックインしたときのストリングが $Revision: 1.1 $ だったとすると、$Revision: 5.7 $ ではなく $Revision: 1.1 $ が生成されます。これは、たまたまキーワード・ストリングの形式をとっているサブストリングの変更を許容できないバイナリー・ファイル形式の場合に便利です。
-k kv デフォルトの形式 ($Revision: 5.7 $ など) を使って、Revision キーワードのキーワード・ストリングを生成します。 wci -l や wco-l などによってファイルがロックされている場合にのみ、ファイルをロックしたユーザーの名前が、Header、Id、および Locker キーワード・ストリングの値に挿入されます。これはデフォルトです。
-k kvl -k kv と同じ働きをしますが、指定したリビジョンがロックされている場合、ロックしたユーザーの名前が必ず挿入される点が異なります。
-k v キーワード・ストリングのキーワード値だけを生成します。たとえば、Revision キーワードの場合、$Revision: 5.7 $ ではなくストリング 5.7
が生成されます。これは、$Revision:$ のようなキーワード区切り文字をストリングから取り除くことが難しいプログラミング言語でファイルを生成する場合に便利です。ただし、いったんキーワード名を削除してしまうとその他のキーワードを置換できなくなるので、このオプションの使用には注意が必要です。このようにキーワードが失われる危険があるため、このオプションを -l と組み合わせて使用することはできません。また、作業ファイルの所有者書き込み許可は無効になります。後でファイルを編集する場合は、-kv を指定せずにもう一度チェックアウトしてください。
wco
132 Tivoli Management Framework: リファレンス・マニュアル
-l [rev]
-r と同じ働きをしますが、取り出したリビジョンを呼び出し元専用にロックする点が異なります。
-p [rev]
取り出したリビジョンを、作業ファイルに格納する代わりに標準出力に出力します。このオプションは、wco がパイプの一部になっている場合に便利です。
-q [rev]
静止モード。診断は出力されません。
-r [rev]
rev 以下の番号を持つ最新のリビジョンを取り出します。rev にリビジョンではなくブランチを指定すると、そのブランチ上の最新のリビジョンが検索されます。 rev を省略すると、デフォルトのブランチ (wrcs コマンドの-b オプションを参照) 上の最新のリビジョンが取り出されます。 rev に $
を指定すると、wco は作業ファイル内のキーワード値からリビジョン番号を判別します。それ以外の場合、リビジョンはピリオドで区切った 1 つ以上の数値フィールドまたは記号フィールドで構成します。記号フィールドが表す数値は、コマンド wci および wrcs の -n オプションで指定します。
-u [rev]
-r と同じ働きをしますが、取り出したリビジョンが呼び出し元によってロックされていた場合にアンロックする点が異なります。 rev を省略して -uを指定すると、呼び出し元がロックしたリビジョンがある場合はそのリビジョンが、呼び出し元がロックしたリビジョンがない場合はデフォルトのブランチ上の最新のリビジョンが取り出されます。
-V n RCS バージョン n をエミュレートします。この場合、n は 3、4、または5 のいずれかです。これは、RCS の古いバージョンを実行している別のユーザーと RCS ファイルを交換する場合に役立ちます。相手側のシステムで実行されている RCS のバージョンを確認するには、相手のシステム側でRCS ファイルに対して wrlog コマンドを呼び出す必要があります。出力の最初の数行の中にストリング branch: が含まれる行がない場合は、バージョン 3 です。日付の年が 2 桁の場合は、バージョン 4 です。それ以外の場合はバージョン 5 です。バージョン 3 のエミュレートで生成されたRCS ファイルではデフォルトのブランチはなくなります。バージョン 4 以前のエミュレートで生成された RCS リビジョンのタイム・スタンプは、13
時以前になっています。バージョン 4 以前をエミュレートした際に抽出されたリビジョンでは、日付の形式付は yyyy/mm/dd ではなく yy/mm/dd で、$Log$ の代わりに別の空白が使われることもあります。
-x suffixes
suffixes を使用して RCS ファイルを特徴付けます。詳しくは、wci コマンドを参照してください。
キーワードの置換テキスト内に組み込まれた $keyword$ および $keyword:...$ という形式のストリングは、$keyword:value$という形式のストリングに置き換えられます。keyword とvalue は対になっています。詳しくは以下で説明します。キーワードは、リビジョンを識別するためにリテラル・ストリングまたはコメントに組み込むことができま
wco
第 3 章 コマンド (アルファベット順) 133
す。最初に、ユーザーが $keyword$ という形式のストリングを入力します。チェックアウト時に、wco がこれらのストリングを $keyword:value$ という形式のストリングに置き換えます。後者の形式のストリングを含んでいるリビジョンが再びチェックインされると、次のチェックアウト時に値フィールドが置換されます。このように、キーワード値はチェックアウト時に自動的に更新されます。この自動置換は、-k オプションによって変更できます。
キーワードとそれに対応する値は、次のとおりです。
$Author$リビジョンをチェックインしたユーザーのログイン名。
$Date$リビジョンがチェックインされた日時 (UTC)。
$Header$RCS ファイルの完全パス名、リビジョン番号、日付 (UTC)、作成者、状態、およびロックしたユーザー (ロックされている場合) から構成される標準のヘッダー。
$Id$ RCS ファイル名にパスがない点を除いて、$Header$ と同じ。
$Locker$リビジョンをロックしたユーザーのログイン名 (ロックされていない場合は空)。
$Log$ RCS ファイル名、リビジョン番号、作成者、および日付 (UTC) から構成されるヘッダーのあとに、チェックイン時に指定されたログ・メッセージを続けたもの。既存のログ・メッセージは置換されません。 代わりに、$Log:...$ のあとに新しいログ・メッセージが挿入されます。これは、完全な変更ログをソース・ファイルに蓄積する場合に使用します。
$RCSfile$パスなしの RCS ファイル名。
$Revision$リビジョンに割り当てられたリビジョン番号。
$Source$RCS ファイルの完全パス名。
$State$wrcs または wci コマンドの -s オプションでリビジョンに割り当てられた状態。
注RCS ファイルおよび作業ファイルへのリンクは保存されません。
キーワードの拡張を選択的に抑制する方法は、キーワードを別々に作成する以外にはありません。 nroff と troff では、これはヌル文字 (¥&) をキーワードに組み込むことによって行います。
wco
134 Tivoli Management Framework: リファレンス・マニュアル
診断RCS ファイルのパス名、作業ファイルのパス名、および取り出されたリビジョン番号が、診断出力に書き込まれます。すべての処理が成功した場合にだけ、終了状況が 0 になります。
ファイルwco コマンドのファイルへのアクセス方式は wci コマンドと同じですが、作業ファイルを読み取る必要がない点が異なります。
環境変数RCSINIT
オプション・リストの前に付くオプションで、それぞれはスペースで区切られています。詳しくは、wci コマンドを参照してください。
障害場合によっては、-d オプションでは 1970 年より前の日付を使用できないことがあります。
作成者作成者: Walter F. Tichy リビジョン番号: 5.7; リリース日 : 1991/08/19 Copyright ©
1982, 1988, 1989 by Walter F. Tichy. Copyright © 1990, 1991 by Paul Eggert.
参照wci、wident、wrcs、wrcsdiff、wrcsmerge、wrlog; Walter F. Tichy 著、RCS—A System for Version Control, “Software—Practice & Experience 15, 7 (July
1985), 637-654.
wco
第 3 章 コマンド (アルファベット順) 135
wconnect
2 つの Tivoli リージョンを接続します。
構文wconnect [-u] [-P port] [-m mode] [-r encrypt_level] -s server region_num
wconnect [-n] [-u] [-P port] [-c encrypt_level] [-l login] [-m mode] [-rencrypt_level] server
説明wconnect コマンドは、2 つの Tivoli リージョン内の Tivoli サーバー間の接続を確立します。構文で示した wconnect の最初の使用法では、セキュア接続が実行されます。接続を完了するには、接続対象の両方の Tivoli サーバーでこのコマンドを実行する必要があります。 2 番目の使用法では、リモート接続が実行されます。この場合は、一方の Tivoli サーバーだけでこのコマンドを実行します。作成されるのが片方向接続であると、リモート接続を実行する Tivoli サーバーは管理側サーバーになります。
Tivoli リージョンは、片方向接続または両方向接続で接続できます。片方向接続では、一方のサーバーが管理側サーバーになり、もう一方が管理対象サーバーになります。管理側サーバーのアドミニストレーターは、管理側サーバーと管理対象サーバーの両方のリソースを管理できます。これに対し、管理対象サーバーのアドミニストレーターは管理側サーバーのリソースを管理することはできません。両方向接続では、どちらのサーバーのアドミニストレーターも、他方のサーバーのリソースを管理できます。
オプション-c encrypt_level
ローカル Tivoli リージョンで使用されるリージョン間暗号化レベルを指定します。有効な暗号化レベルは、simple、none、または DES です。暗号化レベルが none の場合は、鍵は不要です。レベルが simple または DESの場合は、使用されているキーの入力を求めるプロンプトが表示されます。暗号鍵は、Tivoli サーバーのインストール時に指定したインストール・パスワードと同じです。暗号化レベルは、Tivoli サーバーのインストール時に指定したレベルと同じでなければなりません。デフォルトの暗号化レベルはsimple です。
-l login
リモート接続プロセスに使用するログイン名を指定します。このログインは、リモート・サーバー上のユーザーの有効なログインでなければならず、そのユーザーはリモート Tivoli リージョンで定義された super 役割を持つTivoli アドミニストレーターでなければなりません。 -l オプションを指定すると、パスワードの入力を求めるプロンプトが表示されます。承認されたホスト機能を使用する場合は、パスワードを入力しないでください。 Enterキーだけを押して、先に進んでください。
136 Tivoli Management Framework: リファレンス・マニュアル
-m mode
Tivoli リージョン間をつなぐ接続のモードを指定します。有効な接続モードは、次のとおりです。
Two-wayTivoli リージョン間を接続する両方向接続を確立します。両方向接続では、両方の Tivoli サーバーが両方のリージョンのリソースに対する管理権限を持つことになります。これはデフォルト値です。
Managingローカル Tivoli サーバーを管理側サーバーとして、片方向接続を確立します。ローカル Tivoli サーバーはリモート Tivoli リージョンのリソースを管理できますが、リモート Tivoli サーバーはローカル・リージョンのリソースを管理できません。
Managedローカル Tivoli サーバーを管理対象サーバーとして、片方向接続を確立します。このオプションは、セキュア接続でのみ有効です。リモート接続の場合、ローカル・サーバーは管理側サーバーにしかなれません。
-n パスワードの入力を求めるプロンプトを表示しないように Tivoli
Management Framework に指示します。このオプションは、トラステッド・ホスト・アクセスがあり、暗号鍵が不要な場合にだけ使用できます。
注: Windows オペレーティング・システムはトラステッド・ホスト・アクセスがないので、Windows オペレーティング・システムで Tivoli サーバーを接続するときはこのオプションを使用できません。
-P port
Tivoli サーバーとの通信に使用するポート番号を指定します (ローカル・オブジェクト・ディスパッチャーのポートと異なる場合)。
注: このオプションは、開発環境とテスト環境での使用だけを目的としています。実稼働環境では使用しないでください。
-r encrypt_level
リモート Tivoli リージョンで使用されている暗号化レベルを指定します。有効な暗号化レベルは、simple、none、または DES です。暗号化レベルが none の場合は、鍵は不要です。レベルが simple または DES の場合は、使用されている鍵の入力を求めるプロンプトが表示されます。暗号鍵は、Tivoli サーバーのインストール時に指定したインストール・パスワードと同じです。暗号化レベルは、Tivoli サーバーのインストール時に指定したレベルと同じでなければなりません。デフォルトの暗号化レベルは simpleです。
-s セキュア接続プロセスを使って接続を確立します。このためには、接続されている Tivoli サーバーごとに -s オプションを指定してコマンドを実行する必要があります。
-u 両方向接続の両方の Tivoli リージョンのリソース、または片方向接続のリモート・リージョンのリソースを更新します。これは時間の掛かるプロセス
wconnect
第 3 章 コマンド (アルファベット順) 137
であるため、後日 (接続時以外に) -u オプションを指定した wlsconn コマンドを使ってこの操作を実行してもかまいません。
region_num
リモート Tivoli リージョンのリージョン番号を指定します。
server リモート・リージョンの Tivoli サーバーの名前を指定します。
権限super
例1. 次に示す例は、両方向のリモート接続を実行する例です。どちらの Tivoli サーバーも、暗号化レベル simple を使用しています。このコマンドを実行するアドミニストレーターは、リモート・サーバー elbert にログインする場合、sally を使用します。接続が完了すると同時に、サーバー間でリソース情報が交換されます。
wconnect -u -c simple -l sally -m Two-way -r simple elbert
2. 次に示す例は、片方向のリモート接続を実行する例です。ローカル・サーバーでは暗号化を使用していませんが、リモート・サーバー cook では暗号化レベルsimple を使用しています。ローカル・サーバーが管理側サーバーになり、リモート・サーバーが管理対象サーバーになります。ローカル・サーバーのリソース情報が更新されます。
wconnect -u -c none -m Managing -r simple cook
3. 次に示す例は、両方向のセキュア接続を実行する例です。リモート・サーバーpinatubo では暗号化レベル simple (デフォルト) が使用されています。リモート・サーバーのリージョン番号は 4004418954 です。接続が完了すると、サーバー間でリソース情報が交換されます。
wconnect -u -s pinatubo 4004418954
接続を完了するには、リモート・サーバーでも wconnect を実行する必要があります。 pinatubo から、以下のコマンドを実行する必要があります。前のコマンドではデフォルトの値が使用されていましたが、この例では -r オプションで暗号化レベルが指定されています。両方のサーバーのリソース情報が更新されます。
wconnect -u -r simple -s everest 4004598145
4. 次に示す例は、片方向のセキュア接続を実行する例です。リモート・サーバーmeiron では、暗号化レベル simple (デフォルト) が使用されています。リモート・サーバーのリージョン番号は 0003432265 です。ローカル・サーバーが管理対象サーバーになります。接続が完了すると、サーバー間でリソース情報が交換されます。
wconnect -u -m Managed -s meiron 0003432265
接続を完了するには、リモート・サーバーでも wconnect を実行する必要があります。 meiron から、以下のコマンドを実行する必要があります。meiron が管理側サーバーになります。
wconnect -u -m Managing -s space 4004598145
wconnect
138 Tivoli Management Framework: リファレンス・マニュアル
注: セキュア接続プロセスを使って片方向接続を行う場合、最初に wconnectコマンドを実行するサーバーを管理対象サーバーではなく管理側サーバーとして指定した場合、管理側サーバーで接続情報の交換を完了するには -u オプションを指定したwlsconn コマンドを実行する必要があります。
参照wdisconn, wlsconn, wupdate
wconnect
第 3 章 コマンド (アルファベット順) 139
wcpcdrom
CD からシステム・ディレクトリーへインストール・イメージをコピーします。
構文wcpcdrom [-i start_index] [-a] [-c] [-n] cdrom_list new_cd_dir [interp_list]
説明wcpcdrom コマンドは、Tivoli CD の Tivoli インストール・イメージをシステム・ディレクトリー new_cd_dir にコピーします。このコマンドを使用することにより、CD の内容をシステム・ディレクトリーにコピーできるほか、複数の CD イメージをシステム・ディレクトリーでマージしたり、1 つまたは複数の CD の単一のインタープリター・タイプをシステム・ディレクトリーにコピーしたりできます。たとえば、Tivoli Management Framework の HP-UX 版とすべての Tivoli アプリケーションのインストール・イメージを構築する場合は、このコマンドを使って、すべてのインストール対象 Tivoli アプリケーション用の HP-UX 10.01 バイナリーおよびライブラリーを格納する単一のディレクトリーを作成します。その後、このディレクトリーからすべてのアプリケーションをインストールできます。
デフォルトでは、wcpcdrom コマンドは CD 上のイメージへのシンボリック・リンクを作成します。複数の CD のイメージをコピーする場合は、-c オプションを使用してください。このオプションを使用すると、シンボリック・リンクを作成する代わりにファイルがコピーされます。
複数の CD からイメージをコピーする場合は、-i オプションも使用する必要があります。このオプションは、wcpcdrom コマンドがシステム・ディレクトリー内のパケットの番号付けに使用する最初の番号を指定します。たとえば、すでに 1 つのTivoli CD をディレクトリーにコピーしてあるとします。そのディレクトリーには、file1.pkt ~ file95.pkt ファイルが入っています。 2 枚目の CD をコピーするときは、-i オプションを使って、既存のファイルが上書きされないようにする必要があります。たとえば、2 枚目の CD でパケットの番号付けを順次に file96.pkt ファイルから開始していくには、wcpcdrom -i 96 を指定します。
必要なイメージを new_cd_dir にコピーしたら、次のコマンドを使って、イメージ全体をテープにコピーすることができます。
cd new_cdrom_dir tar-cvhf tape_device
新しいイメージからインストールする場合は、インストール・ ディレクトリーを作成し、CD からインストールする場合と同じように wpreinst コマンドを実行します。インストール手順については、「Tivoli Enterprise インストール・ガイド」を参照してください。
オプション-a CD からすべてのファイルとディレクトリーをコピーします。
-c CD へのシンボリック・リンクを作成する代わりに、CD イメージをコピーします。
140 Tivoli Management Framework: リファレンス・マニュアル
-i start_index
コマンドが、new_cd_dir にコピーされたパケットの番号付けに使用する最初の番号を指定します。start_index 変数には、1 ~ 9999 の間であればどの値でも指定できます。
-n コマンドの実行時の処理内容を表示します。このオプションを指定した場合、ファイルは変更されません。
cdrom_list
CD のパスを指定します。複数のパスを指定する場合は、コンマで区切ってください。
interp_list
CD からコピーするインタープリター・タイプを指定します。複数のインタープリター・タイプは、スペースで区切ってください。省略すると、すべてのインタープリター・タイプがコピーされます。有効なインタープリター・タイプの完全なリストが「Tivoli Management Framework リリース情報」にありますので、参照してください。
new_cd_dir
ファイル・パケットのコピー先のディレクトリーを指定します。
権限このコマンドの使用には、特別な許可は不要です。
例1. 次に示す例は、cdrom1 という CD の内容を /tmp/tiv_install ディレクトリーにコピーします。
wcpcdrom -c /mycdrom/cdrom1 /tmp/tiv_install
2. 次に示す例は、cdrom2 という CD からインタープリター・タイプ solaris2 のみを、番号 96 で始まり順次番号付けされたファイル・パケットで /tmp/tme_install
ディレクトリーにコピーします。
wcpcdrom -c -i 96 /mycdrom/cdrom2 /tmp/tme_install solaris2
3. 以下の例では、Tivoli Management Framework の HP-UX 版と Tivoli アプリケーションを、それぞれ/mycdrom/tmp_cdrom ディレクトリーと /urcdrom/apps_cdrom
ディレクトリーから、番号 1 で始まり順次番号付けされたファイル・パケットで /home/new_dir ディレクトリーにコピーします。
wcpcdrom -c -i 1 /mycdrom/tmp_cdrom, /urcdrom/apps_cdrom ¥/home/new_dir hpux
wcpcdrom
第 3 章 コマンド (アルファベット順) 141
wcpyfile
NetWare 構成プログラム (.NCF) でファイルをコピーできるようにします。このコマンドはエンドポイントから実行する必要があります。
構文wcpyfile -s source_path -d destination_path
説明wcpyfile コマンドは、.NCF 構成プログラムをサポートするために作成されたコマンドです。このコマンドを使用すると、NetWare マシン上のあるボリュームまたはディレクトリーから別のボリュームまたはディレクトリーへのファイルのコピーを、.NCF 構成プログラムの中から行えます。
オプション-d destination_path
宛先ファイルの完全パスを指定します。
-s source_path
ソース・ファイルの完全パスを指定します。
例次の例は、SYS:¥TEMP¥FILE.NLM ファイルを、.NCF 構成プログラム内のSYS:¥SYSTEM¥FILE.NLM ファイルにコピーします。
wcpyfile -s SYS:¥TEMP¥FILE.NLM -d SYS:¥SYSTEM¥FILE.NLM
142 Tivoli Management Framework: リファレンス・マニュアル
wcrtadmin
新規の Tivoli アドミニストレーターを作成します。
構文wcrtadmin -l login... [-n noticegroup]... [-r group,role1:role2...] [-u user_id [-ggroup_id]]... name
説明wcrtadmin コマンドは、新規の Tivoli アドミニストレーターを作成します。
オプション-g group_id
新規アドミニストレーターのプリンシパル・グループ ID を設定します。
-l login
新規アドミニストレーターの Tivoli ログインを設定します。 login には、次のいずれかの形式を入力できます。
v user_name
v user_name@ManagedNode
v domain¥user_name
v domain¥user_name@ManagedNode
user_name または domain¥user_name のみを指定した場合、ユーザーは、Tivoli 管理リージョン (TMR) のどのシステムからでもログインできます。user_name@ManagedNode または NTdomain¥user_name@ManagedNode を指定した場合、ユーザーは、指定したホストからのみログインできます。
-n noticegroup
新規アドミニストレーターの通知グループ・サブスクリプションを設定します。複数の通知グループを指定できます。
-r group,role1:role2
指定されたグループ内の役割を、新規アドミニストレーターに与えます。このオプションは、@group,role1:role2 (たとえば、@Administrator,admin:user または @DefaultRegion,super) の形式で入力してください。グループの単一インスタンス内の役割を指定するには、グループ・タイプを指定し、その後にインスタンス名を指定します。両方の名前をコロンで区切ることが必要です。たとえば、@PolicyRegion:MyRegion,super:senior は、ポリシー・リージョンMyRegion 内での super 役割と senior 役割を指定します。 Tivoli リージョンの役割を指定するには、ストリング「global」を使用してください (たとえば、-r global,user)。
-u user_id
新規アドミニストレーターのプリンシパル・ユーザー ID を設定します。user_id には、次のいずれかの形式を入力できます。
v user_name
第 3 章 コマンド (アルファベット順) 143
v user_name@ManagedNode
v domain¥user_name
v domain¥user_name@ManagedNode
注: ManagedNode に指定できるすべての値が、odadmin odlist の出力内のHostname(s) 列にリストされます。
name 新規アドミニストレーターのラベル。このラベルは、「アドミニストレーター」ウィンドウの「アドミニストレーター」アイコンに表示されます。アドミニストレーター名には、任意の英数字、下線 (_)、ダッシュ (-)、ピリオド(.)、スペースを使用することができます。
権限senior
例1. 次の例では、システム ohio への Tivoli ログイン kimiko、Tivoli- Authorization
通知グループ内のメンバーシップ、Testing ポリシー・リージョン内の admin許可の役割、およびラベル kimiko を指定して、アドミニストレーターが作成されます。
wcrtadmin -l kimiko@ohio -n Tivoli-Authorization ¥-r @PolicyRegion:Testing,admin Kimiko
2. 次の例では、Tivoli リージョン内の user の役割、DefaultRegion 内の super、admin、user の役割、グループ Administrators 内の super と senior の役割、およびポリシー・リージョン MyRegion 内の super、senior、admin、user、backup の役割を指定して、プリンシパル callahan@sthelens およびcallahan@dogma の下にアドミニストレーターが作成されます。 callahan は、Tivoli Authorization グループのメンバーとして追加されます。このアドミニストレーターは、プリンシパル・ユーザー ID callahan とプリンシパル・グループID staff で実行します。アドミニストレーター・ラベルは Steve Callahan です。
wcrtadmin -l callahan@sthelens -l callahan@dogma ¥-n "Tivoli Authorization" ¥-r global,user -r @DefaultRegion,super:admin:user ¥-r /Administrators,super:senior ¥-r @PolicyRegion:MyRegion,super:senior:admin:user:backup ¥-u callahan -g staff "Steve Callahan"
参照wgetadmin, wsetadmin
wcrtadmin
144 Tivoli Management Framework: リファレンス・マニュアル
wcrtgate
エンドポイント・ゲートウェイを作成します。
構文wcrtgate [-h managed_node] [-i IPX_socket] [-n gateway_name] [-p TCPIP_port] [-Pprotocols_list] [-t default_session_timeout]
説明wcrtgate コマンドは、指定した管理対象ノード上に新規エンドポイント・ゲートウェイを作成します。次のオプションの少なくとも 1 つを指定する必要があります。
ゲートウェイを作成する際、デフォルトでは ゲートウェイ HTTPd サービスは使用不可です。ブラウザーからゲートウェイ情報にアクセスするには、 wcrtgate コマンドを使用してアクセス・アカウントおよびパスワードを定義し、ゲートウェイがHTTP 要求を受け入れられるようにする必要があります。
オプション-h managed_node
ゲートウェイが作成される管理対象ノードの名前を指定します。このオプションを使用しないと、このコマンドが指定された管理対象ノードにゲートウェイが作成されます。
-i IPX_socket
ゲートウェイが Sequenced Packet Exchange (SPX) パケットを listen するために使用するポートを指定します。ゲートウェイは、指定されたポート -
(マイナス) 1 の Internetwork Packet Exchange (IPX) パケットも listen します。
-n gateway_name
ゲートウェイの名前を指定します。このオプションを使用しないと、ゲートウェイ名は managed_node-gateway フォーマットとなります。
-p TCPIP_port
割り当てられたエンドポイントとゲートウェイが通信するのに使用するTCP/IP ポートの番号を指定します。デフォルトはポート 9494 です。
注: プロキシー管理対象ノードまたはエンドポイントで使用されているポート番号と同じポート番号を使用しないでください。
-P protocols_list
指定したゲートウェイ用にサポートされるプロトコルを指定します。複数のプロトコルを指定する場合は、protocol,protocol のように、コンマで区切る必要があります。
-t default_session_timeout
ゲートウェイからエンドポイントへのダウンコール時に使用されるセッション・タイムアウト期間を設定します。指定された時間は、ゲートウェイがエンドポイントからの応答を待つ時間を表します。
第 3 章 コマンド (アルファベット順) 145
権限senior
例1. 次の例では、管理対象ノード pearl 上にゲートウェイが作成されます。この結果作成されるゲートウェイは、pearl-gateway という名前になり、デフォルトのポート 9494 で通信します。
wcrtgate -h pearl
2. 次の例では、gems というエンドポイント・ゲートウェイが管理対象ノードdiamond 上に作成されます。
wcrtgate -h diamond -n gems
3. 次の例では、ポート 8432 を介して通信を行う管理対象ノード vernon 上で、subnet30-gateway ゲートウェイが作成されます。
wcrtgate -h vernon -n subnet30-gateway -p 8432
4. 次の例では、TCP/IP と IPX の両方のプロトコルをサポートするエンドポイント・ゲートウェイが、管理対象ノード vernon に作成されます。このゲートウェイは、ポート 9999 で TCP/IP エンドポイントと通信し、ポート 6000 で IPX
エンドポイントと通信します。
wcrtgate -h vernon -P TCPIP,IPX -p 9999 -i 6000 -n gems
参照wdelgate
wcrtgate
146 Tivoli Management Framework: リファレンス・マニュアル
wcrtjob
タスク・ライブラリー内にジョブを作成します。
構文wcrtjob -j job_name -l library_name -t task_name -M mode [-s interval -n number]
-m timeout -o output_format [-D | -d node_name -f file_name] [-h node...] [-pprofile_manager...]
説明wcrtjob コマンドは、指定されたタスクを使用するジョブを作成します。ジョブは、反復して実行できる Tivoli 環境環境内のリソースです。
オプション-d node_name
ジョブ出力の保管先管理対象ノードを指定します。
-D ジョブ出力を画面に表示します。
-f file_name
ジョブ出力の保管先ファイル名を指定します。それぞれの出力ファイル名は、異なっていなければなりません。複数の操作に対して同一の名前が使用され、そうした操作が同時に実行されると、すべての出力がこのファイルに書き込まれます。
-h node...
ジョブの実行先のノード (管理対象ノードまたはエンドポイント) を指定します。-h オプションは、指定する各ノードごとに繰り返す必要があります。
注: 同じ名前のエンドポイントと管理対象ノードが存在する場合、-h オプションがデフォルトで管理対象ノードに設定されます。-h オプションで強制的にエンドポイントを指定するには、以下の構文を使用してください (ep_name はエンドポイントの名前)。
-h @Endpoint:ep_name
-j job_name
作成されるジョブの名前を指定します。 名前の 1 文字目は英字でなければなりません。 2 文字目以降には、英数字、下線 (_)、ハイフン (-)、ピリオド (.)、またはスペースが可能です。
-l library_name
ジョブに含まれるタスクが入っているタスク・ライブラリーを指定します。
-m timeout
タスク・ライブラリーが、タスクから結果が返されるのを待つ秒数を指定します。このオプションは、ジョブの実行に影響しません。 -M staged オプションを使用中の場合、timeout は interval より小さくなければなりません。
第 3 章 コマンド (アルファベット順) 147
-M mode
ジョブの実行時のモードを指定します。有効なオプションは次のとおりです。
parallel指定したすべてのノードとサブスクライバーで同時にジョブを実行します。
serial 一度に 1 つのノード上のジョブを実行します。
staged指定した間隔で、ノードのグループでジョブを実行します。このモードを指定する場合は、-n および -s オプションを使用する必要があります。
-n number
各ステージでジョブを実行するノード (管理対象ノードおよびエンドポイント) の数を指定します。 -M staged オプションを使用する場合、このオプションの値を指定しなければなりません。最大数は 150 です。
-o output_format
ジョブ出力の形式を定義します。ジョブ出力には、各管理対象ノード上でのジョブの要約があります。タスクの実行出力の形式を、0 ~ 17 の範囲の 8
進数で指定します。希望する出力の値を加算して、出力の形式を構成します。たとえば、戻りコードおよび標準エラーを出力するには、-o 12 と入力します。出力値は次のとおりです。
01 各レコードの記述ヘッダーを出力します。
02 戻りコードを出力します。
04 標準出力を出力します。
10 標準エラーを出力します。
-p profile_manager...
ジョブの実行先のプロファイル・マネージャーを指定します。 -p オプションは、指定するプロファイル・マネージャーごとに繰り返し指定してください。
-s interval
管理対象ノードのあるグループでタスクを実行してから、次のグループで実行するまでの秒数を指定します。 -M staged オプションを使用する場合、このオプションの値を指定しなければなりません。
-t task_name
ジョブに使用するタスクの名前。
権限admin、senior、super
例1. 次の例では、date_job というジョブが作成されます。このジョブには、my_task
タスク・ライブラリーに入っている date_task タスクが含まれます。このジョブは、marketing プロファイル・マネージャーにサブスクライブされる管理対象ノ
wcrtjob
148 Tivoli Management Framework: リファレンス・マニュアル
ード上で並行して実行されます。このジョブは、タイムアウトになるまで各ノード上で 120 秒間実行されます。出力は、画面に表示されます。
wcrtjob -j date_job -t date_task -l my_tasks -M parallel -m 120 -p marketing ¥-o 017 -D
2. 次の例では、date_job2 というジョブが作成されます。このジョブには、my_task
タスク・ライブラリーに入っている date_task タスクが含まれます。このジョブは、ノード bald 上で並列実行されます。このジョブは、タイムアウトになるまで 120 秒間実行されます。出力は、管理対象ノード bald にある/tmp/date_job2.output という名前のファイルに保管されます。
wcrtjob -j date_job2 -t date_task -l my_tasks -M parallel -m 120 -h bald ¥-o 017 -d bald -f /tmp/date_job2.output
参照wcrttask, wdeljob, wruntask
wcrtjob
第 3 章 コマンド (アルファベット順) 149
wcrtpol
クラスの新規ポリシー・オブジェクトを作成します。
構文wcrtpol [-d] class name [parent]
wcrtpol -v class name [parent]
説明wcrtpol コマンドは、クラスの新規ポリシー・デフォルト・オブジェクトまたはポリシー検証オブジェクトを作成します。新規ポリシー・オブジェクトは、既存クラスのポリシー・オブジェクトからメソッドと属性の最初のセットを継承します。新規ポリシー・オブジェクトをカスタマイズするには、wgetpolm コマンドとwputpolm コマンドを使用してください。
オプション-d デフォルトのポリシー・オブジェクトを作成します。 -v オプションを指定
しない場合、このアクションがデフォルトになります。
-v ポリシー検証オブジェクトを作成します。
class 新規ポリシー・オブジェクトのクラス。
name 新規ポリシー・オブジェクトの名前。この名前名には、任意の英数字、下線(_)、ダッシュ (-)、ピリオド (.)、スペースを使用することができます。
parent 既存クラスのポリシー・オブジェクトのラベル。新規ポリシー・オブジェクトは、このオブジェクトから初期のメソッドと属性を継承します。デフォルトの親は、クラスのデフォルト・ポリシー・オブジェクトです。
権限senior、super
例この例は、BasicProfileManager ポリシー・オブジェクトから継承する ProfileManager
の Restricted ポリシー検証オブジェクトを作成します。
wcrtpol -v ProfileManager Restricted BasicProfileManager
参照wchkpol, wcrtpr, wdelpol, wdelpr, wgetdfpol, wgetpolm, wls, wlspolm,
wputpolm
150 Tivoli Management Framework: リファレンス・マニュアル
wcrtpr
ポリシー・リージョンを作成します。
構文wcrtpr [-a admin...] [-s region] [-m resource...] name
説明wcrtpr コマンドは、ポリシー・リージョンを作成します。このポリシー・リージョンを作成すると、すべてのリソース・タイプについてポリシー検証が使用不可になります。ポリシー検証を使用可能にするには、wsetpr コマンドを使用します。
オプション-a admin...
指定されたアドミニストレーターのデスクトップに新規ポリシー・リージョンを追加します。複数のデスクトップに追加するには、アドミニストレーターごとに -a admin を指定します。
-m resource...
新規ポリシー・リージョンの管理対象リソースのリストに追加されるリソースを指定します。複数のリソースを追加するには、リソースごとに -mresource を指定します。このオプションを使用するには、policy 許可の役割が必要です。
-s region
ポリシー・リージョンを、指定されたポリシー・リージョンのサブリージョンとして作成します。新規ポリシー・リージョンは、その親リージョンのサポートされているクラスを継承します。省略すると、ポリシー・リージョンは最上位のポリシー・リージョンとして作成されます。
name 新規ポリシー・リージョンの名前。ポリシー・リージョン名には、任意の英数字、下線 (_)、ダッシュ (-)、ピリオド (.)、スペースを使用することができます。
権限senior。ただし -m オプションを使用する場合はsenior と policy。
例1. 次の例では、最上位ポリシー・リージョンが作成され、ルート・アドミニストレーターのデスクトップにそのリージョンが自動的に追加されます。
wcrtpr -a Root_ceridwen-region new-region
2. 次の例では、デフォルト・リージョンの下にサブリージョンが作成されます。ManagedNode リソース・タイプが管理対象リソースになります。
wcrtpr -s /Regions/test-region -m ManagedNode node-region
第 3 章 コマンド (アルファベット順) 151
参照wchkpol, wcrtpol, wdelpol, wdelpr, wgetdfpol, wgetpolm, wlspolm,
wputpolm
wcrtpr
152 Tivoli Management Framework: リファレンス・マニュアル
wcrtprf
新しいプロファイルの作成、または既存のプロファイルの複製を行います。
構文wcrtprf [-c source] profile_manager type profile_name
説明wcrtprf コマンドは、指定されたプロファイル・タイプの構成プロファイルを作成します。このプロファイルは、指定されたプロファイル・マネージャー内に作成されます。
source が指定された場合、コマンドは、同じタイプの既存プロファイルを複製します。省略すると、新規プロファイルは空に初期化されます。
オプション-c source
新規プロファイルの複製元となる既存プロファイルの名前を指定します。有効な形式は、次のとおりです。
v @profile_name
v @profile_type:profile_name
v /region/policy_region_name/profile_manager_name/profile_name
profile_manager
プロファイルを作成するプロファイル・マネージャーの名前を指定します。有効な形式は、次のとおりです。
v @profile_manager_name
v @ProfileManager:profile_manager_name
v /region/policy_region_name/profile_manager_name
profile_name
新規プロファイルの名前を指定します。プロファイル名には、任意の英数字、下線 (_)、ダッシュ (-)、ピリオド (.)、スペースを使用することができます。
type 作成するプロファイルのタイプを指定します。プロファイルのリソース・タイプはアプリケーション固有です。プロファイル固有の詳細については、アプリケーション固有の資料を参照してください。
権限senior または super
例1. 次の例では、Development プロファイル・マネージャー内に DiskSpace プロファイルが作成されます。
wcrtprf @ProfileManager:Development SentryProfile DiskSpace
第 3 章 コマンド (アルファベット順) 153
2. 以下の例では、Marketing プロファイル・マネージャー内に DiskSpace プロファイルの複製が作成されます。
wcrtprf -c @SentryProfile:DiskSpace ¥@ProfileManager:Marketing SentryProfile OurDiskSpace
参照wcrtprfmgr, wdistrib, wgetprf, wgetsub, wlspol, wpopulate, wsub, wunsub,
wvalidate
wcrtprf
154 Tivoli Management Framework: リファレンス・マニュアル
wcrtprfmgr
プロファイル・マネージャーを作成します。
構文wcrtprfmgr policy_region profile_manager
説明wcrtprfmgr コマンドは、指定されたポリシー・リージョン内にプロファイル・マネージャーを作成します。
注: プロファイル・マネージャーをデータレス・モードで実行するかどうかを指定するには、wsetpm コマンドを使用してください。
オプションprofile_manager
新規プロファイル・マネージャーの名前を指定します。プロファイル・マネージャー名には、任意の英数字、下線 (_)、ダッシュ (-)、ピリオド (.)、スペースを使用することができます。
policy_region
プロファイル・マネージャーの作成先のポリシー・リージョンを指定します。
v @policy_region
v @PolicyRegion:policy_region
v /region/policy_region
権限senior または super
例次の例は、Development プロファイル・マネージャーを Dallas ポリシー・リージョン内に作成します。
wcrtprfmgr @Dallas Development
参照wcrtprf, wdistrib, wgetprf, wgetsub, wlssub, wpopulate, wsetpm, wsub,
wunsub, wvalidate
第 3 章 コマンド (アルファベット順) 155
wcrtqlib
照会ライブラリーを作成します。
構文wcrtqlib policy_region query_library
説明wcrtqlib コマンドは、指定されたポリシー・リージョン内に新規照会ライブラリーを作成します。
オプションpolicy_region
照会ライブラリーを作成するポリシー・リージョンの名前を指定します。
query_library
新規照会ライブラリーの名前を指定します。
権限senior または super
例次の例では、NewQueries という照会ライブラリーが amon-sul-Region ポリシー・リージョン内に作成されます。
wcrtqlib amon-sul-Region NewQueries
参照wcrtquery, wdel, wgetquery, wruninvquery, wrunquery, wsetquery
156 Tivoli Management Framework: リファレンス・マニュアル
wcrtquery
照会ライブラリーに照会を作成します。
構文wcrtquery [-d description] [-r repository] [-v view] [-c column]... -i [-x]
query_library query_name
wcrtquery [-d description] [-r repository] [-v view] [-c column]... -s [-x]
query_library query_name
wcrtquery [-d description] [-r repository] [-v view] [-c column]... -w where_clause
[-x] query_library query_name
説明wcrtquery コマンドは、新規照会を照会ライブラリー内に作成します。照会に関する記述、リポジトリー、ビュー、照会する列、SQL 検索 (または where) 文節を指定できます。標準入力によって、またはコマンド行上でオプションの where 文節を指定できます。
構成リポジトリー、ビュー、およびカラムのデフォルトは、照会ライブラリーが入っているポリシー・リージョン内のポリシー・デフォルトによって提供されます。
wgetquery および wsetquery コマンドを使用するか、もしくは Tivoli デスクトップから、これらの属性の表示と変更を行うことができます。
オプション-c column
情報を検索する 1 つまたは複数の列を指定します。2 つ以上の列を指定するには、-c オプションを複数指定します。出力での列の順序は、ここで入力した順序になります。
-d description
照会に関する記述を指定します。
-i 構造化されていない where 文節を標準入力から読み取ります。
-r repository
情報を検索する構成リポジトリーの名前を指定します。
-s 構造化 where 文節を標準入力から読み取ります。文節の形式は、次のとおりです。
[AND|OR] [NOT] Column_Name {=|!=|<|<=|>|>=|LIKE|IN} Column_Value
-v view
情報を検索するビューまたはテーブルの名前を指定します。
-w where_clause
コマンド行上で where 文節を提供します。
-x 照会の出力に重複行を取り込まないことを指定します。
第 3 章 コマンド (アルファベット順) 157
query_library
照会を作成する照会ライブラリーの名前を指定します。
query_name
新規照会の名前を指定します。
権限admin、senior、または super
例1. 以下の例は、DOS-machines 照会を NewQuereis 照会ライブラリーに作成します。この照会は、標準入力から読み取られる構造化 where 文節を使用し、DOS
を実行中のマシンに関する情報を検索します。この照会は、MACHINE_TYPE ビュー内の inventory リポジトリーを調べて、DOS の値をもつBOOTED_OS_NAME のすべてのインスタンスの PROCESSOR_TYPE 列とOPERATING_SYSTEM 列から情報を戻します。
wcrtquery -d "Find all DOS machines" -r inventory -v ¥MACHINE_TYPE -c PROCESSOR_TYPE -c OPERATING_SYSTEM -s ¥NewQueries ¥DOS-machines <<EOF
(BOOTED_OS_NAME = ’DOS’)EOF
2. 次の例では同じ照会が作成されますが、結果を HARDWARE_SYSTEM_ID に従ってソートするように構造化されていない where 文節で指定する点が異なっています。
wcrtquery -d "Find all DOS machines" -r inventory -v ¥MACHINE_TYPE -c PROCESSOR_TYPE -c HARDWARE_SYSTEM_ID ¥-w "(BOOTED_OS_NAME = ’DOS’) ORDER BY HARDWARE_SYSTEM_ID" ¥NewQueries DOS-machines
参照wcrtqlib, wdel, wgetquery, wruninvquery, wrunquery, wsetquery
wcrtquery
158 Tivoli Management Framework: リファレンス・マニュアル
wcrtrim
RDBMS Interface Module (RIM) オブジェクトを作成します。
構文wcrtrim [-i] -v vendor { -o host_oid | -h host_name } -d database -u user -Hdb_home -s server_id [-I instance_home] [-t instance_name] [-a application_label] [-mmax_connections] rim_name
説明wcrtrim コマンドは、特定の管理対象ノード上に新規 RIM オブジェクトを作成します。 -h オプションまたは -o オプションを使用するときは、wcrtrim コマンドを入力し、RIM オブジェクトが入る Tivoli リージョンにとってローカルな管理対象ノードを指定してください。管理対象ノードの名前またはオブジェクト ID のいずれかを指定しないと、RIM オブジェクトは、Tivoli サーバー上に作成されます。
RIM オブジェクトをいったん作成すると、その RIM オブジェクトのベンダーを変更することはできません。ベンダーを変更しなければならないときは、その RIM
オブジェクトを削除して新たに RIM オブジェクトを作成する必要があります。
注:
1. -I instance_home および -t instance_name オプションは、DB2 データベースによってのみ使用されます。
2. スペースが含まれたパス名を指定する場合、そのパス名を引用符 (″ ″) で囲む必要があります。Windows システムでは、MS-DOS パスも指定できます。たとえば、パス c:¥Program Files¥sqllib を、次のいずれかの方法で指定できます。v "c:¥Program Files¥sqllib"
v c:¥progra~2¥sqllib
オプション-a application_label
RIM オブジェクトのアプリケーション・ラベルを指定します。
注: この引き数は RIM が必要とするものではありません。アプリケーションが使用するために提供されます。
-d database
RIM オブジェクトの接続先データベースの名前 (データベース ID) またはデータ・ソースを指定します。
DB2 DB2 データベース別名またはローカル DB2 データベース名です。
OracleOracle インスタンスの名前です。この名前は、構成接続ファイルのSID オプションです。 ORACLE_SID 変数の値に対応します。
Sybaseアプリケーションが使用するデータベースの名前です。
第 3 章 コマンド (アルファベット順) 159
Microsoft SQLRIM が Microsoft SQL Server データベースへの接続に使用するODBC データ・ソースの名前。
Informix.odbc.ini ファイルで定義されているデータ・ソースの名前です。
-h host_name
RIM オブジェクトが入る管理対象ノードのホスト名を指定します。管理対象ノードは、ローカル Tivoli リージョン内になければなりません。このオプションまたは -o オプションのいずれも指定しないと、 RIM オブジェクトは作成されません。
-H db_home
RDBMS サーバーまたはクライアント・ソフトウェアがインストールされている、 RIM ホストのディレクトリーへの絶対パスを指定します。
注: Windows システムでは、スペースが含まれるパスの値を指定する場合、次のいずれかのフォーマットを使用します。
v ″c:¥Program Files¥sqlib″
v c:¥progra~1¥sqllib
値を二重引用符 (″) で囲まなかった場合またはパス名に波形記号 (~) を含まなかった場合、コマンドの構文解析は失敗します。
DB2 DB2 ソフトウェアをインストールしたディレクトリー。 DB2DIR
変数の値と同じです。
Oracleホーム・ディレクトリー。ORACLE_HOME 変数と同じです。
Sybaseinterfaces ファイルを含むディレクトリー。 SYBASE 変数と同じです。
Microsoft SQLMicrosoft SQL サーバーをインストールしたディレクトリー。
InformixInformix CLI クライアントをインストールしたディレクトリー。INFORMIXDIR 変数の値と同じです。
-i データベース・パスワードを標準入力から読み取ります。このオプションを指定する場合、パスワードは、任意の長さにすることができます。このオプションを指定しない場合には、パスワードを入力するよう促されますが、パスワードは 8 文字以下でなければなりません。
-I instance_home (DB2 のみ)
INSTHOME 変数の値を指定します。この値は、データベース・インスタンスが作成されたホーム・ディレクトリーです。
-m max_connections
RIM オブジェクトと RDBMS 間で許可される接続の最大数を指定します。接続の最大数は、アプリケーションが使用するスレッドの数と同じにするようお勧めします。
wcrtrim
160 Tivoli Management Framework: リファレンス・マニュアル
接続数の範囲は 1 ~ 200 です。デフォルトは、16 個の接続です。
注: この引き数は RIM が必要とするものではありません。アプリケーションが使用するために提供されます。
-o host_oid
RIM オブジェクトが入る管理対象ノードのオブジェクト ID を指定します。管理対象ノードは、ローカル Tivoli リージョン内になければなりません。このオプションまたは -h オプションのいずれも指定しないと、 RIM
オブジェクトは作成されません。
-s server_id
データベースのサーバー ID を指定します。この値により、 RIM ホストがRDBMS に接続できます。
DB2 RIM は値が tcpip であることを要求します。 DB2COMM 変数の値を tcpip に設定してください。
Oracletnsnames.ora ファイル内の Oracle リスナー・サービスの名前。TWO_TASK 変数の値と同じです。
SybaseSybase サーバーの名前。DSQUERY 変数の値と同じです。
Microsoft SQLMicrosoft SQL Server を実行しているホストの名前。
InformixInformix サーバーの名前。INFORMIXSERVER 変数の値と同じです。
-t instance_name (DB2 のみ)
DB2INSTANCE 変数の値を指定します。RIM ホストがデータベース・サーバーと同じマシンの場合、この値は DB2 サーバー・インスタンスの名前でなくてはなりません。RIM ホストがデータベース・サーバーと異なるマシン上にある場合、この値は DB2 クライアント・インスタンスの名前でなくてはなりません。
-u user
RIM オブジェクトがデータベースにアクセスするために使用する、データベース・ユーザーの名前を指定します。
DB2 サーバー・インスタンスとデータベースの使用が許可されているRDBMS ユーザー。 RIM オブジェクトの DB2 ユーザー ID がクライアント・インスタンス名と一致しているか、もしくは RIM オブジェクトの instance_name 属性にクライアント・インスタンス名が設定されていなくてはなりません。
Oracleアプリケーションのデータ・スペースを所有する RDBMS ユーザーです。
Sybaseアプリケーションのデータ・スペースを所有する RDBMS ユーザーです。
wcrtrim
第 3 章 コマンド (アルファベット順) 161
Microsoft SQLアプリケーションのデータ・スペースを所有する RDBMS ユーザーです。
Informixinformix でなければなりません。
-v vendor
ご使用の RDBMS のベンダーを指定します。有効なエントリーは次のとおりです。
v DB2
v Oracle
v Sybase
v MS_SQL
v Informix
rim_name
RIM オブジェクトのラベルを指定します。
権限Tivoli リージョン内の senior または super
例1. 次の例では、RIM オブジェクトが対話式に作成されます。
wcrtrim -v Oracle -h amon-sul -d amar -u tivoli ¥-H /tivoli/drm/2/amishra/ORACLE -s invdb.world inventory
2. 次の例では同じ RIM オブジェクトが作成されますが、パスワードがファイルから読み取られます。
wcrtrim -i -v Oracle -h amon-sul -d amar -u tivoli ¥-H /tivoli/drm/2/amishra/ORACLE -s invdb.world inventory ¥< ./passwd
3. 次の例では、invdh2 RIM オブジェクトを作成し、アプリケーション・レベルをinvdh に設定します。さらに RDBMS 接続の最大数を 10 に設定します。
wcrtrim -v Oracle -h amon-sul -d amar -u tivoli ¥-H /tivoli/drm/2/amishra/ORACLE -s invdb.world ¥-a invdh -m 10 invdh2
参照wdel, wgetrim, wsetrim, wsetrimpw
wcrtrim
162 Tivoli Management Framework: リファレンス・マニュアル
wcrttask
タスク・ライブラリー内にタスクを作成します。
構文wcrttask -t task_name -l library_name [-g group_name] [-u user_name] -r role [-ccomments] -i interp_type node_name file_name...
wcrttask [-F file_name] -t task_name -l library_name [-u user_name] [-ggroup_name] -r role
説明wcrttask コマンドは、指定されたタスク・ライブラリー内にタスクを作成します。タスクとは、指定した管理対象ノードおよびそのサブスクライバー上で実行するメソッドです。タスクを実行するたびに、実行情報を指定する必要があります。
-t オプションと -l オプションのみを指定すると、指定したタスク・ライブラリー内にタスクが作成されますが、実行されません。タスクを作成して即時に実行するには、オプション・セット -i interp_type node_name file_name を指定する必要があります。このセットの場合、タスクを実行するプラットフォームごとに 1 回ずつ、複数回指定することができます。
オプション-c comments
タスクとタスクの目的を識別するための説明のコメントを追加します。
-F file_name
既存タスクに関する情報が入っているファイルを指定します。指定するファイルは、wgettask コマンドを実行することによって作成した tar ファイルでなければなりません。このオプションを使用すると、指定したファイルがインポートされ、そのファイル内の情報を使用して新規タスクが作成されます。このオプションは、ある Tivoli 環境から別の環境へタスクをインポートするときに役立ちます。
-g group_name
タスクを実行するグループの名前を指定します。
-i 管理対象ノードでの新しいタスクの実行に必要な情報を定義します。 -i オプションと共に、次の値を指定する必要があります。
interp_type
タスクの実行先プラットフォームのインタープリター・タイプを指定します。
node_name
指定したプラットフォーム用の実行可能ファイルのある管理対象ノードを指定します。
file_name
指定したプラットフォームで実行する実行可能ファイルの名前を指定します。
第 3 章 コマンド (アルファベット順) 163
-l library_name
タスクを作成するタスク・ライブラリーを指定します。
-r role タスクの実行に必要な許可の役割を指定します。コロンで区切って指定することにより、役割を複数指定できます。たとえば、admin:senior:super です。
-t task_name
新規タスクの名前を指定します。名前の 1 文字目は英字でなければなりません。 2 文字目以降には、英数字、アンダースコアー (_)、ハイフン (-)、ピリオド (.)、またはスペースが可能です。
-u user_name
タスクの実行に使用するユーザー名を指定します。アスタリスク (*) を使用して user_name を現行ユーザー ID (UID) に設定するには、アスタリスクを単一引用符で囲んでください (たとえば、-u ’*’)。
権限admin、senior、super
例1. 以下の例は、my_tasks タスク・ライブラリー内に date_task タスクを作成します。このタスクを実行するには、アドミニストレーターは、super、senior、user のいずれかの役割をもっている必要があります。タスクは、Solaris オペレーティング環境で実行されます。このタスクの実行可能ファイルは、管理対象ノード bald の /bin/date ディレクトリーにあります。コメントも入っています。
wcrttask -t date_task -l my_tasks ¥-r super:senior:user -i solaris2 bald /bin/date ¥-c "This task runs the /bin/date command"
2. 以下の例は、my_tasks タスク・ライブラリー内に find_cores タスクを作成します。このタスクを実行するには、super 役割が必要です。タスクは、デフォルト・プラットフォーム上で実行されます。実行可能ファイルは、管理対象ノードbald の /tmp/find_cores.sh ディレクトリーにあります。このタスクは root で実行されます。
wcrttask -t find_cores -l my_tasks -r super ¥-i default bald /tmp/find_cores.sh ¥-c "This task finds core files and runs as root" -u root
参照wcrtjob, wdeltask, wgettask, wsettask, wtll
wcrttask
164 Tivoli Management Framework: リファレンス・マニュアル
wcrttlib
タスク・ライブラリーを作成します。
構文wcrttlib library_name policy_region_name
説明wcrttlib コマンドは、指定されたポリシー・リージョン内にタスク・ライブラリーを作成します。
オプションlibrary_name
作成するタスク・ライブラリーの名前を指定します。名前の 1 文字目は英字でなければなりません。 2 文字目以降には、英数字、アンダースコアー(_)、ハイフン (-)、ピリオド (.)、またはスペースを使用できます。
policy_region_name
タスク・ライブラリーの作成先のポリシー・リージョンの名前を指定します。
権限admin、senior、super
例以下の例は、bald-region ポリシー・リージョンに my_tasks タスク・ライブラリーを作成します。
wcrttlib my_tasks bald-region
参照wcrtjob, wcrttask
第 3 章 コマンド (アルファベット順) 165
wdate
管理対象ノードの現在の日付と時刻を出力します。
構文wdate node_name
説明wdate コマンドは、指定された管理対象ノードの現在の日付と時刻 (グリニッジ標準時 (GMT)) を出力します。日付は、ロケールに依存する形式で出力されます。
オプションnode_name
日付を出力される管理対象ノードの名前を指定します。
権限user、admin、senior、super
例次の例は、管理対象ノード bald の現在の日付と時刻を示します。
wdate bald
参照wdiskspace, whostid, wifconfig, winstdir, winterp, wmannode, wmemsize,
wping, wtimezone, wuname, wxterm
166 Tivoli Management Framework: リファレンス・マニュアル
wdel
Tivoli データベースからオブジェクトを削除します。
構文wdel [-I] label...
説明wdel コマンドは、Tivoli オブジェクト・データベースから 1 つ以上のオブジェクトを削除します。このコマンドは、Tivoli オブジェクト・データベースの低レベル管理に使用します。デフォルトでは、サブオペレーションが異常終了するとコマンドは異常終了します。 Tivoli Management Framework には、次のような、共通に実行される処理用のコマンドがあります。
wdelepTivoli データベースからエンドポイントを削除します。
wdeljobタスク・ライブラリーからジョブを削除します。
wdelpolデフォルトのポリシー・オブジェクトを削除します。
wdelprポリシー・リージョンを削除します。
wdelschedジョブをスケジューラーから削除します。
wdeltaskタスク・ライブラリーからタスクを削除します。
wrmnodeTivoli データベースから管理対象ノードを削除します。
オプション-I 失敗したすべてのサブオペレーションを無視して、コマンドが処理を続行で
きるようにします。このオプションは、コマンドに複数のラベルを渡す場合にだけ役立ちます。このオプションを使用すると、1 つのオブジェクトの削除が失敗しても、引き続き次のオブジェクトがこのコマンドによって削除されます。このオプションが指定されていない場合、このコマンドは 1 つのオブジェクトを削除できないと、すでに削除されたすべてのオブジェクトを復元してから、エラーとなって終了します。
label... 削除するオブジェクトのラベルを指定します。このオプションの値には、オブジェクト・パスまたは登録名のどちらかを指定できます。オブジェクト・パスは、絶対パス ("/" コレクションで始まるパス)、相対パス (現在の作業コレクションを起点とするパス)、または単純名 (現在の作業コレクションの中での名前) のいずれでも構いません。
第 3 章 コマンド (アルファベット順) 167
権限admin、senior、super
例次の例では、絶対パスを使用して、プロファイル・マネージャー pm2 をsevenup-region ポリシー・リージョンから削除します。
wdel /Administrators/vwilburn/sevenup-region/pm2
参照wdelep, wdelgate, wdeljob, wdelpol, wdelpr, wdelsched, wdeltask, wrm,
wrmnode
wdel
168 Tivoli Management Framework: リファレンス・マニュアル
wdelep
エンドポイントを削除します。
構文wdelep [-d] [-f] endpoint_name ...
説明wdelep コマンドは、指定されたエンドポイントを Tivoli データベースから削除します。 -d オプションを使用すると、エンドポイントを削除する前にそのエンドポイント・サービスをシャットダウンします。
Tivoli リージョンが片方向に相互接続している場合には、Tivoli リージョン境界外にあるエンドポイントを削除することはできません。管理対象でしかも片方向に相互接続されたリージョンからエンドポイントを削除するときは、まず、wunsub コマンドを使用して、管理側のリージョンのすべてのプロファイル・マネージャーからエンドポイントをアンサブスクライブする必要があります。すべてのプロファイル・マネージャーからエンドポイントをアンサブスクライブしてから、ローカルTivoli リージョンで wdelep コマンドを使用してエンドポイントを削除します。
エンドポイントのサブスクライブ先のプロファイル・マネージャーを判別するには、 wlssub コマンドを使用します。
オプション-d lcf.dat ファイルをエンドポイント・システムから削除し、エンドポイント・
サービスをシャットダウンします。
-f エンドポイントを例外なく強制的に削除します。
endpoint_name ...
削除するエンドポイントの名前を指定します。複数のエンドポイントを指定する場合には、それぞれの名前をスペースで区切ります。
権限削除対象のエンドポイントが含まれているポリシー・リージョン内の seniorまたはsuper。
例次の例では、エンドポイント ruby が削除されます。
wdelep ruby
参照wep, wlssub, wunsub
第 3 章 コマンド (アルファベット順) 169
wdelgate
エンドポイント・ゲートウェイを削除します。
構文wdelgate gateway_name
説明wdelgate コマンドは、指定されたゲートウェイを削除します。ゲートウェイを削除した後には、wchknode コマンドを実行して、削除したゲートウェイへの参照をクリーンアップしてください。
オプションgateway_name
削除するゲートウェイの名前を指定します。
権限senior
例次の例は、ゲートウェイ gems を削除します。
wdelgate gems
参照wcrtgate
170 Tivoli Management Framework: リファレンス・マニュアル
wdeljob
タスク・ライブラリーからジョブを削除します。
構文wdeljob job_name task_library_name
説明wdeljob コマンドは、ジョブをタスク・ライブラリーから削除します。
オプションjob_name
削除するジョブの名前を指定します。
task_library_name
ジョブが入っているタスク・ライブラリーの名前を指定します。
権限admin、super、senior
例以下の例は、my_tasks タスク・ライブラリーから date_job ジョブを削除します。
wdeljob date_job my_tasks
参照wcrtjob, wdeltask
第 3 章 コマンド (アルファベット順) 171
wdelpol
デフォルトのポリシー・オブジェクトを削除します。
構文wdelpol -d class name
wdelpol -v class name
説明wdelpol コマンドは、指定されたポリシー・デフォルト・オブジェクト、または指定されたラベルを持つリソースのポリシー検証オブジェクトを削除します。
オプション-d リソースのポリシー・デフォルト・オブジェクトを削除します。-v を指定
しないと、このオプションがデフォルトになります。
-v リソースのポリシー検証オブジェクトを削除します。
class ポリシー・オブジェクトを削除される管理対象リソースのクラスのラベルを指定します。
name 削除するポリシー・オブジェクトの名前を指定します。
権限senior または super
例次の例では、ProfileManager の制限付きポリシー検証オブジェクトを削除します。
wdelpol -v ProfileManager Restricted
参照wchkpol, wcrtpr, wdelpr, wgetdfpol, wgetpolm, wlspol, wlspolm, wputpolm
172 Tivoli Management Framework: リファレンス・マニュアル
wdelpr
ポリシー・リージョンを削除します。
構文wdelpr region
説明wdelpr コマンドは、指定されたポリシー・リージョンを削除します。
オプションregion 削除するポリシー・リージョンを指定します。ポリシー・リージョンは空で
なければなりません。
権限削除するポリシー・リージョン内の senior 役割。
例次のそれぞれの例で、DefaultRegion ポリシー・リージョンが削除されます。
wdelpr /Regions/DefaultRegion
wdelpr @PolicyRegion:DefaultRegion
wdelpr @DefaultRegion
参照wcrtpr
第 3 章 コマンド (アルファベット順) 173
wdelsched
スケジューラーからジョブを除去します。
構文wdelsched [-b ’mm/dd/yyyy hh:mm’] [-a ’mm/dd/yyyy hh:mm’]
wdelsched -s id ...
説明wdelsched コマンドは、ジョブをスケジューラーから削除します。オプションを何も指定しないと、すべてのジョブに関する情報が削除されます。-a オプションと-b オプションは、特定の時刻範囲に入るジョブを限定するために使用します。 -sオプションは、ジョブの ID 番号によってジョブを指定するために使用します。
オプション-a ’mm/dd/yyyy hh:mm’
この時刻より後にスケジュールされているジョブを指定します。
-b ’mm/dd/yyyy hh:mm’
この時刻より前にスケジュールされているジョブを指定します。
-s id... ジョブ ID を指定します。
権限super、senior、admin
例1. 次の例では、1998 年 5 月 6 日午前 1 時より前、および 1998 年 5 月 8 日午後 1 時より後に実行するようスケジュールされているジョブをすべて削除します。
wdelsched -b ’05/06/1998 01:00’ -a ’05/08/1998 13:00’
2. 次の例では、ジョブ ID 876 と 934 が削除されます。
wdelsched -s 876 -s 934
参照wedsched, wenblsched, wgetsched, wschedjob, wstartsched
174 Tivoli Management Framework: リファレンス・マニュアル
wdeltask
タスク・ライブラリーからタスクを削除します。
構文wdeltask task_name task_library_name
説明wdeltask コマンドは、タスクをタスク・ライブラリーから削除します。
オプションtask_library_name
タスクが入っているタスク・ライブラリーの名前を指定します。
task_name
削除するタスクの名前を指定します。
権限admin、senior、super
例以下の例は、my_tasks タスク・ライブラリーから date_task タスクを削除します。
wdeltask date_task my_tasks
参照wcrttask, wdeljob
第 3 章 コマンド (アルファベット順) 175
wdepot
MDist 2 の配布内容を (一時的または永続的に) 保管するリポジトリーである、MDist 2 リピーター保管庫を管理します。
構文wdepot repeater_name add ″id^version″ [source_host:]path_name
wdepot repeater_name delete ″id^version″ ″filter″
wdepot repeater_name describe
wdepot repeater_name image ″id^version″ [source_host:]path_name image_dir
wdepot repeater_name list [″filter″] [-l]
wdepot repeater_name purge
説明wdepot コマンドは、MDist 2 リピーター保管庫を管理します。このコマンドは、保管庫へのセグメントの追加、保管庫エントリーの削除、保管庫の構成情報の表示、配布イメージの作成、既存保管庫のリスト、および保管庫エントリーのパージを実行する機能を提供します。
オプションadd ″id^version″ [source_host:]path_name
指定したセグメントを使用して、エントリーを保管庫に追加します。オプションは次のとおりです。
″id^version″ファイル・セグメントの ID とバージョンを指定します。スペースを含める場合には、ID とバージョンを脱字記号 (^) で区切ります。次に例を示します。
"Tivoli^3.7.1"
path_name
ソース・ファイルの完全パスとファイル名を指定します。 Windows
オペレーティング・システムでは、パス名にドライブ名 (たとえば、C:¥) が入っているときは、 source_host オプションを指定する必要があります。
source_host
ソース・ファイルのホスト名を指定します。指定しなかった場合は、ローカル・ホストがデフォルトとして使用されます。
delete ″id^version″ ″filter″リピーターのキュー内の配布によって現在ロックされているエントリー (
filter で指定された) を削除します。 ″id^version″ は、ファイル・セグメントの ID とバージョンを指定します。削除する前に、コマンドから確認のプ
176 Tivoli Management Framework: リファレンス・マニュアル
ロンプトが出されます。 filter オプションでは、アスタリスク (*) などのワイルドカード文字がサポートされます。
describeロケーション、サイズ、一時ストレージ、永続ストレージ、合計ストレージ、およびフリー・スペースなどの保管庫の構成設定を表示します。これらのオプションは、wmdist コマンドで変更できます。
image ″id^version″ [source_host:]path_name image_dir
ファイル・サーバーまたは CD からのインストール時に使用する配布イメージを作成します。オプションは次のとおりです。
″id^version″ファイル・セグメントの ID とバージョンを指定します。スペースを含める場合には、ID とバージョンを脱字記号 (^) で区切ります。次に例を示します。
"Tivoli^3.7.1"
source_host
ソース・ファイルのホスト名を指定します。指定しなかった場合は、ローカル・ホストがデフォルトとして使用されます。
path_name
ソース・ファイルの完全パスとファイル名を指定します。 Windows
オペレーティング・システムでは、パス名にドライブ名 (たとえば、C:¥) が入っているときは、 source_host オプションを指定する必要があります。
image_dir
イメージの作成場所であるイメージ・ディレクトリーの完全パスを指定します。
list [″filter″] [-l]リピーター保管庫内のすべてのエントリーをリスト表示します。このオプションを使って、セグメントが占めているディスク・スペース量を表示したり、いずれかのセグメントが不要となっているかどうかを判断できます。また、保管庫内容のリストを表示して、プリロードした内容を再確認したり、データがそこに置かれたままかどうかを調べたりすることもできます。オプションは次のとおりです。
″filter″ リスト表示するエントリーを指定します。フィルターを指定しないと、保管庫内のすべてのエントリーがリスト表示されます。 filter
オプションでは、アスタリスク (*) などのワイルドカード文字もサポートされます。
-l それぞれのエントリーごとにすべての情報がリスト表示されます。指定しないと、ID、バージョン、サイズ、完了率、および最終変更時刻の情報のみがリスト表示されます。
purge アクティブな配布用を除き、保管庫内のすべてのエントリーを削除します。保管庫のパージの前に、ユーザーに確認を求めるプロンプトが出されます。リピーターのキュー内のアクティブ配布を削除する方法については、wmdist コマンドの説明を参照してください。
wdepot
第 3 章 コマンド (アルファベット順) 177
repeater_name
リピーターのラベル、オブジェクト ID、または管理対象ノード ID を指定します。
権限add、delete、image、および purge の各オプションを使用するには、admin 許可の役割が必要です。
describe オプションおよび list オプションを使用するには、Tivoli 許可の役割が必要です。
例1. 次の例では、ID が Tivoli でバージョンが 3.7.1 のエントリーを、リピーター
banshee の保管庫に追加します。ソース・ホストは seesaw、パス名は /data です。
wdepot banshee add "Tivoli^3.7.1" seesaw:/data
2. 次の例は、リピーター banshee の保管庫内のすべての内容をリスト表示します。
wdepot banshee list
3. 以下の例は、banshee リピーター上のバージョン ver1 の program_a_install 保管庫エントリーの詳細情報をリスト表示します。
wdepot banshee list "program_a_install^ver1" -l
4. 次の例は、リピーター banshee の保管庫内の文字 T で始まるすべての項目と項目バージョンをリスト表示します。
wdepot banshee list "T*"
5. 次の例は、リピーター banshee の保管庫の詳細情報をリスト表示します。
wdepot banshee list -l
Entry #1:Id: program_a_installVersion: ver1Bytes received: 6755840(100%)Location: /net/futura/programs/proram_a.tar.gzCreation time: 2000/04/04 14:11:31Last modification time: 2000/04/04 14:11:31Receive time: 2000/04/04 14:11:31Last access time: 2000/04/04 14:11:31Update time: 2000/04/04 14:11:31Access count: 0Modification count: 1Reference count: 1Storage status: PermanentEntry #2:Id: program_a_dataVersion: ver1Bytes received: 13511680(100%)Location: /data/program_a_data.tar.gzCreation time: 2000/04/18 14:08:46Last modification time: 2000/04/18 14:08:46Receive time: 2000/04/18 14:08:46Last access time: 2000/04/18 14:08:46Update time: 2000/04/18 14:08:46Access count: 0
wdepot
178 Tivoli Management Framework: リファレンス・マニュアル
Modification count: 1Reference count: 0Storage status: Permanentroot@reality>
-l オプションを指定しないと、ID、バージョン、サイズ、完了率、および最終変更時刻の情報だけが表示されることに注意してください。
6. 次の例は、リピーター banshee の保管庫内の文字 T で始まるすべてのエントリーを削除します。
wdepot banshee delete "T*"
7. 次の例では、リピーター banshee の保管庫の構成を表示します。
wdepot banshee describe
Depot Location = /usr/local/Tivoli/rpt_dir/depot/Depot Size = 512000 (KB)Temporary Storage = 0 (KB)Permanent Storage = 0 (KB)Total Storage = 0 (KB)Free Space = 512000 (KB)
8. 以下の例は、antivirus ファイルのイメージを banshee リピーター上に作成してから、seesaw という名前のソース・ホスト上の C:/data ディレクトリーにそのイメージを転送します。
wdepot banshee image "Tivoli^3.7.1" seesaw:C:/temp/antivirus C:/data
参照wmdist
wdepot
第 3 章 コマンド (アルファベット順) 179
wdepset
実行する必要のあるメソッドの依存関係を指定します。
構文wdepset -c dependency_label [-C class] {-a depset nested_dependency_set} | -a tag
path [+p prefix_path [+a]] [+x] ...
wdepset -e dependency_set {-r tag path} | {-r depset nested_dependency_set} | {-adepset nested_dependency_set} | -a tag path [+p prefix_path [+a]] [+x]}...
wdepset -d dependency_set
wdepset -v dependency_set
wdepset -r dependency_set
説明wdepset コマンドは、実行する必要のあるメソッドの依存関係を指定します。このコマンドは、依存関係セットを作成、削除、編集、表示、または解決するのに使用できます。
wdepset -c コマンドを使用して依存関係を指定してから、 wchdep コマンドを使って依存関係セットをメソッド・ヘッダーと関連付けます。
依存関係セットを作成する際、依存関係のタイプ (たとえば、bin、lib、または$INTERP) を指定するタグを組み込みます。
通常、wdepset コマンドはオブジェクト・データベースの afterscript 内か、またはアプリケーションの .ist ファイル内にあります。
オプション-a 依存関係セットに特性を追加します。
+a サブディレクトリーのパスのベース名だけが prefix_path に追加されるよう指定します。
注: このオプションは、+p オプションの修飾子としてのみ使用されます。
-c 依存関係セットを作成します。
-C DependencyMgr オブジェクトでない場合の、依存関係クラス・オブジェクトの名前です。
-d 依存関係セットを削除します。
-e 依存関係セットを編集します。
+p エンドポイントのキャッシュがいっぱいになるときに、従属ファイルがエンドポイントから削除されないようにします。
-r 依存関係セットを解決する、または依存関係セットから特性を除去します。
-v 依存関係セットを表示します。
180 Tivoli Management Framework: リファレンス・マニュアル
+x エンドポイントが、他の依存関係を受け取る前で、なおかつメソッドを実行する前に、依存関係を実行しなければならないようにします。
dependency_label
新規の依存関係オブジェクトに割り当てられるラベルです。@DependencyMgr: という接頭部であってはなりません。
dependency_set
依存関係セットの名前です。 @DependencyMgr:label という書式のラベルとして、またはオブジェクト ID (OID) として指定できます。
nested_dependency_set
ネストされた依存関係セットの名前です。 @DependencyMgr:label という書式のラベルとして、またはオブジェクト ID として指定できます。
path ファイルへのパスを表します。これは相対パスです。 先頭のスラッシュ (/)
は無視されます。ゲートウェイ上のどのディレクトリーに対して相対的であるかは、タグによって判別されます。エンドポイント上のどのディレクトリーに対して相対的であるかは、タグと prefix_path によって判別されます。パスのスラッシュ (/) は、円記号を要求するエンドポイント上では円記号(¥) に変換されます。
prefix_path
依存関係をダウンロードする際に、$LCF_CACHEDIR ではなく、エンドポイント上のディレクトリーをベース・ディレクトリーとして使用するよう指定します。こうした依存関係は、キャッシュ外の依存関係 と呼ばれます。prefix_path には、絶対パスまたは相対パスが使用できます。相対パスの場合には、$LCF_DATDIR に対して相対です。
パスのスラッシュ (/) は、円記号を要求するエンドポイント上では円記号(¥) に変換されます。
+a オプションが指定されない場合には、エンドポイント・ロケーションは、 $BINDIR/../lcf_bundle.40 に対して相対的なゲートウェイ・ロケーションを prefix_path に追加して形成されます。
prefix_path をキャッシュ・ディレクトリーに設定する場合でも、依存関係は依然キャッシュ外と見なされ、キャッシュがいっぱいになっても除去の対象になりません。
tag 以下のいずれかの定義された解決タグです。
bin 依存関係を、ゲートウェイの $BINDIR/../lcf_bundle/bin/$INTERP ディレクトリーに常駐するバイナリー・プログラムとして識別します。 ファイルへのパスは、エンドポイントのインタープリター・タイプに基づいて、実行時に解決されます。 依存関係を bin に指定する場合には、 wdepset コマンドに拡張子を含めないでください。拡張子は、必要な場合には自動的に追加されます。
depsetこの依存関係は、別の依存関係セットです。 これにより、依存関係セット同士をネストできます。
lib 依存関係を、ゲートウェイの $BINDIR/../lcf_bundle/lib/$INTERP ディレクトリーに常駐する共用ライブラリーとして識別します。 ファイルへのパスおよび共用ライブラリー拡張子は、エンドポイントの
wdepset
第 3 章 コマンド (アルファベット順) 181
インタープリター・タイプに基づいて、実行時に解決されます。 依存関係を lib に指定する場合には、 wdepset コマンドに拡張子を含めないでください。
すべてのプラットフォームの共通ライブラリーとリンクする場合には、 wdepset コマンドへのエントリーを 1 つだけにする必要があります。ライブラリーがエンドポイントにダウンロードされるときに、適切な拡張子が追加されます。
一部のインタープリター・タイプには共用ライブラリーを使用し、その他のタイプには静的ライブラリーを使用するのが、アプリケーションにとって都合の良い場合があります。 lib タグは、このような場合をサポートします。静的ライブラリーを使用するインタープリター・タイプの場合には、ライブラリーをゲートウェイ上のディレクトリーには入れないでください。ゲートウェイが、ライブラリーが存在しないことを通知する場合には、依存関係を無視します。
$INTERP
このインタープリター・タイプに設計されたエンドポイント用にのみ、ファイルをダウンロードします。依存関係を $INTERP に指定する場合には、wdepset コマンドにファイル拡張子を含めてください。
genericインタープリター・タイプにかかわらず、依存関係ファイルを各エンドポイント用にダウンロードします。パス解決は実行されません。ですから、依存関係へのパスを提供する必要があります。
権限admin、senior、super
例1. 次の例では、依存関係セット hello_dependency を作成し、hello_library という名前のライブラリーとして識別します。依存関係は、ゲートウェイ上の$BINDIR/../lcf_bundle/lib/$INTERP/hello_library$SL から、エンドポイント上の$LCF_CACHEDIR/lib/$INTERP/hello_library$SL にダウンロードされます。
wdepset -c hello_dependency -a lib hello_library
2. 次の例では、依存関係セット my_label_dependency を作成し、 sys:/tivoli のキャッシュ外のロケーションとして指定します。
wdepset -c my_label_dependency -a nw4 sentry/nw4/sentry.nlm +p sys:/tivoli
依存関係セットは、sys:/tivoli/sentry/nw4 ディレクトリーに配置されます。
参照wchdep
wdepset
182 Tivoli Management Framework: リファレンス・マニュアル
wdisconn
2 つの Tivoli リージョンの接続を切断する。
構文wdisconn [-s] region_name
wdisconn [-s] -r region_number
説明wdisconn コマンドは、2 つの Tivoli リージョン間の接続を切断します。リソースの交換後の 2 つの Tivoli リージョンの切断は時間がかかるプロセスなので、慎重に実行する必要があります。このコマンドは Tivoli リージョンのリソースのみを除去します。データベースの整合性を保ちながらコレクション内のいずれかのオブジェクトを除去するには、Tivoli リージョンの切断後に必ず -ux オプションを指定した wchkdb コマンドを実行します。
オプション-r region_number
リモート Tivoli リージョンのリージョン番号を指定します。リージョン名を使用できない場合、このオプションは必須です。
-s 切断する接続が片方向の接続であることを指定します。他の Tivoli サーバーを接続しようとしないでください。誤って片方向接続の両端を管理サーバーとして指定した場合や、接続の両端に同じリージョン番号を指定した場合に、このオプションを使用することができます。このオプションは、もう一方に影響を与えないで、一方の接続だけを切断します。そうすれば、正確な情報を用いて Tivoli リージョンを再接続することができます。
region_name
リモート Tivoli リージョンの名前を指定します。リージョン名は、サーバーのインストール時に作成された初期ポリシー・リージョンの名前と同じです。
権限super
例1. 次の例では、リージョン番号 4000447345 がローカル Tivoli リージョンから切断されます。
wdisconn -r 4000447345
2. 次の例では、Tivoli リージョンの writers-Region がローカル・リージョンから切断されます。この場合、writers-Region Tivoli リージョンのみが切断されます。
wdisconn -s writers-Region
第 3 章 コマンド (アルファベット順) 183
参照wchkdb, wconnect, wlsconn, wupdate
wdisconn
184 Tivoli Management Framework: リファレンス・マニュアル
wdiskspace
管理対象ノードの使用可能なディスク・スペースを出力します。
構文wdiskspace node_name directory
説明wdiskspace コマンドは、指定されたディレクトリー (またはファイル・システム)
の使用可能なディスク・スペース (KB) を出力します。
オプションdirectory
使用可能なディスク・スペースを調べるディレクトリーを指定します。ディレクトリーは、絶対パスで指定する必要があります。
node_name
使用可能なディスク・スペースを調べる管理対象ノードを指定します。
権限user、admin、senior、super
例次の例では、管理対象ノード bald 上の /tmp ディレクトリー内にある使用可能ディスク・スペースが表示されます。
wdiskspace bald /tmp
11747
参照wdate, whostid, wifconfig, winterp, wmannode, wmemsize, wping,
wtimezone, wuname, wxterm
第 3 章 コマンド (アルファベット順) 185
wdistrib
1 つ以上のプロファイル・コピーを配布します。
構文wdistrib [-l maintain | over_all | over_opts | over_all_no_merge] [-m] [-r]
name [subscriber...]
説明wdistrib コマンドは、プロファイルの 1 つまたは複数のコピーをそのサブスクライバーに配布します。このコマンドはサブスクライバー・データベースを更新し、また Tivoli データベースの構成ファイルも更新します。 name オプションは、配布するプロファイル、またはすべてのプロファイルの配布元となるプロファイル・マネージャーを指定します。配布先のサブスクライバーは、subscriber で指定します。サブスクライバーをまったく指定しないと、コマンドは、すべてのサブスクライバーを更新します。
-m オプションを指定すると、プロファイルはすべてのレベルのサブスクライバーに配布されます。このオプションを指定しないと、プロファイルは次のレベルのサブスクライバーのみに配布されます。
-l オプションは、配布レベルを識別します。このオプションを指定しないと、maintain がデフォルトになります。
注: プロファイルの配布は、プロファイルがどのアプリケーション用向けに作成されたかに基づきます。以下にリストされているオプションは、アプリケーション固有のプロファイルを選択する上で無効もしくは適用不可の場合もあります。
オプション-l maintain | over_all | over_opts | over_all_no_merge
配布レベルを指定します。maintain オプションは、ローカル変更を保持します。 over_all オプションは、ローカル変更を上書きします。 over_optsオプションは、すべてのレコードを組み合わせて、配布します。over_all_no_merge オプションは、指定されたプロファイルのみを配布します。
-m 複数ステップの配布を指定します。
-r プロファイル・マネージャーへのプロファイルの配布、またはプロファイル・マネージャーからのプロファイルの検索が、1 つ以上失敗した場合に、戻りコードを 1 に設定します。
name 配布されるプロファイルの名前、またはすべてのプロファイルの配布元となるプロファイル・マネージャーの名前。有効な形式は、次のとおりです。
v @profile_type:profile_name
v /Regions/policy_region_name/profile_manager_name/profile_name
186 Tivoli Management Framework: リファレンス・マニュアル
subscriber...
プロファイル・コピーの配布先である Tivoli リソースの名前を指定します。有効な形式は、次のとおりです。
v @ManagedNode:node_name
v /Regions/policy_region_name/profile_manager_name
権限admin、senior、super
例1. 次の例では、Development プロファイル・マネージャーに入っているプロファイルが、そのプロファイル・マネージャーのすべてのサブスクライバーに配布されます。このプロファイルに加えられたすべてのローカル変更が保持されます。
wdistrib /Regions/Development
2. 以下の例では、サブスクライバーの pinatubo と rushmore、およびプロファイル・マネージャー Marketing に Admin プロファイルが配布されます。プロファイルは Marketing のサブスクライバーには配布されません。すべてのローカル変更は、この配布によって上書きされます。
wdistrib -l over_all @UserProfile:Admin pinatubo ¥rushmore @ProfileManager:Marketing
3. 次の例では、Admin プロファイルがプロファイル・マネージャー Sales に配布されます。プロファイルはさらに、Sales にサブスクライブされているエンドポイントやプロファイル・マネージャーにも配布されるようになります。
wdistrib -m @UserProfile:Admin @ProfileManager:Sales
参照wcrtprf, wcrtprfmgr, wgetprf, wgetsub, wlssub, wpopulate, wsub, wunsub,
wvalidate
wdistrib
第 3 章 コマンド (アルファベット順) 187
wdisttask
タスク・ライブラリーのタスク・ バイナリーの配布をコントロールします。
構文wdisttask -q library_name
wdisttask -s library_name mode
wdisttask -d library_name task_name
説明wdisttask コマンドは、タスク・ライブラリーの配布モードの照会や設定を行うことができます。また、タスク・バイナリーの配布を強制的に発生させることができます。
タスク・バイナリーは、ローカル・リージョンの Tivoli サーバー上に置いておく(ALI モード) ことができますが、ローカル・リージョン内のすべてのファイル・サーバーに配布したり (LOCAL モード)、接続している各 Tivoli リージョン内にあるすべてのファイル・サーバーに配布したりする (GLOBAL モード) こともできます。 GLOBAL モードを使用するのは、タスク・バイナリーがローカル・ファイル・システムに存在することが Tivoli ベースのアプリケーションで必要とされるときのみにしてください。グローバル配布は、リソースを集中的に使用する操作で、一時的にネットワークをスローダウンさせる場合があります。
オプション-d タスク・バイナリーの配布を即時に発生させます。
-q タスク・ライブラリーの配布モードを判別します。
-s タスク・ライブラリーの配布モードを設定します。
library_name
タスク・ライブラリーを指定します。
mode タスク・ライブラリーの配布に使用するモードを指定します。モードは、次のいずれかです。
ALI ローカル Tivoli リージョンの Tivoli サーバー上にのみタスク・バイナリーを保管するよう指定します。
GLOBAL接続しているそれぞれの Tivoli リージョン内にあるすべてのファイル・サーバーに、タスク・バイナリーのコピーを配布します。 同じファイル・サーバーを共用する 2 つ以上のリージョンへのグローバル配布を実行すると、その配布は失敗します。
LOCALローカル Tivoli リージョン内のすべてのファイル・サーバーに、タスク・バイナリーのコピーを配布します。
188 Tivoli Management Framework: リファレンス・マニュアル
task_name
配布するタスク・バイナリーを指定します。
例1. 次の例では、abc というタスク・ライブラリーの配布モードが照会されます。
wdisttask -q abc
2. 次の例では、abc タスク・ライブラリーの配布モードが変更されます。
wdisttask -s abc LOCAL
3. 次の例では、abc タスク・ライブラリー内にある rm_core_files タスクのバイナリーが即時に配布されます。
wdisttask -d abc rm_core_files
参照wcrttask, wgettask
wdisttask
第 3 章 コマンド (アルファベット順) 189
wdskspc
使用可能なディスク・スペースの量を検査します。
構文wdskspc [-q] [-f output_file] [-s required_size] volume_label
説明wdskspc コマンドは、指定されたボリューム上の使用可能なディスク・スペースの量を戻します。このコマンドは、Windows および NetWare エンドポイントから実行できます。
-s オプションを指定すると、必要なディスク・スペースが使用可能な場合には戻りコードとしてゼロが戻り、そうでない場合はゼロ以外の値が戻ります。省略すると、使用可能なディスク・スペース量の合計が表示されます。
オプション-f output_file
情報またはエラーを指定された出力ファイルにリダイレクトします。
-q -s オプションを指定したかどうかに応じて、戻される情報を、必須ディスク・スペースまたは使用可能ディスク・スペースに限定します。
-s required_size
必要なディスク・スペースの量を指定します。このオプションには、次のいずれかのサフィックスを付けることができます。
k キロバイト
m メガバイト
g ギガバイト
このオプションでは、使用可能ディスク・スペースの合計量は表示されません。
volume_label
指定されたボリュームまたはディスクについて、ボリュームまたはディスク上の使用可能ディスク・スペースの量を戻します。
戻り値-s オプションを指定すると、このコマンドは次のいずれか 1 つを戻します。
0 コマンドが、指定量のディスク・スペースが使用可能なことを識別したことを示します。
ゼロ以外必要なディスク・スペースが使用不可です。
190 Tivoli Management Framework: リファレンス・マニュアル
例1. 以下の例は、C: ドライブに 10 MB の使用可能なディスク・スペースがあるかを検査します。
wdskspc -s 10m C:¥
2. 以下の例は、C: ドライブ上の使用可能ディスク・スペースの合計を調べます。
wdskspc C:¥
3. 以下の例は、NetWare マシン上の SYS ボリュームに 20 MB の使用可能ディスク・スペースがあるかを調べます。
wdskspc -s 20m SYS:
wdskspc
第 3 章 コマンド (アルファベット順) 191
wdtmsg
Tivoli デスクトップを始動する際に表示されるメッセージをカスタマイズします。
構文wdtmsg {-g | -s ″message″}
説明wdtmsg コマンドを使用すると、ユーザーが Tivoli デスクトップを始動する際に表示するメッセージを作成できます。メッセージはダイアログに表示され、ユーザーはこのメッセージに応答する必要があります。
オプション-g Tivoli デスクトップを始動する際に表示されるメッセージを戻します。
-s ″message″Tivoli デスクトップを始動する際に表示されるメッセージを設定します。
権限senior または super
例1. 次の例では、″You are entering a secured zone (セキュア・ゾーンに入力しています。)″ というデスクトップ・メッセージを設定します:
wdtmsg -s "You are entering a secured zone"
2. 次の例では、定義済みのデスクトップ・メッセージを除去します。
wdtmsg -s ""
3. 次の例では、定義済みのデスクトップ・メッセージを戻します。
wdtmsg -g
192 Tivoli Management Framework: リファレンス・マニュアル
weditini
.INI ファイル内のグループ、変数、および値を変更します。このコマンドはエンドポイントから実行する必要があります。
構文weditini [-r] -g section_name [-n variable_name] [-v value] file_name
説明weditini コマンドは、.INI ファイルの内容を編集します。このコマンドを使用すると、このファイルのセクションへの変数や値の追加、変数またはセクションの削除、指定した変数の値の置換ができます。
オプション-g section_name
処理対象の .INI ファイル内のセクションの名前を指定します。存在しないセクションに対する変数の追加を指定すると、セクションが作成された後に変数が追加されます。
-n variable_name
追加、置換、または削除する変数の名前を指定します。
-r 指定されたセクションまたは変数を削除します。
-v value
-n オプションで指定された変数に対して追加または置換する値を指定します。
file_name
編集するファイルの完全パスを指定します。
戻り値このコマンドは、次のいずれかを戻します。
0 コマンドが .INI ファイルを編集したことを示します。
ゼロ以外コマンドが .INI ファイルを編集しなかったことを示します。
例1. 以下の例は、DefaultDirectory 変数を c:¥windows¥system.ini ファイル内の
UserSettings セクションに追加して、その値を c:¥work ディレクトリーに設定します。
weditini -g UserSettings -n DefaultDirectory -v c:¥work ¥ -c:¥windows¥system.ini
2. 以下の例は、c:¥windows¥system.ini ファイルから UserSettings グループを除去します。
weditini -r -g UserSettings c:¥windows¥system.ini
第 3 章 コマンド (アルファベット順) 193
参照wmrgini
weditini
194 Tivoli Management Framework: リファレンス・マニュアル
wedsched
スケジューラーに現存するジョブを編集します。
構文wedsched [-c ’time_period’ | OFF] [-C {daytime | nighttime | weekday |
weekend} {from to | OFF}] [-D] [-d desktop... | OFF] [-f file | OFF] [-h host] [-ggroup | OFF] [-m email | OFF] [-l label] [-o] [-R ’time_period’ | ’iterations’ | OFF]
[-r ’time_period’ | ’iterations’ | OFF] [-t ’mm/dd/yyyy hh:mm’] id
説明wedsched コマンドを使用すると、アドミニストレーターは、スケジューラーの中に現在存在しているジョブを編集できます。アドミニストレーターは、編集するジョブの ID が必要です。この ID は、wgetsched コマンドを使用して調べることができます。
オプション-c ジョブがキャンセルされる時点を指定します。有効なオプションは次のとお
りです。
’time_period’
スケジュールのとおりにジョブが開始されない場合にジョブがキャンセルされる時点を指定します。数値 (時間) と時間の単位を指定しなければなりません。時間の単位は、minute、hour、day のいずれかです。たとえば ’3 hour’ と指定した場合、ジョブが当初の予定開始時刻から 3 時間後にまだ開始していないと、そのジョブは取り消されます。
OFF 取り消し機能をオフにします。ジョブは取り消されません。
-C ジョブの実行に関する条件または制約事項を指定します。 from オプションは、開始日または開始時刻です。 to オプションは、終了日と終了時刻のどちらかです。時刻は、24 時間時計により入力する必要があります (たとえば、午前 9 時は 9:00、午後 2 時は 14:00)。曜日は数値で入力する必要があります。日曜日は 0、土曜日は 6 になります。有効なオプションは次のとおりです。
daytime from to | OFF日中のみジョブを実行するよう指定します。 OFF オプションを指定すると、この制約は解除されます。
nighttime from to | OFF夜間のみジョブを実行するよう指定します。 OFF オプションを指定すると、この制約は解除されます。
weekday from to | OFF平日のみジョブを実行するよう指定します。 OFF オプションを指定すると、この制約は解除されます。
第 3 章 コマンド (アルファベット順) 195
weekend from to | OFF週末のみジョブを実行するよう指定します。 OFF オプションを指定すると、この制約は解除されます。
-d 何らかのアクションがジョブに対して実行されたときに「状況」ウィンドウをデスクトップ上に表示するかどうかを指定します。有効なオプションは次のとおりです。
desktop...
ジョブで処理が実行されたときに「状況」ウィンドウの表示先となるデスクトップを指定します。複数のデスクトップを指定できます。
OFF 何らかのアクションがジョブに対して実行されたときに「状況」ウィンドウを表示しないよう指定します。
-D ジョブを無効にします。ジョブはスケジューラー内に残されたままですが、使用可能になるまで実行されません。
-f 何らかのアクションがジョブに対して実行されたときにジョブ状況をファイルに書き込むかどうかを指定します。有効なオプションは次のとおりです。
file ジョブで処理が実行されたときのジョブ状況の書き込み先ファイルを指定します。ファイルを指定する場合、-h オプションを使用して、ファイルへの書き込みが行われるホストを指定する必要があります。
OFF ジョブ状況をファイルに書き込まないように指定します。
-g 何らかのアクションがジョブに対して実行されたときにジョブ状況を Tivoli
通知グループに送信するかどうかを指定します。有効なオプションは次のとおりです。
group ジョブで処理が実行されたときに、ジョブ状況の送信先となる通知グループを指定します。複数の通知グループを指定できます。
OFF ジョブ状況を通知グループに送信しないように指定します。
-h host
ジョブ状況ファイルの書き込み先ホストを指定します。 -f オプションと同時に指定しなければなりません。
-l label
ジョブのこのインスタンスに固有の名前を指定します。
-m 何らかのアクションがジョブに対して実行されたときにジョブ状況を電子メール・アドレスに送信するかどうかを指定します。有効なオプションは次のとおりです。
email ジョブで処理が実行されたときに、ジョブ状況の送信先となる電子メール・アドレスを指定します。複数の電子メール・アドレスを指定できます。
OFF ジョブ状況を電子メール・アドレスに送信しないように指定します。
-o -t オプションで示された時刻が過去であることを指定します。警告メッセージを指定変更します。
wedsched
196 Tivoli Management Framework: リファレンス・マニュアル
-r 反復情報を指定します。iterations オプションを指定した場合は、ジョブは有限回数繰り返されます。次のオプションの 1 つを指定する必要があります。
’time_period’
ジョブを繰り返す間隔を指定します。数値 (時間) と時間の単位を指定しなければなりません。時間の単位は、minute、hour、day、week、month、year のいずれかです。たとえば ’3 hour’ と指定すると、ジョブは 3 時間おきに繰り返されます。
’iterations’
ジョブを繰り返す回数を指定します。時間間隔、時間の単位、反復回数を指定する必要があります。時間の単位は、minute、hour、day、week、month、year のいずれかです。たとえば ’3 hour 6’
と指定した場合、ジョブは、3 時間ごとに 6 回再試行されます。
OFF 反復機能をオフにします。ジョブは反復されません。
-R 再試行情報を指定します。iterations オプションを指定した場合は、ジョブは有限回数再試行されます。次のオプションの 1 つを指定する必要があります。
’iterations’
ジョブを再試行する回数を指定します。時間間隔、時間の単位、再試行回数を指定する必要があります。時間の単位は、minute、hour、day のいずれかです。たとえば ’3 hour 6’ と指定した場合、ジョブは、3 時間ごとに合計 6 回再試行されます。
’time_period’
ジョブを再試行する間隔を指定します。数値 (時間) と時間の単位を指定しなければなりません。時間の単位は、minute、hour、dayのいずれかです。たとえば ’3 hour’ と指定した場合、ジョブは、完了するまでに 3 時間ごとに再試行されます。
OFF 再試行機能をオフにします。ジョブは、正常に完了しなかった場合は再試行されません。
-t ’mm/dd/yyyy hh:mm’
ジョブ実行が最初にスケジューリングされる時刻を指定します。日付と時刻を任意の順に入力できます。日付のみ、または時刻のみを入力することもできます。時刻を入力して日付を入力しないと、ジョブは現在の日付の指定時刻に実行されます。日付を入力して時刻を入力しないと、ジョブは指定した日付の現在の時刻に実行されます。時刻は、24 時間時計により入力する必要があります (たとえば、午前 9 時は 9:00、午後 2 時は 14:00)。
id ジョブ ID を指定します。
権限super、senior、admin
例1. 次の例では、ジョブ 782 の開始時刻が 1998 年 11 月 30 日午後 6 時に変更されます。 (ジョブ ID を知るには、wgetsched コマンドを使用してください。)
wedsched
第 3 章 コマンド (アルファベット順) 197
wedsched -t ’18:00 11/30/1998’ 782
2. 次の例では、ジョブ 35 が編集されます。この例では、取り消し機能をオフにし、成功するまで 1 日 1 回再試行するよう設定されます。ジョブ状況はファイルに書き込まれず、Tivoli Diagnostics 通知グループに送信されます。
wedsched -c OFF -R ’1 day’ -f OFF ¥-g ’Tivoli Diagnostics’ 35
3. 次の例では、毎週月曜日から金曜日まで実行されるようにジョブ 728 が編集されます。
wedsched -r ’1 day’ -C ’weekday 1 5’ 728
4. 次の例では、ジョブ 28 に関する制約事項が週末 (土曜日と日曜日) から平日(月曜日から金曜日まで) に変更されます。
wedsched -C ’weekend OFF’ -C ’weekdays 1 5’ 28
参照wdelsched, wenblsched, wgetsched, wschedjob, wstartsched
wedsched
198 Tivoli Management Framework: リファレンス・マニュアル
wenblsched
スケジュールされているジョブを無効にしたり、有効にします。
構文wenblsched [-b ’mm/dd/yyyy hh:mm’] [-a ’mm/dd/yyyy hh:mm’] [-d]
wenblsched [-s id [-s id]...] [-d]
wenblsched -e
説明wenblsched コマンドを使用すると、アドミニストレーターは、スケジュールされているジョブを無効または有効にすることができます。ジョブは、無効にされるとスケジュールどおりに実行されません。オプションを何も指定しないと、すべてのジョブが有効または無効になります。 -a オプションと -b オプションは、特定の時刻範囲に入るジョブを限定するために使用します。 -s オプションは、ジョブのID 番号によってジョブを指定するために使用します。 -d オプションは、スケジュールされているジョブを無効にするために使用します。 -e オプションは、スケジュールされたジョブの暗号化レベルを同期化するために使用します。
オプション-a ’mm/dd/yyyy hh:mm’
この時刻より後にスケジュールされているジョブを指定します。
-b ’mm/dd/yyyy hh:mm’
この時刻より前にスケジュールされているジョブを指定します。
-d ジョブを無効にします。
-e スケジュールされたジョブの暗号化レベルを、odadmin set_encrypt_levelコマンドによる Tivoli リージョンの暗号化レベルへの変更と同期化します。 Tivoli リージョン内のすべての管理対象ノードを再始動した後、即時に wenblsched-e コマンドを実行してください。
-s id... ジョブ ID を指定します。複数の ID を指定できます。
権限admin、senior、super
例1. 次の例では、1998 年 5 月 6 日午前 1 時より前、および 1998 年 5 月 8 日午後 1 時より後に実行するようスケジュールされているジョブがすべて使用可能にされます。
wenblsched -b ’05/06/1998 01:00’ -a ’05/08/1998 13:00’
2. 次の例では、ジョブ ID 529 および 734 が無効にされます。
wenblsched -s 529 -s 734 -d
第 3 章 コマンド (アルファベット順) 199
参照wdelsched, wedsched, wgetsched, wschedjob, wstartsched
wenblsched
200 Tivoli Management Framework: リファレンス・マニュアル
wep
エンドポイント・リストに入っているエンドポイント情報に関してアクションを実行します。
構文wep
wep endpoint_label
wep endpoint_label get {suboptions}
wep help [option]
wep ls [-d delimiter] [-g gateway_label] [-i suboptions]
wep endpoint_label migrate [-f] gateway_label
wep migrate_to_pref {-a | -d | -n} [-f] [-g gateway_label]
wep endpoint_label set {suboptions}
wep set gateway {-e endpoint_label | -g gateway_label}
wep set interfaces {-e endpoint_label | -g gateway_label} gateway_hostname+port
[:gateway_hostname+port]...
wep endpoint_label set_config suboptions
wep endpoint_label set_label [-s] new_label
wep endpoint_label status
wep sync_gateways
wep endpoint_label upgrade {disable | enable}
拡張オプションwep boot_method add tag prototype_object method_name endpoint_oid ...
wep boot_method list tag endpoint_oid ...
wep boot_method remove tag endpoint_oid ...
wep boot_method test tag endpoint_oid ...
wep del endpoint_oid gateway_label ...
wep view endpoint_oid gateway_label ...
注: 拡張オプションについては、 209ページの『拡張オプション』に説明があります。
第 3 章 コマンド (アルファベット順) 201
説明wep コマンドは、エンドポイント・マネージャーが保守するエンドポイント・リストに入っているエンドポイント情報に関してアクションを実行します。このコマンドを使用すると、Tivoli リージョン内のエンドポイントとそれに割り当てられたゲートウェイのリスト表示、エンドポイント情報の取り出しとその設定、ゲートウェイからゲートウェイへのエンドポイントのマイグレーション、Tivoli リージョン内の他のエンドポイントのデータの更新を行うことができます。
get オプションが指定された wep コマンドは指定されたエンドポイントの情報を取得し、ls および -g オプションが指定された wep コマンドは指定されたゲートウェイとそのエンドポイントの情報を取得し、ls オプションが指定された wep コマンドは複数のゲートウェイのすべてのエンドポイントに関する情報を取得します。
注: エンドポイントの ID (OID) を指定するときは、 211ページの『例』に示されているとおり、必ず正符号 (+) を付けてください。
オプションget suboption, ...
エンドポイント・リストから endpoint_label という名前のエンドポイントに関する指定された情報を検索します。複数の属性に関する情報を要求できますが、それぞれのサブオプションをコンマで区切る必要があります。
注: サブオプションの省略形が未確定でなければ、省略形を利用できます。last_login_time を指定する代わりに、省略形 last_l を利用できます。このサブオプションの場合、省略形 last はあいまいなので、この省略形は利用できません。
サブスクリプションは次のとおりです。
addressネットワーク・アドレス。
all 指定されたエンドポイントのすべての属性。
crypt_mode NONE | DES
エンドポイントがゲートウェイと通信する際に、56 ビット DES 暗号化を使用するかどうかを指定します。 NONE に設定すると、通信は暗号化されません。 DES に設定すると、通信は暗号化されます。
gateway割り当てられたゲートウェイ。
httpd HTTP パスワード。HTTP パスワードは、Web ブラウザーによってエンドポイント情報を変更するために使用されます。
id 指定されたエンドポイントの固有のインベントリー ID。
interp 指定されたエンドポイントで稼働するインタープリター・タイプまたはオペレーティング・システム。
label エンドポイント・ラベル。
wep
202 Tivoli Management Framework: リファレンス・マニュアル
last_login_timeエンドポイントの最後のログイン時刻。
last_method_timeエンドポイントでの最後のメソッド呼び出し時刻。
last_migration_timeエンドポイントが最後にマイグレーションされた時刻。
login_mode (Windows オペレーティング・システム のみ)
モバイル・コンピューティング・コンソールによる配布のコントロールにエンドポイントが使用可能か使用不可かどうか、およびユーザーがこのエンドポイント・モードを変更できるかどうかを指定します。モバイル・モードの場合、エンドポイントは使用可能ですが、デスクトップ・モードの場合は使用不可です。
mac_addressエンドポイントで Wake on LAN 機能が使用可能な場合は、エンドポイントの MAC アドレス。エンドポイントで Wake on LAN 機能が使用不可な場合、このサブオプションは値 NONE を戻します。
netload現行の netload 設定
object エンドポイントのオブジェクト ID。
policy エンドポイントが置かれているポリシー・リージョン。エンドポイントがポリシー・リージョンに置かれていない場合、このコマンドの結果は OBJECT_NIL になります。
preferred_gatewayエンドポイントの優先ゲートウェイ。エンドポイントに優先ゲートウェイがない場合、このコマンドの結果は OBJECT_NIL になります。
protocolエンドポイントで使用するネットワーク・プロトコル。
subnet_maskエンドポイントで Wake on LAN 機能が使用可能な場合は、エンドポイントのサブネット・マスク。エンドポイントで Wake on LAN
機能が使用不可な場合、このサブオプションは値 NONE を戻します。
upgrade_modeエンドポイントがアップグレード可能または不可のどちらであるかを表示します。
versionエンドポイントのバージョン番号。
help [option]
指定されたコマンド・オプションの使用法情報を表示します。コマンド・オプションを指定しないと、使用法ステートメントが表示されます。
wep
第 3 章 コマンド (アルファベット順) 203
ls [-d delimiter] [-g gateway_label] [-i suboption, ...]
ゲートウェイとそれに関連したエンドポイントに関する情報がリスト表示されます。オプションは次のとおりです。
-d delimiter
-i オプションを使って表示されるデータで使用される区切り文字を変更します。デフォルトの区切り文字はコンマです。
注: HTTP パスワード・フィールドにはタブは入れられませんが、コンマや他のよく使用される区切り文字を入れることはできます。
-g gateway_label
指定されたゲートウェイとそれに関連したエンドポイントに関する情報を表示します。
-i suboption, ...
ゲートウェイとそれに関連したエンドポイントのエンドポイント・リストから追加情報を取り出します。 get オプションのセクションにリスト表示されているサブオプションを使用してください。 それぞれをコンマで区切ることによって、複数のサブオプションを指定できます。
migrate [-f] gateway_label
エンドポイントをマイグレーションします。また、オプションで、エンドポイントを、割り当てられたゲートウェイから指定のゲートウェイに強制的にマイグレーションします。エンドポイントとは通信しません。エンドポイント・マネージャーとゲートウェイのデータのみが更新されます。次回エンドポイントとゲートウェイが通信をとりあったときに、エンドポイントはマイグレーションされたことを検出します。 -f オプションを指定すると、指定されたゲートウェイが停止中でもエンドポイントは強制的にマイグレーションされます。
migrate_to_pref {-a | -d | -n} [-f] [-g gateway_label]
優先ゲートウェイが使用可能であれば、そこにエンドポイントをマイグレーションします。このマイグレーションは、migrate オプションを使用した場合に似ています。エンドポイントとは通信しません。エンドポイント・マネージャーとゲートウェイのデータのみが更新されます。
-a すべてのエンドポイントが優先ゲートウェイにマイグレーションされます。
-d 現在優先ゲートウェイに割り当てられていないエンドポイントのリストを表示します。エンドポイントはマイグレーションされません。
-f 優先ゲートウェイが停止中でも、エンドポイントは強制的にマイグレーションされます。
-g gateway_label
指定された優先ゲートウェイに関連付けられたエンドポイントのみをマイグレーションします。
-n すべての非モバイル・エンドポイントが、その優先ゲートウェイにマイグレーションされます。
wep
204 Tivoli Management Framework: リファレンス・マニュアル
set suboption, ...
endpoint_label という名前のエンドポイントに関する指定の情報を設定します。
注: サブオプションの省略形が未確定でなければ、省略形を利用できます。last_login_time を指定する代わりに、省略形 last_l を利用できます。このサブオプションの場合、省略形 last はあいまいで未確定なので、この省略形は利用できません。
サブスクリプションは次のとおりです。
address endpoint_address
エンドポイントの IP アドレスを設定します。
crypt_mode NONE | DES
エンドポイントがゲートウェイと通信する際に、56 ビット DES 暗号化を使用するかどうかを指定します。 NONE に設定すると、通信は暗号化されません。 DES に設定すると、通信は暗号化されます。
注: エンドポイントおよびゲートウェイ間で変更を同期化するためには、sync_gateways オプションを使用する必要があります。
httpd [user:password]
エンドポイントの HTTP パスワードを設定します。HTTP パスワードは、Web ブラウザーによってエンドポイント情報を変更するために使用されます。パスワードを変更した後、エンドポイント、ゲートウェイ、およびエンドポイント・マネージャーで一斉に変更を同期化するために、sync_gateways オプションを使用する必要があります。
login_mode -m {mobile | desktop} -s {variable | constant} (Windows
オペレーティング・システムのみ)
エンドポイントのログイン・モードを設定します。-m オプションに mobile 値を指定すると、モバイル・エンドポイントが指定されます。 -m オプションに desktop 値を指定すると、非モバイル・エンドポイントが指定されます。モバイル・エンドポイントのユーザーのみがモバイル・コンピューティング・コンソールを利用して配布の受信およびコントロールを行うことができます。 -s オプションに variable 値を指定すると、そのユーザーがエンドポイント・モードを変更できるように設定されます。 -s オプションにconstant 値を指定すると、そのユーザーがエンドポイント・モードを変更できないように指定されます。
注: エンドポイントおよびゲートウェイ間で変更を同期化するためには、sync_gateways オプションを使用する必要があります。
netload value
ゲートウェイから指定のエンドポイントに送信されるデータの転送速度をバイト/秒で指定します。この値をゼロに設定すると、このオプションは無視されます。この値を正の整数に指定すると、その値はゲートウェイの wmdisttarget_netload 値を指定変更しますが、
wep
第 3 章 コマンド (アルファベット順) 205
wmdist net_load の値は依然として監視されます。この値を負の整数に設定すると、その値は wmdist target_netload およびnet_load の値を指定変更して、ゲートウェイはデータを可能な限り速くエンドポイントを送信します。
preferred_gateway {gateway_label | nil}
優先ゲートウェイを、指定したゲートウェイに設定します。優先ゲートウェイを削除するには、nil を使います。
upgrade_mode enable | disable
エンドポイントを更新可能にするかどうかを設定します。
set gateway {-e endpoint_label | -g gateway_label}
エンドポイントに現在割り当てられているゲートウェイをそのエンドポイントに知らせます。指定されたエンドポイントを更新するには、-e オプションを使用します。指定されたゲートウェイに割り当てられたすべてのエンドポイントを更新するには、-g オプションを使用します。
set interfaces {-e endpoint_label | -g gateway_label} gateway_hostname+port
gateway_IP_address+port [:gateway_hostname+port | :gateway_IP_address+port] ...
エンドポイントがログインできる 1 つ以上のゲートウェイのアドレスとポートを設定します。このインターフェースのセットは、そのエンドポイントが分離状態になった場合に、エンドポイントが使用するエンドポイント用のゲートウェイのリストになります。指定されたエンドポイント用にインターフェースを設定するには、-e オプションを使用します。指定されたゲートウェイに割り当てられたすべてのエンドポイント用にインターフェースを設定するには、 -g オプションを使用します。複数のゲートウェイ・アドレスを指定できます。複数のアドレスを指定する場合は、それぞれをコロンで区切ってください。
set_config suboption
Tivoli リージョン内のどの管理対象ノードからも、エンドポイント・オプションを設定できます。エンドポイント構成情報は、エンドポイントのLast.cfg ファイルに格納されます。このコマンドを使用する際、1 つのみのサブオプションが指定できます。指定するサブオプションにもよりますが、変更が有効になるようにエンドポイントを停止して再始動しなければならない場合があります。次のようなサブオプションがあります。
allow_proxy_upcalls=true | false
エンドポイントとその割り当てられたゲートウェイ間のすべての通信が、エンドポイント上の構成済みターゲット・ポートを使用するかどうかを指定します。 true に設定すると、エンドポイントとゲートウェイはターゲット・ポートのみを使用して通信します。エンドポイントがプロキシー・アップコールを使用できるようになる前に、エンドポイントはプロキシー対応のゲートウェイへの接続を確立していなければなりません。 false に設定される場合には、エンドポイントとその割り当てられたゲートウェイは通常の仕方で通信します。このオプションを使用すると、last.cfg ファイル内のallow_proxy_upcalls の値が変更されます。デフォルトは false
です。
depot_dir=path
マルチキャスト配布がインストールされるまで、それらが保管され
wep
206 Tivoli Management Framework: リファレンス・マニュアル
るエンドポイント上のディレクトリーを指定します。 このオプションを使用すると、 last.cfg ファイル内の depot_dir の値が変更されます。 デフォルト・ディレクトリーは、$LCF_DATDIR/depot です。相対パスを指定すると、保管庫ディレクトリーは$LCF_DATDIR 変数に対して相対になります。
detect_address_change=TRUE | FALSE
エンドポイントがネットワーク・インターフェース構成の変更を検出して、必要な場合は修正アクションを実行するかどうかを指定します。このオプションを TRUE に設定すると、エンドポイントはアドレス変更に対してネットワーク・インターフェース構成をモニターします。エンドポイント変更の listen アドレスに変更があった場合、エンドポイントはゲートウェイへのログ・バックを試みます。(この listen アドレスは、local_ip_interface オプションを使用して設定します。) このオプションは Windows 2000、Windows XP、および Windows Server 2003 システムでのみ使用できます。デフォルトは FALSE です。
diag_interval=seconds
エンドポイントが、エンドポイントが待機する、一連の自己診断機能テストの実行間隔を秒で指定します。これらのテストは、エンドポイントのタスクとメソッドを実行する能力を判断するのに役立ちます。テストには、一時ファイル・スペースと許可、およびキャッシュ・スペースと許可の検査が含まれています。 Windows オペレーティング・システムでは、テストにはトークンの作成およびプロセス作成の検査も含まれます。テストが完了すると、その結果はlcfd.log ファイルに保管されます。エンドポイントがログインしている場合、結果は現行ゲートウェイに送られます。この値をゼロに設定すると、テストはゲートウェイが要求した場合にのみ実行されます。デフォルトはゼロです。値の許容範囲は 900 秒 (15 分) ~86400 秒 (1 日) です。
diag_temp_space=bytes
diag_interval オプションでコントロールされた自己診断機能テストの実行用の望ましい最小一時スペースをバイトで設定します。この値をゼロに設定すると、テストは実行されません。デフォルトはゼロです。最小値は 1024 です。
filefree_upcalls=TRUE | FALSE
統合アップコールがアップコール・データをディスクに書き込むかどうかを指定します。この設定は、allow_proxy_upcalls が TRUE
に設定されている場合にのみ有効です。この場合、デフォルトではアップコール・データはディスクに書き込まれます。アップコール・データがディスク以外の場所に書き込まれるようにするには、filefree_upcalls を TRUE に設定すると、すべてのアップコール・ディスクは転送されます。 このオプションを使用すると、 last.cfg
ファイル内の filefree_upcalls の値が変更されます。 デフォルトは FALSE です。
lcfd_autostart=TRUE | FALSE
Windows エンドポイントがエンドポイント・サービスの自動開始を
wep
第 3 章 コマンド (アルファベット順) 207
設定するかどうかを指定します。この値を TRUE に設定すると、Windows エンドポイントは、エンドポイントの始動時とエンドポイントのシャットダウン時に 1 回ずつ Windows エンドポイント・サービスを検査します。エンドポイント・サービスが手動 (Manual)
に設定されている場合、エンドポイントはサービスを自動(Automatic) にリセットします。この値を FALSE に設定すると、エンドポイントは Windows エンドポイント・サービスの設定を検査しません。デフォルト値は FALSE です。
lcs.machine_unique_id=ID_string
エンドポイントの固有の ID を指定します。 ID_string の値は、Tivoli 環境 内で固有のストリングでなくてはなりません。ストリングの長さは 36 文字以下でなくてはなりません。この値は$LCF_DATDIR/lcf.id ファイルに保管されます。
log_threshold=integer
識別済みのエンドポイント用のファイルをトレースするための、詳細な書き込みのレベルを指定します。このオプションを使用すると、 last.cfg ファイル内の log_threshold の値が変更されます。指定できる整数値の範囲は、1 ~ 4 で、 1 は詳細レベルが最も低く、4 は最も高いレベルとなります。 デフォルトは 1 です。
login_attempts=value
エンドポイントがリスト内の次のゲートウェイに対して試行を開始するまでの、ゲートウェイに対する指定ログイン試行回数。指定ログイン試行とは、最終既知ゲートウェイまたはログイン・インターフェース・リスト内のゲートウェイへのログイン試行です。デフォルトは 3 です。
login_timeout=seconds
エンドポイントが指定ログイン試行への応答を待つ時間 (秒) を指定します。指定ログイン試行とは、最終既知ゲートウェイまたはログイン・インターフェース・リスト内のゲートウェイへのログイン試行です。デフォルト値は 300 秒 (5 分) です。
repair_accts=TRUE | FALSE
エンドポイントが tmersrvd アカウントおよびTivoli_Admin_Privileges グループのインストールと構成をテストして、必要な場合は修理を行うかどうかを指定します。このオプションを TRUE に設定すると、エンドポイントは始動の際に 1 回この検査を行い、lcfd.log ファイルに記述されている修正アクションを実行します。このオプションを FALSE に設定すると、この検査は実行されません。デフォルト値は FALSE です。
repair_tap=TRUE | FALSE
エンドポイントが Tivoli 認証パッケージのインストールと構成をテストして、必要な場合は修理を行うかどうかを指定します。このオプションを TRUE に設定すると、エンドポイントは始動の際に 1 回この検査を行い、lcfd.log ファイルに記述されている修正アクションを実行します。このオプションを FALSE に設定すると、この検査は実行されません。デフォルト値は FALSE です。
wep
208 Tivoli Management Framework: リファレンス・マニュアル
web_post_interval=seconds
エンドポイントが、イベントおよび状態変更情報を Web サーバーに通知する間隔 (秒) を指定します。情報が送られるのは、この間隔内でイベントまたは状態変更が生じた場合のみです。最小値は300 秒 (5 分) です。最大値は 86,400 秒 (1 日) です。デフォルト値はゼロです。このオプションをゼロに設定すると、エンドポイント Web 通知は使用不可になります。
web_post_url=URL
エンドポイントがイベントおよび状態変更情報を通知する宛先 URL
を指定します。以下の URL の構文例を参考にして入力してください。
http://web_server_name:port/relative_path_to_cgi_script/script_name
注: デフォルト・ポート 80 を使用している場合は、ポート番号を指定する必要はありません。
set_label [-s] new_label
指定されたエンドポイントのラベルを変更します。ゲートウェイを同期し、新ラベルを使ってそのエンドポイントを更新するには、-s オプションを使います。このコマンドはエンドポイントと通信します。
status new_label
指定されたエンドポイントの状況をリスト表示します。状況は、"alive" または "endpoint may be unreachable" のいずれかです。このコマンドはエンドポイントと通信します。
sync_gatewaysエンドポイント・マネージャー、ゲートウェイ、および Tivoli リージョン内のエンドポイントで格納されているエンドポイント・データを同期させます。エンドポイントまたはポリシー・リージョン用の HTTP パスワードを変更したり、暗号化の設定を変更する場合や、『拡張オプション』に示されているオプションのいずれかを使用する場合、更新を有効にするにはこのオプションを使用する必要があります。このオプションは、いくつかのエンドポイントにおけるデータ更新を一度に行うようスケジュールされたジョブにおいて有用です。
注: エンドポイントのポリシー・リージョンを変更するには、wmv コマンドを使用してください。
upgrade disable | enable
エンドポイントをアップグレード可能にするかどうかを指定します。
endpoint_label
サブオプションが実行されるエンドポイントを識別します。オプションを指定しないと、指定されたエンドポイントのすべての情報を表形式で表示します。
拡張オプションwep コマンドの拡張機能の含意が不明な場合は、次のいずれかの操作を実行する前にサポート・プロバイダーにご相談ください。
wep
第 3 章 コマンド (アルファベット順) 209
del endpoint_oid gateway_label
epmgr.bdb ファイルからエンドポイントを削除します。それぞれのゲートウェイごとに別個の .bdb ファイルがあるので、エンドポイントに割り当てられているゲートウェイのラベルを指定する必要があります。ゲートウェイ・ラベルを調べるには、wep コマンドを発行する際に ls オプションを指定します。wep コマンドを発行する際に del オプションを指定すると、エンドポイントへのすべての参照が完全には削除されません。エンドポイントへのすべての参照を削除するには、wdelep コマンドを使用します。
view endpoint_oid gateway_label
$DBDIR/epmgr.bdb ディレクトリーの中の、該当ゲートウェイに関連した.bdb ファイルに格納されているエンドポイント情報を表示します。このコマンドは、エンドポイント・マネージャーの内部キャッシュを検索しません。ゲートウェイ・ラベルを調べるには、wep コマンドを発行する際に lsオプションを指定します。
以下のコマンドは、アプリケーション開発者が (Tivoli アプリケーション開発環境、つまり ADE を使用して) 作成したブート・メソッドをエンドポイントに対して実行するよう構成する場合に使用します。これらのオプションを使用して、エンドポイントのインストール中またはアプリケーション・プロファイルの配布中にブート・メソッドを設定します。これらのメソッドは、エンドポイントがゲートウェイにログインするたびに実行されます。
boot_method add tag prototype_object method_name endpoint_oid...
指定ブート・メソッドをエンドポイントに追加します。指定の詳細は、次のとおりです。
tag ユーザー指定の名前を指定します。
prototype_object
メソッドを実装する、プロトタイプ OID (オブジェクト ID) を指定します。
method_name
メソッドの名前を指定します。
endpoint_oid
メソッドが実行されるエンドポイントのオブジェクト ID (OID) を指定します。 OID はそれぞれ、スペースで区切ります。
boot_method list tag endpoint_oid
エンドポイント上の指定されたブート・メソッドのプロトタイプ・オブジェクト番号とメソッド名を表示します。
boot_method remove tag endpoint_oid...
指定されたブート・メソッドをエンドポイントから削除します。
boot_method test tag endpoint_oid
エンドポイント上の指定されたブート・メソッドを起動します。
権限v get、status、および ls オプションを使用してエンドポイント情報を表示する場合: user または admin
wep
210 Tivoli Management Framework: リファレンス・マニュアル
v set gateway -e オプションを使用してエンドポイント用ゲートウェイを設定する場合: senior または super
v help オプションを使用してヘルプ情報を表示する場合: user、admin、senior、または super
v set httpd コマンドを使用して HTTP パスワードを設定する場合: エンドポイントのポリシー・リージョン内の senior または super
v get httpd コマンドを使用して HTTP パスワードを表示する場合: エンドポイントのポリシー・リージョン内の admin
v migrate、set interfaces、set gateway -g、または sync_gateways オプション使用して、エンドポイントをマイグレーションし、すべてのエンドポイントのゲートウェイを設定するか、エンドポイントのデータを同期化する場合: Tivoli
リージョンの senior または super
例1. 次の例では、ゲートウェイ jadams-gateway に割り当てられているエンドポイントが表示されます。
wep ls -g jadams-gateway
1849216842.3.522+#TMF_Endpoint::Endpoint# zoomzoom1849216842.4.522+#TMF_Endpoint::Endpoint# liliana-3121849216842.5.522+#TMF_Endpoint::Endpoint# miura
2. 次の例では、エンドポイント ep4624 用のエンドポイント・リストに入っているすべての情報が戻されます。
wep ep4624
object 1769863560.6.522+#TMF_Endpoint::Endpoint#label ep4624
version 41100id 2E3B4610-1233-11D8-BE66-9401145B01BC
gateway 1769863560.1.578#TMF_Gateway::Gateway#pref_gateway 1769863560.1.578#TMF_Gateway::Gateway#
netload OBJECT_NILinterp w32-ix86
login_mode desktop, constantprotocol TCPIPaddress 9.41.21.50+4624
mac address (WOL) 00:03:14:24:c2:09subnet mask (WOL) 255.255.255.0
policy OBJECT_NILhttpd tivoli:;jMYe9^xalias OBJECT_NIL
crypt_mode NONEupgrade_mode enable
last_login_time 2003/11/10-10:12:53last_migration_time 2003/11/10-10:12:52
last_method_time 2003/11/10-10:12:53
3. 次の例では、エンドポイント cookG のネットワーク・アドレスが戻されます。
wep cookG get lab,address
cookG,146.84.26.26+9494
4. 次の例では、エンドポイント cookG の無作為に生成された HTTP パスワードが戻されます。
wep
第 3 章 コマンド (アルファベット順) 211
wep cookG get httpd
tivoli:WBHtK’y3
ここで、
tivoli
ユーザー名を表します。
: 区切り文字
wBHtK’y3
パスワードを表します。
5. 次の例では、エンドポイント 1802218143.13.500 上の test18 ブート・メソッドのプロトタイプ・オブジェクトとメソッド名が戻されます。
wep boot_method list test18 1802218143.13.500+
Boot Method(s) for Endpoint 1802218143.13.500+TagPrototype ObjectMethod Nametest181802218143.13.500admin
6. 以下の例は、エンドポイント msistrunk での現在のログイン・モードを取得します。
wep msistrunk get login_mode
desktop, constant
7. 以下の例は、エンドポイント msistrunk の優先ゲートウェイを消去します。
wep msistrunk set preferred_gateway nil
参照wdelep, wmdist, wmv
wep
212 Tivoli Management Framework: リファレンス・マニュアル
wepmgr
エンドポイント・マネージャー用のコントロールおよび構成機能を提供します。
構文wepmgr fsck
wepmgr get
wepmgr help [attribute]
wepmgr ping
wepmgr restart
wepmgr set attribute...
wepmgr start
wepmgr stop
wepmgr test_label endpoint_label
wepmgr update
説明wepmgr コマンドは、エンドポイント・マネージャー用のコントロールおよび構成機能を提供します。このコマンドを使用して、エンドポイント・マネージャーを始動、停止、および再始動することができます。さらに、このコマンドでは、Tivoli
オブジェクト・データベース内のエンドポイント・マネージャー属性を取得および設定して、エンドポイントのログインをコントロールすることができます。
オプションfsck エンドポイント・マネージャーのエンドポイント・データから取り出したデ
ータを、Tivoli ネーム・レジストリー・エンドポイント・リソースに再書き込みします。
get エンドポイント・マネージャー・オブジェクト属性のリストを戻します。
help [attribute]
コマンドの使用法ステートメントまたは指定された属性についての情報を表示します。
ping エンドポイント・マネージャーが実行中かどうかを検査します。
restartエンドポイント・マネージャーを再始動します。
set attribute...
Tivoli オブジェクト・データベース内のエンドポイント・マネージャーのオ
第 3 章 コマンド (アルファベット順) 213
ブジェクト属性を設定します。その属性のリストを戻すには、get オプションを使います。属性を即時に有効化するには、update オプションを使います。属性値は次のとおりです。
automigrate {off | on | nonmobile}
優先ゲートウェイが使用可能になったら、エンドポイントをそのゲートウェイにマイグレーションするかどうかを指示します。この値のデフォルトは off ですが、これは、エンドポイントは優先ゲートウェイにマイグレーションされないことを示します。エンドポイントをマイグレーションさせるには、automigrate を on またはnonmobile に設定します。ゲートウェイが使用可能になったら、それを優先ゲートウェイとしているすべてのエンドポイントは、そのゲートウェイにマイグレーションします。
注: 属性を nonmobile に設定していると、このマイグレーションからモバイル・エンドポイントは除外されます。自動マイグレーションから除外する必要のあるエンドポイントの場合、優先ゲートウェイを消去するために、set preferred_gateway オプションを指定した wep コマンドを実行します。
chk_cntl_chars value
これを 1 に設定すると、エンドポイント・ラベルの制御文字が禁止されます。無効なエンドポイント・ラベルが allow_install_policyスクリプトで検出されます。このスクリプト内の既存のラベルは上書きすることができます。デフォルト値は 0 ですが、デフォルトでは、エンドポイント・ラベルは制御文字については検査されません。
ep_hostname_resolution 0 | 1エンドポイント・マネージャーが IP アドレスにエンドポイント・ホスト名を解決するかどうかを指定します。エンドポイントのアドレスは、通常は IP アドレスもしくは IPX アドレスとして保管されます。ただし、(odadmin set_allow_NAT TRUE を使用して)
NAT が使用可能になっている場合、エンドポイント・アドレスは完全修飾ホスト名として保管できます。デフォルトでは、エンドポイント・マネージャーは、エンドポイント・ポリシー・スクリプトまたはログ・メッセージでの使用のためにアドレスを転送する前にホスト名を解決して IP アドレスに変換します。この属性を 0 に設定すると、ホスト名解決は使用不可になります。エンドポイント・アドレス解決がパフォーマンス上の問題を引き起こす場合 (たとえば、エンドポイント・アドレスが解決不能な場合など) は、この値を使用してください。この属性を 1 に設定すると、ホスト名解決は使用可能になります。これはデフォルト値です。
注: この属性を 0 に設定すると、エンドポイント・ポリシー・メソッド内の endpoint_address の値にはホスト名か IP アドレスを指定できます。エンドポイント・ポリシー・メソッドの詳細については、 451ページの『エンドポイント・ポリシー・メソッド』を参照してください。
wepmgr
214 Tivoli Management Framework: リファレンス・マニュアル
epmgr_flags value
これを 1 に設定すると、オーファンのエンドポイント情報が再び取り込まれます。オーファン・エンドポイントとは、以前 Tivoli 管理リージョン (TMR) に属していたが、もう ls オプション付きのwep コマンド出力には表示されなくなったエンドポイントのことです。これは、データベースの復元、不注意による削除、またはデータベース破壊が原因で起きることがあります。このエンドポイントは、分離ログインの実行中でエンドポイント・マネージャーによって再び取り込まれ、このエンドポイントの新規ディスパッチャー番号が作成されます。デフォルトは 0 です。
invalid_chars ’regular_expression’
初期ログインでのエンドポイント・ラベル内で使用禁止にする文字を指定します。デフォルト値は空のリストです。無効なエンドポイント・ラベルが allow_install_policy スクリプトで検出されます。このスクリプト内の既存のラベルは上書きすることができます。
labelspace ’regular_expression’
エンドポイント・ラベルのネーム・スペースを定義し、初期ログイン時にエンドポイント・ラベルを強制的に正規表現に準拠させます。エンドポイント・ラベルで使用できる一連の文字 (たとえば、’^[A-Za-z0-9$^_]*$’) を指定するには、正規表現を使います。指定された表現にラベルが準拠していない場合、そのエンドポイントはTivoli リージョンに接続できません。
注: 無効なエンドポイント・ラベルは allow_install_policy スクリプトで検出されます。このスクリプト内の既存のラベルは上書きすることができます。
log_dir directory
epmgrlog およびすべての epmgrlog.timestamp ログ・ファイルのローカル・システム上のディレクトリーを指定します。
log_size size_in_bytes
epmgrlog ファイルのリファレンス・サイズをバイトで指定します。リファレンス・サイズに達すると、epmgrlog ファイルが epmgrlog.
にコピーされます。 timestamp ファイルと新規の epmgrlog ファイルが作成されます。最大ファイル・サイズは 10485760 バイト (10
メガバイト) です。デフォルトのファイル・サイズは 1048576 バイト (1 メガバイト) です。
logging_level value
epmgrlog ファイルに書き込むロギングのレベルを指定します。各ロギング・レベルには、より低いロギング・レベルからのロギング情報が含まれます。たとえば、ロギング・レベル 3 には、ロギング・レベル 0、1、2 のロギング情報が含まれます。このオプションで、ロギングの以下のレベルを指定できます。
0 エラー、およびエラーである可能性の高い条件のみ。
1 エラーまたは警告と考えられる例外イベント。
2 その他の例外条件。
wepmgr
第 3 章 コマンド (アルファベット順) 215
3 エンドポイント・マネージャーのブート情報。
4 エンドポイント・マネージャー要求およびエンドポイント・ログイン試行に関する情報。これはデフォルト・レベルです。
5 冗長ログイン情報。
6 ある特定のエンドポイント・マネージャー要求に関する冗長情報。
7 デバッグ情報。
8 冗長デバッグ情報。
login_interval value
この間隔はゲートウェイとエンドポイント・マネージャーによって使われ、同じネットワーク・アドレスからのログインを無視する時間値を秒数で指定します。このインターバルを使用すれば、同じエンドポイントから初期ログインが重複して行われないようになります。デフォルト値は 270 秒です。新しい設定を有効にするには、ゲートウェイを再始動する必要があります。
場合によっては、1 つの login_interval で複数のログインを行うことができます。たとえば、エンドポイントの初期ログイン要求後およびアップグレード後のログインは無視されません。エンドポイントのログインの詳細については、「Tivoli Management Framework
デプロイメントの計画ガイド」を参照してください。このログイン・フィルターをオフにするには、login_interval を 0 に設定します。
login_limit value
許可する並行エンドポイント・マネージャー・ログインの最大数を指定します。エンドポイント・マネージャー・ログインには、分離、マイグレーション、初期、およびオーファンの各種ログインがあります。デフォルト値は、max_epmgr_rpc_threads オプションの値の 80% です。これは、エンドポイント・マネージャー・スレッドの約 20% はログイン用以外のメソッドのために予約済みであるためです。この値の 0 の設定は、すべてのログインが禁止されます。
max_epmgr_rpc_threads value
エンドポイント・マネージャーが開始できるスレッドの最大数を指定します。一般的に、エンドポイント・マネージャーが提供する各メソッドは 1 スレッドを必要とします。このオプションは、オブジェクト・ディスパッチャー用に対応する値より小さい値に設定してください。 (odadmin get_rpc_max_threads コマンドを使用してオブジェクト・ディスパッチャーの値を表示できます。) このように、エンドポイント・マネージャーはオブジェクト・ディスパッチャーのスレッドをすべて使い果たすわけではありません。このオプションのデフォルト値は 250 です。
wepmgr
216 Tivoli Management Framework: リファレンス・マニュアル
max_after value
並行して実行できる after_install_policy スクリプトの数を指定します。デフォルトは 10 です。
max_iom_records value
ネーム・レジストリーに情報を再挿入するバッチごとにエンドポイント・エントリー数を指定します。この値は、fsck オプションで使われます。デフォルトは 500 です。
max_install value
並行して実行できる allow_install_policy スクリプトの数を指定します。デフォルトは 10 です。
max_sgp value
並行して実行できる select_gateway_policy スクリプトの数を指定します。デフォルトは 10 です。
migrate_max value
同時に自動的にマイグレーションできるエンドポイントの最大数を指定します。デフォルトはゼロです。値ゼロは、制限が無いことを意味します。
stanza_interval value
epmgrlog ファイルにエンドポイント・ログイン試行情報をダンプする間隔を分数で指定します。デフォルトは 720 です。
timeout_interval value
ある特定のメソッド呼び出し (たとえば、ゲートウェイに対する呼び出しなど) がタイムアウトになるまでエンドポイント・マネージャーがそのメソッド呼び出し上の応答を待つ秒数を指定します。最小値は 15 秒です。デフォルト値はゼロです。値ゼロを指定すると、このオプションは使用不可になります。
start エンドポイント・マネージャーを始動します。
stop エンドポイント・マネージャーを停止します。
test_label endpoint_label
現在設定されているラベル・スペースにラベルが準拠しているかどうかをテストします。
updateTivoli オブジェクト・データベースのエンドポイント・マネージャー・オブジェクトの属性に基づき、実行中のエンドポイント・マネージャーの属性を最新表示します。
権限Tivoli リージョンでの senior、super。
例1. 次の例では、エンドポイント・マネージャーに PING を送信して、エンドポイント・マネージャーが稼働中かどうかを検査します。
wepmgr
第 3 章 コマンド (アルファベット順) 217
wepmgr ping
ep_mgr is running.
2. 以下の例は、エンドポイント・マネージャー・オブジェクト属性のリストを戻します。
wepmgr get
logging_level = 4max_install = 10max_sgp = 10max_after = 10login_interval = 0login_limit = 200stanza_interval = 720timeout_interval = 0max_iom_records = 500epmgr_flags = 0max_epmgr_rpc_threads = 250automigrate = offmigrate_max = 0chk_cntl_chars = 0labelspace = ’’invalid_chars = ’’
3. 次の例では、Tivoli オブジェクト・データベースのエンドポイント・マネージャー・オブジェクトに対して、エンドポイント・マネージャーの login_interval属性を 0 秒に設定します。デフォルトでは、エンドポイントは 270 秒間隔でログイン要求を送ります。エンドポイントへの初期ログイン要求試行の間隔秒数を(lcfd コマンドの login_timeout または udp_interval キーワードを使用して)
減らす場合、ゲートウェイとエンドポイント・マネージャーによって、エンドポイント・ログイン試行がフィルタリングされないように、エンドポイント・マネージャーの属性も減らす必要があります。次のコマンドは、エンドポイント・マネージャーを更新して、実行中のエンドポイント・マネージャーの属性設定を有効にします。この値はゲートウェイで使われるために、このコマンドを発行したら、その後ゲートウェイを再始動する必要があります。
wepmgr set login_interval 0wepmgr update
参照wep
wepmgr
218 Tivoli Management Framework: リファレンス・マニュアル
wepstatus
エンドポイントの状況を戻します。
構文wepstatus [-o file] [-f format] [-v] {endpoint_name | -a | -g gateway_name | -i file
[endpoint_name...]}
説明wepstatus はゲートウェイから実行されて、エンドポイントの状況が戻されます。状況情報が必要な 1 つ以上のエンドポイントを指定するか、もしくは入力ファイルにエンドポイントをリストすることができます。このコマンドは、指定されたゲートウェイに関連付けられたすべてのエンドポイント、もしくはローカル Tivoli リージョン内のすべてのエンドポイントの状況を戻すこともできます。
エンドポイント状況は、次の値のいずれかです。
connectedエンドポイントはゲートウェイに接続されます。エンドポイントとゲートウェイは通信可能です。エンドポイントはゲートウェイからのダウンコールに応答して、タスクを実行したり、アップコールを開始できます。ゲートウェイは、エンドポイントが開始したアップコールを保守します。
disconnectedゲートウェイは、エンドポイントがゲートウェイから切断され、通信を試行しないと認識します。エンドポイントはゲートウェイからログアウトしますが、ネットワークへはまだ接続されている可能性があります。
unavailableゲートウェイは、次のいずれかの理由によりエンドポイントと通信できません。
v ゲートウェイが正常にダウンコールをできない。
v エンドポイントがタスクを実行できない。
v エンドポイントがアップコールを保守していない。
v エンドポイントのディスク・スペースが不足している。
v エンドポイントで許可の問題があり、それが原因でエンドポイントがファイルの読み取り/書き込みを行ったり、プログラムを実行することができない。
unreachableゲートウェイがエンドポイントと通信できません。エンドポイント・プロセスが停止しているか、もしくはエンドポイントがネットワークから切断されている可能性があります。
unknownエンドポイントに関連付けられたゲートウェイがダウンしているか、もしくはゲートウェイがエンドポイントの状況を検査していません。 wepstatus コマンドはエンドポイントの状況を判断できません。
第 3 章 コマンド (アルファベット順) 219
wepstatus コマンドは、エンドポイント状況に関する以下のエラー・コードを戻すこともできます。
0 ファイル許可エラー。一時ファイルを作成することができません。
1 一時ディレクトリーに十分なディスク・スペースがありません。
2 ファイル許可エラー。メソッド・キャッシュを作成または更新できません。
3 LCF_CACHEDIR に十分なディスク・スペースがありません。
4 tmersrvd アカウント用にトークンを生成できません。
5 組み込みアドミニストレーター・アカウント用にトークンを生成できません。
6 プロセスを作成できません。
注: エンドポイントの状況が使用不可であり、エラー・コードが戻されない場合、エンドポイント・ログインは失敗しました。
オプション-a ローカル Tivoli リージョン内のすべてのエンドポイントの状況を戻しま
す。
-f format
出力を指定されたフォーマットで戻します。有効なフォーマットは、htm(HTML フォーマットの場合)、もしくは csv (コンマで区切られたリストの場合) です。
-g gateway_name
指定されたゲートウェイに関連付けられたすべてのエンドポイントの状況を戻します。
-i file 指定されたファイルに含まれているすべてのエンドポイントの状況を戻します。完全修飾パスとファイル名を含む必要があります。ファイルには、各エンドポイントが別の行にリストされていなくてはなりません。
-o file 指定されたファイルに状況を書き込みます。完全修飾パスとファイル名を含む必要があります。
-v 冗長出力を指定します。
endpoint_name...
戻される予定の状況に対するエンドポイントの名前を指定します。各エンドポイントはスペースで区切ってください。
権限admin、senior、super
例1. 次の例では、エンドポイント quartz の状況が戻されます。
wepstatus quartz
このコマンドの出力には、以下の例が示すような情報が含まれています。
wepstatus
220 Tivoli Management Framework: リファレンス・マニュアル
Endpoint Label : quartzDispatcher Number : 24Gateway Label : crystal-gwInterp Type : solaris2Version : 41100IP Address : 9.48.125.57+1929Current Status : unreachableStatus error code(s): -Last Login Time : 2003/09/24-07:37:41 [Passed]Last Logout Time : 2003/09/24-07:37:18 [Passed]Last Migration Time : 2003/09/22-21:35:25 [Passed]Last Downcall Time : 2003/09/24-07:37:42 [Failed]Last Upcall Time : 2003/09/26-12:07:39 [Passed]Last EP check Time : 2003/10/03-07:16:03 [Failed]
2. 次の例では、ゲートウェイ ntgw に関連付けられたすべてのエンドポイントの状況が戻されます。
wepstatus -g ntgw
このコマンドの出力には、以下の例のようにエンドポイント・ラベル、ゲートウェイ、インタープリター・タイプ、エンドポイント・バージョン、オブジェクト・ディスパッチャー番号、エンドポイント状況、およびエラー・コードの情報をリストします。
Last known status of the endpoint(s):Endpoint Gateway Interp Version OD Status Error Code(s)------------------------------------------------------------------------------gem_808_nt02 ntgw w32-ix86 41100 10 unknown -gem_808_nt03 ntgw w32-ix86 41100 11 unknown -gem_808_nt04 ntgw w32-ix86 41100 12 unknown -gem_808_nt05 ntgw w32-ix86 41100 13 unknown -gem_808_sol06 ntgw solaris2 41100 14 unknown -gem_808_sol07 ntgw solaris2 41100 15 unknown -
3. 以下の例では、ローカル Tivoli リージョン内のすべてのエンドポイントの状況が戻されます。
wepstatus -a
このコマンドの出力には、以下の例のようにエンドポイント・ラベル、ゲートウェイ、インタープリター・タイプ、エンドポイント・バージョン、オブジェクト・ディスパッチャー番号、エンドポイント状況、およびエラー・コードの情報をリストします。
Last known status of the endpoint(s):Endpoint Gateway Interp Version OD Status Error Code(s)--------------------------------------------------------------------------------gem_808_nt02 ntgw w32-ix86 41100 10 unknown -gem_808_nt03 ntgw w32-ix86 41100 11 unknown -gem_808_nt04 ntgw w32-ix86 41100 12 unknown -gem_808_nt05 ntgw w32-ix86 41100 13 unknown -gem_808_sol06 ntgw solaris2 41100 14 unknown -gem_808_sol07 ntgw solaris2 41100 15 unknown -gem_808_nt01 solgw w32-ix86 41100 4 unreachable -gem_808_sol02 solgw solaris2 41100 6 unreachable -gem_808_sol03 solgw solaris2 41100 7 unreachable -gem_808_sol04 solgw solaris2 41100 8 unreachable -gem_808_sol05 solgw solaris2 41100 9 unreachable -gem_808_sol08 solgw solaris2 41100 16 unreachable -gem_808_sol09 solgw solaris2 41100 17 unreachable -gem_808_sol010 solgw solaris2 41100 18 unreachable -gem_808_sol011 solgw solaris2 41100 19 unreachable -gem_808_sol014 solgw solaris2 66 25 connected -gem_808_sol015 solgw solaris2 66 26 connected -gem_808_sol01 solgw solaris2 41100 31 connected -
wepstatus
第 3 章 コマンド (アルファベット順) 221
参照wgateway
wepstatus
222 Tivoli Management Framework: リファレンス・マニュアル
wepupgd
エンドポイントをアップグレードします。
構文wepupgd -h
wepupgd [-f] [-l] [-L config_options] [-p upgrade_path] [-r] [-v] [-w wait_time] {-a| -g gw_name | -i file | ep_name...}
説明wepupgd コマンドはエンドポイントをアップグレードするか、もしくはエンドポイントの前のバージョンを強制的にインストールします。このコマンドは、Tivoli
リージョン内のどの管理対象ノードからでも発行できますが、削除されるすべてのエンドポイント・プラットフォームを管理することができます。
注: このコマンドは、wadminep upgrade および wadminep staged_upgradeコマンドの後継コマンドです。
オプション-a Tivoli リージョン内のすべてのエンドポイントをアップグレードします。
-f エンドポイントの前のバージョンのインストールを強制します。
-g gw_name
指定されたゲートウェイに関連付けられたすべてのエンドポイントをアップグレードします。
-h 詳細な使用法ステートメントを表示します。
-i file アップグレードするエンドポイントのリストに含まれている完全修飾ファイル名。ファイルの各エンドポイントは、別の行になければなりません。
-l ローカル管理対象ノードからアップグレード・パッケージを検索します。このオプションが指定されていないと、指定されたエンドポイントに割り当てられているゲートウェイからアップグレード・パッケージを検索します。このオプションは NetWare ゲートウェイでは使用できません。
-L config_options
エンドポイントを起動するための構成オプションを lcfd コマンドに渡します。複数のオプションを指定する場合や、1 つのオプションのスペースしかない場合は、以下のようにテキストを二重引用符 (″) で囲む必要があります。
-L "-p 3456 -P 7890"
有効なオプションのリストについては、lcfd コマンドを参照してください。
-p upgrade_path
アップグレード・パッケージの完全修飾パスを指定します。デフォルト・ロケーションは、該当する lcf_bundle ディレクトリーです。
第 3 章 コマンド (アルファベット順) 223
-r アップグレード後に Windows 98 エンドポイントをリブートします。
-v 冗長モードでコマンドを実行します。
-w アップグレード後にゲートウェイがエンドポイントのログ・バックを待機する時間 (秒数) を指定します。デフォルト値は 150 秒です。
ep_name...
アップグレードするエンドポイントの名前を指定します。
権限エンドポイントの root または Administrator の特権で admin の役割が必要です。
例1. 次の例では、エンドポイント packer をアップグレードします。アップグレード・パッケージは、割り当てられてゲートウェイの lcf_bundle ディレクトリーにあります。
wepupgd packer
2. 次の例では、エンドポイント packer および hoth をアップグレードします。アップグレード・パッケージは、割り当てられてゲートウェイの lcf_bundle ディレクトリーにあります。
wepupgd packer hoth
3. 次の例では、odin 上のエンドポイントの前のバージョンのインストールを強制します。エンドポイント・イメージは、コマンドが発行された管理対象ノードのdata/bin/TMF37/lcf_bundle ディレクトリーにあります。
wepupgd -f -l -p /data/bin/TMF37/lcf_bundle odin
4. 次の例は、Tivoli リージョン内のすべてのエンドポイントをアップグレードします。
wepupgd -a
5. 次の例は steeler ゲートウェイに割り当てられたすべてのエンドポイントをアップグレードします。アップグレード・パッケージは、コマンドが発行された管理対象ノードの lcf_bundle ディレクトリーにあります。
wepupgd -l -g steeler
参照lcfd, winstlcf
wepupgd
224 Tivoli Management Framework: リファレンス・マニュアル
wexpnotif
通知グループの通知を期限切れにします。
構文wexpnotif [-a age] notice_group
説明wexpnotif コマンドは、通知グループからの通知を期限切れにします。通知グループには通常、満了時間が関連付けられています。このコマンドを使用すると、通知の通常の満了時間より前に、強制的に通知を期限切れにすることができます。 -aオプションを指定すると、指定した経過日数より古い通知のみが期限切れになります。このオプションを指定しないと、指定した通知グループ内のすべての通知が即時に期限切れになります。
オプション-a age 指定された時間数より古い通知のみが期限切れになるよう指定します。この
オプションを指定しないと、指定した通知グループ内のすべての通知が即時に期限切れになります。
notice_group
通知の期限を終了させる通知グループを指定します。
権限Tivoli リージョン内で少なくとも senior 役割を持っている必要があります。
例次の例では、すべての Tivoli Administration 通知が 3 時間後に期限切れになるよう指定されます。
wexpnotif -a 3 "Tivoli Administration"
参照wlsnotif, wsndnotif, wtailnotif
第 3 章 コマンド (アルファベット順) 225
wgateway
ゲートウェイを起動または終了したり、ゲートウェイのプロパティーの変更またはプロパティーのリストの表示を実行します。あるいは、ゲートウェイ HTTP サーバーへのアクセスのコントロールや、ロギング特性の定義を実行します。
構文wgateway
wgateway gateway_name [add_gatewayproxy node_name | get_gatewayproxies |
remove_gatewayproxy node_name | reset_gatewayproxies]
wgateway gateway_name [add_protocol protocol | rm_protocol protocol]
[set_ipx_port port] [set_nbi_port port] [set_nbi_name name ] [set_protocolsprotocol_list] [set_sna_address address] [set_sna_mode mode] [set_sna_portport] [set_tcp_port port]
wgateway gateway_name {dbcheck | epact_dbcheck}
wgateway gateway_name describe
wgateway gateway_name get option
wgateway gateway_name logstatus
wgateway gateway_name {restart | start | stop}
wgateway gateway_name run option value
wgateway gateway_name set option value
説明wgateway コマンドは、ゲートウェイの起動/終了、ゲートウェイのプロパティーのリスト表示または変更、ゲートウェイ HTTP サーバーへのアクセスのコントロール、もしくはロギング特性の定義を行います。
オプションを指定しないと、wgateway コマンドはローカル Tivoli リージョン内のすべてのゲートウェイのオブジェクト ID、ラベル、および状況をリスト表示します。ゲートウェイの状況を示す値は、次のいずれかです。
b ゲートウェイはブート中です。
d ゲートウェイはダウンしていて稼動していません。
D 通信エラーが発生しました。オブジェクト・ディスパッチがダウンしています。ただし、コンピューターそのものがダウンする可能性があります。
u ゲートウェイは稼働中です。
ゲートウェイを起動、停止、または再起動する (一度停止してから起動する) 場合は、それぞれ start、stop、および restart オプションを使用します。
226 Tivoli Management Framework: リファレンス・マニュアル
注: NetWare ゲートウェイの場合、start および stop オプションは使用できません。 start オプションを使用したい場合は、代わりに oservrun コマンドを使用します。 stop オプションを使用したい場合は、代わりに oservend コマンドを使用します。これらのコマンドは NetWare コンソールから実行する必要があります。
特定のゲートウェイのすべてのプロパティーのリストを表示する場合は、describeオプションを使用します。これらのプロパティーのいずれかを変更するには、 setオプションとそのサブオプションを使用して変更することができます。
エンドポイント・メソッドのロギングを実行するには、設定された解決時間の値を戻す get method_trace_time オプションと、解決時間を変更する setmethod_trace_time オプションを使用します。ロギングの状況を戻すには、logstatus オプションを使用します。状況チェックを実行する間隔を変更するには、 logstatus_interval オプションを使用します。
ゲートウェイ HTTP サーバーに安全にアクセスできるように、set httpd オプションを使用してサーバーを使用可能または使用不可にすることができます。ゲートウェイ HTTP サーバーを使用可能にした後は、このサービスに接続するユーザーすべてに認証が求められます。ユーザー名およびパスワードを作成するまで、ゲートウェイ Web ページにアクセスすることはできません。ユーザー名およびパスワードを設定すると、ゲートウェイ・ページへのアクセスが許可されます。 sethttpd_passwd オプションを使用して、それぞれのユーザーごとにユーザー名およびパスワードを事前定義する必要があります。 admin 許可の役割をもつ各アドミニストレーターは、自分のユーザー名およびパスワードを定義することができます。
注: ユーザー名およびパスワードには任意の値を使用できます。これらはシステム・アドミニストレーターのユーザー名またはパスワードがデフォルトになるわけではありません。これらは Tivoli アドミニストレーターのユーザー名またはパスワードがデフォルトになるわけではありません。
NetWare ゲートウェイの場合、少なくとも 1 つのゲートウェイ・プロキシーが必要です。ゲートウェイ・プロキシーは、エンドポイント・ポリシー・スクリプトを実行します。どの管理対象ノードもゲートウェイ・プロキシーとして使用できます。以下のオプションを使用して、ゲートウェイ・プロキシーを管理します。
add_gatewayproxy管理対象ノードをゲートウェイ・プロキシー・リストに追加します。
get_gatewayproxies特定の NetWare ゲートウェイ用のゲートウェイ・プロキシーをリストします。
remove_gatewayproxy管理対象ノードをゲートウェイ・プロキシー・リストから除去します。
reset_gatewayproxiesゲートウェイ・プロキシー・リストからすべてのエントリーを除去します。
NetWare ゲートウェイおよび IPX/SPX プロトコルをサポートするその他のゲートウェイの場合、ゲートウェイを作成した後 IPX/SPX サポートを追加できます。
wgateway
第 3 章 コマンド (アルファベット順) 227
IPX/SPX サポートを追加するには、add_protocol IPX オプションを使用し、ゲートウェイのプロトコルを設定するには set protocols IPX オプションを使用します。 IPX/SPX サポートをこれ以上必要としない場合は、rm_protocol IPX オプションを使用します。 Standard TCP/IP または IPX/SPX listen ポートを使用しない場合は、 set_tcp_port を使用して TCP/IP listen ポートを設定するか、set_ipx_port オプションを使用して IPX および SPX listen ポートを設定します。
それぞれのゲートウェイが、データベース・ファイルを保持しメソッド・キャッシュを持っているため、Tivoli サーバー上で同期化されなかったり破壊される可能性があります。複数のコンピューター間でメソッド・キャッシュを同期化するには、dbcheck オプションを使用します。エンドポイント・アクティビティー・データベース (epact.bdb ファイル) の整合性を検査するには、 epact_dbcheck オプションを使用します。
オプションadd_gatewayproxy node_name
NetWare ゲートウェイ専用。管理対象ノードをゲートウェイ・プロキシー・リストにエントリーとして追加します。
add_protocol protocol
指定したゲートウェイ用にサポートされているプロトコルを追加します。サポートされているプロトコルは TCPIP (デフォルト) と IPX です。
dbcheckゲートウェイのメソッド・キャッシュを Tivoli サーバー上のメソッド・キャッシュと同期させます。
describe指定されたゲートウェイのプロパティーを表示します。
epact_dbcheckエンドポイント・アクティビティー・データベース (epact.bdb ファイル) の整合性を検査します。
get option
指定されたオプションに設定されている値を戻します。 get オプションと共に以下のサブオプションを指定することもできます。
continue_eplogin_onerrorゲートウェイが、エンドポイントによる通常のログイン試行の際にboot_method メソッドまたは login_policy スクリプト (あるいはその両方) からの例外を許可しているかどうかを示す値を戻します。
debug_levelゲートウェイによってログに記録されるメッセージ情報のレベルを戻します。レベルは次のとおりです。
epcheck_atbootゲートウェイが、ゲートウェイの始動ごとに割り当てられるすべてのエンドポイントの状況を検査するかどうかを示す値を戻します。
epcheck_intervalゲートウェイが、通信するエンドポイントの状況を検査する間隔(秒) を戻します。
wgateway
228 Tivoli Management Framework: リファレンス・マニュアル
eplogin_timeoutエンドポイントのログイン・タイムアウトの現行値を戻します。
epupgrade_by_gatewayゲートウェイが、通常のログイン処理の際に割り当てられるすべてのエンドポイントをアップグレードするかどうかを示す値を戻します。エンドポイントがすでに最新のレベルであれば、アップグレードは実行されません。
httpd ゲートウェイ HTTP サーバーが使用可能かどうかを示す値を戻します。
httpd_passwdゲートウェイ HTTP サーバーにアクセスするのに必要なユーザー名およびパスワードを表示して、エンドポイントについての情報を示します。
ifs_ignoreゲートウェイのブート時にゲートウェイ別名リストから除外されるIP アドレスのリストを表示します。
ipx_portゲートウェイが IPX パケットを listen するポートを戻します。
log_dirgatelog およびすべての gatelog.timestamp ログ・ファイルのローカル・システム上のディレクトリーを戻します。
log_sizegatelog ファイルのリファレンス・サイズをバイト単位で戻します。
logstatus_interval次回の状況検査を実行するまでの時間を秒単位で戻します。
max_concurrent_jobs並行して実行する最大ジョブ数を戻します。
max_concurrent_logins同時にログインできるエンドポイントの最大数を戻します。
mcache_bwcontrolゲートウェイが MDist 2 サービスとメソッド・キャッシュ・ダウンロードの間で帯域幅コントロールを共用するかどうかを示す値を戻します。
method_trace_timeエンドポイント・メソッドのログ記録の解決時間を秒数で戻します。
nbi_nameNetBIOS 名を戻します。
nbi_modeNetBIOS 名解決モードを戻します。
nbi_portゲートウェイが NetBIOS パケットを listen するポートを戻します。
wgateway
第 3 章 コマンド (アルファベット順) 229
protocols指定したゲートウェイ用にサポートされているプロトコルを戻します。
rpc_maxthreadsスレッドの最大数を戻します。
send_userlink_fileゲートウェイが userlink.htm ファイルをエンドポイントに送ることができるかどうかを示す値を戻します。
session_timeoutゲートウェイがダウンコールを送信してからエンドポイントからの応答を待つ時間 (秒単位) を戻します。
sna_addressSNA アドレスを戻します。
sna_modeSNA モードを戻します。
sna_portゲートウェイが SNA パケットを listen するポートを戻します。
tcp_portゲートウェイが TCP パケットを listen するポートを戻します。
wol_broadcastゲートウェイが Wake on Lan パケットをエンドポイントのサブネットにブロードキャストするかどうかを示す値を戻します。
wol_directゲートウェイが Wake on Lan パケットをエンドポイントの IP アドレスに直接送信するかを示す値をも戻します。
get_gatewayproxiesNetWare ゲートウェイ専用。指定したゲートウェイに追加された管理対象ノードのリストを表示します。
logstatusロギング状況を戻します。
remove_gatewayproxy node_name
NetWare ゲートウェイ専用。エントリーとしての管理対象ノードをゲートウェイ・プロキシー・リストから除去します。
reset_gatewayproxiesNetWare ゲートウェイ専用。ゲートウェイ・プロキシー・リストをクリアします。
restart指定されたゲートウェイを停止してから再起動します。
rm_protocol IPX指定されたゲートウェイから IPX プロトコルのサポートを除去します。TCP/IP プロトコルは除去できません。
wgateway
230 Tivoli Management Framework: リファレンス・マニュアル
run 指定されたサブオプションを実行します。run オプションと共に以下のサブオプションを指定することもできます。
sync_login_intervalゲートウェイのエンドポイント・ログイン間隔とエンドポイント・マネージャーの値を同期化します。この変更を有効にするためにゲートウェイをリブートする必要はありません。
ifs_ignore_remove IP_address
除外ゲートウェイ別名のリストから、指定された IP アドレスを除去します。
set option value
指定されたオプションの値を設定します。set オプションで、以下のオプションと値を指定できます。
continue_eplogin_onerror {0 | 1 | 2 | 3}ゲートウェイが、エンドポイントによる通常のログイン試行の際にboot_method メソッドまたは login_policy スクリプト (あるいはその両方) からの例外を許可しているかどうかを指定します。次の値のいずれかを指定します。
0 ゲートウェイは、boot_method メソッドまたは login_policy
スクリプトから例外を受信する場合、ログイン試行を打ち切ります。これはデフォルト値です。
1 ゲートウェイは、login_policy スクリプトからの例外を許可します。
2 ゲートウェイは、boot_method メソッドからの例外を許可します。
3 ゲートウェイは、login_policy スクリプトと boot_method メソッドの両方からの例外を許可します。
debug_level level
ゲートウェイによってログに記録されるメッセージ情報のレベルを設定します。レベルは次のとおりです。
0 エラー。これがデフォルトのレベルで、推奨レベルです。
1 エラーと警告。
2 無害な例外。
3 冗長通信情報。
5 冗長ブート、データベース・チェック、およびエンドポイント・ログイン情報。
6 冗長アップコール、ダウンコール、およびリピーター情報。
7 冗長ジョブ・スケジューラー情報。
8 冗長ゲートウェイ・キャッシュ情報。
注: レベル 4 はありません。
wgateway
第 3 章 コマンド (アルファベット順) 231
epcheck_atboot {TRUE | FALSE}ゲートウェイが、ゲートウェイの始動ごとに割り当てられるすべてのエンドポイントの状況を検査するかどうかを指定します。デフォルトは TRUE です。
epcheck_interval seconds
ゲートウェイが、通信するエンドポイントの状況を検査する間隔(秒) を指定します。このオプションの値の範囲は 300 ~ 14400 秒です。デフォルトは 3600 秒 (1 時間) です。
epupgrade_by_gateway [TRUE | FALSE]通常ログイン処理中に、このゲートウェイに割り当てられたエンドポイントをアップグレードします。エンドポイントがすでに最新のレベルであれば、アップグレードは実行されません。 NetWare ゲートウェイを除くすべてのゲートウェイのデフォルトは、FALSE です。 NetWare ゲートウェイの場合、この値は TRUE に設定されています。 NetWare ゲートウェイは、最初にプロキシー管理対象ノードを定義してからでなければ login_policy スクリプトを実行できません。
注: epupgrade_by_gateway オプションが機能するのは、upgrade.cntl ファイル内の upgrade_mode パラメーターが auto
に設定されている場合のみです。upgrade.cntl ファイルは、ゲートウェイの $BINDIR/lcf_bundle.41100/upgrade ディレクトリーにあります。
httpd [TRUE | FALSE]ゲートウェイ HTTP サーバーを使用可能または使用不可にします。このオプションでは、admin の役割のみが必要です。 TRUE はゲートウェイ HTTP サーバーを使用可能にします。FALSE はゲートウェイ HTTP サーバーを使用不可にします。デフォルトは FALSE です。
httpd_passwd user_name:password
ゲートウェイ HTTP サーバーへのアクセスに必要なユーザー名およびパスワードを設定して、エンドポイントについての情報を表示します。このオプションには、admin の役割のみが必要です。
ifs_ignore IP_address
ゲートウェイのブート時にゲートウェイ別名リストから除外されるIP アドレスを指定します。エンドポイントを接続しないネットワーク・カードを指定するには、複数の NIC ゲートウェイでこのオプションを使用します。このコマンドを実行するごとに、1 つの IP
アドレスのみを指定できます。ただし、このコマンドを複数回実行して、複数の IP アドレスを除外することができます。
log_dir directory
gatelog およびすべての gatelog.timestamp ログ・ファイルのローカル・システム上のディレクトリーを指定します。
log_size size_in_bytes
gatelog ファイルのリファレンス・サイズをバイト単位で指定します。リファレンス・サイズに達した場合、 gatelog ファイルを
wgateway
232 Tivoli Management Framework: リファレンス・マニュアル
gatelog.timestamp ファイルにコピーして、新しい gatelog ファイルを作成します。最大ファイル・サイズは 10485760 バイト (10 メガバイト) です。デフォルトのファイル・サイズは 1048576 バイト(1 メガバイト) です。
logstatus_interval seconds
次回の状況検査を実行するまでの時間を秒単位で設定します。ゼロに設定すると、ロギングは使用不可になります。値の範囲は 0 ~3600 秒です。デフォルトは 3600 秒 (1 時間) です。
max_concurrent_jobs count
並行して実行する最大ジョブ数を指定します。値の範囲は 200 ~2000 秒です。デフォルトは 200 です。
max_concurrent_logins count
同時にログインできるエンドポイントの最大数を指定します。このオプションの範囲は 100 ~ 500 エンドポイントです。デフォルトは 100 です。
mcache_bwcontrol [TRUE | FALSE]MDist 2 サービスとメソッド・キャッシュ・ダウンロードの間で帯域幅コントロールを共用するかどうかを指定します。デフォルトはFALSE です。
method_trace_time seconds
エンドポイント・アクティビティー (最終ログイン時間、最終ログアウト時間、最終マイグレーション時間、最終ダウンコール時間、最終アップコール時間、最終エンドポイント検査時間) をトレースする解決時間の秒数を指定します。この値をゼロに設定すると、エンドポイント・トレース情報はepact.bdb データベースには書き込まれませんが、ゲートウェイのメモリーに保管されます。デフォルトは 3600 秒 (1 時間) です。
protocols protocol_list
指定したゲートウェイ用にサポートされるプロトコルを設定します。TCP/IP がデフォルトです。
rpc_maxthreads count
スレッドの最大数を指定します。値の範囲は 250 ~ 2500 秒です。デフォルトは 250 です。
send_userlink_file {TRUE | FALSE}ゲートウェイが userlink.htm ファイルをエンドポイントに送るかどうかを指定します。この値を TRUE に設定すると、エンドポイントが最初の通常ログインに成功した後、ゲートウェイは userlink.htm
ファイルをエンドポイントに送ります。 userlink.htm ファイルは、UNIX システムのエンドポイントの場合は /etc/Tivoli ディレクトリーに保管され、Windows システムのエンドポイントの場合はc:/etc/Tivoli ディレクトリーに保管されます。この値を FALSE に設定すると、ゲートウェイは userlink.htm ファイルをエンドポイントに送りません。デフォルトは TRUE です。
wgateway
第 3 章 コマンド (アルファベット順) 233
注: このオプションは、新規エンドポイント用向けのものです。userlink.htm ファイルは、既存のエンドポイントにすでにインストールされている場合もあります。
session_timeout seconds
ゲートウェイがダウンコールを送信してからエンドポイントからの応答を待つ時間 (秒単位) を指定します。デフォルトは 300 秒 (5
分) です。
wol_broadcast {TRUE | FALSE}ゲートウェイが Wake on Lan パケットをエンドポイントのサブネットにブロードキャストするかどうかを指定します。ブロードキャスト・モードでは、エンドポイントの IP アドレスが不明な場合、ゲートウェイは、Wake on Lan パケットをエンドポイントのサブネットに送信することによってエンドポイントをウェイクアップすることができます。デフォルトは TRUE です。
wol_direct {TRUE | FALSE}ゲートウェイが Wake on Lan パケットをエンドポイントの IP アドレスに直接送信するかを指定します。デフォルトは FALSE です。
set_ipx_port port
ゲートウェイが IPX パケットを listen するポートを設定します。 IPX ポートを割り当てると、SPX ポートが割り当てられます。 SPX ポートには、常に IPX ポート番号より 1 つ小さい番号が割り当てられます。デフォルトの IPX ポート番号が 9494 であれば、デフォルトの SPX ポート番号は9493 です。
set_nbi_name name
NetBIOS 名を指定します。
set_nbi_mode mode
NetBIOS 名解決モードを指定します。
set_nbi_port port
ゲートウェイが NetBIOS パケットを listen するポートを設定します。
set_protocols protocol_list
指定したゲートウェイ用にサポートされるプロトコルを設定します。サポートされているプロトコルは TCPIP (デフォルト) と IPX です。
set_sna_address address
SNA アドレスを指定します。
set_sna_mode mode
SNA モードを指定します。
set_sna_port port
ゲートウェイが SNA パケットを listen するポートを指定します。
set_tcp_port port
ゲートウェイが TCP/IP パケットを listen するポートを設定します。デフォルトのポート番号は 9494 です。
wgateway
234 Tivoli Management Framework: リファレンス・マニュアル
start 指定されたゲートウェイを起動します。 NetWare の場合、oservrun コマンドを使用して NetWare コンソールからオブジェクト・ディスパッチャーを開始します。
stop 指定されたゲートウェイを停止します。 NetWare の場合、oservend コマンドを使用して NetWare コンソールからオブジェクト・ディスパッチャーを停止します。
gateway_name
ゲートウェイの名前を識別します。
権限admin または senior
例1. 次の例では、ゲートウェイが IPX および TCP/IP プロトコルを使用している場合の、wgateway コマンドの結果を示します。
wgateway solgw describe
Gateway Object : 1094978554.1.579#TMF_Gateway::Gateway#Hostname : packerdebug_level : 9session_timeout : 30Protocols : TCPIP, IPXTCPIP Port : 41684IPX Port : 41690Start Time : 2003/10/24 11:26:05 +06no_endpoints : 2log_dir : /data/gem/1013/packer.dblog_size : 1024000rpc_maxthreads : 350max_concurrent_jobs : 200max_concurrent_logins : 200method_trace_time : 1800logstatus_interval : 1800login_interval : 0epcheck_interval : 300epcheck_atboot : Enabledhttpd : Enabledmcache_bwcontrol : Disabledwol_broadcast : Disabledwol_direct : Enabledsend_userlink_file : Disabledcrypt_mode : NONEifs_ignore : NIL
2. 次の例では、ゲートウェイが TCP/IP プロトコルを使用している場合の、wgateway コマンドの結果を示します。
wgateway liliana-gateway describe
Gateway Object : 1849216852.1.580#TMF_Gateway::Gateway#Hostname : lilianadebug_level : 9session_timeout : 300Protocols : TCPIPTCPIP Port : 21234Start Time : 2003/09/26 16:36:03 +06no_endpoints : 3log_dir : /data/lorozco/Tivoli-1234/db/liliana.dblog_size : 1024000
wgateway
第 3 章 コマンド (アルファベット順) 235
rpc_maxthreads : 350max_concurrent_jobs : 200max_concurrent_logins : 100method_trace_time : 3600logstatus_interval : 3600login_interval : 270epcheck_interval : 3600epcheck_atboot : Enabledgateway_httpd : Disabledmcache_bwcontrol : Disabledgateway_crypt_mode : NONEwol_broadcast : Enabledwol_direct : DisabledInterface Ignore List : Nonesend_userlink_file : Enabled
3. 以下の例は、管理対象ノード lradner を、NetWare ゲートウェイ lux のゲートウェイ・プロキシー・リストに、エントリーとして追加します。
wgateway lux add_gatewayproxy lradner
4. 次の例では、NetWare ゲートウェイ lux のゲートウェイ・プロキシー・リストを表示します。
wgateway lux get_gatewayproxies
5. 以下の例は、ゲートウェイ lux の除外別名のリストから、指定された IP アドレスを除去します。
wgateway lux run ifs_ignore_remove 9.99.99.98
6. 以下の例は、最大 200 エンドポイントが同時にゲートウェイ lux にログインできることを指定します。
wgateway lux set max_concurrent_logins 200
参照wcrtgate, wdelgate, wrpt
wgateway
236 Tivoli Management Framework: リファレンス・マニュアル
wgetadmin
Tivoli アドミニストレーターに関する情報をリスト表示します。
構文wgetadmin [name]
wgetadmin -n [name]
wgetadmin -o [name]
wgetadmin -p [name]
wgetadmin -u [-i interp] [name]
説明wgetadmin コマンドは、Tivoli アドミニストレーターに関する情報を標準出力に表示します。このコマンドは、アドミニストレーターの名前、ログイン、役割、および通知グループを表示します。アドミニストレーターの役割は、グループ別に表示されます。 name を指定しないと、コマンドは、現行アドミニストレーターの情報を表示します。
注: このコマンドでは、アドミニストレーターに関連したユーザー名やグループ名は示されません。この操作を実行するには、Tivoli デスクトップを使用する必要があります。
オプション-i interp
指定されたインタープリター・タイプを使用して、アドミニストレーターのユーザー・ログイン名とグループ名を解決します。
-n アドミニストレーターの名前のみを表示します。
-o アドミニストレーターのオブジェクト ID のみを表示します。
-p 複数の通知グループの拡張された出力を表示します。リストされる通知グループには、対応する Tivoli リージョン名が付加されています。これは、相互接続された Tivoli 環境で役立ちます。
-u アドミニストレーターのユーザー・ログイン名とグループ名を表示します。
name プロパティーを表示する Tivoli アドミニストレーターの名前を指定します。
権限Tivoli リージョンでの user。
例1. 次の例では、現行アドミニストレーターに関する管理情報が表示されます。
wgetadmin
第 3 章 コマンド (アルファベット順) 237
2. 次の例では、アドミニストレーター callahan@sthelens に関する管理情報が表示されます。
wgetadmin callahan@sthelens
Administrator Steve Callahanlogins: callahan@sthelensroles: global user
DefaultRegion super, admin, userAdministrators super, seniorMyRegion super, senior, admin, user, backupSteve Callahan admin, user, rconnectsecurity_group_any_admin user
notice groups: Tivoli Authorization
参照wcrtadmin, widmap, wsetadmin
wgetadmin
238 Tivoli Management Framework: リファレンス・マニュアル
wgetallinst
あるリソース・タイプのすべてのインスタンスを表示します。
構文wgetallinst [-l] resource_type
説明wgetallinst コマンドは、リソース・タイプのすべてのインスタンスを表示します。-l オプションが指定されると、このコマンドは、’label oid’ のフォーマットでリソース・タイプを表示します。
wgetallinst コマンドは、wlookup コマンドに似ています。 wlookup コマンドはネーム・レジストリーに登録済みリソース・タイプのみを表示しますが、wgetallinst コマンドは登録済みと未登録の両方のリソース・タイプを表示します。未登録のリソースには、他のリソース・タイプのスーパーセットであるリソース・タイプも含まれます。たとえば、wgetallinst コマンドは、ProfileEndpoint リソース・タイプのすべてのインスタンスを表示します。このリソース・タイプには、リソース・タイプ ProfileManager、ManagedNode、および NisDomain のインスタンスが含まれます。
オプション-l ’label oid’ の形式でインスタンスを表示します。
resource_type
表示するインスタンスのリソース・タイプを指定します。
例次の例では、ProfileEndpoint リソース・タイプのすべてのインスタンスが表示されます。
wgetallinst -l ProfileEndpoint
参照wlookup
第 3 章 コマンド (アルファベット順) 239
wgetdfpol
デフォルトのポリシー・オブジェクトをリスト表示します。
構文wgetdfpol [-d | -v] class
説明wgetdfpol コマンドは、指定されたラベルを持つリソースのデフォルトのポリシー・デフォルト・オブジェクトまたはポリシー検証オブジェクトのラベルを表示します。リソースがポリシー・リージョンに管理対象リソースとして追加されると、そのリソースは、デフォルトのポリシー検証オブジェクトとデフォルトのポリシー・デフォルト・オブジェクトの両方を受け取ります。これらのデフォルトは、リソース定義の一部として事前定義されています。ポリシー・デフォルト・オブジェクトは、特定のリソース・タイプのオブジェクトをポリシー・リージョン内に作成するとき、デフォルト値を作成します。ポリシー検証オブジェクトは、ポリシー・リージョン内の管理対象リソース・タイプのオブジェクトについて、属性値のチェックを実行します。
オプション-d ポリシー・デフォルト・オブジェクトのラベルを表示します。-v を指定し
ないと、このオプションがデフォルトになります。
-v ポリシー検証オブジェクトのラベルを表示します。
class デフォルト・ポリシー・オブジェクトを検索する管理対象リソース・クラスを指定します。
権限senior または super
例次の例では、ProfileManager クラスについてデフォルトのポリシー・デフォルト・オブジェクトの名前が戻されます。
wgetdfpol -d ProfileManager
参照wchkpol, wcrtpol, wcrtpr, wdelpol, wdelpr, wgetpolm, wlspol, wlspolm,
wputpolm
240 Tivoli Management Framework: リファレンス・マニュアル
wgeteppol
エンドポイント・ポリシー・スクリプトの本体と定数値を表示します。
構文wgeteppol policy_name
説明wgeteppol コマンドは、指定したエンドポイント・ポリシー・スクリプトの内容を表示します。組織の必要性に合うよう、スクリプトの変更ができます。エンドポイント・ポリシー・スクリプトは、allow_install_policy、after_install_policy、login_policy、および select_gateway_policy です。
エンドポイント・ポリシー・スクリプトをまだ追加していない場合は、wgeteppolの出力は、スクリプトのシェルになります。コメントの後で、exit ステートメントの前に、ポリシー・スクリプトの内容を追加してください。その後で、wputeppolコマンドを使用して、新規スクリプトをディスクに書き込みます。
オプションpolicy_name
戻すポリシー・スクリプトの名前を指定します。
権限senior
例次の例では、after_install_policy スクリプトが戻されます。この後、必要に応じてこのスクリプトを変更できます。
wgeteppol after_install_policy#!/bin/sh## The following are the command line options passed to# this script from the Endpoint Manager.## $1 - The label of the endpoint machine# $2 - The object reference of the endpoint machine# $3 - The architecture type of the endpoint machine# $4 - The object reference of the gateway that the# endpoint logged into# $5 - The ip address of the endpoint logging in.# $6 - Region# $7 - Dispatcher# $8 - Version# $9 - The inventory id of the endpoint logging in.#The following command line option will be passed to this script#from the Endpoint Manager, when complied with the MULTIPROTO flag#turned on# $10 - The protocol of the endpoint logging in.#TCPIP -> TCP/IP#IPX -> IPX/SPX#Note that the environment variable LCF_LOGIN_STATUS is also set by#the endpoint manager. A value of 2 indicates the endpoint#is isolated. That is, it was unable to contact its
第 3 章 コマンド (アルファベット順) 241
#assigned gateway. Isolated endpoints are automatically#migrated to another gateway unless the#select_gateway_policy terminates with a nonzero exit#status.##Also note that during the execution of#allow_install and select_gateway policy scripts,#the endpoint does not yet formally exist. For this#reason, the endpoint object reference will have a#value of OBJECT_NIL, and the object dispatcher number#will be 0. The endpoint label will have the value#suggested by the endpoint (or the user value lcfd -n),#but is not guaranteed to become the final endpoint#label. It will become the final endpoint label if#this value is not already taken by another endpoint.exit 0#
参照wputeppol
wgeteppol
242 Tivoli Management Framework: リファレンス・マニュアル
wgetjob
ジョブのプロパティーをリスト表示します。
構文wgetjob task_name library_name
説明wgetjob コマンドは、ジョブのプロパティーを標準出力に表示します。
オプションlibrary_name
指定したジョブが入っているタスク・ライブラリーの名前を指定します。
task_name
表示するジョブの名前を指定します。
権限user、admin、senior、super
例次の例では、Clean Queue ジョブのプロパティーをリスト表示します。
wgetjob "Clean Queue" queue_lib
Job Name : Clean QueueTask Name : Clean QueueExecution Mode : parallelTimeout : 60Output Format : task header
return codetask standard outputtask standard error
Managed Nodes : yogi
Profile Managers :
参照wcrtjob, wdeljob
第 3 章 コマンド (アルファベット順) 243
wgetkey
レジストリー・ハイブ内のサブキーのリストを検索します。このコマンドはエンドポイントから実行する必要があります。(Windows のみ)
構文wgetkey registry_key_path [registry_entry]
説明wgetkey コマンドは、指定されたレジストリー項目から指定されたキー・パスに関連したサブキーを検索します。リストは標準出力に戻されます。
オプションregistry_entry
サブキーの検索を行うレジストリー項目を指定します。有効なエントリーは次のとおりです。
v HKEY_LOCAL_MACHINE
v HKEY_CLASSES_ROOT
v HKEY_CURRENT_USER
v HKEY_USERS
このオプションを指定しないと、HKEY_LOCAL_MACHINE 項目からサブキーの検索が行われます。
registry_key_path
サブキーの検索を行うレジストリー・キー名を指定します。
権限admin
例1. 以下の例は、SOFTWARE キー・パス下の HKEY_LOCAL_MACHINE 項目からサブキーのすべてを検索します。
wgetkey SOFTWARE
2. 以下の例は、USERS キー・パス下の HKEY_CURRENT_USER 項目からキー値を検索します。
wgetkey USERS HKEY_CURRENT_USER
244 Tivoli Management Framework: リファレンス・マニュアル
wgetpolm
デフォルト・ポリシー・メソッドまたは検証ポリシー・メソッドの本体あるいは定数値を表示します。
構文wgetpolm -d class name policy
wgetpolm -v class name policy
wgetpolm -d profile policy
wgetpolm -v profile policy
説明wgetpolm コマンドは、ポリシー・メソッドの本体または定数値を標準出力に表示します。このコマンドは、コードまたは定数値のいずれかを戻します。ポリシー・メソッドがシェル・スクリプト (または実行可能プログラム) として実現されている場合、このメソッドは、そのスクリプト (またはプログラム) 本体を戻します。ポリシー・メソッドが定数値として実現されている場合は、このメソッドは、その定数値を戻します。このコマンドは、どのようにメソッドが実現されているかを明示的には示しません。
注: 実行可能プログラムであるポリシー・メソッドの場合、このコマンドは、実行可能プログラムのバイナリー・イメージを戻します。
-d オプション (デフォルト) は、デフォルト・ポリシー・メソッドを戻し、-v は、検証ポリシー・メソッドを戻します。 class オプションと name オプションは、それぞれ、管理対象リソース・タイプとポリシー・オブジェクト名を指定します。また、policy オプションは、wlspolm コマンドと同じ形式で、ポリシー・メソッドが戻す個々の属性を指定します。
プロファイルのポリシーを照会するには、このコマンドの 2 番目の形式を使用します。この場合、profile は照会するプロファイルを指定し、 policy は、wlspolm コマンドで再度戻されるポリシーを持つ個々の属性を指定します。ポリシーが定数値として実現されている場合は、このコマンドは、その定数値を戻します。ポリシーがシェル・スクリプト (または実行可能プログラム) として実現されている場合、このコマンドは、そのスクリプト (またはプログラム) のボディを標準出力に戻し、スクリプトに対するオプションを標準エラーに出力します (wputpolm コマンドを参照)。ポリシーが未定義の場合、または none に指定されている場合は、その影響についてのメッセージが標準エラーに出力され、標準出力には何も出力されません。
オプション-d 指定されたデフォルト・ポリシー・メソッドを表示します。 -v オプション
を指定しないと、このアクションがデフォルトになります。
-v 指定されたポリシー検査メソッドを表示します。
class ポリシーを戻す管理対象リソース・タイプを識別します。
第 3 章 コマンド (アルファベット順) 245
name ポリシー・オブジェクトの名前を識別します。
policy ポリシーを戻す属性を識別します。
profile ポリシーを戻すプロファイルを識別します。
権限少なくとも senior 役割を持っていることが必要です。
例プロファイルを使用しない場合、次の例は、ProfileManager リソースのBasicProfileManager ポリシー検証オブジェクトの pm_val_subscribers メソッドについてスクリプト本体を戻します。
wgetpolm -v "ProfileManager" "BasicProfileManager" "pm_val_subscribers"
プロファイルを使用する場合、次の例では Engineering というプロファイルのデフォルト・ユーザー ID (UID) ポリシーについてスクリプト本体を戻します。
wgetpolm -d @UserProfile:user_profile_2 uidscript ARGUMENTS: $real_name $login_name
参照wchkpol, wcrtpol, wcrtpr, wdelpol, wdelpr, wgetdfpol, wlspolm, wputpolm
wgetpolm
246 Tivoli Management Framework: リファレンス・マニュアル
wgetpr
ポリシー・リージョンのプロパティーをリスト表示します。
構文wgetpr region
説明wgetpr コマンドは、ポリシー・リージョンのプロパティーを表示します。
オプションregion ターゲットのポリシー・リージョンを指定します。
権限admin、senior、super
例次の例は、DefaultRegion ポリシー・リージョン内のすべての管理対象リソースを表示します。
wgetpr @PolicyRegion:DefaultRegion
TaskLibraryManagedNodeProfileManager
参照wsetpr
第 3 章 コマンド (アルファベット順) 247
wgetprf
1 つ以上のプロファイルのサブスクリプション・コピーを検索します。
構文wgetprf [-l maintain | over_all] [-m] [-r] name
説明wgetprf コマンドは、現在のプロファイル・マネージャーまたはエンドポイント(ホストあるいはネットワーク情報サービス (NIS) ドメイン) がサブスクライブされている 1つ以上のプロファイルのサブスクリプション・コピーを、プロファイル・マネージャーから検索します。このコマンドはサブスクライバー・データベースを更新し、Tivoli データベースの構成ファイルも更新します。name オプションは、サブスクリプション・コピーの送信先であるエンドポイントを指定します。また、この引き数で現在のプロファイル・コピーも指定できます。
-m オプションを指定すると、複数ステップの配布が (すべてのレベルのサブスクライバーへの配布) プロファイル・マネージャーから実行されます。このオプションを指定しないと、単一ステップの配布が実行されます。
-l オプションは、配布レベルを識別します。このオプションを指定しないと、デフォルトで maintain になります。
オプション-l maintain | over_all
配布レベルを指定します。maintain オプションは、ローカル変更を保持します。over_all オプションは、ローカル変更を上書きします。デフォルトは maintain です。
-m 複数ステップの配布を指定します。
-r プロファイル・マネージャーへのプロファイルの配布、またはプロファイル・マネージャーからのプロファイルの検索が、1 回以上失敗した場合に、戻りコードを 1 に設定します。
name サブスクリプション・コピーまたは現在のプロファイル・コピーの送信先であるエンドポイントを指定します。有効な形式は、次のとおりです。
v @node_name
v @ManagedNode:node_name
v /Regions/policy_region_name/node_name
権限admin、senior、super
例1. 次の例では、プロファイル・コピー Users が検索され、ローカル変更はすべて上書きされます。
248 Tivoli Management Framework: リファレンス・マニュアル
wgetprf -l over_all @UserProfile:Users@rushmore
2. 次の例では、管理対象ノード rushmore にあるすべてのプロファイル・コピーが反復的に検索され、いずれのローカル変更も実行されます。
wgetprf -m @ManagedNode:rushmore
参照wcrtpr, wcrtprfmgr, wdistrib, wgetsub, wlssub, wpopulate, wsub, wunsub
wgetprf
第 3 章 コマンド (アルファベット順) 249
wgetquery
照会に関する情報をリスト表示します。
構文wgetquery [-f] query_name
説明wgetquery コマンドは、Tivoli 照会に関する情報を表示します。この情報には、名前、説明、リポジトリー、ビュー、列のリスト、where 文節などが入っています。
オプション-f 指定された照会に関するすべての情報をリストします。このオプションを省
略すると、where 文節のみがリストされます。
query_name
照会の名前を指定します。
権限query_view、user、admin、senior、または super
例次の例では、DOS-machines 照会に関するすべての情報が表示されます。
wgetquery -f DOS-machines
Name: DOS-machinesDescription: Query for DOS PCsRepository: inventoryView: MACHINE_TYPEColumns:
PROCESSOR_TYPEOPERATING_SYSTEM
Where Clause:--------------------(BOOTED_OS_NAME = ’DOS’)
参照wcrtqlib, wcrtquery, wruninvquery, wsetquery
250 Tivoli Management Framework: リファレンス・マニュアル
wgetrim
RDBMS Interface Module (RIM) オブジェクトに関する情報を表示します。
構文wgetrim rim_name
説明wgetrim コマンドは、指定された RIM オブジェクトに関する現在の情報を表示します。このコマンドは、アプリケーション・ラベルおよび最大接続を除く、すべての構成情報を戻します。この情報を取得するには、該当する idlcall コマンドを使用します。
オプションrim_name
RIM オブジェクトのラベルを指定します。このラベルには、Tivoli ネーム・レジストリー・ラベル (@RIM:name 形式) またはテキスト・ラベルのいずれかを指定します。いつも RIM オブジェクトを検出できるようにするには、 rim_name の前に @ 文字を付ける必要があります。
権限Tivoli リージョン内の senior または super
例1. 次の例では、inventory RIM オブジェクトに関する情報が戻ります。
wgetrim invdh_1
出力は、次のようになります。
RIM Host: fwksrv1RDBMS User: invtivRDBMS Vendor: DB2Database ID: invdbDatabase Home: /usr/lpp/db2_07_01Server ID: tcpipInstance Home: ~invtivInstance Name: invtiv
2. アプリケーション・ラベルおよび RIM オブジェクトに対する最大接続を決定するには、以下の手順に従ってください。
a. Tivoli 環境内のすべての RIM オブジェクトをオブジェクト ID (OID) によってリストします。
wlookup -ar RIM
b. アプリケーション・ラベルをリストします。
idlcall OID _get_application_type
c. 接続の最大数をリストします。
idlcall OID _get_max_conn
第 3 章 コマンド (アルファベット順) 251
参照wcrtrim, wsetrim, wsetrimpw
wgetrim
252 Tivoli Management Framework: リファレンス・マニュアル
wgetsched
スケジューラーに現存するジョブについての情報を検索します。
構文wgetsched [-b ’mm/dd/yyyy hh:mm’] [-a ’mm/dd/yyyy hh:mm’] [-v]
wgetsched [-s id...] [-v]
説明wgetsched コマンドは、実行を現在スケジュールされているジョブに関する情報を検索します。オプションを何も指定しないと、すべてのジョブに関する情報が表示されます。
オプション-a ’mm/dd/yyyy hh:mm’
検索の開始時刻を指定します。
-b ’mm/dd/yyyy hh:mm’
検索の終了時刻を指定します。
-s id... ジョブ ID を指定します。複数のジョブ ID を指定できます。
-v 冗長モードを指定します。
権限user
例1. 以下の例は、ジョブ 2、8、および 10 のスケジューリング情報をリストします。
wgetsched -s 2 -s 8 -s 10
Job ID Label Admin Date & Time Enbld Repeat Retry Cncl------ ----- ----- ----------- -----------------------000008 JOB_14 root@cook Fri May 6 01:00:00 2003 YES YES NO YES000002 JOB_2 root@cook Sun Jan 1 01:12:00 2004 YES NO NO NO000010 JOB_9 root@cook Wed Mar 1 06:55:00 2004 YES NO YES NO
2. 以下の例は、ジョブ 2 の冗長出力をリストします。
wgetsched -s 2 -v
ID : 2Name : BackupLabel : BackupDescription :Administrator : root@cookOriginal Time : Tue Mar 05 16:00:00 2003Next Time : Tue Mar 05 16:00:00 2003Enabled : YesRepeat Type : InfiniteRepeat Increment : 1Repeat Unit : DayRepeat Times : 0
第 3 章 コマンド (アルファベット順) 253
Retry Type : NoneRetry Increment : 0Retry Unit : MinuteRetry Times : 0Cancel Job : YesCancel Increment : 10Cancel Unit : MinuteEmail :Notice : Tivoli SchedulerDesktop :Host Name :File Name :Daytime Rest. : NoDaytime From : 6Daytime To : 18Nighttime Rest. : NoNighttime From : 17Nighttime To : 8Weekday Rest. : NoWeekday From : 1Weekday To : 5Weekend Rest. : YesWeekend From : 6Weekend To : 0
3. 次の例では、1998 年 5 月 6 日午前 1 時より前、および 1998 年 5 月 8 日午後 1 時より後に実行するようスケジュールされているジョブが表示されます。
wgetsched -b ’05/06/1998 01:00’ -a ’05/08/1998 13:00’
4. 次の例では、1998 年 8 月 10 日真夜中以降、および 1998 年 8 月 12 日午後6 時より前に実行するようスケジュールされているジョブが表示されます。
wgetsched -a ’08/10/1998 00:00’ -b ’08/12/1998 18:00’
参照wdelsched, wedsched, wenblsched, wschedjob
wgetsched
254 Tivoli Management Framework: リファレンス・マニュアル
wgetsub
プロファイル・マネージャーのサブスクライバーを表示します。
構文wgetsub [-l] [-o] name
説明wgetsub コマンドは、特定のプロファイル・マネージャーのサブスクライバーをリストします。
オプション-l 詳細表示を指定します。
-o 各サブスクライバーのオブジェクト ID を表示します。
name サブスクライバーが登録されているプロファイル・マネージャーの名前を指定します。有効な形式は、次のとおりです。
v @profile_manager_name
v @ProfileManager:profile_manager_name
v /Regions/policy_region_name/profile_manager_ name
権限user、admin、senior、super
例次の例では、Development プロファイル・マネージャーのすべてのサブスクライバーが表示されます。
wgetsub @Development
参照wcrtprf, wcrtprfmgr, wdistrib, wgetprf, wlssub, wpopulate, wsub, wunsub,
wvalidate
第 3 章 コマンド (アルファベット順) 255
wgettask
タスクのプロパティーをリスト表示します。
構文wgettask [-F file_name] task_name library_name
説明wgettask コマンドは、タスクのプロパティーを標準出力に表示します。
オプション-F file_name
タスク情報を書き込むファイルを指定します。このオプションは、タスク・バイナリーとコメントの .tar ファイルと共にタスク設定値の記述を作成します。このオプションは、ある Tivoli 環境から別の環境へタスクをエクスポートするときに役立ちます。
library_name
指定したタスクが入っているタスク・ライブラリーの名前を指定します。
task_name
表示するタスクの名前を指定します。
権限user、senior、super
例次の例では、queue_lib タスク・ライブラリー内の Clean Queue タスクに関するすべての情報が表示されます。
wgettask "Clean Queue" queue_lib
Task Name : Clean QueueUser ID : *Group ID :Task ACL : admin:senior:super:userSupported Platforms :solaris2 <install>/solaris2/TAS/TASK_LIBRARY/bin/200000/tasknpzmqdTask Documentation :Task Name : Clean Queue
Task Created : Wed Sep 14 20:20:16 1998Task Created By : root@yogiComments:
参照wcrttask, wdeltask
256 Tivoli Management Framework: リファレンス・マニュアル
wgetval
レジストリー・サブキーを検索します。(Windows のみ)
構文wgetval [-h registry_hive] -k {key | @file_name} -n value_name
説明wgetval コマンドは、レジストリーからサブキーを検索します。このコマンドの出力は、標準出力に戻ります。
オプション-h registry_hive
サブキーの検索を行うレジストリー・ハイブを指定します。有効な値は次のとおりです。
v HKEY_LOCAL_MACHINE
v HKEY_CURRENT_USER
v HKEY_CLASSES_ROOT
v HKEY_USERS
v HKEY_CURRENT_CONFIG
v HKEY_DYN_DATA
-k key | @file_name
サブキーの検索を行うキーまたはファイルを指定します。
-n value_name
値の名前を指定します。
権限admin
例以下の例は、Novell ドライバーのバージョン番号を検索します。
wgetval -h HKEY_LOCAL_MACHINE -k SOFTWARE¥NOVELL -n CurrentVersion
参照wsetval
第 3 章 コマンド (アルファベット順) 257
whostid
指定された管理対象ノードのホスト ID を出力します。
構文whostid host_name
説明whostid コマンドは、指定された管理対象ノードの数値ホスト ID を標準出力へ送ります。
オプションhost_name
ID を表示するホストの名前を指定します。
権限user、admin、senior、super
例次の例は、管理対象ノード bald のホスト ID を表示します。
whostid bald
8031ee30
参照wdate, wdiskspace, wifconfig, winstdir, winterp, wmannode, wmemsize,
wping, wtimezone, wuname, wxterm
258 Tivoli Management Framework: リファレンス・マニュアル
whttpd
Tivoli HTTP サービス (spider) をアンインストールまたは登録抹消し、必要に応じて HTTP 要求をサード・パーティー Web サーバーに転送します。
構文whttpd -f url
whttpd -g
whttpd -r node_name [-f url]
whttpd -u node_name [-f url]
説明whttpd コマンドを使用して、spider をアンインストールまたは登録抹消し、必要に応じて HTTP 要求をサード・パーティー Web サーバーに転送することができます。 spider サービスは、管理対象ノード上でオブジェクト・ディスパッチャーに関連付けられています。 spider をアンインストールする代わりに登録抹消すると、spider バイナリーは管理対象ノード上に残ります。
注: spider サービスは、ゲートウェイのリスト表示またはエンドポイントのリスト表示と関連付けられている HTTP サービスには影響しません。
オプション-f url 指定した Universal Resource Location (URL) に HTTP 要求を転送します。
url のフォーマットは次のとおりです。
protocol://web_server_address:port/TivoliFRW/webapp
ここで、
protocol
HTTP 要求に使用されるプロトコル。
web_server_address
サード・パーティー Web サーバーにホスティングするマシンのWWW で知られている名前または IP アドレス。
port サード・パーティー Web サーバー用に正しく構成されているHTTP ポート。
このオプションを使用するには、admin の役割が必要です。
-g サード・パーティー Web サーバーの URL を戻します。 spider を使用している環境の場合や、転送を使用可にしていない場合には、このコマンドは「転送 URL が設定されていません」というメッセージを戻します。
このオプションを使用するには、user 役割が必要です。
-r node_name
spider を登録抹消して spider ファイルを削除します。 node_name が Tivoli
第 3 章 コマンド (アルファベット順) 259
サーバーである場合、コマンドは Tivoli リージョン内のすべての管理対象ノード上で spider をアンインストールします。このオプションを使用するには、super の役割が必要です。
-u node_name
spider を登録抹消します。ただし、spider ファイルは保存しておきます。node_name が Tivoli サーバーである場合、コマンドは Tivoli リージョン内のすべての管理対象ノード上で spider を登録抹消します。このオプションを使用するには、super の役割が必要です。
注: spider バイナリーの削除は永続的なものです。
例1. 次の例では、管理対象ノード ccorley から spider を登録抹消しますが、spider
ファイルは保存しておきます。
whttpd -u ccorley
2. 次の例では、ワークステーション lorozco にあるサード・パーティー Web サーバーに HTTP 要求を転送します。
whttpd -f http://w3.lorozco.tivoli.com/TivoliFRW/webapp
whttpd
260 Tivoli Management Framework: リファレンス・マニュアル
wiconv
1 つのファイル内の文字または文字シーケンスを、現在のコード・セットから別のコード・セットに変換します。
構文wiconv [-f code_set] [-t code_set < input]
wiconv [-f code_set] [-t code_set > output]
wiconv [-f code_set] [-t code_set] [-i input] [-o output]
説明wiconv コマンドは、1 つのファイル内の文字または文字シーケンスを、あるコード・セットから別のコード・セットに変換し、結果を標準出力に書き込みます。このコマンドを使用する前に、TISDIR 環境変数を設定する必要があります。
オプション-f code_set
入力コード・セットを指定します。
-i input
標準入力を使用しない場合に、使用する入力ファイルの名前を指定します。
-o output
標準出力を使用しない場合に、使用する出力ファイルの名前を指定します。
-t code_set
出力コード・セットを指定します。
> output
結果を標準出力に書き込みます。
< input
入力データを標準入力から読み取ります。
権限このコマンドを実行する場合、Tivoli リージョンの許可の役割は不要です。
例次の例では、source.txt ファイルの中のデータを取り出し、それを SJIS エンコード方式から UTF8 エンコード方式に変換し、その結果を utf8.html ファイルに出力します。
wiconv -f SJIS -t UTF8 -i source.txt -o utf8.html
第 3 章 コマンド (アルファベット順) 261
wident
指定されたパターンが含まれるファイルを識別します。
構文wident [-q] [file...]
説明wident コマンドは、指定されたファイル内のパターン "$keyword:...$" のすべてのオカレンスを検索します。ファイル名が指定されないと、標準入力内を検索します。
これらのパターンは、通常、wco コマンドによって自動的に挿入されますが、手動で挿入することもできます。 -q オプションを使用することで、ファイルに指定されたパターンが含まれていないという警告メッセージが表示されないように設定することができます。
wident コマンドは、テキスト・ファイル、オブジェクト・ファイル、およびダンプに対して有効です。たとえば、f.c 内の C プログラムに次の行がある場合、
char rcsid[] = "$Id: f.c,v ¥*(iD $";
f.c が f.o にコンパイルされた後で、次のコマンドにより、
wident f.c f.o
出力は、次のようになります。
f.c:$Id: f.c,v ¥*(iD $
f.o:$Id: f.c,v ¥*(iD $
作成者作成者: Walter F. Tichy リビジョン番号: 5.0; リリース日: 1980/08/22 Copyright ©
1982, 1988, 1989 by Walter F. Tichy. Copyright © 1990 by Paul Eggert.
参照wci、 wco、 wrcs、 wrcsdiff、 wrcsmerge、 wrlog Walter F. Tichy 著、RCS—A System for Version Control, Software—Practice & Experience15, 7 (July
1985), 637-654.
262 Tivoli Management Framework: リファレンス・マニュアル
widmap
ユーザー・ログインのマッピングを表示し、変更します。
構文widmap add_entry map_name interp entry_val
widmap add_map map_name
widmap list_entries map_name
widmap list_maps
widmap resolve_entry map_name interp
widmap rm_entry map_name interp
widmap rm_map map_name
説明widmap コマンドは、マップ全体またはマップのエントリーの作成、リスト、追加、削除を行います。このコマンドによって、複数のプラットフォーム間のユーザー・ログインのマッピングを作成し、保守することができます。ログイン・マップにより、Tivoli Management Framework は、指定されたオペレーティング・システム上の正しいユーザー・アカウントに単一のユーザー・ログイン名を関連付けることができます。たとえば、ログイン名 chris を、Solaris オペレーティング環境のユーザー名 chriss と、Windows オペレーティング・システムのユーザー名 chris_sanders
にマップすることができます。
次の例は、2 つのログイン・マッピングを示しています。1 つは root_user、もう 1
つは chris のマッピングです。
root_user default rootroot_user w32-ix86 Administratorchris solaris2 chrisschris w32-ix86 chris_sanders
マップ名は、Tivoli ウィンドウで $map_name として入力できます。たとえば、マップ名 $chris を、「アドミニストレーターの作成」ウィンドウの「ログイン名」または「グループ名」フィールドに入力できます。処理の際、このマップ名はオペレーティング・システムの規則に従って正しいユーザー名に解決されます。
オプションadd_entry
マップ項目を追加します。
add_mapマップを追加します。
list_entriesマップの既存の項目をリストします。
第 3 章 コマンド (アルファベット順) 263
list_maps既存のマップをリストします。
resolve_entryインタープリター・タイプに基づいて entry_val の値を戻します。
rm_entryインタープリター・タイプに基づいてマップ項目を除去します。
rm_mapマップを除去します。
entry_val
マップが解決されるユーザー名を指定します。
interp entry_val が有効なユーザー名になるインタープリター・タイプまたはオペレーティング・システムを識別します。interp の値を default と指定すると、個別の interp エントリーをもっていないすべてのオペレーティング・システム上で、default の entry_val が使用されます。
map_name
表示または変更を行うマッピングを識別します。
権限マップの表示: user
マップの作成、編集、または削除: super
例1. 次の例では、すべてのマッピングが表示されます。
widmap list_maps
2. 次の例では、default 項目が $chris マップに追加されます。
widmap add_entry chris default chris
chris solaris2 chrisschris w32-ix86 chris_sanderschris default chris
3. 次の例では、solaris2 項目が $chris マップから削除されます。
widmap rm_entry chris solaris2
4. 次の例では、$chris マップ内でデフォルトのインタープリター・タイプにマップされているユーザー名が戻されます。
widmap resolve_entry chris default
このコマンドを実行すると、chris が戻ります。
注: 同じコマンドを HP-UX オペレーティング・システムについて実行した場合、結果は同じになります。HP-UX のエントリーはないので、デフォルト値が戻されます。
widmap
264 Tivoli Management Framework: リファレンス・マニュアル
wifconfig
管理対象ノード上のインターネット・プロトコル (IP) インターフェースの照会または変更を行います。
構文wifconfig -h node_name
wifconfig -h node_name -a device IP_address name notify_server
wifconfig -h node_name -r device [IP_address] [name]
wifconfig -h node_name -s device IP_address name notify_server
説明wifconfig コマンドを使用すると、管理対象ノードにおける IP インターフェースの追加、除去またはリスト表示を行うことができます。
オプション-a IP インターフェースを UNIX 管理対象ノードに追加します。そのインター
フェースのデバイス、IP アドレス、名前を指定する必要があります。Tivoli
サーバーにその新しい IP インターフェースについての通知を送信するかどうかも指示する必要があります。このオプションは、UNIX 管理対象ノードでのみサポートされています。
-h node_name
操作が実行される管理対象ノードを指定します。
-r UNIX 管理対象ノードから IP インターフェースを除去します。デバイス名を指定する必要があります。オプションで、IP アドレスとインターフェース名を指定することができます。このオプションは、UNIX 管理対象ノードでのみサポートされています。
-s UNIX 管理対象ノード上の現在の IP インターフェースの設定を変更します。デバイス名と新しいインターフェース定義 (IP アドレス、インターフェース名、および Tivoli サーバーにそのインターフェースについて通知するかどうか) を指定する必要があります。このオプションによってデバイス名を変更することはできません。このオプションは、UNIX 管理対象ノードでのみサポートされています。
device インターフェースで使用するデバイスを指定します。
IP_address
インターフェースの IP アドレスを指定します。
name インターフェースの名前を指定します。
notify_server
ローカル Tivoli リージョン内の Tivoli サーバーに IP インターフェースの追加または変更を通知するかどうかを指定します。値としては TRUE または FALSE を指定してください。
第 3 章 コマンド (アルファベット順) 265
権限リストする場合: user、admin、senior、super
IP インターフェースを追加/除去する場合、もしくは IP インターフェースのプロパティーを変更する場合: admin、senior、super
例1. 次の例では、管理対象ノード bald の IP アドレスが照会されます。
wifconfig -h bald
Device Address Name Used by dispatcherlo0 127.0.0.1 localhost unused
2. 以下の例では、名前が bald2 で IP アドレスが 146.84.49.3 である lel IP インターフェースが管理対象ノード bald に追加されて、この新規インターフェースの情報が Tivoli サーバーに通知されます。
wifconfig -h bald -a lel 146.84.49.3 bald2 TRUE
3. 次の例では、管理対象ノード bald の IP インターフェース bald2 が削除されます。
wifconfig -h bald -r lel 146.84.49.3 bald2
参照netstat, odadmin
wifconfig
266 Tivoli Management Framework: リファレンス・マニュアル
winsblk
ステートメントのブロックをファイルに挿入します。このコマンドはエンドポイントから実行する必要があります。
構文winsblk -s ″search_string″ -a ″insertion_string″ | @file_name [-o output_file]
file_name
winsblk -s ″search_string″ -b ″insertion_string″ | @file_name [-o output_file]
file_name
説明winsblk コマンドは、ステートメントのブロックをファイルに挿入します¡ このコマンドを使用すると、固有のストリングで区切ったステートメントのブロックを追加できます。追加したブロックは、後で wrplblk または wclrblk コマンドを使用して検索または削除できます。
オプション-a ″insertion_string″ | @file_name
検索ストリングを含んでいる行のあとにステートメントのブロックを挿入します。このオプションは、-b オプションと共に指定することはできません。
insertion_string を指定する場合は、ストリングを二重引用符で囲んでください。@file_name を指定すると、指定したファイルからステートメントのブロックが挿入されます。
-b ″insertion_string″ | @file_name
検索ストリングを含んでいる行の前にステートメントのブロックを挿入します。このオプションは、-a オプションと共に指定することはできません。
insertion_string を指定する場合は、ストリングを二重引用符で囲んでください。@file_name を指定すると、指定したファイルからステートメントのブロックが挿入されます。
-o output_file
出力を、指定されたファイルに書き込みます。このオプションを指定しないと、出力は標準出力に書き込まれます。
-s ″search_string″検索ストリングを指定します。検索ストリングを含んでいる行がある場合、ステートメントのブロックは、検索ストリングを含んでいる行の前 (-b オプションを指定した場合) または後 (-a オプションを指定した場合) に挿入されます。このオプションを指定しないと、ステートメントのブロックはファイルの最後に追加されます。
file_name
ブロックの挿入先のファイルを指定します。
第 3 章 コマンド (アルファベット順) 267
戻り値winsblk は次のいずれかの値を戻します。
0 コマンドが指定されたステートメント・ブロックを追加したことを示します。
ゼロ以外コマンドが指定されたステートメント・ブロックを追加しなかったことを示します。
例c:¥temp¥blkstmts.fil ファイル内のステートメントを、c:¥windows¥system.ini ファイルに device= ストリングが出現する都度そのあとに挿入し、出力を c:¥temp¥outputl.fil
ファイルにリダイレクトする場合は、次のコマンドを入力します。
winsblk -s "device=" -a @c:¥temp¥blkstmts.fil ¥-o c:¥temp¥outputl.fil c:¥windows¥system.ini
参照wclrblk, winsline, wrplblk
winsblk
268 Tivoli Management Framework: リファレンス・マニュアル
winsline
ファイルに 1 行挿入します。このコマンドはエンドポイントから実行する必要があります。
構文winsline [-f] -s ″search_string″ -a ″insertion_string″ [-o output_file] file_name
winsline [-f] -s ″search_string″ -b ″insertion_string″ [-o output_file] file_name
説明winsline コマンドは、テキスト・ファイルに行を追加します。追加する行の位置には、検索ストリングを含んでいる行の前またはあとにどちらかを指定できます。
オプション-a ″insertion_string″
指定されたストリングまたは指定されたファイルに含まれている行を、検索ストリングを含んでいる行のあとに挿入します。このオプションは、-b オプションと共に指定することはできません。 ストリングは二重引用符で囲んでください。
-b ″insertion_string″指定されたストリングまたは指定されたファイルに含まれている行を、検索ストリングを含んでいる行の前に挿入します。このオプションは、-a オプションと共に指定することはできません。 ストリングは二重引用符で囲んでください。
-f 検索ストリングを含む最初の行だけを処理します。このオプションを指定しないと、検索ストリングに一致するストリングが見つかるたびに処理が行われます。
-o output_file
出力が書き込まれるファイルの名前を指定します。このオプションを指定しないと、出力は標準出力に書き込まれます。
-s ″search_string″検索ストリングを指定します。検索ストリングを含んでいる行がある場合、挿入ストリングは、検索ストリングを含んでいる行の前 (-b オプションを指定した場合) または後 (-a オプションを指定した場合) に挿入されます。ストリングは二重引用符で囲んでください。
file_name
行を挿入するファイルの名前を指定します。
戻り値winsline コマンドは次のいずれかの値を戻します。
0 コマンドが指定された行を追加したことを示します。
ゼロ以外コマンドが指定された行を追加しなかったことを示します。
第 3 章 コマンド (アルファベット順) 269
例1. 以下の例は、c:¥windows¥system.ini ファイル内の device= ストリングの最初のオカレンスの後に lp01 を挿入して、出力を c:¥temp¥output.fil ファイルにリダイレクトします。
winsline -f -s "device=" -a "lp01" -o c:¥temp¥output.fil ¥c:¥windows¥system.ini
2. 以下の例は、c:¥windows¥system.ini ファイルで type= ストリングが現れるごとに、その前に dev01 を挿入して、出力を c:¥temp¥output.fil ファイルにリダイレクトします。
winsline -s "type=" -b "dev01" -o c:¥temp¥output.fil c:¥windows¥system.ini
参照wclrline, 267ページの『winsblk』, wrplline
winsline
270 Tivoli Management Framework: リファレンス・マニュアル
winstall
Tivoli Enterprise 製品をインストールします。
構文winstall [-c source_dir] [-s server] [-i product] [-y] [install_variables] [-n |
managed_node...]
説明winstall コマンドは、Tivoli リージョン 上で呼び出されると、Tivoli Enterprise製品をコマンド行からインストールします。製品をインストールする前に、このコマンドは、インストール時に実行されるアクションを識別します。
オプション-c source_dir
インストール・イメージ が入っているディレクトリーへの完全パスを指定します。 source_dir には、完全修飾パス (たとえば、/cdrom)、もしくはソース・ホストと source_host:path (たとえば、oak:/cdrom) フォーマットのパスのどちらかを指定できます。
-i product
製品のインストール元の製品インデックス・ファイルを指定します。インデックス・ファイルには、.IND という拡張子が付いています。
-n 現在製品がインストールされていない管理対象ノードすべてに製品をインストールします。 managed_node を指定すると、このオプションは無視されます。
-s server
インストール・サーバーとして使用する管理対象ノードを指定します。指定しないと、Tivoli サーバーが設定されます。
-y 確認メッセージなしで製品をインストールします。
install_variables
製品固有の keyword=value ペアを指定します。詳細については、 272ページの『インストール変数』を参照してください。
注: インストール・オプションの名前は、製品の資料に示されているとおり正確に入力してください。インストール・オプションは、大文字小文字を区別します。
managed_node
この Tivoli Enterprise製品のインストール先の管理対象ノードを指定します。管理ノードは複数指定できます。管理対象ノードを指定しないと、製品はこの Tivoli リージョン内のすべての管理対象ノードにインストールされます。
第 3 章 コマンド (アルファベット順) 271
インストール変数インストールをコントロールするには、コマンド行で、インストール変数用の値を指定します。 Tivoli Enterprise製品にインストール変数がある場合は、その製品用のインデックス・ファイルを表示すると、その製品のインストール変数の限定的なリストを見ることができます。これらの変数を使用して、必須引き数と任意オプションを指定したり、デフォルトのインストール情報を指定変更できます。
インストール変数を使用して、Tivoli Enterprise製品のインストール先ディレクトリーを指定できます。この種のディレクトリーを指定するのは、Tivoli Management
Framework をインストールする場合です。その他の Tivoli 製品は、Tivoli
Management Framework と同じディレクトリーを使用します。ディレクトリー内にすでにファイルが入っている場合、同じ名前のファイルは再インストールされません。ただし、指定したディレクトリー用の値として感嘆符 (!) を入力することにより、これらのディレクトリーをどれでも強制的に上書きすることができます。たとえば¤バイナリーを再インストールするには、BIN=! と入力します。そのバイナリー・ディレクトリーまでのパス全体を入力するのではありません。この指定変更機能はすべてのインストール変数に適用されます。
次に示すのは、インストール・ディレクトリーに関する変数です。
BIN=binaries_dir
製品のバイナリーのデフォルト・インストール・パス (/usr/local/Tivoli/bin)
を変更します。
LIB=libraries_dir
製品のライブラリーのデフォルト・インストール・パス (/usr/local/Tivoli/lib)
を変更します。
DB=client_database
製品のクライアント・データベースのデフォルト・インストール・パス(/var/spool/Tivoli) を変更します。
MAN=manpage
製品のマニュアル・ページのデフォルト・インストール・パス(/usr/local/Tivoli/man) を変更します。
CAT=message_catalog
製品のメッセージ・カタログのデフォルト・インストール・パス(/usr/local/Tivoli/msg_cat) を変更します。
次に、便利な変数をもう 1 つ示します。
@CreatePaths@=0 | 1指定したディレクトリーがない場合に、このディレクトリーを作成する (1)
か、作成しない (0) かを指定します。デフォルトでは、ディレクトリーは作成されません。指定したディレクトリーがなければ、エラー・メッセージが表示されます。
権限Tivoli リージョンでの install_product または senior が必要です。
winstall
272 Tivoli Management Framework: リファレンス・マニュアル
例1. 次の例では、Tivoli リージョンリージョン内の管理対象ノードすべてに Tivoli
User Administration がインストールされます。インストール・イメージへのパスは /cdrom で、製品インデックス・ファイルは ADMIN です。
winstall -c /cdrom -i ADMIN
2. 次の例では、Tivoli Software Distribution を管理対象ノード dan および barney
にインストールします。インストール・イメージへのパスは /dev0/cdrom で、製品インデックス・ファイルは COURIER です。
winstall -c /dev0/cdrom -i COURIER dan barney
3. 次の例では、Tivoli User Administration を管理対象ノード petra に再インストールして、バイナリー・ディレクトリー内の既存ファイルを上書きします。インストール・イメージへのパスは /cdrom で、製品インデックス・ファイルはADMIN です。
winstall -c /cdrom -i ADMIN BIN=! petra
参照wclient, wpatch, wserver
winstall
第 3 章 コマンド (アルファベット順) 273
winstdir
指定された管理対象ノードのインストール・ディレクトリーのパスを出力します。
構文winstdir host_name
説明winstdir コマンドは、指定された管理対象ノードのインストール・ディレクトリーのパスを出力します。
オプションhost_name
インストール・ディレクトリーを表示するホストの名前を指定します。
権限user、admin、super、senior
例次の例では、管理対象ノード bald のインストール・ディレクトリーが表示されます。
winstdir bald
/data/shadow/solaris2/as/bin
参照wdate, wdiskspace, whostid, wifconfig, winterp, wmannode, wmemsize,
wping, wtimezone, wuname, wxterm
274 Tivoli Management Framework: リファレンス・マニュアル
winstendpt
エンドポイント・リソース・タイプの振る舞いをインストールします。
構文winstendpt behavior [resource_type]
説明winstendpt コマンドは、Endpoint リソース・タイプに振る舞いをインストールします。プロファイル・ベースのアプリケーションでエンドポイントの振る舞いが定義されると、管理対象ノードなどの Endpoint リソース・タイプの継承に、その振る舞いを追加できます。このコマンドは、通常、プロファイル・ベースのアプリケーションの初期化スクリプトから実行されます。
オプションbehavior
新しいエンドポイントの振る舞いのリソース・タイプのインスタンス・マネージャーを識別します。
resource_type
新しい振る舞いをインストールするエンドポイント・リソース・タイプを識別します。このオプションを省略すると、ManagedNode リソース・タイプが想定されます。
権限super、senior
例次の例では、ManagedNode リソース・タイプにリソース・タイプ aef のエンドポイントの振る舞いがインストールされます。
aef_CO=`wlookup -r Classes aef`managednode_CO=`wlookup -r Classes ManagedNode`winstendpt $aef_CO $managednode_CO
第 3 章 コマンド (アルファベット順) 275
winstlcf
AS/400 と OS/2 を除くすべてのオペレーティング・システムにエンドポイントをインストールします。
構文winstlcf [-a] [-C locale_name] [-D] [-d dir_name] [-e] [-f file_name] [-gmachine[+port][:machine[+port]] [-i] [-j] [-L config_options] [-l endpoint_port] [-Nendpoint] [-n endpoint_label] [-P] [-R] [-r policy_region] [-S share_name] [-sdir_name] [-T account] [-v] [-x TCPIP | IPX] [-Y] host [user_account password]...
説明winstlcf コマンドは、1 つまたは複数のワークステーション上にエンドポイント・サービス (lcfd) をインストールし、起動します。このコマンドを使用して、AS/400
および OS/2 を除くすべてのオペレーティング・システムにエンドポイントをインストールできます。 AS/400 オペレーティング・システムの場合は、w4inslcf.pl コマンドまたは Tivoli Software Installation Service を使用します。 OS/2 オペレーティング・システムの場合は、提供されている InstallShield プログラムまたは Tivoli
Software Installation Service を使用します。
注:
v Linux エンドポイントをインストールする前に、使用するアクセス方式 (exec
またはシェル) がターゲットで使用可能かを確認してください。 exec アクセス方式はデフォルト・インストール・オプションです。シェル・アクセス方式を指定するには、-e オプションを使用します。
v UNIX オペレーティング・システム の場合、 root ユーザーのログイン・シェルが C シェルであることはできません。
v winstlcf コマンドを使用して Windows エンドポイントをインストールするには、最初に InstallShield イメージを使用して手動でドメインまたはトラストに Windows エンドポイントを 1 つインストールする必要があります。このエンドポイントを、ドメインまたはトラストにすべての追加 Windows エンドポイントをリモート側でインストールするためのプロキシーとして使用します。プロキシー・エンドポイントをインストールした後、winstlcf コマンドと -N オプションを使用して、ドメインまたはトラストにすべての追加Windows エンドポイントをインストールしてください。
デフォルトでは、インストール後にエンドポイント・サービスが起動します。マシン名をコマンド行でリストするか、 -f オプションを使用してマシン名が入っているファイルを指定することによって、エンドポイントを複数のワークステーションにインストールできます。
winstlcf コマンドをマシン上で複数回実行すると、そのマシン上で実行する lcfd サービスの複数のインスタンスを持ちます。
いったん、インストール・パスワードを winstlcf コマンドで指定すると、そのパスワードは、その後のすべてのインストールでデフォルト・パスワードになります。パスワードを変更するには、以下のステップに従ってください。
276 Tivoli Management Framework: リファレンス・マニュアル
1. 別のパスワードを明示的に指定する。
2. サポートされていないオペレーティング・システムへのインストールを試みる。これにより、パスワードが入っているグローバル変数は消去されます。
3. -P オプションを指定します。
オプション-a エンドポイントを非同期でインストールするよう指定します。このオプショ
ンを指定しないと、このコマンドは、エンドポイントがゲートウェイにログインするまで待ってから、次のエンドポイントをインストールします。
-C locale_name
Linux および UNIX オペレーティング・システムの場合にのみ、ターゲット・エンドポイントの言語ロケールを指定します。 -C オプションを指定しない場合、言語は lcfd の環境から継承されます。
-d dir_name
エンドポイント・ソフトウェアのインストール先となるターゲット・ディレクトリーを指定します。デフォルト・ロケーションは、UNIX オペレーティング・システムの場合は /opt/Tivoli/lcf ディレクトリーで、Windows オペレーティング・システムの場合は c:¥Program Files¥Tivoli¥lcf ディレクトリーです。 Windows のエンドポイントを Linux または UNIX Tivoli サーバーからインストールする場合は、パス名にスラッシュを入れることができます。
-D Windows オペレーティング・システムの場合は、lcfep プログラムをインストールしないことを指示します。 Windows 端末サーバー環境にインストールする場合、これはデフォルトの振る舞いであり、指定変更することはできません。つまり、lcfep プログラムはこの環境にインストールできません。
-e UNIX オペレーティング・システムの場合のみ、exec の代わりにトラステッド・ホスト・アクセスを使用することを指定します。
-f file_name
エンドポイントをインストールするマシンのリストが入っているファイル名を指定します。ファイルには、1 行当たり 1 つのマシン名が入っている必要があります。 1 行ごとに、マシン名、ユーザー ID、パスワード、ポリシー・リージョン、そしてエンドポイントをインストールするために使用するラベルを入れることができます。次に、行のフォーマットを示します。
host_name user_ID password policy_region endpoint_label
ここで、
host_name
エンドポイントをインストールするマシンのホスト名。
user_ID
インストールを実行するシステム・アドミニストレーターのユーザー ID。
password
user_ID に関連付けられているパスワード。
winstlcf
第 3 章 コマンド (アルファベット順) 277
policy_region
オプション。エンドポイントを移動するポリシー・リージョンの名前です。
注: endpoint_label を指定して、かつエンドポイントがポリシー・リージョンに移動しないようにする場合、policy_region をヌル・ストリング (″″) として指定します。
endpoint_label
オプション。エンドポイントのラベル。
たとえば、次の指定は、ファイル内の 3 つの行に該当します。
red root mstr_Keyorange chris d1n0mite "" orange-epyellow root mstr_Key NYC_PR yellow-ep
-g machine[+port][:machine[+port]]...
インターネット・プロトコル (IP) アドレスあるいはホスト名を指定します。また、オプションで、エンドポイントがログインするゲートウェイのポート番号を指定します。複数のゲートウェイ・エントリーは、コロン (:) で区切る必要があります。ポート番号が 9494 (デフォルト) でない場合は、そのポート番号を指定する必要があります。 -g オプションを省略すると、エンドポイントはすべてのゲートウェイにブロードキャストします。
注: ネットワーク・アドレス変換 (NAT) 環境では、ゲートウェイは、IP アドレスとしてではなく、完全修飾ドメイン・ネームとして指定する必要があります。 NAT 環境にゲートウェイの IP アドレスを直接指定すると失敗します。
-i インストール後の Linux または UNIX エンドポイントに対する自動始動構成をオフにします。デフォルトでは、インストール後に常に Windows のエンドポイントが自動的に開始されるようになっています。
-j エンドポイントをインストールするためにマシンに接続する場合、暗号化されたセキュア・シェル (SSH) 接続が使用されるようにします。
注:
1. Windows ターゲット上にインストールするのに、SSH は使用できません。
2. Windows システムからエンドポイントをインストールするためにこのオプションを使用する場合、トラステッド・ホスト・アクセス方式を使用してください。トラステッド・ホスト・アクセス方式はパスワードを使用しないので、パスワードを必要とする winstlcf オプションと共に -jオプションを使用することはできません。
3. winstlcf コマンドと -j オプションを使用して Windows システムからエンドポイントをインストールするには、Cygwin コマンド・プロンプトを起動して、Cygwin が提供する Perl のバージョンから次のようにwinstlcf コマンドを実行します。
/usr/bin/perl -S winstlcf -j options
詳しくは、「Tivoli Enterprise インストール・ガイド」の SSH に関する章を参照してください。
winstlcf
278 Tivoli Management Framework: リファレンス・マニュアル
-l endpoint_port
エンドポイントのポート番号を指定します。デフォルトのポート番号は9495 です。
-L config_options
エンドポイントを起動するための構成オプションを lcfd コマンドに渡します。複数のオプションを指定する場合や、1 つのオプションのスペースしかない場合は、テキストを二重引用符 (″) で囲む必要があります。有効なオプションのリストについては、lcfd コマンドを参照してください。
-n endpoint_label
ユーザー提供のエンドポイント・ラベルを指定します。
注: -n オプションを省略する場合、エンドポイントのラベルは自動的に生成されます。エンドポイントのポート番号を指定しない場合、ラベルはエンドポイントのホスト名になります。エンドポイントのポート番号を指定する場合 (たとえば、-l オプションを使用して)、エンドポイントのラベルは次のように生成されます。
v Windows オペレーティング・システムでは、ラベルのフォーマットは host-port です。
v Linux と UNIX オペレーティング・システムでは、インスタンス数が 1 より大きければラベルのフォーマットは host-instance です。instance の値は、$LCFROOT/dat/instance ディレクトリーで使用されるインスタンス数と同じです。
-N endpoint
その他のすべての Windows エンドポイントをリモート・インストールするためのプロキシーとして使用する、ドメインまたはトラスト内の既存のWindows エンドポイントを指定します。
注: winstlcf コマンドを使用して Windows エンドポイントをインストールするには、最初に InstallShield イメージを使用して手動でドメインまたはトラストに Windows エンドポイントを 1 つインストールする必要があります。このエンドポイントを、ドメインまたはトラストにすべての追加 Windows エンドポイントをリモート側でインストールするためのプロキシーとして使用します。プロキシー・エンドポイントをインストールした後、winstlcf コマンドと -N オプションを使用して、ドメインまたはトラストにすべての追加 Windows エンドポイントをインストールしてください。このオプションを指定すると、インストールするすべてのエンドポイントが Windows クライアントであると想定されます。 Tivoli リモート実行サービスをインストールする必要はありません。
-P それぞれのマシンごとにパスワードの入力を促すプロンプトを出します。このオプションは、異なるパスワードでリモート・ホストにインストールする場合にのみ役立ちます。各マシンのパスワードが同じである場合、またはこのオプションを使用しない場合、コマンドは、各マシンで使用するためのグローバル・パスワードを入力するよう促します。
-r policy_region
エンドポイントをインストールするポリシー・リージョンを指定します。
winstlcf
第 3 章 コマンド (アルファベット順) 279
-R ユーザーに入力を促すことなく、インストール後に Windows エンドポイントが再始動するよう要求します。 Tivoli 認証パッケージ、TivoliAP.dll をこれまでにエンドポイントにインストールしていない場合、または旧バージョンの Tivoli 認証パッケージを置換しようとする場合のにみ、このオプションが必要となります。
-s dir_name
エンドポイント・インストール・イメージが入っているソース・ディレクトリーを指定します。
-S share_name
宛先共用名を指定します (デフォルト = C$)。
-T account
Windows エンドポイントの Tivoli リモート・アクセス・アカウントを指定します。
-v 冗長インストール情報とエラー・メッセージをリスト表示します。
-x [TCPIP | IPX]
Internetwork Packet Exchange (IPX) エンドポイントの場合のみ使用できます。エンドポイントで使用するプロトコルを指定します。このオプションを指定しないと、エンドポイントは TCP/IP を使用します。サポートされているプロトコルは TCP/IP と IPX です。TCP/IP と IPX の両方を指定するには、オプションを -x=TCPIP、IPX として指定します。ゲートウェイの場合には、TCP/IP プロトコルをオフにできません。
-Y 確認なしでエンドポイントをインストールします。デフォルトでは、このコマンドは、インストールを実行するための処理内容を明示し、その確認を受けてからインストールを開始します。このオプションを使用すると、コマンドはアクションを示し、確認を要求することなくインストールを実行します。
host [user_account password]
エンドポイントのインストール先となるマシンの名前を指定します。ホスト名のみを指定すると、root アカウントか Administrator アカウントのいずれかが使用されます。パスワードの入力を求めるプロンプトが表示されます。3 つのエントリーを単一引用符で囲むことによって、別のユーザー・アカウントとパスワードを指定することができます。たとえば、次のように入力します。
winstlcf ’vernon DOMAIN-NT¥chris d1n0mite’
Windows ドメインとローカル・コンピューターが同じ user_account 名(Administrator など) を使用している場合は、前の例に示すように、アカウントの完全修飾名を指定する必要があります。完全修飾ユーザー・アカウントを指定するときは、引用符が必要です。
権限-N オプションが指定されている場合を除き、Tivoli 許可の役割は不要です。winstlcf コマンドと -N オプションを使用するには、super、senior、またはadmin の役割が必要です。
winstlcf
280 Tivoli Management Framework: リファレンス・マニュアル
例1. 次の例では、vernon という UNIX ワークステーション上にエンドポイント・ソフトウェアがインストールされ、ロケールがフランス語に設定され、エンドポイント・デーモン (lcfd) が起動されます。 winstlcf コマンドは root アカウントを使用し、vernon 上で root パスワードを入力するよう促します。インストール・イメージはデフォルトのディレクトリーに入ります。エンドポイントは、デフォルトの設定で起動されます。
winstlcf -C fr vernon
2. 次の例では、olympus という Windows ワークステーション上にエンドポイント・ソフトウェアがインストールされ、エンドポイント・サービスが起動されます。 winstlcf コマンドは Administrator アカウントを使用し、olympus 上でAdministrator パスワードを入力するよう促します。インストール・イメージは、fuji という Windows のプロキシー (以前にインストールした Windows のドメインにあるエンドポイント) から取られます。ソフトウェアは、olympus コンピューターのデフォルト・ディレクトリーにインストールされます。エンドポイントは、デフォルトの設定で起動されます。
winstlcf -N fuji olympus
3. 次の例では、Windows ワークステーションの、デフォルト・ディレクトリー以外のディレクトリーに、エンドポイントをインストールします。この例では、エンドポイントは、ワークステーション bonnell のドライブ D に、共用名 steve
を使用してインストールされます。宛先ドライブの共用名がデフォルト名 (D:¥
= D$) 以外のインスタンス用に、-d でディレクトリー (D:¥tivoli¥lcf) を指定して、-S で共用名 (steve) を指定しています。
winstlcf -N pctmp107 -d D:¥tivoli¥lcf -S steve bonnell
4. 次の例では、ワークステーション myoung 上にエンドポイント・ソフトウェアがインストールされます。このエンドポイントは、IP アドレス 123.45.1.12 によってその初期ログインを実行します。
winstlcf -g 123.45.1.12 myoung
5. 次の例ではワークステーション bbunny 上にエンドポイントがインストールされ、エンドポイントを起動するときに使用する構成オプションが lcfd コマンドに渡されます。この例では、-g cedar+1616 が、最初のログインでエンドポイントが接触するゲートウェイおよびポートを指定しています。そして-Dlcs.machine_name=bbunny-ep は特定の名前をエンドポイントに割り当てます。
winstlcf -L "-g cedar+1616 ¥-Dlcs.machine_name=bbunny-ep" bbunny
6. 次の例では、マシン cedar と mahogany がエンドポイントとしてインストールされます。インストール・プロセスでは、グローバル root パスワードを入力するよう促されますが、インストール前の確認は求められません。
winstlcf -P -Y cedar mahogany
7. 次の例では、endpt.txt ファイル内の複数のエンドポイントがらインストールされます。インストール・プロセスでは、パスワードの入力やインストールの確認を促されることはありません。ソフトウェアは /usr/lcf ディレクトリーにインストールされます。
winstlcf -f endpt.txt -Y -d /usr/lcf
winstlcf
第 3 章 コマンド (アルファベット順) 281
8. 次の例では、antonella という Windows エンドポイントをコンピューター・システム agodino にインストールします。このとき IPX を使用して NetWare ゲートウェイ lux に接続し、エンドポイント vernon をプロキシーとして使用します。
winstlcf -x IPX -N vernon -g LUX+7787 -n antonella agodino
9. 以下の例は、Windows 管理対象ノードから暗号化された SSH 接続を使用して、マシン oak にエンドポイントをインストールします。
/usr/bin/perl -S winstlcf -j oak
注: winstlcf コマンドと -j オプションを使用して Windows 管理対象ノードからエンドポイントをインストールするには、Cygwin コマンド・プロンプトを起動して、Cygwin が提供する Perl のバージョンから winstlcf コマンドを実行します。
参照lcfd.sh, wdelep
winstlcf
282 Tivoli Management Framework: リファレンス・マニュアル
winterp
指定された管理対象ノードのインタープリター・タイプを表示します。
構文winterp host_name
説明winterp コマンドは、指定された管理対象ノードのインタープリター・タイプを出力します。
オプションhost_name
インタープリター・タイプを表示するホストの名前を指定します。
権限user、admin、senior、super
例次の例は、管理対象ノード bald のインタープリター・タイプを表示します。
winterp bald
solaris2
参照wdate, wdiskspace, whostid, wifconfig, wmannode, wmemsize, wping,
wtimezone, wuname, wxterm
第 3 章 コマンド (アルファベット順) 283
wlcftap
Windows エンドポイント上の Tivoli 認証パッケージ (TAP) のプロパティーを設定する。
構文wlcftap [-a | -d] [-B] [-P] [-r [domain_name¥user_name | user_name]] [-k]
説明wlcftap コマンドは、ローカル・エンドポイントにある Tivoli 認証パッケージTivoliAP.dll のプロパティーを設定します。このファイルを使用すると、Tivoli
Management Frameworkはユーザーのコンテキストでリモート・ファイル・システムにアクセスすることができます。これによって、Windows オペレーティング・システムで setuid メソッドを実行する、つまりそのメソッドに関連するユーザーのコンテキストでメソッドを実行することができます。リモート・ファイル・システムへのアクセスについての詳細は、「Tivoli Management Framework デプロイメントの計画ガイド」を参照してください。
Tivoli リモート・アクセス・アカウントは、ユーザー・アカウントを指定します。Tivoli はこのアカウントを使用して、リモート・ファイル・システムにアクセスします。
オプションを指定せずに wlcftap コマンドを実行すると、現在実行中のTivoliAP.dll からのバージョン情報が出力されます。
初めて Tivoli 認証パッケージを活動化する場合 (通常は Tivoli サーバーのインストール直後)、変更を有効にするにはマシンを再始動しなければなりません。
注: アクティブ・ディレクトリーを使用する Windows 2000 ドメイン環境では、Tivoli 認証パッケージ (TAP) は、アクティブ・ディレクトリーへの接続に無名ログインではなく Tivoli リモート・アクセス・アカウントを使用します。この機能を使用するには、Tivoli リモート・アクセス・アカウントを有効なドメイン修飾ユーザー ID とパスワードに設定する必要があります。
オプション-a Tivoli 認証パッケージ内部キーを設定して、ローカル・セキュリティー権限
(LSA) 付きで TivoliAP.dll を登録します。新しい内部キーが即時に有効になります。 TivoliAP.dll ファイルは、マシンが再始動されるときに LSA によってロードされます。
-B 1 次ドメイン・コントローラー以外のドメイン・コントローラーを使用してドメイン・ユーザーを認証します。 1 次ドメイン・コントローラーを使用してユーザーを認証するには、-P オプションを使用します。
-d Tivoli 認証パッケージ内部キーを削除して、LSA 付きの TivoliAP.dll の登録を抹消します。 TivoliAP.dll ファイルは、マシンが再始動されるときにLSA によってリリースされます (したがって、Tivoli Management
Frameworkがアンインストールされるときにはこのファイルを削除できます)。
284 Tivoli Management Framework: リファレンス・マニュアル
-k user_name のパスワードを標準入力から読み取るよう指定します。このオプションを指定しないと、パスワードの入力を促すプロンプトが出されます。
-P 1 次ドメイン・コントローラーを使用してドメイン・ユーザーを認証します。これがデフォルトの設定です。バックアップ・ドメイン・コントローラーなど、他のドメイン・コントローラーを使用してユーザーを認証するには、-B オプションを使用します。
-r [domain_name¥user_name | user_name]
Tivoli リモート・アクセス・アカウントを、指定されたユーザー名に設定します。 Tivoli は、このユーザー・アカウントを使用してリモート・ファイル・システムにアクセスします。このユーザー名には、スラッシュ (/) と円記号 (¥) のどちらかで区切って、ドメイン・ネームのプレフィックスを付けます。ドメインを指定するときは、そのドメインが Tivoli 認証パッケージを実行しているマシンが属するドメインか、そのドメインによって承認されたドメインでなければなりません。ドメインを指定しないと、Windows はローカル・ドメイン内の所定のユーザーまたは承認されたドメインを探します。 -r ″″ オプションが指定された wlcftap を実行すると、Tivoli からリモート・ファイル・システムへのアクセスが使用不可になります。変更内容が即時に反映されているかを確認するには、オブジェクト・ディスパッチャーを再始動します。
権限wlcftap をオプションを指定しないで実行するには、Administrators グループのメンバー Tivoli admin 許可が必要です。レジストリーの編集には Windows オペレーティング・システム許可が必要です。
例次の例では、Tivoli リモート・アクセス・アカウントが userTME というユーザー・アカウントに設定されます。 wlcftap コマンドは、passwd.txtファイルからアカウント・パスワードを読み取ります。
wlcftap -r userTME -k < passwd.txt
wlcftap
第 3 章 コマンド (アルファベット順) 285
wln
オブジェクトをコレクションにリンクします。
構文wln [-I] label... collection
説明wln コマンドは、指定されたラベルの付いたオブジェクトを、指定されたコレクションにリンクします。label オプションと collection オプションは、完全ラベル・パスか部分ラベル・パスのいずれでも指定できます。
このコマンドを使用してエンドポイントをリンクするには、 wep sync_gatewaysコマンドを実行して、エンドポイント・マネージャー、ゲートウェイ、およびTivoli リージョン内のエンドポイントによって格納されるエンドポイント・データを同期させます。
オプション-I 失敗したすべてのサブオペレーションを無視して、コマンドを続行できるよ
うにします。このオプションは、コマンドに複数のラベルを渡す場合にだけ役立ちます。 -I オプションが指定されると、コマンドは、個々のオブジェクトについてリンク操作が異常終了しても、継続して次のオブジェクトのリンクを実行します。このオプションを指定しないと、個別のオブジェクトのリンク操作が失敗した場合、コマンドは、すでにリンクされているすべてのオブジェクトをリンク解除したあとで、エラー・メッセージを出して終了します。サブオペレーションが失敗すると、デフォルトではコマンドは失敗します。
collection
オブジェクトのリンク先となるコレクションのラベルを指定します。このオプションも、完全ラベル・パス (その先頭は root (/) コレクション)、部分ラベル・パス (現在の作業コレクションに対して相対的な)、単純名 (現在の作業コレクションの中にある) のいずれかにすることができます。リンクされたオブジェクトは、選択したコレクションのメンバーになります。
label オブジェクトのラベルを指定します。このオプションは、完全ラベル・パス( root (/) コレクションで始まるパス)、部分ラベル・パス (現在の作業コレクションに対して相対的な)、単純名 (現在の作業コレクションの中にある)
のいずれかにすることができます。
権限admin、senior、super
例次の例では、wcrtadmin コマンドを使用して新規アドミニストレーターを作成します。次に、wln コマンドを使用して、デフォルトの root デスクトップから、新たに
286 Tivoli Management Framework: リファレンス・マニュアル
作成されたアドミニストレーターのデスクトップ・コレクションに Tivoli サーバーとスケジューラー・オブジェクトをリンクします。
wcrtadmin -a jack -r global,backup:admin:user ¥-r @ceridwen-region,admin:senior:user ¥-r @Administrators,admin:user -r @Scheduler,admin:user ¥-n "Tivoli Administration" -n "Tivoli Authorization" ¥-n "Tivoli Diagnostics" -n "Tivoli Scheduler" -u jack -g staff ¥"Jack Frost"wln /Administrators/Root_ceridwen-region/ceridwen-region ¥/Administrators/"Jack Frost"wln /Administrators/Root_ceridwen-region/Scheduler ¥/Administrators/"Jack Frost"
参照wep, wmv
wln
第 3 章 コマンド (アルファベット順) 287
wlocalhost
ローカル・ホストの名前を Windows レジストリー内に設定します。
構文wlocalhost [host_name]
説明wlocalhost コマンドは、ローカル・ホスト名を Windows レジストリー内に設定します。ホスト名を指定しないと、コマンドは、レジストリーに現在格納されているホスト名を戻します。
オプションhost_name
ローカル・ホスト名を指定します。
権限Administrators グループのメンバー。
288 Tivoli Management Framework: リファレンス・マニュアル
wlocktmr
現行の Tivoli リージョンを保守モードに設定する。
構文wlocktmr -p
wlocktmr -e command_file
説明wlocktmr コマンドは、現在の Tivoli リージョンを保守モードにします。このモードで各種の保守タスクと診断タスクを実行できます。このコマンドを発行すると、即時に、すべてのアクティブな Tivoli プロセスが終了します。
wlocktmr を呼び出す方法は 2 つあります。 1 つは、Tivoli リージョンを永続的に保守モードにするという方法です。これには、-p オプションを使用します。このオプションは、Tivoli リージョンを保守モードにして、そのプロセスを手動で停止するまで休止させます。 保守操作と診断操作は別のウィンドウで実行できます。
wlocktmr を呼び出す他の方法は、単一の保守コマンドを実行するか、バッチ・ファイルまたはスクリプト・ファイルを実行するという方法です。これには、-e オプションを使用します。このオプションは、Tivoli リージョンを保守モードにして、指定されたコマンドまたはファイルを実行した後、保守モードを終了します。
vi コマンド (または任意のテキスト・エディター) を使用して、コマンド・リストを作成します。そのコマンドが実行可能であることを確認するために chmod コマンドを使用します。次に、-e オプションとコマンド・ファイル名を指定してwlocktmr コマンドを実行します。
オプション-e command_file
Tivoli リージョンを保守モードにして、 command_file で指定されたコマンドを実行した後、保守モードを終了します。 command_file には、バッチ・ファイルまたはスクリプト・ファイルの名前を指定できます。
-p Tivoli リージョンを保守モードにして、そのプロセスを手動で停止するまで休止させます。
権限super
第 3 章 コマンド (アルファベット順) 289
wlocpath
ローカライズされたファイルまたはディレクトリーのパスを戻します。
構文wlocpath path [-d default_path] [-l locale] [-o output]
説明wlocpath コマンドは、ローカライズされたファイルまたはディレクトリーを検索して、そのパスを標準出力に出力します。パスが見つからない場合、このコマンドは何も戻しません。
注: これは、tis_get_loc_path() 関数用のコマンド行インターフェース (CLI) です。
wlocpath コマンドは、LANG 環境変数を使用して、現行のローカライズされた環境 (ロケール) に適したメッセージ・カタログを検索します。たとえば、LANG がfr_FR に等しく、NLSPATH が/tivoli/msg_cat/%L/%N.cat;/tivoli/msg_cat/%L%N.cat;/tivoli/msg_cat/C/%N.cat
に等しい場合、wlocpath コマンドは以下のパス名を使用してメッセージ・カタログを探そうとします。
/tivoli/msg_cat/fr_FR/catalog_name.cat/tivoli/msg_cat/fr/catalog_name.cat/tivoli/msg_cat/C/catalog_name.cat
メッセージの検索とバインドが終わったあとで、結果のストリングが標準出力に書き込まれます。
オプション-d default_path
デフォルト・パスを指定します。パス・オプションから有効なパスを取得するためのコマンドが失敗した場合に、このオプションが使用されます。
-l locale
ロケール名を指定します。このオプションを指定しないと、現行の LANG
環境変数の値が使用されます。
-o output
標準出力に書き込まない場合に、使用する出力ファイルの名前を指定します。
path パス・ストリングを入力します。このストリングに %L 変数が含まれていると、その %L はロケール名に置換されます。
権限このコマンドに Tivoli 許可の役割は不要です。
290 Tivoli Management Framework: リファレンス・マニュアル
例次の例では、./msg_cat/%L ディレクトリーで query.txt ファイルを探します。
wlocpath ./msg_cat/%L/query.txt -d/tmp -l fr
結果には、このファイル用の LANG 環境変数が何であるかが表示されます。この変数が見付からなかった場合は、-d オプションによって、/tmp ディレクトリーが検索されます。それでも該当の変数が見付からなかった場合は、-l オプションによって、/fr ディレクトリーが検索されます。
wlocpath
第 3 章 コマンド (アルファベット順) 291
wlookup
Tivoli ネーム・レジストリー内のリソース・インスタンスを検索します。
構文wlookup [-l] -R]
wlookup -a [-L | -o] -r resource_type
wlookup -r resource_type resource_name
wlookup -r resource_type -n instance_name {resource_name | -a}
説明wlookup コマンドは、リソースに関するオブジェクト情報のための Tivoli ネーム・レジストリーを検索します。タイプを指定しない場合、distinguished がデフォルトのリソース・タイプになります。-L または -o のいずれも指定しないと、指定したリソースのオブジェクト ID とラベルが返されます。-l および -R を指定すると、変更されたリソース・タイプのタイム・スタンプがリスト表示されます。
オプション-a ネーム・レジストリー内にある指定したリソース・タイプのインスタンスす
べてを表示します。
-l リソース・タイプを変更した日付のリストを表示します。
-L 指定したリソースのラベルをオブジェクト ID なしで表示します。
-n instance_name
指定された instance の下のネストされたリソースを検索します。
-o 指定したリソースのオブジェクト ID をラベルなしで表示します。
-r resource_type
検索するリソースのリソース・タイプを指定します。省略した場合、distinguished がデフォルトのリソース・タイプになります。
-R 登録されているすべてのリソース・タイプのリストを表示します。
resource_name
登録されているリソースの名前を指定します。
権限user、admin、senior、super
例1. 次の例では、Tivoli ネーム・レジストリー 内の識別されるリソースすべてが検索されます。
wlookup -a
2. 次の例では、登録されているすべてのリソース・タイプのリストが表示されます。
292 Tivoli Management Framework: リファレンス・マニュアル
wlookup -R
3. 次の例では、ポリシー・リージョン・リソース・タイプのすべてのインスタンスが表示されます。
wlookup -r PolicyRegion -a
4. 次の例では、リソース・タイプ (TaskLibrary) の特定のインスタンス (MyTask)
についてオブジェクト情報が表示されます。
wlookup -r TaskLibrary MyTask
5. 次の例では、管理対象ノード vail 上の TaskExecute リソースが表示されます。
wlookup -r ManagedNode -n vail TaskExecute
参照wregister
wlookup
第 3 章 コマンド (アルファベット順) 293
wls
コレクションのメンバー・オブジェクトをリスト表示します。
構文wls [-d] [-l] [-o] [path]
説明wls コマンドは、選択されたコレクションのメンバーを表示します。
オプション-d コレクション・メンバーについてではなく、コレクション自体についての情
報を表示します。
-l 各メンバーのオブジェクト ID とラベルを表示します。
-o 各メンバーのオブジェクト ID を表示します。
path メンバーを表示しようとするコレクション・オブジェクトへのパスを指定します。パスワードの有効なフォーマットは次のとおりです。
v @resource_type:collection_name
v /region/policy_region_name/collection_ name
デフォルト・コレクションは、現在の作業コレクションです。
-l オプションと -o オプションが指定されないと、このコマンドはメンバーのラベルのみを表示します。
権限少なくとも、コレクションがメンバーになっているグループ内の user の役割を持っていることが必要です。
例1. 次の例では、現在の作業コレクションのメンバーが表示されます。
wls
2. 次の例では、Administrators コレクションのメンバーのオブジェクト ID とラベルが表示されます。このコマンドは、デスクトップから削除されたが Tivoli データベースからは削除されていないアドミニストレーター (またはその他のオブジェクト) を識別するときに役立ちます。
wls -l /Administrators
3. 次の例では、アドミニストレーター Jorge のデスクトップ上のオブジェクトが表示されます。
wls @Administrator:jorge
参照wcd, wpwd
294 Tivoli Management Framework: リファレンス・マニュアル
wlsconn
現在の Tivoli リージョン接続または単一の接続に関する情報を表示し、接続プロセスが接続情報の交換を完了していなかったときには、これを完了します。
構文wlsconn [region_name]
wlsconn -u region_name
説明wlsconn コマンドは、現行の Tivoli リージョン接続情報のリストを表示します。このリストには、リージョン番号、ポート、接続モード、リソース、およびそれらのリソースが最後に交換された日時などが含まれます。 -u オプションを指定すると、コマンドは、ローカル・リージョンと、接続しているリモート・リージョンとの間の接続情報の交換を完了します。オプションを指定しないと、コマンドは、ローカル・リージョンとの現在の接続をすべて表示します。
接続しているリージョン間でリソースを交換する場合は、 wlookup -l -R コマンドの出力を wlsconn コマンドの出力と比較すると、どのリソースを更新するかを判別するのに役立ちます。
-u オプションが指定された場合、接続プロセスが接続情報の交換を完了していなかったときには、wlsconn はこれを完了します。確実な手順を用いて、第 1 の側が管理サーバー、第 2 の側が管理対象サーバーである片方向接続を確立するときは、-u オプションを指定してこのコマンドを実行し、接続情報を交換する必要があります。
オプション-u region
Tivoli リージョン名、リモート・サーバー名、およびその他のキャッシュに書き込まれたリージョン間情報を、指定された Tivoli リージョンの最新情報で更新します。
region_name
リモート Tivoli リージョンの名前を指定します。
権限-u オプションを指定する場合は super、指定しない場合は user。
例1. 次の例では、ローカル Tivoli リージョンとの現在の接続をすべて表示します。
wlsconn
MODE NAME SERVER REGION<--> morie-Region morie 3333333333---> amon-sul-Region amon-sul 5555555555<--- ceridwen-Region ceridwen 2222222222
第 3 章 コマンド (アルファベット順) 295
2. 次の例では、ローカル Tivoli リージョンと morie-Region というリモート Tivoli
リージョンの間の接続についての接続情報を表示します。
wlsconn morie-Region
Name: morie-RegionServer:morieRegion:3333333333Mode:two_wayPort:94
Resource Name Last Exchange--------------- ---------------TMF_Notice Fri Jan 09 11:33:10 1998Administrator Fri Jan 02 13:13:15 1998PolicyRegion Tue Jan 13 10:00:38 1998TaskLibrary Tue Nov 04 10:02:34 1997Job Wed Dec 31 19:00:00 1969QueryLibrary Wed Dec 31 19:00:00 1969Query Wed Dec 31 10:00:00 1969ProfileManager Wed Nov 05 17:49:38 1997ManagedNode Tue Jul 07 19:24:34 1998Repeater Thu Sep 04 10:04:32 1997CheckDB Thu Sep 04 20:04:23 1997RemoveNode Thu Sep 04 20:04:23 1997HTTPRealm Tue Nov 04 20:03:22 1997HTTPRealmMakerGroup Thu Sep 04 20:07:22 1997HTTPRealmMaker Thu Sep 04 20:07:23 1997DependencyMgr Thu Sep 04 20:07:23 1997Gateway Wed Dec 31 19:00:00 1969Endpoint Wed Dec 31 19:00:00 1969
3. 次の例では、ローカル Tivoli リージョンと morie-Region というリモート Tivoli
リージョンの間の接続情報を表示します。
wlsconn -u morie-Region
参照wconnect, wdisconn, wlookup, wupdate
wlsconn
296 Tivoli Management Framework: リファレンス・マニュアル
wlsendpts
プロファイル・マネージャーにサブスクライブされているエンドポイントをすべて表示します。
構文wlsendpts [-l] profile_manager
説明wlsendpts コマンドは、指定されたプロファイル・マネージャーに直接的に、または間接的にサブスクライブされているエンドポイントをすべて表示します。リストされるエンドポイントは、第 1 サブスクリプション・レベル (つまり、プロファイル・マネージャー - サブスクライバー) であることも、それより低いサブスクリプション・レベル (プロファイル・マネージャー - プロファイル・マネージャー、またはプロファイル・マネージャー - エンドポイントというような) であることもあります。
オプション-l エンドポイントのオブジェクト ID とラベルを出力します。このオプション
を指定しないと、ラベルのみが出力されます。
profile_manager
プロファイル・マネージャーの名前を指定します。プロファイル・マネージャーの名前にスペースが含まれている場合は、名前全体を引用符で囲んでください。プロファイル・マネージャー名の有効なフォーマットは次のとおりです。
v @profile_manager_name
v @ProfileManager:profile_manager_name
v /Regions/policy_region_name/profile_manager_name
権限user
例次の例では、Admin_PM プロファイル・マネージャーにサブスクライブされているエンドポイントが表示されます。
wlsendpts @ProfileManager:Admin_PM
pepper (ManagedNode)gumby (ManagedNode)
第 3 章 コマンド (アルファベット順) 297
wlsinst
Tivoli リージョンにインストールされている製品とパッチを表示します。
構文wlsinst {-a | -l | -p | -P | -s name | -V} [-i] [-v] [-h]
説明wlsinst コマンドは、Tivoli リージョンにインストールされている製品とパッチのいずれか、または両方を表示します。 -i、-v、または -h オプションを指定すると、製品リストまたはパッチ・リストにホスト情報が含まれます。 -s オプションは指定された製品またはパッチを検索します。
オプション-a Tivoli リージョンにインストールされているすべての製品とパッチを表示し
ます。
-h 製品またはパッチがインストールされているマシンのホスト名とインタープリター・タイプを表示します。
-i インタープリター・タイプ別に出力をソートします。このオプションは、-vまたは -h オプションのいずれかと共に使用する必要があります。
-l パッチされている製品にインストールされたすべてのパッチを表示します。パッチされている製品がまったくないときは、出力はありません。
-p Tivoli リージョンにインストールされているすべての製品を表示します。
-P Tivoli リージョンにインストールされているすべてのパッチを表示します。
-s name
指定された製品またはパッチを表示します。製品またはパッチの名前(name) にスペースが含まれる場合は、製品名またはパッチ名を引用符で囲みます。
-v それぞれの製品またはパッチの各種コンポーネント (たとえば、バイナリー、ライブラリー、マニュアル・ページなど) がインストールされたすべてのホスト名、インタープリター・タイプ、およびディレクトリーを表示します。
-V 各コンポーネントのパス名の最後のスペースをすべてスラッシュに置換して、そのパスを印刷します。
権限super、senior、admin、または user
例1. 次の例では、Tivoli リージョンにインストールされているすべての製品とパッチが表示されます。
298 Tivoli Management Framework: リファレンス・マニュアル
wlsinst -a
*---------------------------------------------------*Product List
*---------------------------------------------------*Tivoli Management PlatformTivoli/Admin 2.5*---------------------------------------------------*
Patch List*---------------------------------------------------*Tivoli Management Platform 3.0 Patch 3.0-TMP-0005Tivoli Management Platform 3.0 Service Pack 01
2. 次の例では、Tivoli リージョンにインストールされている製品のみが表示されます。
wlsinst -p
*---------------------------------------------------*Product List
*---------------------------------------------------*Tivoli Management PlatformTivoli/Admin 2.5
3. 次の例では、インストールされた製品、製品がインストールされたホスト名とインタープリター・タイプ、および製品がインストールされたディレクトリーが表示されます。
wlsinst -p -v
*---------------------------------------------------*Product List
*---------------------------------------------------*Tivoli Management Platform
ida solaris2ALIDB /var/spool/Tivoli ida.dbAPPD /usr/lib/X11/app-defaultsBIN /usr/local/Tivoli/bin solaris2BIN /usr/local/Tivoli/bin solaris2BUN /usr/local/Tivoli/bin client_bundleCAT /usr/local/Tivoli/msg_catCONTRIB /usr/local/Tivoli/bin solaris2/contribGBIN /usr/local/Tivoli/bin generic_unixLIB /usr/local/Tivoli/lib solaris2
tornado solaris2APPD /usr/lib/X11/app-defaultsBIN /usr/local/Tivoli/bin solaris2CAT /usr/local/Tivoli/msg_catCONTRIB /usr/local/Tivoli/bin solaris2/contribDB /var/spool/Tivoli tornado.dbGBIN /usr/local/Tivoli/bin generic_unixLIB /usr/local/Tivoli/lib solaris2
wlsinst
第 3 章 コマンド (アルファベット順) 299
wlsnotif
アドミニストレーターの掲示板上の通知を表示します。
構文wlsnotif
wlsnotif -g
wlsnotif -l [-n notice_group]
説明wlsnotif コマンドは、アドミニストレーターの掲示板上の通知をリストします。 -gオプションは、すべての通知グループをリストします。 -l オプションは、メッセージ全体ではなく、通知のヘッダーのみをリストします。 -n オプションは、指定された通知グループから通知をリストします。 -n を指定しないと、すべての通知グループからの通知がリストされます。オプションを何も指定しないと、すべての通知グループのすべての通知がリストされます。このコマンドは、アドミニストレーターがサブスクライブされている通知グループのサブセットに通知グループを制限します。いずれの場合も、このコマンドの出力は、標準出力に書き込まれます。
オプション-g 1 行ごとに 1 つずつ、有効な通知グループを表示します。このオプション
を指定すると、その他のオプションは無効になります。
-l アドミニストレーターの掲示板上の通知のヘッダーを出力します。このオプションが指定されないと、このコマンドは、実際の通知を出力します。出力は 40 文字で切り捨てられます。
-n notice_group
表示する通知の作成元の通知グループ、または表示する特定の通知を指定します。このオプションが指定されないと、このコマンドは、すべての通知グループの通知を表示します。
権限user、admin、senior、super
例1. 次の例では、すべての通知グループのすべての通知が表示されます。この出力はきわめて長いものになることがあるので、ファイルにリダイレクトしてください。
#wlsnotif
Date: Mon Nov 21 10:29:12 1994Notice-Group-Name: Tivoli AdministrationPriority: NoticeSent-By-Administrator: root@bald
300 Tivoli Management Framework: リファレンス・マニュアル
A new IP interface was added on bald by [email protected]: le1address: 146.84.49.3name: bald2
2. 次の例では、アドミニストレーターがサブスクライブされているすべての通知グループが表示されます。
wlsnotif -g
Tivoli AdministrationTivoli AuthorizationTivoli DiagnosticsTivoli Scheduler
3. 次の例では、アドミニストレーターのすべてのメッセージのヘッダーが表示されます。
wlsnotif -l
11/21/01 10:29:12 CST A new IP interface was added on bald by11/21/01 10:30:25 CST An IP interface was deleted from bald by11/21/01 10:34:32 CST Deleted Objects11/21/01 10:37:08 CST A new task, date_task, was created by ro11/21/01 10:39:35 CST The task, date_task, of the my_tasks tas11/21/01 10:49:33 CST The task, date_task2, of the my_tasks ta11/21/01 10:50:45 CST The task, date_task2, of the my_tasks ta11/21/01 10:55:52 CST A new task, find_cores, was created by r
参照wexpnotif, wsndnotif, wtailnotif
wlsnotif
第 3 章 コマンド (アルファベット順) 301
wlspol
Tivoli 管理リソース・タイプの使用可能なポリシー・デフォルト・オブジェクトおよびポリシー検証オブジェクトをリスト表示します。
構文wlspol [-d] resource
wlspol -v resource
説明wlspol コマンドは、指定された管理対象リソース・タイプのポリシー・デフォルト・オブジェクトとポリシー検証オブジェクトの名前を表示します。
オプション-d 指定された管理リソース・タイプのポリシー・デフォルト・オブジェクトの
ラベルを表示します。ポリシー・デフォルト・オブジェクトは、ポリシー・リージョン内に作成されたリソースのデフォルト属性値を生成します。 -vオプションを指定しない場合、このアクションがデフォルトになります。
-v 指定された管理リソース・タイプのポリシー検査オブジェクトのラベルを表示します。ポリシー検証オブジェクトは、管理対象リソースの属性値を検証します。
resource
ポリシー・デフォルト・オブジェクトまたはポリシー検証オブジェクトを表示したい管理対象リソース・タイプを指定します。
権限senior、super
例次の例では、ProfileManager 管理リソース・タイプのすべてのポリシー検証オブジェクトが表示されます。
wlspol -v ProfileManager
参照wchkpol, wcrtpol, wcrtpr, wdelpol, wdelpr, wgetdfpol, wgetpolm, wlspolm,
wputpolm
302 Tivoli Management Framework: リファレンス・マニュアル
wlspolm
Tivoli 管理リソース・タイプのポリシー・メソッド、もしくはプロファイルの属性名をリストします。
構文wlspolm [-d | -v] class
wlspolm [-d | -v] profile
説明wlspolm コマンドに class オプションを指定した場合は、指定された管理対象リソース・タイプに割り当てられたポリシー・メソッド名をリストします。wlspolm コマンドで profile オプションを指定すると、指定されたプロファイルの属性名 (関連付けられたポリシーをもつことができるプロパティー) がリストされます。最終オプションには、ポリシー・メソッドをサポートする管理対象リソース・タイプ (たとえば、ホスト、ネットワーク情報サービス (NIS) ドメイン、ファイル・パッケージなど) またはプロファイルを指定できます。
このコマンドで表示された名前は、wgetpolm コマンドと wputpolm コマンドに対する入力に使用できます。
-d オプションではデフォルト・ポリシー (default) がリスト表示され、-v オプションでは検証ポリシーがリスト表示されます。特定の Tivoli アプリケーション用のデフォルト・ポリシーおよび検証ポリシーを設定する方法は、特定の Tivoli のアプリケーションの資料を参照してください。
オプション-d デフォルト・ポリシー・メソッドを表示します。 -v オプションを指定しな
い場合、このアクションがデフォルトになります。
-v 検証ポリシー・メソッドを表示します。
class ポリシー・メソッドをリスト表示する管理対象リソース・タイプを指定します。
profile 属性名をリスト表示するプロファイルを指定します。
権限senior または super
例1. プロファイルを使用しない場合、次の例では、ProfileManager ポリシー検証オブジェクトに関するすべてのポリシー・メソッドのリストを表示します。
wlspolm -v ProfileManager
pm_val_remove_subscriberspm_val_remove_subscriptionpm_val_subscriberspm_val_subscription
第 3 章 コマンド (アルファベット順) 303
2. プロファイルを使用する場合、次の例では、Engineering という名前の電話番号リスト・プロファイル用の関連ポリシーを持っている可能性があるプロパティーのリストを表示します。
wlspolm -d @PhoneListProfile:Engineering
namephoneaddresscitystatecountrypostalownertypecomment
参照wchkpol, wcrtpol, wcrtpr, wdelpol, wdelpr, wgetdfpol, wlspol, wputpolm
wlspolm
304 Tivoli Management Framework: リファレンス・マニュアル
wlssub
オブジェクトがサブスクライブするプロファイル・マネージャーをリストします。
構文wlssub -l [-o] name
説明wlssub コマンドは、オブジェクトのサブスクライブ先のプロファイル・マネージャーをリストします。これらのオブジェクトとは、管理対象ノード、ネットワーク情報サービス (NIS) ドメイン、エンドポイント、プロファイル・マネージャーなどです。
オプション-l 詳細表示を指定します。
-o オブジェクトのサブスクリプション先である個々のプロファイル・マネージャーのオブジェクト ID をリスト表示します。このオブジェクトには、管理対象ノード、NIS ドメイン、エンドポイント、またはプロファイル・マネージャーが含まれます。
name サブスクリプションをリスト表示するオブジェクトの名前を指定します。このオプションの有効なフォーマットは次のとおりです。
v @domain_name
v @NisDomain:domain_name
v /Regions/policy_region_name/domain_name
権限user、admin、senior、super
例次の例では、管理対象ノード cook のサブスクライブ先であるすべてのプロファイル・マネージャーが表示されます。
wlssub @ManagedNode:cook
参照wcrtpr, wcrtprfmgr, wdistrib, wgetprf, wgetsub, 336ページの『wpopulate』,
wsub, wvalidate
第 3 章 コマンド (アルファベット順) 305
wlstlib
タスク・ライブラリーの内容を表示します。
構文wlstlib library_name
説明wlstlib コマンドは、指定されたタスク・ライブラリーに含まれているジョブおよびタスクをリストします。
オプションlibrary_name
タスク・ライブラリーの名前を指定します。
権限user、senior、super
例次の例では、queue_lib タスク・ライブラリーの内容が表示されます。
wlstlib queue_lib
Clean Queue (task)Clean Queue (job)
参照wcrttlib
306 Tivoli Management Framework: リファレンス・マニュアル
wmailhost
Windows オペレーティング・システムで Tivoli Management Framework が使用するメール・サーバーを指定します。
構文wmailhost [?][host_name]
説明wmailhost コマンドは、Tivoli 環境の Windows オペレーティング・システムにSimple Mail Transfer Protocol (SMTP) 接続を提供します。任意の Windows Tivoli
サーバーまたは管理対象ノードで、このコマンドを発行してください。電子メールを生成する Tivoli ツールは、このコマンドに指定したメール・サーバーに、電子メールを送信します。 host_name オプションを指定しないと、コマンドは現行で指定されたメール・サーバーを戻します。
メール・サーバーは、SMTP サーバー、または SMTP ゲートウェイにより接続されるサーバーでなければなりません。たとえば、ネットワーク・メール・サーバーがMicrosoft Exchange または Lotus Notes がインストールされている Windows 2000
コンピューターの場合、SMTP ゲートウェイ・ソフトウェアをそのコンピューターにインストールする必要があります。 SMTP 電子メール用の構成に関する詳細は、「Tivoli Enterprise インストール・ガイド」を参照してください。
オプション? 使用法ステートメントを出力します。
host_name
メール・サーバーのホスト名を指定します。
例次の例では、メール・サーバーがホスト loki に設定されます。
wmailhost loki
第 3 章 コマンド (アルファベット順) 307
wmannode
管理対象ノードに関するシステム情報を戻します。
構文wmannode node_name
説明wmannode コマンドは、Tivoli リージョンの管理対象ノードに関するシステム情報を戻します。このコマンドを発行する時は、管理対象ノードが使用可能でなくてはなりません。
オプションnode_name
管理対象ノードの名前を指定します。
権限user、admin、senior、super
例次の例では、管理対象ノード yankee のシステム情報を表示します。
wmannode yankee
System Name : yankeeInterpreter : solaris2Install Directory : /usr/local/TivoliHost ID : 945bd30System Architecture : sun4mMemory Size (MB) : 48System Timezone : 360OS Name : SunOSOS Release : 5.3OS Version : Generic_101318-21
参照wdiskspace, whostid, wident, winstdir, winterp, wmemsize, wtimezone
308 Tivoli Management Framework: リファレンス・マニュアル
wmcast
MDist 2 マルチキャスト配布のためのリピーターを構成します。
構文wmcast -s {default | repeater_name} [keyword=value...]
wmcast -p {all | repeater_name}
説明wmcast コマンドは、MDist 2 マルチキャスト配布のためのリピーター・プロパティーを設定します。提供されているデフォルトは、ほとんどの LAN 環境で使用できるよう設計されています。ただし、マルチキャストを高速および低速両方のリンク上で使用する場合、最も速度の遅いリンクに合わせてマルチキャスト・リピーターを構成してください。
オプション-p 指定したゲートウェイ・リピーターに接続しているそれぞれのエンドポイン
トにマルチキャスト ping を送信します。
-s 以下のキーワードおよび値を 1 つ以上使用して、リピーターを構成します。 value を指定しないと、指定したリピーターの既存のオプションが表示されます。
all デフォルト設定を含め、すべてのリピーターを指定します。
default新規リピーター用のデフォルト設定を指定します。
repeater_name
リピーターのラベルまたはオブジェクト ID を指定します。
keyword=value
キーワードと値は次のとおりです。
backofftm=time_in_milliseconds
バック・オフ時間をミリ秒単位で指定します。受信者はマルチキャスト通知の受信を確認すると、送信側に応答するまで、 0 ミリ秒からこのキーワードで指定したミリ秒までの無作為の時間間隔で待機します。これは輻輳を軽減します。さらに多くの受信者を追加するにしたがって、パフォーマンスの改善のためにこの数を増やす必要があるかもしれません。デフォルトは 100 です。
blocksize=size_in_bytes
送信側がデータをネットワークに書き込む際に使用するブロックのサイズをバイト単位で指定します。指定するサイズは 65535 バイト未満である必要があります。デフォルトは 1460 バイトです。これはイーサネット通信における最大伝送単位 (MTU) です。
connrty=retry_count
マルチキャスト送信側が接続メッセージを受信者に再ブロードキャストする回数を指定します。デフォルトは 5 です。
第 3 章 コマンド (アルファベット順) 309
connwtout=milliseconds
マルチキャスト送信側が、受信者が接続を受け入れるまで待機する時間をミリ秒単位で指定します。デフォルトは 2000 です。
dtrtry=retry_count
マルチキャスト送信側が、ドロップされたパケットを受信者に再送信する回数を指定します。デフォルトは 10 です。
dtwtout=time_in_milliseconds
データ伝送が中断された場合、受信者がタイムアウトまで待機する時間をミリ秒単位で指定します。デフォルトは 3000 です。
ifrcvaddr=address...
マルチキャスト・パケットを listen する際に受信者が使用する IP
アドレスのリストを指定します。マルチアドレスをセミコロン (;)
で分けて、二重引用符 (″) で囲みます。アドレスを指定しない場合、デフォルトは 0.0.0.0 です。
ifsrcaddr=address
マルチキャスト・パケットの送信に使用するソース・ホスト・インターフェースの IP アドレスを指定します。デフォルトは 0.0.0.0
です。
mcadvert=address
マルチキャスト・メッセージのためのアドレスを指定します。mcadvert をデフォルト以外に設定すると、マルチキャスト通知用の別のアドレスを listen するようエンドポイントを変更する必要があります。デフォルトは 224.0.1.118 です。これは、Tivoli マルチキャスト配布用の IANA 登録のアドレスです。
mchigh=highest_address
マルチキャスト・データの送信に使用する最も高いアドレスを指定します。サーバーはマルチキャスト・データを送信できる状態になると、マルチキャスト・データ・トラフィックに使用可能なアドレスを検出するために、 mclow および mchigh 間で 1 つのアドレスを選択します。チェックした最初のアドレスがマルチキャスト・データの送信に使用されている場合、アドレスは増分されてその次のアドレスをアクティビティー用にモニターします。これは使用可能なアドレスまたは mchigh に達するまで続けられます。デフォルトは 224.2.255.255 です。
mclow=lowest_address
マルチキャスト・データの送信に使用する最も低いアドレスを指定します。サーバーはマルチキャスト・データを送信できる状態になると、マルチキャスト・データ・トラフィックに使用可能なアドレスを検出するために、 mclow および mchigh 間で 1 つのアドレスを選択します。チェックした最初のアドレスがマルチキャスト・データの送信に使用されている場合、アドレスは増分されてその次のアドレスをアクティビティー用にモニターします。これは使用可能なアドレスまたは mchigh に達するまで続けられます。デフォルトは 224.2.128.0 です。
wmcast
310 Tivoli Management Framework: リファレンス・マニュアル
mc_netload=bytes_per_second
このリピーターが使用できるネットワーク帯域幅の最大量を 1 秒あたりのバイト数で指定します。デフォルトは 500000 です。
mc_debug_level=trace_level
トレース・レベルを指定します。
0 トレース情報を記録しない
1 例外のみ記録する
2 一般トレース情報を記録する
3 すべてのインプリメントされたトレースを記録する
トレース・レベルは増分的です。トレース・ログは、それぞれのリピーター上で $DBDIR¥mcast.log にローカルに書き込まれます。デフォルトは、1 です。
pollrtry=retry_count
マルチキャスト受信側が、最終状況を決定するよう受信者にポーリングする回数の最大数を指定します。デフォルトは 5 です。
port=port_number
マルチキャスト通知およびマルチキャスト・データに使用するポートの番号を指定します。デフォルトは 9499 です。
rcvbufsz=size_in_bytes
UDP ソケットの受信バッファーのサイズをバイト単位で指定します。デフォルトは 250000 です。
relrty=retry_count
マルチキャスト受信側が、接続または解放メッセージを受信者にブロードキャストする回数を指定します。デフォルトは 5 です。
relwtout=time_in_milliseconds
全データ転送後に、受信者が接続を解放するまで送信側が待機する時間をミリ秒単位で指定します。デフォルトは 2000 です。
repeat=count
サーバーが同じコントロール・パケットを送信する回数を指定します。パケット・ドロップがパフォーマンスに影響する場合、この回数を増やすことができます。デフォルトは 2 です。
returnIP=address
受信者が通信するサーバーの IP アドレスを指定します。たとえば、サテライト構成においてサーバーから受信者へのトラフィックはサテライト・リンクであり、受信者からサーバーへのトラフィックは一般に電話回線です。つまり、戻り IP アドレスは、ソースのIP アドレスとは異なります。デフォルトは 0.0.0.0 です。
sndbufsz=size_in_bytes
UDP ソケットの送信バッファーのサイズをバイト単位で指定します。デフォルトは 250000 です。
ttl=count
存続時間整数を指定します。この整数は、ルーターを通してパケッ
wmcast
第 3 章 コマンド (アルファベット順) 311
トを転送できる回数を指定します。パケットがルーターを通過すると、この整数は減分されます。整数が 0 になると、パケットをドロップします。マルチキャスト送信側と受信者間のルーター数より大きい数を指定します。デフォルトは 5 です。
権限senior、super
参照wdepot, wmdist, wrpt
wmcast
312 Tivoli Management Framework: リファレンス・マニュアル
wmdistリピーターを構成して、MDist 2 配布を管理します。
構文wmdist [-f] [-A] -B repeater_name
wmdist [-f] -c dist_id | endpoint_id [endpoint_id...]
wmdist [-f] [-h] -d dist_id [dist_id...]
wmdist -D [debug_level]
wmdist -e dist_id [-t ep_label] [-n node_type] [state...]
wmdist -I repeater_name
wmdist -j depot_directory...
wmdist -k depot_directory...
wmdist -l [-a] [-idist_id] [-v]
wmdist -m dist_id [-t ep_label] [-n node_type] [state...]
wmdist -M [TRUE | FALSE]
wmdist -N [TRUE | FALSE]
wmdist [-f] -p dist_id | endpoint_id [endpoint_id...]
wmdist -q dist_id
wmdist [-f] -r dist_id | endpoint_id [endpoint_id...]
wmdist -R [rim_object]
wmdist -s repeater_name [-C noprompt | nostart | nostop] [keyword=value...]
wmdist -T [database_purge_interval]
説明wmdist コマンドは、リピーターを構成して、MDist 2 配布を管理します。 MDist
サービスを使用するリピーターを構成する場合には、 wrpt コマンドを参照してください。 RDBMS Interface Module (RIM) オブジェクトを構成していなければ、使用できるオプションは -s と -I だけです。 MDist 2 とそのサービスの詳細については、「Tivoli Management Framework ユーザーズ・ガイド」を参照してください。
オプション-A デポからすべての項目を削除します。デポを削除する前に、キューを削除す
る必要があるので、-A オプションは必ず -B オプションと共に使用する必
第 3 章 コマンド (アルファベット順) 313
要があります。このコマンドは、Tivoli サービス・プロバイダーからの要請があった場合のみ、使用してください。
-B repeater_name
キューからすべての項目を削除します。このコマンドは、次のような非常事態のときに使用できます。
v ゲートウェイが始動しないか破損していて、再始動できない場合。
v -I オプション付きの wmdist コマンドを発行し、アクティブではない配布からリピーター・キュー内のデータ・セグメントを監視した場合。
リピーターのキューから項目を削除するときには、状況データベースは更新されません。このコマンドは、サポート・プロバイダーからの要請があった場合のみ、使用してください。
-c dist_id | endpoint_id [endpoint_id...]
dist_id で指定されたアクティブ配布を取り消すか、もしくは endpoint_id で指定されたターゲットによる 1 つ以上のアクティブ配布を取り消します。
-d dist_id [dist_id...]
MDist 2 データベースから 1 つ以上の配布を削除します。削除する配布は、dist_id で指定します。
-D [debug_level]
配布マネージャーがログ・ファイル $DBDIR/distmgr.log に書き込むログ・メッセージのレベルを変更します。 debug_level オプションは、0 (最小の情報) ~ 9 (最大の情報) までの値を指定します。デフォルトは 0 です。このファイルのサイズは、不要なデータを削除して、ログ記録された情報の量を管理するまで大きくなり続けます。値を指定しないでこのコマンドを発行すると、現行値が表示されます。
-e dist_id [-t ep_label] [-n node_type] [state...]
配布に関するエンドポイントの状況をリスト表示します。サブオプションは次のとおりです。
-n node_type
出力をフィルターにかけて、リピーターまたはエンドポイントのみを表示します。
-t ep_label
配布のエンドポイントを指定します。エンドポイントを指定すると、wmdist コマンドではそれらのエンドポイントの状況のみがリスト表示されます。指定しなければ、すべてのエンドポイントの状況がリスト表示されます。
state 指定した状態のノード (エンドポイントおよびリピーター) の状態をリスト表示します。指定しないと、wmdist コマンドでは、すべてのノードの状態がリスト表示されます。サポートされる状態は、次のとおりです。v CANCELED
v EXPIRED
v FAILED
v INTERRUPTED
v PAUSED
wmdist
314 Tivoli Management Framework: リファレンス・マニュアル
v RECEIVING
v REJECTED
v SENDING
v STORED
v SUCCESSFUL
v UNAVAILABLE
v WAITING
-f 操作を強制し、確認のプロンプトを抑制します。
-h 完了していない配布を、データベースから強制的に除去します。
-I repeater_name
リピーターが現在処理している配布についての詳細な情報の表示が可能になります。
-j depot_directory...
1 つ以上の代替デポ・ディレクトリーを追加します。
-k depot_directory...
1 つ以上の代替デポ・ディレクトリーを除去します。
-l [-i dist_id] [-a] [-v]
配布の状況をリスト表示します。オプションは次のとおりです。
-a アクティブな配布のみを戻します。
-i dist_id
配布 ID を指定します。配布 ID を指定しないと、コマンドはすべての配布の状況を戻します。
-v 状況についてのすべての情報を戻します。 -v オプションを指定しないと、コマンドはキーワード値情報のみを戻します。
-m dist_id [-t ep_label] [-n node_type] [state...]
配布に関するメッセージをリストします。サブオプションの説明については、-e オプションを参照してください。
-M [TRUE | FALSE]
アクティブな MDist 2 配布が、別のゲートウェイにマイグレーションするエンドポイントにアクセス可能かどうかをコントロールします。マイグレーションするエンドポイントで配布へアクセスできるようにするには TRUE
を、そうでない場合は FALSE を指定します。オプションを指定しない場合、現在の設定が表示されます。
-N [TRUE | FALSE]
データベース接続を検証する前に配布マネージャーに配布を開始させるかどうかをコントロールします。接続は、配布を登録するために必要なので、配布状況コンソールを使用して配布をコントロールできます。オプションを提供しない場合、現行の設定が表示されます。サポートされる値は次のとおりです。
FALSE 配布マネージャーは、配布を開始する前にデータベース接続を検証しません。アプリケーション固有の設定により、この設定を指定変更することができます。これはデフォルト値です。
wmdist
第 3 章 コマンド (アルファベット順) 315
TRUE 配布マネージャーは、配布を開始する前にデータベース接続を検証します。アプリケーション固有の設定により、この設定を指定変更することができます。
-p dist_id | endpoint_id [endpoint_id...]
dist_id で指定されたアクティブ配布を休止するか、もしくは endpoint_id で指定されたターゲットによる 1 つ以上のアクティブ配布を休止します。
-q dist_id
経路を示すインデント形式で、特定の配布に関連したノードを表示します。表示される各ノードには、その状態を示すサフィックスが付きます。
-r dist_id | endpoint_id [endpoint_id...]
dist_id で指定された休止状態の配布を再開するか、もしくは endpoint_id で指定されたターゲットによる 1 つ以上の休止状態の配布を再開します。
-R [rim_object]
配布マネージャーで使用される RIM オブジェクトをユーザーが変更して状況を保管できるようにします。デフォルト値は mdist2 です。値を指定しないでこのコマンドを発行すると、現行値が表示されます。
-s [-C [noprompt | nostart | nostop] repeater_name [keyword=value...]
後続のキーワードおよび値を 1 つ以上使用して、(repeater_name で指定する) リピーターを構成します。 value を指定しないと、指定したリピーターの既存のオプションが表示されます。キーワード値ペアがリスト表示されていない場合は、コマンドから、現在使用中の構成が戻されます。
-C noprompt | nostart | nostop
ゲートウェイ・リピーターがエンドポイントでマルチキャスト受信側を起動および停止する方法を指定します。値は次のとおりです。
noprompt
リピーターは、確認を求めることなくマルチキャスト受信側を開始するメッセージを送信します。ゲートウェイに割り当てられたエンドポイントの数によっては、すべてのエンドポイントでマルチキャスト受信側を開始するのに時間がかかることがあります。このオプションは、endpoint_multicast=TRUE の場合に使用できます。
nostart
リピーターは、エンドポイントでマルチキャスト受信側を開始するメッセージを送信しません。このオプションは、endpoint_multicast=TRUE の場合に使用できます。
nostop
リピーターは、エンドポイントでマルチキャスト受信側を停止するシャットダウン・メッセージを送信しません。それぞれのエンドポイントのマルチキャスト受信側は実行したままです。このオプションは、endpoint_multicast=FALSE の場合に使用できます。
注: -C オプションを使用できるのは、 endpoint_multicast キーワードと一緒の場合のみです。他のキーワードと一緒に指定すると、このオプションは無視されます。
wmdist
316 Tivoli Management Framework: リファレンス・マニュアル
repeater_name
ラベル、リピーターのオブジェクト ID、または次のオプションのいずれかを指定します。
all デフォルト設定を含め、すべてのリピーターを指定します。
default新規リピーター用のデフォルト設定を指定します。
keyword=value
キーワードと値は次のとおりです。
conn_retry_interval=seconds
使用不可または中断状態になっているターゲットを再試行する頻度を (秒で) 指定します。
debug_level=number
管理対象ノード・リピーター ($DBDIR/rpt2log) 用のログ・ファイルに、どのメッセージを書き込むかをコントロールします。ゲートウェイ・リピーター用のログは、debug_levelオプション付きの wgateway debug_level コマンドでコントロールします。
default_multicast=TRUE | FALSE
マルチキャストをすべての MDist 2 配布のためのデフォルト・モードにするかどうかを指定します。この配布モードをTivoli アプリケーションによりオーバーライドすることができます。 TRUE を指定すると、使用可能になります。 FALSE
を指定すると、使用不可になります。デフォルトは FALSE
です。
disk_max=max_size_MB
リピーターのデポに割り振るディスク・スペースの量を指定します。単位はメガバイト (MB) です。 disk_max の数値がゼロの場合は、サイズは無制限になります。ディスクのサイズより大きい数値は指定できません。リピーターを通過するすべての配布 wmdist 288 は、一時的にではあっても、デポに格納されます。デポは、配布を予定している最大配布量を保持できる大きさにしておく必要があります。
注: 新しい値が古い値より大きい場合、リピーターを再始動するまで変更は有効になりません。
endpoint_multicast=TRUE | FALSE
アプリケーションがマルチキャスト配布を送信する場合、パッケージをエンドポイントに配布する際にゲートウェイがマルチキャストを使用するかどうかを指定します。マルチキャストを使用する場合、TRUE を指定します。マルチキャストを使用不可にしてユニキャストを使用する場合は、FALSE を指定します。ゲートウェイは、自身のエンドポイントにのみマルチキャストできます。このキーワードは、ゲートウェイ・リピーターにのみ有効です。デフォルトは FALSE です。
wmdist
第 3 章 コマンド (アルファベット順) 317
注:
v キーワードは、-C オプションと組み合わせて使用することができます。
v このキーワードを TRUE に設定するには、 Java 1.3
for Tivoli および Tivoli Java クライアント・フレームワークをこのリピーターにインストールする必要があります。
execute_timeout=seconds
エンドポイント・メソッドが配布データからデータをすべて受信したあとで結果を戻すまでの時間を (秒単位で) 指定します。アプリケーションによっては、データを受信したあとで、結果をリピーターに戻す前に、スクリプトを実行するものがあります。
fail_unavailable=TRUE | FALSE
ゲートウェイに、配布の受信に失敗したエンドポイントにパッケージを再配布させるかどうかを指定します。配布の受信に失敗したエンドポイントにパッケージを再配布するためには、FALSE を指定します。再試行不可にするには TRUE を指定します。このキーワードは、ゲートウェイ・リピーターにのみ適用されます。アプリケーション固有の設定により、この設定が指定変更されます。デフォルトは FALSE です。
注: オリジナルの配布がマルチキャストかユニキャストかに関係なく、再試行にはユニキャストが使用されます。
max_sessions_high=number
リピーターが高優先度の配布用にオープンする同時接続の最大数を指定します。これらの接続は、すべてのアクティブな配布間で共用されます。リピーターは、高優先度の接続をすべて使い尽くすと、中優先度の接続を使用します。
注: 新しい値が古い値より大きい場合、リピーターを再始動するまで変更は有効になりません。
max_sessions_low=number
リピーターが低優先度の配布用にオープンする同時接続の最大数を指定します。この数値は、1 以上でなければなりません。これらの接続は、すべてのアクティブな配布間で共用されます。リピーターは、低優先度の接続をすべて使い尽くすと、オープン中の接続が完了するまで待ってから、次の接続をオープンします。
注: 新しい値が古い値より大きい場合、リピーターを再始動するまで変更は有効になりません。
max_sessions_medium=number
リピーターが中優先度の配布用にオープンする同時接続の最大数を指定します。これらの接続は、すべてのアクティブな配布間で共用されます。リピーターは、中優先度の接続をすべて使い尽くすと、低優先度の接続を使用します。
wmdist
318 Tivoli Management Framework: リファレンス・マニュアル
注: 新しい値が古い値より大きい場合、リピーターを再始動するまで変更は有効になりません。
mem_max=max_size_MB
ターゲットに送信されるバッファー・データに使用するメモリーの量を (MB 単位で) 指定します。これによって、デポへのディスク・アクセスの回数が減り、パフォーマンスが向上します。このメモリーは、すべてのアクティブな配布の間で共用されます。
注: 新しい値が古い値より大きい場合、リピーターを再始動するまで変更は有効になりません。
net_load=KB_per_second
このリピーターが使用できるネットワーク帯域幅の最大量を(1 秒あたりのキロバイト数で) 指定します。 slow_link をTRUE に設定すると、ネットワーク帯域幅を 1 秒当りのバイト数で測ります。この割り振りは、すべてのアクティブな配布の間で共用されます。このオプションは、target_netloadと共に使用します。
notify_interval=minutes
状況報告の頻度を (分単位で) 指定します。 notify_intervalが経過した場合、またはすべてのターゲット上で配布が終了した場合は、結果がフラッシュされます。結果は MDist 2
を使用してアプリケーションに送られ、MDist 2 データベースに更新されます。
packet_size=number_KB
1 回の送信要求でネットワークに書き込むキロバイト数を指定します。 slow_link を TRUE に設定すると、1 回の送信要求でネットワークに書き込むバイト数を指定します。
permanent_storage=TRUE | FALSE
リピーターをデポとして構成します。 TRUE を指定すると、永続記憶域用にマークされたセグメントが、配布完了後にそのデポに保存されます。 FALSE を指定すると、セグメントは配布完了後にそのデポから削除されます。
repeater_multicast=TRUE | FALSE
アプリケーションがマルチキャスト配布を送信する場合、パッケージを他のリピーターに配布する際にゲートウェイがマルチキャストを使用するかどうかを指定します。マルチキャストを使用する場合、TRUE を指定します。ユニキャストを使用する場合は、FALSE を指定します。デフォルトは FALSE
です。
注: このキーワードを TRUE に設定するには、 Java 1.3 for
Tivoli および Tivoli Java クライアント・フレームワークをこのリピーターにインストールする必要があります。
wmdist
第 3 章 コマンド (アルファベット順) 319
retry_ep_cutoff=seconds
使用不可または中断状態になっているエンドポイントの再試行を継続する時間 (秒数) を指定します。使用不可または中断状態になっているリピーターに対する再試行は、配布期限に達するまで続きます。
rpt_dir=path_name
¥depot サブディレクトリーと states ディレクトリーを入れるために使用する親ディレクトリーを指定します。 ¥depot
ディレクトリーには、データベースに格納されるすべてのセグメントが入るので、disk_max キーワードの値を保持できるだけの十分なフリー・スペースが必要です。 states ディレクトリーにはリピーターのキューの永続的状態が入ったデータベースが格納されています。
send_timeout=seconds
データの送信中にネットワーク障害またはターゲット障害を検出するために使用するタイムアウトを (秒単位で) 指定します。ターゲットは、send_timeout オプションで指定した秒数で、ネットワーク上の各パケットを受信できます。タイムアウトになると、配布はリピーターのキューの中に残り、conn_retry_interval 秒後に再試行が行われます。アプリケーション固有の設定により、この設定が指定変更される場合があります。
slow_link=TRUE | FALSE
1 キロバイト未満の帯域幅のリンク上で配布を行うかどうかを指定します。 TRUE に指定すると、net_load、packet_size、および target_netload の値はキロバイトではなくバイト単位で測定されます。デフォルトは FALSE です。
target_netload=KB_per_second
個々のターゲットに送信できるネットワーク帯域幅の最大量を (1 秒あたりのキロバイト数で) 指定します。 slow_linkを TRUE に設定すると、ネットワーク帯域幅を 1 秒当りのバイト数で測ります。デフォルト値 0 は、この検査を使用不可にします。このコマンドは、net_load キーワードと共に使用します。
-T [database_purge_interval]
完了した配布が 配布マネージャーによって RIM データベースから削除されるときのインターバルを (秒単位で) 設定します。このインターバルを設定すると、配布要求が実行依頼された後に配布マネージャーで、完了した配布をデータベースから削除できます。パージ間隔が定義されていても、定義された間隔が経過して配布要求が実行依頼されていないと、完了した配布は削除されません。パージ間隔を指定しないでこのコマンドを発行すると、現行設定が出力されます。パージ間隔を -1 に設定すると、データベースのパージは使用不可になります。デフォルト値は -1 です。
wmdist
320 Tivoli Management Framework: リファレンス・マニュアル
権限配布の取り消し、削除、休止、または再開を行う場合: senior、またはDist_control と RIM_view の両方。
配布マネージャーでログ・ファイルに書き込まれるログ・メッセージのレベルを変更する場合、調整オプションを使用してリピーターを構成する場合、状況を保管するように RIM オブジェクトを変更する場合、または完了した配布を RIM データベースから除去するインターバルを設定する場合: senior
指定したリピーターの内部状態を表示してキュー内の配布対象を使用中の接続リストを出力する場合、配布対象に対応するエンドポイント状況のリストを出力する場合、または経路をインデント形式にして、特定の配布対象に関連するノードを表示する場合: senior または RIM_view
キューの内容を削除する場合: admin、senior、または super
配布がアクティブのときに、別のゲートウェイへマイグレーションするエンドポイントの後に配布を続けるかどうかをコントロールする場合: senior
配布マネージャーに、配布を開始する前にデータベース接続を検証させるかどうかをコントロールする場合: senior
例1. 以下の例は、ID 11268691349760 の配布対象のエンドポイントのうち、状態が
SUCCESSFUL または FAILED のいずれかである、すべてのエンドポイントの状況をリストします。
wmdist -e 11268691349760 SUCCESSFUL FAILED
Name Status Start Time End Timehops SUCCESSFUL 2000.12.05 10:31:25 2000.12.05 10:31:29starn FAILED 2000.12.05 10:31:25 2000.12.05 10:31:29
2. 次の例では、リピーター zyrus のキューの内容が表示されます。
wmdist -I zyrus
Repeater: zyrus
Jobs in SEND queue: 1Jobs in RECEIVE queue: 0
===Session Information ===
Low: available = 40 used = 0Medium: available = 10 used = 0High: available = 5 used = 0
===Distribution Information ===
External Id: 1185150392.113Internal Id: 1185150392.113Label: bobg20Priority: 3Application: mftp2debug
Target: endpt123 State: PAUSED
3. 次の例では、すべてのアクティブな配布に関する詳細な情報をリスト表示します。
wmdist
第 3 章 コマンド (アルファベット順) 321
wmdist -l -a -v
4. 次の例では、デフォルト構成のものも含めてすべてのリピーターについて、permanent_storage を FALSE に設定して、disk_max を 51200 に設定します。
wmdist -s all permanent_storage=FALSE disk_max=51200
5. 次の例では、リピーター liliana の設定を表示できます。
wmdist -s liliana-gw
repeater_id: 1849216852.1.580rpt_dir: /tmp/permanent_storage: TRUEmax_sessions_high: 5max_sessions_medium: 10max_sessions_low: 40disk_max: 500 (MB)mem_max: 64 (MB)send_timeout: 300 (secs)execute_timeout: 600 (secs)notify_interval: 30 (mins)conn_retry_interval: 900 (secs)retry_ep_cutoff: 7200 (secs)net_load: 500 (KB/sec)packet_size: 16 (KB)target_netload: 0 (KB/sec)debug_level: 3repeater_multicast: FALSEendpoint_multicast: FALSEdefault_multicast: FALSESLOW_LINK: FALSE
リピーターのラベル、オブジェクト ID、または管理対象ノード ID を指定できることに注意してください。
6. 次の例では、zyrus リピーターのキューとデポの両方から内容をすべて削除します。
wmdist -B -A zyrus
このコマンドは、サポート・プロバイダーからの要請があった場合のみ、使用してください。
参照wmcastwdepot, wep, wmdistgui, wrpt
wmdist
322 Tivoli Management Framework: リファレンス・マニュアル
wmdistgui
起動した管理対象ノードから、分散ステータス・コンソールを開始します。
構文wmdistgui
説明wmdistgui コマンドは、アドミニストレーターがネットワーク上での配布をモニターしてコントロールできる分散ステータス・コンソールを始動します。
このコマンドを実行する前に、分散ステータス・コンソール・ソフトウェアをインストールしておく必要があります。
UNIX 管理対象ノードでこのコマンドを実行するには、X Window システムへの接続を使用可能にして、さらにリモート・ログインを使用可能にしておく必要があります。
オプションなし。
権限状況を表示するには、senior または RIM_view の、どちらかの許可の役割が必要です。
第 3 章 コマンド (アルファベット順) 323
wmemsize
管理対象ノードにインストールされている物理メモリーの量を報告します。
構文wmemsize node_name
説明wmemsize コマンドは、管理対象ノードにインストールされている物理メモリーの量を報告します。このコマンドを実行するには、管理対象ノードが使用可能でなくてはなりません。出力は標準出力に表示され、物理メモリーのメガバイト数が報告されます。
オプションnode_name
検査する管理対象ノードの名前を指定します。
権限user、admin、senior、super
例次の例では、管理対象ノード ebbets にインストールされているメモリーの量が表示されます。
wmemsize ebbets
64
324 Tivoli Management Framework: リファレンス・マニュアル
wmerge
3 つのファイル・マージを実行します。
構文wmerge [-L ″label1″ [-L ″label3″]] [-p] [-q] ″file1 file2 file3″
説明wmerge コマンドは、file2 から file3 へリードするすべての変更を、file1 に取り込みます。 -p オプションを指定すると、結果は標準出力に書き込まれます。このオプションを指定しないと、結果は file1 に書き込まれます。このコマンドは、元のファイルに対する個別の変更内容をまとめるときに役立ちます。たとえば、file2 がオリジナルで、file1 と file3 は両方ともオリジナル・ファイルを変更したものだとします。このコマンドは、これらの両方の変更を結合します。
両方の変更ファイルで行の共通セグメントが変更されている場合、オーバーラップが発生します。 diff3 コマンドが -E オプションをサポートしない少数の古いホストでは、wmerge コマンドはオーバーラップを検出しないので、変更された行をfile3 から取り出すだけです。ほとんどのホストでは、オーバーラップがあると、wmerge コマンドは (-q オプションを指定しない場合に) メッセージを出力し、重複部分の両方を結果に組み込みます。それらの重複行は、次のように区切られます。
<<<<<<< "file1""lines in file1""=======""lines in file3">>>>>>> "file3"
オーバーラップが発生している場合、ユーザーは、結果を編集して重複行のうちのいずれかを削除する必要があります。両方の -L オプションが指定されると、オーバーラップ・レポートに、file1 および file3 の名前の代わりにラベルが出力されます。
診断終了状況は、オーバーラップがない場合は 0、多少のオーバーラップがある場合は1、大量のオーバーラップがある場合は 2 になります。
作成者作成者: Walter F. Tichy リビジョン番号: 1.1.6.2; リリース日: 1993/10/07 Copyright
© 1982, 1988, 1989 by Walter F. Tichy. Copyright © 1990, 1991 by Paul Eggert.
参照wco, wrcsmerge
第 3 章 コマンド (アルファベット順) 325
wmrgaef
アップグレード後、Tivoli Enterprise アプリケーションからカスタム・ダイアログをマージします。
構文wmrgaef [-r resource...] -d path
説明wmrgaef コマンドは、アップグレード後に、Tivoli Enterprise アプリケーションからカスタム・ダイアログをマージします。このコマンドを実行する前に、最初にwcatcher コマンドを使用してカスタム・ダイアログを保管しておく必要があります。
wmrgaef コマンドは、カスタム・ダイアログをアップグレード後のダイアログにマージさせます。元のダイアログとアップグレード後のダイアログの違いが少ないほど、カスタム・ダイアログは簡単にマージされます。
オリジナルのダイアログとアップグレード後のダイアログがまったく異なる場合は、マージにより、無効なダイアログ仕様言語 (Dialog Specification Language: DSL)
が生じる可能性があります。この場合、wmrgaef コマンドは、そのダイアログをマージできなかったことを知らせます。このコマンドは、元のダイアログ、アップグレード後のダイアログ、およびマージを試行したダイアログを、wcatcher コマンドで指定されたディレクトリーに保管します。
オプション-d path
カスタム・ダイアログを含むディレクトリーへのパスを指定します。このディレクトリーは、wcatcher コマンドで指定されたディレクトリーと同じです。つまり、-d オプションで指定された親パスと -s オプションで指定されたサブディレクトリーです。
-r resource
マージするリソース・タイプを指定します。リソース・タイプを指定しないと、コマンドは、指定されたディレクトリー内のすべてのカスタム・ダイアログを読み取ってマージしようとします。
権限super
例以下の例は、 /tmp/aef/my.dir ディレクトリー内にある wcatcher コマンドによって保管されたカスタム・ダイアログをマージします。
wmrgaef -d /tmp/aef/my.dir
326 Tivoli Management Framework: リファレンス・マニュアル
参照wcatcher
wmrgaef
第 3 章 コマンド (アルファベット順) 327
wmrgini
ある .INI ファイルのグループおよび変数を、別の .INI ファイルのグループおよび変数にマージします。
構文wmrgini destination_file source_file
説明wmrgini コマンドは、ある .INI ファイルの内容を別の .INI ファイルの内容にマージします。ソース・ファイル内のそれぞれの変数ごとに、宛先ファイルに同じ変数が作成されるか、置換されます。このコマンドはエンドポイントから実行する必要があります。
オプションdestination_file
宛先ファイルの名前を指定します。
soure_file
マージするソース・ファイルの名前を指定します。
例以下の例は、c:¥temp¥system.ini ファイルを c:¥temp¥win.ini ファイルにマージします。
wmrgini c:¥temp¥win.ini c:¥temp¥system.ini
参照weditini
328 Tivoli Management Framework: リファレンス・マニュアル
wmv
コレクション間でオブジェクトを移動します。
構文wmv [-I] label... collection
説明wmv コマンドは、現在の作業コレクションから指定されたコレクションに、指定されたオブジェクトを移動します。このコマンドのオプションには、完全ラベル・パスまたは部分ラベル・パスを指定できます。
このコマンドを使用してエンドポイントを移動する場合は、wep コマンドのsync_gateways オプションを利用して、エンドポイント・マネージャー、ゲートウェイ、および Tivoli リージョン内のエンドポイントで保管されているエンドポイント・データを同期化します。
オプション-I 失敗したすべてのサブオペレーションを無視して、コマンドを続行できるよ
うにします。このオプションは、コマンドに複数のラベルを渡す場合にだけ役立ちます。このオプションを使用すると、1 つのオブジェクトの移動プロセスが失敗しても、引き続き次のオブジェクトがこのコマンドによって移動されます。このオプションを指定しないと、個別オブジェクトについて移動プロセスが失敗した場合、コマンドはすでに除去されたオブジェクトをすべて復元し、そのあとで失敗します。デフォルトでは、サブオペレーションが異常終了するとコマンドは異常終了します。
collection
宛先コレクションのラベルを指定します。このオプションは、完全ラベル・パス (/ コレクションで始まるパス)、部分ラベル・パス (現在の作業コレクションに対して相対的な)、単純名 (現在の作業コレクションの中にある) のいずれかにすることができます。 デフォルトは、現在の作業コレクションです。リンクされたオブジェクトは、選択したコレクションのメンバーになります。
label 移動する 1 つまたは複数のオプションのラベルを指定します。このオプションには、完全ラベル・パス (/ コレクションで始まるパス)、部分ラベル・パス (現在の作業コレクションを起点とするパス) 、または単純名 (現在の作業コレクションの中での名前) の、どれでも指定できます。
権限両方のポリシー・リージョンでの admin、senior、または super、および該当するグローバル権限の役割
例次の例では、lost-n-found コレクションからアドミニストレーター Root のデスクトップ・コレクションに、ManagedNode オブジェクト ceridwen を移動します。
第 3 章 コマンド (アルファベット順) 329
wmv /lost-n-found/ceridwen /Administrators/Root_ceridwen-region
参照wep, wln
wmv
330 Tivoli Management Framework: リファレンス・マニュアル
wmvrim
RDBMS Interface Module (RIM) オブジェクトを別の管理対象ノードに移動します。
構文wmvrim [-h host_name | -o host_oid] [-H db_home] [-I instance_home] [-tinstance_name] rim_name
説明wmvrim コマンドは、RIM オブジェクトを指定した管理対象ノードに移動します。-h オプションまたは -o オプションを使用するときは、wmvrim コマンドを入力し、既存の RIM オブジェクトが配置される Tivoli リージョンにとってローカルな管理対象ノードを指定してください。 -I オプションが必要なのは、DB2 データベースの場合だけです。移動を実行している間は、その RIM オブジェクトのベンダーを変更することはできません。ベンダーを変更するには、その RIM オブジェクトを削除して新たに RIM オブジェクトを作成する必要があります。
注: スペースが含まれたパスを指定する場合、そのパス名を引用符 (″ ″) で囲む必要があります。Windows システムでは、MS-DOS パスも指定できます。たとえば、パス c:¥Program Files¥sqllib を、次のいずれかの方法で指定できます。v "c:¥Program Files¥sqllib"
v c:¥progra~2¥sqllib
オプション-h host_name
RIM オブジェクトが入る管理対象ノードのホスト名を指定します。管理対象ノードは、ローカル Tivoli リージョン内になければなりません。このオプションまたは -o オプションのいずれも使用しない場合、 RIM オブジェクトは移動しません。
-H db_home
RDBMS サーバーまたはクライアント・ソフトウェアがインストールされている、 RIM ホストのディレクトリーへの絶対パスを指定します。
DB2 DB2 ソフトウェアをインストールしたディレクトリー。 DB2DIR
変数の値と同じです。
Oracleホーム・ディレクトリー。 ORACLE_HOME 変数と同じです。
Sybaseinterfaces ファイルを含むディレクトリー。 SYBASE 変数と同じです。
Microsoft SQLMicrosoft SQL サーバーをインストールしたディレクトリー。
InformixInformix CLI クライアントをインストールしたディレクトリー。INFORMIXDIR 変数の値と同じです。
第 3 章 コマンド (アルファベット順) 331
注: Windows オペレーティング・システムでは、スペースが含まれるパスの値を指定する場合、次のいずれかのフォーマットを使用します。
v ″c:¥Program Files¥sqlib″
v c:¥progra~1¥sqllib
値を二重引用符 (″) で囲まなかった場合またはパス名に波形記号 (~) を含まなかった場合、コマンドの構文解析は失敗します。
-I instance_home (DB2 のみ)
INSTHOME 変数の値を指定します。この値は、データベース・インスタンスが作成されたホーム・ディレクトリーです。
-o host_oid
RIM オブジェクトが入る管理対象ノードのオブジェクト ID を指定します。管理対象ノードは、ローカル Tivoli リージョン内になければなりません。このオプションまたは -h オプションのいずれも使用しない場合、RIM オブジェクトは移動しません。
-t instance_name (DB2 のみ)
DB2INSTANCE 変数の値を指定します。RIM ホストがデータベース・サーバーと同じマシンの場合、この値はサーバー・インスタンスの名前でなくてはなりません。RIM ホストがデータベース・サーバーと異なるマシン上にある場合、この値はクライアント・インスタンスの名前でなくてはなりません。
rim_name
既存の RIM オブジェクトのラベルを指定します。
権限Tivoli リージョン内の senior または super
例1. 次の例では、RIM オブジェクト inventory を管理対象ノード amon-sul に移動します。
wmvrim -h amon-sul inventory
2. 次の例では、RIM オブジェクト invdh2 を管理対象ノード amon-sul に移動します。オリジナル RIM オブジェクト上の Oracle クライアント・ソフトウェアは、 /tivoli/oracle ディレクトリーにあります。管理対象ノード amon-sul では、それは /oracle ディレクトリーにあります。
wmvrim -h amon-sul -H /oracle invdh2
参照wcrtrim, wdel
wmvrim
332 Tivoli Management Framework: リファレンス・マニュアル
wpatch
Tivoli Enterprise ソフトウェア・パッチのインストール
構文wpatch [-c source_dir] -i patch [-n] [-y] [install_variables]... managed_node...
説明wpatch コマンドは、Tivoli サーバーで呼び出されると、Tivoli Enterprise ソフトウェア・パッチをインストールします。
オプション-c source_dir
インストール・イメージ が入っているディレクトリーへの完全パスを指定します。 source_dir には、完全修飾パス (たとえば、/cdrom)、もしくはソース・ホストと source_host:path (たとえば、oak:/cdrom) フォーマットのパスのどちらかを指定できます。
-i patch
パッチのインストール元のインデックス・ファイルを指定します。インデックス・ファイルには、.IND という拡張子が付いています。このファイル拡張子を付けてファイル名を入力しても、付けないで入力しても構いません。たとえば、ソース・ディレクトリーにファイル TMF.IND が入っている場合、-i TMF と指定しても -i TMF.IND と指定しても、同じファイルが表示されます。
-n 現在パッチがインストールされていない管理対象ノードすべてにパッチをインストールします。管理ノードを指定すると、このオプションは無視されます。
-y 確認をせずにインストールを進めることを指定します。デフォルトでは、このコマンドは、インストールを実行するための処理内容を明示し、その確認を受けてからインストールを開始します。このオプションを指定すると、wpatch コマンドは処理内容を明示した後、確認を求めずにインストールを実行します。
install_variables
パッチ固有のインストール変数を指定します。この変数は一般的に、@variable@=value という形式をとります。特定の製品とそのパッチのインストール・オプションの詳細については、製品とパッチの資料を参照してください。
注: インストール・オプションの名前は、製品の資料に示されているとおり正確に入力してください。インストール・オプションは、大文字小文字を区別します。
managed_node
Tivoli パッチをインストールする管理対象ノードを指定します。複数の管理対象ノードを指定できます。管理対象ノードを指定しないと、パッチは、
第 3 章 コマンド (アルファベット順) 333
Tivoli 管理リージョン (TMR) 内の管理対象ノードすべてにインストールされます。ほとんどの場合は、このオプションを指定しません。
権限senior または install_product
参照wclient, winstall, wserver
wpatch
334 Tivoli Management Framework: リファレンス・マニュアル
wping
ホスト上のオブジェクト・ディスパッチャーへの接続を試みます。
構文wping host_name [timeout]
説明wping コマンドは、指定したホスト上のオブジェクト・ディスパッチャーへのコンタクトを行います。オブジェクト・ディスパッチャーが応答する場合、次のメッセージが標準出力に書き込まれます。
object dispatcher on host_name is alive
オブジェクト・ディスパッチャーが応答しない場合、次のメッセージが標準出力に書き込まれます。
no response from object dispatcher on host_name
オプションhost_name
コンタクトするホストの名前です。
timeout ホストがアクティブでないことを報告する前に、ホストが応答するまで待つ秒数です。
権限user、admin、senior、super
第 3 章 コマンド (アルファベット順) 335
wpopulate
システム・ファイルからプロファイルに情報を取り込みます。
構文wpopulate [-o] source profile
説明wpopulate コマンドは、Tivoli Enterprise ソフトウェアが管理するシステムの構成情報を構成プロファイルに追加します。
このコマンドは、プロファイル・エンドポイントで検出した構成に基づいて、指定されたプロファイル情報を取り込みます。 source オプションは、取り込み元プロファイル・エンドポイントを識別します。プロファイルに取り込む情報のタイプは、プロファイル・タイプによります。
-o オプションを指定した場合、wpopulate コマンドによって現在のプロファイルの内容が上書きされます。-o オプションを指定しない場合、プロファイルの内容にsource の内容が追加されます。
オプション-o 指定したプロファイルの内容を上書きすることを指定します。
profile 取り込み先プロファイルの名前を指定します。
source プロファイルのソースとして使用するプロファイル・エンドポイントの名前を指定します。
権限senior、super
例次の例では、管理対象ノード pinatubo 上の passwd ファイルの内容が、UnixUser
UserProfile に取り込まれます。ファイルの内容が、プロファイルに追加されます。
wpopulate @ManagedNode:pinatubo @UserProfile:UnixUser
参照wcrtprf, wcrtprfmgr, wdistrib, wgetprf, wgetsub, wlssub, wsub, wunsub,
wxterm
336 Tivoli Management Framework: リファレンス・マニュアル
wputeppol
変更したエンドポイント・ポリシー・スクリプトを置き換えます。
構文wputeppol policy_script
説明wputeppol コマンドは、エンドポイント・ポリシー・スクリプトを置き換えます。スクリプトの変更後、このコマンドを使って Tivoli データベースにスクリプトを書き込み、変更を保管します。スクリプトの内容は、標準入力により入力されなければなりません。
オプションpolicy_script
置き換えるポリシー・スクリプトの名前を指定します。
権限senior
例次の例では、データベースにログイン・ポリシー・スクリプトの変更のメソッドを書き込み、保管します。
wputeppol login_policy < login_policy
参照wgeteppol
第 3 章 コマンド (アルファベット順) 337
wputpolm
ポリシー・メソッドの本体を置き換えます。
構文wputpolm [-C | -c value] [-d | -v] class name policy
wputpolm [-d | -v] [-F | -N] [-n | -C | -c value] [args=’a1,...’] profile policy
説明wputpolm コマンドは、指定したポリシー・メソッドの本体を置き換えます。wputpolm コマンドには 2 つの形式があります。従来の Tivoli 管理対象リソースのポリシー・メソッドを置き換えるための形式と、プロファイルのポリシーの値を置き換えるための形式です。
最初の形式では、class オプションは、リソースのタイプを指定し、name は、アクションの対象とするポリシー・オブジェクトのラベルを指定します。 -d オプションを指定した場合、name はポリシーのデフォルト・オブジェクト名とリソースのデフォルト・ポリシーを表します。
このコマンドの形式を使用して、次の 2 とおりの方法でポリシー・メソッドを定義できます。 1 つは、標準入力からポリシー・メソッドの本体を読み取る方法です。この形式では、シェル・スクリプトとしてインプリメントされたメソッドを定義するために wputpolm を使用します。オブジェクト名とリソースのデフォルト・ポリシーを表します。この形式は、バイナリー・ファイルに対しても実行でき、標準入力から実行可能プログラムを受け入れることもできます。もう 1 つは、定数値を持つポリシー・メソッドを定義するためにこのコマンドを使用する方法です。この形式では、シェル・スクリプトを書く必要はありません。これらの定数によるメソッドは、シェル・スクリプトによるメソッドより、ストレージ・スペースが少なく済み、迅速に実行できます。このコマンドは、コマンド行 (-c オプションを指定した場合) または標準入力 (-C オプションを指定した場合) から定数の戻り値を読み取ります。
2 番目の形式では、profile オプションはプロファイル名を指定し、policy オプションは設定するポリシーの個別属性、つまり wlspolm コマンドが返すものを指定します。 -C オプション、-c オプション、-d オプション、および -v オプションは、プロファイルと管理対象リソースに対して同じように動作し、プロファイルに定数値のポリシーまたはスクリプト値のポリシーをインストールするために使用します。プロファイルに対して wputpolm を実行する場合は、-n オプションも使用できます。-n オプションは、none を示します。デフォルト・ポリシーを表す -d と同時に使用すると、-n は、その特定の属性にデフォルト値がないことを意味します。検証ポリシーを表す -v と同時に使用した場合、 -n はそのポリシーに対してすべての値が有効であることを示します。
ポリシーを固定に設定するには -F オプションを、非固定に設定するには -N 引き数を指定します。いずれのフラグも指定しない場合は、ポリシーの状況は固定され、変更されないままです。
338 Tivoli Management Framework: リファレンス・マニュアル
オプションの args リストは、スクリプト値のポリシーに対してのみ有効で、ポリシー・スクリプトに渡す入力オプションを示します。形式 $attribute のすべての入力オプションに対して、属性値は入力としてスクリプトに渡されます。ここでattribute はリソース・タイプの属性の名前です。
注: ポリシーはポリシー・メソッドが適用される管理対象リソースのタイプに依存するので、ポリシー・メソッドを追加しても通知は通知グループに組み込まれません。
入力-C オプションを指定した場合は、ポリシー・メソッドに設定する定数の戻り値はコマンドの標準入力から読み取られます。
-c オプションを指定した場合は、標準入力は無視されます。
-C オプションと -c オプションの両方を省略すると、コマンドの標準入力からメソッドの本体 (通常はシェル・スクリプト) が読み取られます。
オプション-c value
ポリシー・メソッドが常に特定の定数値を返すよう定義することを指定します。 value は、英数字の情報交換用米国標準コード (ASCII) ストリングです。数値は読み取られますが、ストリングとして格納されます。このオプションと -C オプションを省略すると、このコマンドは標準入力からメソッドの本体を読み取ります。
-C ポリシー・メソッドが常にこのコマンドの標準入力から読み取った特定の定数値を返すよう定義することを指定します。このオプションと -C オプションを省略すると、このコマンドは標準入力からメソッドの本体を読み取ります。
-d メソッドがデフォルト・ポリシーであることを指定します。
-F ポリシーが固定で、サブスクライバーはこれは変更できないことを指定します。
-n ポリシーの属性にデフォルト値がないか、またはポリシー用としてどの値でも有効であることを指定します。
-N ポリシーが固定でないことを指定します。配布後、サブスクライバーはポリシーを変更できます。
-v メソッドが検証ポリシーであることを指定します。
args=’a1,...’
メソッドへの追加の引き数を指定します。
class ポリシーを割り当てる管理対象リソースのタイプを指定します。
name 管理対象リソースの名前を指定します。
policy 本体が定義または置換されるメソッドの名前を指定します。
profile ポリシーを割り当てるプロファイルを指定します。
wputpolm
第 3 章 コマンド (アルファベット順) 339
権限最初のコマンド形式の場合は、super と policy
2 番目のコマンド形式の場合は、senior または super
例1. プロファイルを使用しない場合、次の例は、ProfileManager タイプに対する制限付きポリシー検証オブジェクトの pm_val_subscribers 検証スクリプトから新しいポリシー・スクリプトをインストールします。スクリプトは、標準入力から読み取られます。
wputpolm -v ProfileManager Restricted pm_val_subscribers < new_script
2. プロファイルを使用しない場合、次の例では pm_val_subscribers 検証スクリプトのポリシーが定数 TRUE に設定されます。これは、すべてのサブスクライバーを受け入れることを意味します。
wputpolm -v -c TRUE ProfileManager Restricted pm_val_subscribers
3. プロファイルを使用する場合、次の例は Engineering という名前のユーザー・プロファイル用にユーザー ID (UID) を生成する新しいデフォルトのポリシー・スクリプトをインストールします。ポリシーは固定されているので、サブスクライバーはこれを変更できません。スクリプトでは、ユーザーの実名とログイン名を引き数として使用します。スクリプトは、標準入力から読み取られます。
wputpolm -d -F args=’$real_name,$login_name’ ¥@UserProfile:Engineering uid < new_script
参照wchkpol, wcrtpol, wcrtpr, wdelpol, wdelpr, wgetdfpol, wgetpolm, wlspol,wlspolm
wputpolm
340 Tivoli Management Framework: リファレンス・マニュアル
wpwd
現在の作業コレクションを表示します。
構文wpwd [-o]
説明wpwd コマンドは、現在の親プロセス ID に対するアドミニストレーターの現在の作業コレクションのラベルを出力します。各アドミニストレーターは、親プロセスID ごとに現在の作業コレクションをもっています。
オプション-o コレクションのオブジェクト ID を表示します。このオプションを指定しな
いと、コレクションのラベルが表示されます。
権限user、admin、senior、super
参照wcd
第 3 章 コマンド (アルファベット順) 341
wrcs
Revision Control System (RCS) ファイルの属性を変更します。
構文wrcs [options] file...
説明wrcs コマンドは、新しい RCS ファイルを作成したり、既存の RCS ファイルの属性を変更します。 RCS ファイルには、テキストの複数のリビジョン、アクセス・リスト、変更ログ、記述テキスト、一部のコントロール属性が収められています。wrcs を動作させるには、呼び出し元のログイン名がアクセス・リストになければなりません。ただし、アクセス・リストが空の場合、呼び出し元がファイルの所有者またはスーパーユーザーの場合、-i オプションが指定されている場合は例外です。
RCS サフィックスに一致するパスは、RCS ファイルを表します。その他のパスは、作業ファイルを表します。名前は、wci コマンドで説明されているとおりに対になっています。リビジョン番号では、wci コマンドで説明した構文を使用します。
オプション-a logins
コンマで区切られたリスト logins 内のログイン名を RCS ファイルのアクセス・リストに追加します。
-A old_file
old_file のアクセス・リストを RCS ファイルのアクセス・リストに追加します。
-b [rev]
デフォルトのブランチを rev に設定します。rev を省略すると、デフォルトのブランチは (動的に) トランクの最上位のブランチにリセットされます。
-c string
コメント・リーダーを string に設定します。最初の wci コマンドまたは-c オプションを省略した wrcs -i コマンドでは、作業ファイル名のサフィックスからコメント・リーダーを推測します。このオプションは廃止されました。なぜなら、RCS は通常、チェックアウト時にログ行を挿入するときには、先行の $Log$ 行のプレフィックスを使用するからです (wco コマンドを参照)。しかし、古いバージョンの RCS では $Log$ 行のプレフィックスでなく、コメント・リーダーを使用している場合があります。したがって、新旧両方のバージョンの RCS を使用してファイルにアクセスすることを計画している場合は、コメント・リーダーが $Log$ 行のプレフィックスに一致していることを確認してください。
-e [logins]
コンマで区切られたリスト logins 内のログイン名を RCS ファイルのアクセス・リストから削除します。logins を省略すると、アクセス・リスト全体が削除されます。
-i 新しい RCS ファイルを作成して初期化しますが、リビジョンは格納されま
342 Tivoli Management Framework: リファレンス・マニュアル
せん。RCS ファイルにパスのプレフィックスがない場合は、最初に ./RCS
サブディレクトリーへの配置を試みて、それから現行ディレクトリーへの配置を試みます。 RCS ファイルがすでにある場合は、エラー・メッセージが出力されます。
-I 標準入力が端末でない場合でも、対話式に実行します。
-k subst
デフォルト・キーワードの置換を subst に設定します。キーワード置換の効果については、wco に説明があります。 wco コマンド、wrcsdiff コマンド、および wrcsmerge コマンドで明示的に -k オプションを指定すると、このデフォルトは指定変更されます。 -kv オプションは wco -l コマンドと非互換なので、wrcs -kv コマンドは使用しないでください。通常のデフォルト・キーワードの置換を復元するには、wrcs -k kv コマンドを使用します。
-l [rev]
番号 rev のリビジョンをロックします。ブランチを指定した場合は、そのブランチでの最新のリビジョンがロックされます。rev を省略すると、デフォルトのブランチの最新リビジョンがロックされます。ロックによって、変更がオーバーラップすることを防ぎます。wci または wrcs -u コマンドを指定すると、ロックが除去されます。
-L ロックを strict に設定します。strict (厳密な) ロックとは、RCS ファイルの所有者でもチェックイン時にロックしなければならないということを意味しています。このオプションは、共有ファイルの場合に使用します。
-m rev:msg
rev の改訂ログ・メッセージを msg で置換します。
-M ロックを破ることになる場合は、メールを送信しません。このオプションは通常一般的に使用するものではありません。他の方法でユーザーに警告し、低水準のロック破り操作として wrcs -u を呼び出すプログラムでのみ使用するためのものです。
-n name[:[rev]]
記号名 name をブランチまたはリビジョン rev に関連付けます。コロン (:)
と rev オプションの両方を省略した場合、記号名が削除されます。いずれかを指定した場合、name がすでに別の番号に関連付けられているときには、エラー・メッセージが出力されます。rev が記号である場合、関連付けの前に展開されます。ブランチ番号にピリオド (.) が続く構成の rev は、ブランチ内の現在の最新改訂を意味します。コロンと空の rev は、デフォルトのブランチ (通常はトランク) での現在の最新リビジョンを意味します。たとえば wrcs -n name: RCS/* は、RCS という名前のすべてのファイルの現在の最新のリビジョンに name を関連付けます。これは、wrcs -n name:
RCS/* と対照的です。後者は、nameを、対応する作業ファイル内のキーワード・ストリングから取り出されたリビジョン番号に関連付けます。
-N name[:[rev]]
-n の動作と同じですが、name に対する以前の割り当てを指定変更します。
-o range
range で指定したリビジョンを削除します (「期限切れ」にします)。範囲が単独のリビジョン番号である場合は、そのリビジョンを意味します。範囲が
wrcs
第 3 章 コマンド (アルファベット順) 343
ブランチ番号である場合、そのブランチでの最新のリビジョンを意味します。範囲が rev1:rev2 の形式の場合は、同じブランチでのリビジョン rev1
からリビジョン rev2 を意味します。:rev は、ブランチの始めから rev まで (rev を含む) を意味します。rev: は、リビジョン rev 以降 (rev を含む)、そのブランチの終わりまでを意味します。期限切れのリビジョンには、ブランチやロックを設定できません。
-q 非対話モードで実行します。診断を出力しません。
-s state[:rev]
リビジョン rev の状態属性を state に設定します。rev がブランチ番号である場合は、そのブランチでの最新のリビジョンと見なします。rev が省略された場合は、デフォルトのブランチでの最新のリビジョンが指定されたと見なされます。 state に対して、すべての ID が受け入れ可能です。状態の有効な組み合わせは、Exp (試験)、Stab (安定)、Rel (リリース) です。デフォルトでは、wci はリビジョンの状態を Exp に設定します。
-t [file]
指定した file の記述テキストを RCS ファイルに書き込みます。既存のテキストは削除されます。file パス名はダッシュ (-) で始めることはできません。 file を省略すると、ファイルの終わり (EOF) で終了するか、またはピリオド (.) だけの行で終了テキストが標準入力から取得されます。対話が可能な場合、テキストを入力するよう指示されます。-I オプションを参照してください。-i を指定すると、-t を指定しない場合でも記述テキストが取得されます。
-t - string
string から RCS ファイルに記述テキストを書き込みます。既存のテキストは削除されます。
-T リビジョンが除去されない限り、変更時刻を RCS ファイルに保存します。このオプションを使用すると、作業ファイルの一部コピーに RCS ファイルへの make 依存関係があることで大量の再コンパイルが生じるのを防ぐことができます。 ただし、再コンパイルが必要な場合、つまり RCS ファイルへの変更が作業ファイル内のキーワード・ストリングの変更を意味する場合でも、再コンパイルが抑止されることがあるので、このオプションを使用するときは十分注意してください。
-u [rev]
番号 rev のリビジョンをアンロックします。ブランチを指定した場合は、ブランチでの最新のリビジョンがアンロックされます。 rev を省略した場合は、呼び出し元での最新のロックが除去されます。通常、リビジョンをロックしたユーザーだけがこれをアンロックできます。他のユーザーがリビジョンをアンロックすると、ロックが壊れます。ロックが壊れると、ロックしたユーザーにメール・メッセージが送られます。メッセージには、ロックを壊したユーザーからのコメントも書き込まれます。コメントはファイル・マーク (EOF) で終了するか、ピリオド (.) だけからなる行で終了します。
-U ロックを non-strict に設定します。non-strict (非厳密) ロックとは、ファイルの所有者のチェック時に、リビジョンをロックする必要がないことを意味します。このオプションは、共有ファイルでは使用しないでください。 デフォルトのロックが厳密であるかどうかはシステム・アドミニストレーターが決定しますが、通常ロックは strict (厳密) です。
wrcs
344 Tivoli Management Framework: リファレンス・マニュアル
-V RCS のバージョン番号を出力します。
-V n RCS バージョン n をエミュレートします。詳細については、wco コマンドを参照してください。
-x suffixes
suffixes を使用して RCS ファイルを特徴付けます。詳しくは、wci コマンドを参照してください。
-z zone
zone をデフォルトの時間帯として使用します。このオプションには何の効果もありません。これは、他の RCS コマンドとの互換性を確保するためのものです。
wrcs コマンドに将来加わる予定の拡張機能との互換性を確保するために、明示的なオプションを少なくとも 1 つ指定してください。
互換性-b rev オプションを指定すると、RCS バージョン 3 以前では解析できない RCS
ファイルが生成されます。
-k subst オプション (-k kv を除く) を指定すると、RCS バージョン 4 以前では解析できない RCS ファイルが生成されます。
wrcs -V n を指定すると、バージョン n に適合しない情報は破棄され、RCS バージョン n で RCS ファイルを受け入れることができるようになります。
RCS バージョン 5.5 以前では、-x オプションをサポートしていないため、RCS パス名にサフィックス ,v が必要です。
診断RCS パス名と期限切れのリビジョンは、診断出力に書き込まれます。すべての処理が成功した場合にだけ、終了状況が 0 になります。
ファイルwrcs コマンドのファイル・アクセス方式は、wci コマンドとほぼ同じです。ただし、wrcs コマンドは、すべてのアクセスにおいて有効なユーザーを使用すること、作業ファイルやディレクトリーを書き込まないこと、リビジョン番号 $ が指定されない限り作業ファイルを読み取らないという点が異なります。
環境変数RCSINIT
オプション・リストの前に付くオプションで、それぞれはスペースで区切られています。詳しくは、wci コマンドを参照してください。
障害非常事態 (たとえばシステムの破損) が起きると、RCS でセマフォー・ファイルが残ったままとなり、あとで RCS を呼び出したときに、RCS ファイル使用中のエラ
wrcs
第 3 章 コマンド (アルファベット順) 345
ーになることがあります。これを修正するには、セマフォー・ファイルを除去します。セマフォー・ファイルの名前は、通常、コンマ (,) で始まるか、または アンダースコアー (_) 拡張子で終わります。
-o オプションでのリビジョン範囲の区切り文字は、以前は コロン (:) ではなくダッシュ (-) でしたが、この区切り記号を使用すると、記号名がダッシュを含む場合に、混乱を招きます。 下位互換性のため、wrcs -o ではダッシュ区切り文字もサポートしていますが、この区切り記号の使用は避けてください。
記号名は、既存のリビジョンやブランチを参照する必要はありません。たとえば -oオプションは期限切れのリビジョンの記号名を削除しません。このような記号名を削除するには、-n を使用します。
作成者作成者: Walter F. Tichy リビジョン番号: 5.13; リリース日: 1995/06/05 Copyright ©
1982, 1988, 1989 by Walter F. Tichy. Copyright © 1990, 1991, 1992, 1993, 1994,
1995 by Paul Eggert.
参照wco、 wci、 wident、 wrcsdiff、 wrcsmerge、Walter F. Tichy 著、 RCS—A
System for Version Control, Software—Practice & Experience 15, 7 (July 1985),
637-654.
wrcs
346 Tivoli Management Framework: リファレンス・マニュアル
wrcsdiff
Revision Control System (RCS) のリビジョンを比較します。
構文wrcsdiff [-k subst] [-q] [-r rev1 [-r rev2]] [-T] [-V n] [-x suffixes] [-z zone]
[diff_options] file...
説明wrcsdiff コマンドは diff コマンドを実行することにより、指定した各 RCS ファイルの 2 つのリビジョンを比較します。
RCS サフィックスに一致するパスは、RCS ファイルを表します。その他のパスは、作業ファイルを表します。名前は、wci コマンドで説明されているとおりに対になっています。 -q オプションは診断出力を抑制します。 -r で 0、1、または 2 のリビジョンを指定できます。 -k オプションは、wco で説明したように、リビジョンを抽出する際にキーワードの置換に影響します。たとえば -k k-r1.1-r1.2 を指定すると、リビジョン 1.1 と 1.2 の比較の際にキーワード値の違いを無視されます。ロックしたユーザーの名前を置換することによって出力が増大するのを避けるため、次のような場合には -k kvl が指定されたと見なされます。 (1) リビジョンを最大 1つまで指定した場合。 (2) -k オプションを指定しなかった場合。 (3) -k kvがデフォルトのキーワード置換である場合。 (4) 作業ファイルのモードを wco-l コマンドで生成する場合。 -T 、-V、-x、および -z オプションに関する詳細については、wco コマンドのセクションを参照してください。それ以外のオプションは、通常のファイルに適用できる diff のオプションであれば、すべて diff の場合と同じように使用できます。 rev1 と rev2 の両方を省略すると、wrcsdiff はデフォルトのブランチ (デフォルトではトランク) の最新のリビジョンと、対応する作業ファイルの内容を比較します。これは最後にチェックインしたあとに行われた変更を判別するのに役立ちます。 rev1 を指定して rev2 を省略すると、wrcsdiff は、RCS ファイルのリビジョン rev1 と、対応する作業ファイルの内容を比較します。 rev1 とrev2 の両方を指定すると、wrcsdiff はRCS ファイルのリビジョン rev1 とリビジョン rev2 を比較します。 rev1 と rev2 は、いずれも数字または記号で指定します。
診断終了状況は、比較の結果、違いがない場合は 0、多少の違いがある場合は 1、大量の違いがある場合は 2 になります。
環境変数RCSINIT
オプション・リストの前に付くオプションで、それぞれはスペースで区切られています。詳しくは、wci コマンドを参照してください。
例次のコマンドは、RCS ファイルのデフォルト・ブランチ上の最新のバージョンを作業ファイル f.c の内容と比較します。
wrcsdiff f.c
第 3 章 コマンド (アルファベット順) 347
作成者作成者: Walter F. Tichy リビジョン番号: 5.5; リリース日: 1993/11/03 Copyright ©
1982, 1988, 1989 by Walter F. Tichy. Copyright © 1990, 1991, 1992, 1993 by Paul
Eggert.
参照wco、 wci、 wident、 wrlog、 Walter F. Tichy 著、RCS—A System for Version
Control, Software—Practice & Experience 15, 7 (July 1985), 637-654.
wrcsdiff
348 Tivoli Management Framework: リファレンス・マニュアル
wrcsmerge
Revision Control System (RCS) の改訂をマージします。
構文wrcsmerge [options] file
説明wrcsmerge コマンドは、RCS ファイルの 2 つの改訂の間の変更を、対応する作業ファイルに取り込みます。
RCS サフィックスに一致するパスは、RCS ファイルを表します。その他のパスは、作業ファイルを表します。名前は、wci コマンドで説明されているとおりに対になっています。
次に説明するオプションのいずれかで、少なくとも 1 つの改訂を指定しなければなりません。通常は、-r を指定します。最大 2 つの改訂を指定できます。改訂を 1
つだけ指定した場合、デフォルトのブランチ (通常はトランクの最上位ブランチ) の最新の改訂が 2 番目の改訂と見なされます。改訂は、数字または記号で指定します。
wrcsmerge は、オーバーラップがある場合、警告を出力して、オーバーラップ領域の範囲を区切ります。このコマンドは、チェックアウト後の改訂に変更をマージする場合に使用します。
オプション-k subst
subst スタイルのキーワード置換を使用します。詳しくは、wco コマンドを参照してください。 たとえば -k k-r1.1-r1.2 と指定すると、1.1 から 1.2
に変更をマージするときに、キーワード値の違いは無視されます。
-p [rev]
作業ファイルを上書きする代わりに、標準出力に結果を送信します。
-q [rev]
非対話モードで実行します。診断を出力しません。
-r [rev]
改訂 rev に対してマージを行います。このとき、空の rev は、デフォルトのブランチ (通常はヘッド) での最新の改訂を意味します。
-V n RCS バージョン n をエミュレートします。詳細については、wco コマンドを参照してください。
-x suffixes
suffixes を使用して RCS ファイルを特徴付けます。詳しくは、wci コマンドを参照してください。
第 3 章 コマンド (アルファベット順) 349
診断終了状況は、オーバーラップがない場合は 0、多少のオーバーラップがある場合は1、大量のオーバーラップがある場合は 2 になります。
環境変数RCSINIT
オプション・リストの前に付くオプションで、それぞれはスペースで区切られています。詳しくは、wci コマンドを参照してください。
例1. f.c ファイルの改訂 2.8 をリリースしたとします。その後、改訂 3.4 を完成させ、まだリリースしていないときに、他のユーザーからリリース 2.8 に対する更新を受け取ったとします。 2.8 の更新と、自分の 2.8 から 3.4 への変更を組み合わせるには、2.8 の更新をファイル f.c ファイルに入れて、次のコマンドを実行します。
wrcsmerge -p -r2.8 -r3.4 f.c >f.merged.c
次に、f.merged.c を調べます。あるいは、2.8 への更新を RCS ファイルに保管する場合は、改訂 2.8.1.1 としてこれをチェックインして、wco -j を実行します。
wci -r2.8.1.1 f.cwco -r3.4 -j2.8:2.8.1.1 f.c
2. 別の例として、次のコマンドは、現在 f.c ファイル内でチェックアウトした改訂2.4 と 2.8 の間の変更を取り消します。
wrcsmerge -r2.8 -r2.4 f.c
オプションを上の例の順序で指定すると、f.c ファイルは上書きされてしまうので注意してください。
作成者作成者: Walter F. Tichy 改訂番号: 5.3; リリース日: 1991/08/19 Copyright © 1982,
1988, 1989 by Walter F. Tichy. Copyright © 1990, 1991 by Paul Eggert.
参照wco、 wci、 wident、 wrcsdiff、 wrlog、Walter F. Tichy著、 RCS—A System
for Version Control, Software—Practice & Experience 15, 7 (July 1985), 637-654.
wrcsmerge
350 Tivoli Management Framework: リファレンス・マニュアル
wrefresh
Tivoli コレクション・ウィンドウを最新表示します。
構文wrefresh collection
説明wrefresh コマンドは、指定したコレクションのコレクション・ウィンドウを最新表示します。
オプションcollection
最新表示するコレクション・ウィンドウを指定します。「アドミニストレーター」ウィンドウを最新表示するには、次の形式を使用します。
/Administrators/administrator_name
他のコレクション・ウィンドウを最新表示するには、次の形式のいずれかを使用します。
/Regions/top_level_region_name/subregion_ name
@NisDomain:domain_name
権限user
例1. 次の例は、アドミニストレーター Callahan のデスクトップのすべてのインスタンスを最新表示します。オープンしている Callahan のデスクトップが複数ある場合は、すべてが最新表示されます。
wrefresh /Administrator/Callahan
2. 次の例は、New York ポリシー・リージョンのすべてのインスタンスを最新表示します。
wrefresh @PolicyRegions:NewYork
第 3 章 コマンド (アルファベット順) 351
wregister
新しいリソース・インスタンスをネーム・レジストリーに登録したり、接続している Tivoli リージョン間でリソースを交換できるようにします。
構文wregister -i [-fn] -r resource_type
wregister -i {-fr | -fx} -r resource_type
wregister [-i [-fn] -r resource_type] name object
wregister -u [-r resource_type] name
説明wregister コマンドは、新しいリソース・インスタンスを Tivoli ネーム・レジストリーに登録したり、接続している Tivoli リージョン間でリソースを交換できるようにします。
ある交換可能なリソースをリモート・リソース・タイプとしてマークして使用する場合、接続している Tivoli リージョン間でそのリソースを交換することはできなくなります。リモート・リソース・タイプに対して wlookup コマンドを実行する場合、出力は Tivoli リージョンにより一致するリソース・タイプのリストを戻します。基本的に、リソース・タイプをリモートにした後には、ソート順は異なります。
新しいリソース・インスタンスの作成に使用する場合、コマンドはオプションとして新しいリソース・タイプ用にキャッシュを初期化します。 -r を指定しない場合、distinguished がデフォルトのリソース・タイプになります。
オプション-fn 作成するリソース・タイプが交換できないものとなるよう指定します。交換
できないリソース・タイプは、接続している Tivoli リージョン間で更新できません。
-fr 交換可能なリソース・タイプをリモート・リソース・タイプに指定します。交換可能なリソース・タイプがリモートである場合、接続している Tivoli
リージョン間で更新する必要はありません。
-fx リモート・リソース・タイプを交換可能なリソース・タイプに戻すよう指定します。これらのリソース・タイプは接続している Tivoli リージョンの間で更新できます。
-i リソース・キャッシュを初期化します。このオプションを指定せず、指定したリソース・タイプがあらかじめキャッシュに存在していない場合、wregister はエラーを生成します。
-r resource_type
登録するリソースのリソース・タイプを指定します。省略した場合、distinguished がデフォルトのリソース・タイプになります。
352 Tivoli Management Framework: リファレンス・マニュアル
-u リソース・タイプからリソースを削除します。
name 登録するリソースの名前を指定します。
object リソースのオブジェクト参照子を指定します。
権限senior、super
例1. 次の例では、新しいリソース・タイプ MyResource がネーム・レジストリーに追加されます。新しいリソース・タイプは、交換できません。
wregister -i -fn -r MyResource
2. 次の例では、mylabel というリソースが MyResource に追加されます。 mylabel
のオブジェクト ID は 400004.34.26 です。
wregister -r MyResource mylabel 400004.34.26
3. 次の例では、リソース mylabel が MyResource から除去されます。
wregister -r MyResource -u mylabel
4. 次の例では、新しいリソース・タイプ YourResource が追加され、yourlabel というリソースが YourResource に追加されます。yourlabel のオブジェクト IDは400005.35.37 です。
wregister -i -r YourResource yourlabel 400005.35.37
参照wlookup, wupdate
wregister
第 3 章 コマンド (アルファベット順) 353
wrestart
システムの再始動およびオプションの再始動を開始します。 (Windows のみ)
構文wrestart [-b] [-c] [-f] [-t timeout_value] [-m ″confirm_message″]
説明wrestart コマンドは、システムの再始動やオプションの再始動を開始します。
オプション-b シャットダウンしてからシステムを再始動します¡
-c システムを再始動する前にユーザーに確認を求めます。
-f 他のアプリケーションでの変更を保管せず、強制的に再始動します。このオプションが指定された場合は、変更の保管を促すアプリケーションからのプロンプトが表示されません。
-m ″confirm_message″表示される確認メッセージを指定します。
-t timeout_value
再始動を開始する前にユーザーの確認を待つ時間 (秒数) を指定します。
例1. システムを再始動する前にユーザーに確認を求める場合は、次のコマンドを入力します¡
wrestart -c
2. 警告メッセージを表示して、60 秒後にシステムを再始動する場合は、次のコマンドを入力します。
wrestart -m "Warning: The system will reboot in 60 seconds." -t 60
354 Tivoli Management Framework: リファレンス・マニュアル
wrimtest
RDBMS Interface Module (RIM) オブジェクトの接続性と機能性を検証します。
構文wrimtest -l RIM_object_label
説明wrimtest コマンドは、対話型のコマンド行ユーティリティーです。このコマンドを使用すると、指定したデータベースに接続して RIM メソッドを実行できます。
コマンドが要求された接続を確立した後、以下のオプションのいずれかを入力して機能性をテストすることができます。
c トランザクションをコミットします。
d データベースから行を削除します。
e 構造化照会言語 (SQL) ステートメントを実行します。
g データベースから行を検索します。
i データベースに行を挿入します。
r トランザクションを取り消します。
u データベースの行を更新します。
? コマンド・オプションのリストを出力します。
x ユーティリティーを終了します。
オプション-l RIM_object_label
テストする RIM オブジェクトを指定します。wlookup -ar RIM コマンドを使用すると、使用可能な RIM オブジェクトのリストが表示されます。
権限rim_view、rim_update
参照wrimtrace
第 3 章 コマンド (アルファベット順) 355
wrimtrace
RDBMS Interface Module (RIM) オブジェクトのトレースを使用可能/使用不可にします。
構文wrimtrace RIM_object_label [trace_levels]
説明wrimtrace コマンドは、RIM オブジェクトのトレースを使用可能または使用不可にします。 RIM オブジェクトとクライアント・プログラムの間で受け渡しされたInter-Object Messaging (IOM) パケットの内容と、ネイティブの RDBMS エラーが、 /tmp/rim_db_log ディレクトリーにある RIM ログ・ファイルに書き込まれます。以下の手順を実行して、RIM ログ・ファイルのデフォルトの位置を見つけたり、変更することができます。
1. 次のコマンドを実行します。
odadmin environ get > env.out
2. env.out ファイルを編集し、次の行を追加します。
RIM_DB_LOG=/tivoli/rim/rim_db_log
3. 次のコマンドを実行します。
odadmin environ set < env.out
トレース・レベル・オプション (INFORMATION、ERROR、または TRACE_OFF)
を指定せずに wrimtrace コマンドを実行した場合は、現在のトレース・レベルが標準出力に書き込まれます。トレースは、デバッグのために使用します。長期間使用可能にすると、トレースによってパフォーマンスが悪化し、RIM の処理が遅くなります。
注: RIM トレース・レベルを変更する場合、マシン上の該当するRIM_database_Agent プロセスを検索して停止しなければなりません。なお、database は次のいずれかです。
DB2 の場合DB2
Informix の場合Informix
Microsoft SQL Server の場合MS_SQL
Oracle の場合Oracle
Sybase の場合Sybase
356 Tivoli Management Framework: リファレンス・マニュアル
オプションRIM_object_label
トレースする RIM オブジェクトを指定します。
trace_levels
該当するトレース・レベルを次の中から選択して指定します。
ERRORRDBMS エラーを RIM ログ・ファイルに書き込みます。
INFORMATIONIOM パケットの内容を RIM ログ・ファイルに書き込みます。
TRACE_OFFトレースをオフにします。
例1. 次の例は、Inventory RIM オブジェクトの現在のトレース・レベルを出力します。
wrimtrace inventory
2. 次の例は、IOM パケット情報を RIM ログ・ファイルに書き込みます。
wrimtrace inventory INFORMATION
3. 次の例は、IOM パケット情報と RDBMS エラーを RIM ログ・ファイルに書き込みます。
wrimtrace inventory "INFORMATION|ERROR"
4. 次の例では、RIM トレースをオフにします。
wrimtrace inventory TRACE_OFF
参照wrimtest
wrimtrace
第 3 章 コマンド (アルファベット順) 357
wrlog
Revision Control System (RCS) ファイルについてのログ情報とその他の情報を出力します。
構文wrlog [options] file...
説明wrlog コマンドは、RCS ファイルについての情報を出力します。
RCS サフィックスに一致するパスは、RCS ファイルを表します。その他のパスは、作業ファイルを表します。名前は、wci コマンドで説明されているとおりに対になっています。
wrlog は各 RCS ファイルについての情報を出力します。出力される情報は、RCS
パス名、作業パス名、ヘッド (たとえば、トランクでの最新のリビジョンの番号)、デフォルトのブランチ、アクセス・リスト、ロック、記号名、サフィックス、リビジョン番号の合計、出力するよう選択したリビジョンの番号、記述テキストです。この後に、各ブランチに対して選択したリビジョンのエントリーが、日付の新しい順に続きます。各リビジョンに対して、wrlog はリビジョン番号、作者、日付/時刻、状態、(前のリビジョンに対して) 追加または削除された行数、(あれば) リビジョンをロックしたユーザー、ログ・メッセージを出力します。時刻は、すべて協定世界時 (UTC) で表示されます。オプションが指定されない場合、wrlog はすべての情報を出力します。次のオプションで、この出力を制限します。
オプション-b デフォルトのブランチでのリビジョンについての情報を出力します。デフォ
ルトのブランチは通常、トランクの最上位ブランチです。
-d dates
セミコロンで区切った日付のリストで指定された範囲のリビジョンに関する情報を、チェックイン日時と共に出力します。 d1<d2 または d2>d1 の形式で範囲を指定すると、d1 および d2 を含めた期間内で実施されたリビジョンが対象になります。 <d または d> の形式で範囲を指定すると、d 以前に実施されたすべてのリビジョンが対象になります。 d< または >d の形式で範囲を指定すると、d 以降に実施されたすべてのリビジョンが対象になります。 d の形式で範囲を指定すると、日付が d 以前の最新の単一リビジョンが対象になります。日時のストリング d、d1、および d2 は、wco で説明したフリー・フォーマットです。通常は引用符で囲む必要があります。特に< と > の場合は必要です。区切り文字はセミコロンです。
-h RCS パス名、作業パス名、ヘッド、デフォルトのブランチ、アクセス・リスト、ロック、記号名、サフィックスのみを出力します。
-l [lockers]
ロックされたリビジョンについての情報のみを出力します。また、コンマで区切られたログイン名のリスト lockers を指定すると、lockers によって指
358 Tivoli Management Framework: リファレンス・マニュアル
定されたロック以外は無視されます。たとえば、wrlog -L -R -l wft RCS/*
を指定すると、ユーザー wft がロックした RCS ファイルの名前が出力されます。
-L ロックが設定されていない RCS ファイルを無視します。これは、-h、-l、-R を組み合わせると便利です。
-r [revisions]
コンマで区切られたリビジョンと範囲のリスト revisions で指定したリビジョンについての情報を出力します。範囲が rev1:rev2 の形式の場合は、同じブランチでのリビジョン rev1 からリビジョン rev2 を意味します。:rev
は、ブランチの始めから rev まで (rev を含む) を意味します。rev: は、リビジョン rev 以降 (rev を含む)、そのブランチの終わりまでを意味します。オプションが単独のブランチである場合は、そのブランチでのすべてのリビジョンを意味します。ブランチの範囲は、その範囲のブランチのすべてのリビジョンを意味します。ブランチの後にピリオド (.) を続けると、そのブランチの最新のリビジョンを意味します。 revisions が指定されていない空の -r は、デフォルトのブランチ (通常はトランク) の最新の改訂を意味します。
-R RCS ファイルの名前のみを出力します。これは、作業パス名を RCS パス名に変換するのに便利です。
-s states
状態属性が、コンマ区切りのリスト states で指定した状態のいずれかに一致するリビジョンについての情報を出力します。
-t -h と同じ情報、タイムアウト、および記述テキストを出力します。
-V n ログを生成するときに、RCS バージョン n をエミュレートします。詳しくは、wco コマンドを参照してください。
-w [logins]
コンマ区切りのリスト logins にログイン名があるユーザーがチェックインしたリビジョンについての情報を出力します。logins を省略すると、そのコマンドを実行したユーザーのログインが指定されたと見なされます。
-x suffixes
suffixes を使用して RCS ファイルを特徴付けます。詳しくは、wci コマンドを参照してください。
wrlog は、オプション -d、-l、-s、-w で選択したリビジョンの共通部分から、-bと -r で選択したリビジョンの合併共通部分を取り出して出力します。
診断すべての操作が成功した場合にだけ終了状況は 0 になります。
環境変数RCSINIT
オプション・リストの前に付くオプションで、それぞれはスペースで区切られています。詳しくは、wci コマンドを参照してください。
wrlog
第 3 章 コマンド (アルファベット順) 359
例1. 次のコマンドは、サブディレクトリー RCS 内のロックされているすべての RCS
ファイルの名前を出力します。
wrlog -L -R RCS/*
2. 次のコマンドは、上記のファイルのヘッダーを出力します。
wrlog -L -h RCS/*
3. 次のコマンドは、ロックされた改訂のヘッダーおよびログ・メッセージを出力します。
wrlog -L -l RCS/*
4. 次のコマンドは、完全な情報を出力します。
wrlog RCS/*
障害-r オプションでのリビジョン範囲の区切り文字は、以前は コロン (:) ではなくダッシュ (-) でしたが、この区切り記号を使用すると、記号名がダッシュを含む場合に、混乱を招きます。 下位互換性のため、wrlog -r では以前使用したダッシュ区切り文字もサポートしていますが、この区切り記号の使用は避けてください。
作成者作成者: Walter F. Tichy リビジョン番号: 5.3; リリース日: 1991/08/22 Copyright ©
1982, 1988, 1989 by Walter F. Tichy. Copyright © 1990, 1991 by Paul Eggert.
参照wco、 wci、 wident、 wrcs、 wrcsdiff、 wrcsmerge、Walter F. Tichy 著、RCS—A System for Version Control, Software—Practice & Experience 15, 7 (July
1985), 637-654.
wrlog
360 Tivoli Management Framework: リファレンス・マニュアル
wrm
コレクションからオブジェクトを除去します。
構文wrm [-I] label...
説明wrm コマンドは、コレクションから指定したオブジェクトを除去します。除去するオブジェクトをラベルまたはラベル・パスで指定できます。このコマンドは、オブジェクトへの参照のみを除去します。オブジェクト自体は削除しません。
オプション-I 失敗したすべてのサブオペレーションを無視して、コマンドを続行できるよ
うにします。このオプションは、コマンドに複数のラベルを渡す場合にだけ役立ちます。このオプションを使用すると、1 つのオブジェクトの除去が失敗しても、引き続き次のオブジェクトがこのコマンドによって除去されます。このオプションを指定しないと、個々のオブジェクトの削除操作が失敗したときに、コマンドはすでに削除されたオブジェクトを復元してから、エラーで終了します。サブオペレーションが失敗すると、デフォルトではコマンドは失敗します。
label 除去するオブジェクトのラベルまたはラベル・パスを指定します。オブジェクトを、UNIX のファイル名の指定と同じ方法で指定します。完全ラベル・パスまたは相対ラベル・パスを指定すると、オブジェクトはラベル・パスで指名したコレクションから除去されます。つまりオブジェクトは、最終コンポーネントを除いたラベル・パスで指名されたコレクションから除去されます。修飾せずにオブジェクト・ラベルのみを指定した場合、オブジェクトは現在の作業コレクションから削除されます。
権限admin、senior、super
例次の例では、ManagedNode オブジェクト ceridwen への参照が Administrators コレクションから除去されます。
wrm /Administrators/Root_ceridwen-region/ceridwen
参照wdel
第 3 章 コマンド (アルファベット順) 361
wrmnode
Tivoli 環境から管理対象ノードを削除する。
構文wrmnode [-f] node_name [-d dispatcher_number] [node_name [-ddispatcher_number]]...
説明wrmnode コマンドは、指定した管理対象ノードを Tivoli データベースから除去します。Tivoli サーバーは管理対象ノードですが、このコマンドで Tivoli サーバーを除去するために使用することはできません。UNIX 管理対象ノードの場合、このコマンドは、ディスパッチャーをシャットダウンした後に、Tivoli データベースから管理対象ノードを除去します。
管理対象ノードは、名前で指定します。管理対象ノードが損傷した場合、ディスパッチャー番号を提供する必要がある場合があります。ディスパッチャー番号を取得するには、odadmin odlist コマンドを使用します。
管理対象ノードを除去した後、wchkdb コマンドを使用して、除去した管理対象ノードへのリファレンスが存在しないことを確認するためにデータベースを検証することができます。
オプション-d dispatcher_number
指定したディスパッチャーをシャットダウンして、損傷した管理対象ノードを削除します。
-f ユーザーの確認がなくても、要求されたすべての削除を実行します。
node_name
削除する管理対象ノードの名前を指定します。
権限install_client、super
注このコマンドは、Tivoli Management Framework 実行可能ファイル、データベース、またはその他のファイルを管理対象ノードからは削除しません。
例1. 次の例では、管理対象ノード sherman を Tivoli データベースから除去します。
wrmnode sherman
2. 次の例では、一部をインストールしたノードや、一部を削除した管理対象ノードを削除します。システムからは完全な管理対象ノード名が分からないため、ディスパッチャー番号を指定しなければなりません。ディスパッチャー番号を判別するには、次のコマンドを入力します。
362 Tivoli Management Framework: リファレンス・マニュアル
odadmin odlist
Region Disp Flags Port IPaddr Hostname(s)232323 1 ct- 94 146.84.25.15 ceridwen,ceridwen.tivoli.com
2 -t- 94 146.84.29.12 elcap,elcap.tivoli.com
一部が削除された管理対象ノードを除去するには、以下のコマンドを入力します。
wrmnode elcap -d 2
参照odadmin, wbkupdb, wchkdb, wclient, winstall, wpatch, wserver
wrmnode
第 3 章 コマンド (アルファベット順) 363
wrplblk
ファイル内のステートメントのブロックを置換します。このコマンドはエンドポイントから実行する必要があります。
構文wrplblk [-r] -s ″start_string″ -e ″end_string″ [-o output_file] {-i ″replace_string″ |
@file_name} file_name
説明wrplblk コマンドは、ファイル内のステートメントのブロックを置換します。このコマンドは、ブロックの先頭と終わりが明確に区切られているステートメント・ブロック (winsblk コマンドを使用して追加されたブロックなど) の置換に使用します。
オプション-e ″end_string″
ステートメントのブロックの終わりを表す検索ストリングを指定します。ストリングは二重引用符で囲んでください。
-i {″replace_string″ | @file_name}
区切られたステートメントの間のテキストに置き換わるストリング、またはステートメントのブロックを含んでいるファイルを指定します¡ ストリングは二重引用符で囲んでください。
-o output_file
このコマンドの出力を、標準出力ではなく、output_file ファイルに書き込みます。
-r ステートメントのブロックだけでなく、区切り行も置換します¡
-s ″start_string″ステートメントのブロックの先頭を表す検索ストリングを指定します。ストリングは二重引用符で囲んでください。
file_name
ステートメント・ブロックの置換を行う入力ファイルを指定します。
例以下の例は、c:¥windows¥system.ini ファイル内の [boot] で始まり end で終わるステートメントのブロックを、rplblk.fil ファイル内のステートメントに置き換えます。このコマンドの出力は、c:¥temp¥output.txt ファイルにリダイレクトされます。
wrplblk -s "[boot]" -e "end" -o c:¥temp¥output.txt ¥-i @c:¥temp¥rplblk.fil c:¥windows¥system.ini
参照wclrblk, winsblk
364 Tivoli Management Framework: リファレンス・マニュアル
wrplline
ファイル内の 1 行を置換します。このコマンドはエンドポイントから実行する必要があります。
構文wrplline [-f] -s ″search_string″ [-o output_file] -r ″replace_string″ file_name
説明wrplline コマンドは、テキスト・ファイル内の行を置換します。置換する行は、検索ストリングを使って見つけます。このコマンドの出力は、標準出力に書き込まれます。
オプション-f 検索ストリングを含む最初の行だけを処理します。このオプションを指定し
ないと、検索ストリングに一致するストリングが見つかるたびに処理が行われます。
-o output_file
このコマンドの出力を、標準出力ではなく、output_file ファイルに書き込みます。
-r ″replace_string″検索ストリングを含んでいる行に置き換わるストリングを指定します。ストリングは二重引用符で囲んでください。
-s ″search_string″検索ストリングを指定します。検索ストリングを含んでいる行は、-r オプションで指定されたストリングに置き換えられます。 ストリングは二重引用符で囲んでください。
file_name
行の置換を行う入力ファイルの名前を指定します。
例以下の例は、c:¥windows¥system.ini ファイルの中の device= で始まるすべての行をtype= ストリングに置き換えます。このコマンドの出力は、c:¥temp¥output.txt ファイルに書き込まれます。
wrplline -s "device=" -o c:¥temp¥output.txt -r "type=" ¥c:¥windows¥system.ini
参照wclrline, winsline
第 3 章 コマンド (アルファベット順) 365
wrpt
管理対象ノード上にリピーターを作成し (MDist および MDist 2 の両方について)、MDist リピーターを構成し、MDist 配布を管理します。
構文wrpt
wrpt -A [-f] -k distribution_id
wrpt -g [-e]
wrpt -L
wrpt [-n] source_host [always | noalways] [default | nodefault] [wan | nowan]
[range=value]
wrpt-q source_host target [target...]
wrpt -R -k distribution_id
wrpt -r source_host
wrpt -T [seconds]
wrpt -t source_host [-k distribution_id] [reinit | keyword=value...]
説明wrpt コマンドは、MDist リピーターを構成し、MDist サービスを使用した配布を管理するために使用されます。このコマンドは、また、MDist、MDist 2、あるいはその両方を使用して管理対象ノードにリピーターを作成するためにも使用されます。多重化配布サービスの詳細については、「Tivoli Management Framework ユーザーズ・ガイド」を参照してください。
source_host オプションは、ソース・ホスト (管理対象ノード) の名前を指定します。ホスト番号は、odadmin odlist からの出力の Disp 列のものと同じです。
注: wrpt コマンドでは、エンドポイントをゲートウェイの範囲に追加したり、そこから削除したりすることはできません。ゲートウェイの範囲は、エンドポイントがゲートウェイにログインしたり、ゲートウェイから削除されたときに、動的に設定されます。
オプションオプションが設定されていない場合、wrpt はすべてのリピーターが含まれるテーブルを返します。最初の列は、ソース・ホスト名と大括弧 ([ ]) で囲んだホスト番号です。2 番目の列は、そのリピーターがデフォルト・リピーター (d) であるか、広域ネットワーク (WAN) エントリー・サイト (w) であることを示します。3 番目の列は、リピーターがサービスを提供するホストの範囲を示します。
366 Tivoli Management Framework: リファレンス・マニュアル
注: 結果出力には、リピーターの範囲内にある管理対象ノードだけがリストされます。エンドポイントは表示されません。
-A [-f] -k distribution_id
指定された配布を取り消し、アクティブになっている配布を終了します。取り消した配布を再び開始することはできません。取り消しの際には、強制オプション (-f) が指定されている場合を除き、「よろしいですか ?」というメッセージのプロンプトが出されます。オプションは次のとおりです。
-f 強制的に取り消し操作を実行します。確認のプロンプトは出されません。
-k distribution_id
ターゲットのアクティブ・プロセスを指定します。 distribution_id
には、アクティブな配布の固有のプロセス番号を指定します。distribution_id の値を取得するには、-L オプションを使用します。
注: 配布を取り消しても、ターゲットに正常にインストールされていたファイルが除去されることはありません。
-g [-e] wrpt の追加オプションまたは変更オプションのフォーマットに合うように、フォーマットを変更します。これにより、あとで復元するときにリピーターのレイアウトを取り込むことが容易になります。-e オプションは、リピーターがサービスを提供するエンドポイントの範囲を表示します。
-L 4 列からなる形式で、すべてのアクティブな配布を表示します。最初の列は、アクティブな配布の一意的な番号です。2 番目の列は、配布名です (アプリケーションが選択したラベル)。3 番目の列は、配布の開始時刻で、4
番目の列は in/est_size [out_min-out_max] のフォーマットで、配布の統計情報を表示します。
-n source_host [wan | nowan] [default | nodefault] [always | noalways]
[range=value]
新規のリピーターを作成したり、既存のリピーターに変更を加えたりします。オプションは次のとおりです。
source_host
Tivoli ネーム・レジストリー に登録されている、ソース・ホスト(管理対象ノード) を指定します。
always | noalwaysこのリピーターにはクライアントが 1 つしかない場合でも、配布がこのリピーターを通じて行われるよう指定します。デフォルトでは、リピーターのクライアントが 1 つだけの場合、そのクライアントへの配布はリピーターをバイパスして、直接クライアントに対して行われます。always オプションは、デフォルトの動作を指定変更します。 always オプションを使用不可にして、デフォルトの動作に戻るには、noalways オプションを使用します。
default | nodefaultこのリピーターが、明示的に別のリピーターの範囲に指定されていないすべてのホストにサービスを提供することを示します。このオプションを使用不可にするには、nodefault を使用します。
wrpt
第 3 章 コマンド (アルファベット順) 367
range=value
コンマ区切りによるホスト番号のリストを指定します。連続する番号は、ダッシュ (-) で省略できます。たとえば、2-14 は、2 ~ 14
のすべてのホスト番号を含むリストを指定します。 Tivoli
Management Framework は、範囲をチェックしません。範囲の競合やオーバーラップがあると、結果は保証されません。
wan | nowanこのリピーターを、そのリージョンの WAN エントリー・ポイントとして使用可能/使用不可にします。他のリージョンからの配布はすべて、このリピーターを介して行われます。リージョンの WAN エントリー・ポイントを指定しない場合は、どのリピーターでもリージョン内の配布の最初のホップになることができます。
-q source_host target
指定されたソース・ホストとターゲット・ノードとの間の配布の経路を表示します。出力はインデント形式で示され、指定されたソース・ホストとターゲットとの間のリピーターが表示されます。配布を開始するときには、まずこのオプションを使用して、経路が予期したとおりになっているかを確認してください。オプションは次のとおりです。
source_host
配布のソース・ホストのラベル、オブジェクト ID、または名前を指定します。
target 配布のターゲットのラベル、オブジェクト ID、または名前を指定します。
注: 管理対象ノードとターゲット・エンドポイントが同じ名前の場合は、@ManagedNode と @Endpoint という表記を用いることができます。
-r host 指定されたリピーターを除去します。 host オプションには、Tivoli ネーム・レジストリー に登録されているソース・ホスト (管理対象ノード) を指定します。
-t source_host [-k distribution_id] [reinit | keyword=value]
リピーターの調整オプションを表示および変更します。オプションは次のとおりです。
source_host
Tivoli ネーム・レジストリー に登録されている、ソース・ホスト(管理対象ノード) を指定します。
-k distribution_id
構成オプションが、アクティブな配布だけに影響するようにします。distribution_id には、アクティブな配布の固有のプロセス番号を指定します。 distribution_id の値を取得するには、-L オプションを使用します。
reinit すべてのオプションを工場出荷時の設定に戻します。
keyword=value
以下のいずれかのキーワードとキーワードの値 (整数とディレクトリーの絶対パス名のどちらか) を指定できるようにします。 value
wrpt
368 Tivoli Management Framework: リファレンス・マニュアル
が指定されない場合は、指定されたリピーターの既存のオプションが表示されます。次のようなキーワードがあります。
disk_dir一時ディスク・ページングやスワップ・スペースに使用するディレクトリーを指定します。配布がハングするのを避けるため、十分なスワップ・スペースを持つようにリピーターを設定する必要があります。このスワップ・スペースは、少なくとも disk_max と同じサイズにする必要があります。
disk_hiwatディスク・ブロックの割り振りの間、遅延の生じるディスクの使用量を (KB 単位で) 指定します。遅延期間をdisk_time 調整キーワードで指定します。ディスク・ブロックの割り振りは、16 KB です。Tivoli では、この値をリピーターで使用できる最大のディスク・スペースの約 50%
とするよう推奨します。
disk_maxページングに使用するディスク・スペースの最大量を (KB
単位で) 指定します。 disk_max オプションと mem_maxオプションは、配布に使用するリピーターのタイプに応じて設定する必要があります。ゲートウェイでないリピーターの場合、max_conn が配布のターゲットになるクライアント数より小さい場合は、mem_max と disk_max の合計値は、少なくとも配布する最大ファイル・パッケージのサイズと同じにしておく必要があります。ゲートウェイ・リピーターの場合、max_conn が配布のターゲットになるクライアント数より小さい場合は、disk_max オプション単独で、少なくとも配布する最大ファイル・パッケージのサイズと同じになるように設定する必要があります。
disk_timeディスク・ブロック割り振りの間の遅延を (秒単位で) 指定します。遅延は、ディスクの使用量が disk_hiwat 調整キーワードで指定された数値を超えた場合にのみ開始します。
max_conn配布中にリピーターが開始する、並列クライアントの同時接続の最大数を指定します。
mem_maxディスクにページングする前に使用する最大メモリーを(KB 単位で) 指定します。 disk_max オプションとmem_max オプションは、配布に使用するリピーターのタイプに応じて設定する必要があります。ゲートウェイでないリピーターの場合、max_conn が配布のターゲットになるクライアント数より小さい場合は、mem_max とdisk_max の合計値は、少なくとも配布する最大ファイル・パッケージのサイズと同じにしておく必要があります。ゲートウェイ・リピーターの場合、max_conn が配布のターゲットになるクライアント数より小さい場合は、
wrpt
第 3 章 コマンド (アルファベット順) 369
disk_max オプション単独で、少なくとも配布する最大ファイル・パッケージのサイズと同じになるように設定する必要があります。
net_loadそれぞれの配布の間に、リピーターがネットワークに送信するデータの最大量を (KB/ 秒単位で) 指定します。 Tivoli
では、この値を (リピーターとクライアントの間での) ネットワーク帯域幅の約 25% になるように設定するよう推奨します。net_load は、32 MB/ 秒 より大きい値には設定できません。また、net_load に負の値を設定すると、オプションは 1 配布当たりでなく 1 ターゲット・マシンあたりの設定値になります。
net_spacingネットワークでのそれぞれの書き込みの間に挿入する遅延を指定します (ミリ秒単位)。
stat_intvブロックされた接続がエラーとして終了するまでの、高水準TCP タイムアウト値を指定します (秒単位)。この値は、ネットワーク・クライアント・マシンのプロセッサー、特にPC のプロセッサーと RAM に依存しています。
-R -k distribution_id
アクティブな配布の配布経路を戻します。 -k distribution_id オプションは、アクティブな配布の配布 ID を指定するために使用します。 -q オプションとは異なり、ソースや宛先のノードを指定する必要はありません。distribution_id の値を取得するには、-L オプションを使用します。
-T [seconds]
リピーター・マネージャーのタイムアウトを指定します。このタイムアウト値は、ターゲットに対する最終処理の配布のあとでエラーが発生したとき、接続が強制終了されるまでの間にリピーター・ノードが処理の完了を待つ最大時間 (秒数) です。最終タイムアウト値がゼロ (0) の場合、タイムアウトがないか、無制限であることを示します。
権限senior
例1. リージョン内の全リピーターのリストを表示するには、次のコマンドを入力します。
wrpt
fuji [1] wd [default]lazzaro [2] -- [2-14,18,20-40]
最初の列では、リピーター名と、それに続いて大括弧内でそのディスパッチャー番号が表示されます。 2 列目の最初のエントリーには、w またはハイフン (-)
を指定します。 w は、エントリーが WAN エントリー・サイトであることを示
wrpt
370 Tivoli Management Framework: リファレンス・マニュアル
します。 2 列目の 2 番目のエントリーが d の場合、エントリーは、そのリージョンのデフォルトのリピーターになります。3 列目は、リピーターがサービスを提供するホストの範囲を表します。範囲が指定されない場合 ([ ])、そのリピーターはそのリージョンで唯一のリピーターになります。
-g オプションを指定すると、wrpt 追加変更オプションの入力オプションのフォーマットに合わせてフォーマットが変更されます。これにより、あとで復元するときにリピーターのレイアウトを取り込むことが容易になります。
2. peppe という配布を取り消す場合は、次のコマンドを入力します。
wrpt -A peppe
3. 次の例では、peppe ホストにリピーターを作成します。
wrpt -n peppe range=2-14,18,20-40
-n peppe は、ホスト peppe を新規リピーターとして指定します。range=2-14,18,20-40 は、新規リピーターの配布範囲となるホスト番号を指定します。ホスト番号は、2 ~ 14、18、20 ~ 40 です。
4. smith という管理対象ノードと jones というエンドポイントとの間での配布経路を表示するには、次のコマンドを入力します。
wrpt -q smith jones
--[RPT:smith [1]]|--[RPT:smith [1]]| |--[RPT:reality [6]]| | |--jones [5]
ノードのラベルまたはオブジェクト ID を指定することもできます。また、管理対象ノードとエンドポイントが同じ名前の場合は、@ManagedNode と@Endpoint という表記を用いることができます。たとえば、smith という同じ名前を持つ管理対象ノードとエンドポイントとの間の配布経路を表示するには、次のコマンドを入力します。
wrpt -q @ManagedNode:smith @Endpoint:smith
--[RPT:smith [1]]|--[RPT:jones [3]]| |--smith [4]
5. アクティブなすべての配布をリストする場合は、ソース・リピーター・マシンから次のコマンドを入力します。
wrpt -L
4 fp_distribute 05 09 16:12:50 2816/0 [640-640]
ここで、4 はそのアクティブな配布を識別する固有の番号で、 fp_distribute
は配布の名前 (アプリケーションによって割り当てられた名前)、 05 09
16:12:50 は配布の開始日時、そして 2816/0 [640-640] は配布の統計を表しています。
saigoの列に示されている統計は、in/est_size [out_min-out_max] というフォーマットで表示されます。ここで、in はリピーターが受け取ったデータの量を示しており、est_size は見積もられる配布のサイズ、out_min は最も遅いターゲットに送られたバイト数、out_max は最も速いターゲットに送られたバイト数を示します。
wrpt
第 3 章 コマンド (アルファベット順) 371
6. peppe リピーターの設定を見たい場合は、次のコマンドを入力します。
wrpt -t peppe
mem_max = 10000disk_max = 50000disk_hiwat = 50000disk_time = 1disk_dir = "C:/TEMP/"net_load = 500max_conn = 100stat_intv = 180
7. 次の例では、アクティブな配布の一意的なプロセス番号を取得して、その番号を使用して配布を呼び出し、プロセスが追加できる最大ネットワーク負荷が 100
KB/秒に変更されます。このコマンドは、この配布のネットワーク負荷のみを変更します。
wrpt -L
l fp_distribute Jun 16 12:53:27 1696/1696 [0-432]
wrpt -k l -t peppe net_load=100
注: peppe は、リピーターが構成される管理対象ノードの名前です。
wrpt
372 Tivoli Management Framework: リファレンス・マニュアル
wrunas
指定されたコマンドを指定されたユーザーとして実行します。そのユーザーのパスワードは指定されたキーを使用してレジストリーから検索されます。
構文wrunas [user_name | key | command]
説明wrunas コマンドは、レジストリーからパスワードを検索し、Microsoft 認証パッケージを使用して、指定されたコマンドを立ち上げます。 wrunas コマンドは、Tivoli デスクトップから実行可能ファイルを立ち上げる際に、タスク・ライブラリー・スクリプトや Tivoli Application Extension Facility (AEF) メソッド・スクリプトで使用できます。これらのスクリプトは、$root_user として稼働するようにインストールする必要があります。
オプションcommand
実行するコマンドを指定します。
key ユーザー名のパスワードを格納するキーを指定します。
user_name
ユーザー名を指定します。
例次の例では、キーが admin_key である場合に、Administrator のパスワードを検索します。
wrunas Administrator admin_key net config workstation
第 3 章 コマンド (アルファベット順) 373
wruninvquery
インベントリー情報をデータベースに照会して、照会基準に一致するマシンのオブジェクト ID とオブジェクト・ラベルのリストを戻します。
構文wruninvquery [-i] [-T idl_type] [-l | -t] query_name [input...]
説明wruninvquery コマンドは照会を実行して、サブスクリプション・リストで使用できる形式でオブジェクト ID とオブジェクト・ラベルのリストを戻します。すべての照会の出力は、SysAdminTypes_ObjectLabelList です。このコマンドを使用するには、TME_OBJECT_ID と TME_OBJECT_LABEL を照会の列リストに指定しなければなりません。照会にこれらの列が指定されていない場合や、照会出力を単にテキスト形式で表示する場合は、wrunquery コマンドを使用します。
wruninvquery コマンドは、次の出力のみを返します。
v 行で区切られたオブジェクト ID のリスト (デフォルト)
v 行で区切られたオブジェクト・ラベルのリスト
v 情報交換用米国標準コード (ASCII) Interface Definition Language (IDL) でエンコードされたバージョンの SysAdminTypes_ObjectLabelList タイプのインスタンス
このコマンドは、限定された入力セットを読み取ることにより、照会結果を狭めることができます。入力を指定すると、照会は照会の結果を入力と結合して、それから両方のリストにある結果だけを返します。次の形式の入力タイプを使用できます。
v スペースで区切られたオブジェクト ID のリスト (デフォルト)
v IDL タイプの ASCII 表現。現在、次の IDL タイプのみが入力として有効です。
– SysAdminTypes_ObjectList
– SysAdminTypes_ObjectLabelList
– TMF_CCMS_subscriber_list
オプション-i 標準入力から、照会入力と、オブジェクト ID および IDL データ・タイプ
の ASCII 表現のどちらかを読み取ります。 -T オプションを指定しないと、入力はオブジェクト ID のスペースで区切られたリストとして解釈されます。 -T オプションを指定した場合、入力は IDL データ・タイプのASCII 表現でなければなりません (idlcall コマンドや idlattr コマンドの場合と似ています)。入力は、標準入力とコマンド行のどちらからでも行うことができますが、同時に両方から行うことはできません。
-l 出力が、改行で区切られたオブジェクト・ラベルのリストであることを指定します。
-t 出力が、IDL 出力結果の ASCII 表現でなければならないことを指定します。
374 Tivoli Management Framework: リファレンス・マニュアル
-T idl_type
IDL データ・タイプの完全名を指定します。標準入力の場合もコマンド行の場合も、入力は IDL データ・タイプの ASCII 表現でなければなりません。
input 照会への入力を指定します。 -T オプションを指定しないと、入力はオブジェクト ID のスペースで区切られたリストとして解釈されます。 -T オプションを指定した場合、入力は IDL データ・タイプの ASCII 表現でなければなりません (idlcall コマンドや idlattr コマンドの場合と似ています)。入力は、標準入力とコマンド行のどちらからでも行うことができますが、同時に両方から行うことはできません。
query_name
実行する照会の名前を指定します。
権限query_execute、admin、senior、または super
例1. 次の例では、AIX-machines 照会を実行して、オブジェクト ID のリストとして出力が書き込まれます。
wruninvquery AIX-machines
1922582407.1.323#TMF_ManagedNode::Managed_Node#555555.1.332#TMF_ManagedNode::Managed_Node#
2. 次の例では、AIX-machines 照会を実行して、オブジェクト・ラベルのリストとして出力が書き込まれます。
wruninvquery -l AIX-machines
manzanoamon-sul
3. 次の例では、AIX-machines 照会を実行して、SysAdminTypes_ObjectLabelList タイプの ASCII エンコード表現として出力が書き込まれます。
wruninvquery -t AIX-machines
{ 2 } 1922582407.1.323#TMF_ManagedNode::Managed_Node# ¥"manzano" { } 555555.1.332#TMF_ManagedNode::Managed_Node# ¥"amon-sul" { }
4. 次の例では、pm1 プロファイル・マネージャーのサブスクライバーを使用してAIX-machines 照会を実行して、出力のラベルのリストが生成されます。
idlcall 555555.1.535#TMF_CCMS::ProfileManager# ¥_get_subscribers | wruninvquery -l -i ¥-T TMF_CCMS::subscriber_list aix-boxes amon-sul
manzano
参照idlattr, idlcall, wcrtqlib, wcrtquery, wgetquery, wrunquery, wsetquery
wruninvquery
第 3 章 コマンド (アルファベット順) 375
wrunjob
タスク・ライブラリー内のジョブを実行します。
構文wrunjob job_name -l library [-a option] [-e name=value] [-i] [-E] [-r] [-Ttransaction_type]
説明wrunjob コマンドは、タスク・ライブラリーにあるジョブを実行します。
オプション-a option
タスクに渡す引き数を指定します。渡される引き数にオプションのフラグと引き数を指定して渡す場合は、両方を引用符で囲みます (たとえば、-a "-o
option")。
-e name=value
タスクの環境変数を設定します (たとえば、DISPLAY=bald:0.0)。
-E すべてのユーザー環境変数をタスクに渡します。
-i タスクの入力オプションを標準入力から読み取ります。
-l library
実行するタスクが入っているタスク・ライブラリーを指定します。
-r ジョブを正常に実行することに失敗したエンドポイントが 1 つでもあれば、エラー・コード 1 を戻します。
-T transaction_type
トランザクション・タイプを指定します。このオプションは、次のいずれかです。
none トランザクションはありません。
revoke取り消し可能なトランザクションです。
sub サブトランザクションです。
top 最上位のトランザクションです。 -T オプションを指定しないと、これがデフォルトになります。
job_name
実行するジョブの名前を指定します。
権限ジョブが作成されたときに指定された役割が必要です。wgetjob コマンドを使用して必要な役割を検索できます。
376 Tivoli Management Framework: リファレンス・マニュアル
例1. 以下の例は、my_tasks タスク・ライブラリーからの date_job ジョブを実行しています。
wrunjob date_job -l my_tasks
###################################################Task Name: date_taskManaged Node: baldReturn Code: 0-------Standard Output-------Mon Nov 21 14:24:16 CST 1998-------Standard Error Output-------####################################################
2. 以下の例は、my_tasks タスク・ライブラリーに入っている date_job ジョブを実行して、German に設定された LANG 変数を使用します。
wrunjob date_job -l my_tasks -e LANG=de
#####################################################Task Name: date_taskManaged Node: baldReturn Code: 0-------Standard Output-------Montag, 21. November 1998 14:25:30 Uhr CST-------Standard Error Output-------#####################################################
3. 次の例は、NoonTide タスク・ライブラリーに入っている ps_vernon ジョブを実行して、aux オプションを渡します。
wrunjob ps_vernon -l NoonTide -a aux
##############################################################Task Name: psTask Endpoint: vernon (ManagedNode)Return Code: 0------Standard Output------USER PID %CPU %MEM SZ RSS TT STAT START TIME COMMANDroot 2245 54.5 6.2 360 2368 ? S 13:10 0:02 task_endpointroot 2246 19.7 1.3 228 488 ? R 13:10 0:00 /tmp/ taskAAAa02245 auxnobody 2244 14.6 5.2 176 1992 ? S 13:10 0:01 man_node_skel1nobody 2239 12.2 7.3 568 2800 ? S 13:10 0:02 repository_ skel1root 134 8.4 2.9 1508 1100 ? S Apr 19 0:41 oserv -p -k /usr/Tivonobody 2237 3.5 5.7 184 2188 ? S 13:10 0:01 library_ skel1root 2236 1.1 5.5 120 2108 p0 S 13:09 0:01 wrunjob ps_vernon -l Nooroot 172 0.0 1.8 136 684 ? S Apr 19 0:02 ./usrlnkd------Standard Error Output------###############################################################
参照wcrtjob, wcrttask, wgetjob
wrunjob
第 3 章 コマンド (アルファベット順) 377
wrunquery
照会を実行して、結果を標準出力とファイルのどちらかに戻します。
構文wrunquery [-n] [[-h host_name] -f file_name] [-d delimiter] query_name
説明wrunquery コマンドは照会を実行して、結果を表示したりファイルに保管できるようにします。デフォルトでは、wrunquery コマンドは出力を標準出力に返します。サブスクリプション・リストで使用するためにオブジェクト ID とオブジェクト・ラベルのリストを取得するには、wruninvquery コマンドを使用します。
オプション-d delimiter
出力ファイルのエントリーを区切るための区切り文字を指定します。デフォルトの区切り文字はコンマです。
-f file_name
照会結果の格納先ファイルのパスと名前を指定します。
-h host_name
照会結果の格納先管理対象ノードの名前を指定します。管理対象ノードを指定しないと、ファイルはローカル・マシンに保管されます。
-n 出力からヘッダーを省略します。
query_name
実行する照会の名前を指定します。
権限query_execute、RIM_view、 admin、senior、もしくは super
例次のコマンドは、Operating-systems 照会を実行して、その出力を管理対象ノードamon-sul 上の query.txt ファイルに送信します。出力ファイルにはヘッダーが含まれています。項目はセミコロンで区切られています。
wrunquery -h amon-sul -f query.txt -d ";" Operating-systems
query.txt ファイルの内容は、次のとおりです。
Query Name Operating-systemsNumber of rows: 9BOOTED_OS_VERSION_TYPE BOOTED_OS_NAME PROCESSOR_SPEED3.2;AIX;UNKNOWN3.2;AIX;UNKNOWN3.2;AIX;UNKNOWN4.1;AIX;UNKNOWN4.1;AIX;UNKNOWN
378 Tivoli Management Framework: リファレンス・マニュアル
3.10;Windows 25;486 DX3.10;Windows 25;486 DX3.10;Windows 33;486 DX3.10;Windows 133;Intel Pentium
参照wcrtqlib, wcrtquery, wgetquery, wruninvquery, wsetquery
wrunquery
第 3 章 コマンド (アルファベット順) 379
wruntask
タスク・ライブラリーのタスクを実行します。
構文wruntask -t task_name -l library_name {-h node... | -p profile_mgr...} [-a option]
[-e name=value] [-i] [-E] [-T trans_type] [-M mode [-s interval] [-n number] [-r] [-mtimeout] [-o output_format]
説明wruntask コマンドは、タスク・ライブラリーのタスクを実行します。実行するタスクは、あらかじめ作成されたものでなくてはなりません。
オプション-a option
タスクに渡す引き数を指定します。渡される引き数にオプションのフラグと引き数を指定して渡す場合は、両方を引用符で囲みます。たとえば、次のような構文があるとします。
-a "-o option"
-a オプションは、指定するノードごとに繰り返し指定してください。たとえば、次のような構文があるとします。
-a "-h node" -a "-p profile_mgr"
-e name=value
タスクの環境変数を設定します。 -e オプションは、指定する環境変数ごとに繰り返し指定してください。たとえば、次のような構文があるとします。
-e DISPLAY=bald:0.0 -e COLOR=red
-E 現在のシェルで設定されているすべての環境変数をタスクに渡します。
-h node...
タスクを実行するノード (管理対象ノードまたはエンドポイント) を指定します。最低でも 1 つのノードか、1 つのプロファイル・マネージャーを指定しなければなりません (オプション -p を使用)。 -h オプションは、指定する各ノードごとに繰り返し指定してください。たとえば、次のような構文があるとします。
-h vernon -h everest -h fuji
-i 標準入力を読み取って、タスクの標準入力としてタスクに渡します。
-l library_name
実行するタスクが入っているタスク・ライブラリーを指定します。
-m timeout
タスク・ライブラリーが、タスクから結果が返されるのを待つ秒数を指定します。このオプションは、管理対象ノード上でタスクの実行には影響しません。オプション -m を使用しない場合、デフォルトのタイムアウトは 60
秒です。
380 Tivoli Management Framework: リファレンス・マニュアル
注: エンドポイントに対してタスクを実行する場合、タスクのタイムアウト値はゲートウェイのタイムアウト値よりも大きい値を設定する必要があります。たとえば、タスクのタイムアウト値が 600、ゲートウェイのタイムアウトが 300 に設定されている場合、タスクは 300 秒後に失敗します。
-M mode
どのモードでタスクを実行するかを指定します。有効なオプションは次のとおりです。
parallel指定したすべての管理対象ノードとすべてのサブスクライバー上で、タスクを同時に実行します。オプション -M を指定していない場合は、これがデフォルトになります。
serial 一度に 1 つの管理対象ノードまたはエンドポイントでタスクを実行します。
staged指定した間隔で、設定した数の管理対象ノードおよびエンドポイントでタスクを実行します。このモードを指定する場合は、-n および-s オプションを使用する必要があります。
-n number
各ステージでタスクを実行するノード (管理対象ノードまたはエンドポイント) の数を指定します。 -M staged オプションを使用する場合、このオプションの値を指定しなければなりません。ノードの最大数は 150 です。
-o output_format
タスク出力の形式を定義します。タスクの実行出力の形式を、0 ~ 17 の 8
進数で指定します。希望する出力の値を加算して、出力の形式を構成します。たとえば、戻りコードを標準出力に出力するには、-o 05 と指定します。ファイルに出力するには、標準のリダイレクト構文を使用します。出力値は次のとおりです。
01 各レコードの記述ヘッダーを出力します。
02 戻りコードを出力します。
04 標準出力を出力します。
08 標準エラー出力を出力します。
-p profile_mgr...
タスクを実行するプロファイル・マネージャーを指定します。最低でも 1
つのプロファイル・マネージャーか、1 つのノードを指定しなければなりません (オプション -h を使用)。 -p オプションは、指定するプロファイル・マネージャーごとに繰り返し指定してください。たとえば、次のような構文があるとします。
-p pm1 -p pm2 -p pm3
-r ジョブを正常に実行することに失敗したエンドポイントが 1 つでもあれば、エラー・コード 1 を戻します。
-s interval
管理対象ノードのあるグループでタスクを実行してから、次のグループで実
wruntask
第 3 章 コマンド (アルファベット順) 381
行するまでの秒数を指定します。この間隔は、最初のグループが終了してからの間隔です。 -M staged オプションを使用する場合、このオプションの値を指定しなければなりません。
-t task_name
実行するタスクの名前を指定します。
-T trans_type
トランザクション・タイプを指定します。トランザクション・タイプについての詳細については、 8ページの『Tivoli トランザクション』を参照してください。このオプションは、次のいずれかです。
none トランザクションはありません。
revoke取り消し可能なトランザクションです。
sub サブトランザクションです。
top 最上位のトランザクションです。 -T オプションを指定しないと、これがデフォルトになります。
権限タスクが作成されたときに指定された役割が必要です。タスクのターゲットが属するリージョンでこの役割を持っていなくてはなりません。 wgettask コマンドを使用して必要な役割を検索できます。
例1. 以下の例は、date_task タスクを、ノード bald および fuji 上で実行します。このタスクは my_tasks タスク・ライブラリーに入っています。
wruntask -t date_task -l my_tasks -h bald -h fuji
#####################################################Task Name: date_taskManaged Node: baldReturn Code: 0-------Standard Output-------Mon Nov 21 10:49:34 CST 1998-------Standard Error Output-------#####################################################Task Name: date_taskManaged Node: fujiReturn Code: 0-------Standard Output-------Mon Nov 21 10:49:45 CST 1998-------Standard Error Output-------#####################################################
2. 以下の例は、date_task2 タスクをノード bald で実行します。このタスクはmy_tasks タスク・ライブラリーに入っています。このタスクの出力は、標準出力です。
wruntask -t date_task2 -l my_tasks -h bald -o 04
#####################################################Mon Nov 21 10:50:47 CST 1998#####################################################
wruntask
382 Tivoli Management Framework: リファレンス・マニュアル
3. 以下の例は、ps タスクをノード vernon で実行します。このタスクは NoonTide
タスク・ライブラリーに入っています。この例では、aux オプションをタスクに渡します。
wruntask -t ps -l NoonTide -h vernon -a aux
############################################################Task Name: psTask Endpoint: vernon (ManagedNode)Return Code: 0------Standard Output------USER PID %CPU %MEM SZ RSS TT STAT START TIME COMMANDroot 2245 54.5 6.2 360 2368 ? S 13:10 0:02 task_endpointroot 2246 19.7 1.3 228 488 ? R 13:10 0:00 /tmp/ taskAAAa02245 auxnobody 2244 14.6 5.2 176 1992 ? S 13:10 0:01 man_node_ skel1nobody 2239 12.2 7.3 568 2800 ? S 13:10 0:02 repository_ skel1root 134 8.4 2.9 1508 1100 ? S Apr 19 0:41 oserv -p 94 ¥-k /usr/Tivonobody 2237 3.5 5.7 184 2188 ? S 13:10 0:01 library_skel1root 2236 1.1 5.5 120 2108 p0 S 13:09 0:01 wrunjob ps_ vernon -l Nooroot 172 0.0 1.8 136 684 ? S Apr 19 0:02 ./usrlnkd------Standard Error Output------###############################################################
参照wcrtjob, wcrttask, wgettask
wruntask
第 3 章 コマンド (アルファベット順) 383
wschedjob
タスク・ライブラリーに入っているジョブをスケジューリングします。
構文wschedjob -n name -L library_name -t ″mm/dd/yyyy hh:mm″ [-c ’time_period’] [-Cdaytime | nighttime | weekday | weekend from to] [-D] [-d desktop] [-f file -hhost] [-g group] [-l label] [-m email] [-o] [-r ’time_period’ | ’iterations’] [-R’time_period’ | ’iterations’] [-s description]
説明wschedjob コマンドによって、アドミニストレーターはジョブをスケジューリングできます。タスク・ライブラリーにあるジョブだけをコマンド行からスケジューリングできます。
アドミニストレーターは、ジョブを実行するための正しい許可を受けていなければなりません。ジョブが実行されるときにアドミニストレーターが正しい許可を受けていない場合、ジョブは失敗します。ジョブをスケジューリングする前に、アドミニストレーターはジョブを手動で実行して (たとえば wrunjob コマンドを使用して) 適切な許可を受けていることを検証する必要があります。
オプション-c ’time_period’
スケジュールのとおりにジョブが開始されない場合にジョブがキャンセルされる時点を指定します。数値 (時間) と時間の単位を指定しなければなりません。時間の単位は、minute、hour、day のいずれかです。たとえば「3
hour」と指定した場合、ジョブは、元々スケジューリングされている開始時間から 3 時間後に取り消されます。
-C daytime | nighttime | weekday | weekend from to
ジョブの実行に関する条件または制約事項を指定します。 from オプションは、開始日または開始時刻です。 to オプションは、終了日と終了時刻のどちらかです。時刻は、24 時間時計で入力する必要があります (たとえば、午前 9 時は 9:00、午後 2 時は 14:00)。曜日は数値で入力する必要があります。日曜日は 0、土曜日は 6 になります。有効なオプションは次のとおりです。
’daytime from to’
日中、from 時から to 時までの間だけジョブを実行するように指定します。
’nighttime from to’
夜間、from 時から to 時までの間だけジョブを実行するように指定します。
’weekday from to’
平日の from 曜日から to 曜日までの間だけジョブを実行するように指定します。
384 Tivoli Management Framework: リファレンス・マニュアル
’weekend from to’
週末の from 曜日から to 曜日までの間だけジョブを実行するように指定します。
-d desktop
ジョブで処理が実行されたときに「状況」ウィンドウの表示先となるデスクトップを指定します。複数のデスクトップを指定できます。
-D ジョブを無効にします。ジョブはスケジューラー内に残されたままですが、使用可能になるまで実行されません。
-f file ジョブで処理が実行されたときのジョブ状況の書き込み先ファイルを指定します。ファイルを指定する場合、-h を使用してホストを指定しなければなりません。
-g group
ジョブで処理が実行されたときに、ジョブ状況の送信先となる通知グループを指定します。複数の通知グループを指定できます。
-h host
ジョブ状況ファイルの書き込み先ホストを指定します。 -f オプションと同時に指定しなければなりません。
-l label
ジョブのこのインスタンスに固有の名前を指定します。
-L library_name
ジョブが入っているタスク・ライブラリーの名前を指定します。このオプションは必須です。
-m email
ジョブで処理が実行されたときに、ジョブ状況の送信先となる電子メール・アドレスを指定します。複数の電子メール・アドレスを指定できます。
-n name
スケジューリングされる、タスク・ライブラリー内のジョブの名前を指定します。このオプションは必須です。
-o -t オプションで示された時刻が過去であることを指定します。警告メッセージは上書きされます。
-r ’time_period’ | ’iterations’
反復情報を指定します。iterations オプションを指定した場合は、ジョブは有限回数繰り返されます。時間の単位は、ローカル側の言語で指定する必要があります。
’time_period’ ジョブを再試行する間隔を指定します。数値 (時間) と時間の単位を指定しなければなりません。時間の単位は、minute、hour、day、week、month、year のいずれかです。たとえば ’3 hour’ と指定すると、ジョブは 3 時間おきに繰り返されます。
’iterations’ ジョブを繰り返す回数を指定します。時間、時間の単位、回数を指定しなければなりません。時間の単位は、minute、
wschedjob
第 3 章 コマンド (アルファベット順) 385
hour、day、week、month、year のいずれかです。たとえば’3 hour 6’ と指定した場合、ジョブは、3 時間ごとに 6 回再試行されます。
-R ’time_period’ | ’iterations’
再試行情報を指定します。iterations オプションを指定した場合は、ジョブは有限回数再試行されます。
’time_period’
ジョブを繰り返す間隔を指定します。数値 (時間) と時間の単位を指定しなければなりません。時間の単位は、minute、hour、day のいずれかです。たとえば ’3 hour’ と指定すると、ジョブは 3 時間おきに再試行されます。
’iterations’
ジョブを再試行する回数を指定します。時間、時間の単位、回数を指定しなければなりません。時間の単位は、minute、hour、day のいずれかです。たとえば ’3 hour 6’ と指定した場合、ジョブは、3
時間ごとに合計 6 回試行されます。
-s description
ジョブを記述します。記述が複数の語句になる場合は、全体を引用符で囲む必要があります。
-t ″mm/dd/yyyy hh:mm″ジョブ実行が最初にスケジューリングされる時刻を指定します。このオプションは必須です。
権限スケジューラー・リソース用には admin
例1. 次の例では、タスク・ライブラリー Holiday のジョブ SendWishList をスケジューリングします。ジョブは 1998 年 12 月 24 日の午前 6 時に実行されます。ジョブで処理が実行されると、ジョブ状況メッセージが E メール・アドレス[email protected] に送信されます。
wschedjob -t "12/24/1998 6:00" -m [email protected] -L ¥Holiday -n SendWishList
2. 次の例では、タスク・ライブラリー Holiday のジョブ SendWishList をスケジューリングします。ジョブは 1998 年 12 月 24 日の午前 6 時に実行されます。この例では、ジョブで処理が実行されると、ジョブ状況メッセージが E メール・アドレス [email protected] 、[email protected]、および [email protected] に送信されます。ジョブは 5 分おきに繰り返されます。ジョブが失敗すると、失敗の 1 分後に 1 度再試行されます。
wschedjob -t "12/24/1998 6:00" -m [email protected] ¥-L Holiday -n SendWishList -r ’5 minute’ ¥-m [email protected] -m [email protected] -R ’1 minute 1’
3. 次の例は、タスク・ライブラリー MakeToys のジョブ nice_list をスケジューリングします。ジョブは月曜から金曜の午後 10 時に実行されます。
wschedjob -t "3/4/1996 22:00" -L MakeToys -n nice_list ¥-r ’1 day’ -C ’weekday 1 5’
wschedjob
386 Tivoli Management Framework: リファレンス・マニュアル
参照wdelsched, wedsched, wenblsched, wgetsched
wschedjob
第 3 章 コマンド (アルファベット順) 387
wserver
UNIX マシンに TMR サーバーをインストールします。
構文wserver -c cdrom_path [-a server_name] [-d] [-P] [-p path_prefix[!]]
[install_variable=value...]
説明wserver コマンドは、Tivoli リージョン用の初期 Tivoli サーバーサーバーをインストールします。次の 2 つのインストール・モードをサポートしています。X11 ベースのインストールと、コマンド行のみのインストールです。 X11 ベースのインストールを使用するには、DISPLAY 環境変数が設定されていて、DOGUI 環境変数が設定されていないことを確認します。コマンド行のみのインストールを使用するには、DOGUI 環境変数が no に設定されていることを確認します。デフォルトでは、X11 バージョンのインストールが選択されます。いずれの場合でも、現行ディレクトリーを installation_directory ディレクトリーに変更します。これは、wpreinst.shスクリプトの実行または file0.tar ファイルの解凍を行うディレクトリーです。あるいは、BINDIR 環境変数 を install_directory に設定することもできます。
オプション-a server_name
Tivoli サーバーの名前を指定します。ローカルのホスト名とリモートのホスト名のどちらかを指定します。デフォルトでは、ローカルのホスト名です。ホスト名の長さが 8 文字を超えるシステムでは、hostname コマンドがunknown を戻す場合もあります。このオプションを指定すると、振る舞いを修正できます。
注: ローカル・ホストにインストールしていて完全修飾ホスト名を指定する場合は、ローカルの /.rhosts ファイルを更新して適正なリモート・アクセスを使用可能にしておく必要があります。
-c cdrom_path
CD-ROM イメージへのパスを指定します。
-d インストール変数 (install_variable) をデフォルト値に設定します。このフラグは、コマンド行バージョンにのみ使用します。すべてのオプションと環境変数を選択するのでない限り、このオプションを指定してください。
-p path_prefix[!]
パス・プレフィックスをデフォルトのインストール・パスの先頭に追加します。オプションの感嘆符 (!)があると、path_prefix は、デフォルトのインストール・パスの最後の部分だけの前に付加されます。たとえば、バイナリーのデフォルトのインストール・パスは、/usr/local/Tivoli/bin です。 -p
/Tivoli を指定すると、インストール・パスは /Tivoli/usr/local/Tivoli/bin になります。 -p /Tivoli! を指定すると、パスは /Tivoli/bin になります。
388 Tivoli Management Framework: リファレンス・マニュアル
-P トラステッド・ホスト・アクセスではなく、グローバル・ルート・パスワードを使用するよう指定します。このオプションは、リモート・ホストにインストールする場合にのみ使用します。
install_variable=value
インストールをコントロールする変数を指定します。この変数には、コマンド行で値を設定できるものやデフォルト値を使用できるものがあります。X11 バージョンを使用している場合は、インストール時にこれらの値を変更できます。コマンド行からインストールする場合には、コマンド行で変数を渡すのが値を設定する唯一の方法です。必要な情報の指定またはデフォルト情報の指定変更には、インストール変数を使用します。
注: インストール・オプションの名前は、資料に示されているとおり正確に入力してください。インストール・オプションは、大文字小文字を区別します。
インストール変数の一部は、Tivoli サーバーのインストール先ディレクトリーを指定します。以前のインストールによるファイルがディレクトリーにすでに入っている場合、コマンドは、それらのファイルを再コピーしません。指定したディレクトリーの後に ! 文字を入力すると、これらのディレクトリーに強制的に再インストールすることもできます。ディレクトリーに関連するインストール変数を次に示します。
BIN=binaries_dir
Tivoli Management Framework バイナリーのデフォルトのインストール・パス (/usr/local/Tivoli/bin) を変更します。
LIB=libraries_dir
Tivoli Management Framework ライブラリーのデフォルトのインストール・パス (/usr/local/Tivoli/lib) を変更します。
ALIDB=server_database_dir
Tivoli Management Framework サーバー・データベースのデフォルトのインストール・パス (/var/spool/Tivoli) を変更します。
MAN=manpage_dir
Tivoli Management Framework マニュアル・ページのデフォルトのインストール・パス ( /usr/local/Tivoli/man) を変更します。
APPD=X11_dir
X11 アプリケーション・デフォルトのデフォルトのインストール・パス (/usr/lib/X11/app-defaults) を変更します。
CAT=message_catalog_dir
Tivoli Management Framework メッセージ・カタログのデフォルトのインストール・パス (/usr/local/Tivoli/msg_cat) を変更します。
その他のインストール変数を次に示します。
@EL@=None | Simple | DESサーバーをインストールするときに使用する暗号化レベルを定義します。デフォルト・レベルは Simple です。
@ForceBind@=yes | no通信接続を強制して、単一のインターネット・プロトコル (IP) アド
wserver
第 3 章 コマンド (アルファベット順) 389
レスにバインドします。このオプションは、特定の高可用性またはフェイルオーバー構成で使用されます。この場合、多重オブジェクト・ディスパッチャーは 1 つの物理システム上の異なる IP アドレスにあります。
AutoStart=0 | 1システムのブート時に Tivoli デーモンを開始するかどうかを指定します。デフォルトでは、デーモンは開始されません。
CreatePaths=0 | 1指定したディレクトリーがない場合に、このディレクトリーを作成する (1) かどうかを指定します。デフォルトでは、ディレクトリーを作成します。 install_variable で指定されたディレクトリーが存在しないと、エラーが発生します。
IP=install_password
インストール・パスワードを設定します。デフォルトでは、パスワードはありません。このパスワードは、Tivoli Management
Framework をクライアントにインストールする場合にはインストール・パスワードです。暗号化を使用するときはデフォルトのシードで、暗号化を使用して Tivoli リージョンに接続するときにはリージョン間パスワードです。
LK=license_key
ライセンス・キーを指定します。このインストール変数に指定された値は無視されます。
RN=region_name
デフォルトのポリシー・リージョン名を変更します。デフォルトのポリシー・リージョン名は、後から変更できます。
SetPort=0 | 1Tivoli デーモンのリモート開始機能を設定するかどうかを指定します。デフォルトでは、この機能は設定されません。
権限インストール先システムでの root アクセス
ファイル/tmp/tivoli.sinstall
前回インストールを行ったときの詳細なデバッグ情報が入っています。
/tmp/install.cfg.error /tmp/install.cfg.outputTMR サーバー・データベースの初期化中に作成される一時ファイルです。初期化に成功すると、初期化後にこれらのファイルは削除されます。
/etc/Tivoli/setup_env.shインストール後に、Bourne シェルと互換性のあるシェルから読み込むことができるファイルです。これには有効なシェル環境変数が入っています。
/etc/Tivoli/setup_env.cshインストール後に、C シェルと互換性のあるシェルから読み込むことができるファイルです。これには有効なシェル環境変数が入っています。
wserver
390 Tivoli Management Framework: リファレンス・マニュアル
環境変数環境変数には、インストールに関連して次のような意味があります。
DISPLAYインストールに使用する X11 ディスプレイを指定します。
DOGUI$DISPLAY 変数値以外を設定すると、コマンド行バージョンが使用されます。
EtcTivoliデフォルトは /etc/Tivoli ディレクトリーです。指定変更しないでください。
BINDIRinstall_dir ディレクトリー (wpreinst.sh コマンドを実行したディレクトリーまたは file0.tar ファイルを解凍したディレクトリー) からこのコマンドを実行しない場合は、この変数を install_dir ディレクトリーに設定できます。
o_dispatchデフォルトのポートは 94 です。指定変更しないでください。
SAVE_CFG_FILESTivoli サーバーの初期化中に使用するデバッグ・ファイル/tmp/install.cfg.output と /tmp/install/cfg.error は、インストールが成功すると削除されます。そのまま保持する場合、この変数を非空文字の値に設定します。
注: Tivoli Management Framework を UNIX オペレーティング・システム上にインストールすると、 /tmp/.tivoli ディレクトリーが作成されます。 このディレクトリーには、オブジェクト・ディスパッチャーのプロセスで必要なファイルが含まれます。 Tivoli サポート提供者からはっきりとした指示がない限りは、このディレクトリーまたディレクトリーのいかなる内容も削除しないでください。一定の間隔でスケジュールされたディスクのクリーンアップ・ジョブ (cron
または Tivoli ジョブ) が、このディレクトリーやその内容を除去することのないようにしなければなりません。
別のディレクトリーを使用するには、オブジェクト・ディスパッチャーおよびシェル内の両方の環境変数を設定する必要があります。 Tivoli Management
Framework をインストールしてから、以下のステップを実行して必要な環境変数を設定します。
1. ディレクトリーの作成。このディレクトリーには、少なくともパブリックの読み取り許可および書き込み許可が必要です。しかし、完全な許可を定義し、スティッキー・ビットを設定して、他のユーザーが自分の所有していないファイルを変更できないようにしてください。
2. ディスパッチャー内の環境変数を設定します。
a. 次のコマンドを入力してください。
odadmin environ get > envfile
b. 次の行を envfile ファイルに追加して保管します。
TIVOLI_COMM_DIR=new_directory_name
c. 次のコマンドを入力してください。
odadmin environ set < envfile
wserver
第 3 章 コマンド (アルファベット順) 391
3. Tivoli 提供の /etc/Tivoli ディレクトリー内の setup_env.csh、setup_env.sh、および oserv.rc ファイルを編集して、TIVOLI_COMM_DIR 変数を設定します。
4. HP-UX および Solaris システムの場合には、オブジェクト・ディスパッチャーを開始するファイルに以下の行を追加します。
TIVOLI_COMM_DIR=new_directory_name
この行を、オブジェクト・ディスパッチャーを開始する前に実行する部分で、他の環境変数が設定されている近辺の行に挿入します。 以下のリストには、各オペレーティング・システムで変更が必要なファイルが示されています。
v HP-UX オペレーティング・システム: /sbin/init.d/Tivoli
v Solaris オペレーティング環境: /etc/rc3.d/S99Tivoli
5. 以下のコマンドを入力して、オブジェクト・ディスパッチャーをシャットダウンします。
odadmin shutdown all
6. 以下のコマンドを入力して、Tivoli サーバー上のオブジェクト・ディスパッチャーを再始動します。
odadmin reexec 1
7. 以下のコマンドを入力して、管理対象ノード上のオブジェクト・ディスパッチャーを再始動します。
odadmin reexec clients
例次の例は、コマンド行によるインストールを示したものです。 DOGUI 環境変数はno 設定されています。X11 バージョンのインストールの場合もほぼ同様です。
1. 次の例では、ローカル・マシンに Tivoli サーバーがインストールされます。CD-ROM イメージへの完全パスは、/cdrom/cdrom0 です。バイナリーは、/Tivoli/bin にインストールされます。ライブラリーは、/Tivoli/lib にインストールされます。サーバー・データベースは、/Tivoli/database にインストールされます。マニュアル・ページは、/Tivoli/man にインストールされます。 X11 デフォルトは /Tivoli/X11 にインストールされます。メッセージ・カタログは、/Tivoli/cat にインストールされます。デフォルトのポリシー・リージョンは、NoonTide-Region という名前で作成されます。 Tivoli デーモンは、システムのブート時に自動的に開始されます。 Tivoli デーモンのリモート開始機能が構成されます。指定したディレクトリーが存在していない場合は、そのディレクトリーが作成されます。インストール・パスワードは Tivoli4Ever に設定されます。デフォルトの暗号化レベルは使用されません。
./wserver -c /cdrom/cdrom0 BIN=Tivoli/bin ¥LIB=Tivoli/lib ALIDB=/Tivoli/database MAN=/Tivoli/man ¥APPD=/Tivoli/X11 CAT=/Tivoli/cat RN=NoonTide-Region ¥AutoStart=1 SetPort=1 CreatePaths=1 IP=Tivoli4Ever
注: この Tivoli サーバーを再インストールするには、強制インストールによって、 Tivoli データベースが入っているディレクトリーを上書きする必要があります (ALIDB=!)。 . その他のディレクトリーも、オプションで上書きできます。既存のディレクトリーを上書きするためのインストールを強制実行
wserver
392 Tivoli Management Framework: リファレンス・マニュアル
するには、感嘆符 (!) を使用してください。次の例では、前出のコマンドでインストールされた Tivoli サーバーを再インストールし、各ディレクトリーを上書きします。
./wserver -c /cdrom/cdrom0 ¥BIN=! LIB=! ALIDB=! MAN=! APPD=! CAT=! ¥RN=NoonTide-Region AutoStart=1 ¥SetPort=1 CreatePaths=1 IP=Tivoli4Ever
2. 次の例では、ローカル・マシンに Tivoli サーバーがインストールされます。CD-ROM イメージへの完全パスは /cdrom です。バイナリーは、/Tivoli/bin にインストールされます。ライブラリーは、/Tivoli/lib にインストールされます。サーバー・データベースは、/Tivoli/database にインストールされます。マニュアル・ページは、/Tivoli/man にインストールされます。デフォルトのポリシー・リージョンは、NoonTide という名前で作成されます。
wserver -c /cdrom -d -p /Tivoli! ALIDB=/database ¥RN=NoonTide
3. 次の例では、ローカル・マシンに Tivoli サーバーがインストールされます。CD-ROM イメージへの完全パスは /cdrom です。バイナリーは、/Tivoli/bin にインストールされます。ライブラリーは、/Tivoli/lib にインストールされます。サーバー・データベースは、/Tivoli/database にインストールされます。マニュアル・ページは、/Tivoli/man にインストールされます。デフォルトのポリシー・リージョンは、NoonTide という名前で作成されます。
wserver -c /cdrom BIN=/Tivoli/bin LIB=/Tivoli/lib ¥ALIDB=/Tivoli/database MAN=/Tivoli/man RN=NoonTide
4. 次の例では、ローカル・マシンに Tivoli サーバーがインストールされます。CD-ROM イメージへの完全パスは /cdrom です。すべて (バイナリー、ライブラリーなど) は、ユーザーの指定したディレクトリー /Tivoli の下のデフォルトの位置にインストールされます。
wserver -c /cdrom -d
5. 次の例では、cook というリモート・マシンに Tivoli サーバーがインストールされます。 CD-ROM イメージへの完全パスは、/cdrom です。このパスは、ローカル・マシンとリモート・マシンの両方からアクセスできなければなりません。ユーザーは、マシン cook の root パスワードを入力するよう指示されます。すべて (バイナリー、ライブラリーなど) は、デフォルトの位置にインストールされます。
wserver -c /cdrom -P -d -a cook
参照wclient, winstall
wserver
第 3 章 コマンド (アルファベット順) 393
wsetadmin
Tivoli アドミニストレーターに関する情報を変更します。
構文wsetadmin [-L login] [-l login] [-n notice_group] [-N notice_group] [-R group] [-rgroup,role:role...] name
説明wsetadmin コマンドは、既存の Tivoli アドミニストレーターの選択プロパティーを変更します。このコマンドにより、ログインの追加/除去、通知グループ・サブスクリプションの追加/除去、および許可グループ役割の変更を行うことができます。
注: このコマンドを使用してユーザー名、グループ名、またはアドミニストレーター・アイコンのラベルを変更することはできません。これらの変更は Tivoli デスクトップから行わなければなりません。
オプション-l login
指定したログインを追加します。
-L login
指定したログインを削除します。
-n notice_group
サブスクリプションを通知グループに追加します。
-N notice_group
通知グループからサブスクリプションを削除します。
-r group,role:role
指定されたグループ内のアドミニストレーターの役割を、指定された役割に変更します。 group の有効なフォーマットの例を次に示します。
v @Administration
v @PolicyRegion:Administration
v /Regions/PolicyRegion:Administration
-R group
グループ内のアドミニストレーターのすべての役割を削除します。
name プロパティーを変更するアドミニストレーターの名前を指定します。
権限senior または super
例1. 次の例では、アドミニストレーター Steve Callahan の情報が変更されます。
Accounting ポリシー・リージョン内のアドミニストレーターの役割は、admin
394 Tivoli Management Framework: リファレンス・マニュアル
です。このアドミニストレーターは、Tivoli Authorization 通知グループからサブスクリプション解除されます。また、ログイン callahan@teton が追加されます。
wsetadmin -r @Accounting,admin -N "Tivoli Authorization" ¥-l callahan@teton "Steve Callahan"
2. 次の例では、再度アドミニストレーター Steve Callahan の情報が変更されます。この例では、Accounting ポリシー・リージョン内のこのアドミニストレーターの権限が削除されます。Tivoli Authorization 通知グループへのサブスクリプションを追加して、ログイン callahan@teton が削除されます。
wsetadmin -R @Accounting -n "Tivoli Authorization" ¥-L callahan@teton "Steve Callahan"
参照wcrtadmin, wgetadmin
wsetadmin
第 3 章 コマンド (アルファベット順) 395
wsetdfpol
管理対象オブジェクト・クラスのデフォルト・ポリシー・オブジェクトを設定します。
構文wsetdfpol -d class label
wsetdfpol -v class label
説明wsetdfpol コマンドは、管理対象ノード・クラスのデフォルト・ポリシー・オブジェクトを設定します。デフォルト・ポリシー・オブジェクトとは、デフォルトのポリシー・オブジェクトと検証ポリシー・オブジェクトのことです。これらのポリシー・オブジェクトは、現行のポリシー・リージョンに関するものです。管理対象オブジェクト・クラスがポリシー・リージョンに追加されると、そのポリシー・リージョンは指定されたデフォルト・ポリシー・オブジェクトを受け取ります。ポリシー・デフォルト・オブジェクトは、ポリシー・リージョン内で作成されたリソースに、デフォルトの属性値を生成します。 ポリシー検証オブジェクトは、管理対象オブジェクト・クラスの属性値を検証します。
オプション-d デフォルト・オブジェクトのデフォルト・ポリシーを設定します。
-v 検証オブジェクトのデフォルト・ポリシーを設定します。
class デフォルト・ポリシー・オブジェクトについて設定するクラスを指定します。
label 希望するポリシー・オブジェクトのラベルを指定します。
権限admin、senior、super
例次の例では、ProfileManager クラスに対するデフォルトのポリシー検証オブジェクトとして、ポリシー検証オブジェクト Restricted が作成されます。
wsetdfpol -v ProfileManager Restricted
参照wgetdfpol
396 Tivoli Management Framework: リファレンス・マニュアル
wseterr
構成プログラム用のバッチ・ファイルからの戻りコードを設定します。このコマンドはエンドポイントから実行する必要があります。
構文wseterr return_code
説明wseterr コマンドは、構成プログラムとして起動されるバッチ・ファイルの戻りコードを設定します。呼び出し側の Tivoli Enterprise 製品に対して正しいコードが戻るようにするために、すべてのバッチ・ファイルの最後にこのコマンドを使用してください。
オプションreturn_code
対象の戻りコードを指定します。
第 3 章 コマンド (アルファベット順) 397
wsetjob
ジョブのプロパティーを設定します。
構文wsetjob -j job_name -l library_name [-t task_name] [-M mode] [-s interval -nnumber] [-m timeout] [-o output_format] [-D] [-d node_name -f file_name] [-hnode_name] [-p profile_manager_name] [-N] [-X]
説明wsetjob コマンドは、指定したタスクを使用してジョブのプロパティーを設定します。
オプション-d node_name
ジョブ出力の保管先管理対象ノードを指定します。
-D ジョブ出力をデスクトップに表示します。
-f file_name
ジョブ出力の保管先ファイル名を指定します。
-h node_name
ジョブの実行先の管理対象ノードを指定します。
-j job_name
作成されるジョブの名前を指定します。
-l library_name
ジョブに含まれるタスクが入っているタスク・ライブラリーを指定します。
-m timeout
結果がタスクから戻されるまでタスク・ライブラリーが待つ秒数を指定します。 staged モードを使用している場合、timeout は interval より小さくなければなりません。
-M mode
ジョブの実行時のモードを指定します。有効なオプションは次のとおりです。
parallel一度に 1 つの管理対象ノード上のジョブを実行します。
serial 指定したすべての管理対象ノードとサブスクライバーで同時にジョブを実行します。
staged指定した間隔で、管理対象ノードのグループでジョブを実行します。 staged モードを指定する時は、-s、-n、および -m オプションも指定する必要があります。
398 Tivoli Management Framework: リファレンス・マニュアル
-n number
staged モードの各グループでの管理対象ノードの数を指定します。staged モードを選択した場合、このオプションの値を指定しなければなりません。
-N ジョブ出力のファイルへの書き込みを使用不可にします。
-o output_format
ジョブ出力の形式を定義します。ジョブ出力には、各管理対象ノード上でのジョブの要約があります。ジョブ出力の形式は、0 ~ 15 の数で指定します。形式は、以下の値の論理和で構成されます。
1 各レコードの記述ヘッダーを出力します。
2 ジョブの戻りコードを出力します。
4 標準出力を出力します。
8 標準エラー出力を出力します。
-p profile_manager_name
ジョブの実行先のプロファイル・マネージャーを指定します。
-s interval
管理対象ノードのあるグループでタスクを実行してから、次のグループで実行するまでの秒数を指定します。 staged モードを選択した場合、このオプションの値を指定しなければなりません。間隔は、オプション -m で指定したタイムアウト値より大きくなければなりません。
-t task_name
タスク・ライブラリーに組み込むタスクの名前を指定します。
-X ジョブ出力のデスクトップへの書き込みを使用不可にします。
権限admin、senior、super
参照wcrttask, wdeljob, wrunjob, wsettask
wsetjob
第 3 章 コマンド (アルファベット順) 399
wsetlang
Tivoli サーバーまたは管理対象ノード上で、Tivoli メソッドを実行するためのロケールを設定します。
構文wsetlang [-o] [-l locale_name]
説明wsetlang コマンドは、Tivoli サーバーまたは管理ノードの言語環境を設定します。指定するロケール名は、有効なオペレーティング・システム・ロケール名または標準ロケール名のいずれかです。ロケール名は 2 桁の ISO 639 言語コードとその後に続くオプションのアンダースコアー (_) および 2 桁の ISO 3166 国別コードから構成されます。標準的な構文は、次のとおりです。
ll[_TT]
この場合、ll は言語コードを表し、TT はオプショナル国名コードを表します。
UNIX マシンのオペレーティング・システム・ロケール名は、次の UNIX コマンドを使用してリストできます。
locale -a
UNIX オペレーティング・システム上では、指定されたロケール名はインストールされたオペレーティング・システム・ロケール名のうちで一番近いものにマップされます。一致するロケール名が見つからない場合は、C ロケールが使用されます。Windows オペレーティング・システム上では、指定したロケール名を使用します。その妥当性検査は行われません。
標準ロケール名には、以下のものがあります。
en または C英語
fr フランス語
de ドイツ語
it イタリア語
ja 日本語
pt_BR ブラジル・ポルトガル語
ko 韓国語
zh_CN中国語 (簡体字)
zh_TW中国語 (繁体字)
400 Tivoli Management Framework: リファレンス・マニュアル
オプション-l locale_name
使用するロケールを指定します。-l オプションを指定しないと、現在の言語環境が使用されます。
-o この Tivoli サーバーまたは管理対象ノード用の言語を、指定した値に設定します。
権限super または senior
例1. ロケールをフランス語に設定し、メソッド用の odadmin 環境を更新するには、次のコマンドを入力します。
wsetlang -o -l fr
メソッド環境設定は、次のコマンドを使用して表示できます。
odadmin environ get
2. フランス語用のオペレーティング・システム・ロケール名を表示するだけの場合は、次のコマンドを入力します。このコマンドでは、メソッド環境は更新されません。
wsetlang -l fr
wsetlang
第 3 章 コマンド (アルファベット順) 401
wsetpkey
パスワードを暗号化して、レジストリーに格納します。
構文wsetpkey -a key [-k]
wsetpkey -d key
説明wsetpkey コマンドは、パスワードを暗号化し、それを Windows レジストリーに格納します。暗号化されたパスワードは、設定したキーの下に格納されます。
オプション-a key キーおよびパスワードを追加または置換します。
-d key プロンプトを表示せずに標準入力からパスワードを読み込んだり、エコーなしでコンソールからパスワードを読み込みます。
-k キーとパスワードを削除します。
例次の例では、admin_key レジストリー・キーが追加されます。
wsetpkey -a admin_key
402 Tivoli Management Framework: リファレンス・マニュアル
wsetpm
プロファイル・マネージャーのデータレス・モードでの実行を可能または不可にします。
構文wsetpm -d @ProfileManager:profile_manager
wsetpm -D @ProfileManager:profile_manager
説明wsetpm コマンドは、プロファイル・マネージャーをデータレス・モードで実行するかどうかを指定します。データレス・モードの場合、プロファイル・マネージャーは、クライアント・データベースのないエンドポイントに配布できます。エンドポイントは、データレス・モードで実行中のプロファイル・マネージャーにサブスクライブできます。管理対象ノードは、配布モードに関係なくプロファイル・マネージャーにサブスクライブできます。データレス・モードのプロファイル・マネージャーで管理対象ノードに配布する場合、配布中、管理対象ノードのデータベースは無視されます。
オプション-d プロファイル・マネージャーのデータレス・モードでの実行を可能または不
可にします
-D データレス・モードでのプロファイル・マネージャーの実行を使用不可にします。データレス・モードを使用不可にする前に、事前にプロファイル・マネージャーからすべてのエンドポイント・サブスクライバーを除去しておく必要があります。
@ProfileManager:profile_manager
プロファイル・マネージャーの名前を指定します。
権限admin、senior、super
例1. 次の例は、AdminServer プロファイル・マネージャーをデータレス・モードで作動するように設定します。エンドポイントのサブスクライバーは受け入れられます。
wsetpm -d @ProfileManager:AdminServer
2. 次の例は、TopLevel プロファイル・マネージャーがエンドポイントのサブスクライバーを受け入れないように設定します。データレスでの運用は使用禁止になります。
wsetpm -D @ProfileManager:TopLevel
第 3 章 コマンド (アルファベット順) 403
wsetpr
ポリシー・リージョンで使用するポリシーを割り当てて、ポリシーの検証を使用可能または使用不可にします。ポリシー・リージョン内の管理対象リソースの追加または削除も行います。
構文wsetpr [-d default_policy] [-v validation_policy] [-E | -e] resource region
wsetpr [-r] resource region
説明wsetpr コマンドは、指定したポリシー・リージョン内の指定したリソースに使用する、デフォルト・ポリシーまたは検証ポリシーを指定します。 -E 引き数または -eオプションを指定すると、このコマンドにより、指定したポリシー・リージョン内の指定したリソースのポリシー検証が使用可能または使用不可になります。 wsetprコマンドは、ポリシー・リージョン内の管理対象リソースの追加または削除を行います。デフォルトでは、コマンドは指定したリソースをポリシー・リージョンに追加します。管理対象リソースを削除するには、オプション -r を使用します。
オプション-d default_policy
管理対象リソースに使用するデフォルトのポリシーのラベルを指定します。
-e ポリシー検証を使用可能にします。
-E ポリシー検証を使用不可にします。
-r 指定したリソースをポリシー・リージョンから削除します。
-v validation_policy
管理対象リソースに使用するデフォルトの検証ポリシーのラベルを指定します。
region ターゲット・ポリシー・リージョンのラベルを指定します。
resource
管理対象リソースのタイプを指定します。
権限senior または super のほかに、policy
例1. 次の例では、リソース TaskLibrary が Engineering ポリシー・リージョンに追加されます。
wsetpr TaskLibrary @PolicyRegion:Engineering
2. 次の例では、Engineering ポリシー・リージョン内の TaskLibrary リソースのポリシー検証が使用可能になります。デフォルト・ポリシーは BasicTaskLibrary
で、検証ポリシーは BasicTaskLibrary です。
404 Tivoli Management Framework: リファレンス・マニュアル
wsetpr -d BasicTaskLibrary -v BasicTaskLibrary -e ¥TaskLibrary @Engineering
参照wcrtpr, wdelpr, wgetpr
wsetpr
第 3 章 コマンド (アルファベット順) 405
wsetquery
照会のプロパティーを編集します。
構文wsetquery [-n name] [-d description] [-r repository] [-v view] [-c column...] [-i | -s| -w where_clause] [-x] query_name
説明wsetquery コマンドを使用すると、既存の照会についての情報を変更できます。照会名、記述、リポジトリー、表示、列リスト、where 文節を変更できます。
オプション-c column
情報を検索する場合に使用する、1 つまたは複数の照会先の列を変更します。 2 つ以上の列を指定するには、-c 文節を複数指定します。出力での列の順序は、ここで入力した順序になります。
-d description
照会の記述を変更します。
-i 標準入力から新しい where 文節を読み取ります。
-n name
照会の名前を変更します。
-r repository
情報の照会先リポジトリーを変更します。
-s 標準入力から新しい構造化された文節を読み取ります。文節の形式は、次のとおりです。
[AND | OR] [NOT] column_name {= | != | < | <= | > | >= | LIKE | IN}
column_value
-v view
データベースからの情報の検索する場合に使用する、照会先のビュー表示またはテーブルを変更します。
-w where_clause
コマンド行から新しい where 文節を読み取ります。
-x 照会の出力に重複行を取り込まないことを指定します。
query_name
変更対象の照会を指定します。
権限query_edit、admin、senior、または super
406 Tivoli Management Framework: リファレンス・マニュアル
例1. 次の例では、DOS-machines 照会の where 文節が変更され、オペレーティング・システムのバージョン、およびオペレーティング・システムの名前が検査されます。新しい where 文節はコマンド行から読み取られます。
wsetquery -w "BOOTED_OS_NAME = ’DOS’ AND ¥BOOTED_OS_VERSION LIKE ’6.%’" DOS-machines
2. 次の例では、DOS-machines 照会の名前が AIX-machines に変更され、照会の記述も変更されます。新しい where 文節は標準入力から読み取られます。
wsetquery -i -n AIX-machines -d "Find all the AIX ¥machines" DOS-machines <<EOF
(BOOTED_OS_NAME = ’AIX’)EOF
参照wcrtqlib, wcrtquery, wgetquery, wruninvquery, wrunquery
wsetquery
第 3 章 コマンド (アルファベット順) 407
wsetrim
RDBMS Interface Module (RIM) オブジェクトのプロパティーを編集します。
構文wsetrim [-n name] [-d database] [-u user] [-H db_home] [-s server_id] [-Iinstance_home] [-t instance_name] [-a application_label] [-m max_connections]
rim_name
説明wsetrim コマンドは、指定した RIM オブジェクトのデータベース情報を変更します。データベース ID、データベース・ユーザー、データベース・ホーム、データベース・サーバー ID、インスタンス・ホームを変更できます。 RIM オブジェクトのベンダーを変更するには、wdel コマンドを使用してオブジェクトを削除してから、wcrtrim コマンドを使用してそのオブジェクトを再作成する必要があります。 RIM
オブジェクトの管理対象ノードを変更するには、wmvrim コマンドを使用して RIM
オブジェクトを移動するか、もしくはその RIM オブジェクトを削除して再作成します。 RIM オブジェクトのラベルを変更するには、wsetrim -n コマンドを使用するか、もしくはその RIM オブジェクトを削除して再作成します。
注: スペースが含まれたパス名を指定する場合、そのパス名を引用符 (″ ″) で囲む必要があります。Windows システムでは、MS-DOS パスも指定できます。たとえば、パス c:¥Program Files¥sqllib を、次のいずれかの方法で指定できます。v "c:¥Program Files¥sqllib"
v c:¥progra~2¥sqllib
オプション-a application_label
RIM オブジェクトのアプリケーション・ラベルを変更します。
-d database
RIM オブジェクトの接続先データベースまたはデータ・ソースの名前を変更します。
DB2 DB2 データベース別名またはローカル DB2 データベース名です。
OracleOracle インスタンスの名前です。この名前は、構成接続ファイルのSID オプションです。 ORACLE_SID 変数の値に対応します。
Sybaseアプリケーションが使用するデータベースの名前です。
Microsoft SQLRIM が Microsoft SQL Server データベースへの接続に使用するODBC データ・ソースの名前。
Informix.odbc.ini ファイルで定義されているデータ・ソースの名前です。
408 Tivoli Management Framework: リファレンス・マニュアル
-H db_home
データベースのホーム・ディレクトリーのパスを変更します。このオプションは、変数 ORACLE_HOME (Oracle の場合)、SYBASE (Sybase の場合)、および DB2DIR (DB2 の場合) の値を変更します。
注: Windows オペレーティング・システムでは、スペースが含まれるパスの値を指定する場合、次のいずれかのフォーマットを使用します。
v "c:¥Program Files¥sqlib"
v c:¥progra~1¥sqllib
値を二重引用符 (″) で囲まなかった場合またはパス名に波形記号 (~) を含まなかった場合、コマンドの構文解析は失敗します。
-I instance_home
指定した RIM オブジェクトに対する DB2 インスタンスのパスを変更します (DB2 のみ)。
-m max_connections
RIM オブジェクトと RDBMS の最大接続数を変更します。
-n name
RIM オブジェクトの名前を name に変更します。
-s server_id
データベースのサーバー ID を変更します。このオプションは、変数TWO_TASK (Oracle の場合)、DSQUERY (Sybase の場合)、およびDB2COMM (DB2 の場合) の値を変更します。 Microsoft SQL Server の場合、これは RDBMS サーバー・マシンの名前です。
-t instance_name
指定した RIM オブジェクトに対する DB2 インスタンスの名前を変更します (DB2 のみ)。
-u user
RIM オブジェクトが使用するデータベース・ユーザーの名前を変更します。 DB2 を使用している場合、有効な UNIX ユーザーを指定します。
rim_name
変更する RIM オブジェクトのラベルを指定します。
権限Tivoli リージョン内の senior または super
例次の例では、inventory RIM オブジェクトについて、データベース ID が inventory
に、データベース・ユーザーが tivoli2 に、データベース・ホーム・ディレクトリーが /ORACLE に、データベース・サーバー ID が invdb2.world に、それぞれ変更されます。
wsetrim -d inventory -u tivoli2 -H /ORACLE ¥-s invdb2.world inventory
変更を検証するには、wgetrim コマンドを使用します。
wsetrim
第 3 章 コマンド (アルファベット順) 409
wgetrim inventory
RIM Host: amon-sulRDBMS User: tivoli2RDBMS Vendor: OracleDatabase ID: inventoryDatabase Home: /ORACLEServer ID: invdb2.worldInstance Home:
Instance Home フィールドの出力はブランクです。このフィールドは DB2 にのみ適用されるためです。
参照wcrtrim, wgetrim, wsetrimpw
wsetrim
410 Tivoli Management Framework: リファレンス・マニュアル
wsetrimpw
RDBMS Interface Module (RIM) オブジェクトのデータベース・パスワードを設定します。
構文wsetrimpw rim_name [old_password] [new_password]
説明wsetrimpw コマンドは、RIM オブジェクトのデータベース・パスワードを設定します。old_password オプションおよび new_password オプションを指定しないと、コマンドからパスワードの入力を求められます。
オプションnew_password
新しいパスワードを指定します。
old_password
現行のパスワードを指定します。
rim_name
RIM オブジェクトのラベルを指定します。
権限Tivoli リージョン内の senior または super
例次の例では、inventory RIM オブジェクトのパスワードを funEguy から Dlite に変更します。
wsetrimpw inventory funEguy Dlite
参照wcrtrim, wgetrim, wsetrim
第 3 章 コマンド (アルファベット順) 411
wsettap
Windows 管理対象ノード上の Tivoli 認証パッケージ (TAP) のプロパティーを設定します。
構文wsettap [-a | -d] [-B] [-P] [-r [domain_name¥user_name | user_name]] [-k]
説明wsettap コマンドは、ローカル管理対象ノード上で Tivoli 認証パッケージTivoliAP.dll のプロパティーを設定します。 Tivoli 認証パッケージを使用すると、Tivoli Management Framework はユーザーのコンテキストでリモート・ファイル・システムにアクセスできるようになります。また wsettap コマンドによって、Windows 管理対象ノードで setuid メソッドを実行する、つまりそのメソッドに関連するユーザーのコンテキストでメソッドを実行することも可能になります。リモート・ファイル・システムへのアクセスについての詳細は、「Tivoli Management
Framework デプロイメントの計画ガイド」を参照してください。
Tivoli リモート・アクセス・アカウントは、ユーザー・アカウントを指定します。Tivoli Management Framework はこのアカウントを使用して、リモート・ファイル・システムにアクセスします。
オプションを指定せずに wsettap コマンドを実行すると、現在実行中のTivoliAP.dll からのバージョン情報が出力されます。
初めて Tivoli 認証パッケージを活動化する場合 (通常は Tivoli サーバーのインストール直後)、変更を有効にするにはマシンを再始動しなければなりません。
注: アクティブ・ディレクトリーを使用する Windows 2000 ドメイン環境では、Tivoli 認証パッケージ (TAP) は、アクティブ・ディレクトリーへの接続に無名ログインではなく Tivoli リモート・アクセス・アカウントを使用します。この機能を使用するには、Tivoli リモート・アクセス・アカウントを有効なドメイン修飾ユーザー ID とパスワードに設定する必要があります。
オプション-a Tivoli 認証パッケージの内部キーを設定し、ローカル・セキュリティー権限
(LSA) 付きで登録します。新しい内部キーが即時に有効になります。TivoliAP.dll ファイルは、マシンが再始動されるときに LSA によってロードされます。
-B 1 次ドメイン・コントローラー以外のドメイン・コントローラーを使用してドメイン・ユーザーを認証します。 1 次ドメイン・コントローラーを使用してユーザーを認証するには、-P オプションを使用します。
-d Tivoli 認証パッケージ内部キーを削除して、LSA 付きの登録を抹消します。ファイルは、マシンが再始動されるときに LSA によってリリースされます (したがって、Tivoli Management Frameworkがアンインストールされるときにはこのファイルを削除できます)。
412 Tivoli Management Framework: リファレンス・マニュアル
-k user_name のパスワードを標準入力から読み取るように指定します。このオプションを指定しないと、パスワードの入力を求めるプロンプトが表示されます。
-P 1 次ドメイン・コントローラーを使用してドメイン・ユーザーを認証します。これがデフォルトの設定です。バックアップ・ドメイン・コントローラーなど、他のドメイン・コントローラーを使用してユーザーを認証するには、-B オプションを使用します。
-r [domain_name¥user_name | user_name]
Tivoli リモート・アクセス・アカウントを、指定されたユーザー名に設定します。 Tivoli Enterprise ソフトウェアは、このユーザー・アカウントを使用してリモート・ファイル・システムにアクセスします。指定するユーザー名には、スラッシュ (/) と円記号 (¥) のどちらかで区切って、ドメイン・ネームのプレフィックスを付けます。ドメインを指定するときは、そのドメインが Tivoli 認証パッケージを実行しているマシンが属するドメインか、そのドメインによって承認されたドメインでなければなりません。ドメインが指定されない場合、オペレーティング・システムはローカル・ドメイン内の所定のユーザーまたは承認されたドメインを探します。変更内容が即時に反映されているかを確認するには、オブジェクト・ディスパッチャーを再始動します。
権限レジストリーを編集する場合: Windows オペレーティング・システム許可
オプションなしでコマンドを実行する場合: admin
例1. 以下の例のように入力すると、Tivoli Management Framework からリモート・ファイル・システムにアクセスできなくなります。
wsettap -r " "
2. 次の例では、Tivoli リモート・アクセス・アカウントが userTME というユーザー・アカウントに設定されます。コマンドは、passwd.txt ファイルからパスワードを読み取ります。
wsettap -r userTME -k < passwd.txt
wsettap
第 3 章 コマンド (アルファベット順) 413
wsettask
タスクのプロパティーを設定します。
構文wsettask -t task_name -l library_name [-g group_name] [-u user_name] -r role [-ccomments] -i interp_type node_name file_name...
説明wsettask コマンドは、指定したタスク・ライブラリー内のタスクのプロパティーを設定します。
オプション-c comments
タスクとタスクの目的を識別するための説明のコメントを追加します。
-g group_name
タスクを実行するグループの名前を指定します。 (UNIX のみ)
-i 管理対象ノードでの新しいタスクの実行に必要な情報を定義します。次のそれぞれの値を指定する必要があります。
file_name
指定したプラットフォームで実行する実行可能ファイルの名前を指定します。
interp_type
タスクの実行先プラットフォームのインタープリター・タイプを指定します。
node_name
指定したプラットフォーム用の実行可能ファイルのある管理対象ノードを指定します。
-l library_name
タスクのあるタスク・ライブラリーを指定します。
-r role タスクの実行に必要な許可の役割を指定します。コロンで区切って指定することにより、役割を複数指定できます。たとえば、admin:senior:super です。
-t task_name
更新対象タスクの名前を指定します。
-u user_name
タスクの実行に使用するユーザー名を指定します。
権限admin、senior、super
参照wcrttask, wdeltask, wgettask
414 Tivoli Management Framework: リファレンス・マニュアル
wsetval
レジストリー項目を追加または削除します。
構文wsetval [-b] [-d] [-h registry_hive] -k {key | @file_name} -n value_name -v{″value_string″ | @file_name}
説明wsetval コマンドは、Windows エンドポイント上でのみ、レジストリー項目 (キー名) を追加または削除し、その値 (キー値) を設定します。キーまたは値が存在しない場合は、作成されます。
注: このコマンドはエンドポイントから実行する必要があります。
オプション-b 値をバイナリーとして作成します。バイナリー値は、-v オプションで指定
されたファイルから読み取る必要があります。
-d -n オプションで指定された値名、または -k オプションで指定されたキー名を削除します。 -n オプションがあれば、-n オプションで指定されている値名が削除されます。 -n オプションがない場合は、 -k オプションで指定されているキー (およびそのすべてのサブキー) が削除されます。
-h registry_hive
レジストリー・ハイブを更新することを指定します。有効な値は次のとおりです。
v HKEY_LOCAL_MACHINE (デフォルト)
v HKEY_CURRENT_USER
v HKEY_CLASSES_ROOT
v HKEY_USERS
v HKEY_CURRENT_CONFIG (Windows)
v HKEY_DYN_DATA (Windows)
-k key | @file_name
値を挿入するキーを指定します。キーの先頭文字が @ の場合、そのキーはfile_name から読み取られます。
-n value_name
値の名前を指定します。 -d を使用している場合、-n オプションの指定は任意です。
-v ″value_string″ | @file_name
値または値が入っているファイルを指定します。 -d を使用している場合は、-v オプションは無視されます。
権限admin
第 3 章 コマンド (アルファベット順) 415
例既存の SOFTWARE キーの下に NOTEPAD サブキーを追加して、HKEY_LOCAL_MACHINE ハイブ内の NOTEPADVAR キー値名を割り当てる場合は、次のコマンドを入力します。
wsetval -h HKEY_LOCAL_MACHINE -k SOFTWARE¥NOTEPAD ¥-n NOTEPADVAR -v C:¥TEMP¥NTPADVAR.FIL
wsetval
416 Tivoli Management Framework: リファレンス・マニュアル
wsndnotif
標準入力をメッセージ構造に変換して、通知サーバーに送信します。
構文wsndnotif [-e] [-t] notice_group priority
説明wsndnotif コマンドは、標準入力をメッセージ構造に変換して通知サーバーに送信するコマンド行プログラムです。 -e オプションと -t オプションによって、シェル・スクリプトがメッセージを特定の言語に依存しない形式で送信できるようにします。これらのオプションを指定しないと、標準入力は単一の ASCII バッファーとして処理され、メッセージは言語に依存しない形式には変換されません。このコマンドより、指定した優先順位で指定した通知グループにメッセージが送信されます。
オプション-e 標準入力が例外の ASCII 表現 (Interface Definition Language (IDL) 呼び出
しから生成される例外など) となることを指定します。
-t 標準入力が Extended Interface Definition Language (EIDL) シェル・メソッド・タイプで使用される ASCII 形式の tmf_msg_t に変換されなければならないことを指定します。EIDL シェル・メソッド・タイプで使用されるASCII 形式の詳細については、「TME 10 ADE Framework Services
Manual」を参照してください。
notice_group
変換した標準入力の送信先の通知グループを指定します。
priority
変換した標準入力を指定通知グループに送信するために使用する、優先順位を指定します。有効な優先順位は、Critical、Error、Warning、Notice、および Debug です。
権限user、senior、super
例1. 次の例では、通知が Tivoli Administration 通知グループに送信されます。優先順位は Notice です。
wsndnotif "Tivoli Administration" NoticeThis notice is to inform all administrators that I amchanging the name of managed node homer to marge this weekend.
Paul
2. 次の例では、シェル・スクリプトで -e オプションが使用されます。 IDL 呼び出しがゼロ以外の終了状況を戻す場合、ASCII 出力は例外です。ASCII データは、エラーとして Tivoli Administration 通知グループに記録されます。
第 3 章 コマンド (アルファベット順) 417
out=``idlcall $OID method`if [ $? -ne 0 ]thenwsndnotif -e "Tivoli Administration" Error <<EOF$outEOFfi
3. 次の例では、シェル・スクリプトで -t オプションが使用されます。この例の場合、task_msg メッセージ・カタログから Tivoli Administration 通知グループにメッセージ 49 が送信されます。ストリング Amar、[email protected]、および AmarLib がメッセージに挿入されます。メッセージ 49 が見つからない場合、デフォルトのメッセージが送信されます。デフォルトのメッセージは、"A
new task, %1$s, was created by %2$s in the %3$s task library" です。
echo ’{ { 1 } "task_msg" "A new task, %1$s, was created by %2$s ¥in the %3$s task library." 49 { { ¥TMF_Types::_sequence_string_StringList } ¥{ 3 "Amar" "[email protected]" ¥"AmarLib" } } } } }’ | ¥
wsndnotif -t "Tivoli Administration" Critical
参照wexpnotif, wlsnotif, wtailnotif
wsndnotif
418 Tivoli Management Framework: リファレンス・マニュアル
wstandalone
Tivoli サーバーがローカル・マシンへの接続を開始する必要なく、管理対象ノードを作成します。
構文wstandalone -c tivoli_server [-i] [managed_node]
wstandalone -a managed_node dispatcher policy_region
説明Tivoli サーバーがローカル・マシンへの接続を開始する必要なく、wstandaloneコマンドにより管理対象ノードを作成できます。このコマンドは、接続の確立によりセキュリティー・リスクが生じるような状態の場合に有効です。
注: wclient コマンドにより、暗号化された SSH 接続を使用して管理対象ノードを作成できます。詳しくは、 121ページの『wclient』を参照してください。
wstandalone コマンドを利用して管理対象ノードを作成するには、以下のステップを実行してください。
1. 管理対象ノードを作成するマシン上に、Tivoli サーバーを作成します。リモート始動能力が使用可能になるように、この Tivoli サーバーの SetPort パラメーターを 1 に設定します。 Tivoli サーバーの作成および SetPort パラメーターの設定についての詳細は、「Tivoli Enterprise インストール・ガイド」を参照してください。
2. 以下のコマンドを使用して、ステップ 1 で作成した Tivoli サーバーを管理対象ノードに変換します。以下のコマンド構文で tivoli_server には管理対象ノードの接続先 Tivoli サーバーの名前を指定します。managed_node には、管理対象ノードのデフォルト・ラベルを変更したい場合にのみオプションでストリングを指定します。
wstandalone -c tivoli_server managed_node
3. Tivoli サーバーで以下のコマンドを実行します。managed_node には、ステップ2 で作成した管理対象ノードの名前を、dispatcher にはその管理対象ノードのオブジェクト・ディスパッチャー番号を、policy_region にはその管理対象ノードを追加するポリシー・リージョンをそれぞれ指定します。
wstandalone -a managed_node dispatcher policy_region
オプション-a 指定されたポリシー・リージョンに管理対象ノードを追加して、その管理対
象ノードを Tivoli サーバーに登録します。このコマンドを実行する前に、管理対象ノードを作成し、wstandalone -c コマンドを使用して Tivoli サーバーを指定する必要があります。 wstandalone -c コマンドは Tivoli サーバーで実行してください。
-c ローカル・マシン上に管理対象ノードを作成して、その管理対象ノードを指定された Tivoli サーバーの管理対象ノード・リストに追加します。このオプションを実行する前に、Tivoli サーバーをローカル・マシンにインストー
第 3 章 コマンド (アルファベット順) 419
ルしておく必要があります。このオプションは、ローカル・マシン上のTivoli サーバーを管理対象ノードに変換します。managed_node パラメーターは、wstandalone -c コマンドではオプションです。管理対象ノードのデフォルト・ラベルを変更したい場合にのみ managed_node 値を指定してください。管理対象ノードのデフォルト・ラベルは、hostname コマンドから出力されたものです。wstandalone -c コマンドは、管理対象ノードを作成するマシンで実行する必要があります。
-i インストール・パスワードの入力を求めるプロンプトが表示されるようにします。このオプションを使用しなかった場合は、パスワード・プロンプトは表示されません。
dispatcher
odadmin odlist コマンドを使用して確認した管理対象ノードのオブジェクト・ディスパッチャー番号を指定します。
managed_node
管理対象ノードのラベルを指定します。
policy_region
管理対象ノードを追加するポリシー・リージョンを指定します。
tivoli_server
この管理対象ノードを接続する Tivoli サーバーのホスト名を指定します。
権限wstandalone -c コマンドを実行するには、ローカル・マシンでの root アクセス権を持っていなくてはなりません。 Windows システムでは、Windows Administrators
グループのメンバーでなくてはなりません。
wstandalone -a コマンドの実行には、super または install_client が必要です。
例1. 以下の例では、ローカル・マシンに管理対象ノードを作成して、その管理対象ノードを Tivoli サーバー oak に接続することを指定します。
wstandalone -c oak
2. 以下の例では、ローカル・マシンに管理対象ノードを作成し、その管理対象ノードを Tivoli サーバー oak に接続することを指定して、管理対象ノードのラベルを birch に変更します。
wstandalone -c oak birch
3. 以下の例では、管理対象ノード birch をポリシー・リージョン my_region に追加します。
wstandalone -a birch 50 my_region
参照odadmin, wclient, winstlcf, wserver
wstandalone
420 Tivoli Management Framework: リファレンス・マニュアル
wstartsched
Tivoli スケジューラーを始動します。
構文wstartsched
説明wstartsched コマンドは、Tivoli スケジューラーの TMF_sched サービスを開始します。
権限senior
参照wdelsched, wedsched, wenblsched, wgetsched, wschedjob
第 3 章 コマンド (アルファベット順) 421
wsub
Tivoli リソースをプロファイル・マネージャーにサブスクライブします。
構文wsub [-r] name subscriber...
説明wsub コマンドは subscriber で指定された Tivoli リソースを、name で指定されたプロファイル・マネージャーにサブスクライブします。
オプション-r 到達不能なサブスクライバーがあった場合に、wsub コマンドがエラー・コ
ード (1) を戻すことを指定します。指定したサブスクライバーが存在しなかった場合は、常に障害コードが戻されます。
name リソースのサブスクライブ先プロファイル・マネージャーの名前を指定します。 name オプションの有効な形式は、次のとおりです。
v @prof_manager_name
v @ProfileManager:prof_manager_name
v /Regions/PolicyRegionName/prof_manager_name
subscriber
指定したプロファイル・マネージャーのサブスクリプション・リストに追加される Tivoli リソースの名前を指定します。このオプションを複数回指定できます。 subscriber オプションに有効な形式は、次のとおりです。管理対象ノード以外のリソースをサブスクライブする場合、これらの例を変更してリソース・タイプを反映させます。
v @ManagedNode:node_name
v /Regions/PolicyRegionName/node_name
権限プロファイル・マネージャーのポリシー・リージョンおよびサブスクライバーのポリシー・リージョンにおける admin。
例以下の例では、管理対象ノード pinatubo と newcastle、およびプロファイル・マネージャー Apps_Dev を、Development プロファイル・マネージャーにサブスクライブします。
wsub @Development @ManagedNode:pinatubo ¥@ManagedNode:newcastle @ProfileManager:Apps_Dev
参照wcrtprf, wcrtprfmgr, wdistrib, wgetprf, wgetsub, wlssub, wpopulate, wunsub,
wvalidate
422 Tivoli Management Framework: リファレンス・マニュアル
wsupport
ユーザーから問題情報を収集して、お客様サポート担当者に送信します。(UNIX のみ)
構文wsupport -s
説明wsupport コマンドは、サポート担当者が技術的な問題を調査するために必要となる重要な情報を入力するようユーザーに指示します。情報の入力後、その情報をサポート担当者に電子メールで送るか、テキスト・ファイルに保管するかを選択するよう指示されます。電子メールを指定した場合、情報の送信先の電子メール・アドレスを入力しなければなりません。入力した情報は、毎行 1 項目として解析できる形式で送信されます。情報をテキスト・ファイルに保管するよう選択した場合、情報はサポート担当者にファックス送信できる形式で表示されます。ファックス送信の前に情報を編集できます。ファイルをあとから電子メールで送ることもできます。あとから電子メールでサポート担当者にファイルを送る場合、指示されたときに電子メール・オプションを選択して、最終的な確認時に No を選択してください。
次の情報の入力を求めるプロンプトが出されます。
名前 要求の処理を依頼するユーザーの名前です。
会社名 会社の名前です。
電子メール・アドレス電子メールが使用できる場合、送信者の電子メール・アドレスです。
電話番号送信者の電話番号です。電子メール・アドレスを入力しない場合、電話番号が必要です。
Fax 番号送信者の Fax 番号です。
TMR 番号ライセンス交付を受けた Tivoli リージョンの番号。
サポート・プロバイダーの電子メール会社が利用するサポート・プロバイダーの電子メール・アドレスです。
次のシステム情報の入力を求めるプロンプトが出されます。
呼び出し ID 番号サポート・プロバイダーが記録した既存の問題の呼び出し追跡番号です。
システム・タイプ問題が発生したシステムです。
オペレーティング・システム・リリース問題が発生したオペレーティング・システムのリリース・レベル (4.1.3 など) です。
第 3 章 コマンド (アルファベット順) 423
Tivoli 製品問題が発生した Tivoli 製品名です。 wsupport により、選択対象となるTivoli 製品のリストが表示されます。
Tivoli リリース製品のバージョンおよびリリース番号です。
問題に関する次の情報の入力を求めるプロンプトが出されます。
問題の発生場所問題が発生した場所 (Tivoli サーバーまたは管理対象ノード) です。
サーバーまたはクライアントの名前問題が発生したシステムの名前です。
問題の重大度問題の重大度レベルです。有効なオプションは次のとおりです。
v Critical — 業務を行うことができない。製品が作動不能。運用上の損失あり。継続的な故障や中断。データ破壊。
v Major — システムまたはアプリケーションは一時停止後に回復。再度生じる危険性が高く緊急。断続的な故障。性能低下が著しい。
v Minor — 問題が発生。業務の運営にある程度影響。影響範囲は局地的または他に影響しない。運用上問題がある。
v No Impact — 一般的な質問または必要な情報。
簡単な説明10 ~ 12 語での問題の説明です。
行った処置問題を解決できなかった処置です。
詳細な説明問題の詳細な説明です。
問題に関する情報は、ユーザーのホーム・ディレクトリー内の .tivoli_rc ファイルに保管できます。
オプション-s カスタマー情報の質問をスキップします。質問はシステム情報から始まりま
す。カスタマー情報は .tivoli_rc ファイルから読み取られます。
ファイル/tmp/wsupport.$UNAME — 生成されたレポート・ファイル
/tmp/sup.$UNAME.uu — エンコードされた圧縮ログ・ファイル
wsupport
424 Tivoli Management Framework: リファレンス・マニュアル
wtailnotif
通知グループにポストされた通知を表示します。
構文wtailnotif [-a administrator...] [-g notice_group...] [-l] [-p priority...]
説明wtailnotif コマンドは、通知サーバーに接続して新しい通知がポストされると、これを表示します。通知を、優先順位、アドミニストレーター、またはグループでフィルターに掛けることができます。また、すべての通知データを表示するか、あるいは通知ヘッダーのみを表示するかを指定できます。オプションを指定しないと、受信時にすべての通知グループのすべての通知が表示されます。
オプション-a administrator
指定されたアドミニストレーターがポストした通知のみが表示されます。複数のアドミニストレーターを指定できます。
-g notice_group
指定した通知グループにポストされた通知のみが表示されるよう指定します。複数の通知グループを指定できます。
-l 通知ヘッダーのみが表示されるよう指定します。
-p priority
指定された優先順位の通知のみが表示されるよう指定します。複数の優先順位を指定できます。
権限senior、super
例次の例は、TME Administration 通知グループに通知がポストされたらその通知を表示するよう指定します。
wtailnotif -g "TME Administration"
参照wexpnotif, wlsnotif, wsndnotif
第 3 章 コマンド (アルファベット順) 425
wtaskabort
タスクのトランザクションを停止して、コミットされていない変更をロールバックします。
構文wtaskabort
説明wtaskabort コマンドは、タスク・シェル・スクリプト内で使用されます。コマンド行からこのコマンドを使用して特定のタスクを取り消すことはできません。
タスクを実行するとき、トランザクション・モデルを指定できます。Tivoli コマンドを使用すると、1 つのトランザクションの一部として複数の操作を実行できます。タスク全体が終了してトランザクションがコミットされるまで、変更は永続的なものになりませせん。Tivoli 以外のコマンドを使用してタスクで障害が発生した場合、wtaskabort コマンドを使用してトランザクションを停止し取り消して、コミットされていないすべての変更をロールバックすることができます。
注wtaskabort コマンドを使用すると、タスクは出力や戻りコードを戻しません。エラー・メッセージの代わりに次のような出力が表示されます。
bald (ManagedNode): The task failed to execute.bald (ManagedNode): System Exception: failure detected by object adapter:completion status: NOTransaction Error
例次の例では、タスクが、ディレクトリーへのパスが格納される Tivoli ネーム・レジストリーに特別なリソースを登録します。次にディレクトリーが作成されます。mkdir コマンドが失敗すると、スクリプトは abort() 関数を実行します。シェルは-e フラグを指定して実行されているからです。 abort() 関数では、ネーム・レジストリーへの変更をロールバックする wtaskabort が呼び出されます。その後の検索で、特別なリソースは表示されません。
1 #!/bin/sh2 set -e34 #5 # Function to be used to abort a transaction in task shell script67 #8 abort() {9 return_code=$?10 if [ $return_code -ne 0 ]; then11 wtaskabort12 fi13 }1415 trap ’abort’ 01617 #
426 Tivoli Management Framework: リファレンス・マニュアル
18 # TASK MAIN19 #20 wregister -i -r special_directory /Tivoli/specials OBJECT_NIL21 mkdir /Tivoli/specials
参照wruntask, wrunjob, Tivoli トランザクション
wtaskabort
第 3 章 コマンド (アルファベット順) 427
wtimezone
指定されたシステムの時間帯の値を出力します。
構文wtimezone node_name
説明wtimezone コマンドは、グリニッジ標準時 (GMT) を基準に時差 (分単位) を出力して時間帯を示します。
オプションnode_name
ホスト名を指定します。
権限user、admin、senior、super
例次の例では、管理対象ノード bald の時間帯が表示されます。
wtimezone bald
360
参照wdate, wdiskspace, whostid, wifconfig, winstdir, winterp, wmannode,
wmemsize, wping, wuname, wxterm
428 Tivoli Management Framework: リファレンス・マニュアル
wtempTivoli Enterprise 製品で作成される一時ファイルが入るディレクトリーの名前を表示します。
構文wtemp [-s]
説明wtemp コマンドは、Tivoli Enterprise 製品で作成される一時ファイルが入るディレクトリーの名前を表示して、このディレクトリーが存在しており書き込みが許可されているのを確認します。
wtemp では、すべてのパス名にスラッシュ (/) を使用します。 Windows オペレーティング・システムでは、 bash シェルを使用していない場合は、スラッシュを円記号 (¥) に変換しなければならないことがあります。
オプション-s ディレクトリーが存在し、書き込みが許可されていることを確認します。
権限Tivoli の許可の役割は不要です。
戻り値一時ディレクトリーが存在しない場合、または書き込みに使用できない場合は、ヌル・ストリングを標準出力に書き込みます。
例1. 次の例では、Solaris オペレーティング環境の一時ディレクトリーを表示します。
wtemp
/var/tmp
2. 次の例では、Windows オペレーティング・システム上の一時ディレクトリーを表示します。
wtemp
c:/Tivoli/db/cdeamqs.db/tmp
3. 次の例では、AIX システムに一時ディレクトリーが存在し、書き込みが許可されていることを確認します。
wtemp -s
/tmp
4. 次の例では、一時ディレクトリーが存在していないか、または書き込みが許可されていないことが示されています。
wtemp -s
第 3 章 コマンド (アルファベット順) 429
wtll
タスク・ライブラリーの定義をインポートおよびエクスポートします。
構文wtll [-r] -p region [-P preprocessor] import_file [preprocessor_options...]
wtll -i [-p region | -l library_name] [-t task...] [-P preprocessor] import_file
[preprocessor_options...]
wtll -d [-l library_name] [-P preprocessor] import_file [preprocessor_options...]
wtll -F export_file -l library_name
説明wtll コマンドは、タスク・ライブラリー定義のインポート (インストール) に使用するツールで、Tivoli タスク・ライブラリーを作成または変更します。このコマンドは、オフラインで保管できる形式、または他のシステムに転送できる形式で、既存のタスク・ライブラリーをエクスポートする場合にも使用できます。インポートとエクスポートのいずれの場合でも、タスク・ライブラリーはタスク・ライブラリー言語 (TLL) で記述されます。
新しいタスク・ライブラリーを Tivoli リージョンにインポートする場合、TLLソース・ファイルが作成されます。タスクで使用するすべてのプログラムまたはスクリプトは、直接 TLL ソースに組み込むことも、TLL ディレクティブの外部ファイルとして参照することもできます。wtll コマンドは、タスク・ライブラリー定義を読み取って解析します。次に、ソースに定義されたさまざまな属性を検証して、それからタスク・ライブラリー・オブジェクトを作成または変更します。
タスク・ライブラリーをエクスポートする場合、wtll はタスク・ライブラリーの再構成に必要なすべてのエレメントを含む tar 形式のファイルを作成します。収集されたエクスポート・ファイルには、タスクの TLL の記述と、サポートされているそれぞれのプラットフォーム・タイプ用のタスクのコードが入っています。
wtll コマンドを使用してタスク・ライブラリーを作成する方法の詳細については、493ページの『第 3 部 タスク・ライブラリー言語』を参照してください。
オプション-d コマンドをデバッグ・モードで実行します。デバッグ・モードの場合、イン
ポート済みのファイルの構文をチェックしますが、ファイルを Tivoli リージョンにはインポートしません。
-F export_file
library_name で指定されたタスク・ライブラリーの tar 形式のエクスポート・ファイルを作成します。
-i 新しいタスクまたはタスクのグループを既存のタスク・ライブラリーに挿入します。インポート・ファイルが解析され、指定したタスクが既存のタス
430 Tivoli Management Framework: リファレンス・マニュアル
ク・ライブラリーに作成されます。インポート・ファイルは、タスク・ライブラリー全体でも、個々のタスクのリストでも構いません。
注:
v タスクをタスク・ライブラリーに追加するには、wcrttask コマンドを使用してください。
v インポート・ファイルにタスク・ライブラリーが含まれている場合、そこに含まれているタスクは自己完結型のタスクでなければなりません。このタスクでは、レイアウト・キーワードを使用してタスク・ライブラリー内に定義されている ArgLayout を指定することはできません。
-l library_name
エクスポートまたは変更するタスク・ライブラリーの名前を指定します。ライブラリーはローカルの Tivoli リージョンに定義されていなければなりません。
-p region
新しいタスク・ライブラリーの作成先ポリシー・リージョンを指定します。ポリシー・リージョンはローカルの Tivoli リージョン内になければなりません。
-P preprocessor
解析の前に、インポート・ファイルでプリプロセッサーとして使用するプログラムへのパスを指定します。 cpp コマンドは、もっともよく使用されるプリプロセッサーです。コマンド行で import_file の後に指定されたすべてのオプションは、プリプロセッサーに渡されるオプション(preprocessor_options) と見なされます。
-r タスク・ライブラリーを import-file で指定したライブラリーで置換します。既存のライブラリーと、そのタスクとジョブのすべてが削除され、次に、インポート・ファイルで指定された機能のライブラリーが再作成されます。ライブラリーが存在しない場合には、新しいライブラリーが作成されます。
-t task インポートするタスクの名前を指定します。指定したタスク名は、それが含まれているタスク・ライブラリーまたはポリシー・リージョンの中で固有にする必要があります。
import_file
インポートするファイルを指定します。このファイルには、タスク・ライブラリーに追加される単一のタスク、または既存のタスク・ライブラリーの置換先の新しいタスク・ライブラリー全体が入っています。
preprocessor_options
追加のプリプロセッサー・オプションを指定します。有効なオプションに関しては、プリプロセッサーのマニュアルを参照してください。
権限admin、senior
wtll
第 3 章 コマンド (アルファベット順) 431
例1. 次の例では、/tmp/tll ファイル内の TLL ソースを使用して、ポリシー・リージョン sandia-Region 内に新しいタスク・ライブラリーが作成されます。
wtll -p sandia-Region /tmp/tll
2. 次の例でも、ポリシー・リージョンに新規タスク・ライブラリーを作成します。ただし、この例では、まず cpp プリプロセッサーで TLL ソースを実行し、そのあとでユーザーのホーム・ディレクトリーにある include ファイルを使用します。 -B および -P オプションは、cpp プリプロセッサーへの入力です。これらの引き数は、タスク・ライブラリー・ファイルの中の C++ のコメントを構文解析します。
wtll -p sandia-Region -P /usr/lib/cpp /tmp/tll -B -P
注: プリプロセッサー用のオプションでは、wtll に使用するものと同じオプション名 (-P など) を使用できます。構文ステートメントの中での位置が決まっているので、コマンドはこれらのオプションを正しく処理します。
3. 次の例では、sandia-Region というポリシー・リージョン内の my_tasks という名前のタスク・ライブラリーが /tmp/tll ファイル内の TLL ソースで置換されます。
wtll -r -p sandia-Region -l my_tasks /tmp/tll
4. 次の例では、タスク・ライブラリー my_tasks が /tmp/my_tasks.tar という名前のファイルにエクスポートされます。
wtll -F /tmp/my_tasks.tar -l my_tasks
参照cpp、tar、wcrttask
wtll
432 Tivoli Management Framework: リファレンス・マニュアル
wtmrname
ローカルの Tivoli リージョンの名前を表示または変更する。
構文wtmrname [-s new_name]
説明wtmrname コマンドは、ローカル Tivoli リージョンの名前を表示します。ローカル Tivoli リージョンの名前を変更するには、-s オプションを使用します。この場合は、すべての Tivoli リージョンが接続されていなければなりません。Tivoli 環境全体でその新規名が固有であることを検証できるようにするためです。
オプション-s new_name
ローカル Tivoli リージョンの名前を指定された名前に変更します。名前を変更する前に、接続されたすべての Tivoli リージョンに対して新規名が検証されます。
権限呼び出し元は、ローカル Tivoli リージョン内に次の役割を持っていなければなりません。
v 名前を変更する場合: super
v 名前を表示する場合: super、senior、admin、または user
例1. 以下の例は、ローカル Tivoli リージョンの名前を表示します。
wtmrnamesherman-region
2. 以下の例は、ローカル Tivoli リージョンの名前を patton-region に変更します。
wtmrname -s patton-region
参照wconnect, wdisconn, wlsconn, wupdate
第 3 章 コマンド (アルファベット順) 433
wtrace
メソッド呼び出しのデバッグに役立つ情報を提供します。
構文wtrace [-h] [-j] [-l] [-n] [-u] [-v] [-D] [-E] [H] [-I] [-J] [-O] [-V] [format_options]
-k db_dir
説明wtrace コマンドを使用して、メソッドの入力、トランザクション、メソッドの出力を検査して、カスタム・メソッドと実行可能ファイルでの問題を診断します。このコマンドを使用するには、Tivoli オブジェクト・ディスパッチャーでトレースを可能にしておく必要があります。トレースを可能にすると、odtrace.log ログ・ファイルが作成されます。このファイルは、指定された管理対象ノードのデータベース・ディレクトリー内に作成されます。デフォルトでは、トレース・ログは 1MB (2KB
のトレース・レコードが 512 件) ですが、オブジェクト・ディスパッチャーを再起動してオプション -t で新規サイズを指定することにより、この制限を変更できます。
トレースは、オブジェクト・ディスパッチャーの複数の呼び出しで持続します。これは、オブジェクト・ディスパッチャーを再起動する場合に、トレースを再度使用可能にする必要がないことを意味します。このコマンドはトレース・ログを直接検査するので、オブジェクト・ディスパッチャーがアクティブである必要はありません。しかし、いずれかのオブジェクト・ディスパッチャーをアクティブにしておくと、odstat を実行することができます。
wtrace コマンドには、さまざまな表示データを提供する多くの形式設定オプションがあります。出力フォーマットには次のような一般ルールが適用されます。
v 構造体出力は、中括弧 ({}) で囲みます。
v 配列は大括弧 ([]) で囲みます。
v シーケンスは、カウント・フィールドにエレメントの配列が続く構造体です。
v 最上位のトランザクションの一般的な形式は、次のとおりです。
{111111:1,111111:1,2:3311
}#4
このコマンドは一般的に次のように使用されます。
wtrace -jk /usr/Tivoli/spam.db
次のような出力が表示されます。
loc-ec 676 15:10:36 M-H 1-289 0 NOT_FOUNDObject ID: 333333.1.387#FpPol::FilePackagePolDef#
Method: o_setattrMethod Args: fp_def_src_hostPrincipal: root@albundy (0/0)Path: o_setattrTrans Id:
{333333:1,333333:1,2:405
434 Tivoli Management Framework: リファレンス・マニュアル
},{333333:1,333333:1,2:406}#3
この出力は、スレッド ID 676 上のローカルなオブジェクト呼び出しで、現地時間の 15:10:36 に実行されたことを表しています。 o_setattr メソッドは、オプションfp_def_src_host を指定して、オブジェクト参照子333333.1.387#FpPol::FilePackagePolDef# で呼び出されました。NOT_FOUND のエラー状況が返りました。この冗長形式では、トランザクション ID、メソッドの呼び出し元プリンシパル、メソッドの有効ユーザー ID とグループ ID、およびメソッドへのパスも分かります。
次は、エラー状態 (例外) が発生したことを示す出力例です。
loc-ec 6073 16:28:01 M-hdoq 1-6047 26 e=12Object ID: 333333.1.26
Method: get_allPrincipal: root@ajax (60001/60001)Helper pid: 2419Path: /home/Tivoli/bin/solaris2/TMF/BASESVCS/TNR_prog1Trans Id:
{333333:1,333333:1,7:4042},{333333:1,333333:1,7:4063}#3
Input Data: (encoded): "NisDomain" 9999Results: (encoded):"Exception:UserException:SysAdminException::ExException:SysAdminException::ExInvalid:SysAdminException::ExNotFound{"Exception:UserException:SysAdminException::ExException:SysAdminException::ExInvalid:SysAdminException::ExNotFound" "TNR_errors"1 "The resource type %7$s was not found."779578081{
0}"NisDomain"}
この出力例で、アドミニストレーター root@ajax はネーム・レジストリー (オブジェクト参照子 333333.1.26) で、有効ユーザー ID nobody (60001) を使って get_allメソッドを呼び出しました。Input Data は、NisDomain オプションがメソッドに渡されたことを示しています。エラー・コード (e=12) と Results の出力から、NisDomain タイプの特定のリソースが見付からないことを示す例外が発生したことが分かります。
オプション-D 入力データのラージ・ブロックを出力します。
-E エラー・レコードの出力を抑制します。
-h 使用されるヘッダーを「old」形式で出力します。
wtrace
第 3 章 コマンド (アルファベット順) 435
-H 16 進ダンプの出力を抑制します。
-I 入力レコードの出力を抑制します。
-j 通常の画面 (80 桁) に適した形式で出力します。
-J ワイド画面 (132 桁) に適した形式で出力します。
-k db_dir
Tivoli データベース・ディレクトリーを指定します。
-l 長い出力形式で出力します。
-n トランザクションとトランザクションの間に、追加の改行をいくつか出力します。
-O 出力レコードの出力を抑制します。
-u 使用法ステートメントを出力します。
-v 冗長モードで出力します。
-V コマンドのバージョン番号を出力します。
format_options
出力の形式設定を変更する追加のオプションを指定します。使用可能な形式設定オプションは、次のとおりです。
-e lines
改行のしきい値を指定します。デフォルトは 5 です。
-f 短縮数値での出力 (たとえば 3219 の代わりに 3.2K など) をオフにします。
-t tab_size
タブの増分を指定します。デフォルトは 4 文字です。
-w width
形式設定後の行の最大幅を指定します。デフォルトは 80 です。
-W width
形式設定後の行の最小幅を指定します。デフォルトは 70 です。
例1. 以下の例は、現行のオブジェクト・ディスパッチャー内にあるオブジェクト呼び出しをすべてトレースできるようにします。
odadmin trace objcalls
2. 次の例は、すべてのオブジェクト・ディスパッチャー内にあるオブジェクト呼び出しをすべてトレースできるようにします。
odadmin trace objcalls all
3. 次の例は、現行のオブジェクト・ディスパッチャー内のエラー条件のトレースができるようにします。
odadmin trace errors
4. 次の例は、すべてのオブジェクト・ディスパッチャー内のオブジェクト・サービス呼び出しのトレースができるようにします。
odadmin trace services all
wtrace
436 Tivoli Management Framework: リファレンス・マニュアル
5. 次の例は、すべてのオブジェクト・ディスパッチャー内のオブジェクト・サービス呼び出しとエラーのトレースができるようにします。
odadmin trace services allodadmin trace errors all
障害トレース・ログが壊れると、wtrace コマンドがメモリー・ダンプを収集する場合があります。
参照odadmin
wtrace
第 3 章 コマンド (アルファベット順) 437
wuname
オペレーティング・システムの情報をリスト表示します。
構文wuname node_name
説明wuname コマンドは、指定された管理対象ノードのオペレーティング・システムを表示します。コマンドは、オペレーティング・システム、バージョン番号、リリース番号、およびハードウェア名を戻します。
オプションnode_name
管理対象ノードを指定します。
権限user、admin、senior、super
例次の例では、管理対象ノード bald のオペレーティング・システム情報が表示されます。
wuname bald
SunOS bald 5.3 Generic_101318-21 sun4m
参照wdate, wdiskspace, whostid, wifconfig, winstdir, winterp, wmannode,
wmemsize, wping, wxterm
438 Tivoli Management Framework: リファレンス・マニュアル
wuninst
指定のノードまたは Tivoli リージョン全体から Tivoli Enterprise 製品をアンインストールします。
構文wuninst
wuninst tag
wuninst -list
wuninst tag -list
wuninst tag node_name [-rmfiles] [options]
説明wuninst コマンドは、製品固有のアンインストール・スクリプトを呼び出すラッパー・スクリプトです。このセクションでは、このコマンドの使用法に関する一般的な情報を提供しています。このコマンドの使用方法は、各製品ごとに異なります。
一般的な使用方法を表示するには、コマンドを次のように入力します。
wuninst
特定の Tivoli Enterprise 製品の使用法ステートメントを表示するには、コマンドを次のように入力します。
wuninst tag
tag は、登録済みの製品タグです。
製品タグのリストを表示するには、コマンドを次のように入力します。
wuninst -list
node_name オプションを指定すると、tag で指定された Tivoli Enterprise 製品が、指定されたノードから除去されます。 node_name が Tivoli サーバーの場合は、製品がその Tivoli リージョン全体から除去されます。 Tivoli リージョンから製品を除去する前に、確認メッセージによって確認を求められます。
wunstmn コマンドで管理対象ノードをアンインストールする前に、wuninst コマンドでアプリケーション・ファイルをすべて削除してください。
オプション-list インストールされたアプリケーション・タグまたは製品がインストールされ
た管理対象ノードを表示します。tag オプションを指定して使用すると、-list は指定された製品がインストールされている管理対象ノードを表示します。それ以外のオプションを指定しないと、-list はインストールされたすべての製品のタグを表示します。
-rmfiles指定された管理対象ノードから除去するすべての製品ファイルを示します。
第 3 章 コマンド (アルファベット順) 439
このオプションを指定しないと、コマンドはデータベース項目のみを除去します。 Tivoli サーバーからこのオプションを指定してコマンドを発行すると、Tivoli リージョン内のそれぞれの管理対象ノードの全項目が除去されます。
node_name
製品を除去する管理対象ノードの名前を指定します。Tivoli サーバーを指定すると、製品は Tivoli リージョン内のすべての管理対象ノードから除去されます。
options 各製品で必要となる場合のあるオプションを示します。特定の製品をアンインストールするのに必要なオプションを表示するときは、wuninst tag コマンドを使用します。
tag 除去する Tivoli Enterprise製品の登録製品タグを指定します。
権限super
例1. 次の例では、コマンドの一般的な使用法ステートメントが戻されます。
wuninst
2. 次の例では、Tivoli リージョンにインストールされたすべての Tivoli Enterprise
製品の登録製品タグが表示されます。
wuninst -list
3. 次の例では、Tivoli Software Installation Service, Version 3.6 がインストールされている管理対象ノードがリストされます。
wuninst SIS_3.6 -list
4. 次の例では、Tivoli Software Installation Service を管理対象ノード kiwi から削除します。
wuninst SIS_3.6 kiwi
5. 次の例では、Tivoli Software Installation Service を管理対象ノード pctmp83 から削除します。この管理対象ノードは Tivoli サーバーなので、Tivoli Software
Installation Service はその Tivoli リージョン内のすべてのノードから削除されます。-rmfiles オプションは、データベース・エントリーと共にすべての製品ファイルが削除されることを示します。
wuninst SIS_3.6 pctmp83 -rmfiles
参照wunstmn
wuninst
440 Tivoli Management Framework: リファレンス・マニュアル
wunstmn
UNIX または Windows の管理対象ノードから Tivoli Management Framework ファイルを除去します。
構文wunstmn [-A] [-f] [-r] [-y] [...] [name [...]]
説明wunstmn コマンドは、指定した UNIX および Windows の管理対象ノードからTivoli Management Framework ファイルをアンインストールします。これらのファイルを除去すると、その管理対象ノードは Tivoli リージョンから除去されます。
このコマンドを実行するには、管理対象ノードを Tivoli サーバーに接続して$BINDIR/TAS/UNINST ディレクトリーからコマンドを実行する必要があります。管理対象ノードが Tivoli サーバーへの接続を失った場合は、-r オプションを指定してください。
注: このコマンドを発行するシステム上の Tivoli サーバーまたは管理対象ノードはアンインストールできません
Tivoli Enterprise アプリケーションがインストールされている管理対象ノードを除去するには、最初にwuninst コマンドを使用してアプリケーションを除去してから、wunstmn コマンドを使用して管理対象ノードを除去します。
-A オプションを指定しないと、wunstmn はクライアント・データベースだけを除去します。 -A オプションを指定すると、wunstmn コマンドは、Tivoli
Management Framework に関連したすべてのファイルを除去します。
注: 除去対象の管理対象ノードが、 Tivoli 環境に残しておきたい他の管理対象ノードとファイルを共用している場合は、 -A オプションを使用しないでください。
このコマンドは、インストール済みのファイルを除去したあとで、wrmnode コマンドを呼び出して、このノードの関するすべての項目を残りの Tivoli データベースから除去します。 wunstmn コマンドが完了したら、wchkdb コマンドでオブジェクト・データベースを同期化する必要があります。
オプション-A 指定した管理対象ノードからすべての Tivoli Management Framework ファ
イルを除去します。これには、ライブラリー、バイナリー、マニュアル・ページ、メッセージ・カタログなども含まれます。このオプションを指定しないと、コマンドは、指定された管理対象ノードのクライアント・データベースだけを除去します。
-f name オプションが、アンインストールする管理対象ノードのリストを含むファイル名であることを指定します。ファイル形式は、次のようになります。
第 3 章 コマンド (アルファベット順) 441
ManagedNode_name user_name
-r rexec を通信プロトコルとして使用します。オブジェクト・ディスパッチャーを実行していないときに管理対象ノードをアンインストールするには、このオプションを使用してください。
-y 確認メッセージを抑止します。このオプションを使用すると、複数の管理対象ノードに対して不在モードで wunstmn を実行できます。
name アンインストールする単一の管理対象ノードの名前、またはアンインストールする複数の管理対象ノードを指定したテキスト・ファイルの名前を指定します。 -f オプションと共に使用すると、name はテキスト・ファイルへのパスを指定します。ファイル名は複数指定できます。 -f オプションを指定しない場合、name は単一の管理対象ノードの名前です。
権限super
例1. 次の例では、Tivoli Management Framework およびすべてのファイルを管理対象ノード iandu-4 から除去します。
wunstmn -A iandu-4
2. 次の例では、nodelist という名前のファイルを使用して、管理対象ノードの 1 グループをアンインストールします。 -y オプションにより、確認メッセージを抑止しています。 -A を指定していないので、データベースだけが除去されます。すべての Tivoli Management Framework ファイルはノードに残ります。
wunstmn -f -y nodelist
参照wchkdb, wrmnode, wuninst
wunstmn
442 Tivoli Management Framework: リファレンス・マニュアル
wunsub
Tivoli リソースを、プロファイル・マネージャーのサブスクリプション・リストから削除します。
構文wunsub [-a] [-l] [-r] name [subscriber...]
説明wunsub コマンドは、指定された Tivoli リソースを、指定されたプロファイル・マネージャーのサブスクリプション・リストから削除します。
-l オプションを指定すると、このプロファイルからサブスクライバー・データベースに配布されるすべての構成情報がサブスクライバーのデータベースに保持されますが、この情報はサブスクライバーに対してローカルに設定されます。 -l オプションを指定しないと、このプロファイルから配布されたサブスクライバー・データベース内の構成情報は削除されます。
-a オプションを指定すると、現在のすべてのサブスクライバーが削除されます。
オプション-a 指定したプロファイル・マネージャーに対する現在のすべてのサブスクライ
バーを削除します。
-l サブスクライバーのデータベースは保持されますが、ローカルに設定されます。
-r 到達不可能なサブスクライバーがあった場合に、コマンドがエラー・コード(1) を戻すことを指定します。指定したサブスクライバーが存在しなかった場合は、常に障害コードが戻されます。
name リソースをサブスクリプション解除するプロファイル・マネージャーの名前です。有効な形式は、次のとおりです。
v profile_manager_name
v @ProfileManager:profile_manager_name
v /Regions/policy_region_name/profile_manager_name
subscriber...
指定したプロファイル・マネージャーのサブスクリプション・リストから削除する Tivoli リソースの名前です。このオプションを複数回指定できます。有効な形式は、次のとおりです。
v @node_name
v @ManagedNode:node_name
v @Endpoint:endpoint_label
v /Regions/policy_region_name/node_name
権限super、senior、admin
第 3 章 コマンド (アルファベット順) 443
例1. 次の例では、プロファイル・マネージャー pm1 のすべてのサブスクライバーがサブスクリプション解除され、サブスクライバーのデータベースに構成情報がローカルとして保持されます。
wunsub -a -l pm1
2. 次の例では、プロファイル・マネージャー pm1 から、サブスクライバー pm2
と mn1 がサブスクリプション解除されます。すべての構成情報は、サブスクライバーのデータベースから削除されます。
wunsub pm1 @ProfileManager:pm2 @ManagedNode:mn1
参照wcrtprf, wcrtprfmgr, wdistrib, wgetprf, wgetsub, wlssub, wpopulate, wsub,
wvalidate
wunsub
444 Tivoli Management Framework: リファレンス・マニュアル
wupdate
ローカル・ネーム・レジストリー内のリソースを更新します。
構文wupdate [-f] -r resource [-r resource...] regions...
説明wupdate コマンドは、1 つ以上のリモート Tivoli リージョンでローカルなネーム・レジストリー内のリソースを更新します。このコマンドを実行すると、ネーム・レジストリー内のリソースがロックされます。場合によっては (別の wupdateが実行されている場合など)、リソースがすでにロックされていることがあります。このコマンドは、60 秒間リソースのロックを試みたあとでタイムアウトになります。
オプション-f タイム・スタンプに関係なく、更新を強制実行します。
-r resource...
更新する 1 つ以上のリソース・タイプを指定します。リソース・タイプを指定することも、All を使用してすべてのリソース・タイプを更新することもできます。
regions...
更新する 1 つ以上の Tivoli リージョンを指定します。リージョンの名前を指定することもできますし、All を使用してすべてのリージョンを更新することもできます。
権限Tivoli リージョン内の senior または super
例1. 次の例では、ceridwen-Region でローカルなネーム・レジストリー内の
ManagedNode リソース・タイプが更新されます。
wupdate -r ManagedNode ceridwen-Region
2. 次の例では、ceridwen-Region と meiron-Region でローカルなネーム・レジストリー内のすべてのリソース・タイプが更新されます。
wupdate -r All ceridwen-Region meiron-Region
3. 次の例では、接続されたすべてのリージョンでローカルなネーム・レジストリー内の ProfileManager および AdministratorCollection リソースが更新されます。
wupdate -r ProfileManager -r AdministratorCollection All
4. 次の例では、リソース・タイプのタイム・スタンプに関係なく、すべてのリソース・タイプに対する更新を強制的に実行します。
wupdate -f -r All meiron-Region
第 3 章 コマンド (アルファベット順) 445
参照wconnect, wdisconn, wlsconn
wupdate
446 Tivoli Management Framework: リファレンス・マニュアル
wvalidate
プロファイルをその検証ポリシーと比較して検証します。
構文wvalidate name
説明wvalidate コマンドは、name で指定されたプロファイルをその検証ポリシーと比較して検証します。
オプションname ポリシーが検証されるプロファイルです。有効な形式は、次のとおりです。
v @prof_name
v @ProfileManager:prof_name
v /Regions/PolicyRegionName/prof_manager_name/prof_name
権限super、senior、admin
例次の例では、プロファイル pr1 が検証ポリシーと比較して検証されます。
wvalidate @TestProfile:pr1
参照wcrtprf, wcrtprfmgr, wdistrib, wgetprf, wgetsub, wlssub, wpopulate, wsub,
wunsub
第 3 章 コマンド (アルファベット順) 447
wxterm
指定されたディスプレイ上に X 端末のウィンドウを開きます。
構文wxterm -h node_name [xterm_options]
説明wxterm コマンドは、指定された管理対象ノード上に X 端末のウィンドウを開きます。また xterm プログラムを直接呼び出す場合、希望する構成オプションを指定することもできます。構成オプションが指定されていないと、このコマンドは、install_dir/bin/interp/TAS/xterm.sh スクリプト内にあるデフォルトの構成オプションを使用します。
オプション-h node_name
xterm プログラムの実行先の管理対象ノードを指定します。
xterm_options
xterm プログラムに渡されるオプションを指定します (デフォルト・フォント、カラーなど)。
権限senior、super
448 Tivoli Management Framework: リファレンス・マニュアル
第 2 部 ポリシー・メソッド第 4 章 エンドポイント・ポリシー・スクリプト 451エンドポイント・ポリシー・メソッド . . . . . 451allow_install_policy . . . . . . . . . . . . 452after_install_policy . . . . . . . . . . . . 456login_policy . . . . . . . . . . . . . . 459select_gateway_policy . . . . . . . . . . . 462
第 5 章 プロファイル・マネージャー・ポリシー・スクリプト . . . . . . . . . . . . . . 467プロファイル・マネージャーのデフォルト・ポリシー・メソッド . . . . . . . . . . . . . 467プロファイル・マネージャーの検証ポリシー・メソッド . . . . . . . . . . . . . . . . 467プロファイル・マネージャーのポリシー・メソッド 468pm_def_profile_managers . . . . . . . . . . 469pm_def_profile_types . . . . . . . . . . . 470pm_def_subscribers . . . . . . . . . . . . 471pm_val_remove_subscribers . . . . . . . . . 472pm_val_remove_subscription . . . . . . . . . 473pm_val_subscribers . . . . . . . . . . . . 474pm_val_subscription. . . . . . . . . . . . 475
第 6 章 タスク・ライブラリー・ポリシー・スクリプト . . . . . . . . . . . . . . . . 477タスク・ライブラリーのデフォルト・ポリシー・メソッド . . . . . . . . . . . . . . . . 477タスク・ライブラリーの検証ポリシー・メソッド 477タスク・ライブラリー・ポリシー・メソッド . . . 478tl_def_dist_mode. . . . . . . . . . . . . 479tl_def_man_nodes . . . . . . . . . . . . 480tl_def_prof_mgrs. . . . . . . . . . . . . 481tl_def_set_gid. . . . . . . . . . . . . . 482tl_def_set_uid. . . . . . . . . . . . . . 483tl_val_man_nodes . . . . . . . . . . . . 484tl_val_prof_mgrs . . . . . . . . . . . . . 485tl_val_set_gid. . . . . . . . . . . . . . 486tl_val_set_uid. . . . . . . . . . . . . . 487
第 7 章 ポリシー・スクリプトの編集 . . . . . 489エンドポイント・ポリシー・スクリプトの編集 . . 489プロファイル・マネージャーおよびタスク・ライブラリー・ポリシー・スクリプトの編集 . . . . . 490
© Copyright IBM Corp. 2004 449
450 Tivoli Management Framework: リファレンス・マニュアル
第 4 章 エンドポイント・ポリシー・スクリプト
Tivoli Management Framework のインストール時には、エンドポイント・ポリシー・スクリプトは空です。エンドポイント・ポリシー・スクリプトは、コマンド行オプションを受け取り、戻りコードを出して終了し、標準出力に出力を送信する実行可能ファイルであれば、どのようなタイプでも構いません。ほとんどの場合、シェル・スクリプトで十分ですが、状況によっては、Perl や C などのより柔軟性のあるプログラミング言語が必要な場合もあります。これらのスクリプト (login_policyを除く) の実行時には、エンドポイント・マネージャーが一度に処理することができるログインの量および効率に影響を与えます。
次の表に、エンドポイント・ポリシーのスクリプトと、そのスクリプトの実行元および実行時期を示します。
ポリシー名 実行元 実行時
allow_install_policy エンドポイント・マネージャーによって実行されます。
エンドポイントのインストール開始時に実行されます。
after_install_policy エンドポイント・マネージャーによって実行されます。
エンドポイント・マネージャーがエンドポイントの存在を記録した後、エンドポイントが初期ログイン情報を受け取る前に実行されます。
login_policy ゲートウェイによって実行されます。
エンドポイントがログインするたびに実行されます。
select_gateway_policy エンドポイント・マネージャーによって実行されます。
エンドポイントをゲートウェイに割り当てる必要が生じるたびに実行されます。
エンドポイント・ポリシー・メソッドこのセクションでは、エンドポイント・ポリシー・メソッドについて説明します。
© Copyright IBM Corp. 2004 451
allow_install_policy現行の Tivoli リージョンにエンドポイントをインストールできるかどうかを検証します。
構文allow_install_policy endpoint_label endpoint_object_id endpoint_interpreter_type
gateway_object_id endpoint_ip_address region dispatcher version unique_id protocol
説明allow_install_policy スクリプトは、現行の Tivoli リージョンにエンドポイントをインストールできるかどうかを検証します。デフォルトの動作では、このポリシーはエンドポイントのラベルが有効で使用中でない限り、エンドポイントのログインを許可します (デフォルトは、exit 0 です)。また、このスクリプトを使用して、エンドポイントがログインする前に別のプロセスを実行することもできます。ただし、このスクリプトを実行する時点ではエンドポイントは存在していないので、注意が必要です。それで、このスクリプトは Tivoli コマンドを実行できません。
このスクリプトが失敗すると、インストール・プロセスは終了し、Tivoli データベースには情報は書き込まれません。
エンドポイント・マネージャーは、ゲートウェイからエンドポイントの最初のログイン・パケットを受け取ると、allow_install_policy を実行します。その後のログインでは、このスクリプトは実行されません。allow_login_policy は、select_gateway_policy スクリプトの前に実行されます。
オプションdispatcher
エンドポイントのオブジェクト・ディスパッチャー番号を指定します。
endpoint_interpreter_type
エンドポイントのインタープリター・タイプを指定します。
endpoint_address
エンドポイントのインターネット・プロトコル (IP) アドレスとポート番号を指定します。
注: ホスト名の解決を、wepmgr ep_hostname_resolution コマンドを使用して可能にした場合、この値にはホスト名または IP アドレスのいずれかを指定できます。
endpoint_label
ログインするエンドポイントのラベルを指定します。
endpoint_object_id
エンドポイントのオブジェクト ID を指定します。
gateway_object_id
代行受信ゲートウェイのオブジェクト ID を指定します。
452 Tivoli Management Framework: リファレンス・マニュアル
protocol
ログインするエンドポイントで使用するネットワーク・プロトコルを指定します。
region エンドポイントの位置するリージョン番号を指定します。
unique_id
ログインするエンドポイントの固有 ID (インベントリー ID ともいいます)
を指定します。
version エンドポイント・ソフトウェアの現行バージョンを指定します。
環境変数これらの環境変数は、エンドポイント・マネージャーによってこのスクリプトが実行されると、自動的に設定されます。
LCF_DUPL_GATEWAY既存のエンドポイント・ゲートウェイのオブジェクト ID を指定します。
LCF_DUPL_INTERP既存のエンドポイントのインタープリターを指定します。
LCF_DUPL_INV_ID既存のエンドポイントのインベントリー ID を指定します。
LCF_DUPL_LOGIN既存のエンドポイントの最初の正常ログインのタイム・スタンプを指定します。
LCF_DUPL_NET_ADDRESS既存のエンドポイントのネットワーク・アドレスを指定します。
LCF_DUPL_OBJECT既存のエンドポイントのオブジェクト ID を指定します。
LCF_INVALID_LABELwepmgr コマンドの test_label オプションに従ってエンドポイントのラベルが有効かどうかを指定します。
例allow_install_policy スクリプトの例を以下に示します。この例では、サブネット146.84.26 上のエンドポイントは Tivoli 管理リージョン (TMR) にログインできません。また、名前にストリング dev が含まれているエンドポイントもログインを許可されません。
このスクリプトは UNIX オペレーティング・システム用です。 Windows オペレーティング・システムの場合は、awk ユーティリティーは、 UNIX で awk ユーティリティーが実行できる機能をすべてはサポートしていません。特に、次の点に注意してください。
awk ’{S="." ; print $2}’
allow_install_policy
第 4 章 エンドポイント・ポリシー・スクリプト 453
UNIX オペレーティング・システムでは、これでピリオドがレコード分離文字として設定されますが、Windows オペレーティング・システムではそうはなりません。Windows オペレーティング・システムの場合、awk ユーティリティーの構文は、次のとおりでなくてはなりません。
awk -F’.’ ’{ print $2 }’
注: 以下の例で指定するエンドポイント・ラベルは、 lcfd で宣言されるラベルで、ほとんどの場合はホスト名です。これは、完全修飾名 (spot.dev.tivoli.com) でも、そうでなくても (spot) 構いません。このラベルは、-Dlcs.machine_name=name オプションを使って変更できます。詳細については、lcfd コマンドを参照してください。
#!/bin/sh# Please do not remove the below Tivoli comments# --- Start of Tivoli comments ---## The following are the command line options passed to this script# from the Endpoint Manager.## $1 - The label of the endpoint machine# $2 - The object reference of the endpoint machine# $3 - The architecture type of the endpoint machine# $4 - The object reference of the gateway that the endpoint$ logged into# $5 - The ip/ipx address of the endpoint logging in (refer to# parameter $10 to determine the protocol of the endpoint).# $6 - region# $7 - dispatcher# $8 - version# $9 - The inventory id of the endpoint logging in.# $10 - The protocol of the endpoint logging in.# TCPIP -> TCP/IP# IPX -> IPX/SPX## A line with this format may be written to standard output to# change an endpoint label:# new_label = <label>## The normal exit code of 0 from the allow_install_policy will allow# the endpoint initial login to proceed. (If the label of this# endpoint is in use, or invalid, then this login will not complete.)## An exit code of 10 also will allow this login to proceed and,# if this endpoints label matches the label of an existing# endpoint, or if the endpoint label is invalid, then a unique# label will be created for this endpoint.## An exit code of 6 will cause this login to be ignored.## Exiting the allow_install_policy with any other non-zero exit status will# stop this endpoint initial (or orphaned) login.## The environment variable LCF_LOGIN_STATUS is also set by the epmgr.# A value of 2 indicates the endpoint is isolated. That is, it was unable# to contact its assigned gateway. Isolated endpoints are automatically# migrated to another gateway unless the select_gateway_policy terminates# with a non-zero exit status. Other LCF_LOGIN_STATUS values are:# 0 Initial login (allow_install_policy, select_gateway_policy,# after_install_policy)# 2 Isolated login (select_gateway_policy)# 3 Migratory login (select_gateway_policy)# 7 Orphaned login (allow_install_policy, select_gateway_policy,# after_install_policy)## The allow_install_policy will have these environment variables set if
allow_install_policy
454 Tivoli Management Framework: リファレンス・マニュアル
# there is already an existing endpoint with the same label as the endpoint# which is attempting to login:# LCF_DUPL_OBJECT object id of existing endpoint# LCF_DUPL_ADDRESS network address of existing endpoint# LCF_DUPL_LOGIN timestamp of existing endpoint first normal login# LCF_DUPL_GATEWAY object id of existing endpoint gateway# LCF_DUPL_INV_ID inventory id of existing endpoint# LCF_DUPL_INTERP interp (architecture type) of existing endpoint# The initial login will fail for an endpoint whose label matches the label# of an existing endpoint, unless allow_install_policy is exited with code 10.## The allow_install_policy will have the environment variable# LCF_INVALID_LABEL set to TRUE, if the endpoint label, $1, is invalid.# Endpoint labels must not contain any invalid characters and must conform# to the labelspace regular expression. A label may be tested with the# wepmgr test label command. Invalid characters and the labelspace regular# expression may be displayed and set with the wepmgr get and set commands.# An initial login will fail if the endpoint label is invalid, unless# allow_login_policy is exited with code 10, in which case a generic# label stem, "eplabel", is used as the beginning of the endpoint label.# The object dispatcher number and arbitrary characters will be added to# make the label unique.## Also note that during the execution of allow_install and select_gateway# policy scripts, the endpoint does not yet formally exist. For this reason,# the endpoint object reference will have a value of OBJECT_NIL and the# object dispatcher number will be 0. The endpoint label will have the value# suggested by the endpoint (or the user value lcfd -n) but is not guaranteed# to become the final endpoint lable. It will become the final endpoint label# if this value is not already taken by another endpoint.# --- End of Tivoli comments ---#set -e
## Don’t allow endpoints from subnet 26 log into this TMR.#
SUBNET=`echo $5 | awk ’{FS="."}} print $1"."$2"."$3 }’`if [ "$SUBNET" = "146.84.26" ]; then
exit 1fi
## Don’t allow endpoints whose name contain the regular# expression "dev".## This line will force the script to exit nonzero if the# expression "dev" is in the label.#echo $1 | grep -v dev
exit 0
allow_install_policy
第 4 章 エンドポイント・ポリシー・スクリプト 455
after_install_policyエンドポイントがゲートウェイに正常にログインした直後に、希望する処理を実行します。
構文after_install_policy endpoint_label endpoint_object_id endpoint_interpreter_type
gateway_object_id endpoint_ip_address region dispatcher version unique_id protocol
説明after_install_policy スクリプトは、エンドポイントが作成された直後に、希望する処理を実行します。このポリシーは、最初のログイン後にのみ実行され、その後のログインでは実行されません。
このスクリプトが失敗しても、ログイン・プロセスは停止されません。このスクリプトが実行される時点では、エンドポイントはすでに存在しています。このスクリプトに指定した後処理が失敗するだけです。
エンドポイント・マネージャーは、最初のゲートウェイ割り当ての直後、エンドポイント・ログイン・メソッドが代行受信ゲートウェイにコントロールを戻す前に、after_install_policy を実行します。これはエンドポイントの最初の正常ログインの前に行われるので、このスクリプトからダウンコールを実行することはできません。
オプションdispatcher
エンドポイントのオブジェクト・ディスパッチャー番号を指定します。
endpoint_interpreter_type
エンドポイントのインタープリター・タイプを指定します。
endpoint_address
エンドポイントのインターネット・プロトコル (IP) アドレスとポート番号を指定します。
注: ホスト名の解決を、wepmgr ep_hostname_resolution コマンドを使用して可能にした場合、この値にはホスト名または IP アドレスのいずれかを指定できます。
endpoint_label
スクリプトの実行対象エンドポイントのラベルを指定します。
endpoint_object_id
エンドポイントのオブジェクト ID を指定します。
gateway_object_id
割り当て先ゲートウェイのオブジェクト ID を指定します。
protocol
エンドポイントで使用するネットワーク・プロトコルを指定します。
region エンドポイントの位置するリージョン番号を指定します。
456 Tivoli Management Framework: リファレンス・マニュアル
unique_id
エンドポイントの固有 ID (インベントリー ID ともいいます) を指定します。
version エンドポイント・ソフトウェアの現行バージョンを指定します。
例次に、類似したアーキテクチャー・タイプのエンドポイントを記述するプロファイル・マネージャーに新しいエンドポイントをサブスクライブする例を示します。指定したポリシー・リージョンまたはプロファイル・マネージャーが存在しない場合は、自動的に作成されます。
#!/bin/sh# Please do not remove the below Tivoli comments# --- Start of Tivoli comments ---## The following are the command line options passed to# this script from the Endpoint Manager.## $1 - The label of the endpoint machine# $2 - The object reference of the endpoint machine# $3 - The interpreter type of the endpoint machine# $4 - The object reference of the assigned gateway that the# endpoint logged into# $5 - The IP address of the endpoint logging in# $6 - Region# $7 - Dispatcher# $8 - Version# $9 - The inventory id of the endpoint logging in# $10 - The protocol of the endpoint logging in.# TCPIP -> TCP/IP# IPX -> IPX/SPX## The environment variable LCF_LOGIN_STATUS is also set by the epmgr.# A value of 2 indicates the endpoint is isolated. That is, it was unable# to contact its assigned gateway. Isolated endpoints are automatically# migrated to another gateway unless the select_gateway_policy terminates# with a non-zero exit status. Other LCF_LOGIN_STATUS values are:# 0 Initial login (allow_install_policy, select_gateway_policy,# after_install_policy)# 2 Isolated login (select_gateway_policy)# 3 Migratory login (select_gateway_policy)# 7 Orphaned login (allow_install_policy, select_gateway_policy,# after_install_policy)# --- End of Tivoli comments ---LCF_POLICY_REGION=LCF-EndpointsPROFILE_MANAGER=LCF-$3EP=$1
## Check to see if our top-level policy region already# exists. If not create it and put it on this administrators# desktop.## Disable "exit on error" for this call since we will handle# the failure.#set +ewlookup -r PolicyRegion $LCF_POLICY_REGION > /dev/nullERR=$?set -e
if [ $ERR -ne 0 ]; thenALI=`objcall 0.0.0 get_security_objid`
after_install_policy
第 4 章 エンドポイント・ポリシー・スクリプト 457
set `objcall $ALI get_identity`ADMIN="$1"ADMIN_OID=’echo $2 |cut -d"#" -f1’wcrtpr -m ProfileManager -a $ADMIN $LCF_POLICY_REGIONidlcall $ADMIN_OID refresh_collection
fi
## Check to see if our interp specific profile manager# already exists. If not create it and make it dataless so# that we can subscribe the endpoint to it.## Disable "exit on error" for this call since we will handle# the failure.#set +ewlookup -r ProfileManager $PROFILE_MANAGER > /dev/nullERR=$?set -e
if [ $ERR -ne 0 ]; thenwcrtprfmgr $LCF_POLICY_REGION $PROFILE_MANAGER > /dev/nullwsetpm -d /Library/ProfileManager/$PROFILE_MANAGER
fi
## Subscribe the endpoint to the profile manager which# contains the endpoints for that specific interp type.#wsub /Library/ProfileManager/$PROFILE_MANAGER ¥@Endpoint:$EP
exit 0
after_install_policy
458 Tivoli Management Framework: リファレンス・マニュアル
login_policyエンドポイントがログインするたびに、希望する処理を実行します。
構文login_policy endpoint_label endpoint_object_id endpoint_interpreter_type
gateway_object_id endpoint_ip_address region dispatcher version unique_id protocol
説明login_policy スクリプトは、エンドポイントがログインするたびに、希望する処理を実行します。このポリシーは、エンドポイントの割り当て先ゲートウェイによって実行されます。 Tivoli リージョン内のすべてのゲートウェイで同じポリシー・スクリプトが実行されます。
注: このポリシーは、バイナリーの使用をサポートしません。
このスクリプトの 1 つの特徴は、各クライアントのエンドポイント・ソフトウェアを自動的にアップグレードするように設定できることです。エンドポイント・ソフトウェアをアップグレードする login_policy スクリプトを設定するには、次の手順に従ってください。
1. upgrade.cntl ファイル内の upgrade_mode エントリーを auto に変更することにより、$BINDIR/../lcf_bundle/upgrade 内のアップグレード・スクリプト(upgrade.sh) を有効にします。この手順は、ゲートウェイごとに実行する必要があります。
2. upgrade.sh を呼び出すために login_policy スクリプトを編集します。次のスクリプト例には、このオプションが含まれます。アップグレード・スクリプトの出力のログを記録するには、定義しておく必要があります。
エンドポイント・ゲートウェイは、エンドポイントがログインするたびにlogin_policy を実行します。
オプションdispatcher
エンドポイントのオブジェクト・ディスパッチャー番号を指定します。
endpoint_interpreter_type
エンドポイントのインタープリター・タイプを指定します。
endpoint_address
エンドポイントのインターネット・プロトコル (IP) アドレスとポート番号を指定します。
endpoint_label
スクリプトの実行対象エンドポイントのラベルを指定します。
endpoint_object_id
エンドポイントのオブジェクト ID を指定します。
gateway_object_id
割り当て先ゲートウェイのオブジェクト ID を指定します。
第 4 章 エンドポイント・ポリシー・スクリプト 459
protocol
エンドポイントで使用するネットワーク・プロトコルを指定します。
region エンドポイントの位置するリージョン番号を指定します。
unique_id
エンドポイントの固有 ID (インベントリー ID ともいいます) を指定します。
version エンドポイント・ソフトウェアの現行バージョンを指定します。
例次に、エンドポイントがログインするたびにエンドポイント関連の通知グループへの通知を記録し、エンドポイント・ソフトウェアを自動的にアップグレードする例を示します。
#!/bin/sh
# Please do not remove the below Tivoli comments# --- Start of Tivoli comments ---## The following are the command line options passed to this script# from the Gateway.## $1 - The label of the endpoint machine# $2 - The object reference of the endpoint machine# $3 - The architecture type of the endpoint machine# $4 - The object reference of the gateway that the endpoint logged into# $5 - The ip/ipx address of the endpoint logging in (refer to parameter# $10 to determine the protocol of the endpoint).# $6 - region# $7 - dispatcher# $8 - version# $9 - The inventory id of the endpoint# $10 - The protocol of the endpoint logging in.# TCPIP -> TCP/IP# IPX -> IPX/SPX## --- End of Tivoli comments ---## AUTO UPGRADE# Invoke the upgrade script to check the current version of# the endpoint software and upgrade if necessary.BO=`objcall 0.0.0 self`OS=`objcall $BO getattr oserv`INSTALLDIR=`objcall $OS query install_dir|tr ’¥134’ ’/’`$INSTALLDIR/lcf_bundle/upgrade/upgrade.sh $1 $8 $3#LCF_NOTICE_GROUP=LCF_Endpoints## Send a notice to LCF endpoint notice group every time this# endpoint logs in.#set +ewlookup -r TMF_Notice $LCF_NOTICE_GROUP > /dev/nullERR=$?set -eif [ $ERR -ne 0 ]; then
NTFGM=`wlookup -r Classes TMF_Notice`idlcall -T top $NTFGM ¥
TMF_Notice::NoticeManager::create_notice_group ¥’"’$LCF_NOTICE_GROUP’" 72’
fi
login_policy
460 Tivoli Management Framework: リファレンス・マニュアル
GW=`idlcall $4 _get_label`EPOID=`wlookup -o -r Endpoint $1`
wsndnotif $LCF_NOTICE_GROUP Notice << LCF_NOTICEEndpoint $1 ($EPOID of interp type, $3, logged into gateway$GW ($4).LCF_NOTICE
exit 0
login_policy
第 4 章 エンドポイント・ポリシー・スクリプト 461
select_gateway_policyエンドポイントの管理を許可されている一連のゲートウェイを判別します。
構文select_gateway_policy endpoint_label endpoint_object_id endpoint_interpreter_type
gateway_object_id endpoint_ip_address region dispatcher version unique_id protocol
説明select_gateway_policy スクリプトは、エンドポイントの管理を許可されている一連のゲートウェイを判別します。select_gateway_policy は、エンドポイントが孤立している場合、あるいはエンドポイントが移行ログインを行う場合の最初のログイン時に実行されます。
このスクリプトでゲートウェイが戻らないと、エンドポイント・マネージャーはデフォルトの選択プロセスを実行し、最高 5 つまでのゲートウェイからなるリストをエンドポイント・リージョンに生成します。エンドポイント・マネージャーのデフォルトの選択プロセスは、select_gateway_policy によって変更されます。このポリシーを定義しないと、使用可能なゲートウェイのリストの最後に代行受信ゲートウェイが追加されます。
また、代行受信ゲートウェイは、エンドポイントに少なくとも 1 つ以上の確実な接続があるように、select_gateway_policy リストの最後に追加されます。エンドポイント・マネージャーがスクリプトに戻されたゲートウェイのいずれにも接続できない場合、エンドポイント・マネージャーは、代行受信ゲートウェイをエンドポイントに割り当てます。このスクリプトが失敗する (ゼロ以外が戻る) と、ログインは失敗します。 select_gateway_policy が正常に実行されると、割り当てられたゲートウェイのオブジェクト ID がエンドポイントに渡されます。
エンドポイント・マネージャーは、allow_install_policy の実行後にエンドポイントの初期ログイン・パケットを受け取ると、select_gateway_policy を実行します。
オプションdispatcher
エンドポイントのオブジェクト・ディスパッチャー番号を指定します。
endpoint_interpreter_type
エンドポイントのインタープリター・タイプを指定します。
endpoint_address
エンドポイントのインターネット・プロトコル (IP) アドレスとポート番号を指定します。
注: ホスト名の解決を、wepmgr ep_hostname_resolution コマンドによって可能にした場合、この値にはホスト名または IP アドレスのいずれかを指定できます。
endpoint_label
スクリプトの実行対象エンドポイントのラベルを指定します。
462 Tivoli Management Framework: リファレンス・マニュアル
endpoint_object_id
エンドポイントのオブジェクト ID を指定します。
gateway_object_id
割り当て先ゲートウェイのオブジェクト ID を指定します。
protocol
エンドポイントで使用するネットワーク・プロトコルを指定します。
region エンドポイントの位置するポリシー・リージョンを指定します。
unique_id
エンドポイントの固有 ID (インベントリー ID ともいいます) を指定します。
version エンドポイントの現行バージョンを指定します。
例エンドポイント・マネージャーからこのスクリプトに渡されるオプションは、前述した 3 つのエンドポイント・ポリシー・スクリプトと同じものです。LCF_LOGIN_STATUS 変数も、エンドポイント・マネージャーによっても設定されます。2 の値は、エンドポイントが孤立している (そのエンドポイントに割り当てられたゲートウェイに接続できない) ことを示します。 select_gateway_policy スクリプトがゼロ以外の終了状況で終了した場合を除き、孤立したエンドポイントは別のゲートウェイに自動的にマイグレーションします。エンドポイントの分離またはマイグレーションの詳細については、「Tivoli Management Framework デプロイメントの計画ガイド」を参照してください。
注: このスクリプトの実行時には、エンドポイントは正式にまだ存在しません。したがって、エンドポイントのオブジェクト参照子の値は、OBJECT_NIL で、オブジェクト・ディスパッチャー番号は 0 です。エンドポイント・ラベルの値は、エンドポイントによって (または、ユーザーが -n オプションを指定したlcfd コマンドを使用して) 指定されますが、別のエンドポイントによってその値がまだ取得されていない場合にのみその値が最終的なラベルとなります。
ゲートウェイとエンドポイントがネットワーク・アドレス変換 (NAT) デバイスによって分離されている場合は、オブジェクト ID の後ろにパイプ (|) 記号を付けてゲートウェイの完全修飾ホスト名を追加する必要があります。たとえば、ゲートウェイ paris の完全修飾名が paris.dev.server.com で、オブジェクト ID が123267682.1.529 の場合、select_gateway_policy スクリプトには次のように入力します。
123267682.1.529|paris.dev.server.com
スクリプトの例を紹介します。
#!/bin/sh# Please do not remove the below Tivoli comments# --- Start of Tivoli comments ---## The following are the command line options passed to# this script from the Endpoint Manager.## $1 - The label of the endpoint machine# $2 - The object reference of the endpoint machine# $3 - The interpreter type of the endpoint machine
select_gateway_policy
第 4 章 エンドポイント・ポリシー・スクリプト 463
# $4 - The object reference of the assigned gateway that the# endpoint logged into# $5 - The IP address of the endpoint logging in# $6 - Region# $7 - Dispatcher# $8 - Version# $9 - The inventory id of the endpoint logging in# $10 - The protocol of the endpoint logging in.# TCPIP -> TCP/IP# IPX -> IPX/SPX## The environment variable LCF_LOGIN_STATUS is also set by the epmgr.# A value of 2 indicates the endpoint is isolated. That is, it was unable# to contact its assigned gateway. Isolated endpoints are automatically# migrated to another gateway unless the select_gateway_policy terminates# with a non-zero exit status. Other LCF_LOGIN_STATUS values are:# 0 Initial login (allow_install_policy, select_gateway_policy,# after_install_policy)# 2 Isolated login (select_gateway_policy)# 3 Migratory login (select_gateway_policy)# 7 Orphaned login (allow_install_policy, select_gateway_policy,# after_install_policy)# Also note that during the execution of allow_install and select_gateway# policy scripts, the endpoint does not yet formally exist. For this reason,# the endpoint object reference will have a value of OBJECT_NIL and the# object dispatcher number will be 0. The endpoint label will have the value# suggested by the endpoint (or the user value lcfd -n) but is not guaranteed# to become the final endpoint label. It will become the final endpoint label# if this value is not already taken by another endpoint.## NB: That the version in $8 is not defined when the sgp is called during a# migratory completion by login or upcall.# --- End of Tivoli comments ---
# only ep_ip is needed for this exampleep_label=$1ep_oid=$2ep_interp=$3gateway=$4ep_ip=$5region=$6dispatcher=$7version=$8#FOUNDONE=FALSE# we just want the subnet of the endpointSUBNET=`echo $ep_ip|cut -d’.’ -f3`# get all gateways and find ones that are on the same subnetGATEWAYS=`wlookup -ar Gateway -o`
for gwoid in $GATEWAYSdogwproxy=`idlattr -tg $gwoid proxy Object`mnips=`wifconfig -h $gwproxy | grep -v Device | awk’(print $2)’`
# a managed node might have multiple interfaces, so check each# one of them if the gateway subnet matches the endpoint number.# return gwoid if it matchesfor ip in $mnipsdogwsub=`echo $ip | cut -d’.’ -f3`if [ $gwsub -eq $SUBNET ]thenecho $gwoidFOUNDONE=TRUEfi
select_gateway_policy
464 Tivoli Management Framework: リファレンス・マニュアル
donedone
#if you did not find a gateway, and you still want the endpoint# to log in, exit 0, else exit 1if [ "$FOUNDONE" = "TRUE" ]then
exit 1else
exit 0fi
select_gateway_policy
第 4 章 エンドポイント・ポリシー・スクリプト 465
466 Tivoli Management Framework: リファレンス・マニュアル
第 5 章 プロファイル・マネージャー・ポリシー・スクリプト
Tivoli Management Framework では、プロファイル・マネージャー・サービスを対象にしたデフォルト・ポリシーと検証ポリシーを提供しています。
プロファイル・マネージャーのデフォルト・ポリシーは、プロファイル・マネージャーのサブスクライバーとして設定できる管理対象ノードを定義し、プロファイルの複製を入れることのできるプロファイル・マネージャーを定義します。
検証ポリシーが検証する内容は、次のとおりです。
v サブスクライバーをプロファイル・マネージャーから削除できるかどうか。
v プロファイル・マネージャーがサブスクリプションを削除できるかどうか。
v サブスクライバーをプロファイル・マネージャーに追加できるかどうか。
v プロファイル・マネージャーを別のプロファイル・マネージャーにサブスクライブできるかどうか。
プロファイル・マネージャーのデフォルト・ポリシー・メソッド次の表に、プロファイル・マネージャーのデフォルト・ポリシー・メソッドとその目的を示します。
メソッド 説明
pm_def_profile_managers プロファイルの複製を入れることのできるプロファイル・マネージャーのリストを提供します。
pm_def_profile_types 指定したリージョンによって管理されるプロファイル・タイプのリストを提供します。
pm_def_subscribers プロファイル・マネージャーのサブスクライバーに、設定できる管理対象ノードのリストを提供します。
プロファイル・マネージャーの検証ポリシー・メソッド次の表に、プロファイル・マネージャーの検証ポリシー・メソッドとその目的を示します。
メソッド 説明
pm_val_remove_subscribers プロファイル・マネージャーからのサブスクライバーの除去を検証します。
pm_val_remove_subscription プロファイル・マネージャーに対するサブスクリプションの取り消しが可能かどうかを検証します。
pm_val_subscribers サブスクライバーをプロファイル・マネージャーに追加できるかどうかを検証します。
© Copyright IBM Corp. 2004 467
メソッド 説明
pm_val_subscription プロファイル・マネージャーの、別のプロファイル・マネージャーへのサブスクリプションを検証します。
プロファイル・マネージャーのポリシー・メソッドこのセクションでは、プロファイル・マネージャーのデフォルト・ポリシー・メソッドと検証ポリシー・メソッドについて説明します。
468 Tivoli Management Framework: リファレンス・マニュアル
pm_def_profile_managers
プロファイルの複製を入れることのできるプロファイル・マネージャーのリストを提供します。
リソースProfileManager
構文pm_def_profile_managers manager_name
説明pm_def_profile_managers メソッドは、プロファイルの複製を入れるプロファイル・マネージャーのリストを戻します。
このメソッドは、pm_def_profile_managers スクリプトを実行します。このスクリプトは、1 行に 1 つのプロファイル・マネージャーが記述されたプロファイル・マネージャー・リストを標準出力に書き込みます。このスクリプトはカスタマイズ可能です。スクリプトの出力は、フォーマットのラベル、タブ文字、オブジェクトID の順でなければなりません。
たとえば、ラベルが PM1 で OID が1214115201.1.616#TMF_CCMS::ProfileManager# の場合、次の ASCII 文字が標準出力に書き込まれることになります。
PM1¥t1214115201.1.616#TMF_CCMS::ProfileManager#¥n
出力は、「プロファイルの複製」ウィンドウの「複製先プロファイル・マネージャー」スクロール・リストに表示されます。
デフォルトの実装では、pm_def_profile_managers は全 Tivoli 管理リージョン(TMR) 内の、リソース・タイプが ProfileManager のすべてのインスタンスのリストを戻します。
オプションmanager_name
複製対象のプロファイルが登録されているプロファイル・マネージャーの名前を指定します。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドが正常に完了しました。
1 メソッドはエラーを戻して終了しました。標準出力は未定義です。
第 5 章 プロファイル・マネージャー・ポリシー・スクリプト 469
pm_def_profile_types
指定したリージョンによって管理されるプロファイル・タイプのリストを提供します。
リソースProfileManager
構文pm_def_profile_types region
説明pm_def_profile_types メソッドは、指定したリージョンによって管理されるプロファイル・タイプのリストを提供します。
このメソッドは、pm_def_profile_types スクリプトを実行します。このスクリプトは、1 行に 1 つのプロファイル・タイプが記述されたプロファイル・タイプ・リストを標準出力に書き込みます。出力は、「プロファイルの作成」ウィンドウに表示されます。
pm_def_profile_types のデフォルトの実装では、指定したリージョンによって管理されるすべてのプロファイル・タイプのリストが戻されます。
オプションregion プロファイルを作成するポリシー・リージョンの名前を指定します。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドは正常に終了しました。プロファイル・タイプ が標準出力に書き込まれます。
1 メソッドはエラーを戻して終了しました。標準出力は未定義です。
470 Tivoli Management Framework: リファレンス・マニュアル
pm_def_subscribers
プロファイル・マネージャーのサブスクライバーに、設定できる管理対象ノードのリストを提供します。
リソースProfileManager
構文pm_def_subscribers manager_name
説明pm_def_subscribers メソッドは、プロファイル・マネージャーのサブスクライバーに設定できる管理対象ノード、プロファイル・マネージャー、およびエンドポイントのリストを戻します。
このメソッドは、pm_def_subscribers スクリプトを実行します。このスクリプトは、1 行に 1 つのサブスクライバーが記述されたサブスクライバーのリストを標準出力に書き込みます。このスクリプトはカスタマイズ可能です。スクリプトの出力は、フォーマットのラベル、タブ文字、オブジェクト ID の順でなければなりません。
たとえば、ラベルが reality で OID が1214115201.3.7#TMF_ManagedNode::ManagedNode# の場合、次の ASCII 文字が標準出力に書き込まれることになります。
reality¥t1214115201.3.7#TMF_ManagedNode::Managed_Node#¥n
出力は、「サブスクライバー」ウィンドウの「サブスクライバーとして使用可能」スクロール・リストに表示されます。
pm_def_subscribers のデフォルト・インプリメンテーションでは、すべてのTivoli リージョン内の ProfileManager および ManagedNode リソース・タイプのインスタンスをすべて戻します。
オプションmanager_name
サブスクリプション先のプロファイル・マネージャーの名前を指定します。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドが正常に完了しました。
1 メソッドはエラーを戻して終了しました。標準出力は未定義です。
参照pm_val_remove_subscribers, pm_val_remove_subscription,
pm_val_subscribers, pm_val_subscription
第 5 章 プロファイル・マネージャー・ポリシー・スクリプト 471
pm_val_remove_subscribers
プロファイル・マネージャーからサブスクライバーを除去できるかどうかを検証します。
リソースProfileManager
構文pm_val_remove_subscribers localize manager_name subscriber...
pm_val_remove_subscribers delete manager_name subscriber...
説明pm_val_remove_subscribers メソッドは、プロファイル・マネージャーからサブスクライバーを除去できるかどうかを検証します。
このメソッドは、pm_val_remove_subscribers スクリプトを実行します。このスクリプトは、除去の検証基準を満たしている場合は TRUE を、検証基準を満たしていない場合は FALSE を標準出力に書き込みます。
Tivoli Management Framework におけるデフォルト値は TRUE です。
オプションdelete サブスクライバーを削除するときにこのアクションが実行されることを示し
ます。
localizeサブスクライバーを削除するときにこのアクションが実行されることを示します。
manager_name
プロファイル・マネージャーの名前を指定します。
subscriber...
削除対象のサブスクライバーのリストを指定します。サブスクライバーはスペースで区切って指定してください。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドは正常に終了しました。TRUE または FALSE が標準出力に書き込まれます。
1 メソッドはエラーを戻して終了しました。標準出力は未定義です。
参照pm_val_remove_subscription, pm_val_subscription
472 Tivoli Management Framework: リファレンス・マニュアル
pm_val_remove_subscription
プロファイル・マネージャーに対するサブスクリプションの取り消しが可能かどうかを検証します。
リソースProfileManager
構文pm_val_remove_subscription subscriber localize manager_name
pm_val_remove_subscription subscriber delete manager_name
説明pm_val_remove_subscription メソッドは、プロファイル・マネージャーまたはエンドポイントによるプロファイル・マネージャーへのサブスクリプションの取り消しが可能かどうかを検証します。このメソッドは、pm_val_remove_subscriptionスクリプトを実行します。このスクリプトは、削除の検証基準を満たしている場合は TRUE を、検証基準を満たしていない場合は FALSE を標準出力に書き込みます。
Tivoli Management Framework におけるデフォルト値は TRUE です。
オプションdelete サブスクライバーを削除するときにこのアクションが実行されることを示し
ます。
localizeサブスクライバーを削除するときにこのアクションが実行されることを示します。
manager_name
サブスクライバーのサブスクライブ先のプロファイル・マネージャーを指定します。
subscriber
サブスクライバーであるプロファイル・マネージャーまたはエンドポイントの名前を指定します。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドは正常に終了しました。TRUE または FALSE が標準出力に書き込まれます。
1 メソッドはエラーを戻して終了しました。標準出力は未定義です。
参照pm_val_remove_subscribers, pm_val_subscription
第 5 章 プロファイル・マネージャー・ポリシー・スクリプト 473
pm_val_subscribers
サブスクライバーをプロファイル・マネージャーに追加できるかどうかを検証します。
リソースProfileManager
構文pm_val_subscribers manager_name subscriber...
説明pm_val_subscribers メソッドは、プロファイル・マネージャーにサブスクライバーを追加できるかどうかを検証します。このメソッドは、pm_val_subscribers スクリプトを実行します。このスクリプトは、新しいサブスクライバーが検証基準を満たしている場合は TRUE を、検証基準を満たしていない場合は FALSE を標準出力に書き込みます。
Tivoli Management Framework におけるデフォルト値は TRUE です。
オプションmanager_name
プロファイル・マネージャーの名前を指定します。
subscriber...
検証対象となる新規サブスクライバーのリストを指定します。サブスクライバーはスペースで区切って指定してください。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドは正常に終了しました。TRUE または FALSE が標準出力に書き込まれます。
1 メソッドはエラーを戻して終了しました。標準出力は未定義です。
参照pm_val_remove_subscribers, pm_val_remove_subscription,
pm_val_subscription
474 Tivoli Management Framework: リファレンス・マニュアル
pm_val_subscription
プロファイル・マネージャーのサブスクリプションを別のプロファイル・マネージャーへ追加できるかどうかを検証します。
リソースProfileManager
構文pm_val_subscription subscribee manager_name
説明pm_val_subscription メソッドは、プロファイル・マネージャーまたはエンドポイントによるプロファイル・マネージャーへのサブスクリプションの追加が可能かどうかを検証します。このメソッドは、pm_val_subscription スクリプトを実行します。このスクリプトは、サブスクリプションが検証基準を満たしている場合は TRUE
を、検証基準を満たしていない場合は FALSE を標準出力に書き込みます。
Tivoli Management Framework におけるデフォルト値は TRUE です。
オプションmanager_name
サブスクライバーであるプロファイル・マネージャーまたはエンドポイントを指定します。
subscribee
サブスクリプション先のプロファイル・マネージャーを指定します。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドは正常に終了しました。TRUE または FALSE が標準出力に書き込まれます。
1 メソッドはエラーを戻して終了しました。標準出力は未定義です。
参照pm_val_remove_subscribers, pm_val_remove_subscription
第 5 章 プロファイル・マネージャー・ポリシー・スクリプト 475
476 Tivoli Management Framework: リファレンス・マニュアル
第 6 章 タスク・ライブラリー・ポリシー・スクリプト
タスク・ライブラリーでは、デフォルト・ポリシーによって、タスクやジョブの作成時に関連付けられる管理対象ノードおよびプロファイル・マネージャーのリストを設定します。
検証ポリシーが検証する内容は、次のとおりです。
v 既存のタスクやジョブが適切な管理対象ノードおよびプロファイル・マネージャーに関連付けられているかどうか
v そのタスクやジョブの実行に使用する有効グループ ID および有効ユーザー ID
が妥当かどうか
タスク・ライブラリーのデフォルト・ポリシー・メソッド次の表に、タスク・ライブラリーのデフォルト・ポリシー・メソッドとその目的を示します。
メソッド 説明
tl_def_dist_mode Tivoli リージョンにタスク・バイナリーを配布するためのデフォルト・モードを戻します。
tl_def_man_nodes 管理対象ノードおよびエンドポイントのデフォルト・リストをタスク・ライブラリーに戻します。
tl_def_prof_mgrs プロファイル・マネージャーのデフォルト・リストをタスク・ライブラリーに戻します。
tl_def_set_gid タスクに割り当てられたデフォルトのグループID を提供します。
tl_def_set_uid タスクに割り当てられたデフォルトのユーザーID を提供します。
タスク・ライブラリーの検証ポリシー・メソッド次の表に、タスク・ライブラリーの検証ポリシー・メソッドとその目的を示します。
メソッド 説明
tl_val_man_nodes タスクまたはジョブを実行するターゲット管理対象ノードおよびエンドポイントのリストを検証します。
tl_val_prof_mgrs タスクまたはジョブに関連付けられたターゲット・プロファイル・マネージャーのリストを検証します。
tl_val_set_gid タスクまたはジョブに割り当てられた有効なグループ ID を検証します。
© Copyright IBM Corp. 2004 477
メソッド 説明
tl_val_set_uid タスクまたはジョブに割り当てられた有効なユーザー ID を検証します。
タスク・ライブラリー・ポリシー・メソッドこのセクションでは、タスク・ライブラリーのデフォルト・ポリシー・メソッドと検証ポリシー・メソッドについて説明します。
478 Tivoli Management Framework: リファレンス・マニュアル
tl_def_dist_mode
Tivoli リージョンにタスク・バイナリーを配布するためのデフォルト・モードを戻します。
リソースTaskLibrary
構文tl_def_dist_mode
説明tl_def_dist_mode メソッドは、タスクの作成時にタスクの実行可能ファイルを配布するためのデフォルト・モードを戻します。有効な配布モードは次のとおりです。
ALI タスク・バイナリーを Tivoli サーバー だけにコピーします。
GLOBALタスク・バイナリーを、接続されているすべての Tivoli リージョンのすべての管理対象ノードにコピーします。
LOCALタスク・バイナリーを、ローカル Tivoli リージョン内のすべての管理対象ノードにコピーします。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドが正常に完了しました。
1 メソッドを呼び出したオプションが無効です。
2 エラーが発生しました。
第 6 章 タスク・ライブラリー・ポリシー・スクリプト 479
tl_def_man_nodes
管理対象ノードおよびエンドポイントのデフォルト・リストをタスク・ライブラリーに戻します。
リソースTaskLibrary
構文tl_def_man_nodes task_name administrator_name
説明tl_def_man_nodes メソッドは、管理対象ノードとエンドポイントのデフォルト・リストをタスク・ライブラリーに戻します。tl_def_man_nodes メソッドは、tl_def_man_nodes.sh スクリプトを実行します。このスクリプトは、タスクの実行先候補の ManagedNode リソースおよび Endpoint リソースのリストを戻します。
このメソッドは、1 行に 1 つのノードが記述された管理対象ノードおよびエンドポイントのリストを標準出力に書き込みます。
オプションadministrator_name
このメソッドを呼び出したアドミニストレーターの名前を指定します。
task_name
リストの生成対象となるタスクを指定します。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドが正常に完了しました。
1 メソッドを呼び出したオプションが無効です。
2 エラーが発生しました。
参照tl_def_prof_mgrs
480 Tivoli Management Framework: リファレンス・マニュアル
tl_def_prof_mgrs
プロファイル・マネージャーのデフォルト・リストをタスク・ライブラリーに戻します。
リソースTaskLibrary
構文tl_def_prof_mgrs task_name administrator_name
説明tl_def_prof_mgrs メソッドは、プロファイル・マネージャーのデフォルト・リストをタスク・ライブラリーに提供します。このスクリプトは、タスクの実行先であることができる ProfileManager リソースのリストを提供します。
このメソッドは、1 行に 1 つのプロファイル・マネージャーが記述されたプロファイル・マネージャー・リストを標準出力に書き込みます。
オプションadministrator_name
このメソッドを呼び出したアドミニストレーターの名前を指定します。
task_name
リストの生成対象となるタスクを指定します。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドが正常に完了しました。
1 メソッドを呼び出したオプションが無効です。
2 エラーが発生しました。
参照tl_val_man_nodes
第 6 章 タスク・ライブラリー・ポリシー・スクリプト 481
tl_def_set_gid
タスクに割り当てられたデフォルトのグループ ID を提供します。
リソースTaskLibrary
構文tl_def_set_gid administrator_name
説明tl_def_set_gid メソッドは、タスクと関連付けられたデフォルトのグループ ID を提供します。
スクリプトは、グループ ID を標準出力に書き込みます。出力は、「タスクの作成」ウィンドウに表示されます。
オプションadministrator_name
このメソッドを呼び出したアドミニストレーターの名前を指定します。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドが正常に終了したことを示します。メソッドはグループ ID を標準出力に書き込みます。
1 メソッドはエラーを戻して終了しました。メソッドの標準出力は保証されません。
参照tl_def_set_uid
482 Tivoli Management Framework: リファレンス・マニュアル
tl_def_set_uid
タスクに割り当てられたデフォルトのユーザー ID を提供します。
リソースTaskLibrary
構文tl_def_set_uid administrator_name
説明tl_def_set_uid メソッドは、タスクに割り当てられたデフォルトのユーザー ID を提供します。
スクリプトはユーザー ID を標準出力に書き込みます。出力は、「タスクの作成」ウィンドウに表示されます。
オプションadministrator_name
このメソッドを呼び出したアドミニストレーターの名前を指定します。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドが正常に終了したことを示します。メソッドはユーザー ID を標準出力に書き込みます。
1 メソッドはエラーを戻して終了しました。メソッドの標準出力は保証されません。
参照allow_install_policy
第 6 章 タスク・ライブラリー・ポリシー・スクリプト 483
tl_val_man_nodes
タスクまたはジョブに関連付けられたターゲット管理対象ノードおよびエンドポイントのリストを検証します。
リソースTaskLibrary
構文tl_val_man_nodes task_name administrator_name node_name...
説明tl_val_man_nodes メソッドは、タスクまたはジョブに関連付けられた管理対象ノードおよびエンドポイントのリストを検証します。
このスクリプトは、リストが検証基準を満たしている場合は TRUE を、検証基準を満たしていない場合は FALSE を標準出力に書き込みます。 Tivoli Management
Framework におけるデフォルト値は TRUE です。
オプションadministrator_name
このメソッドを呼び出したアドミニストレーターの名前を指定します。
node_name
検証対象となる管理対象ノードおよびエンドポイントのリストを指定します。名前はスペースで区切って指定してください。
task_name
タスクまたはジョブの名前を指定します。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドは正常に終了しました。TRUE または FALSE が標準出力に書き込まれます。
1 メソッドはエラーを戻して終了しました。メソッドの標準出力は未定義です。
参照tl_def_prof_mgrs, tl_val_set_gid, tl_val_set_uid
484 Tivoli Management Framework: リファレンス・マニュアル
tl_val_prof_mgrs
タスクまたはジョブに関連付けられたターゲット・プロファイル・マネージャーのリストを検証します。
リソースTaskLibrary
構文tl_val_prof_mgrs task_name administrator_name profile_manager_name...
説明tl_val_prof_mgrs メソッドは、タスクまたはジョブに関連付けられたターゲット・プロファイル・マネージャーのリストを検証します。
このスクリプトは、リストが検証基準を満たしている場合は TRUE を、検証基準を満たしていない場合は FALSE を標準出力に書き込みます。デフォルト値は TRUE です。
オプションadministrator_name
このメソッドを呼び出したアドミニストレーターの名前を指定します。
profile_manager_name...
検証対象のプロファイル・マネージャーのリストを指定します。名前はスペースで区切って指定してください。
task_name
タスクまたはジョブの名前を指定します。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドは正常に終了しました。TRUE または FALSE が標準出力に書き込まれます。
1 メソッドはエラーを戻して終了しました。メソッドの標準出力は保証されません。
参照tl_def_man_nodes, tl_val_set_gid, tl_val_set_uid
第 6 章 タスク・ライブラリー・ポリシー・スクリプト 485
tl_val_set_gid
タスクまたはジョブに割り当てられたグループ ID を検証します。
リソースTaskLibrary
構文tl_val_set_gid administrator_name group_id
説明tl_val_set_gid メソッドは、タスクまたはジョブに割り当てられたグループ ID を検証します。このスクリプトは、グループ ID が検証基準を満たしている場合はTRUE を、検証基準を満たしていない場合は FALSE を標準出力に書き込みます。Tivoli Management Framework におけるデフォルト値は TRUE です。
オプションadministrator_name
このメソッドを呼び出したアドミニストレーターの名前を指定します。
group_id
検証対象のグループ ID を指定します。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドは正常に終了しました。TRUE または FALSE が標準出力に書き込まれます。
1 メソッドはエラーを戻して終了しました。標準出力は未定義です。
参照tl_def_man_nodes, tl_val_set_uid
486 Tivoli Management Framework: リファレンス・マニュアル
tl_val_set_uid
タスクまたはジョブに割り当てられたユーザー ID を検証します。
リソースTaskLibrary
構文tl_val_set_uid administrator_name user_id
説明tl_val_set_uid メソッドは、タスクまたはジョブに割り当てられたユーザー ID を検証します。このスクリプトは、ユーザー ID が検証基準を満たしている場合はTRUE を、検証基準を満たしていない場合は FALSE を標準出力に書き込みます。Tivoli Management Framework におけるデフォルト値は TRUE です。
オプションadministrator_name
このメソッドを呼び出したアドミニストレーターの名前を指定します。
user_id 検証対象のユーザー ID を指定します。
リターン・コードこのメソッドの終了コードは次のいずれかです。
0 メソッドは正常に終了しました。TRUE または FALSE が標準出力に書き込まれます。
1 メソッドはエラーを戻して終了しました。標準出力は未定義です。
参照tl_def_man_nodes, tl_val_prof_mgrs, tl_val_set_gid
第 6 章 タスク・ライブラリー・ポリシー・スクリプト 487
488 Tivoli Management Framework: リファレンス・マニュアル
第 7 章 ポリシー・スクリプトの編集
エンドポイント・ポリシー・スクリプトの編集Tivoli Management Framework のインストール時には、エンドポイント・ポリシー・スクリプトは空です。 エンドポイント・ポリシー・スクリプトに内容を追加する場合や、後で既存のスクリプトを編集する場合は、wgeteppol コマンドとwputeppol コマンドを使用する必要があります。詳細については、 1ページの『第1 部 各プラットフォームのコマンド』 を参照してください。
エンドポイント・ポリシー・スクリプトを編集するには、次の手順を実行します。この例では login_policy スクリプトを使用します。 login_policy を編集対象ポリシーの名前に置き換えれば、どのエンドポイント・ポリシー・スクリプトにもこの手順を使用できます。
注: ポリシーをファイルにリダイレクトしない場合、ポリシーは画面に出力されます。
1. 次のコマンドを入力して、login_policy を抽出し、それをファイルに書き込みます。
wgeteppol login_policy > login_policy.txt
このスクリプトを初めて編集する場合は、出力は次のようになります。その後の編集では、スクリプト全体が出力されます。
#!/bin/sh## The following are the command line options passed# to this script from the gateway.## $1 - The label of the endpoint machine# $2 - The object reference of the endpoint machine# $3 - The interpreter type of the endpoint machine# $4 - The object reference of the gateway that the# endpoint logged into# $5 - The IP address of the endpoint logging in# $6 - Region# $7 - Dispatcher# $8 - Version# $9 - The inventory id of the endpoint logging in# $10 - The protocol of the endpoint logging in.# TCPIP -> TCP/IP# IPX -> IPX/SPX
exit 0#
2. テキスト・エディターを使って、スクリプトの内容の追加や既存の内容の変更を行います。
3. 次のコマンドを入力すると、更新されたポリシー・スクリプトが戻ります。
wputeppol login_policy < login_policy.txt
© Copyright IBM Corp. 2004 489
プロファイル・マネージャーおよびタスク・ライブラリー・ポリシー・スクリプトの編集
次に、タスク・ライブラリーの検証ポリシーを編集する手順の例を示します。プロファイル・マネージャーの検証ポリシーも、同じ手順を使って編集できます。デフォルト・ポリシーを編集する場合は、wlspolm コマンド、wgetpolm コマンド、および wputpolm コマンドの -v オプションを -d オプションに置き換えてください。
出荷時のタスク・ライブラリー・ポリシーでは、ジョブやタスクの実行先として有効な管理対象ノードは Tivoli リージョン内のすべての管理対象ノードに設定されています。検証ポリシーを変更することによって、ジョブやタスクの実際の実行先管理対象ノードを限定することができます。
1. 次のコマンドを入力して、使用可能な検証ポリシーとその正確な名前のリストを取得します。
wlspol -v TaskLibrary
2. 次のコマンドを入力して、validate_execution_managed_nodes メソッドに関連付けられたポリシー・シェル・スクリプトを取得し、それを aef というファイルにリダイレクトします。必ず正確な名前を使用してください。
wgetpolm -v TaskLibrary BasicTaskLibrary tl_val_man_nodes > aef
aef ファイルには、次のようなシェル・スクリプトが格納されます。
#!/bin/sh########################################################### $Id: tl_val_man_nodes.sh,v 1.2 1998/09/09 15:41:23 paul$## This script implements the# "validate_execution_managed_nodes" policy method for the# Task Library. The script is provided with the name of the# task, the label of the Admin and all of the# managed nodes selected for execution targets of the task.# Modify the code below if you want something different# returned.## To debug your changes, you could add the lines:## set -xv# exec > /tmp/debug.output 2>&1## These lines will allow you to see any errors that occur# by looking in the /tmp/debug.output file.## NOTE: This script can also be called when a check_policy# operation is performed. In that case, the name of# the Admin will be "any". Make sure that you handle# that case if you modify this script.##########################################################
task_name=$1administrator=$2shift 2
## Example of how to validate the list of managed nodes. ##
# for i in $*; do# if [ $i = "the evil managed node" ]; then# echo FALSE# exit 0
490 Tivoli Management Framework: リファレンス・マニュアル
# fi# done
echo TRUEexit 0
#
3. テキスト・エディターを使って、aef ファイルを変更します。
Tivoli Management Framework では、ジョブやタスクの実行先管理対象ノードを限定するためのポリシー・オプションを提供しています。このオプションを使用するには、Tivoli Management Framework から提供されたポリシー・オプションの注釈行を削除し、"the evil managed node" を管理対象ノードの名前に置き換えてください。
ユーザー独自のオプションを追加することもできます。
4. 次のコマンドを入力して、編集したポリシー・スクリプトに置き換えます。
wputpolm -d TaskLibrary BasicTaskLibrary tl_val_man_nodes < aef
独自のポリシー・グループを作成する場合は、次のコマンドを入力します。
wcrtpol -d TaskLibrary "Secure Tasks"
その後、新しく作成したグループのメソッドを取得または設定し、[管理対象リソースのポリシー] ウィンドウを使ってそのグループを TaskLibrary リソースに割り当てることができます。
これらのメソッドが呼び出すシェル・スクリプトを変更して、新しいデフォルト・ポリシーを設定することができます。デフォルト・ポリシーは、ポリシー・リージョンごとに設定できます。
第 7 章 ポリシー・スクリプトの編集 491
492 Tivoli Management Framework: リファレンス・マニュアル
第 3 部 タスク・ライブラリー言語第 8 章 タスク・ライブラリー言語の概要 . . . 495wtll コマンドの使用 . . . . . . . . . . . 495タスク・ライブラリーでのメッセージ・カタログの使用 . . . . . . . . . . . . . . . . 497エンドポイントでタスクを実行可能にする . . . . 498
第 9 章 タスク・ライブラリー言語の構文 . . . 501ライブラリー特性の設定 . . . . . . . . . . 501引き数レイアウトの定義 . . . . . . . . . . 503
Text および CryptoText . . . . . . . . . 504Choice および TextChoice . . . . . . . . 505例 — Resource キーワードが指定されたChoice レイアウト . . . . . . . . . . 507例 — File キーワードが指定されたTextChoice レイアウト . . . . . . . . 509例 — 選択リストが組み込まれた TextChoiceレイアウト . . . . . . . . . . . . 510
ChoiceButton . . . . . . . . . . . . . 510例 — Program キーワード . . . . . . . 511例 — Resource キーワード . . . . . . . 511
RadioButton . . . . . . . . . . . . . 512例 — File キーワード . . . . . . . . 513例 — ラジオ・ボタンの組み込みリスト . . 513
タスク定義の作成 . . . . . . . . . . . . 514タスク・ヘッダーの定義 . . . . . . . . . 514Implementation 文節の定義 . . . . . . . . 515Argument 文節の定義 . . . . . . . . . . 517
タスク・ライブラリーへのコメントの追加 . . . . 519TLL 構成ファイルの編集 . . . . . . . . . 520
第 10 章 サンプル・タスク・ライブラリー . . . 521
© Copyright IBM Corp. 2004 493
494 Tivoli Management Framework: リファレンス・マニュアル
第 8 章 タスク・ライブラリー言語の概要
タスク とは、ネットワーク中の管理対象ノードおよびエンドポイントで定期的に実行されるアクションです。それぞれのタスクは、作業を実行するスクリプト、コマンド、またはその他の実行可能ファイルを参照しています。また、タスクは、スクリプトの実行に必要な許可の役割、およびタスクの実行に使用するユーザー ID またはグループ ID も定義します。タスクには、たとえばプリンター・キューをクリアするタスク、システム・バックアップを開始するタスク、Tivoli がサポートする操作 (イベント・サーバーへのイベントの転送など) を実行するタスクがあります。
タスクは タスク・ライブラリー に保管されます。タスク・ライブラリーには通常、密接に関連したタスク (たとえば同じ許可の役割を必要とするタスク、または単一の製品またはリソースの管理を助けるタスクなど) が含まれます。
タスク・ライブラリー言語 (TLL) を使用して、タスク・ライブラリーおよびタスクを構成することができます。 Tivoli デスクトップからタスク・ライブラリーまたはタスクを作成する場合、デスクトップは TLL を使用してタスク・ライブラリーの基本プロパティーを定義します。 TLL には、テキスト・ボックス、ラジオ・ボタン、スクロール・リストなどのガジェットが含まれるカスタマイズされたウィンドウを作成する機能など、デスクトップからはインプリメントできない追加機能があります。これらのガジェットは、ユーザー入力のキャプチャー、および基礎をなすスクリプトまたはプログラムへの引き数の受け渡しに使用できます。
wtll コマンドの使用wtll は、タスク・ライブラリーの作成および編集に使用する基本コマンドです。このコマンドは TLL 変換プログラムを使用します。この変換プログラムは、タスク・ライブラリーの記述を CORBA (Common Object Request Broker Architecture)
データ構造に変換するのに必要です。 TLL 変換プログラムは、コマンド行からwtll コマンドを使用して実行します。現在のところ、この変換プログラム用のグラフィカル・ユーザー・インターフェースはありません。
タスク・ライブラリー記述が CORBA データ構造に変換されて、Tivoli リージョンにインストールされると、Tivoli アプリケーションはタスク・ライブラリー内のタスクを使用できます。アプリケーションはタスクを構成して起動します。異なるアプリケーションが構成済みタスクを異なる方法で起動できます。
以下のコマンド実行すると、タスク・ライブラリーの内容を表示したり編集することができます。
wtll -F export_file -l library_name
このコマンドはタスク・ライブラリーを tar ファイルにエクスポートします。 tar
ファイルには、編集して再インポートできる tll ファイルが含まれています。タスク・ライブラリーの内容は、以下のシェル・コマンドで取り出すことができます。
tar -xvf file_name
© Copyright IBM Corp. 2004 495
取り出された tll ファイルは、任意のテキスト・エディターで編集できます。ファイルを編集したら、wtll コマンドでタスク・ライブラリーを Tivoli リージョンにインポートします。
注: タスク・ライブラリーをインポートすると、そのタスク・ライブラリーの前のバージョンは削除され、新規生成のタスク・ライブラリーに置き換わります。その結果、ライブラリーのエクスポート時に定義されていなかったすべてのジョブとタスクは失われます。
タスク・ライブラリーをインポートするには、以下のコマンドを実行します。
wtll -r -p policy_region -P C_preprocessor tll
ここで、
-r タスク・ライブラリーを置き換えます。tll ファイルを編集した際にタスク・ライブラリーを名前変更した場合、このフラグは省略してください。
-p policy_region
タスク・ライブラリーを配置させるポリシー・リージョンを指定します。
-P C_preprocessor
C プリプロセッサーへのパスを指定します。ほとんどの UNIX オペレーティング・システムでは、このパスは /usr/ccs/lib/cpp です。Windows 管理対象ノード上では、C プリプロセッサーへのパスは$BINDIR/tools/cpp.exe です。
tll タスク・ライブラリー定義が含まれているファイルを示します。
ポリシー・リージョン内にタスクとジョブを素早く再作成できるスクリプトを保持してください。スクリプトが無い場合、以下の手順を実行してタスクとジョブの喪失を避けることができます。
1. デスクトップから、もしくは以下のような wdeltask コマンドを使用して、タスク・ライブラリー内の置き換えるタスクを削除します。
wdeltask MyTask TaskLib
上記のコマンドで、MyTask はタスクの名前で、TaskLib はそのタスク・ライブラリーです。
2. 以下のコマンドを使用して、tll2 という名前の tll ファイルのコピーを作成します。
cp tll tll2
新規ファイル (tll2) を編集します。
3. 新規ファイル内の、ArgLayout 文節とタスク定義を除くすべてを削除します。タスク定義および ArgLayout 文節の追加情報については、それぞれ 503ページの『引き数レイアウトの定義』と 514ページの『タスク定義の作成』を参照してください。
4. 以下のコマンドを実行して、新規タスクをタスク・ライブラリーにロードします。
wtll -i -l TaskLib -P /usr/ccs/lib/cpp tll2
詳細については、 430ページの『wtll』を参照してください。
496 Tivoli Management Framework: リファレンス・マニュアル
タスク・ライブラリーでのメッセージ・カタログの使用TLL は、Dialog Specification Language (DSL) において使用可能な機能と同じ機能を多数使用します。DSL は、GUI 作成のためのサービスを提供する Tivoli
Application Developer’s Environment (ADE) の一部です。
TLL にとって、メッセージ・カタログはもっとも重要な DSL の機能の 1 つです。メッセージ・カタログによって、ウィンドウ内のテキストを複数の言語で表示することが可能になります。「TME 10 ADE Desktop Services Manual」、および「TME
10 ADE Application Services Manual, Volume I」に、メッセージ・カタログの作成およびインプリメント方法が記載されています。
TLL 定義内のメッセージ・カタログ参照のフォーマットは、次のとおりです。
’MsgCatalogName’, ’DefaultText’, ’Key’
ここで、
MsgCatalogName
表示するメッセージが含まれるメッセージ・カタログを指定します。
メッセージ・カタログを使用しない場合は、メッセージ・カタログ名として" " を入力します。引用句で囲んだストリング (例: "_!_") を使用して、メッセージ・カタログが無いことを示すことができます。ただし、タスク・ライブラリーは、空ストリング値をより速く処理します。
DefaultText
メッセージ・カタログが見付からない場合または存在しない場合に表示するテキストを指定します。
Key メッセージ・カタログ内のエントリーを識別する番号を指定します。
注: 本書では、番号 1 は、メッセージ・カタログが使用されていないことを示します。
また、幾つかの TLL エレメントは、DefaultText と同じである可能性がある戻り値を使用します。以下の例で、最初の Ascending (昇順) と Descending (降順) は、ウィンドウに表示される値です。 2 番目の Ascending (昇順) と Descending (降順)
は、そのタスクを実行したスクリプトに戻される値です。
RadioButton {{ ("","Ascending (昇順)",1) "Ascending (昇順)" }{ ("","Descending (降順)",1) "Descending (降順)" }
};
タスク定義の読み易さを向上させるには、表示されるテキストとは異なる戻り値を使用します。以下に例を示します。
RadioButton {{ ("","Ascending (昇順)",1) "ASC" }{ ("","Descending (降順)",1) "DESC" }
};
第 8 章 タスク・ライブラリー言語の概要 497
エンドポイントでタスクを実行可能にするほとんどのタスクは、シェル、Perl インタープリター、またはこれらと似たツールを必要とします。これらのツールは通常、管理対象ノードで使用可能であり、タスクも実行できます。しかし、PC エンドポイントは、これらのツールが利用不可な場合がひんぱんにあります。
管理対象ノードのインストール時に、 $BINDIR/tools ディレクトリーが作成されます。このディレクトリーには、UNIX から移植されたコマンドおよびユーティリティー (Bourne シェル (sh.exe)、awk コマンド (awk.exe)、grep コマンド(grep.exe) を含む) の他に、Perl インタープリター (perl.exe) が含まれます。
Windows オペレーティング・システムでエンドポイントを作成した場合、ツール・ディレクトリー $BINDIR/tools は組み込まれません。これらのツールにアクセスする必要のあるタスクがある場合は、ツールをオンデマンドでダウンロードするための依存関係を作成する必要があります。
このセクションでは、この依存関係の確立方法を説明します。手順では、Windows
ベースのエンドポイント用プロセスを説明していますが、他のオペレーティング・システムの場合もこの手順を実行しなければならない場合があります。
注:
v 任意のゲートウェイから依存関係を作成できますが、Windows ゲートウェイを使用するとより容易に依存関係をセットアップできます (Windows 固有のツールは Windows 管理対象ノードにのみインストールされているため)。UNIX 管理対象ノードには、Windows 固有のツールのコピーはインストールされていません。 UNIX 管理対象ノードにこれらのツールをインストールするには、ツールの依存関係をセットアップするための追加ステップを実行する必要があります。
v アプリケーションがタスク単位で依存関係を指定することはありません。タスク・ライブラリーの場合、依存関係を run_taskメソッドに書き込むことがその解決方法です。
Windows エンドポイントでタスク・ライブラリー・スクリプト用の依存関係をセットアップするには、以下のステップを実行します。
1. Windows ゲートウェイの場合、wdepset コマンドを $BINDIR/tools ディレクトリーから Windows ゲートウェイにコピーします。
2. -c オプションを指定した wdepset コマンドを実行して、依存関係セットを作成します。このコマンドのもっとも基本的なインプリメンテーションは、次のとおりです。
wdepset -c label -a interp path +p path
ここで、
-c label
指定されたラベルが付いた依存関係セットを作成します。
-a interp
エンドポイントのインタープリター・タイプを指定します。
498 Tivoli Management Framework: リファレンス・マニュアル
path ツールへのパスを指定します。パスは、-a オプションで指定したインタープリター・タイプに相対的です。
+p path
エンドポイントのキャッシュが満杯になった時に、従属ファイルがエンドポイントから削除されないようにします。path オプションは、依存関係をダウンロードする際に、エンドポイント上のディレクトリーを基本ディレクトリーとして使用するよう指定します。 Windows ツールの場合、path オプションは %TOOLS% 環境変数として指定できます。
以下に、wdepset コマンドの例を示します。
wdepset -c task-tools-a win95 bin/win95/tools/sh.exe +p %TOOLS% ¥-a w32-ix86 bin/w32-ix86/tools/sh.exe +p %TOOLS%¥-a w32-ix86 bin/w32-ix86/tools/win32gnu.dll +p %TOOLS%
3. wchdep コマンドを使用して、依存関係を run_task メソッドに関連付けます。
wchdep @Classes:TaskEndpoint @DependencyMgr:task-tools run_task
タスク・ライブラリーの場合、wchdep コマンドの唯一の変数は依存関係の名前です。この場合、task-tools が依存関係です。
4. dbcheck オプションを指定した wgateway コマンドを使用して、ゲートウェイ・キャッシュを Tivoli サーバーと同期化します。たとえば、ゲートウェイの名前が subnet30-gateway の場合、次のように入力します。
wgateway subnet30-gateway dbcheck
依存関係の詳細については、「Tivoli Application Development for the Lightweight
Client Framework」を参照してください。
第 8 章 タスク・ライブラリー言語の概要 499
500 Tivoli Management Framework: リファレンス・マニュアル
第 9 章 タスク・ライブラリー言語の構文
Tivoli デスクトップからタスクを作成する場合、タスク・ライブラリー言語 (TLL)
が提供するすべての機能を利用できるわけではありません。TLL が提供する最も重要な機能は、ユーザーが情報を入力できるウィンドウを作成する機能です。これらの機能を使用可能にするには、タスク・ライブラリー定義の構文についてよく理解する必要があります。
タスク・ライブラリー定義には、以下のセクションが含まれています。
ライブラリー特性このセクションは、タスク・ライブラリーの名前やバージョン番号を含む、いくつかのグローバル属性を定義します。このセクションは常にタスク・ライブラリー定義の最初に出てきます。
Argument レイアウトこのセクションはそれぞれの Argument レイアウトを定義します。Argument レイアウトは、テキスト・ボックス、スクロール・リストなどのウィンドウ上のエレメントを定義します。ユーザーが指定または選択した値は、該当するタスク定義に渡されます。 Argument レイアウトはタスク定義の前または後に配置できます。
タスク定義このセクションは、タスクをインプリメントするコードが含まれるタスク定義を定義します。また、このセクションは、ユーザーが引き数としてタスク定義に渡される情報を入力できるように、Argument レイアウトを使用してウィンドウを構成します。タスク定義は、ライブラリー特性の指定またはArgument レイアウトの定義よりもかなり複雑です。
ライブラリー特性の設定ライブラリー特性セクションは、タスク・ライブラリー定義の最初に指定しなくてはなりません。このセクションは、タスク・ライブラリー全体のグローバル特性を定義します。ここで定義する特性には、タスク・ライブラリー名、ライブラリーに関して表示されるヘルプ・メッセージ、およびバージョン番号が含まれます。
タスク・ライブラリーの特性セクションは、次のステートメントで始まります。
TaskLibrary library_name {
library_name はタスク・ライブラリーのラベルです。
また、ライブラリー特性セクションには、以下の属性のうちの幾つか、もしくはすべてが含まれています。これらの属性は、ライブラリーが Tivoli 環境の他の部分とどのように相互作用するかという情報を提供します。
Tivoli デスクトップからタスク・ライブラリーを作成する場合、Tivoli Management
Framework が基礎として以下のコードを提供します。
© Copyright IBM Corp. 2004 501
#ifndef TASK_BINDIR#define TASK_BINDIR "./"#endif
TaskLibrary "NewTaskLibrary" {Context = ("_!_","*",1);Distribute = ("_!_","ALI",1);HelpMessage = ("_!_","Conventional Task Library (従来型タスク・ライブラリー)",1);Requires = ("_!_",">2.5",1);Version = ("_!_","1.0",1);
}
注: 最初の 3 行は、タスク・ライブラリー・ディレクトリーの場所に関する情報をC プリプロセッサーに提供します。新規タスク・ライブラリーを作成する場合、これらの行を必ずしも追加する必要はありません。
TaskLibrary ステートメントは、タスク・ライブラリーの一般的説明で始まります。このステップはすべてのタスク・ライブラリーに必要です。 "NewTaskLibrary" 引き数は、タスク・ライブラリーのラベルです。このラベルを変更すると、編集済みタスク・ライブラリーを Tivoli 環境にインポートする際に新規のタスク・ライブラリーが作成されます。
デフォルト・コード・サンプル内にリストされている値は、(“_!_”, “Text”, “1”) というフォーマットを使用しています。このフォーマットは、Dialog Specification
Language (DSL) で定義されているメッセージ・カタログ・フォーマットに対応しています。タスク・ライブラリーを翻訳またはローカライズする予定がない場合、重要な値は、Text オプションで指定されたストリングのみです。
以下のキーワードは、タスク・ライブラリー特性の定義に役立ちます。これらのキーワードは、タスク・ライブラリーの引き数レイアウト・セクションおよびタスク定義セクションの前に、任意の順序で指定できます。
Contextそのタスク・ライブラリーを使用するアプリケーションを指定します。アプリケーションはこの属性を利用して、インストール済みタスク・ライブラリーのリストをフィルター処理します。この属性はオプションです。
Distributionタスク・ライブラリー・バイナリーが保管される場所を示します。このキーワードの値は、タスク・ライブラリーに分散モニター・タスクが定義されている場合にのみ関係があります。
有効な値は、以下のとおりです。
ALI ローカル Tivoli リージョンの Tivoli サーバー上にのみタスク・バイナリーを保管するよう指定します。
GLOBAL接続しているすべての Tivoli リージョン内にあるすべての管理対象ノードに、タスク・バイナリーのコピーを配布します。
LOCALローカル Tivoli リージョン内のすべてのファイル・サーバーに、タスク・ライブラリーのコピーを配布します。タスク・ライブラリーが複数のマシンに分散されており、パスがファイル共用システムだと、タスク・ライブラリーは 1 回配布されます。
502 Tivoli Management Framework: リファレンス・マニュアル
HelpMessageヘルプ・メッセージ・ストリングを定義します。この属性はオプションです。
Requiresそのタスク・ライブラリーの実行に必要な Tivoli Management Framework
のバージョンを指定します。バージョン番号の前に、より大記号 (>) が指定されていると、指定されているバージョンより上のソフトウェア・バージョンもすべてサポートされます。この属性はオプションです。
Versionそのタスク・ライブラリーのバージョンを表すストリングを定義します。この属性は必須です。
引き数レイアウトの定義Tivoli デスクトップから使用可能な機能のみを利用してタスクを作成する場合、タスクに関連付けられたウィンドウをカスタマイズできません。その結果、作成するタスクはユーザー入力を必要としない、必要なものを完備したものになります。TLL を使用した場合、テキスト・ボックスやラジオ・ボタンなどが含まれたウィンドウを作成できるよう引き数レイアウトを定義することができます。ウィンドウでユーザーが入力した値を、引き数としてタスクに渡すことができます。
引き数レイアウトの基本構文は、次のとおりです。
ArgLayout Name {LayoutType;ButtonLabel ("テキスト");
};
Name 変数は、それぞれの引き数レイアウトごとに指定する必要があります。この名前は、タスク定義に含まれている Argument 文節内で参照されます。 Argument
文節の詳細については、 517ページの『Argument 文節の定義』を参照してください。
LayoutType 引き数は、次のいずれか 1 つの値をもつ TLL キーワードです。これらの各レイアウトは、ガジェットの基本構造を提供します。
v Text
v CryptoText
v Choice
v TextChoice
v ChoiceButton
v RadioButton
ButtonLabel キーワードは、ボタン上に表示されるテキストを定義します。ButtonLabel キーワードは、ボタンを使用するすべてのレイアウト・タイプに組み込む必要があります。
ガジェットが含まれるウィンドウは、非特権ユーザーとして実行されます。ウィンドウに、特権ユーザーまたは呼び出しアドミニストレーターとして実行する必要の
第 9 章 タスク・ライブラリー言語の構文 503
あるスクリプトが含まれている場合、そのスクリプトはカスタム・メソッドとしてインストールする必要があります。詳細については、 515ページの『Implementation
文節の定義』を参照してください。
以下のセクションでは、それぞれのレイアウトについて説明します。サンプル・コードと、そのコードが提供するウィンドウのスナップショットが含まれています。
注: それぞれの例でリストされている Argument 文節はレイアウト定義には含まれていません。これらの文節はタスク定義に含まれています。ここでリストされている Argument 文節は、ウィンドウを形成するためにレイアウト内でどのように使われているかを示すのが目的です。 Argument 文節内で使用されるキーワードの詳細については、 517ページの『Argument 文節の定義』を参照してください。
Text および CryptoTextText レイアウトは、ユーザーが直接入力できるテキスト・ボックスを作成します。CryptoText レイアウトは Text レイアウトに似ていますが、例外はユーザーが入力するテキストがアスタリスク (*) などの文字でマスクされる点です。CryptoTextレイアウトは、標準テキストを表示させないパスワード・フィールドやその他のフィールドに使用できます。
注: CryptoText レイアウトに入力したテキストは暗号化されません。テキストは平文として送信されます。
Text および CryptoText レイアウトは、以下のように定義します。
ArgLayout TextField {Text;
};
ArgLayout PasswordField {CryptoText;
};
TextField および PasswordField 引き数は、タスクの Argument 文節で参照される ID です。以下のコード・サンプルは、レイアウトと引き数の関連を表しています。
Argument ("", "User Name (ユーザー名)", 1) {Layout = ("", "TextField", 1);
};
Argument ("", "Password (パスワード)", 1) {Layout = ("", "PasswordField", 1);
};
これらの Argument ステートメントが同じタスク定義内に配置されると、以下のようなウィンドウが表示されます。
504 Tivoli Management Framework: リファレンス・マニュアル
次のようにテキスト・フィールドにテキストが表示されます。
Text および CryptoText レイアウトは、追加の属性を使用しません。これらのレイアウト用にカスタマイズされた属性は無いので、これらのレイアウトの単一インスタンスを定義して、タスク・ライブラリー内で何回も再利用できます。
Choice および TextChoiceChoice レイアウトは、「選択リスト」ウィンドウを起動するボタンを作成します。ユーザーが選択リストから項目を選択すると、その項目がタスク・ウィンドウの編集不可フィールドに表示されます。
TextChoice レイアウトは、Choice レイアウトが提供する機能に編集可能なテキスト・ボックスを追加します。ユーザーは、「選択リスト」ウィンドウを使用するか、あるいはテキストを直接テキスト・ボックスに入力できます。後でユーザーが「選択リスト」ウィンドウから項目を選択すると、テキスト・ボックスの内容は上書きされます。
以下のコード・サンプルは、Choice および TextChoice レイアウトを表しています。
ArgLayout SelectManNode {Choice Resource "ManagedNode";ButtonLabel = ("", "ManagedNodes...", 1);
};
第 9 章 タスク・ライブラリー言語の構文 505
ArgLayout SelectFrequency {TextChoice Multi ("", ", ", "") File "/bin/scripts/Times.txt";ButtonLabel = ("", "Frequency...(頻度...)", 1);
};
Multi キーワードを利用して、選択リストから複数の項目を選択することができます。 (複数の項目を選択する際は Ctrl キーを押します。) このキーワードは、Choice または TextChoice キーワードのすぐ後に、スペースで区切って入力してください。また、Multi キーワードの後には、選択された項目の区切りかたを示す指示セットを入力する必要があります。それらの指示は、以下のようなフォーマットで入力します。
("leading_string", "separator_string", "trailing_string")
区切り文字の例はコンマやコロンを含みますが、ユーザーのスクリプトが処理できるものであればどの文字でも使用できます。上記の ArgLayout SelectFrequency の例では、先行ストリングおよび末尾ストリングはありませんが、分離文字ストリングは、コンマとそれに続くスペースに設定されています。以下の例で、リスト内の最初の選択項目は、前に左括弧が付き、それぞれの項目はコロンで区切り、最後の項目の後に右括弧が付きます。
ArgLayout ManagedNode {Choice Multi ("(", ":", ")") File "/bin/scripts/Times.txt";ButtonLabel = ("", "Frequency...(頻度...)", 1);
};
選択リスト内の項目は、動的に導出したり、ファイルから読み取ったり、レイアウト定義に明示的にコーディングすることができます。 Resource キーワードは、選択リストに動的に項目を取り込む方法の 1 つです。このキーワードは、現行のTivoli リージョン内で定義されている、指定された Tivoli リソース(ManagedNode、Administrator など) のインスタンスのリストを生成します。
TLL は、選択リストの生成に関して以下のキーワードを受け入れます。
File “Path”
指定されたファイルを開いて、ファイル内の各行を選択リストの選択可能オプションとして表示します。このファイルにコメントやその他の無関係の情報が含まれていてはなりません。このファイルは、タスク・エンジンが見付けられるように TMR サーバーまたはその他の適切な場所に配置する必要があります。
FileBrowser選択リストの代わりにファイル・ブラウザー・ウィンドウを表示します。ブラウザーは、Tivoli サーバー上のファイルを表示します。DefaultValue キーワードは、最初に表示されるパスとホストを指定します。 DefaultValueキーワードについての詳細は、 517ページの『Argument 文節の定義』を参照してください。
FileData “Path”
指定されたファイルを開いて、ファイル内のそれぞれの奇数番号の行を選択リストの選択可能オプションとして表示します。偶数番号の行は、戻り値です。項目を選択すると、戻り値がタスク・ウィンドウに表示されます。
HostFileBrowserユーザーがファイルの保管先ホストも選択できるファイル・ブラウザーを表
506 Tivoli Management Framework: リファレンス・マニュアル
示します。 DefaultValue キーワードは、最初に表示されるパスとホストを指定します。 DefaultValue キーワードについての詳細は、 517ページの『Argument 文節の定義』を参照してください。
Program Script
プログラムまたはスクリプトを実行して、出力の各行を選択項目として使用します。プログラムおよびスクリプトは、タスク定義内に定義されたものと同じ構文および規則に従わなくてはなりません。詳しくは、 515ページの『Implementation 文節の定義』を参照してください。
ProgramData Script
Program キーワードと同じ規則に従います。ただし、例外は、奇数番号の行が選択可能オプションとして表示され、偶数番号の行は戻り値である点です。項目を選択すると、戻り値がタスク・ウィンドウに表示されます。
Resource “Name”
Tivoli ネーム・レジストリーに照会して、指定されたリソース名と一致するインスタンスのリストを戻します。各インスタンスが選択可能オプションとして表示されます。リソース名は、wlookup コマンドを -R オプションを使用して実行した結果表示される項目であればどれでも構いません。
注: Tivoli リージョンが接続されている環境内のすべてのアドミニストレーターのリストを表示するには、Administrator ではなくAdministratorCollection リソースを指定します。
ResourceOID “Name”
Tivoli ネーム・レジストリーに照会して、指定されたリソース・オブジェクト ID と一致するインスタンスのリストを戻します。各インスタンスが選択可能オプションとして表示されます。
レイアウト内に選択可能オプションのセットを定義することもできます。このオプション生成方法ではキーワードは使用しませんが、以下の構文を使用する必要があります。
{{("Msgcat","DisplayedValue",Key) "ReturnValue"}{ ... }
};
タスク・ライブラリーを変換しない場合も、Msgcat、DisplayedValue、および Key
引き数は必要です。 ReturnValue 引き数は、処理のためにタスクに戻される値です。
例 — Resource キーワードが指定された Choice レイアウトSelectManNode レイアウトは、ManagedNodes... ラベルが付いたボタンで選択リストを作成します。ボタンの左側のテキストは、Argument 文節で定義します。
ArgLayout SelectManNode {Choice Resource "ManagedNode";ButtonLabel = ("", "ManagedNodes...", 1);
};
Argument ("", "Select a Managed Node (管理対象ノードを選択してください)", 1) {Layout = "SelectManNode";};
第 9 章 タスク・ライブラリー言語の構文 507
ユーザーがこの Argument 文節が含まれているタスクを選択すると、以下のウィンドウが表示されます。
「ManagedNodes」をクリックすると、次のようなウィンドウが表示されます。
レイアウト定義には Multi キーワードは含まれていなかったので、選択リストの上のラベルは「Choose one (1 つ選択)」です。オプションを選択してウィンドウが消えると、選択された項目がボタンの右側の編集不可テキスト・ボックスに表示されます。
508 Tivoli Management Framework: リファレンス・マニュアル
例 — File キーワードが指定された TextChoice レイアウト以下のレイアウトでは、File キーワードを利用してテキスト・ファイルからオプション・リストを生成します。タスク・エンジンは、指定されたテキスト・ファイル内の各行を読み取り、それをオプション・リストに入れます。
ArgLayout SelectFrequency {TextChoice Multi ("", ", ", "") File "/bin/scripts/Times.txt";ButtonLabel = ("", "Frequency... (頻度...)", 1);
};
Argument ("", "Frequency... (頻度...)", 1) {Layout = "SelectFrequency";};
Times.txt ファイルには、次のような情報が入っています。
151025
ユーザーがこの Argument 文節が含まれているタスクを選択すると、以下のウィンドウが表示されます。
「Frequency (頻度)」をクリックすると、次のようなウィンドウが表示されます。
Multi キーワードがレイアウトで使用されたので、オプション・リストのラベルは「Choose one or more (1 つ以上選択してください)」です。ユーザーが 1 つ以上の項目を選択してウィンドウが消えると、ボタンの右側のテキスト・ボックスに選択した項目が表示されたタスク・ウィンドウが表示されます。
第 9 章 タスク・ライブラリー言語の構文 509
例 — 選択リストが組み込まれた TextChoice レイアウトTimes.txt ファイルに定義されたオプションを、ファイルを参照しないで指定する場合のレイアウト定義は、次のようになります。
ArgLayout ListOfNumbers {Choice ("", ", ", "")
{{("","1",1) "1"}{("","5",1) "5" }{("","10",1) "10" }{("","25",1) "25" }};
ButtonLabel = ("", "Frequency... (頻度...)", 1);};
Argument ("", "Frequency... (頻度...)", 1) {Layout = "ListOfNumbers";};
ChoiceButtonChoiceButton レイアウトはポップアップ・メニューを作成します。ポップアップ・リストから項目を 1 つだけ選択できます。 TLL は、ポップアップ・リストの生成に関して以下のキーワードを受け入れます。
File “Path”
指定されたファイルを開いて、ファイル内の各行をメニュー・オプションとして表示します。このファイルにコメントやその他の無関係の情報が含まれていてはなりません。このファイルは、タスク・エンジンが見付けられるように Tivoli サーバーまたはその他の適切な場所に配置する必要があります。
FileData “Path”
指定されたファイルを開いて、ファイル内の各奇数番号の行をメニュー・オプションとして表示します。偶数番号の行は、戻り値です。
Program Script
プログラムまたはスクリプトを実行して、出力の各行をメニュー・オプションとして使用します。プログラムおよびスクリプトは、タスク定義内に定義されたものと同じ構文および規則に従わなくてはなりません。詳しくは、515ページの『Implementation 文節の定義』を参照してください。
510 Tivoli Management Framework: リファレンス・マニュアル
ProgramData Script
Program キーワードと同じ規則に従います。ただし、例外は、奇数番号の行がメニュー・オプションとして表示され、偶数番号の行は戻り値である点です。
Resource “Name”
Tivoli ネーム・レジストリーに照会して、指定されたリソース名と一致するインスタンスのリストを戻します。各インスタンスがメニュー・オプションとして表示されます。
例 — Program キーワードProgram キーワードを使用して、メニュー・オプションのリストを作成するスクリプトを実行することができます。この例では、スクリプトは /etc/hosts ファイルから読み取りを行って、ホストのリストを生成します。
注: Implementation キーワードが以下の例で使用されています。このキーワードについての詳細は、 515ページの『Implementation 文節の定義』を参照してください。
ArgLayout Hosts {ChoiceButton Program {Implementation ("default")
.#!/bin/sh
.awk < /etc/hosts ’/^[0-9][0-9]*/ {print $2}’ | sort.exit 0
;};
};
Argument ("", "Select Host (ホストの選択)", 1) {Layout = ("", "Hosts", 1);
};
以下のウィンドウが表示されます。
例 — Resource キーワード以下の例では、Tivoli アドミニストレーターの名前が含まれているポップアップ・メニューを作成します。
ArgLayout Admin {ChoiceButton Resource "Administrator";
};
第 9 章 タスク・ライブラリー言語の構文 511
Argument ("", "Select Administrator (アドミニストレーターの選択)", 1) {Layout = ("", "Admin", 1);
};
以下のウィンドウが表示されます。
RadioButtonRadioButton レイアウトはラジオ・ボタンのセットを作成します。これらのラジオ・ボタンが選択ボタンと異なる点は、1 度に 1 つのラジオ・ボタンだけを選択できる点です。選択ボタンのように、ラジオ・ボタンも動的に導出したり、ファイルから読み取ったり、レイアウト定義に明示的にコーディングすることができます。
TLL は、ラジオ・ボタンのセットの生成に関して以下のキーワードを受け入れます。
File “Path”
指定されたファイルを開いて、ファイル内の各行をラジオ・ボタンとして表示します。このファイルにコメントやその他の無関係の情報が含まれていてはなりません。このファイルは、タスク・エンジンが見付けられるようにTivoli サーバーまたはその他の適切な場所に配置する必要があります。
FileData “Path”
指定されたファイルを開いて、各奇数番号の行をラジオ・ボタンとして表示します。偶数番号の行は、戻り値です。
Program Script
プログラムまたはスクリプトを実行して、出力の各行をラジオ・ボタンとして使用します。プログラムおよびスクリプトは、タスク定義内に定義されたものと同じ構文および規則に従わなくてはなりません。詳しくは、 515ページの『Implementation 文節の定義』を参照してください。
ProgramData Script
Program キーワードと同じ規則に従います。ただし、例外は、奇数番号の行がラジオ・ボタンとして表示され、偶数番号の行は戻り値である点です。
Resource “Name”
Tivoli ネーム・レジストリーに照会して、指定されたリソース名と一致するインスタンスのリストを戻します。リソースの各インスタンスがラジオ・ボタンとして表示されます。
512 Tivoli Management Framework: リファレンス・マニュアル
レイアウト内でラジオ・ボタンを定義することもできます。このオプション生成方法ではキーワードは使用しませんが、以下の構文を使用する必要があります。
{{("Msgcat","DisplayedValue",Key) "ReturnValue"}{ ... }
};
タスク・ライブラリーを翻訳しない場合も、Msgcat、DisplayedValue、および Key
引き数は必要です。 ReturnValue 引き数は、処理のためにタスクに戻される値です。
例 — File キーワードこの例は、TextChoice レイアウトのレイアウトで使用されていたのと同じファイルを参照します。ただし、ソース・ファイル内の各行は、オプション・リストの項目ではなくラジオ・ボタンとして表示されます。
ArgLayout FrequencyButtons {RadioButton File "/bin/scripts/Times.txt";
};
Argument ("", "How many times to run this script? (このスクリプトを実行する回数)", 1) {Layout = ("", "FrequencyButtons", 1);
};
以下のウィンドウが表示されます。
例 — ラジオ・ボタンの組み込みリストSeverityButtons レイアウトは、イベントの重大度に対応したラジオ・ボタンのセットを作成します。最初の項目はデフォルトで選択されています。
ArgLayout SeverityButtons {RadioButton {
{ ("", "High (高)", 1) "HIGH"}{ ("", "Medium (中)", 1) "MEDIUM" }{ ("", "Low (低)", 1) "LOW" }
};};
Argument ("", "Select Severity (重大度の選択)", 1) {Layout = ("", "SeverityButtons", 1);
};
第 9 章 タスク・ライブラリー言語の構文 513
以下のウィンドウが表示されます。
タスク定義の作成タスク定義は、2 つもしくは 3 つのセクションで構成されます。最初のセクションはタスク・ヘッダーであり、タスクの基本特性 (タスクの実行に必要な許可の役割やユーザー ID など) を指定します。 2 番目のセクションは、タスクをインプリメントするファイルにスクリプトまたはポインターを提供します。 3 番目セクションは引き数を定義します。引き数定義と Argument レイアウトが、表示されるウィンドウを作成します。
タスク・ヘッダーの定義タスク・ヘッダー・セクションは、常に Task キーワードとそれに続くタスク名および左中括弧 ({) で始まります。タスク名はタスク・コレクション内では固有でなくてはならず、スペースおよび引用符を含めることはできません。また、TLL キーワードであってはなりません。
次に、一連の属性と値の対がタスクの特性を定義します。以下の属性が有効です。
Commentsウィンドウに表示されていないタスクに関するコメントを提供します。コメントは、二重引用符 (’’ ’’) で囲む必要があります。この属性はオプションです。
Descriptionタスクの要旨を指定します。これは、「Configure Task Arguments (タスク引き数の構成)」ウィンドウに表示されます。
Gid タスクを実行するグループの名前 (グループ ID) を指定します。 この属性はオプションです。
HelpMessageユーザーが「Task Description (タスクの説明)」をクリックしたときに表示するヘルプ・メッセージを指定します。この属性はオプションです。
ヘルプ・メッセージはシンプルなテキスト・ストリングです。ヘルプ・メッセージの各行は 80 文字以下で指定してください。以下の制御文字を使用して、ヘルプ・メッセージのテキストの表示のしかたを指定できます。
514 Tivoli Management Framework: リファレンス・マニュアル
¥n 以降のテキストを新しい行に表示します。
¥r ブランク行を 1 行挿入します。
¥t 水平タブを挿入します。
Roles タスクの実行に必要な許可の役割を指定します。役割が複数ある場合は、コロンで区切ります (例: Roles ="admin:senior:super")。この属性は必須です。
Uid タスクを実行するユーザーの名前を指定します。ユーザー ID を現行ユーザー名に設定する場合は、引用符で囲まれたアスタリスク (“*”) を使用します。この属性はオプションです。
以下の例は、タスクのヘッダー情報を示しています。Task CheckFileSystem {
Description = ("","Checks the availability of a file system(ファイル・システムの可用性を検査します)",1);HelpMessage = ("","This task runs the ls command to determine to determine
whether the file system is available. You must specify adirectory name and user name to execute this task.",1);
Uid = ("","*",1);Roles = ("","senior:admin:user",1);Comments = ("", "Created 1/17/98", 1)
...}
Implementation 文節の定義Implementation 文節は、タスクの作業を実行するスクリプトを実行します。また、Implementation 文節は、スクリプトのインタープリター・タイプも指定します。タスクのために幾つかの Implementation 文節を定義することができます。
スクリプトとして有効なのは、Bourne シェル・スクリプト、Perl スクリプト、Tivoli コマンド、もしくは似たような実行可能ファイルです。スクリプトは、希望のターゲット上で実行できるものでなくてはなりません。たとえば、Windows エンドポイントは、Bourne シェルまたは Perl インタープリターに直接アクセスすることはできません。Windows エンドポイント用に依存関係セットを確立する必要があります。詳しくは、 498ページの『エンドポイントでタスクを実行可能にする』を参照してください。
注: サポートされるインタープリター・タイプのリストが「Tivoli Management
Framework リリース情報」にありますので、参照してください。インタープリター・タイプは、Tivoli デスクトップの「Create Task (タスクの作成)」ウィンドウに表示されるリストに対応しています。
スクリプトを Implementation 文節に組み込むか、もしくは文節に外部ファイルまたはプログラムをポイントさせることができます。 Implementation 文節は、タスク定義内の主文節として、もしくは Program および ProgramData Argument レイアウト内の副文節として定義できます。
Implementation 文節の構文は、スクリプトが外部ものか、組み込まれたものかによって異なります。外部スクリプトの場合、構文は次のとおりです。
Implementation ("Interp") Binary "File";
Binary キーワードは、タスク・コードが別のファイルに存在することを示し、File
引き数は、そのファイルへのパスを指定します。タスク・ライブラリーを Tivoli 環境に再インポートすると、タスク・エンジンはそのスクリプト・ファイルを、
第 9 章 タスク・ライブラリー言語の構文 515
TASK_BINDIR 変数で指定されたディレクトリーにコピーします。(TASK_BINDIR
変数は、タスク・ライブラリー定義の最初に割り当てます。) また、エンジンはファイルを number.default というフォーマットの名前 (例: 0.default) に変更します。スクリプトへの以降の変更は、名前変更ファイルに対して行われます。
以下の例は、Binary キーワードの使用法を示しています。
Implementation ("aix4-r1") Binary "aix_list.sh";Implementation ("default") Binary "list.sh";
注: TLL は、/bin/sh を使用して組み込みシェル・スクリプトをインプリメントするように設計されています。他のスクリプト言語 (Perl など) では期待される結果を得られない場合があります。他のスクリプト・タイプをインプリメントする場合は、Binary キーワードを使用してください。
スクリプトをタスクに組み込むための構文は、次のとおりです。
Implementation ("Interp").Line of Code.Line of Code
...";
Program レイアウトでは、レイアウトの名前とタイプを定義した後、スクリプトの組み込むための構文は同じです。以下のサンプルでは、Hosts という名前のレイアウトを定義して、ChoiceButton を使用します。
ArgLayout Hosts {ChoiceButton Program
Implementation ("Interp").Line of Code.Line of Code...
};};
組み込みスクリプトのそれぞれの行は、ピリオド (.) で始めます。 TLL 変換プログラムは、これらの行を二重引用符で囲まれたストリングとして扱います。追加の引用符は不要です。この構文を使用することで、straight シェル・スクリプト・コードをそのまま組み込むことが容易になり、シェル・スクリプトでの引用符の使用に関連した潜在的問題が減少します。
注: Binary キーワードでタスク・ライブラリーにインポートするタスクは再書き込みの必要がないので、各行はピリオドで開始します。
タスクそのものとは異なり、Argument レイアウトに組み込まれるスクリプトとコマンドは非特権ユーザーが実行します。それらのスクリプトとコマンドを、特権ユーザーまたは呼び出しアドミニストレーターとして実行する必要がある場合、それらのスクリプトとコマンドはカスタム・メソッドとしてインストールする必要があります。
スクリプトをカスタム・メソッドとしてインストールするには、最初に $BINDIR
変数が指すディレクトリーにそれをコピーする必要があります。最初にカスタム・スクリプト用に、次の例のようにサブディレクトリーを作成しておくことをお勧めします。
516 Tivoli Management Framework: リファレンス・マニュアル
mkdir $BINDIR/CUSTOMcp /path/to/mymethod.sh $BINDIR/CUSTOM/mymethod.sh
wputmeth コマンドはカスタム・メソッドをインストールします。 root として実行するためのスクリプトをインストールするには、以下のコマンドを使用します。
wputmeth -u root -g other -r TaskLibrary mymethod /CUSTOM/mymethod.sh
呼び出しアドミニストレーターとして実行するためのスクリプトをインストールするには、以下のコマンドを使用します。
wputmeth -u ’*’ -g ’*’ -r TaskLibrary mymethod /CUSTOM/mymethod.sh
Argument レイアウトの Implementation セクションで、メソッドは objcall コマンドを使用して呼び出されます。
Implementation ("Interp").objcall ’wlookup -r TaskLibrary LibName’ mymethod
Interp は有効なインタープリター・タイプで、LibName はインストールするライブラリーの名前です。
Argument 文節の定義Argument 文節は、Argument レイアウト (ArgLayout) を使用してタスク・ウィンドウ上のガジェットを作成します。この文節は、Argument レイアウトに関連付けられたデータを読み取り、それをタスク・スクリプトに渡します。このため、スクリプトで定義されたそれぞれの引き数ごとに Argument 文節を定義する必要があります。また、Argument 文節は、ウィンドウでガジェットが表示される順序 (上から下へ) で定義する必要があります。
Argument 文節の構文は、次のとおりです。
Argument "ArgumentName" {Layout = "ArgLayoutName";OptionalAttributes;
}
ArgumentName パラメーターで指定する値は、ユーザーに入力または選択する情報のタイプを示すラベルです。ラベルはガジェットの左側に表示されます。たとえば、あるファイルへのパスを入力することが必要なテキスト・ボックスを作成する場合、ArgumentName パラメーターの値は、「ファイル名」のようなものでなくてはなりません。
Layout キーワードは必須で、その値は定義された Argument レイアウトに一致していなくてはなりません。指定されたレイアウトが定義されていない限り、タスク・エンジンはガジェットを表示できません。 Argument 文節は以下の属性も受け入れます。これらの属性はすべてオプションです。
ButtonLabelボタン上に表示するテキストを指定します。
DefaultValue引き数のデフォルト値を指定します。
レイアウトが Text または CryptoText の場合、デフォルト値がテキスト・ボックスに表示されます。
第 9 章 タスク・ライブラリー言語の構文 517
レイアウトが Choice、TextChoice、ChoiceButton、またはRadioButton の場合、指定した値はオプションの戻り値と一致していなくてはなりません。オプション項目の戻り値および表示される値は違っていても構いません。
レイアウトが FileBrowser または HostFileBrowser の場合、ブラウザー・ウィンドウには指定されたディレクトリーが表示されます。
RadioButton または ChoiceButton レイアウトについてこの属性を指定しないと、最初のオプションが選択されます。
MustMatchすべての構成済みの引き数値が一致しなければならない正規表現を指定します。
MustNotMatch引き数が一致していてはならない正規表現を指定します。
SectionLabel現行の属性が含まれている引き数の上に表示されるグループ・ラベルを指定します。最大で 4 つの SectionLabel 属性を組み込むことができます。追加情報を指定する必要がある場合は、HelpMessage 属性を使用してヘルプ・メッセージを作成します。
以下の例は、MustMatch および MustNotMatch キーワードの使用法を示しています。
^(w{5,}|¥w{5,}-[xX][yY][zZ])$行の先頭でそのストリングに最低 5 つの英数字が含まれているかをチェックするか、もしくは最低 5 つの英数字が含まれており、-XYZ で終わるストリングがあるかどうかをチェックします。XYZ サブストリングのチェックは、大文字小文字を区別しません。
^(120¥.22¥.¥d{1,3}¥.¥d{1,3})$行の先頭で、120.22 で始まる IP アドレスをチェックします。残りの 2 つの数字グループは、1 ~ 3 桁 でなくてはなりません。
¥w{3,8}$英数字ストリングを調べて、そこに 3 ~ 8 文字が含まれているかを判断します。
^[0-1][0-9]-[0-3][0-9]-[12][09][019][0-9]$MM-DD-YYYY フォーマットの日付をチェックします。無効な日付を入力する可能性があるので、追加検査が必要です。
^[0-9]{3}-[0-9]{2}-{0-9]{4}$社会保障番号が正しいフォーマット (NNN-NN-NNNN) で指定されているかチェックします。
以下の例は、幾つかのレイアウトと Argument 文節を示しています。
ArgLayout AscDesc {RadioButton { {("", "Ascending (昇順)", 1) "ASC"}{("", "Descending (降順)", 2) "DESC"} };
};
ArgLayout Number {Text};
518 Tivoli Management Framework: リファレンス・マニュアル
Argument ("", "Ascending or Descending order? (昇順/降順 ?)", 1){Layout = "AscDesc";DefaultValue = "DESC;
};
Argument ("", "Number of Events (イベント数)", 1) {Layout = "Number";MustMatch = "^[0-9][0-9]*$";DefaultValue = ("","1",1);
};
引き数のデフォルト値はそれぞれ DESC (降順) および 1 です。 Number レイアウトの MustMatch キーワードで、テキスト・フィールドに入力された値が整数であることを確認します。
1 タスクあたり最大 23 個の引き数を組み込むことができます。それ以上の数の引き数が必要な場合は、必要な引き数情報が入っている Dialog Specification Language
(DSL) ファイルを使用してダイアログ・ボックスを作成します。使用する前に DSL
ダイアログ・ボックスをコンパイルしてインストールする必要があります。 DSL
の詳細については、「TME 10 ADE Desktop Services Manual」、および「TME 10
ADE Application Services Manual, Volume I」を参照してください。
DSL ダイアログ・ボックスを呼び出すタスクを作成できます。 DSL ダイアログ・ボックスを呼び出すタスクを作成するには、以下の例のように Argument 文節内のLayout キーワードが Dialog に設定されていることを確認してください。
Argument ("", "DisplayedValue", keyLayout="Dialog";
また、DSL ダイアログ・ボックスの名前がタスク定義と同じであることも確認します。たとえば、タスクが以下のように定義されている場合、コンパイルしてインストールする DSL ダイアログ・ボックスの名前は RunSQL.d でなくてはなりません。
Task "RunSQL" {
Argument 文節内の Layout キーワードを Dialog に設定すると、タスク・ライブラリー・コードはタスク定義と同じ名前のファイルを探して実行します
タスク・ライブラリーへのコメントの追加wtll コマンドは、C++ のコメント・インディケーター (//) を有効な TLL 構文とは認識しません。ただし、C コメント・インディケーター (/* */) は認識します。
C プリプロセッサーを、// 文字の後に続く行のすべてのテキストを無視するように構成することができます。以下のコマンドにより、タスク・ライブラリー定義内でC++ コメントを使用できるようになります。
wtll -i -l LibraryName -P /usr/ccs/lib/cpp FileName -B -P
-B および -P オプションは cpp コマンドの一部です。 -B オプションにより、コメント・インディケーターが使用可能になります。-P オプションは追加の処理命令を与えます。
第 9 章 タスク・ライブラリー言語の構文 519
C コメント・インディケーターを使用する場合、-B および -P オプションを指定する必要はありません。
TLL 構成ファイルの編集タスク・ライブラリー・エンジンはファイルの・セットを使用して、タスク・ライブラリー定義内のどの引き数がオプションかを判別します。 UNIX オペレーティング・システムでは、これらのファイルは /etc/Tivoli/tll.conf ディレクトリーにあります。 Windows オペレーティング・システムでは、%SYSTEMROOT%¥system32¥drivers¥etc¥Tivoli¥tll.conf ディレクトリーにあります。
tll.conf ディレクトリーには以下のファイルが含まれています。
arg Arguments セクションの構文解析をコントロールします。このファイルがコントロールする属性についての詳細は、 517ページの『Argument 文節の定義』を参照してください。
layout タスク定義の ArgLayout セクション内の属性の構文解析をコントロールします。現在、ButtonLabel がサポートされている唯一の属性です。
libraryタスク・ライブラリー・ヘッダーの構文解析をコントロールします。このファイルがコントロールする属性についての詳細は、 501ページの『ライブラリー特性の設定』を参照してください。
task タスク・ヘッダーの構文解析をコントロールします。このファイルがコントロールする属性についての詳細は、 514ページの『タスク・ヘッダーの定義』を参照してください。
これらのファイル内に定義される属性は、以下の規則に従わなくてはなりません。
v 各属性は別々の行にリストする必要があります。行の終わりにセミコロンまたは他の句読記号があってはなりません。
v 必須属性の場合、その属性名の前に特殊文字を入れないでください。
v オプション属性名の前には、疑問符 (?) を付けてください。
v 許可されていない属性名の前には、感嘆符 (!) を付けてください。
v タスク・ライブラリーの構文解析時に無視される属性名の前には、番号記号 (#)
を付けてください。
新規属性を tll.conf ファイルに追加することはできません。
以下の例は、デフォルトの ライブラリー・ファイルです。
Version?RequiresHelpMessage?ContextDistribute?DisplayCfgd
注: DisplayCfgd キーワードは、tll.conf ファイルで定義されていてもタスク・ライブラリー内にはインプリメントされていない幾つかのキーワードのうちの 1 つです。
520 Tivoli Management Framework: リファレンス・マニュアル
第 10 章 サンプル・タスク・ライブラリー
この章には、サンプル・タスク・ライブラリーが記載されています。これには、タスク・ライブラリー言語内の可能なエレメントがほとんど含まれています。
TaskLibrary "T/EC Tasks" {Distribute = "ALI";Version = "1.0";Requires = ">2.1";Context = "TEC";
HelpMessage = (tec_tasks, "Tasks for use by the IBM Tivoli Enterprise Console", 1);
ArgLayout Filename {TextChoice FileBrowser;ButtonLabel = (tec_tasks, "File...", 2);
};
ArgLayout HostFilename {TextChoice HostFileBrowser;
ButtonLabel = (tec_tasks, "File...", 2);};
ArgLayout ManagedNode {Choice Multi ( "", ",", "" ) Resource "ManagedNode";ButtonLabel = (tec_tasks, "Managed Node...", 3);
};
ArgLayout Administrator {TextChoice Resource "AdministratorCollection";ButtonLabel = (tec_tasks, "Administrator ...", 131);
};
ArgLayout EventServer {TextChoice Resource "EventServer";ButtonLabel = (tec_tasks, "Choose ...", 68);
};
ArgLayout PolicyRegion {TextChoice Resource "PolicyRegion";ButtonLabel = (tec_tasks, "Choose ...", 68);
};
ArgLayout Host {TextChoice Program {Implementation ( "hpux9" "sunos4", "solaris2", "aix3-r2" )
.#!/bin/sh.awk < /etc/hosts ’/^[0-9][0-9]*/ {print $2}’;
};ButtonLabel = (tec_tasks, "Hosts ...", 66);
};
ArgLayout FileText {RadioButton { {(tec_tasks, "File", 4) "FILE"}{(tec_tasks, "Text", 5) "TEXT"} };
};
ArgLayout AscDesc {RadioButton { {(tec_tasks, "ASC", 6) "ASC"}{(tec_tasks, "DESC", 7) "DESC"} };
};
© Copyright IBM Corp. 2004 521
ArgLayout YesNo {RadioButton { {(tec_tasks, "Yes", 8) "YES"}{(tec_tasks, "No", 9) "NO"} };
};
ArgLayout Number {Text
};
ArgLayout SimpleText {Text;
};
ArgLayout Severities {ChoiceButton {
{ (tec_tasks, "Fatal", 10) "FATAL" }{ (tec_tasks, "Critical", 11) "CRITICAL" }{ (tec_tasks, "Minor", 12) "MINOR" }{ (tec_tasks, "Warning", 13) "WARNING" }{ (tec_tasks, "Harmless", 14) "HARMLESS" }{ (tec_tasks, "Unknown", 15) "UNKNOWN" }};
};
ArgLayout SelectSeverity {TextChoice Multi ("", ",", "")
{{(tec_tasks, "UNKNOWN", 69) "UNKNOWN"}{(tec_tasks, "HARMLESS", 70) "HARMLESS"}{(tec_tasks, "WARNING", 71) "WARNING"}{(tec_tasks, "MINOR", 72) "MINOR"}{(tec_tasks, "CRITICAL", 73) "CRITICAL"}{(tec_tasks, "FATAL", 74) "FATAL"}};
ButtonLabel = (tec_tasks, "Severity ...", 75);};
ArgLayout SelectStatus {TextChoice Multi ("", ",", "")
{{(tec_tasks, "OPEN", 76) "OPEN"}{(tec_tasks, "RESPONDED", 77) "RESPONDED"}{(tec_tasks, "ACKNOWLEDGED", 78) "ACKNOWLEDGED"}{(tec_tasks, "CLOSED", 79) "CLOSED"}};
ButtonLabel = (tec_tasks, "Status ...", 80);};
ArgLayout SelectSlots {Choice Multi ("", ",", "")
{{(tec_tasks, "server_handle", 81) "server_handle"}{(tec_tasks, "date_reception", 82) "date_reception"}{(tec_tasks, "event_handle", 83) "event_handle"}{(tec_tasks, "source", 84) "source"}{(tec_tasks, "sub_source", 39) "sub_source"}{(tec_tasks, "origin", 36) "origin"}{(tec_tasks, "sub_origin", 38) "sub_origin"}{(tec_tasks, "hostname", 35) "hostname"}{(tec_tasks, "adapter_host", 89) "adapter_host"}{(tec_tasks, "status", 90) "status"}{(tec_tasks, "administrator", 91) "administrator"}{(tec_tasks, "acl", 92) "acl"}{(tec_tasks, "severity", 37) "severity"}{(tec_tasks, "date", 94) "date"}{(tec_tasks, "duration", 95) "duration"}{(tec_tasks, "msg", 96) "msg"}{(tec_tasks, "msg_catalog", 97) "msg_catalog"}{(tec_tasks, "msg_index", 98) "msg_index"}{(tec_tasks, "num_actions", 99) "num_actions"}{(tec_tasks, "credibility", 100) "credibility"}{(tec_tasks, "repeat_count", 101) "repeat_count"}
522 Tivoli Management Framework: リファレンス・マニュアル
{(tec_tasks, "cause_date_reception", 102) "cause_date_reception"}{(tec_tasks, "cause_event_handle", 103) "cause_event_handle"}};
ButtonLabel = (tec_tasks, "Slots ...", 104);};
ArgLayout SelectSource {TextChoice Multi ("", ",", "")Program {
Implementation ( "default").#!/bin/sh
.EVENT_SERVER=`wlookup -r EventServer -a | awk ’{print $2}’`
.SOURCES=`idlcall $EVENT_SERVER list_sources`
.for SOURCE in `echo $SOURCES | sed s/[{}]//g`.do
.if [ "$PRINT" = "YES" ];then.echo $SOURCE | sed s/¥"//g
. else. PRINT=YES
. fi.done.exit 0
;};
ButtonLabel = (tec_tasks, "Source ...", 105);};
ArgLayout SelectClass {TextChoice Multi ("", ",", "")Program {
Implementation ( "default").#!/bin/sh
.EVENT_SERVER=`wlookup -r EventServer -a ¥
. | awk ’{print $2}’`
.RB=`idlcall $EVENT_SERVER _get_current_rb`
.CLASSES=`idlcall $EVENT_SERVER list_rb_classes $RB`
.for CLASS in `echo $CLASSES | sed s/[{}]//g`.do
.if [ "$PRINT" = "YES" ];then. echo $CLASS | sed s/¥"//g
. else. PRINT=YES
. fi.done.exit 0
;};ButtonLabel = (tec_tasks, "Event Classes ...", 106);
};
ArgLayout SelectHost {TextChoice Program {Implementation ( "default" )
.#!/bin/sh
.awk < /etc/hosts ’/^[0-9][0-9]*/ {print $2}’ | sort;
};ButtonLabel = (tec_tasks, "Hosts ...", 66);
};
ArgLayout Order {RadioButton { {(tec_tasks, "Ascending", 107) "ASC"}{(tec_tasks, "Descending", 108) "DESC"} };
};
Task Send_Email {Description = (tec_tasks, "e-mail event info ", 16);
HelpMessage = (tec_tasks, "This task will send information about the event tothe supplied address. Provide the name and the email address of the administrator
第 10 章 サンプル・タスク・ライブラリー 523
that you want to send the message to.", 17);
Roles = "super:senior:admin:user";Argument (tec_tasks, "Administrator’s Name", 18) {
Layout = "SimpleText";DefaultValue = "Chris Sanders";
};
Argument (tec_tasks, "Administrator’s E-mail Address", 19) {Layout = "SimpleText";DefaultValue = "[email protected]";
};
Implementation ("default").#! /bin/sh.#.# This script assumes that sendmail is available.# and is in /usr/lib..#..PATH=/bin:/usr/bin:/usr/ucb:/usr/lib.export PATH..MAIL_MESSAGE=". cause_date : $cause_date. cause_hndl : $cause_hndl. class_name : $class_name. date_event : $date_event. ev_key : $ev_key. formatted_date : $formatted_date. handle : $handle. srvr_handle : $srvr_handle"..for SLOT in $SLOTS; do. eval slotVal=¥"¥$"${SLOT}"¥". if [ ! -z "$slotVal" ]; then. length=`expr "$SLOT" : ’.*’`. if [ $length -gt 7 ]; then. if [ $length -gt 15 ]; then. MAIL_MESSAGE="$MAIL_MESSAGE. $SLOT : $slotVal". else. MAIL_MESSAGE="$MAIL_MESSAGE. $SLOT : $slotVal". fi. else. MAIL_MESSAGE="$MAIL_MESSAGE. $SLOT : $slotVal". fi. fi
.done..echo Sending message to $2 ....sendmail -F’T/EC’ -t << __EOF__.To: $2.Subject: Automatic Event Response message.Dear $1,..Event received with the following:..$MAIL_MESSAGE..Sincerely,.Event Task Send_Email.__EOF__
524 Tivoli Management Framework: リファレンス・マニュアル
.
.echo done.;};
Task Log_Event_To_File {
Description = (tec_tasks, "Log event to file", 20);
HelpMessage = (tec_tasks, "This task will log information about an event to afile. Supply the path to the file that you want the infomation logged to.", 21);
Roles = "super:senior:admin";
Argument (tec_tasks, "Log File Name", 22) {Layout = "Filename";ButtonLabel = (tec_tasks, "Log File Name", 22);
};
Implementation ("default").#!/bin/sh
.
.LOG_MESSAGE="
. cause_date : $cause_date
. cause_hndl : $cause_hndl
. class_name : $class_name
. date_event : $date_event
. ev_key : $ev_key
. formatted_date : $formatted_date
. handle : $handle
. srvr_handle : $srvr_handle"
.
.for SLOT in $SLOTS; do
. eval slotVal=¥"¥$"${SLOT}"¥"
. if [ ! -z "$slotVal" ]; then
. length=`expr "$SLOT" : ’.*’`
. if [ $length -gt 7 ]; then
. if [ $length -gt 15 ]; then
. LOG_MESSAGE="$LOG_MESSAGE
. $SLOT : $slotVal"
. else
. LOG_MESSAGE="$LOG_MESSAGE
. $SLOT : $slotVal"
. fi
. else
. LOG_MESSAGE="$LOG_MESSAGE
. $SLOT : $slotVal"
. fi
. fi.done
.
.
.echo Logging event to file $1 ...
.
.echo "
.#
.Event received at `/bin/date`
.
. $LOG_MESSAGE
.
." >> $1
.
.sync
.echo done..exit 0
;};
第 10 章 サンプル・タスク・ライブラリー 525
Task Popup_Message {Description = (tec_tasks, "Popup message on desktop ", 23);
HelpMessage = (tec_tasks, "This task will display a dialog on aTivoli デスクトップ. Supply the administrator label and the path to the filethat contains the text to be displayed.", 24);
Roles = "super:senior:admin";
Argument (tec_tasks, "Administrator Name", 18) {Layout = "Administrator";MustMatch = ".";
};
Argument (tec_tasks, "File Name", 25) {Layout = "HostFilename";ButtonLabel = (tec_tasks, "File Name", 25);
};
Implementation ("default").#!/bin/sh
.echo Posting message to an administrator desktop ...
.wsendresp $1 $2
.rc=$?
.echo done
.exit $rc;
};
Task Wake_Up_Netscape {
Description = (tec_tasks, "Jump Netscape to URL", 26);
HelpMessage = (tec_tasks, "This task causes a Netscape window to be displayed withthe specified URL. The window is from an already running Netscape process ora new Netscape process is started. Specify the URL to be displayed.", 27);
Argument (tec_tasks, "URL to DISPLAY", 28) {Layout = "SimpleText";DefaultValue = "http://www.tivoli.com";
};
Roles = "super:senior:admin";
Implementation ("default").#!/bin/sh
.# Uncomment the following lines to assist with debugging
.# exec > /tmp/view_online_doc.out 2>&1
.# set -x
.
.# env
.# echo $1
.echo Sending command to netscape ...
.if [ "$WD_DISPLAY" != "" ];then.DISPLAY="$WD_DISPLAY"
.fi
.export DISPLAY
.PATH=$PATH:/usr/local/bin
.
.HOSTNAME=`uname -n`
.URL=$1
.netscape -noraise -remote "openURL($URL,new-window)"
.netrc=$?
.echo done
.exit $netrc;
};
526 Tivoli Management Framework: リファレンス・マニュアル
Task Forward_Event {
Description = (tec_tasks, "Forward event to event server", 29);
HelpMessage = (tec_tasks, "This task forwards an event to another event server.Select the server to receive the event.", 30);
Roles = "super:senior:admin:user";
Argument (tec_tasks, "Event server name", 33) {Layout = "EventServer";MustMatch = ".";
};
Implementation ("default").#!/bin/sh
.
.COMMAND="wpostemsg -S $1 "
.
.for SLOT in $SLOTS; do
. if [ $SLOT = server_handle ]; then
. continue
. fi
. if [ $SLOT = date_reception ]; then
. continue
. fi
. if [ $SLOT = event_handle ]; then
. continue
. fi
. if [ $SLOT = acl ]; then
. continue
. fi
. if [ $SLOT = duration ]; then
. continue
. fi
. if [ $SLOT = num_actions ]; then
. continue
. fi
. if [ $SLOT = credibility ]; then
. continue
. fi
. if [ $SLOT = repeat_count ]; then
. continue
. fi
. if [ $SLOT = cause_date_reception ]; then
. continue
. fi
. if [ $SLOT = cause_event_handle ]; then
. continue
. fi
. if [ $SLOT = administrator ]; then
. continue
. fi
. eval slotVal=¥"¥$"${SLOT}"¥"
. if [ ! -z "$slotVal" ]; then
. COMMAND="$COMMAND $SLOT=$slotVal"
. fi.done
.
.COMMAND="$COMMAND $class_name $source"
.
.echo Forwarding event to $1 ...
.eval $COMMAND
.rc=$?
第 10 章 サンプル・タスク・ライブラリー 527
.echo done
.exit $rc;
};
Task Send_Event {
Description = (tec_tasks, "Send event to event server", 31);
HelpMessage = (tec_tasks, "This task generates a new event and sends it to theselected event server. Select the server and specify the characteristics of theevent to be sent.", 32);
Roles = "super:senior:admin:user";
Argument (tec_tasks, "Event server name", 33) {Layout = "EventServer";MustMatch = ".";
};
Argument (tec_tasks, "message", 34) {Layout = "SimpleText";
};
Argument (tec_tasks, "hostname", 35) {Layout = "SimpleText";
};
Argument (tec_tasks, "origin", 36) {Layout = "SimpleText";
};
Argument (tec_tasks, "severity", 37) {Layout = "SimpleText";
};
Argument (tec_tasks, "sub_origin", 38) {Layout = "SimpleText";
};
Argument (tec_tasks, "sub_source", 39) {Layout = "SimpleText";
};
Argument (tec_tasks, "CLASS_NAME", 40) {Layout = "SimpleText";
};
Argument (tec_tasks, "SOURCE", 41) {Layout = "SimpleText";
};
Implementation ("default").#!/bin/sh
.echo Sending event to $1 ...
.wpostemsg -S $1 msg=$2 hostname=$3 origin=$4 severity=$5 ¥sub_origin=$6 sub_source=$7 $8 $9
.rc=$?
.echo done
.exit $rc;
};
Task Reset_Event_Log {
Description = (tec_tasks, "Reset transaction log", 42);
HelpMessage = (tec_tasks, "This task clears the transaction log of anything that is
528 Tivoli Management Framework: リファレンス・マニュアル
more than 30 seconds old.", 43);
Roles = "super:senior:admin:user";
Implementation ("default").#!/bin/sh
.echo Resetting event log ...
.wtdbresetlog
.rc=$?
.echo done
.exit $rc;
};
Task Clear_Reception_Log {
Description = (tec_tasks, "Clear reception log ", 132);
HelpMessage = (tec_tasks, "This task clears from the reception log anything thatwas received more than 30 seconds ago.", 133);
Roles = "super:senior:admin:user";
Implementation ("default").#!/bin/sh
.echo Clearing reception log ...
.wtdbclear -l -t 30
.rc=$?
.echo done
.exit $rc;
};
Task Clear_Closed_Events {
Description = (tec_tasks, "Clear closed events ", 44);
HelpMessage = (tec_tasks, "This task clears closed events from the event repositorythat are older than the specified time. Specify how old events should be to becleared.", 45);
Roles = "super:senior:admin:user";
Argument (tec_tasks, "Seconds Old", 46) {Layout = "Number";ButtonLabel = (tec_tasks, "Seconds Old", 46);MustMatch = "^[0-9][0-9]*$";DefaultValue = "30";
};
Implementation ("default").#!/bin/sh
.echo Clearing out closed events ...
.wtdbclear -e -s CLOSED -t $1
.rc=$?
.echo done
.exit $rc;
};
Task Change_Severity {
Description = (tec_tasks, "Change severity of event", 47);
HelpMessage = (tec_tasks, "This task will change the severity of the current event.Select the new severity for the event.", 48);
Roles = "super:senior:admin:user";
第 10 章 サンプル・タスク・ライブラリー 529
Argument (tec_tasks, "Severity", 49) {Layout = "Severities";ButtonLabel = (tec_tasks, "Severity", 49);DefaultValue = "FATAL";
};
Implementation ("default").#!/bin/sh
.echo Changed event severity ...
.wsetemsg -r $1 $CONSOLE_NAME $ev_key
.rc=$?
.echo done
.exit $rc;
};
Task Dump_Event_Repository {
Description = (tec_tasks, "Dump event repository", 50);
HelpMessage = (tec_tasks, "This task will dump out events from the event repository.Specify how many events to dump and whether they should be in ascending ordescending order.", 51);
Roles = "super:senior:admin:user";
Argument (tec_tasks, "Ascending or Descending order?", 67) {Layout = "AscDesc";
};
Argument (tec_tasks, "Number of Events", 52) {Layout = "Number";ButtonLabel = (tec_tasks, "Number of Events", 52);MustMatch = "^[0-9][0-9]*$";DefaultValue = "1";
};
Implementation ("default").#!/bin/sh
.echo Dumping $2 events from the event repository ...
.wtdumper -d -o $1 -m $2
.rc=$?
.echo done
.exit $rc;
};
Task Backup_Event_log {
Description = (tec_tasks, "Backup the event log", 53);
HelpMessage = (tec_tasks, "This task will backup the event log. No input argumentsare required.", 54);
Roles = "super:senior:admin:user";
Implementation ("default").#!/bin/sh
.echo Backing up event log ...
.wtdbbackup
.rc=$?
.echo done
.exit $rc;
};
530 Tivoli Management Framework: リファレンス・マニュアル
Task Event_Query {
Description = (tec_tasks, "Query event repository", 109);
HelpMessage = (tec_tasks, "This task will perform a query on the event repositoryand display the events that match the query. Specify the values that you want touse to perform the query.", 110);
Roles = "super:senior:admin:user";
Argument (tec_tasks, "Match Class:", 120) {Layout = "SelectClass";DefaultValue = "*";
};
Argument (tec_tasks, "Match Status:", 121) {Layout = "SelectStatus";DefaultValue = "*";
};
Argument (tec_tasks, "Match Severity:", 122) {Layout = "SelectSeverity";DefaultValue = "*";
};
Argument (tec_tasks, "Match Hostname:", 123) {Layout = "SelectHost";DefaultValue = "*";
};
Argument (tec_tasks, "Match Source:", 124) {Layout = "SelectSource";DefaultValue = "*";
};
Argument (tec_tasks, "Match SubSource:", 125) {Layout = "SimpleText";ButtonLabel = "SubSource";DefaultValue = "*";
};
Argument (tec_tasks, "Match Origin:", 126) {Layout = "SimpleText";ButtonLabel = "Origin";DefaultValue = "*";
};
Argument (tec_tasks, "Match SubOrigin:", 127) {Layout = "SimpleText";ButtonLabel = "SubOrigin";DefaultValue = "*";
};
Argument (tec_tasks, "Match Message:", 128) {Layout = "SimpleText";ButtonLabel = "Message";DefaultValue = "*";
};
Argument (tec_tasks, "Starting Date and Time:", 59) {Layout = "SimpleText";ButtonLabel = "Start Date";DefaultValue = "*";
};
Argument (tec_tasks, "Order Events by:", 116) {Layout = "Order";
第 10 章 サンプル・タスク・ライブラリー 531
DefaultValue = "ASC";DefaultValue = "*";
};
Argument (tec_tasks, "Show values for slots:", 117) {Layout = "SelectSlots";DefaultValue = "*";
};
Implementation ("default").#!/bin/sh
.#
.# This script is called by the event repository query task
.# It formats some of the arguments into a where clause which
.# can be passed to wtdumper. It also filters the output so
.# that only interesting slots are actually printed.
.#
.# Functions
.#
.make_in_char()
.{
. VALUE=$2
. COLUMN=$1
. if [ "$VALUE" = "*" -o "$VALUE" = "" ]; then
. VALUE="$COLUMN LIKE ¥"%¥" "
. else
. TEMP=`echo $VALUE | sed s/,/"¥",¥""/g`
. VALUE="$COLUMN IN (¥"$TEMP¥")"
. fi
.}
.
.make_in_int()
.{
. VALUE=$2
. COLUMN=$1
. if [ "$VALUE" = "*" -o "$VALUE" = "" ]; then
. VALUE=""
. else
. TEMP=`echo $VALUE | sed s/,/","/g`
. VALUE="$COLUMN IN ($TEMP)"
. fi
.}
.
.make_like()
.{
. VALUE=$2
. COLUMN=$1
. if [ "$VALUE" = "*" -o "$VALUE" = "" ]; then
. VALUE="$COLUMN LIKE ¥"%¥" "
. else
. VALUE="$COLUMN LIKE ¥"$VALUE¥" "
. fi
.}
.
.#
.# Mainline starts here
.#
.CLASS=$1;shift
.STATUS=$1;shift
.SEVERITY=$1;shift
.HOSTNAME=$1;shift
.SOURCE=$1;shift
.SUB_SOURCE=$1;shift
.ORIGIN=$1;shift
.SUB_ORIGIN=$1;shift
.MSG=$1;shift
532 Tivoli Management Framework: リファレンス・マニュアル
.START_TIME=$1;shift
.ORDER=$1;shift
.SLOTS=$1
.
.#
.# Format the where clause
.#
.
.make_in_char class "$CLASS"
.WHERE="$VALUE"
.
.STATUS=`echo "$STATUS" | sed -e s/OPEN/0/ ¥
. -e s/RESPONDED/10/ -e s/ACKNOWLEDGED/20/ -e s/CLOSED/30/ `
.make_in_int status "$STATUS"
.if [ "$VALUE" != "" ];then
. WHERE="$WHERE AND $VALUE"
.fi
.
.SEVERITY=`echo "$SEVERITY" | sed -e s/UNKNOWN/10/ ¥
. -e s/HARMLESS/20/ -e s/WARNING/30/ ¥
. -e s/MINOR/40/ -e s/CRITICAL/50/ ¥
. -e s/FATAL/60/ `
.make_in_int severity "$SEVERITY"
.if [ "$VALUE" != "" ];then
. WHERE="$WHERE AND $VALUE"
.fi
.
.make_in_char hostname "$HOSTNAME"
.WHERE="$WHERE AND $VALUE"
.
.make_in_char source "$SOURCE"
.WHERE="$WHERE AND $VALUE"
.
.make_like sub_source "$SUB_SOURCE"
.WHERE="$WHERE AND $VALUE"
.
.make_like origin "$ORIGIN"
.WHERE="$WHERE AND $VALUE"
.
.make_like sub_origin "$SUB_ORIGIN"
.WHERE="$WHERE AND $VALUE"
.
.make_like msg "$MSG"
.WHERE="$WHERE AND $VALUE"
.
.# If slots are being specified.
.# First remove the list of slots to print from the
.# list of available slots. Then exclude these slots on
.# the output of the wtdumper command. This makes sure that
.# all slots that are extensions of the base event will print.
.
.if [ "$SLOTS" = "*" -o "$SLOTS" = "" ];then
. if [ "$START_TIME" = "" -o "$START_TIME" = "*" ];then
. wtdumper -d -o "$ORDER" -w "$WHERE"
. else
. wtdumper -d -t "$START_TIME" -o "$ORDER" -w "$WHERE"
. fi
.else
. SLOTS_TO_KEEP=`echo $SLOTS ¥
. | sed -e "s/^/-e /" -e "s/,/¥$ -e /g" -e "s/$/¥$/"`
. SLOTS_TO_SKIP=`grep -v $SLOTS_TO_KEEP <<EOF
. server_handle
. date_reception
. event_handle
. source
. sub_source
. origin
第 10 章 サンプル・タスク・ライブラリー 533
. sub_origin
. hostname
. adapter_host
. status
. administrator
. acl
. severity
. date
. duration
. msg
. msg_catalog
. msg_index
. num_actions
. credibility
. repeat_count
. cause_date_reception
. cause_event_handle
. EOF`
.
. SLOTS_TO_SKIP=`echo $SLOTS_TO_SKIP ¥
. | sed -e "s/ /= -e /g" -e "s/^/-e /" -e "s/$/=/"`
.
.#
.# Run the wtdumper command and pipe it to the output formatter
.#
. if [ "$START_TIME" = "*" -o "$START_TIME" = "" ];then
. wtdumper -d -o "$ORDER" -w "$WHERE" ¥
. | grep -v $SLOTS_TO_SKIP
. else
. wtdumper -d -t "$START_TIME" -o "$ORDER" -w "$WHERE" ¥
. | grep -v $SLOTS_TO_SKIP
. fi
.fi
.
.exit $?;
};
Task page_admin {
Description = (tec_tasks, "Send alphanumeric page", 60);
HelpMessage = (tec_tasks, "This task will use the fbeep program to send a page. Thedevice name for the modem, phone number, page number and the message number must besupplied as input arguments. It is assumed that the fbeep proram can be found inthe search path. If you do not have this program the source for it is shippedwith IBM Tivoli Enterprise Console and it gets installedin $BINDIR/TME/TEC/contrib/pager.", 61);
Argument (tec_tasks, "Device", 62) {Layout = "SimpleText";DefaultValue = "/dev/ttya";MustMatch = ".";
};
Argument (tec_tasks, "Phone Number", 63) {Layout = "SimpleText";DefaultValue = "9,18005551000";MustMatch = ".";};
Argument (tec_tasks, "Pager Number", 64) {Layout = "SimpleText";DefaultValue = "1234567";MustMatch = ".";
};
Argument (tec_tasks, "Message", 65) {
534 Tivoli Management Framework: リファレンス・マニュアル
Layout = "SimpleText";MustMatch = ".";
};
Roles = "super:senior:admin:user";
Implementation ("default").#!/bin/sh
.set -xv
.echo Attempting to send page ...
.fbeep -vv -D $1 -d $2 -p $3 - $4
.rc=$?
.echo Page sent with return code $rc.
.exit $rc;
};
Task Find_Similar_Events {
Description = (tec_tasks, "Find matching event", 118);
HelpMessage = (tec_tasks, "This task will perform a query to find events that havesimilar characteristics as the task in whose context this task is executed. Specifywhich attributes you want to match on.", 119);
Roles = "super:senior:admin:user";
Argument (tec_tasks, "Match Class:", 120) {Layout = "YesNo";DefaultValue = "YES";
};
Argument (tec_tasks, "Match Status:", 121) {Layout = "YesNo";DefaultValue = "YES";
};
Argument (tec_tasks, "Match Severity:", 122) {Layout = "YesNo";DefaultValue = "YES";
};
Argument (tec_tasks, "Match Hostname:", 123) {Layout = "YesNo";DefaultValue = "YES";
};
Argument (tec_tasks, "Match Source:", 124) {Layout = "YesNo";DefaultValue = "YES";
};
Argument (tec_tasks, "Match SubSource:", 125) {Layout = "YesNo";DefaultValue = "YES";
};
Argument (tec_tasks, "Match Origin:", 126) {Layout = "YesNo";DefaultValue = "YES";
};
Argument (tec_tasks, "Match SubOrigin:", 127) {Layout = "YesNo";DefaultValue = "YES";
};
Argument (tec_tasks, "Match Message:", 128) {
第 10 章 サンプル・タスク・ライブラリー 535
Layout = "YesNo";DefaultValue = "YES";
};
Argument (tec_tasks, "Starting Date and Time:", 59) {Layout = "SimpleText";DefaultValue = "*";
};
Argument (tec_tasks, "Order Events by:", 116) {Layout = "Order";DefaultValue = "ASC";
};
Argument (tec_tasks, "Show values for slots:", 117) {Layout = "SelectSlots";DefaultValue = "*";
};
Implementation ("default").#!/bin/sh
.#
.# This script is called by the event repository query task
.# It formats some of the arguments into a where clause which
.# can be passed to wtdumper. It also filters the output so
.# that only interesting slots are actually printed.
.#
.# Functions
.#
.make_in_char()
.{
. VALUE=$2
. COLUMN=$1
. if [ "$VALUE" = "*" -o "$VALUE" = "" ]; then
. VALUE="$COLUMN LIKE ¥"%¥" "
. else
. TEMP=`echo $VALUE | sed s/,/"¥",¥""/g`
. VALUE="$COLUMN IN (¥"$TEMP¥")"
. fi
.}
.
.make_in_int()
.{
. VALUE=$2
. COLUMN=$1
. if [ "$VALUE" = "*" -o "$VALUE" = "" ]; then
. VALUE=""
. else
. TEMP=`echo $VALUE | sed s/,/","/g`
. VALUE="$COLUMN IN ($TEMP)"
. fi
.}
.
.make_like()
.{
. VALUE=$2
. COLUMN=$1
. if [ "$VALUE" = "*" -o "$VALUE" = "" ]; then
. VALUE="$COLUMN LIKE ¥"%¥" "
. else
. VALUE="$COLUMN LIKE ¥"$VALUE¥" "
. fi
.}
.
.#
.# Mainline starts here
.#
536 Tivoli Management Framework: リファレンス・マニュアル
.if [ "$1" = "NO" ];then
. CLASS="*"
.else
. CLASS="$class"
.fi
.shift
.if [ "$1" = "NO" ];then
. STATUS="*"
.else
. STATUS="$status"
.fi
.shift
.if [ "$1" = "NO" ];then
. SEVERITY="*"
.else
. SEVERITY="$severity"
.fi
.shift
.if [ "$1" = "NO" ];then
. HOSTNAME="*"
.else
. HOSTNAME="$hostname"
.fi
.shift
.if [ "$1" = "NO" ];then
. SOURCE="*"
.else
. SOURCE="$source"
.fi
.shift
.if [ "$1" = "NO" ];then
. SUB_SOURCE="*"
.else
. SUB_SOURCE="$sub_source"
.fi
.shift
.if [ "$1" = "NO" ];then
. ORIGIN="*"
.else
. ORIGIN="$origin"
.fi
.shift
.if [ "$1" = "NO" ];then
. SUB_ORIGIN="*"
.else
. SUB_ORIGIN="$sub_source"
.fi
.shift
.if [ "$1" = "NO" ];then
. MSG="*"
.else
. MSG="$msg"
.fi
.shift
.START_TIME=$1;shift
.ORDER=$1;shift
.SLOTS=$1
.
.#
.# Format the where clause
.#
.
.make_in_char class "$CLASS"
.WHERE="$VALUE"
.
.STATUS=`echo "$STATUS" | sed -e s/OPEN/0/ ¥
. -e s/RESPONDED/10/ ¥
第 10 章 サンプル・タスク・ライブラリー 537
. -e s/ACKNOWLEDGED/20/ ¥
. -e s/CLOSED/30/ `
.make_in_int status "$STATUS"
.if [ "$VALUE" != "" ];then
. WHERE="$WHERE AND $VALUE"
.fi
.
.SEVERITY=`echo "$SEVERITY" | sed -e s/UNKNOWN/10/ ¥
. -e s/HARMLESS/20/ ¥
. -e s/WARNING/30/ ¥
. -e s/MINOR/40/ ¥
. -e s/CRITICAL/50/ ¥
. -e s/FATAL/60/ `
.make_in_int severity "$SEVERITY"
.if [ "$VALUE" != "" ];then
. WHERE="$WHERE AND $VALUE"
.fi
.
.make_in_char hostname "$HOSTNAME"
.WHERE="$WHERE AND $VALUE"
.
.make_in_char source "$SOURCE"
.WHERE="$WHERE AND $VALUE"
.
.make_like sub_source "$SUB_SOURCE"
.WHERE="$WHERE AND $VALUE"
.
.make_like origin "$ORIGIN"
.WHERE="$WHERE AND $VALUE"
.
.make_like sub_origin "$SUB_ORIGIN"
.WHERE="$WHERE AND $VALUE"
.
.make_like msg "$MSG"
.WHERE="$WHERE AND $VALUE"
.
.#
.# Logic when slots are being specified.
.# Remove the list of slots to print from the
.# list of available slots. Then exclude the slots on
.# the output of the wtdumper command. This makes sure that
.# all slots that are extensions of the base event will print.
.#
.
.if [ "$SLOTS" = "*" -o "$SLOTS" = "" ];then
. #
. # Run the wtdumper command
. #
. if [ "$START_TIME" = "" -o "$START_TIME" = "*" ];then
. wtdumper -d -o "$ORDER" -w "$WHERE"
. else
. wtdumper -d -t "$START_TIME" -o "$ORDER" -w "$WHERE"
. fi
.else
. SLOTS_TO_KEEP=`echo $SLOTS ¥
. | sed -e "s/^/-e /" -e "s/,/¥$ -e /g" -e "s/$/¥$/"`
. SLOTS_TO_SKIP=`grep -v $SLOTS_TO_KEEP <<EOF
. server_handle
. date_reception
. event_handle
. source
. sub_source
. origin
. sub_origin
. hostname
. adapter_host
. status
538 Tivoli Management Framework: リファレンス・マニュアル
. administrator
. acl
. severity
. date
. duration
. msg
. msg_catalog
. msg_index
. num_actions
. credibility
. repeat_count
. cause_date_reception
. cause_event_handle
. EOF`
.
. SLOTS_TO_SKIP=`echo $SLOTS_TO_SKIP ¥
. | sed -e "s/ /= -e /g" -e "s/^/-e /" -e "s/$/=/"`
.
. #
. # Run wtdumper and pipe it to the output formatter
. #
. if [ "$START_TIME" = "*" -o "$START_TIME" = "" ];then
. wtdumper -d -o "$ORDER" -w "$WHERE" ¥
. | grep -v $SLOTS_TO_SKIP
. else
. wtdumper -d -t "$START_TIME" -o "$ORDER" -w "$WHERE" ¥
. | grep -v $SLOTS_TO_SKIP
. fi
.fi
.
.exit $?;
};
Task Clean_Database {
Description = (tec_tasks, "Clean out event repository", 129);
HelpMessage = (tec_tasks, "Clean out old events from the event repository.", 130);
Roles = "super:senior:admin:user";
Implementation ("default").#! /bin/sh... /etc/Tivoli/setup_env.sh..#.# The following section sets up some.# environment variable you might need..#.TNR=${TNR:-`wlookup NameRegistry`}.export TNR..methodpath="$EXECDIR/$INTERP/TME/TEC".export methodpath..EventServer=`wlookup -r EventServer EventServer`..wtdbresetlog..#.# The following section removes all events in.# the reception log that are older than REC_LOG_TIME.#.REC_LOG_TIME=`idlattr -t -g $EventServer recv_log_time ulong`.wtdbclear -l -t $REC_LOG_TIME 1> /dev/null 2>&1.if [ $? -ne 0 ]
第 10 章 サンプル・タスク・ライブラリー 539
.then
. echo "There was a problem executing wtdbclear, ret = $?"
. exit 1;
.fi
.
.#
.# The following section removes events in
.# the event repository that are closed and older
.# than the time specified in the parameters dialog
.#
.CLOSED_CACHE_TIME=`idlattr -t -g $EventServer rule_cache_full_history ulong`
.wtdbclear -e -s CLOSED -t $CLOSED_CACHE_TIME 1> /dev/null 2>&1
.if [ $? -ne 0 ]
.then
. echo "There was a problem executing wtdbclear, ret = $?"
. exit 1;
.fi
.
.wtdbresetlog;
};}
540 Tivoli Management Framework: リファレンス・マニュアル
付録. 特記事項
本書は米国 IBM が提供する製品およびサービスについて作成したものであり、本書に記載の製品、サービス、または機能が日本においては提供されていない場合があります。日本で利用可能な製品、サービス、および機能については、日本 IBM
の営業担当員にお尋ねください。本書で IBM 製品、プログラム、またはサービスに言及していても、その IBM 製品、プログラム、またはサービスのみが使用可能であることを意味するものではありません。これらに代えて、IBM の知的所有権を侵害することのない、機能的に同等の製品、プログラム、またはサービスを使用することができます。ただし、IBM 以外の製品とプログラムの操作またはサービスの評価および検証は、お客様の責任で行っていただきます。
IBM は、本書に記載されている内容に関して特許権 (特許出願中のものを含む) を保有している場合があります。本書の提供は、お客様にこれらの特許権について実施権を許諾することを意味するものではありません。
使用許諾については、下記の宛先に書面にてご照会ください。
〒106-0032
東京都港区六本木 3-2-31
IBM World Trade Asia Corporation
Licensing
以下の保証は、国または地域の法律に沿わない場合は、適用されません。
IBM およびその直接または間接の子会社は、本書を特定物として現存するままの状態で提供し、商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を含むすべての明示もしくは黙示の保証責任を負わないものとします。
国または地域によっては、法律の強行規定により、保証責任の制限が禁じられる場合、強行規定の制限を受けるものとします。
この情報には、技術的に不適切な記述や誤植を含む場合があります。本書は定期的に見直され、必要な変更は本書の次版に組み込まれます。 IBM は予告なしに、随時、この文書に記載されている製品またはプログラムに対して、改良または変更を行うことがあります。
本書において IBM 以外の Web サイトに言及している場合がありますが、便宜のため記載しただけであり、決してそれらの Web サイトを推奨するものではありません。それらの Web サイトにある資料は、この IBM 製品の資料の一部ではありません。それらの Web サイトは、お客様の責任でご使用ください。
IBM は、お客様が提供するいかなる情報も、お客様に対してなんら義務も負うことのない、自ら適切と信ずる方法で、使用もしくは配布することができるものとします。
© Copyright IBM Corp. 2004 541
本プログラムのライセンス保持者で、(i) 独自に作成したプログラムとその他のプログラム(本プログラムを含む)との間での情報交換、および (ii) 交換された情報の相互利用を可能にすることを目的として、本プログラムに関する情報を必要とする方は、下記に連絡してください。
IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758 U.S.A.
本プログラムに関する上記の情報は、適切な使用条件の下で使用することができますが、有償の場合もあります。
本書で説明されているライセンス・プログラムまたはその他のライセンス資料は、IBM 所定のプログラム契約の契約条項、IBM プログラムのご使用条件、またはそれと同等の条項に基づいて、IBM より提供されます。
IBM 以外の製品に関する情報は、その製品の供給者、出版物、もしくはその他の公に利用可能なソースから入手したものです。IBM は、それらの製品のテストは行っておりません。したがって、他社製品に関する実行性、互換性、またはその他の要求については確証できません。 IBM 以外の製品の性能に関する質問は、それらの製品の供給者にお願いします。
本書には、日常の業務処理で用いられるデータや報告書の例が含まれています。より具体性を与えるために、それらの例には、個人、企業、ブランド、あるいは製品などの名前が含まれている場合があります。これらの名称はすべて架空のものであり、名称や住所が類似する企業が実在しているとしても、それは偶然にすぎません。
この情報をソフトコピーでご覧になっている場合は、写真やカラーの図表は表示されない場合があります。
商標AIX、AS/400、DB2、IBM、MVS、OS/2、OS/400、S/390、Tivoli、Tivoli
Enterprise、Tivoli Enterprise Console、TME、TME 10、WebSphere、WIN-OS/2、z/OS
は、IBM Corporation の商標です。
Microsoft、Windows、Windows NT および Windows ロゴは、Microsoft Corporation
の米国およびその他の国における商標です。
Action Media、LANDesk、MMX、Pentium および ProShare は Intel Corporation の米国およびその他の国における商標です。Intel の商標のリストは、http://www.intel.com/sites/corporate/tradmarx.htm を参照してください。
Java およびすべての Java 関連の商標およびロゴは、Sun Microsystems, Inc.
の米国およびその他の国における商標または登録商標です。
542 Tivoli Management Framework: リファレンス・マニュアル
UNIX は、The Open Group がライセンスしている米国およびその他の国における登録商標です。
他の会社名、製品名およびサービス名などはそれぞれ各社の商標または登録商標です。
付録. 特記事項 543
544 Tivoli Management Framework: リファレンス・マニュアル
索引日本語, 数字, 英字, 特殊文字の順に配列されています。なお, 濁音と半濁音は清音と同等に扱われています。
[ア行]アイコン、Windows Program Manager への追加 89
アクセシビリティー ix
アクセス、リモートWindows エンドポイント 284
Windows 管理対象ノード 412
値ALI 502
GLOBAL 502
LOCAL 502
アドミニストレーターグループ役割の変更 394
作業コレクションの表示 341
作業コレクションの変更 104
作成 143
状況の検索情報 237
通知グループサブスクリプションの変更 394
ログインの変更 394
root アドミニストレーターの削除 93
root アドミニストレーターの作成 93
アドミニストレーター・コマンド表 11
wauthadmin 93
wcd 104
wcrtadmin 143
wgetadmin 237
widmap 263
wpwd 341
wsetadmin 394
wsetlang 400
アプリケーションアンインストール 439
インストール 271
依存関係、設定 498
依存関係セット解決 180
関連付け 105
作成 180
表示 180
編集 180
イタリック体、その意味 ix
一時ディレクトリー、検証 429
インスタンス所有者、DB2 161
インスタンス名、DB2 161
インスタンス名、Oracle 159, 408
インスタンス・ホーム、DB2 160
インストール、製品のアップグレード333
インストール・イメージ、CD からのコピー 140
インストール・コマンド表 13
oinstall 71
wclient 121
wcpcdrom 140
winstall 271
winstlcf 276
wmailhost 307
wpatch 333
wpreinst.sh 388
wserver 388
wsettap 412
wstandalone 419
インストール・ディレクトリー管理対象ノード用インストール・ディレクトリーの取得 274
DB2 160
Informix 160
インターフェース、IP
管理対象ノード上の IP インターフェースのリスト表示 265
管理対象ノードからの除去 265
管理対象ノードのプロパティーの変更265
管理対象ノードへの追加 265
インターフェース・ファイル、Sybase 160
インタープリター・タイプ概要 vii
管理対象ノードのインタープリター・タイプの取得 283
インプリメンテーション属性取得 23
設定 23
追加 23
インベントリー状況、照会 374
エンドポイントアップグレード 223
インストール 276
インストール (AS/400) 86
ウェイクアップ 92
管理するゲートウェイの判別 462
構成 31
エンドポイント (続き)
削除 169
状況 219
情報の表示 201
初期ポスト・インストール処理 456
接続の検証 452
タスク・ターゲットとして検証する484
タスク・ライブラリー内のデフォルト・リスト 480
バッチ・ファイルの使用 397
ブート・メソッドに関する処理 201
プロパティーの設定 201
プロファイル・マネージャーへのサブスクリプションをリストする 297
マイグレーション 201
前のバージョンのインストール 223
リモート・アクセス・アカウントの設定 (Windows) 284
ロギング・オプションの設定 31
ログイン時の自動アップグレード 459
ログイン処理 459
ログイン・オプションの設定 31
HTTP パスワードの設定 201
UNIX エンドポイントの開始 43
UNIX エンドポイントの停止 43
エンドポイント・コマンドlcfd 31
lcfd.sh 43
w4inslcf.pl 86
wadminep 92
wclrblk 127
wclrline 129
wcpyfile 142
wdelep 169
wdelgate 170
wlcftap 284
エンドポイント・コマンドとゲートウェイ・コマンド表 12
waddpath 91
wdskspc 190
weditini 193
wep 201
wepmgr 213
wepstatus 219
wepupgd 223
wgateway 226
wgetkey 244
wgetval 257
winsblk 267
© Copyright IBM Corp. 2004 545
エンドポイント・コマンドとゲートウェイ・コマンド (続き)
winsline 269
winstlcf 276
wlsendpts 297
wmrgini 328
wrestart 354
wrplblk 364
wrplline 365
wseterr 397
wsetval 415
エンドポイント・ポリシー実行元と実行時 451
自動のソフトウェア・アップグレードを使用可能にする 459
説明 451
表 451
編集 489
after_install_policy 456
allow_install_policy 452
login_policy 459
select_gateway_policy 462
エンドポイント・ポリシー・スクリプト、入手 241
エンドポイント・マネージャー構成 213
コントロール 213
お客様サポート参照: ソフトウェア・サポート
オブジェクトコレクションからの除去 361
コレクション間での移動 329
コレクションのメンバーをリスト表示する 294
DependencyMgr 105, 180
オブジェクト呼び出し、トレース 434
オブジェクト・データベースオブジェクトの削除 167
検証 107
サーバーでローカルに検証する 109
サーバーでローカルに更新する 109
修復 107
低レベル管理 167
同期 49
内容のリスト 64
バックアップ 95
復元 95
ローカル 443
オブジェクト・ディスパッチャー暗号化レベルの設定 49
オブジェクト・データベースの同期49
環境の取得 49
管理対象ノードのインストールの許可49
構成 73
オブジェクト・ディスパッチャー (続き)
コントロール 73
始動 49, 73
情報のリスト 49
初期化 73
設定 49
停止 49
トレースの使用可能化 434
ネットワーク・セキュリティーの設定49
リサイクル 49
ping 335
Windows サービス・マネージャー内のサービスの更新 71
Windows サービス・マネージャー内のサービスの除去 71
Windows サービス・マネージャーへのサービスのインストール 71
オペレーティング・システム、再始動(Windows) 354
オペレーティング・システム情報、リスト表示 438
オンライン資料アクセス ix
[カ行]カスタム・ダイアログ保管 102
マージ 326
環境変数参照: 変数
管理対象ノードアンインストール 441
インストール 419
インストール、変更されたファイル121
インストール・ディレクトリーの取得274
インタープリター・タイプの取得 283
オブジェクト・データベースの同期49
オブジェクト・データベースのバックアップオブジェクト・データベースの復元
95
オペレーティング・システム情報のリスト表示 438
環境の取得 49
時間帯の出力 428
システム情報の取得 308
状況の検査 84
情報のリスト 49
除去 362, 441
設定 49
管理対象ノード (続き)
タスク・ターゲットとして検証する484
タスク・ライブラリー内のデフォルト・リスト 480
データベース参照の検証 109
データベース参照の更新 109
配布状況コンソールの始動 323
日付と時刻の出力 166
プロファイル・マネージャーへのサブスクライバー・リストの提供 471
ホスト ID の出力 258
メモリー量の判別 324
リサイクル 49
リピーターとして構成する 366
リピーターの作成 366
リモート・アクセス・アカウントの設定 (Windows) 412
ロケールの設定 400
IP インターフェースの除去 265
IP インターフェースの追加 265
IP インターフェースのリスト表示265
IP インターフェース・プロパティーの変更 265
ping 84
X 端末ウィンドウを開く 448
管理対象ノード・コマンド表 15
wchknode 109
wclient 121
wdate 166
wdiskspace 185
whostid 258
wifconfig 265
winstdir 274
winterp 283
wmannode 308
wmemsize 324
wstandalone 419
wtimezone 428
wuname 438
wunstmn 441
wxterm 448
管理対象リソースネーム・レジストリーでの検索 292
ポリシー・オブジェクトのリスト表示302
ポリシー・メソッドのリスト表示 303
リスト 292
管理対象リソース・タイプポリシー・リージョンからの除去 404
ポリシー・リージョンへの追加 404
キーワードFile 506, 510, 512
FileBrowser 506
546 Tivoli Management Framework: リファレンス・マニュアル
キーワード (続き)
FileData 506, 510, 512
HostFileBrowser 506
Implementation 515
Layout 517
Multi 506
Program 507, 510, 512
ProgramData 507, 510, 512
Resource 507, 511, 512
ResourceOID 507
task 514
キャッシュ外の依存関係 180
ゲートウェイ管理するエンドポイントの判別 462
ゲートウェイ HTTP サーバーのコントロール 226
構成 226
削除 170
作成 145
始動 226
停止 226
プロパティーのリスト 226
ロギング特性の定義 226
ゲートウェイ HTTP サーバー、アクセスのコントロール 226
ゲートウェイ・コマンドwcrtgate 145
wdelgate 170
参照: エンドポイント・コマンドとゲートウェイ・コマンド
検証ポリシーオブジェクト・クラス用にデフォルトを設定する 396
プロファイルの検証 447
ポリシー・メソッドのリスト表示 303
ポリシー・リージョンとの関連 404
コード・セット、変換 261
構成管理コマンド表 11
wcrtprf 153
wcrtprfmgr 155
wdistrib 186
wgetprf 248
wgetsub 255
wlssub 305
wpopulate 336
wsetpm 403
wsub 422
wuninst 439
wunsub 443
wvalidate 447
国際化対応コード・セット間での文字の変換 261
ローカライズされたファイルおよびディレクトリーの検索 290
コマンドwcrtpol 490
wgeteppol 489
wgetpolm 490
wlspol 490
wlspolm 490
wputeppol 489
wputpolm 490
コマンド、Tivoli Management Framework
が提供する 1
コマンド表アドミニストレーター 11
インストール 13
エンドポイント 12
管理対象ノード 15
ゲートウェイ 12
構成管理 11
照会 17
スケジューラー 18
その他 18
多重化配布 15
タスク・ライブラリー 18
通知 16
低レベル保守 14
ポリシー 16
リージョン間 14
httpd 13
RDBMS Interface Module 17
Revision Control System 17
コレクションオブジェクトの移動 329
オブジェクトの除去 361
オブジェクトのリンク 286
現行の作業コレクションの表示 341
現行の作業コレクションの変更 104
最新表示 351
情報のリスト 294
メンバー・オブジェクトのリスト表示294
[サ行]サービス、Oracle リスナー 161
作業ディレクトリー 341
サブスクライバー除去 443
リスト 255, 305
サブスクリプション、プロファイル・コピーの検索 248
サブスクリプション・リスト 443
サポート参照: ソフトウェア・サポート
シェル・メソッド出力のフォーマット設定 30
入力オプションの取得 29
例外の発生 27
時間帯、判別 428
システム ID、Oracle 用 159, 408
照会作成 157
実行 374, 378
状況の検索情報 250
変更 406
照会コマンド表 17
wcrtqlib 156
wcrtquery 157
wgetquery 250
wruninvquery 374
wrunquery 378
wsetquery 406
照会ライブラリー作成 156
照会の作成 157
状況、エンドポイント 219
書体の規則 ix
ジョブエンドポイント・ターゲットの検証
484
管理対象ノード・ターゲットの検証484
グループ ID の検証 486
作成 147
実行 376
スケジューラーからの削除 174
スケジューラーの使用可能化 199
スケジューリング 384
スケジュールされた編集 195
スケジュールの検索 253
タスク・ライブラリーからの削除 171
タスク・ライブラリーに含まれているジョブのリスト表示 306
プロパティーの設定 398
プロパティーのリスト表示 243
プロファイル・マネージャー内のターゲットの検証 485
ユーザー ID の検証 487
資料オンライン・アクセス ix
スケジューラー始動 421
使用可能化 199
ジョブ状況の検索 253
ジョブの削除 174
ジョブの編集 195
スケジューラー・コマンド表 18
wdelsched 174
wedsched 195
wenblsched 199
wgetsched 253
wschedjob 384
索引 547
スケジューラー・コマンド (続き)
wstartsched 421
製品アップグレード 333
アンインストール 439
インストール 271
インストール済み製品のリスト表示298
接続、Tivoli リージョン情報の交換 295
リスト 295
属性説明 514
ButtonLabel 517
Comments 514
Context 502
DefaultValue 517
Distribution 502
Gid 514
HelpMessage 503, 514
MustMatch 518
MustNotMatch 518
Requires 503
Roles 515
SectionLabel 518
Uid 515
Version 503
属性、インプリメンテーション取得 23
設定 23
追加 23
その他のコマンド表 18
tivoli 78
vdisp 84
waddicon 89
wbindmsg 99
wbkupdb 95
wcatcher 102
wcd 104
wchdep 105
wchkdb 107
wchknode 109
wdel 167
wdepot 176
wdepset 180
wdtmsg 192
wgetallinst 239
wiconv 261
winstendpt 275
wlcftap 284
wln 286
wlocpath 290
wls 294
wlsinst 298
wmcast 309
その他のコマンド (続き)
wmdist 313
wmdistgui 323
wmerge 325
wmrgaef 326
wmv 329
wping 335
wpwd 341
wrefresh 351
wrm 361
wrmnode 362
wrpt 366
wrunas 373
wsetpkey 402
wsupport 423
wtemp 429
wtrace 434
ソフトウェア・サポート情報の収集 423
連絡先 ix, 423
[タ行]ダイアログ、カスタム保管 102
マージ 326
多重化配布コマンドの表 15
タスクエンドポイント・ターゲットの検証
484
管理対象ノード・ターゲットの検証484
グループ ID の検証 486
削除 175
作成 163
実行 380
スケジューラーの使用可能化 199
タスク・ライブラリーに含まれているタスクのリスト表示 306
定義 495, 514
デフォルト・グループ ID 482
デフォルト・ユーザー ID 483
バイナリー、デフォルト配布モード479
バイナリーの配布 188
プロパティーの設定 414
プロパティーのリスト表示 256
プロファイル・マネージャー内のターゲットの検証 485
ユーザー ID の検証 487
タスク定義 514
タスク・トランザクション停止 426
取り消し 426
ロールバック 426
タスク・バイナリー、配布のコントロール188
タスク・ヘッダー 514
タスク・ライブラリーエンドポイントのデフォルト・リスト
480
管理対象ノードのデフォルト・リスト480
作成 165, 430
ジョブのグループ ID の検証 486
ジョブの削除 171
ジョブのユーザー ID の検証 487
タスクとジョブのリスト表示 306
タスクのグループ ID の検証 486
タスクの削除 175
タスクの作成 163
タスクのデフォルト・グループID 482
タスクのデフォルト・ユーザーID 483
タスクのユーザー ID の検証 487
定義 495
配布モードの照会 188
配布モードの設定 188
プロファイル・マネージャーのデフォルト・リスト 481
ヘッダー 501
変更 430
タスク・ライブラリー定義インポート 430
エクスポート 430
タスク・ライブラリー・コマンド表 18
wcrtjob 147
wcrttask 163
wcrttlib 165
wdeljob 171
wdeltask 175
wdisttask 188
wgetjob 243
wgettask 256
wlstlib 306
wrunjob 376
wruntask 380
wsetjob 398
wsettask 414
wtaskabort 426
wtll 430
タスク・ライブラリー・ポリシー検証ポリシー・メソッド表 477
tl_val_man_nodes 484
tl_val_prof_mgrs 485
tl_val_set_gid 482, 486
tl_val_set_uid 487
説明 489
548 Tivoli Management Framework: リファレンス・マニュアル
タスク・ライブラリー・ポリシー (続き)
デフォルト・ポリシー・メソッド表 477
tl_def_dist_mode 479
tl_def_man_nodes 480
tl_def_prof_mgrs 481
tl_def_set_uid 483
編集 490
通信、DB2 用 161
通知期限切れにする 225
送信 417
表示 425
フィルター 425
リスト 300
通知グループサブスクリプションの変更 394
通知を期限切れにする 225
リスト 300
通知コマンド表 16
wbroadcast 101
wexpnotif 225
wlsnotif 300
wsndnotif 417
wtailnotif 425
データベース ID、Informix 160, 408
データベース・サーバーID、Informix 161
データベース・モード、プロファイル・マネージャー 403
データレス・モード、プロファイル・マネージャー 403
ディスク・スペース使用可能なディスク・スペースのリスト 185
ディスク・スペース、検査 190
ディスク・スペース・コマンド 185
ディレクトリー現行の作業コレクションの検索 341
ローカライズされたディレクトリーの検索 290
低レベル保守コマンド表 14
idlarg 22
idlattr 23
idlcall 25
idlexception 27
idlinput 29
idlresult 30
logls 44
objcall 46
odadmin 49
odbls 64
odstat 66
oserv 73
低レベル保守コマンド (続き)
tmcmd 80
tmstat 81
wlocalhost 288
wlocktmr 289
wmailhost 307
テキスト・ファイル行の除去 129
行の挿入 269
行の置換 365
ブロックの除去 127
ブロックの挿入 267
ブロックの置換 364
デフォルト・ファイル 515
デフォルト・ポリシーオブジェクト・クラス用にデフォルトを設定する 396
ポリシー・メソッドのリスト表示 303
ポリシー・リージョンとの関連 404
電子メールサーバーの指定 307
SMTP 307
Windows 用に構成する 307
特記事項 541
トランザクション階層 8
現行トランザクションの表示 81
サブトランザクション 8
取り消し可能サブトランザクション 8
変更の強制 80
読み取り可能ログ・ファイル 44
ロックの表示 81
logls コマンド 44
トランザクション、タスク停止 426
取り消し 426
ロールバック 426
トランザクション・マネージャー 80
[ナ行]名前、DB2 インスタンス 161
ネーム・レジストリー接続された Tivoli リージョンにまたがった 445
リソースの検索 292
リソースの更新 445
リソースのリスト表示 292
[ハ行]配布タスク・バイナリーの配布のコントロール 188
配布 (続き)
タスク・ライブラリーの配布モードの設定 188
配布状況コンソール始動 323
パスワード 504
パスワード・キー、Window レジストリー402
パッチインストール 333
インストール済みパッチのリスト表示298
バッチ・ファイル・コマンド 397
引き数レイアウト 503
日付コマンド 166
ブート・メソッド、エンドポイント 201
ファイル一時 429
インターフェース、Sybase 160
エンドポイント構成 31
エンドポイント・ロギング 31
管理対象ノードのインストール時に変更されたファイル 121
コード・セットの変換 261
読み取り可能トランザクション・ログ44
ローカライズされたファイルの検索290
3 つのファイル・マージ 325
arg 520
file0.tar 388
last.cfg 31
layout 520
lcfd.log 31
library 520
logls コマンド 44
odtrace.log 434
setup_env 5
setup_env.csh 5
sup.$UNAME.uu 423
task 520
tnsnames.ora 161
wsupport.$UNAME 423
.odbc.ini 160, 408
.tivoli_rc 423
ファイル、テキスト行の除去 129
行の挿入 269
行の置換 365
ブロックの除去 127
ブロックの挿入 267
ブロックの置換 364
ブック参照: 資料
太字体、その意味 ix
プラットフォームのコマンド 11
索引 549
プロファイル上書き 336
検証 447
作成 153
サブスクリプション・コピーの検索248
属性のリスト表示 303
取り込み 336
配布 186
複製 153
プロファイル・マネージャーのリストの提供 469
ポリシー・リージョン用のタイプのリストの提供 470
連結 336
プロファイル・マネージャーエンドポイント・サブスクライバーのリスト表示 297
作成 155
サブスクライバーの検証 474
サブスクライバーの除去の検証 472
サブスクライバーのリスト表示 255,
305
サブスクライバーをプロファイル・マネージャーから除去する 443
サブスクリプションの取り消しの検証473
ジョブ・ターゲットの検証 485
タスク・ターゲットの検証 485
タスク・ライブラリー用のデフォルト・リスト 481
データベース・モードの使用可能化403
データベース・モードの使用不可化403
データレス・モードの使用可能化 403
データレス・モードの使用不可化 403
プロファイル・コピーの検索 248
プロファイル・マネージャー・サブスクリプションの検証 475
プロファイル・リストの提供 469
マネージャー・ノードのサブスクライバー・リストの提供 471
リソースのサブスクライブ 422
リソースのサブスクリプション解除443
プロファイル・マネージャー・ポリシー検証ポリシー・メソッド表 467
pm_val_remove_subscribers 472
pm_val_remove_subscription 473
pm_val_subscribers 474
pm_val_subscription 475
説明 467
デフォルト・ポリシー・メソッド表 467
プロファイル・マネージャー・ポリシー(続き)
デフォルト・ポリシー・メソッド (続き)
pm_def_profile_managers 469
pm_def_profile_types 470
pm_def_subscribers 471
編集 490
ヘッダー情報 501
タスク・ライブラリー 501
変数設定 5
DB2COMM 161
DB2DIR 160
DB2INSTANCE 161
DSQUERY 161
INFORMIXDIR 160, 161
INSTHOME 160
LANG 99
NLSPATH 99
ORACLE_HOME 160
ORACLE_SID 159, 408
SYBASE 160
TIVOLI_COMM_DIR 124, 391
TMPDIR 113
TOOLS 499
TWO_TASK 161
変数、表記 ix
ホーム・ディレクトリー、DB2 インスタンス 160
保守、低レベル表 14
保守、Tivoli リージョンを保守モードにする 289
ホスト電子メール 307
SMTP サーバー 307
ホスト ID コマンド 258
ホスト名、Windows レジストリーへの設定 288
ポリシーオブジェクト・クラス用に設定する
396
ポリシー・オブジェクトの作成 150
メンバーの検証 111
ポリシー検証 111
ポリシー・オブジェクト削除 172
作成 150
デフォルトの設定 396
リスト 240, 302
ポリシー・コマンド表 16
wchkpol 111
wcrtpol 150
ポリシー・コマンド (続き)
wcrtpr 151
wdelpol 172
wdelpr 173
wgetdfpol 240
wgeteppol 241
wgetpolm 245
wgetpr 247
wlspol 302
wlspolm 303
wputeppol 337
wputpolm 338
wsetdfpol 396
wsetpr 404
ポリシー・スクリプトエンドポイント 241
エンドポイント、置き換え 337
ポリシー・メソッド内容のリスト 245
本体の置き換え 338
リスト 303
参照: エンドポイント・ポリシー、タスク・ライブラリー・ポリシー、プロファイル・マネージャー・ポリシー
ポリシー・リージョン検証ポリシー 404
削除 173
作成 151
照会ライブラリーの作成 156
状況の検索情報 247
タスク・ライブラリーの作成 165
デフォルト・ポリシー 404
プロファイル・タイプのリストの提供470
ポリシーの検証 111
ポリシーの割り当て 404
ポリシー・オブジェクトのデフォルトの設定 396
リソース・タイプの除去 404
リソース・タイプの追加 404
[マ行]マップ、ユーザー・ログイン 263
マニュアル参照: 資料
マルチキャスト配布、構成 309
メール・サーバーTivoli ツール用 307
Windows 用に指定する 307
メソッドエンドポイント用ブート・メソッド
201
エンドポイント・ポリシーafter_install_policy 456
550 Tivoli Management Framework: リファレンス・マニュアル
メソッド (続き)
エンドポイント・ポリシー (続き)
allow_install_policy 452
login_policy 459
select_gateway_policy 462
オブジェクト呼び出しとして実行 46
シェル 30
入力オプションの取得 29
例外の発生 27
出力のフォーマット設定 30
タスク・ライブラリーの検証ポリシーtl_val_man_nodes 484
tl_val_prof_mgrs 485
tl_val_set_gid 482, 486
tl_val_set_uid 487
タスク・ライブラリーのデフォルト・ポリシー
tl_def_dist_mode 479
tl_def_man_nodes 480
tl_def_prof_mgrs 481
tl_def_set_uid 483
プロファイル・マネージャー検証ポリシー
pm_val_remove_subscribers 472
pm_val_remove_subscription 473
pm_val_subscribers 474
pm_val_subscription 475
プロファイル・マネージャーのデフォルト・ポリシー
pm_def_profile_manager 469
pm_def_profile_types 470
pm_def_subscribers 471
run_task 498
setuid 113
メソッド呼び出し、トレース 434
メッセージ変数のバインディング 99
ローカリゼーション 99
ロケール固有のメッセージの検索 99
Tivoli デスクトップへのブロードキャスト 101
メッセージ・カタログ 497
メッセージ・カタログ・フォーマット502
戻りコード、バッチ・ファイルの設定397
モノスペース・フォント、その意味 ix
問題診断 434
[ヤ行]ユーザー・アカウント
informix 162
ユーザー・ログイン・マップ 263
[ラ行]リージョン間コマンド表 14
wconnect 136
wdisconn 183
wlookup 292
wlsconn 295
wregister 352
wtmrname 433
wupdate 445
リスナー・サービス、Oracle 161
リソースオブジェクト・データベースからの削除 167
サブスクライバーをプロファイル・マネージャーから除去する 443
接続された Tivoli リージョンでの更新445
プロファイル・マネージャーからのサブスクリプション解除 443
プロファイル・マネージャーへのサブスクライブ 422
ポリシー・リージョンに定義されている 247
Tivoli リージョン間での交換 352
リソース・タイプインスタンスのリスト表示 239
エンドポイントの振る舞いのインストール 275
ポリシー・オブジェクトのリスト表示302
ポリシー・メソッドのリスト表示 303
ポリシー・リージョンからの除去 404
ポリシー・リージョンへの追加 404
リピーター構成 366
作成 366
調整 366
マルチキャスト配布用に構成する 309
MDist 2 配布用に管理する 313
MDist 2 配布用に構成する 313
リピーター保管庫イメージの作成 176
エントリーの削除 176
エントリーのパージ 176
構成の表示 176
セグメントの追加 176
リスト 176
リモート・アクセスWindows エンドポイント 284
Windows 管理対象ノード 412
レイアウトChoice 505
ChoiceButton 510
CryptoText 504
レイアウト (続き)
Text 504
TextChoice 505
レイアウト、引き数 503
レジストリー、パスワード・キーの設定402
レジストリー・キー検索 257
設定 415
レジストリー・ハイブエントリーの追加 91
キー値の検索 244, 257
キー値の設定 415
ローカリゼーション、ファイルおよびディレクトリーの検索 290
ログ・ファイルトランザクション、読み取り可能 44
logls コマンド 44
odtrace.log 434
ログ・メッセージ、Revision Control
System 358
ロケール、設定 400
ロック、トランザクション 81
Aafter_install_policy メソッド 456
ALI 値 502
allow_install_policy メソッド 452
Application Developer’s Environment 497
arg ファイル 520
ArgLayout キーワード 503
Argument 文節 517
BBinary インタープリター 515
ButtonLabel キーワード 503
ButtonLabel 属性 517
CC プリプロセッサー 496
Choice レイアウト 505
ChoiceButton レイアウト 510
Comments 属性 514
Context 属性 502
cpp コマンド 496
CryptoText レイアウト 504
DDB2
インスタンス所有者 161
インスタンス名 161
索引 551
DB2 (続き)
インスタンス・ホーム 160
インストール・ディレクトリー 160
通信 161
DB2COMM 変数 161
DB2INSTANCE 変数 161
DBDIR 変数 160
INSTHOME 変数 160
DB2COMM 変数 161
DB2DIR 変数 160
DB2INSTANCE 変数 161
DefaultValue 属性 517
DependencyMgr オブジェクト 105, 180
Description 属性 514
Dialog Specification Language (DSL) 497
Distribution 属性 502
DSL (Dialog Specification Language) 497
DSQUERY 変数 161
FFile キーワード 506, 510, 512
file0.tar ファイル 388
FileBrowser キーワード 506
FileData キーワード 506, 510, 512
GGid 属性 514
GLOBAL 値 502
HHelpMessage 属性 503, 514
HostFileBrowser キーワード 506
HTTP
エンドポイント・リスト 259
ゲートウェイ・リスト 259
転送要求 259
HTTP サーバー、ゲートウェイ 226
httpd コマンド表 13
whttpd 259
IIDL コマンドシェルからの呼び出し 25
idlarg 22
idlattr 23
idlcall 25
idlexception 27
idlinput 29
idlresult 30
idlarg コマンド 22
idlattr コマンド 23
idlcall コマンド 25
idlexception コマンド 27
idlinput コマンド 29
idlresult コマンド 30
ifconfig コマンド 265
Implementation 515
Informix
インストール・ディレクトリー 160
データベース ID 160, 408
データベース・サーバー ID 161
Informix アカウント 162
INFORMIXDIR 変数 160
INFORMIXSERVER 変数 161
.odbc.ini ファイル 160, 408
INFORMIXDIR 変数 160
INFORMIXSERVER 変数 161
INI ファイル内容のマージ 328
変更 193
INSTHOME 変数 160
IP インターフェース管理対象ノード上の IP インターフェースのリスト表示 265
管理対象ノードからの除去 265
管理対象ノードのプロパティーの変更265
管理対象ノードへの追加 265
LLANG 環境変数 99, 290
Layout キーワード 517
layout ファイル 520
lcfd コマンド 31
lcfd.sh コマンド 43
lcfep service 277
library ファイル 520
LOCAL 値 502
login_policy メソッド 459
logls コマンド 44
Lotus Notes、メール・サーバー 307
MMDist 2 の配布管理 313
マルチキャスト用に構成する 309
リピーターの構成 313
リピーター保管庫の管理 176
Microsoft Exchange、メール・サーバー307
Multi キーワード 506
MustMatch 属性 518
MustNotMatch 属性 518
NNetWare 構成プログラム、コピー 142
NLSPATH 環境変数 99
NLSPATH 変数 290
Oobjcall コマンド 46
odadmin コマンド 49
odbls コマンド 64
odstat コマンド 66
odtrace.log ファイル 434
oinstall コマンド 71
Oracle
インスタンス名 159, 408
システム ID 159, 408
リスナー・サービス 161
ORACLE_HOME 変数 160
ORACLE_SID 変数 159, 408
tnsnames.ora ファイル 161
TWO_TASK 変数 161
ORACLE_HOME 変数 160
ORACLE_SID 変数 159, 408
oserv コマンド 73
Pping コマンド 335
pm_def_profile_managers メソッド 469
pm_def_profile_types メソッド 470
pm_def_subscribers メソッド 471
pm_val_remove_subscribers メソッド 472
pm_val_remove_subscription メソッド 473
pm_val_subscribers メソッド 474
pm_val_subscription メソッド 475
Program キーワード 507, 510, 512
ProgramData キーワード 507, 510, 512
pwd コマンド 341
RRCSINIT コマンド 113
RDBMS Interface Module コマンド表 17
wcrtrim 159
wgetrim 251
wmvrim 331
wrimtest 355
wrimtrace 356
wsetrim 408
wsetrimpw 411
Requires 属性 503
Resource キーワード 507, 511, 512
ResourceOID キーワード 507
552 Tivoli Management Framework: リファレンス・マニュアル
Revision Control System
パターンの検索 262
ファイル属性の変更 342
ファイルのチェックアウト 130
ファイルの比較 347
ファイルのマージ 349
リビジョンの検査 113
ログ・メッセージの出力 358
RCS ファイルの作成 342
Revision Control System コマンド表 17
wci 113
wrcs 342
wrcsdiff 347
wrcsmerge 349
Revision Control System システム・コマンド
wco 130
wident 262
wrlog 358
RIM オブジェクト移動 331
作成 159
状況の検索情報 251
テスト 355
トレース 356
パスワードの設定 411
パスワードの変更 411
プロパティーの編集 408
Roles 属性 515
root アドミニストレーター許可の除去 93
権限の付与 93
リスト 93
RSTLICPGM コマンド (AS/400) 86
RSTOBJ コマンド (AS/400) 86
SSectionLabel 属性 518
select_gateway_policy メソッド 462
setuid メソッド 113
setup_env.csh ファイル 5
setup_env.sh ファイル 5
SMTP
ゲートウェイ・ソフトウェア 307
メール・サーバー 307
Windows への接続 307
spider サービス 259
STRTMEEPT コマンド (AS/400) 86
Sybase
インターフェース・ファイル 160
DSQUERY 変数 161
SYBASE 変数 160
SYBASE 変数 160
Ttar コマンド 495
Task キーワード 514
task ファイル 520
TaskLibrary キーワード 501
TASK_BINDIR 変数 515
Text レイアウト 504
TextChoice レイアウト 505
Tivoli Software Information Center ix
Tivoli オブジェクト・データベース検証 107
修復 107
tivoli コマンド 78
Tivoli サーバーインストール (UNIX) 388
オブジェクト・データベースの同期49
環境の取得 49
管理対象ノードのインストールの許可49
情報のリスト 49
設定 49
リサイクル 49
ロケールの設定 400
Tivoli データベースバックアップ 95
復元 95
Tivoli デスクトップ始動 78
始動メッセージのカスタマイズ 192
メッセージのブロードキャスト 101
Tivoli デスクトップ、コレクションの最新表示 351
Tivoli 認証パッケージ (TAP)
Windows エンドポイント用に設定する284
Windows 管理対象ノード用に設定する412
Tivoli リージョン暗号化レベルの設定 49
エンドポイント接続の検証 452
オブジェクト・データベースのバックアップオブジェクト・データベースの復元
95
接続 136
接続情報の交換 295
接続の切断 183
接続をリスト表示する 295
名前の表示 433
名前の変更 433
保守モードに設定する 289
リソースの交換 352
リモート操作の実行 49
Tivoli リモート・アクセス・アカウントWindows エンドポイント用 284, 412
TIVOLI_COMM_DIR 変数 124, 391
tll.conf ディレクトリー 520
tl_def_dist_mode メソッド 479
tl_def_man_nodes メソッド 480
tl_def_prof_mgrs メソッド 481
tl_def_set_uid メソッド 483
tl_val_man_nodes メソッド 484
tl_val_prof_mgrs メソッド 485
tl_val_set_gid メソッド 482, 486
tl_val_set_uid メソッド 487
tmcmd コマンド 80
TME 10 ADE 497
TMPDIR 変数 113
tmstat コマンド 81
tnsnames.ora ファイル 161
TOOLS 変数 499
TWO_TASK 変数 161
UUid 属性 515
upgrade.sh コマンド 459
Vvdisp コマンド 84
Version 属性 503
Ww4inslcf.pl コマンド 86
waddicon コマンド 89
waddpath コマンド 91
wadminep コマンド 92
Wake on LAN 41
wauthadmin コマンド 93
wbindmsg コマンド 99
wbkupdb コマンド 95
wbroadcast コマンド 101
wcatcher コマンド 102
wcd コマンド 104
wchdep コマンド 105, 498
wchkdb コマンド 107
wchknode コマンド 109
wchkpol コマンド 111
wci コマンド 113
wclient コマンド 121
wclrblk コマンド 127
wclrline コマンド 129
wco コマンド 130
wconnect コマンド 136
wcpcdrom コマンド 140
wcpyfile コマンド 142
索引 553
wcrtadmin コマンド 143
wcrtgate コマンド 145
wcrtjob コマンド 147
wcrtpol コマンド 150, 490
wcrtpr コマンド 151
wcrtprf コマンド 153
wcrtprfmgrコマンド 155
wcrtqlib コマンド 156
wcrtquery コマンド 157
wcrtrim コマンド 159
wcrttask コマンド 163
wcrttlib コマンド 165
wdate コマンド 166
wdel コマンド 167
wdelep コマンド 169
wdelgate コマンド 170
wdeljob コマンド 171
wdelpol コマンド 172
wdelpr コマンド 173
wdelsched コマンド 174
wdeltask コマンド 175, 496
wdepot コマンド 176
wdepset コマンド 180, 498
wdisconn コマンド 183
wdiskspace コマンド 185
wdistrib コマンド 186
wdisttask コマンド 188
wdskspc コマンド 190
wdtmsg コマンド 192
Web サーバーHTTP 要求の転送 259
weditini コマンド 193
wedsched コマンド 195
wenblsched コマンド 199
wep コマンド 201
wepmgr コマンド 213
wepstatus コマンド 219
wepupgd コマンド 223
wexpnotif コマンド 225
wgateway dbcheck コマンド 498
wgateway コマンド 226
wgetadmin コマンド 237
wgetallinst コマンド 239
wgetdfpol コマンド 240
wgeteppol コマンド 241, 489
wgetjob コマンド 243
wgetkey コマンド 244
wgetpolm コマンド 245, 490
wgetpr コマンド 247
wgetprf コマンド 248
wgetquery コマンド 250
wgetrim コマンド 251
wgetsched コマンド 253
wgetsub コマンド 255
wgettask コマンド 256
wgetval コマンド 257
whostid コマンド 258
whttpd コマンド 259
wiconv コマンド 261
wident コマンド 262
widmap コマンド 263
wifconfig コマンド 265
Windows サービス・マネージャー 71
Windows メールSMTP ゲートウェイ 307
SMTP サーバーへの接続 307
winsblk コマンド 267
winsline コマンド 269
winstall コマンド 271
winstdir コマンド 274
winstendpt コマンド 275
winstlcf コマンド 276
winterp コマンド 283
wlcftap コマンド 284
wln コマンド 286
wlocalhost コマンド 288
wlocktmr コマンド 289
wlocpath コマンド 290
wlookup コマンド 292
wls コマンド 294
wlsconn コマンド 295
wlsendpts コマンド 297
wlsinst コマンド 298
wlsnotif コマンド 300
wlspol コマンド 302, 490
wlspolm コマンド 303, 490
wlssub コマンド 305
wlstlib コマンド 306
wmailhost コマンド 307
wmannode コマンド 308
wmcast コマンド 309
wmdist コマンド 313
wmdistgui コマンド 323
wmemsize コマンド 324
wmerge コマンド 325
wmrgaef コマンド 326
wmrgini コマンド 328
wmv コマンド 329
wmvrim コマンド 331
wpatch コマンド 333
wping コマンド 335
wpopulate コマンド 336
wpreinst.sh コマンド 388
wputeppol コマンド 337, 489
wputmeth コマンド 517
wputpolm コマンド 338, 490
wpwd コマンド 341
wrcs コマンド 342
wrcsdiff コマンド 347
wrcsmerge コマンド 349
wrefresh コマンド 351
wregister コマンド 352
wrestart コマンド 354
wrimtest コマンド 355
wrimtrace コマンド 356
wrlog コマンド 358
wrm コマンド 361
wrmnode コマンド 362
wrplblk コマンド 364
wrplline コマンド 365
wrpt コマンド 366
wrunas コマンド 373
wruninvquery コマンド 374
wrunjob 376
wrunquery コマンド 378
wruntask コマンド 380
wschedjob コマンド 384
wserver コマンド 388
wsetadmin コマンド 394
wsetdfpol コマンド 396
wseterr コマンド 397
wsetjob コマンド 398
wsetlang コマンド 400
wsetpkey コマンド 402
wsetpm コマンド 403
wsetpr コマンド 404
wsetquery コマンド 406
wsetrim コマンド 408
wsetrimpw コマンド 411
wsettap コマンド 412
wsettask コマンド 414
wsetval コマンド 415
wsndnotif コマンド 417
wstandalone コマンド 419
wstartsched コマンド 421
wsub コマンド 422
wsupport コマンド 423
wtailnotif コマンド 425
wtaskabort コマンド 426
wtemp コマンド 429
wtimezone コマンド 428
wtll コマンド 430, 495
wtmrname コマンド 433
wtrace コマンド 434
wuname コマンド 438
wuninst コマンド 439
wunstmn コマンド 441
wunsub コマンド 443
wupdate コマンド 445
wvalidate コマンド 447
wxterm コマンド 448
XX 端末ウィンドウ、開く 448
554 Tivoli Management Framework: リファレンス・マニュアル
[特殊文字].odbc.ini ファイル 160, 408
.tivoli_rc ファイル 423
索引 555
556 Tivoli Management Framework: リファレンス・マニュアル
���
Printed in Japan
SC88-9296-01