ページのトップに戻る
TeamWARE Office 200X V3.0L10 管理者ガイド

14.9.2 [to]コマンド

[to]コマンドを起動することにより、TeamWARE Officeサーバやデータベースの状態を参照したり変更したりできます。

[to]コマンドには以下の機能があります。

to start

サーバの起動を行います。

to stop

サーバの停止を行います。

to version

サーバのバージョン情報表示を行います。

to status

サーバの動作状況の表示を行います。

to recover

サーバのデータベース修復を行います。

to resume

サーバのデータベース復元を行います。

to compress

サーバのデータベース圧縮を行います。

to check

サーバのデータベース異常のチェックを行います。

to alarmdump

サーバ内のアラームキューの一覧表示を行います。

to alarmclean

サーバ内のアラームキューの削除を行います。

to alarmfiledump

中間ファイルの一覧表示を行います。

to alarmfileclean

中間ファイルをすべて削除します。

to ping

サーバの回線接続のテストを行います。

to mailq

サーバ内のメールキューの一覧表示を行います。

to ca

サイト間直接アクセスの一連の認証作業を行います。

to tran

サーバ内のサービスの利用を抑止、または抑止を解除します。

to backup

サーバのデータベースをオンラインバックアップモードに設定、または解除します。

to fix

サーバのデータベースの修復を行います。

[to]コマンドの出力するエラーメッセージについては、"付録E [to]コマンドのメッセージ"を参照してください。また、[to ca]については、"10.4.1 サイト間直接アクセスの認証"を、[to fix]については、"14.10.5 拡張復旧作業"を参照してください。

[to]コマンドの使用方法を以下に示します。

to start

サーバ起動用コマンド

入力形式

to start

機能

TeamWARE Officeサーバを起動します。このコマンドの詳細については、"4.1 TeamWARE Officeの起動"を参照してください。

to stop

サーバ停止用コマンド

入力形式

to stop [-t時間]

機能

TeamWARE Officeサーバを停止します。このコマンドの詳細については、"4.2 TeamWARE Officeの停止"を参照してください。

オペランド
-t時間

TeamWARE Officeサーバを確実に停止させる時間を0~9までの分単位で指定します。-tと数値(時間)は空白をあけずに指定します。たとえば5分を指定する場合はto stop -t5となります。通常の停止では-tオペランドは指定せず、無停電電源装置などを使用して停電など緊急に停止したい場合に、電力が供給されている時間内の値を-tオペランドで指定してください。指定した時間以内にTeamWARE Officeサーバが正常に停止しなかった場合は、次回のTeamWARE Officeサーバの起動時にデータベースの修復処理が行われて起動に時間がかかることがありますが、データベースが破壊されることを防止できます。

注意

-tオペランドを指定しても、指定した時間以内に[to stop]コマンドが完了しない場合があります。ただし、この場合でも指定した時間を超えてのデータベースアクセスは行わないため、指定した時間を経過した後では電源切断を行っても問題ありません。

to version

バージョン情報表示コマンド

入力形式

to version

機能

TeamWARE Officeサーバのバージョン情報を表示します。

使用例

>to version
3.0/401

to status

サーバ動作状況の表示コマンド

入力形式

to status [-l]

機能

コマンド入力時点でのTeamWARE Officeサーバのプロセス、およびスレッドの動作状態を表示します。

オペランド
-l

本オペランドを省略した場合の表示に加え、プロセスID、スレッドID、親プロセスIDなどにより、詳細な情報を表示させます。

表示情報の意味

コマンド入力行の直後に表示されるヘッダ行の各情報名の意味を以下に示します。

  • IND:サーバのプロセス管理テーブルのインデックス番号

  • NAME:プロセスまたはスレッドの名前
    名前の直後に"p"が表示されている場合はプロセスを意味し、"t"が表示されている場合は、スレッドを意味します。

  • STATE:

    • IDLE : 要求待ち状態

    • ACTIVE : 要求処理中

    • STARTED : 起動処理中

    • INIT : 初期化処理中

    • S.PEND : シャットダウン処理中

    • S.DOWN : シャットダウン完了

    • FAILURE : 起動失敗

    • ENDED : 終了処理完了

    • EXECERR : 実行エラー発生

    • PAUSED : 処理の受付け一時停止中

  • DATETIME:最後に現在の状態になった日時

  • USER:プロセス/スレッドを使用しているユーザ名
    "$"または"@"で始まるユーザ名は、システムで使用しているプロセス/スレッドを示します。

  • PID:プロセスID(-lオペランド指定時のみ有効)

  • TID:スレッドID(-lオペランド指定時のみ有効)

  • PPID:親プロセスID(-lオペランド指定時のみ有効)

  • PRI:実行優先度(-lオペランド指定時のみ有効)

  • r:

    • 0:通常状態

    • 1:リスタートペンディング状態(-lオペランド指定時のみ有効)

  • p:

    • 0:通常状態

    • 1:ポーズペンディング状態(-lオペランド指定時のみ有効)

