Interstage Application Server OLTPサーバ運用ガイド

3.1.2.3 プロセス情報通知機能の使用方法

　プロセス情報通知機能について説明します。

1) プロセス情報通知機能の使用方法

　プロセス情報通知機能の使用方法について説明します。

■概要

　アプリケーションプロセスの起動時に、プロセス固有の情報が特定の環境変数に設定されます。アプリケーションプログラムでは、自プロセスの情報を環境変数より獲得することができます。これにより、アプリケーションプログラムは、プロセスごとの資源を独自に管理するための情報を獲得することができます。
　また、アプリケーション異常やタイムアウトによりアプリケーションプロセスが終了した場合、プロセス再起動時に終了前の情報を引き継いだり、現プロセスの起動状態を獲得することができます。

　以下に採取可能な情報を記載します。

設定情報	内容
プロセス通番	ワークユニット内でユニークなプロセスのシリアル番号であり、プロセス再起動時にも、異常終了したプロセスと同じ番号が設定されます。 なお、プロセス多重度変更機能によるプロセスの増減を行った場合、ユニークな番号であることは保証されますが、連続した番号は保証されません。
システム名	デフォルトシステムの場合は“default”が設定されます。拡張システムの場合は拡張システムのシステム名が設定されます。
ワークユニット名	ワークユニット名
起動ユーザ名	ワークユニット起動コマンドを実行したユーザ名
プロセス起動回数	プロセスがワークユニット起動による初回起動なのか、プロセス異常終了による再起動なのかを識別する情報
ワークユニット出口復帰情報	ワークユニット起動時のワークユニット出口で、出力値として設定されたワークユニット出口復帰情報１，２

■プログラミングの流れ

プログラミングの詳細は、“プロセス情報通知機能”を参照してください。

■注意事項

　ワークユニットプロセス情報通知機能を使用する場合、次のことに注意してください。

• C、C++言語では、獲得した環境変数領域を解放しないでください。
  誤って解放した場合は、不当領域解放により異常終了する場合があります。
• 環境変数の値は変更しないでください。