pg_listen dbHandle notifyName callbackCommand
pg_listen は、Postgres バックエンドからの非同期 NOTIFY メッセージの監視要求の生成、変更、取 り 消しを行ないます。パラメータ callbackCommand を使って、要求を確立したり、 既存のリクエストのコマンド文字列を置換したりします。パラメータ callbackCommand が無い場合は、事前になされた要求が取り消されます。
pg_listen の要求が確立した後、バックエンドから指定した 名前を持った NOTIFY メッセージが届く 度に、指定コマンド文字列が実行されます。この手順は、任意の Postgres クライ アントアプリケーションがその名前を 参照する NOTIFY コマンドを発行する度に発生します。（その名前はデータベース内の 既存のリレーションのものである必 要がないことに注意して下さい。） コマンド文字列は、Tcl の待ちループから実行されます。それは、Tk で記述さ れたアプリケーション の通常の待ち状態です。非 Tk の Tcl シェルの場合は、update または vwait を実行して、待ちループ状態にすることができます。
pg_listen を使用している場合は、直接 LISTEN もしくは UNLISTEN という SQL 文を呼び出さないで下さい。Pgtcl はこれらの文の発行を 管理しています。しかし、自分で NOTIFY メッセージを送信したい 場合は pg_exec を使って SQL NOTIFY 文を呼び出して下さい。