使用例

>to status
IND NAME STATE DATETIME USER
0 tostart p IDLE 2008-08-01 16:18:37,52
1 toentdir p IDLE 2008-08-01 16:18:25,42
2 toserver p IDLE 2008-08-01 16:18:23,38 NM $SERVER
3 toserver t IDLE 2008-08-01 15:49:20,43 $IPC Queue(#0)
4 toserver t IDLE 2008-08-01 16:16:37,77 $TCP/IP(#1)


ポイント

  • データベースを操作するコマンドの実行中に[to status]コマンドを実行すると、tostartプロセス(先頭行)のUSERフィールドに、実行している処理の状態が表示されます。

    • $Db Recover : [to recover]コマンド実行中

    • $Db Resume : [to resume]コマンド実行中

    • $Db Compress : [to compress]コマンド実行中

    • $Db Check : [to check]コマンド実行中

    • $Db AutoRecover : TeamWARE Officeサーバの起動処理でデータベース修復処理が動作中

  • [to recover]コマンド実行中、またはTeamWARE Officeサーバの起動処理でデータベース修復処理が動作中のときに[to status]コマンドを実行すると、状態表示に続けて以下のメッセージが出力されます。

    tostatus Database recovery is running.

    このメッセージが出力される間は、TeamWARE Officeの各種サービスを使用できません。データベース修復処理が完了するまでお待ちください。

to recover

データベース修復コマンド

入力形式

to recover <directory|mail|library|forum|calendar|task|all>

機能

データベースの修復処理を行います。本コマンドは、TeamWARE Officeサーバを運用中にシステムエラーやハードエラーが発生したり、電源の切断などの理由によりデータベースに矛盾が発生した場合に使用します。

オペランド
directory

Directoryデータベースを修復します。

mail

Mailデータベースを修復します。

library

Libraryデータベースを修復します。

forum

Forumデータベースを修復します。

calendar

Calendarデータベースを修復します。

task

Taskデータベースを修復します。

all

すべてのデータベースを修復します。

使用例

>to recover directory
  recovery: 2000-11-20 12:07:57,69
  d:/to/database/100stn.d01
  collecting indexes
  current file size=0
  estimated remaining time (this phase)=no estimate

使用上の注意

インストールされていないサービスを指定して本コマンドを実行した場合、下記のようなメッセージが出力されます。このメッセージは指定されたサービス用のデータベースファイルが見つからなかったという意味のメッセージです。したがって、データベースには異常が発生していません。

>to recover calendar
to CHECK OS: 1.2.0 OS:No such file or directory

to resume

データベース復元コマンド

入力形式

to resume <directory|mail|library|forum|calendar|task||all>

機能

データベースの復元処理を行います。本コマンドは、TeamWARE Officeサーバの運用を5日以上停止していたあとに、サーバを再起動させる前に投入します。本コマンドは、旧製品(V5.3L13)以降不要となりましたが、実行しても問題は発生しません。

オペランド
directory

Directoryデータベースを復元します。

mail

Mailデータベースを復元します。

library

Libraryデータベースを復元します。

forum

Forumデータベースを復元します。

calendar

Calendarデータベースを復元します。

task

Taskデータベースを復元します。

all

すべてのデータベースを復元します。

使用例

>to resume directory
Ready.

to compress

データベース圧縮コマンド

入力形式

to compress <directory|mail|library|forum|calendar|task|all> [-t時間]

機能

データベースの圧縮処理を行います。本コマンドの詳細については、"15.5 データベースの圧縮"を参照してください。

オペランド
directory

Directoryデータベースを圧縮します。

mail

Mailデータベースを圧縮します。

library

Libraryデータベースを圧縮します。

forum

Forumデータベースを圧縮します。

calendar

Calendarデータベースを圧縮します。

task

Taskデータベースを圧縮します。

all

すべてのデータベースを圧縮します。

-t時間

圧縮処理の実行時間を1~1440までの分単位で指定します。指定した時間が経てば、圧縮処理が完了しなくてもコマンドは終了します。この場合、次の圧縮処理では、前回圧縮されなかった部分から処理が行われます。-tと数値(時間)は空白をあけずに指定します。たとえば60分を指定する場合はto stop -t60となります。

使用例

>to compress mail -t60
Ready.

使用上の注意

インストールされていないサービスを指定して本コマンドを実行した場合、下記のようなメッセージが出力されます。このメッセージは指定されたサービス用のデータベースファイルが見つからなかったという意味のメッセージです。したがって、データベースには異常が発生していません。

>to compress calendar
to CHECK OS: 1.2.0 OS:No such file or directory

to check

データベース異常検査コマンド

入力形式

to check <directory|mail|library|forum|calendar|task||all>

機能

データベースに異常が発生しているか否かを検査します。異常が認められる場合は、以下のようなメッセージが表示されます。

to CHECK 1.-137.0 DB:(objst)Database can not be used before recovery (uncompleted write transaction or OBJIX-file of OBJST has been corrupted)

指定したデータベースに異常がない場合は、"Ready"と表示されます。

オペランド
directory

Directoryデータベースの異常検査を行います。

mail

Mailデータベースの異常検査を行います。

library

Libraryデータベースの異常検査を行います。

forum

Forumデータベースの異常検査を行います。

calendar

Calendarデータベースの異常検査を行います。

task

Taskデータベースの異常検査を行います。

all

すべてのデータベースの異常検査を行います。

使用例

>to check directory
Ready.

使用上の注意

インストールされていないサービスを指定して本コマンドを実行した場合、下記のようなメッセージが出力されます。このメッセージは指定されたサービス用のデータベースファイルが見つからなかったという意味のメッセージです。したがって、データベースに異常が発生していません。

>to check calendar
to CHECK OS: 1.2.0 OS:No such file or directory

to alarmdump

アラームキューの一覧表示コマンド

入力形式

to alarmdump

機能

システム管理者へのアラート通知、および一般のNotifier通知(メールの受信通知、カレンダーの予約通知など)でまだ送信が完了していない通知、または中間ファイルへ出力をしていないツールバー向けの通知を保持しているキューのことを、アラームキューといいます。このコマンドは、現在のアラームキューの状態を表示します。

表示情報の意味

コマンド入力行の直後に表示されるヘッダ行の各情報名の意味を以下に示します。

  • IND    : アラームキュー上のインデックス番号

  • TP     : アラート/Notifier通知の送信に使用されるトランスポートのタイプ
    現在有効なトランスポートタイプは"4"(TCP/IP)だけです。なお、アラート通知の場合は、"-"で表示されます。

  • CMD    : 通知の種別

    • - : システム管理者へのアラート通知

    • 1 : 新規メール受信通知

    • 2 : メールの配達失敗通知

    • 3 : メールの受信失敗通知

    • 4 : Calendarサービス用通知

    • 5 : Forumサービス用通知

    • 7 : 一般通知

    • 12: アラーム一件削除コマンド

    • 14: アラーム全件削除コマンド

    • 18: Taskサービス用通知

  • RETRIES    : 現在までの送信リトライ回数

  • NEXT.TRY(mins) :次の送信リトライまでの時間(分) NOWは送信待ち、送信中です。

  • DESTINATION   : 通知送信先アドレス
    なお、アラート通知の場合は表示されません。

使用例

>to alarmdump
  IND   TP CMD RETRIES NEXT.TRY(mins)   DESTINATION
  00001  4   2  0       NOW              133.162.30.253
  00002  4   2  0       NOW              @133.162.30.253
  00003  -   -  0

to alarmclean

アラームキューの削除コマンド

入力形式

to alarmclean [IND番号]

機能

アラームキューから特定のアラート通知、または、Notifier通知を削除します。

オペランド
IND番号

アラームキュー上のインデックス番号を指定します。インデックス番号は、[to alarmdump]コマンドで得ることができます。なお、このオペランドを省略した場合は、すべての通知を削除します。

使用例

>to alarmclean 1

to alarmfiledump

中間ファイル一覧表示コマンド

入力形式

to alarmfiledump

機能

ツールバー向けの通知情報が格納されている中間ファイルの状態を表示します。

表示情報の意味

コマンド入力行の直後に表示されるヘッダ行の各情報名の意味を以下に示します。

  • FILE NAME:中間ファイルのファイル名

  • MAIL NOTIFY:通知種別

    • 0:通知済みの状態

    • 1:通知していない状態

使用例

>to alarmfiledump
FILE NAME                                 MAIL NOTIFY
SMPDB-US44AQA6AZ3EL5CCYBXY        1
SMPDB-US44AQAEAZ3EL5CCYBXY        1

to alarmfileclean

中間ファイル削除コマンド

入力形式

to alarmfileclean

機能

中間ファイルをすべて削除します。

to ping

回線接続のテスト用コマンド

入力形式

to ping <address>

機能

指定したアドレスで起動されているTeamWARE Officeサーバとの回線接続をテストします。マルチサーバ構成の場合に、サーバ間の転送速度などをチェックできます。なお、[to ping]コマンドの復帰値は、TeamWARE Officeサーバが起動している場合は0、起動していない場合は1となります。

オペランド
address

"トランスポート番号:トランスポートアドレス"を指定します。トランスポート番号には1を指定し、トランスポートアドレスには、テスト対象のサーバIPアドレスを指定します。

使用例
  • TeamWARE Officeサーバを起動している場合
    >to ping 1:199.99.99.99

    Connecting to transport 1 with address 1:199.99.99.99...
    Connect took 10 msecs
    ....................
    20 packets of 2048 bytes sent and received in 80 msecs
    250 packets/sec
    256000 bytes/sec

  • [TeamWARE Officeサーバを起動していない場合]
    >to ping 1:199.99.99.99

    Connecting to transport 1 with address 1:199.99.99.99...
    Failed to connect SES: 3.1.126(0x7e) SESSION:Partner is not running, Cannot
    assign requested address
    Connected attempt took 0 msecs

使用上の注意

トランスポート番号に1以外を指定した場合、または省略した場合(トランスポートアドレスのみを指定した場合)の表示結果に意味はありません。

to mailq

メール配信キューの一覧表示コマンド

入力形式

to mailq

機能

ディレクトリサーバ上のメール配信キューの状態を表示します。ディレクトリサーバでのみ、実行可能です。アプリケーションサーバでは、本コマンドは正しく動作しません。

表示情報の意味

コマンド入力後、端末に以下のようなキューの名前が表示されます。現バージョンではここで示したキューだけが有効です。ほかのキューについては、キューの名前だけ表示され、情報は表示されません。

  • Local : 配達待ちのTeamWARE Officeメール

  • TMB/Inet : メッセージルータが配達処理中のインターネットメール

  • Inet : 配達待ちのインターネットメール

使用例

>to mailq
  List mail queues
  Local
  TMB/X.400
  TMB/Inet
  X.400
  Inet
    c2oc3h2h.u08
      c2oc47rn.u08
      c2oc7il8.u08
  .....

注意

[to mailq]コマンドは、アプリケーションサーバでは正しく動作しません。ディレクトリサーバ上で実行してください。

to tran

トランザクション抑止/解除コマンド

入力形式

to tran <suspend|resume|status>

機能

TeamWARE Officeのサービスの利用を抑止、または抑止を解除します。

オペランド
suspend

サービスの利用を抑止します。

コマンドが終了してから、抑止の解除が行われるまでサービスは利用できません。

resume

サービスの利用の抑止を解除します。

status

サービスの抑止状態を表示します。

表示情報の意味
  • SERVICE:サービス名

  • SUSPEND: サービス抑止の状態

    • ON: サービス抑止中、または抑止解除

    • OFF: サービス抑止解除

  • ONGOING: 実行中の処理の数

    • 0: 実行中の処理はありません。

    • 0以外: 実行中の処理があります。SUSPENDがONの場合、以降の注意を参照の上、サービス抑止、またはサービス抑止解除を実行してください。

使用例

>to tran suspend
  Setting directory service to suspend mode on ...
  directory service : suspend mode on.
  >to tran resume
  Setting directory service to suspend mode off ...
  directory service : suspend mode off.
  >to tran status
  SERVICE        SUSPEND       ONGOING
  directory            ON                0       ←抑止完了
  mail                ON                3       ←抑止中
  forum              OFF                0       ←抑止解除

注意

  • [to tran suspend]コマンドの実行中、時間経過を示す"."が画面に表示される場合があります。

  • [to tran suspend]コマンドの実行開始から、一定時間経過してもサーバ内の全サービスの抑止処理が完了しない場合、[to tran suspend]コマンドはメッセージを表示してエラー終了します。サービス抑止処理を継続する場合は、引き続き[to tran suspend]コマンドを実行してください。サービス抑止処理を終了する場合は、[to tran resume]コマンドを実行して一部実行されたサービス抑止を解除してください。コマンドがエラー終了するまでの時間は標準設定で3分間です。この値は[to.ini]の設定で変更できます。変更方法については、"F.6 [TOTRAN]セクション"を参照してください。

to backup

バックアップモードコマンド

入力形式

to backup <on|off|status>

機能

データベースをオンラインバックアップモードに設定または解除します。

オペランド
on

データベースをオンラインバックアップモードにします。

off

データベースのオンラインバックアップモードを解除します。

status

オンラインバックアップモードの状態を表示します。

使用例

>to backup
  TeamWARE server is in normal mode
  >to backup on
  Setting backup mode on...
  Backup mode on
  >to backup status
  TeamWARE server is in Backup mode